This section describes JES3 Control Statements as documented in the IBM z/OS JCL Manual.

This section provides information about the following topics:

• //*MAIN
• //*DATASET
• //*FORMAT
• //*PROCESS
• //*ROUTE XEQ
• //*NET
• //*NETACCT

//*MAIN

JES3 MAIN Statement

The MAIN statement defines processor requirements for the current job. Many of the parameters are used to override JES3 STANDARDS parameters.

Identifies the job with the specified processor, even though the job was not submitted from or run on that processor. It allows sysout data sets to be sent to a userID attached to the specified processor named in the USER parameter. This will apply to all sysout data sets for the job.

Specifies the maximum number of bytes of data permitted as spooled output for this job and what action to be taken if the maximum is exceeded.

The number of bytes in thousands is specified in a range from 1 to 999999.

The action to be taken if the range of sysout bytes is exceeded is indicated by the following keywords:

WARNING or W requests a warning be sent to the operator and the job continues.

CANCEL or C requests JES3 to cancel the job.

DUMP or D requests JES3 to cancel the job with a storage dump.

When the WARNING or W bytes-option is chosen, a percentage range from 10 to 100 in multiples of 10 can be specified. This will issue the operator warning message each time the maximum byte sysout range is exceeded by the percentage as the job continues. Messages are sent until the job ends or is canceled by the operator. For example, BYTES=(100,W,10) will issue a warning message when sysout bytes reaches 100000, 110000, 120000 and will continue until the end of job.

Specifies the maximum number of cards or records permitted as punched sysout for this job and what action to be taken if the maximum is exceeded.

The number of cards in hundreds specified in a range from 1 to 9999.

The action to be taken if the range of card output is exceeded is indicated by the following keywords:

WARNING or W requests a warning be sent to the operator and the job continues.

CANCEL or C requests JES3 to cancel the job.

DUMP or D requests JES3 to cancel the job with a storage dump.

When the WARNING or W cards-option is chosen, a percentage range from 10 to 100 in multiples of 10 can be specified. This will issue the operator warning message each time the maximum card range is exceeded by the percentage as the job continues. Messages are sent until the job ends or is canceled by the operator. For example, CARDS=(100,W,10) will issue a warning message when punched cards reaches 10000, 11000, 12000 and will continue until the end of job.

Specifies the job class for this job where classname is 1 through 8 characters.

Specifies when the job is required.

Specifies the deadline time using the following notations:

nM where n is 1 to 4 numbers from 0 to 1440 Minutes.

nH where n is 1 or 2 numbers from 0 to 24 Hours.

hhhh represents the 24-hour clock time from 0000 to 2400.

Identifies the installation-defined deadline algorithm which controls how the job’s priority is increased and is one character A to Z or 0 to 9. The algorithms are defined using the

$MJ,DEADLINE command.

Specifies the date when the time parameter takes effects. If date is omitted, the current date is assumed. One of the following formats is used:

mmddyy where mm is from 01 to 12, dd is from 01 to 31 and yy is from 01 to 99. The century is 19 by default.

mm/dd/yyyy where mm is from 01 to 12, dd is from 01 to 31 and yyyy is the year. This format must be used for dates after January 1, 2000.

Specifies on which date within a cycle the deadline falls. Rel is 1 to 3 numbers from 1 to 366. The value of rel depends on the cycle.

Identifies the length of a cycle as coded by the following keywords:

WEEKLY: Sunday is day 1; Saturday is day 7. If rel is greater than 7, rel defaults to 7.

MONTHLY: Day 1 is the first day of month. Days 28, 29, 30 and 31 are treated as the last day of the month. If rel is greater than 31, rel defaults to the last day of the month.

YEARLY: Day 1 is the first day of the year. Days 365 and 366 are treated as the last day of the year. If rel is greater than 366, rel defaults to the last day of the year.

By default, this parameter value is YES to verify that the expiry date on IBM standard labeled scratch output tapes has passed.

Indicates the job recovery option to be used if the system fails. If omitted, the JES3 default failure option is used which is defined during JES3 initialization. The FAILURE parameter will be ignored if automatic restart management is used.

RESTART requests that JES3 restart the job when the failing processor is restarted.

CANCEL requests that JES3 print then cancel the job.

HOLD requests that JES3 hold the job for restart.

PRINT requests that JES3 print and hold the job for restart.

Determines the fetch messages that will be issued to the operator for disk and tape volumes for this job.

ALL requests that JES3 issue fetch messages to the operator for all removable volumes specified in DD statements that request JES3-setup devices. This does not apply to permanently resident volumes.

NONE requests that JES3 not issue fetch messages.

SETUP requests that JES3 issue fetch messages to the operator for all volumes specified in DD statements identified in the //*MAIN SETUP parameter. FETCH=SETUP without coding the //*MAIN SETUP is the equivalent of FETCH=ALL.

The slash may be translated as ‘except for’ so that JES3 fetch messages are not issued for any volumes specified in DD statement ddname.

Requests that JES3 issue fetch messages only for the volumes specified in DD statement ddname.

By default, jobs enter the system with HOLD=NO. This parameter requests that JES3 put the job in operator hold status. The operator must request it‘s release.

Indicates the I/O-to-processor ratio for the job. This parameter is used to balance jobs selected for execution using the following ratio keywords:

iorate-option is LOW, MED or HIGH.

JOURNAL=journal-option

Indicates whether or not JES3 is to create a job journal for the job.

journal-option is YES or NO. The default is defined at initialization. Automatic restart management does not use the job journal when restarting jobs.

Indicates the maximum number of lines of data to be printed from this job‘s sysout data sets and the action to be taken if the maximum is exceeded.

The number of lines in thousands specified in a range from 1 to 9999.

The action to be taken if lines is exceeded is indicated by the following keywords: WARNING or W requests a warning be sent to the operator and the job continues. CANCEL or C requests JES3 to cancel the job.

DUMP or D requests JES3 to cancel the job with a storage dump.

When the WARNING or W lines-option is chosen, a percentage range from 10 to 100 in multiples of 10 can be specified. This will issue the operator warning message each time the maximum lines range is exceeded by the percentage as the job continues. Messages are sent until the job ends or is canceled by the operator. For example, LINES=(100,W,10) will issue a warning message when lines reaches 100000, 110000, 120000 and will continue until the end of job.

Specifies the approximate size of the largest step‘s working set in real storage during execution where nnnn is a decimal which specifies the logical region size in kilobytes (1K = 1 kilobyte = 1024 bytes).

Indicates that the job‘s sysout data sets are to be directed to the named group or network node. If omitted, sysout data sets are directed to the group of devices or node from which the job originated. ORG statements can be overridden using the DEST parameter on a //*FORMAT, OUTPUT JCL, or DD statement.

group specifies the name of an origin group.

nodename specifies a network node named as 1 through 8 characters.

remote specifies a remote work station or VM userID named as 1 through 8 characters and must be separated from the nodename by a period.

Specifies the maximum number of printed pages permitted as spooled output for this job and what action to be taken if the maximum is exceeded. Once a warning message has been issued, the STANDARD initialization statement or system defaults will override the value for maximum number of printed pages allowed.

The number of pages to be printed is specified in a range from 1 to 16777215.

The action to be taken if the range of pages is exceeded is indicated by the following keywords:

WARNING or W requests a warning be sent to the operator and the job continues.

CANCEL or C requests JES3 to cancel the job.

DUMP or D requests JES3 to cancel the job with a storage dump.

When the WARNING or W pages-option is chosen, a percentage range from 10 to 100 in multiples of 10 can be specified. This will issue the operator warning message each time the maximum printed pages range is exceeded by the percentage as the job continues. Messages are sent until the job ends or is canceled by the operator. For example, PAGES=(1000,W,10) will issue a warning message when printed pages reaches 1000, 1100, 1200 and will continue until the end of job.

Names the procedure library that the system is to search for cataloged procedures called by EXEC statements in the job.

Identifies the last 2 characters of the ddname of a procedure library. xx is defined by the installation (IATPLBxx) in the procedure used to start JES3. If this parameter is coded, only the specified library is searched. SYS1.PROCLIB is not searched. By default, PROC=ST for batch jobs uses SYS1.PROCLIB.

Indicates whether or not JES3 is to check the status of the tape reel ring for tape devices. The default is RINGCHK=YES.

Modifies the standard setup algorithm used in assigning devices to a job before it’s execution.

JOB requests that JES3 allocate all of JES3 managed devices before the job executes.

HWS requests that JES3 do a high watermark setup allocating the minimum number of devices required for the step using the greatest number of devices of each type.

THWS requests that JES3 do a high watermark setup for tapes only.

DHWS requests that JES3 do a high watermark setup for disks only.

The slash may be translated as ‘except for’ so that JES3 does not request device allocation for the explicit ddname.

Requests that JES3 request device allocation only for the explicit ddname.

Indicates the spool partition in which JES3 is to allocate spool space to this job.

Specifies the name of the spool partition as 1 through 8 characters.

Indicates the processor that is to execute this job. If the processor is named specifically, it must also be specified on the CLASS initialization statement for the job class. If the SYSTEM parameter is used, it must agree with other parameter assignments as in //*MAIN using CLASS or TYPE, DSP requested with //*PROCESS and all devices specified must be available.

ANY indicates any global or local system that satisfies the job’s requirements.

JGLOBAL indicates that the job is to run on the global processor only.

JLOCAL indicates that the job is to run on a local processor only.

Indicates that the job is not to run on the named processor or processors.

Indicates that the job is to run only on the named processor or processors.

Indicates whether or not scratch tape requests and specific tape requests are separated and whether or not tapes of different media types are separated during high watermark processing. This is valid only if high watermark setup has been specified on the SETUP parameter.

IGNORE specifies that both scratch and specific tape requests are allocated on the same tape drive.

PREFER requests that JES3 try to allocate separate tape drives without allocating additional devices.

REQUIRE specifies that scratch and specific tapes be allocated on separate drives even if additional devices are required.

Specifies the number of track groups to be assigned to the job. A track group is a number      of spool space allocation units defined in the GRPSZ parameter on the JES3 BUFFER or SPART initialization statements. //*MAIN TRKGRPS overrides a TRKGRPS parameter on the CLASS or MAINPROC initialization statements. The TRKGRPS parameter on a DD statement overrides the //*MAIN TRKGRPS.

Specifies the number of track groups to be initially allocated from 1 to 9.

Specifies the number of additional track groups to be allocated when more space is needed.

Indicates the control program that is to execute this job. By default, TYPE=ANY.

Identifies the procedure library data set that this job is to update and will cause all jobs trying to allocate this data set to be held.

dsname specifies the name of an unconcatenated data set.

Identifies the job with the specified TSO/E user named in userID as 1 to 8 characters.

//*DATASET

JES3 DATASET Statement

The DATASET statement is used to mark the beginning of an in-stream data set named by the ddname. The //*ENDDATASET marks the end of the data set.

JCL within the //*DATASET stream is not supported in JES3 or a JES2 compatibility mode.

Specifies the name of the in-stream data that follows the //*DATASET.

Is 1 through 8 characters; the first must be alphabetic.

Defines card-reading mode used only for card-image. By default, MODE=E which is used for EBCDIC validated disk and tape files.

Indicates how JES3 is to recognize the end of the in-stream data set. By default, J=NO which means a JOB statement ends the data set. YES indicates a //*ENDDATASET statement ends the data set.

Identifies the output class JES3 is to use for the data set. By default or if omitted, CLASS=NO and the system will assign an output class.

MSGCLASS uses the MSGCLASS parameter on the JOB statement or a specific output class can be coded.

//*FORMAT

JES3 FORMAT Statement

The FORMAT PR statement permits special processing of sysout data sets that are printed. The FORMAT PU statement permits special processing of sysout data sets that are punched.

PR for printed sysout. PU for punched sysout.

This keyword is required and a file can be named or not. If null, then parameters apply to all sysout data sets except ones with another //*FORMAT PR or //*FORMAT PU statement. For example, //*FORMAT PR,DDNAME=,DEST=ANYLOCAL will print all sysout data sets in this job on any local printer.

Identifies the DD statement that defines the file to be printed or punched using as many or as few qualifiers as required.

JESYSMSG instead of a named file, requests printing of JCL statements and messages for this job.

JESMSGLG instead of a named file, requests printing of JES3 and operator messages for this job.

Requests a specific carriage tape for printing. CARRIAGE and FCB parameters cannot be coded on the same //*FORMAT PR statement.

Specifies the carriage tape for the 3211, 3203-5 or 1403 printer.

Identifies the name of the carriage tape as 1 through 8 characters. SYS1.IMAGELIB must contain a module for each carriage tape name for the 3211 and 3203-5 printers.

Requests one or more character-arrangement tables for printing sysout on a 3800 Printing Subsystem.

Requests the standard character-arrangement table specified at JES3 initialization.

Each character-arrangement table is named as 1 through 4 alphanumeric or national ($, #, @) characters. Parentheses are required around a list of table names. Null positions are invalid.

Gives the number of logical records to be transmitted to an SNA work station as an SNA chain and indicates whether normal output checkpoints are to be taken for this printed or punched sysout data set.

CHNSIZE default sends the sysout data set as a single SNA chain without normal JES3 checkpoints.

Specifies the SNA chain size in pages from 1 to 255. The size of a page is determined by the value of mmm and the carriage control characters in the data that skip to channel 1.

Specifies the number of logical records in a page, from 1 to 255, when the data contains no carriage control characters.

Specifies the compaction table for JES3 to use when sending an SNA data set to be printed or punched to an SNA remote terminal as defined during JES3 initialization.

The name of the compact table is 1 through 8 alphanumeric characters.

Indicates that carriage control for a printed data set is controlled by the data records or by this parameter.

One of four keywords as follows:

Indicates that each logical record begins with a carriage control character. Other carriage control options that are part of the logical records are available using the DCB macro and coded in the JCL statement.

Requests single spacing when carriage control is not present in the logical records.

Requests double spacing when carriage control is not present in the logical records.

Requests triple spacing when carriage control is not present in the logical records.

Indicates how many copies of the sysout data set are to be printed. The default is 1.

The number of copies from 1 to 254 in page sequence.

Used only on the 3800 Printing Subsystem to specify how many copies of each page are to be printed before the next page. Up to 8 group values from 1 to 255 but the total of all groups must not exceed 255. Group values override nnn.

Routes the output from the sysout data set to a printer. This parameter overrides the //*MAIN statement ORG parameter. By default, the first available originating printer is used.

Any local printer is used as specified in the output class in the SYSOUT parameter on the DD statement.

Requests a local printer by a symbolic name as 1 through 8 alphanumeric or national ($, #, @) characters defined during JES3 initialization.

Requests a local printer by a 3 or 4 digit hexadecimal number. A slash may precede a 3 digit number. A slash must precede a 4 digit number.

Identifies a group of local printers, an individual remote station or a group of remote stations by a symbolic name as 1 through 8 alphanumeric or national ($, #, @) characters.

Identifies a node by a symbolic name defined during JES3 initialization as 1 through 8 alphanumeric or national ($, #, @) characters.

Identifies a remote work station or VM userID to which the receiving node directs output.

Indicates a device classification. type is in the form of (gggssss) where ggg is the general device classification and ssss is the specific device classification. The type must be enclosed in parentheses. The type must be defined during JES3 initialization. For example, type for a 3800 is (PRT3800).

Identifies the external writer that is to process the sysout data set at the destination node.

A name from 1 to 8 alphanumeric characters which identifies a module defined to the remote JES3 node that is to execute the job. NJERDR is reserved for JES3.

Specifies the forms control buffer image JES3 is to use to guide printing by a 1403, 3211, 3202-5, 4245, 4248 or 3800 Printing Subsystem.

Identifies the FCB image name as xxxx being 1 through 4 alphanumeric or national ($, #, @) characters and are the last characters of a SYS1.IMAGELIB member name.

FCB2xxxx member for a 3211, 3203-5 or printer supported by SNA.

FCB3xxxx member for a 3800.

FCB4xxxx member for a 4248.

Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing Subsystem and optionally, to specify the number of copies.

Requests JES3 to use the standard forms overlay specified at JES3 initialization.

Identifies the forms overlay frame that the operator is to insert into the printer before printing begins as 1 through 4 alphanumeric or national ($, #, @) characters.

Specifies a number from 0 to 255 of copies that JES3 is to flash with the overlay. 0 to flash all copies.

Indicates the forms on which the sysout data set is to be printed.

Indicates the standard form defined during JES3 initialization.

Names the print forms as 1 through 8 alphanumeric characters.

Specifies whether or not punched output is to be interpreted.

Requests that JES3 interpret the punched sysout data set on a 3525 Card Punch with a Multiline Card Print feature. The default is NO.

Specifies a copy modification module that tell JES3 how to print the sysout data set on a 3800 Printing Subsystem replacing blanks or data in the data set.

Identifies a copy modification module in SYS1.IMAGELIB as 1 through 4 alphanumeric or national ($, #, @) characters.

Identifies which table-name in the CHARS parameter is to be used. This table reference character is 0 for the first table-name, 1 for the second, 2 for the third or 3 for the fourth.

Indicates whether or not the printer program should test for forms overflow.

Forms overflow control is not to be used. ON is default.

Specifies the priority at which the sysout data set enters the output queue.

A decimal number from 0 to 255 where 0 is the lowest priority and 255 is the highest.

Requests a stacker for 3800 Printing Subsystem output.

STANDARD indicates the standard installation default specified at JES3 initialization.

S indicates output is burst into separate sheets.

C indicates continuous fanfold forms stacking.

Specifies the maximum size for the sysout data set calculated as number of records multiplied by number of copies. When the threshold is exceeded, printing may be done on multiple printers.

Maximum records for a single sysout data set from 1 through 99999999.

Indicates the printer train to be used.

Specifies an installation-supplied printer train. STANDARD is the default.

//*PROCESS

JES3 PROCESS Statement

The PROCESS statement controls how JES3 processes a job by calling a Dynamic Support Program or DSP. CI, MAIN, OUTSERV and PURGE are ignored in a JES2 compatibility mode. A series of

//*PROCESS statements is terminated by a //*ENDPROCESS statement.

Specifies a called DSP. Parameters used in the DSP can be found in IBM JES3 Commands.

Supported but not applicable. JES3 Converter/Interpreter Service to interpret JCL and create control blocks.

Supported but not applicable. Main Service to process the program.

Supported but not applicable. Output Service to process the job‘s output.

Supported but not applicable. Purge Service to purge the job. Automatically created by JES3.

Control Block Print.

Display JES3 Dependent Job Control.

Invoke JES3 Dependent Job Control Updating.

Disk Reader.

Input Service Driver for JES3 Control Statement Processing.

Use JESNEWS Facility.

User-written DSP.

//*ROUTE XEQ

JES3 ROUTE XEQ Statement

The ROUTE XEQ statement sends a following input stream to a network node where the job is executed.

Indicates the node as an MVS JES2 system, an MVS JES3 global system, a VSE POWER node, or a VM system.

Identifies a guest system running in a virtual machine (VM); for example, an MVS system running under VM.

 //*NET

JES3 NET Statement

The NET statement is used to specify accounting information that is transmitted with a job to another node in the network a JES2 compatibility mode.

Use the //*NET statement to define the dependencies between jobs in a JES3 dependent job control (DJC) network. JES3 sets up a network of dependent jobs and executes them in a specific order. (Once set up, the structure of a JES3 DJC network cannot be changed unless all of the jobs in the network are resubmitted.)

Specifies the name of the JES3 DJC network for this job.

Is 1 through 8 characters; the first must be alphabetic. All jobs entering the system with the same NETID name form a JES3 DJC network. To add a job to an existing JES3 DJC network, specify the NETID name for that job.

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

Indicates that DJC 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.

DJC purges the network unless successor jobs or subnetworks are missing. If the ABCMP parameter is omitted, NOKP is the default.

Indicates that the JES3 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.

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

ABNORMAL = D | F | R 
NORMAL = D | F |    R

Indicates the action JES3 DJC 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.

Requests that JES3 DJC decrease this job’s NHOLD count, which indicates the number of predecessors for this job. When the NHOLD count becomes zero, JES3 DJC can release this job.

Requests that JES3 DJC flush this job and its successor jobs from the system. JES3 DJC cancels the job and cancels all successor jobs presently in the system, regardless of their normal or abnormal specifications. However, JES3 DJC admits into the system all successor jobs that enter after the JES3 DJC network has been flushed. To flush those jobs, the operator must cancel the jobs or the network.

Requests that JES3 DJC retain this job in the system and not decrease the NHOLD count. R suspends the job and its successor jobs from being released until either the predecessor job is resubmitted or the operator decreases the NHOLD count.

This keyword is supported for compatibility purposes only. If DEVPOOL is coded, it is ignored. Note that opening and closing brackets are required but the text inside the brackets is not parsed.

This keyword is supported for compatibility purposes only. If DEVRELSE is coded it is ignored.

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

Identifies the NETID for the successor job.

Names the JOB statement for the successor job.

Indicates the number of predecessor job completions required before this job can be released for scheduling. The predecessor number can include jobs from another JES3 DJC network.

is a number from 0 from 32767. 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. No hold is applied.
• If the NHOLD is incorrect, the following can occur:
• If n is greater than the actual number of predecessor jobs, DJC does not release the job for execution when all its predecessor jobs complete execution.
• If n is less then the actual number of predecessors jobs, DJC prematurely releases the job for execution.

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

Indicates that DJC is to hold the job until it is released by the operator.

Indicates that DJC is to allow the job to be scheduled.

Indicates that DJC is to flush the job from the system.

Indicates that the job is to be processed normally without operator intervention. If OPHOLD is omitted, NO is the default.

Indicates that JES3 DJC is to hold the job until it is released by the operator.

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

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 a 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 right parenthesis appears at the end of the list. For example:

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

//*WRITJB,JOBABC)

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

This keyword is supported for compatibility purposes only. If RELSCHCT is coded it is ignored.

Examples:

//*NET     NETID=NET01,NHOLD=0,RELEASE=NET02

This statement defines a DJC network named NET01. The network contains no predecessor jobs. This job must be executed before job NET02

//*NET    NETID=N1,RELEASE=B,NETREL=(N2,B2)

This statement adds a job to the DJC network named N1. This job must be executed before job B, which is in N1, and before job B2, which is in the JES3 DJC network named N2.

//*NETACCT

JES3 NETACCT Statement

The NETACCT statement is used to specify accounting information that JES3 is to transmit with a job to another node in the network.

Identifies the programmer.

Programmer’s name is 1 through 20 characters.

Gives the network account number.

1 through 8 characters.

Give the programmer’s building address.

1 through 8 characters.

Gives the programmer’s department number.

1 through 8 characters.

Gives the programmer’s room number.

1 through 8 characters.

Give the programmer’s network userid.

1 through 8 characters.