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 Standard tabs in the dialog boxes of the Storage Toolkit 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 that are used in the Storage Toolkit.
- Mainframe fully qualified dataset containing the batch JCL: Specifies the data set that
contains the batch job. The data set must be a sequential data set or a member of a partitioned data
set (PDS). The logical record length of the data set must be 80 and the data set must be a fixed
length format. To edit or create the data set, click the Edit JCL button, which causes the
Edit Data Set dialog box to be displayed.Note: The user ID for the Tivoli Enterprise Portal that you use must be authorized in the mainframe system to access the data set. When the user ID is not authorized, you see an error message when you click Edit JCL. For more information, see Standard tabs in the dialog boxes of the Storage Toolkit.
- Substitution variables and their run-time replacement values: Specifies replacement
values to be used at run time. The replacement values allow the batch job to reference specific
objects, such as data sets and volumes. For example, these objects might correspond to values in the
table rows that you select prior to invoking this dialog box.In the Variable column, you can enter a unique name for each substitution variable that exists in the data set. In the cells of the Attribute or string column, you can select from the available names. These names reflect attributes from the table rows that you selected in a workspace, prior to invoking the Create Batch Job dialog box. Alternatively, you can manually enter values in the cells. For example, you might want to enter values such as job name, sysout class, and other values that might not be present in the workspace table from which you are selecting rows.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.
- Files whose contents should be copied for later viewing: Specifies the DD names and data
sets to be preserved as a record of the results of the batch job. The files are available for
viewing in the Storage Toolkit Result Details workspace.In the Step name column, you specify the name of the step whose data you want to save. In the Fully Qualified Dataset or DD name column, you specify the sequential data sets, members of partitioned data sets, or DD names that you want to copy. The following table shows some sample settings for this area of the dialog box:The specification in row one preserves data from the USER02.LOG.LISTING data set.
Table 1. Sample settings for "Files whose contents should be copied for later viewing" Step name Dataset or DD name STEPX USER02.LOG.LISTING STEPY SYSPRINT The specification in row two preserves the SYSPRINT file in STEPY. This output is saved in the checkpoint file. The following restrictions apply:- Only sequential data sets or members of a PDS are supported.
- VSAM data sets are not supported.
- Data sets or files that contain unprintable characters (for example hexadecimal code) might display improperly in the Storage Toolkit Result Details workspace.
- Output lines longer than 256 characters are truncated.
- Fully Qualified Datasets needed by the job that also contain substitution variables:
Specifies data sets that are located outside the JCL job stream. Such data sets might be needed to
dynamically supply substitution variables that correspond to objects (such as data sets and volumes)
that are needed when the batch job runs. These additional data sets can be sequential data sets or
members of partitioned data sets. The logical record length of these data sets must be 80 and these
data sets must be a fixed length format.
For example, an IEHLIST job might use a SYSIN DD statement that points to a DASD data set rather than in-stream control cards. That data set could contain substitution variables that need replacement at execution time.
If no data sets that contain substitution variables are referenced from the JCL, this area of the dialog box can remain empty.
Be sure to consult the RKLVLOG for additional messages regarding these results.
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
- %job-name% (see line 000100)
- %sysout% (see line 000100)
- %my-volser% (see line 000800)
- %dsname% (see line 000800)
****** ***************************** 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 ****************************
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 /*
Note: Use of the )DOT and )ENDOT to aggregate results from multiple workspace rows into a single batch job is only supported for direct toolkit actions, such as, performing a multi-row select in a workspace view, then launching a toolkit action via the right-click menu. It is not supported for use in situation driven toolkit actions because the platform framework does not support launching a single action for multiple situation events.