DISPLAY JOB

From VSI OpenVMS Wiki
Jump to: navigation, search

DISPLAY_JOB is a F$GETQUI() function that returns information about the next job defined for the current queue context. Before you make a call to F$GETQUI to request job information, you must make a call to display queue information (with the DISPLAY_QUEUE function code). The DISPLAY_JOB function code is similar to the DISPLAY_ENTRY function code in that both return job information. DISPLAY_JOB, however, requires that a call be made to establish queue context; DISPLAY_ENTRY does not require that queue context be established.

Format

F$GETQUI("DISPLAY_JOB", [item],object-id,[flags])

Item

Corresponds to a $GETQUI system service output item code. The following items are valid for DISPLAY_JOB:

Item Return Type Description Example
ACCOUNT_NAME String The account name of the owner of the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","ACCOUNT_NAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "WRITERS"
 
AFTER_TIME String The system time at or after which the specified job can execute.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","AFTER_TIME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "26-NOV-2019 05:07:09.51"
 
CHARACTERISTICS String The characteristics associated with the specified queue or job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","CHARACTERISTICS",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "3"
 
CHECKPOINT_DATA String The value of the DCL symbol BATCH$RESTART when the specified batch job is restarted.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","CHECKPOINT_DATA",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
CLI String The name of the command language interpreter (CLI) used to execute the specified batch job. The file specification returned assumes the device name SYS$SYSTEM and the file type EXE.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","CLI",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
COMPLETED_BLOCKS Integer The number of blocks that the symbiont has processed for the specified print job. This item code is applicable only to print jobs.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","COMPLETED_BLOCKS",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
CONDITION_VECTOR Integer The vector of three longwords. The first longword gives the completion status of the specified job. The second and third longwords give additional status about the print job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","CONDITION_VECTOR",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
CPU_LIMIT String The maximum CPU time limit specified for the specified job or queue in delta time. This item code is applicable only to batch jobs and batch execution queues.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","CPU_LIMIT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "   0 00:00:00.00"
 
ENTRY_NUMBER Integer The queue entry number of the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","ENTRY_NUMBER",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 70   Hex = 00000046  Octal = 00000000106
 
FILE_COUNT Integer The number of files in a specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","FILE_COUNT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 1   Hex = 00000001  Octal = 00000000001
 
FORM_NAME String The name of the specified form or the mounted form associated with the specified job or queue.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","FORM_NAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "DEFAULT"
 
FORM_STOCK String The name of the paper stock on which the specified form is to be printed.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","FORM_STOCK",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "DEFAULT"
 
INTERVENING_BLOCKS Integer The number of blocks associated with pending jobs in the queue that were skipped during the current call to F$GETQUI. These jobs were not reported because they did not match the selection criterion in effect for the call to F$GETQUI.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","INTERVENING_BLOCKS",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
INTERVENING_JOBS Integer The number of pending jobs in the queue that were skipped during the current call to F$GETQUI. These jobs were not reported because they did not match the selection criterion in effect for the call to F$GETQUI.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","INTERVENING_JOBS",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
JOB_COMPLETION_QUEUE String The name of the queue on which the specified job executed.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_COMPLETION_QUEUE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
JOB_COMPLETION_TIME String The time at which the execution of the specified job completed.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_COMPLETION_TIME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "17-NOV-1858 00:00:00.00"
 
JOB_COPIES Integer The number of times the specified print job is to be repeated.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_COPIES",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 1   Hex = 00000001  Octal = 00000000001
 
JOB_COPIES_DONE Integer The number of times that the specified print job has been repeated.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_COPIES_DONE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
JOB_CPU_LIMIT String TRUE or FALSE to indicate whether a CPU time limit is specified for the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_CPU_LIMIT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_ERROR_RETENTION String TRUE or FALSE to indicate whether the user requested that the specified job be retained in the queue if the job completes unsuccessfully.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_ERROR_RETENTION",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_EXECUTING String TRUE or FALSE to indicate whether the specified job is executing or printing.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_EXECUTING",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_BURST String TRUE or FALSE to indicate whether a burst page option is explicitly specified for the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_BURST",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_BURST_ONE String TRUE or FALSE to indicate whether burst and flag pages precede only the first copy of the first file in the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_BURST_ONE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_FLAG String TRUE or FALSE to indicate whether a flag page precedes each file in the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_FLAG",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_FLAG_ONE String TRUE or FALSE to indicate whether a flag page precedes only the first copy of the first file in the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_FLAG_ONE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_PAGINATE String TRUE or FALSE to indicate whether a paginate option is explicitly specified for the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_PAGINATE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_TRAILER String TRUE or FALSE to indicate whether a trailer page follows each file in the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_TRAILER",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FILE_TRAILER_ONE String TRUE or FALSE to indicate whether a trailer page follows only the last copy of the last file in the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FILE_TRAILER_ONE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_FLAGS Integer The processing options selected for the specified job. The integer represents a bit field. To find the settings of each bit in the field, use one of the following items in place of JOB_FLAGS:
  • JOB_CPU_LIMIT
  • JOB_ERROR_RETENTION
  • JOB_FILE_BURST
  • JOB_FILE_BURST_ONE
  • JOB_FILE_FLAG
  • JOB_FILE_FLAG_ONE
  • JOB_FILE_PAGINATE
  • JOB_FILE_TRAILER
  • JOB_FILE_TRAILER_ONE
  • JOB_LOG_DELETE
  • JOB_LOG_NULL
  • JOB_LOG_SPOOL
  • JOB_LOWERCASE
  • JOB_NOTIFY
  • JOB_RESTART
  • JOB_RETENTION_TIME
  • JOB_WSDEFAULT
  • JOB_WSEXTENT
  • JOB_WSQUOTA
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_FLAGS",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 32768   Hex = 00008000  Octal = 00000100000
 
JOB_HOLDING String TRUE or FALSE to indicate whether the job will be held until it is explicitly released.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_HOLDING",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_INACCESSIBLE String TRUE or FALSE to indicate whether the caller does not have read access to the specific job and file information in the system queue file. When FALSE, the DISPLAY_JOB and DISPLAY_FILE operations can return information for only the following output value item codes:
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_INACCESSIBLE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_LOG_DELETE String TRUE or FALSE to indicate whether the log file is deleted after it is printed.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_LOG_DELETE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_LOG_NULL String TRUE or FALSE to indicate whether a log file is not created.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_LOG_NULL",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_LOG_SPOOL String TRUE or FALSE to indicate whether the job log file is queued for printing when the job is complete.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_LOG_SPOOL",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_LOWERCASE String TRUE or FALSE to indicate whether the job is to be printed on a printer that can print both uppercase and lowercase letters.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_LOWERCASE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_NAME String The name of the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_NAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "GETQ"
 
JOB_NOTIFY String TRUE or FALSE to indicate whether a message is broadcast to a terminal when a job completes or aborts.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_NOTIFY",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_PENDING String TRUE or FALSE to indicate whether the job is pending.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_PENDING",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "TRUE"
 
JOB_PID String The process identification (PID) number of the executing batch job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_PID",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
JOB_REFUSED String TRUE or FALSE to indicate whether the job was refused by the symbiont and is waiting for the symbiont to accept it for processing.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_REUSED",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
JOB_RESTART String TRUE or FALSE to indicate whether the job will restart after a system failure or can be requeued during execution.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_RESTART",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "TRUE"
 
JOB_RETAINED String TRUE or FALSE to indicate whether the job has completed but is being retained in the queue.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_RETAINED",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_RETENTION String TRUE or FALSE to indicate whether the user requested that the job be retained indefinitely in the queue regardless of the job's completion status.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_RETENTION",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_RETENTION_TIME String Returns the system time until which the user requested the job be retained in the queue. The system time may be expressed in either absolute or delta time format.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_RETENTIO_TIME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "17-NOV-1858 00:00:00.00"
 
JOB_SIZE Integer The total number of blocks in the specified print job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_SIZE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 1   Hex = 00000001  Octal = 00000000001
 
JOB_STALLED String TRUE or FALSE to indicate whether the specified job is stalled because the physical device on which the job is printing is stalled.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_STALLED",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_STARTING String TRUE or FALSE to indicate whether the job controller is starting to process the job and has begun communicating with an output symbiont or a job controller on another node.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_STARTING",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_STATUS Integer The specified job's status flags. The integer represents a bit field. To find the settings of each bit in the field, use one of the following items in place of JOB_STATUS:
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_STATUS",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 2048   Hex = 00000800  Octal = 00000004000
 
JOB_SUSPENDED String TRUE or FALSE to indicate whether the job is suspended.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_SUSPENDED",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_TIMED_RELEASE String TRUE or FALSE to indicate whether the job is waiting for a specified time to execute.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_TIMED_RELEASE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_WSDEFAULT String TRUE or FALSE to indicate whether a default working set size is specified for the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_WSDEFAULT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_WSEXTENT String TRUE or FALSE to indicate whether a working set extent is specified for the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_WSEXTENT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
JOB_WSQUOTA String TRUE or FALSE to indicate whether a working set quota is specified for the job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","JOB_WSQUOTA",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "FALSE"
 
LOG_QUEUE String The name of the queue into which the log file produced for the specified batch job is to be entered for printing. This item code is applicable only to batch jobs.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","LOG_QUEUE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
LOG_SPECIFICATION String The name of the log file specified for a job. This item code is meaningful only for batch jobs that were submitted using the /LOG qualifier. If the batch job log was created by default, an empty string will be returned. Use the JOB_LOG_NULL item code to determine whether a log file will be produced.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","LOG_SPECIFICATION",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
NOTE String The note that is to be printed on the job flag and file flag pages of the specified job. This item code is meaningful only for output execution queues.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","NOTE",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
OPERATOR_REQUEST String The message that is to be sent to the queue operator before the specified job begins to execute. This item code is meaningful only for output execution queues.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","OPERATOR_REQUEST",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
PARAMETER_1 to PARAMETER_8 String The value of the user-defined parameters that become the value of the DCL symbols P1 to P8 respectively.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","PARAMETER_1",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
PENDING_JOB_REASON Integer The reason that the job is in a pending state. The integer represents a bit field. To find the settings of each bit in the field, use one of the following items in place of PENDING_JOB_REASON:
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","PENDING_JOB_REASON",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
PRIORITY Integer The scheduling priority of the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","PRIORITY",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 100   Hex = 00000064  Octal = 00000000144
 
QUEUE_NAME String The name of the specified queue or the name of the queue that contains the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","QUEUE_NAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "SYS$PRINT"
 
REQUEUE_QUEUE_NAME String The name of the queue to which the specified job is reassigned.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","REQUEUE_QUEUE_NAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = ""
 
RESTART_QUEUE_NAME String The name of the queue in which the job will be placed if the job is restarted.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","RESTART_QUEUE_NAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "SYS$PRINT"
 
SUBMISSION_TIME String The time at which the specified job was submitted to the queue.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","SUBMISSION_TIME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "26-NOV-2019 05:07:09.51"
 
UIC String The user identification code (UIC) of the owner of the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","UIC",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "[WRITERS,JDOE]"
 
USERNAME String The user name of the owner of the specified job.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","USERNAME",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = "JDOE"
 
WSDEFAULT Integer The default working set size specified for the specified job or queue. This value is meaningful only for batch jobs and execution and output queues.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","WSDEFAULT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
WSEXTENT Integer The working set extent specified for the specified job or queue. This value is meaningful only for batch jobs and execution and output queues.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","WSEXTENT",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 
WSQUOTA Integer The working set quota for the specified job or queue. This value is meaningful only for batch jobs and execution and output queues.
 
SMAN43$ F = F$GETQUI("DISPLAY_JOB","WSQUOTA",,"FREEZE_CONTEXT")
SMAN43$ SHOW SYM F
  F = 0   Hex = 00000000  Octal = 00000000000
 

Object Id

Corresponds to the $GETQUI system service QUI$SEARCH_NAME, QUI$_SEARCH_NUMBER, and QUI$_SEARCH_JOB_NAME input item codes. The object-id argument specifies either the name or the number of an object (for example, a specific queue name, job name, or form number) about which F$GETQUI is to return information. The asterisk (*) and the percent sign (%) wildcard characters are not allowed with DISPLAY_JOB.

Flags

The following flags are allowed with DISPLAY_JOB:

  • ALL_JOBS requests that F$GETQUI search all jobs included in the established queue context. If you do not specify this flag, F$GETQUI returns information only about jobs that have the same user name as the caller.
  • EXECUTING_JOBS selects executing jobs.
  • FREEZE_CONTEXT: wWhen in wildcard mode, prevents advance of wildcard context to the next object. If you do not specify this flag, the context is advanced to the next object.
  • HOLDING_JOBS selects jobs on unconditional hold.
  • PENDING_JOBS selects pending jobs.
  • RETAINED_JOBS selects jobs being retained.
  • THIS_JOB selects all job file information about the calling batch job, the command file being executed, or the queue associated with the calling batch job.
  • TIMED_RELEASE_JOBS selects jobs on hold until a specified time.

Examples

Suppose you have a pending entry in SYS$PRINT:

$ sh queue
...
Generic printer queue SYS$PRINT

  Entry  Jobname         Username     Blocks  Status
  -----  -------         --------     ------  ------
     70  GETQ            JDOE              1  Pending


 

To work with DISPLAY_JOB, you need to establish a queue context first with a DISPLAY_QUEUE command.

$ C = F$GETQUI("DISPLAY_QUEUE","QUEUE_NAME","*","WILDCARD")
$ show sym c
$   C == "SYS$PRINT"
$ F = F$GETQUI("DISPLAY_JOB","ENTRY_NUMBER",,"FREEZE_CONTEXT")
$ show sym F
    F = 70   Hex = 00000046  Octal = 00000000106
$ F = F$GETQUI("DISPLAY_JOB","QUEUE_NAME",,"FREEZE_CONTEXT")
$ show sym F
$   F = "SYS$PRINT"