HELP SYNCHRONIZE — VMS 5.5-2H4
Holds the process issuing the command until the specified job
completes execution.
Format
SYNCHRONIZE [job-name]
Additional information available:
PARAMETER
job-name Specifies the name of the job as defined when the job was submitted. You can specify only job names that are associated with your user name. (A job is associated with the user name of the process that submits it.) To specify a job that does not have a unique name, use the /ENTRY qualifier to specify the entry number. If you specify both the job-name parameter and the /ENTRY qualifier, the job-name parameter is ignored.
QUALIFIERS
Additional information available:
/ENTRY
/ENTRY=entry-number
Identifies the job by the system-assigned entry number.
The system assigns a unique entry number to each queued print or
batch job in the system. By default, the PRINT and SUBMIT commands
display the entry number when they successfully queue a job for
processing. These commands also create or update the local symbol
$ENTRY to reflect the entry number of the most recently queued
job. To find a job's entry number, enter the SHOW ENTRY or SHOW
QUEUE command. If you specify both the job-name parameter and the
/ENTRY qualifier, the job name is ignored.
/QUEUE
/QUEUE=queue-name[:]
Names the queue containing the job. If you use the /QUEUE
qualifier, you must specify either the job-name parameter or
the /ENTRY qualifier. If you specify the job-name parameter, the
default queue is SYS$BATCH. If you specify the /ENTRY qualifier,
there is no default queue.
EXAMPLES
1. $ SUBMIT/NAME=PREP FORMAT/PARAMETERS=(SORT,PURGE)
Job PREP (queue SYS$BATCH, entry 219) started on queue SYS$BATCH
$ SUBMIT PHASER
Job PHASER (queue SYS$BATCH, entry 223) started on queue SYS$BATCH
In this example, the first SUBMIT command submits the command
procedure FORMAT.COM for execution and names the job PREP.
The second SUBMIT command queues the procedure PHASER.COM. The
procedure PHASER.COM contains the following line:
$ SYNCHRONIZE PREP
When this line is processed, the system verifies whether the
job named PREP exists. The procedure PHASER is forced to wait
until the job PREP completes execution.
2. $ SUBMIT/NAME=TIMER COMP.COM
Job TIMER (queue SYS$BATCH, entry 214) started on queue SYS$BATCH
$ SYNCHRONIZE /ENTRY=214
In this example, a batch job named TIMER is submitted. Then
the SYNCHRONIZE command is entered interactively. This command
places the interactive process in a wait state until entry
number 214 (TIMER) completes. You cannot enter subsequent
commands from your terminal session until the SYNCHRONIZE
command completes and your process is released from the wait
state.