Defining variables for JCL generation

When using the JCL Generator for the first time, you can define variables to be used when generating your JCL.

Job card parameters and IRUF selection information for the generated JCL is specified by selecting option 0, SETUP. The supplied information is used in the generated JCL. The same information is used for each job you run and is retained in your user profile data set for future use. You can change the information at any time before running a job.

Using the SetUp Menu, you can utilize the following options:

Define JCL defaults for the job card and data set names (Option A)
See To specify JOB parameters and JCL Generator options.
Define report execution parameters (Option B)
See To specify EXEC PARM options.
Specify basic filters for PRSSELEC data keyword parameters (Option C)
See To specify basic filters for an extracted IRUF.
Specify advanced filters for PRSSELEC data keyword parameters (Option D)
See To specify advanced filters for an extracted IRUF.

Note

Defining JCL defaults and report execution parameters are required. You must provide JCL information before you can generate JCL or run a generated job.

Before you begin

In order to generate JCL, you must first create an IRUF or have an existing IRUF that you can use.

To specify JOB parameters and JCL Generator options

Type 0 on the Select Option line and press Enter.The MVIMS SetUP Menu is displayed.
------------------------ MVIMS SetUp Menu -------------------------------------
                                                                 RELEASE v.r.mm
Select Option => A

* A JCL Setup        - Define JCL Defaults

* B PARM Exec        - Define Report Execution Parms

   C BASIC Filters    - Parms for PRSSELEC

   D ADVANCED Filters - Advanced Parms for PRSSELEC

   X EXIT             - Go back to Main JCL Generator Menu

Note: Option A and B are required. C and D are for filtering data only.
Type A on the Select Option field and press Enter.The MVIMS/PR JCL Defaults panel is displayed.
In the Job Card Parms fields, specify your JOB parameters.By default, the JOB statement LINE parameter is set to 999,999 and the TIME parameter is set to 1,440.
In the DSN Defaults fields, specify general DD statements.The BBLINK DSN field defines the high-level index for the MainView for IMS Offline runtime libraries. This information is supplied automatically by the CLIST used to start the JCL Generator, and it is checked to be sure it exists.
The SORTLIB DSN field defines the library for the modules loaded by an internally invoked sort program.
At least one IRUF must be specified. The first one specified is retained in your user profile data set for future use.
Warning
Note
You can specify detailed or summarized IRUFs, but you cannot mix the two types.
When finished, press Enter to save your variables and continue to the MVIMS/PR Report Execution Parms panel, where you can specify EXEC PARM options.

To specify EXEC PARM options

Type B on the Select Option field and press Enter.The MVIMS/PR Report Execution Parms panel is displayed.
On the MVIMS/PR Report Execution Parms panel, specify the EXEC statement PARM options.Many of the reports use EXEC statement PARM options. Some PARM options are used by many of the reports, such as a time period or a sort size. Other parameters are unique to a specific report, and yet other reports do not have any additional parameters.
The available PARM options for each report or utility are discussed in each report or utility section in this publication.
When finished, press Enter to save your variables and continue to the MVIMS/PR PRSSELEC Data Keyword Parms panel, where you can specify filters to create an extracted IRUF.
Warning
Note
If you press PF3 to return to the previous panel, your variables will not be saved.

To specify basic filters for an extracted IRUF

This optional procedure specifies basic filters for an extracted IRUF by using the PRSSELEC utility. An extracted IRUF contains a subset of the information in a detailed or summarized IRUF. If you do not specify any information, no extracted IRUF is created and all records in an IRUF are included in a report. For more information about creating an extracted IRUF, see IRUF-data-selection-extracted-IRUF.

Type C on the Select Option field and press Enter.The MVIMS/PR PRSSELEC Data Keyword Parms panel is displayed.
On the MVIMS/PR PRSSELEC Data Keyword Parms panel, identify the records you want to extract.Use the fields to extract records based on transaction name, program name, database name, LTERM name, MainView for IMS customer ID, DB2 application plan name, and Fast Path routing code.
Use the first set of fields to specify exact names, and use the second set of fields to specify qualified names. You can specify exact and qualified names, and you can specify a mixture of record types.
Warning
Note
Do not use * as a placeholder for a qualified name.
Leave a field blank (including all of them) if you do not want to filter the IRUF based on the field. The filters specified on this panel and the next panel are all applied to create the extracted IRUF.
When finished, press Enter to save your variables and continue to the MVIMS/PR PRSSELEC Data Keyword Parms panel 2, where you can specify advanced filters for extracted IRUF.

To specify advanced filters for an extracted IRUF

This optional procedure specifies advanced filters for an extracted IRUF by using the PRSSELEC utility.

Type D on the Select Option field and press Enter.The MVIMS/PR PRSSELEC Data Keyword Parms 2 panel is displayed.
On the MVIMS/PR PRSSELEC Data Keyword Parms 2 panel, specify additional filters for extracting records from the IRUF.Leave a field blank (including all of them) if you do not want to filter the IRUF based on the field. The filters specified on this panel and the previous panel are all applied to create the extracted IRUF.
When finished, press Enter to save your filters and return to the MVIMS SetUp Menu.
Enter X to go back to the main MVIMS JCL Generator menu.