XSHOW QUEUE -- extended show queue command Displays information about the system's batch and/or print queues and the jobs they contain. format: XSHOW QUEUE [queue-name[,queue-name...]] XSHOW ENTRY entry-value[,entry-value...]] Note: provides much greater flexibility than the standard VMS SHOW QUEUE utility. Parameters: The queue-name parameter is an optional comma separated list of queue specifications; full wildcard support is provided. Default value is "*". The entry-value may be a number of a range specified by low and high values separated by a dash or colon. Qualifiers: /all_jobs -- all jobs or only current user's jobs /[no]all_jobs /batch -- batch queues vs print queues vs forms & characteristics /[no]batch /brief -- level of information to display /[no]brief /BY_JOB_STATUS -- categories of jobs to display or suppress /BY_JOB_STATUS=([[NO]ALL,][NO]EXECUTING,[NO]PENDING,[NO]WAITING, - [NO]HOLDING,[NO]RETAINED,[NO]OTHER) Specifies what category(s) of jobs to display. By default, jobs in any category will be displayed. The keyword PRINTING may be used as a synonym for EXECUTING and AFTER may be used as a synonym for WAITING. Note: the /ALL_JOBS qualifier still controls whether any jobs owned by other users may be displayed. Category OTHER is a catch-all that should never include any jobs. /characteristics -- characteristics vs forms vs queues Requests that queue characteristics be displayed. Same as SHOW QUEUE except that it may be used in combination with /FORMS, /DEVICE, and /BATCH. Note: the 'queue-name' parameter is treated as a list of characteristic names. /COMPRESS -- suppress blank lines and underlines to fit more on screen /[no]COMPRESS /device -- print queues vs batch queues vs forms & characteristics /[no]DEVICE[=([[NO]ALL,][NO]PRINTER,[NO]TERMINAL,[NO]SERVER,NONE)] Narrows done which type of print queue(s) to display. /ENTRY -- list of job entry numbers for jobs to select or suppress /ENTRY=([-,]entry-num[:entry-num][,entry-num[:entry-num]...]) Specifies a list of job entry numbers to determine which jobs to display. Each element of the list may be a range specified by low and high values separated by a colon (':') or dash ('-'). If the first element is a dash ('-'), then the list represents jobs to be excluded from the display. Note: the /ALL_JOBS qualifier still controls whether any jobs owned by other users may be displayed. /EXCLUDE -- list of queues to suppress /EXCLUDE=(queue-name[,queue-name...]) /files -- display files with brief listing (or /nofiles with full) /[no]files /forms -- forms vs characteristics vs queues Requests that queue forms be displayed. Same as SHOW QUEUE except that it may be used in combination with /CHARACTERISTICS and /DEVICE. Note: the 'queue-name' parameter is treated as a list of form names. /full -- level of information to display /[no]FULL[= ALL | QUEUES | JOBS | NONE ] Determines level of detail to display. /FULL=NONE is the default and is equivalent to /BRIEF. /FULL without a value means /FULL=ALL and is the same as for SHOW QUEUE. /FULL=QUEUES shows full queue information but /brief (or /files) data for jobs. Conversely, /FULL=JOBS shows full job (and file) information but /brief for queues. /GENERIC -- type of queue to display /[NO]GENERIC If /IF is present, /GENERIC is ignored. /IF_QUEUE_STATUS -- categories of queues to display or suppress /IF_Q=([[NO]SOMETHING,][NO]ACTIVE,[NO]INACTIVE,[NO]EMPTY,[NO]NONEMPTY,- [NO]NORMAL,[NO]ABNORMAL,[NO]EXECUTION,[NO]GENERIC,[NO]ANYTHING) Specifies selection criteria for which queues to display. By default, all queues matching the queue-name parameter (possibly modified by the /exclude and/or /on_node qualifiers) are displayed. /IF_QUEUE_STATUS without a value defaults to /IF_QUEUE=SOMETHING which limits the display to queues that have one or more jobs displayed (determined by /all_jobs, /by_job_status, /entry, /jobname, and /username qualifiers). /IF_QUEUE=ANYTHING is the same as omitting /IF_QUEUE_STATUS altogether. SOMETHING A queue is considered "SOMETHING" (ie, of interest) if at least one job in it is being displayed. ACTIVE,INACTIVE A queue is considered active if it has one or more jobs executing, inactive otherwise. EMPTY,NONEMPTY To determine whether a queue is empty, all jobs (regardless of username) are examined. NORMAL,ABNORMAL Stalled, paused, stop pending, stopped are all classed as abnormal. EXECUTION,GENERIC Every queue that is not generic is considered an execution queue. ANYTHING Catch-all for completeness. /JOBNAME -- name(s) of job(s) which are to be displayed /JOBNAME[=([-,]job-name[,job-name...]) List of one or more batch and/or print job-names of interest; wildcards are supported. Only jobs which match the name(s) will be displayed. If the first element of the list is a dash ('-'), then only jobs that do NOT match names will be displayed. /ON_NODE /ON_NODE[=([-,]node-name[,node-name...]) List of one or more VAXcluster nodes of interest; wildcards are supported. Only queues that execute on the node(s) will be displayed. If the first element of the list is a dash ('-'), then only queues NOT on the node(s) will be displayed. Note: appropriate for VAXcluster systems only; also, incompatable with /IF=(GENERIC,NOEXECUTION). /output -- destination of output; defaults to SYS$OUTPUT /output[=file-spec] /SUMMARY -- display job counts by job-status category /SUMMARY /USERNAME -- user(s) whose jobs are to be displayed /USERNAME[=([-,]user-name[,user-name...]) List of one or more VMS usernames of interest; wildcards are supported. Only jobs owner by the user(s) will be displayed. If the first element of the list is a dash ('-'), then only jobs NOT owned by the user(s) will be displayed. The default value is the current user. Note: the /ALL_JOBS qualifier still controls whether any jobs owned by other users may be displayed. /WIDTH /WIDTH=value Specifies line width used when formatting /FULL data. The default value is 80 columns. Note that the base display does not attempt to stay within this limit.