Previous Topic

Next Topic

Insert data into a job (insert/job or insjob)

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:

Qualifier Summary

General Qualifiers:

/[no]log or -[no]log

/[no]confirm or -[no]confirm

/[no]check or -[no]check

/node or -node = target_node

Section identifiers:

/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

Examples

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

Qualifiers

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

See Also

JOB commands

Complete a job (complete/job or compjob)

Copy a job (copy/job or cpjob)

Create a job (create/job or mkjob)

Delete a job (delete/job or rmjob)

Display job properties (directory/job or lsjob)

Edit a job's lists (edit/job or edjob)

Extract a job's list data (extract/job or extjob)

Increment a job's next start time (increment/job or incjob)

Modify a job's properties (modify/job or chjob)

Rebuild job dependencies (rebuild/job or rebjob)

Rename a job (rename/job or mvjob)

Signal a scheduling event (signal/job or sigjob)

Submit a job for execution (submit/job or subjob)

Type a job's data lists (type/job or more)