Batch Submit Utility function
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
COMMAND ===>
JCL for Background Execution:
JOBCAT DSN ===>
JOBLIB DSN ===>
JOB Statement Information:
===> //USERID9R JOB (9999,ABCD,1,5),"NAME 1",CLASS=A,TIME=1,
===> // MSGCLASS=A,NOTIFY=USERID9
===>
===>
Use ENTER to continue
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
COMMAND ===>
EXEC JCL statement:
User control cards ===> N (Y = Yes; N = No)
Program name ===> FILEAID
EXEC parms ===>
Step name ===> STEP01
STEPCAT ===>
STEPLIB ===>
SYSOUT class ===> *
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
Batch Submit Utility Input screen
COMMAND ===>
Input DD JCL statement:
Verify dataset existence ===> Y (Y = Yes; N = No)
Multiple input DD statements ===> N (Y = Yes; N = No)
Concatenated input ===> N (Y = Yes; N = No)
DDNAME ===> DD01
DSN ===>
DISP ===> SHR
VOL SER ===>
UNIT ===>
LABEL ===>
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
COMMAND ===>
Output DD JCL Statement:
Verify dataset existence ===> Y (Y = Yes; N = No)
Multiple output DD statements ===> N (Y = Yes; N = No)
DDNAME ===> DD01O
DSN ===>
DISP ===> OLD
VOL SER ===>
UNIT ===>
LABEL ===>
Space Information:
UNITS ===> PRIMARY ===>
SECONDARY ===> DIRECTORY ===>
OPTIONS ===>
DCB Information:
RECFM ===> LRECL ===>
BLKSIZE ===> OPTCD ===>
DSORG ===> DEN ===>
RKP ===> KEYLEN ===>
BUFNO ===> TRTCH ===>
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
COMMAND ===>
Control Statements:
1==>
2==>
3==>
4==>
5==>
6==>
7==>
8==>
9==>
10==>
11==>
12==>
13==>
14==>
15==>
16==>
17==>
18==>
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
COMMAND ===>
Control Input DD Statement:
Verify dataset existence ===> Y (Y = Yes; N = No)
Concatenated input ===> N (Y = Yes; N = No)
DDNAME ===> SYSIN
DSN ===>
DISP ===> SHR
VOL SER ===>
UNIT ===>
LABEL ===>
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
OPTION ===>
JCL FOR JOB TSOID01R HAS BEEN CREATED.
S - Submit generated JCL statements
E - Edit generated JCL statements, using ISPF edit
B - Browse generated JCL statements
G - Generate JCL for a new job
N - Generate another step within job stream
X - Exit Background submission
JOB Statement information:
===>//USERID9R JOB (9999,ABCD,1,5),"NAME 1",CLASS=A,TIME=1,
===>// MSGCLASS=A,NOTIFY=USERID9
===>//
===>/*
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).