Create Batch Job dialog box

You use this dialog box to submit user-defined JCL. This action request is a more flexible equivalent to the toolkit commands that the product provides.

The Options tab of this dialog box provides the fields that are described below.

To learn about the standard capabilities of a dialog box, see Standard tabs in the dialog boxes of the Storage Toolkit. The topic includes a link to the Reference guides for commands that are used in the Storage Toolkit.

See Conventions for JCL files that you use with the Storage Toolkit. Also see Authentication and authorization for running Storage Toolkit commands regarding the authorization that is required for the action requests of the Storage Toolkit.

When configuration of the batch job is complete, you click OK in the Create Batch Job dialog box. At this point, the JCL file that you provide and any files outside that JCL that contain substitution variables are copied into temporary files. These temporary files are used when the batch job JCL is submitted.

Conventions for JCL files that you use with the Storage Toolkit

The data set for the JCL that you create or edit must be a sequential data set or a member of a partitioned data set (PDS). Any JCL data set that you use with the Storage Toolkit must follow conventions to enable the Tivoli Enterprise Portal to substitute data values at run time. The following elements (marked in bold text in Figure 1) are substitution variables that will be altered by the Storage Toolkit at job run time:
  • %job-name% (see line 000100)
  • %sysout% (see line 000100)
  • %my-volser% (see line 000800)
  • %dsname% (see line 000800)
Figure 1. Variable elements for JCL files used with the Storage Toolkit
****** ***************************** Top of Data ******************************
000100 //%job-name% JOB (),'DHODS',REGION=4M,MSGCLASS=%sysout%,NOTIFY=&SYSUID, 
000200 //         CLASS=A
000300 //* ------------------------------------------------------------------- 
000400 //LISTVTOC EXEC PGM=IEHLIST                                             
000500 //SYSPRINT DD SYSOUT=*                                                  
000600 //SYSIN    DD *                                                         
000700 )DOT                                                                    
000800   LISTVTOC DUMP,VOL=3390=%my-volser%,DSNAME=(%dsname%)                  
000900 )ENDDOT
001000 /*                                                                      
001100 //                                                                      
****** **************************** Bottom of Data ****************************
Tip: Use the percent-sign convention for the substitution variables (%name%) that are present in your JCL data set. That way, this dialog box automatically finds and lists the JCL substitution variables.
The )DOT and )ENDDOT lines in Figure 1 indicate the start and end of table processing. The JCL lines between the )DOT and )ENDDOT lines are repeated for each table row that is passed into the mainframe agent at JCL execution time. Typically, these lines contain substitution variables that are replaced with new values at run time. For example, the output for these SYSIN JCL lines might look similar to this excerpt:
000600 //SYSIN    DD *                                                         
000700   LISTVTOC DUMP,VOL=3390=TSO201,DSNAME=(SYS2.USER.CLIST)                    
000800   LISTVTOC DUMP,VOL=3390=TSO202,DSNAME=(SYS2.USER.PROCLIB)                    
000900   LISTVTOC DUMP,VOL=3390=MVSA12,DSNAME=(SYS2.PROD.LOADLIB)                    
001000 /*