Convert JCL Utility screen
Related Topics
The Convert JCL Utility screen in the following figure allows you to process an input partitioned data set (PDS) and then create an output PDS containing the modified and/or expanded JCL. This screen is accessed by entering option 7 on the Code Coverage Utilities menu.
This utility takes normal application JCL and converts it to run Code Debug TSO in unattended batch mode for capturing Code Coverage statistics. Optionally, Test Data Optimization (TDO) statistics can be collected. The utility then converts selected members or, conversely, an entire input library to the new format, storing the converted JCL in the output PDS or PDSE data set.
Type the required data in each field as displayed and press Enter to proceed to the next screen. When all required fields are entered, a batch job is submitted to execute the Convert JCL Utility. The batch Convert JCL Utility runs under TSO in batch and will require some adjustments during installation. Sample JCL is provided in SLXVSAMP member XVJCLCNV.
Convert JCL Utility Screen
Command ===>
"From" Dataset ===> 'ACMJET0.SAMPLE.REPOSIT'
Member ===> TEST (Blank for member list, "*" for all members)
"To" Dataset ===> 'ACMEVE1.SAMPLE.REPOSIT'
Remove all comments from converted JCL ===> N (Y=yes, N=no)
Replace like-named members ===> N (Y=yes, N=no)
Edit JOB statement override parameters ===> Y (Y=yes, N=no)
Enter/Edit Code Debug TSO datasets ===> Y (Y=yes, N=no)
Edit JCL before submitting job ===> Y (Y=yes, N=no)
Repository Dataset ===> 'ACMJET0.SME25.REPOSIT'
System Name ===> INVENTORY
Test ID ===> TEST # 4
TDO Dataset ===>
Held MSGCLASS ===> X
Press ENTER to process or enter END command to terminate
Input fields
The input fields are defined as follows:
Field | Description |
|---|---|
"From" data set | Specifies the input JCL library. This library may be either a PDS or PDSE data set. You may enter the data set name as unqualified or fully qualified with quotes. This field is limited to 46 characters or less. |
Member | Specifies the name of a specific member, an asterisk (*) for all members, or leave the Member field blank. If blank, a member selection list is displayed when you press Enter. This field is limited to 7 characters or less. |
"To" data set | Specifies the output JCL library (either a PDS or a PDSE) that will contain new JCL for Code Coverage. You must enter an already existing PDS/PDSE library. You may enter the data set name as unqualified or fully qualified with quotes. This field is limited to 46 characters or less. |
Remove all comments from converted JCL | Specifies whether all comments must be removed from the converted JCL. Select Y for Yes or N for No. |
Replace like-named members | Specifies whether any duplicate members found in the output library will be overwritten and replaced. Select Y for Yes or N for No. |
Edit JOB statement override parameters | Specifies whether a new screen must be displayed that allows you to replace selected portions of the job card in the application JCL. Select Y for Yes or N for No. |
Enter/Edit Code Debug TSO data sets | Specifies whether a new screen must be displayed to specify all data sets associated with product (including the source listing files). Select Y for Yes or N for No. |
Edit JCL before submitting job | Specifies whether you must edit JCL (in ISPF edit mode) that runs the batch Convert JCL Utility prior to submitting your job. Select Y for Yes or N for No. |
Repository data set | Specifies the name of the Code Coverage data set designated for saving results. This field is limited to 46 characters or less. |
System name | Specifies an arbitrary name used to differentiate results by application. This field is limited to 15 characters or less. |
Test ID | Specifies an additional name to subdivide results under system name. This field is limited to 15 characters or less. |
TDO data set | Optionally specifies the name of an existing physical-sequential, fixed-blocked, 80-byte record data set. If specified, TDO information will be collected along with Code Coverage statistics. If not specified, only Code Coverage statistics will be collected. (For more information, see Test Data Optimization.) |
Held MSGCLASS | A message class that is defined at installation as a held class. It is used to hold the output of a TYPRUN=SCAN job submission wherein the output can then be extracted as part of the conversion process. |