Syntax
── ? ── SQ ─┬───────┬─┬────────────────────────────────────┬───────────% ├─<LSN>─┤ ├─<queue number list>─┬──────────────┤ └─ * ───┘ │ └─ SHORT ──────┤ └─<queue number>──<number>─┬─────────┤ └─ SHORT ─┘
<queue number>
──<integer>────────────────────────────────────────────────────────────┤
Explanation
The ?SQ command displays jobs queued to run that were initiated under the usercode of the station. If a <queue number list> is not specified, the first entry in all job queues is displayed. Otherwise, all entries in the queue or queues referenced by the <queue number list> are displayed. If a <queue number list> is specified, the display of any queues not having an entry for the designated usercode is suppressed. If SHORT is appended to the ?SQ command, only the first entry in the queue for the designated usercode is displayed. If a <queue number> <number> is specified, all entries in the queue indicated by the queue number whose priority is equal to the second number are displayed.
If a job is specified after a BEGIN JOB statement, the name of the job waiting in the queue is displayed. If a job has parameters, the job name is displayed first, followed by the actual parameters. If no job name is specified, then “BEGIN JOB;” is displayed, followed by the first 30 characters from the next line, which creates the first job attribute, declaration, or statement of the job.
The syntax and results of this command are controlled to some extent by the CANDE ALLMSG option. The state of the ALLMSG option is controlled by the system operator.
If ALLMSG is RESET, a syntax error is issued if <LSN> or an asterisk (*) is specified. The only information returned pertains to those jobs or tasks originating from the user's LSN with which the usercode is associated.
If ALLMSG is SET, information about any LSN can be requested. The asterisk (*) syntax is a shorthand method for specifying the LSN to which the user is signed on. If no LSN is specified, then all information pertaining to jobs or tasks for the user making the request, regardless of origination point, is returned.
Examples
?SQ 0 QUEUE 0: NO ENTRIES QUEUE 77 40017 50 (USER) J (#0001) QUEUED: 05/23/2001 AT 14:38:37 QUEUE 99 40020 50 (USER) J (#0001) QUEUED: 05/23/2001 AT 14:39:02 QUEUE 300 7588 50 (USER) J (#0001) QUEUED: 05/15/2001 AT 12:01:43 7596 50 (USER) J (#0002) QUEUED: 05/15/2001 AT 12:01:56 7606 50 (USER) J (#0003) QUEUED: 05/15/2001 AT 12:02:05 ?SQ 99-600 SHORT QUEUE 99 40020 50 (USER) J (#0001) QUEUED: 05/23/2001 AT 14:39:02 QUEUE 300 7588 50 (USER) J (#0001) QUEUED: 05/15/2001 AT 12:01:43