Batch submit utility (3.9)

The Batch Submit utility is a screen-driven process for creating and submitting batch jobs. Execute, input, output and control statements can be generated in a fill-in-the-blank format. This function is designed to operate with any batch product.

To select the Batch Submit utility, type the number 9 in the OPTION field of the File-AID Extended Utilities menu, or as described in Selecting-screens. When you press Enter, the Batch Submit Utility Job Statement screen is displayed as shown in Batch Submit Utility jobcard Screen.

In addition, File-AID provides an F39 primary command that lets you recursively invoke the Batch Submit utility function. Enter the F39 command from any File-AID screen with an OPTION or COMMAND field. When you invoke the Batch Submit Job Statement screen in this way, use the END command (PF3) on the Job Statement screen, or use the RETURN command (PF4) anywhere in the Batch Submit function, to return to the screen from which you entered the F39 command. After the second session is completed, the original session is continued.

Jobcard Screen

The Batch Submit Utility Jobcard screen is the entry point for batch JCL creation. It is the first of a series of screens that File-AID displays as you complete the information required to submit a background job. This section describes the fields to be completed on each screen, beginning with the Batch Submit Utility jobcard screen.

Batch Submit Utility jobcard Screen

Field Descriptions

JOBCAT DSN

Optional: Specify a valid dataset name to specify a catalog other than the system default catalog. Use the naming conventions described in Pattern data set names for all background submission data set specifications.

JOBLIB DSN

Optional: Specify a valid dataset name to specify a load library which contains the batch program to execute.

JOB Statement Information

Specify jobcard information below the prompt while following all of the standard JCL jobcard rules plus any installation requirements. Once entered, the jobcard is saved from session to session. ISPF assumes that the first // card contains the jobname.

When you press Enter, File-AID displays the Batch Submit Utility EXEC Statement Screen shown in Batch Submit Utility EXEC Statement Screen.

EXEC Statement Screen

Batch Submit Utility EXEC Statement Screen

Field Descriptions

User control cards

Specify a value of Y (Yes) if the control statements are to be typed on the Batch Submit Utility Control Statement Entry screen (see Batch Submit Utility Control Statement Entry Screen). Specify a value of N (No) if the control statements are stored in a data set to be specified on the Batch Submit Utility Control Statement screen (see Batch Submit Utility Control Statement Screen).

The value in the User control cards field cannot be changed after you leave the Batch Submit Utility EXEC Statement screen. Verify the correct value in this field for all File-AID/Batch jobs.

Program name

Specify the name of the program to execute.

EXEC parms

Specify any parameters to be used by the program.

Step name

Specify the job step name.

STEPCAT

Specify the name of the catalog to use during execution of this step if other than the system default.

STEPLIB

Specify the name of the load library to use during execution of this step if other than the system default.

SYSOUT class

Specify the output destination.

When you press Enter, File-AID displays the Batch Submit Utility Input screen as shown in Batch Submit Utility Input Screen.

Input Screen

Field Descriptions

Verify dataset existence

Specify a value of Y (Yes) to have File-AID verify that the input data set name exists in the system. Specify of value of N (No) to have no verification of the dataset name.

Multiple input DD statements

Specify a value of Y (Yes) when more than one input data set must be specified. When Y is specified, File-AID redisplays the Batch Submit Utility Input screen for each data set. Specify a value of N (No) to not redisplay this screen.

Concatenated input

Specify a value of Y (Yes) when multiple input data sets are to be concatenated with the same DD name. When Y is specified, File-AID redisplays the Batch Submit Utility Input screen with the same DD name. Specify a value of N (No) when concatenation is not required.

DDNAME

Specify the input DD statement name.

DSN

Specify the input data set name.

DISP

Specify a valid disposition value. The default value is SHR.

VOL SER

Specify the volume ID in which the input data set resides if the data set is not cataloged.

UNIT

Specify a valid device type.

LABEL

If required, specify a valid label clause.

When you press Enter, File-AID displays the Batch Submit Utility Output screen as shown in Batch Submit Utility Output Screen.

Output Screen

The Batch Submit Utility Output screen is coded in the same way as an output file in JCL.

Batch Submit Utility Output Screen

Field Descriptions

Verify dataset existence

Specify a value of Y (Yes) to have File-AID verify that the out put dataset name exists in the system. Specify of value of N (No) to have no verification of the dataset name.

Multiple output DD statements

Specify a value of Y (Yes) when more than one output data set must be specified. When Y is specified, File-AID redisplays the Batch Submit Utility Output screen for each data set. Specify a value of N (No) to not redisplay this screen.

DDNAME

Specify the output DD statement name.

DSN

Specify the output data set name.

DISP

Specify the disposition value for the data set to be processed.

VOL SER

Specify the volume ID in which the output data set resides if the data set is not cataloged.

UNIT

Specify a valid device type.

LABEL

If required, specify a valid label clause.

Specify values for the size of the output data set below the SPACE Information prompt as follows:

UNITS

Specify a value of TRKS or CYLS to specify space units of tracks or cylinders, respectively. Enter a numeric value to specify the number of blocks.

PRIMARY

If required, specify numeric values in either tracks or cylinders.

SECONDARY

If required, specify numeric values in either tracks or cylinders.

DIRECTORY

For a PDS, specify a numeric value in blocks.

OPTIONS

Specify a valid JCL space option code.

Below the DCB Information prompt, specify values in the following data control block (DCB) fields according to standard JCL conventions:

RECFM

Specify the record format.

LRECL

Specify the logical record length.

BLKSIZE

Specify the block size.

OPTCD

Specify the option code.

DSORG

Specify the data set organization.

DEN

Specify the tape density.

RKP

Specify the relative location of the key within the record.

KEYLEN

Specify the key length.

BUFNO

Specify the number of buffers.

TRTCH

Specify the 7-track tape recording technique.

If the User control cards field on the Batch Submit Utility EXEC Statement screen was set to Y and you press Enter, File-AID displays the Control Statement Entry screen as shown in Batch Submit Utility Control Statement Entry Screen.

If the User control cards field was set to N and you press Enter, File-AID displays the Control Statement screen as shown in Batch Submit Utility Control Statement Screen.

Control Statement Entry Screen

Batch Submit Utility Control Statement Entry Screen

Field Descriptions

Control Statements

Below the prompt, type control statements in the syntax of the batch program being submitted. File-AID/Batch control statement syntax is discussed in the File-AID tutorials and the File-AID/Batch Reference manual.

Press Enter when all control statements are typed. File-AID displays the Batch Submit Utility Submit Menu as shown in Batch Submit Utility Submit Menu.

Control Statement Screen

The Batch Submit Utility Control Statement screen has the same format as the Batch Submit Utility Input screen. This screen allows you to specify a data set containing existing File-AID/Batch control statements.

Batch Submit Utility Control Statement Screen

Field Descriptions

Verify dataset existence

Specify a value of Y (Yes) to have File-AID verify that the control dataset name exists in the system. Specify a value of N (No) to have no verification of the dataset name.

Concatenated input

Specify a value of Y (Yes) when multiple control data sets are to be concatenated with the same DD name. When Y is specified, File-AID redisplays the Batch Submit Utility Control screen with the same DD name. Specify a value of N (No) when no concatenation is required.

DDNAME

Specify the control DD statement name. The default is SYSIN.

DSN

Specify the control dataset name.

DISP

Verify a value of SHR or OLD.

VOL SER

Specify the volume ID in which the control data set resides if the data set is not cataloged.

UNIT

Specify a valid device type.

LABEL

If required, specify a valid label clause.

When you press Enter, File-AID displays the Batch Submit Utility Submit Menu as shown in Batch Submit Utility Submit Menu.

Submit Menu Screen

 Batch Submit Utility Submit Menu

Field Descriptions

OPTION

To process the JCL, enter one of the following options. Selecting the X (Exit) option deletes the displayed JCL. To save the JCL, enter the E (Edit) option to create a new PDS member and store the JCL in it.

S - Submit the generated JCL

E - Edit the generated JCL

B - Browse the generated JCL

G - Generate JCL for a new job (repeat the submission process)

N - Add another step to this JCL (repeat the submission process)

X - Exit this process (delete the JCL).

Job Statement Information

The JCL displayed on the Batch Submit Utility submit menu contains the information entered on the Batch Submit Utility Jobcard screen, shown in Batch Submit Utility jobcard Screen.

Press Enter to process the selected option. When the option is executed, File-AID displays the message: JCL FOR JOB xxxxxxxx HAS BEEN SUBMITTED below the OPTION field of the Batch Submit Utility submit menu, where xxxxxxxx is the job number. Press END to exit the Batch Submit utility. You can save your JCL by entering the CREATE or REPLACE primary command when using option E (ISPF edit).