PURPOSE: The QUEUE TRACE option controls whether Data Set (DS) requests being generated by ACCENT R are indicated by a messages displaying at the terminal as they occur. This command is valid in a CM, PM, SF and as a direct command.
{ENABLE; DISABLE} QUEUE TRACE [{IF; UNLESS} clause]
|
ENABLE |
turns on trace mode for DS’s for which there are queues. It also causes messages to display at the terminal each time ACCENT R generates a request for the DS. |
|
DISABLE |
turns off tracing facility and messages displaying. This is the default state. |
|
{IF; UNLESS} |
specifies a condition for the option to be enabled or disabled. |
*ENABLE QUEUE TRACE, RECORD LOCKS
*USE DS NEWBOOK
*ALTER END IF @RECORD = 1 SET 2 TO ON_ORDER
>>CF file NEWBOOK.CF has record queuing without file queuing
>>Queuing all records in a CF file NEWBOOK.CF for protected-read
>>Dequeuing all records in CF file NEWBOOK.CF
>>Queuing DS file NEWBOOK.DS
>>>>GET is protected-read
>>>>PUT is protected-read
>>>>APPEND is protected-read
>>>>DELETE is protected-read
>>Queuing Special End-Of-File in DS file NEWBOOK.DS for protected-read
extended by another user then get the new EOF
>>Dequeuing Special End-Of-File in DS file NEWBOOK.DS
>>Queuing all records in DS file NEWBOOK.DS for protected-read
>>Queuing file block 1:2 in DS file NEWBOOK.DS for exclusive
>>Dequeuing all records in Ds file NEWBOOK.DS
1 Record(s) Processed
>>Queuing all records in CF file NEWBOOL.CF for exclusive
>>Dequeuing all records in CF file NEWBOOK.CF
>>Queuing Special End-Of-File in DS file NEWBOOK.DS for protected-read
>>Queue EOF at byte 0 for DS file NEWBOOK.DS unless the file has been
extended by another user then get the new EOF
>>Dequeuing special End-Of-File in DS file NEWBOOK.DS
>>Dequeuing DS file NEWBOOK.DS
NOTES: The messages generated by ENABLE QUEUE TRACE are as follows:
(1) Queuing {N}
(2) Queue request blocked - resource not available
(3) Queue request unblocked - request satisfied
(4) Dequeuing {N}
(5) Dequeuing request aborted
(6) Dequeuing request timed out
Key: {N} = Data Set
Message (1) is displayed when a program that specifies the concurrent queued or exclusive queued environment requests a DS and the DS is opened and queued.
Message (2) is displayed immediately after message (1) if the request for a Data Set (DS) cannot be granted at present because the DS is being used.
Message (3) is displayed when the user’s request for a DS is granted.
Message (4) is displayed when the user’s program releases a DS.
Message (5) is displayed when the user aborts out of a program by typing a Control-C while queued for a DS or record.
Message (6) is displayed when the waiting time for a busy DS or record exceeds @DS_WAIT seconds or @RECORD_WAIT seconds, respectively. If the current program is queued for a Data Set it will abort; if it is queued for a record, a time interrupt will occur and @AUX will be set to “BUSY.”