Insert a list, environmental variable or input stream into a job. The list is extracted using the extract command.
The INSERT command will insert a list in a file, environmental variables or an input stream into a job. Environmental variables and input stream are all inserted into the COMMAND list by default and therefore do not require the /JOB qualifier.
Windows/OpenVMS Format:
insert/job job_name [/qualifiers] input_file_name
or
insert job_name /symbol [/qualifiers] symbol
or
insert job_name [/qualifiers] sys$input or stdin or *
UNIX/Linux Format:
insjob job_name [-qualifiers] input_file_name
or
insjob job_name -symbol [-qualifiers] symbol
or
insjob job_name [-qualifiers] sys$input or stdin or *
The inserted list can come from the following sources:
/[no]log or -[no]log
/[no]confirm or -[no]confirm
/[no]check or -[no]check
/node or -node = target_node
/commands or -commands (default)
/prerequisites or -prerequisites
/initiates or -initiates
/distribution or -distribution
/notices or -notices
/holds_up or -holds_up
/activated_by or -activated_by
/resources or -resources
/endactions or -endactions
Windows:
Schedule> insert/job socal_22 /commands c:\tmp\extract_job_a.txt
OpenVMS:
Schedule> insert/job [myjobs]socal_22 /initiates [csmith]job.txt
UNIX/Linux:
Schedule> insjob /cache/all_codes -resources /tmp/allcodes.txt
/activated_by or -activated_by
The "ACTIVATED_BY list" is the list of jobs that activate the job being edited.
/commands or -commands
The COMMANDS qualifier is the list of commands that will be submitted in the form of a command file.
/[no]confirm or -[no]confirm
CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.
/hostname or -node =hostname
The qualifier specifies what node (either local or remote) you want the operation performed on.
/distribution or -distribution
The "DISTRIBUTION list" is a list of PRINT commands to be issued. The idea is to provide a central mechanism for maintaining the how many, where to, and what printer information in a common location separate from the job command stream.
/endactions or -endactions
The ENDACTIONS listing is a list of resource adjustments that are to be run upon completion of the job.
/holds_up or -holds_up
The "HOLDS_UP list" is a list of jobs that are held up by the job being edited.
/initiates or -initiates
The "INITIATES list" is the list of other jobs to start up when this one completes successfully.
/[no]log or -[no]log
The LOG qualifier causes each completed operation to issue a note to the user.
/[no]check or -[no]check
The NOCHECK qualifier disables the CHECK whether or not a provided prerequisite or initiate list makes references to any non-existent jobs.
/notices or -notices
The "NOTICES list" is a free format text entry that is used by the NOTIFICATION procedure to augment the various messages that it sends.
/prerequisites or -prerequisites
The "PREREQUISITES list" is the list of other jobs that must be successfully completed before this one is started.
/resources or -resources
Edits a list of generalized resources. The resource list is where the bulk of advanced job programming occurs. Here IF-THEN or SET statements are processed that can check or alter the value of a variable, supress a job run or cause a wait to occur.
/symbol or -symbol
Inserts the contents of the designated environmental variable into the command list of the job. The symbol is created using the type/symbol command.