insert/job

Insert a list, environmental variable or input stream into a job.

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.

General Format

insert/job job_name [/qualifiers] input_file_name

or

insert job_name /symbol [/qualifiers] symbol

or

insert job_name [/qualifiers] sys$input | stdin | *

Alternate

insjob job_name [-qualifiers] input_file_name or

SYMBOLS or

sys$input | stdin | *

The inserted list can come from the following sources:

• List in input file - The name and path of a text file containing a list will be inserted into the COMMANDS, INITIATES, PREREQUISITES, ACTIVATED_BY, HOLDS_UP, RESOURCES, ENDACTIONS or NOTICES list.
• SYMBOL - Insert the designated environmental variables that have been created using the more -symbols command.
• sys$input or stdin or * - A series of keystrokes may be interactively entered at the prompts, each followed by the return key.The keystrokes will be saved to the COMMAND list.

Qualifier Summary

general qualifiers:

/[no]log

/[no]confirm

/nocheck

/node = target_node

section identifiers:

/commands (default)

/prerequisites

/symbol

/initiates

/distribution

/notices

/holds_up

/activated_by

Examples

C:\> schedule insert/job incremental/commands extract_job_a.txt

Qualifiers

/activated_by

The "ACTIVATED_BY list" is the list of jobs that activate the job being edited.

/commands

The COMMANDS qualifier is the list of VMS commands that will be submitted in the form of a command file.

/confirm

/noconfirm

CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.

/hostname=host_name

The qualifier specifies what node (either local or remote) you want the operation performed on.

/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

The ENDACTIONS listing is a list of resource adjustments that are to be run upon completion of the job.

/holds_up

The "HOLDS_UP list" is a list of jobs that are held up by the job being edited.

/initiates

The "INITIATES list" is the list of other jobs to start up when this one completes successfully.

/log

/nolog

The LOG qualifier causes each completed operation to issue a note to the user.

/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

The "PREREQUISITES list" is the list of other jobs that must be successfully completed before this one is started.

/resources [/check, /expanded, /full]

Displays 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.

The CHECK qualifier performs a syntax check on the resource list to ensure the correct IF-THEN and set statements can take effect. The EXPANDED qualifier used in conjunction with CHECK will display expanded information about the current status of the resource list. The FULL qualifier will give a complete listing of resource information

/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.