Parameter definition

NETID=name

Specifies the name of the DJC network for this job. name is 1 through 8 characters; the first character must be alphabetic.

All jobs put into the system with the same NETID name form a DJC network. To add a job to an existing DJC network, specify the NETID name for that job.

ABCMP=NOKP

ABCMP=KEEP

Indicates what action JES3 is to take if the job abnormally terminates.

NOKP: Indicates that JES3 is to purge the DJC network if the job abnormally terminates and has not been resubmitted by the time the other jobs in the network have completed. JES3 purges the network unless successor jobs or subnetworks are missing. If the ABCMP parameter is omitted, NOKP is the default.
KEEP: Indicates that the DJC network is to be kept in the system until (1) the job is resubmitted and completes normally or (2) the operator forces the network from the system. Use KEEP to make sure that the network is not purged until the operator takes proper action.

Note: If the job abnormally terminates, you can resubmit it to the DJC network, and the network will be retained until the job completes.

ABNORMAL=D

ABNORMAL=F

ABNORMAL=R

NORMAL=D

NORMAL=F

NORMAL=R

Indicates the action JES3 is to take for this job when any predecessor job completes execution normally or abnormally. If the ABNORMAL parameter is omitted, the default is R, and, if the NORMAL parameter is omitted, the default is D.

D: Requests that JES3 decrease this job’s NHOLD count, which indicates the number of predecessors for this job. When the NHOLD count becomes zero, JES3 can schedule this job.
F: Requests that JES3 flush this job and its successor jobs from the system. JES3 cancels the job, prints any output, and cancels all successor jobs presently in the system, regardless of their normal or abnormal specifications. However, JES3 admits into the system all successor jobs that enter after the DJC network has been flushed. To flush those jobs, the operator must cancel the jobs or the network.
R: Requests that JES3 retain this job in the system and not decrease the NHOLD count. R suspends the job and its successor jobs from scheduling until either the predecessor job is resubmitted or the operator decreases the NHOLD count.

DEVPOOL=(ANY[,device-name,n]...)

DEVPOOL=(NET[,device-name,n]...)

Identifies devices to be dedicated to this DJC network. The system allocates these devices only to jobs in the network. The DEVPOOL parameter should be coded on the //*NET statement that establishes the network; it is ignored on other //*NET statements.

ANY: Indicates that jobs in the network can use any dedicated or undedicated device. JES3 tries to allocate from the dedicated pool before allocating any undedicated devices.
NET: Indicates that jobs can use only devices dedicated to the network.
device-name,n: Identifies a dedicated device. Code as many device-names with numbers as will fit on one statement. device-name specifies (1) a device name defined to JES3 by the installation during initialization or (2) a device-type defined to the system in HCD. n is the number of named devices. n is a number from 1 through 32,767.

DEVRELSE=YES

DEVRELSE=NO

Indicates when devices dedicated to the DJC network are to be released. The DEVRELSE parameter can be coded in several jobs in the network, but must not be coded in the first job. If no network job containing DEVRELSE=YES completes, the system releases the devices when it purges the network.

YES: Requests that JES3 release all devices at the end of this job. Completion of any job that specified DEVRELSE=YES causes the devices dedicated to the network to be released.
NO: Requests that JES3 release all devices only when the last job in the network ends.

NETREL=(netid,jobname)

Indicates that this job must be executed before the named job in another DJC network can be executed. The NETREL parameter can be specified only once for each job of a DJC network.

netid: Identifies the NETID for the successor job.
jobname: Names the JOB statement for the successor job.

NHOLD=n

Indicates the number of predecessor job completions required before this job can be released for scheduling. The predecessor number can include jobs from another DJC network. n is a number from 0 through 32,767.

When the predecessor number reaches 0, the job is scheduled for execution. The system reduces this number:

When each predecessor job completes execution.
By operator command.
When a program in a predecessor job issues an assembler DJC WTO macro.

If you specify NHOLD=0 or omit the NHOLD parameter, this job has no predecessor jobs. JES3 can schedule it for immediate execution.

If the NHOLD count is incorrect, the following can occur:

If n is greater than the actual number of predecessor jobs, JES3 does not release this job for execution when all of its predecessor jobs complete execution.
If n is less than the actual number of predecessor jobs, JES3 prematurely releases the job for execution.

NRCMP=HOLD

NRCMP=NOHO

NRCMP=FLSH

Indicates that a network job that completed normally is being resubmitted and that JES3 must erase all references to the job before the job reenters the network.

HOLD: Indicates that JES3 is to hold the job until it is released by the operator.
NOHO: Indicates that JES3 is to allow the job to be scheduled as system resources become available.
FLSH: Indicates that JES3 is to flush the job from the system.

OPHOLD=NO

OPHOLD=YES

NO: Indicates that the job is to be processed normally without operator intervention. If OPHOLD is omitted, NO is the default.
YES: Indicates that JES3 is to hold the job until it is released by the operator.

RELEASE=(jobname[,jobname]...)

Indicates that this job must be executed before the named job(s) in this DJC network can be executed.

jobname: Names the JOB statement for a successor job. You can specify from 1 through 50 successor jobnames.

RELEASE is the only parameter on the //*NET statement that can be split and continued on the next statement. To continue the RELEASE parameter, end the statement with the comma following a jobname and continue the next statement with the next jobname. The left parenthesis appears at the beginning of the jobname list and the right parenthesis appears at the end of the list. For example:

   //*NET NETID=EXP1,RELEASE=(JOB35,JOB27Z,MYJOB,
   //*WRITJB,JOBABC)

RELSCHCT=n

Controls early set up of a dependent job’s resources. Set up begins when the NHOLD count becomes less than or equal to n. n is a number from 1 through 32,767.

If you specify RELSCHCT=0 or omit the RELSCHCT parameter, JES3 does not set up dependent jobs early.

Note: Use this parameter carefully; RELSCHCT can tie up devices and data sets for long times. Do not specify the RELSCHCT parameter:

For a job that may have catalog dependencies.
For a job that contains one or more //*PROCESS statements.