Online JCL Processing from IOA and Control-M Interfaces

Control-M JCL Verify can be invoked from the IOA Primary Option Menu for verifying, reformatting, or enforcing JCL jobs. When Control-M is installed, Control-M JCL Verify can be invoked from several Control-M user interface panels.

This chapter includes the following topics:

IOA Primary Option Menu

When Control-M JCL Verify is installed, the IOA Primary Option Menu provides the following options for processing JCL jobs, as shown in the following figure:

  • JD - JCL Verify Defaults - for specifying verification parameter defaults

  • JV - JCL Verification - for activating the verification, reformatting, or enforcement process on job members

  • JR - JCL Verify Rules - for specifying rules for site standard verification, reformatting, or enforcement

Fig.JV.6.1 IOA Primary Option Menu showing Control-M JCL Verify options

If Control-M is installed, the JD and JV options are provided under the Control-M column, as shown in the following figure.

Fig.JV.6.2 Control-M JCL Verify options with Control-M and Control-M/Restart

Control-M JCL Verify Defaults panel (JD screen)

To open the Control-M JCL Verify Defaults panel (see the following figure), enter JD in the option line in the IOA Primary Option Menu. Adjust the verification criteria settings or accept the current ones. The default settings are specified in the CTJPARM member.

Fig.JV.6.3 Control-M JCL Verify Defaults panel

Copy 
--------------  CONTROL-M/JCL VERIFY DEFINITION FACILITY - ENTRY PANEL  -------(JD)
COMMAND ===>
ENTER THE PARAMETERS BELOW: 
   PROCDD=>                LINKDD=> 
   NODE=> LOCAL          SYSTEM=>    IOA ENV=> LOCAL   AUTO ROUTE=> D (Y/N/D)
   SUMMARY FORMAT ===> D (T/M/N/D) T - TABLE M - MESSAGES N - NO SUMMARY D- DEFAULT
   MESSAGE ID     ===> D (Y/N/D)   Y - SHOW MSGID N - HIDE MSGID
   RULE TRACE     ===> D (Y/N/D)   SHOW TRIGGERED RULE INFORMATION

SPECIFY VERIFICATION CRITERIA
   JES SYNTAX                           ==> D  (Y/N/D)
   DATASET VERIFICATION                 ==> D  (Y/N/S/U/D) CNDALC=> D (Y/N/D)
   DATASET AUTHORIZATION                ==> D  (Y/N/D)
   PROGRAM EXISTENCE                    ==> D  (Y/N/D)
   RESOLVE CONTROL-M AUTO-EDIT VARIABLE ==> D  (Y/N/D)    
   SITE STANDARDS RULES                 ==> D  (Y/N/D)    ENV => GENERAL
   UTILITIES VALIDATION                 ==> Y  (Y/N/D)
   MESSAGE LEVEL                        ==> D  (I/W/E/D)

AUTO-SAVED REPORTS                                                            
   SAVE REPORTS => D (Y/N/D) Y - SAVE N - NO SAVE D - DEFAULT VALUES (CTJPARM)
   JREPPREF =>                     JREPVOL=>        JREPUNIT=>                

 
USE   Y - ALWAYS CHECK N - NEVER CHECK  S - NO SPACE CHECK U - UTITIES CHECK
      E - ERRORS       W - WARNING      I - INFORMATION    D - DEFAULT

The following table describes the configuration parameters of the Control-M JCL Verify Defaults panel. These parameters are only available under the ISPF editor.

Tab.JV.6.1 Control-M JCL Verify Defaults panel parameters

Criteria

Description

PROCDD

Name of a predefined DD card from which the procedures are resolved when the JCLs are verified. For example, PROC01.

The DD card must be predefined in JES PROCLIB or in the CTJPRC member and will be the only procedure library searched.

For more information, see JES2/3 Predefined PROCLIBs

LINKDD

Name of a predefined DD card in which the load modules are searched when the JCLs are verified. For more information, see CTJLINK: User Link Libraries for Program Existence Check.

NODE

Indicates the computer where the verification is being performed.

SYSTEM

Identifies the target SYSTEM in the target SYSPLEX.

Default: A blank specifies any SYSTEM in the target SYSPLEX.

Preference is given to SYSTEM with the same name as the originating SYSTEM, when IOA ENV is not blank or *.

IOA ENV

Identifies the target CTJMON by the QNAME of the IOA environment in the target SYSPLEX/SYSTEM.

Default: A blank specifies any IOA environment in the target SYSPLEX. Preference is given to the same IOA environment as that of the originating CTJMON when SYSTEM is not blank or *.

Masking: * has the same meaning as blank

AUTO ROUTE

Enables automatic routing so the JCL can be verified on different Control-M JCL Verify monitors located in different systems, depending on JES routing commands and JOB card routing keywords.

Valid values are:

  • Y - Enable automatic routing.

  • N - No, do not enable automatic routing.

  • D - as Defined in the AROUTE parameter in the CTJPARM member.

SUMMARY FORMAT/

SUMMFRMT

Display format for the message summary section. Valid values are:

  • T - Table format. Default.

    Consisting of the following 2 or 3 columns:

    • Label

    • Message ID (this column is displayed/hidden depending on parameter MSGID below)

    • Message text

  • M- Text Message format.

    Consisting of the following 2 lines per message:

    • First line - type of message and label

    • Second line - message text and Message ID (optionally, depending on the MSGID parameter setting, as described below)

  • N - No, the message summary section is not displayed.

  • D - as Defined by the JESTTMNT parameter in the CTJPARM member.

MESSAGE ID/

MSGID

Display message ID. Valid values are:

  • Y - Show Control-M JCL Verify messages and summary with message ID.

  • N - Show Control-M JCL Verify messages and summary without message ID.

  • D - Use the default setting as defined in the MSGID parameter in the CTJPARM member.

RULE TRACE

Display triggered rule information ID. Valid values are:

  • Y - Show triggered rule information ID.

  • N - No, the triggered rule information ID is not displayed.

  • D - Use the default setting as defined by the RULETRAC parameter in the CTJPARM member.

The following table describes the criteria for verifying the JCL members.

Tab.JV.6.2 Control-M JCL Verify verification criteria

Criteria

Description

JES SYNTAX

Whether to verify that the JES2 or JES3 statements are correct. Valid values are:

  • Y - Yes, always check

  • N - No, never check

  • D - as Defined by the JESTTMNT parameter in the CTJPARM member. Default

DATASET VERIFICATION

Whether to verify dataset. Valid values are:

  • Y - Yes, always check

  • N - No, never check

  • S - exclude SPACE check, but check everything else

  • U - perform file validation, without issuing any relevant messages, recommended for use with the Utility validation (UT=Y)

  • D - as Defined by the DSNEXIST parameter in the CTJPARM member. Default

CNDALC

Whether to consider datasets that are created or deleted by conditional steps as conditional references, and issue warnings when the dataset is referenced by a step later in the job if this reference may not be valid.

  • N – NO, Control-M/JCL Verify considers all steps as if they always run, regardless of being conditional or not.

  • Y – YES, Control-M/JCL Verify considers all the dataset references in conditional steps as references that may or may not occur and issues warning messages when a later step relies on it (because dataset status is in doubt).

  • D - as Defined by the CNDALC parameter in the CTJPARM.

For more information and examples, see Conditional dataset references

DATASET AUTHORIZATION

Whether to verify file access privileges. Valid values are:

  • Y - Yes, always check

  • N - No, never check

  • D - as Defined by the DSNACCSS parameter in the CTJPARM member. Default

PROGRAM EXISTENCE

Whether to verify that the load modules exist. Valid values are:

  • Y - Yes, always check

  • N - No, never check

  • D - as Defined by the PGMCHECK parameter in the CTJPARM member. Default

RESOLVE CONTROL-M AUTO-EDIT VARIABLE

Whether to resolve Control-M AutoEdit variables in the job. Valid values are:

  • Y - Yes

  • N - No

  • D - as Defined by the CTMVARS parameter in the CTJPARM member. Default

SITE STANDARDS RULES

Whether to verify site standards. Valid values are:

  • Y - Yes, always check

  • N - No, never check

  • D - as Defined by the STDR parameter in the CTJPARM member. Default

In the ENV field, specify which rules, in addition to the GENERAL rules, are to be used in the site standard verifications. The default value is GENERAL, indicating that only the GENERAL rules are to be used in the verifications.

UTILITY VALIDATION

Whether to verify the syntax of the IBM utilities (for details, see JCL and syntax verification) and the DB2 related validation.

Valid values are:

  • Y - Yes

  • N - No

  • D - as Defined by the SUPUTIL parameter in the CTJPARM member. Default

  • If the existence and the attributes of the datasets used in the IBM utilities must be verified, set DATASET VERIFICATION to Y or U, as described above in this table for the DATASET VERIFICATION parameter.

  • DB2 validation requires additional steps. See the "Enabling DB2 Support" section in the INCONTROL for z/OS Installation Guide: Installing.

MESSAGES LEVEL

The minimum level of message severity to be issued. Valid values are:

  • I - Information - all messages are issued.

  • W - Warning messages and errors are issued.

  • E - only Error messages are issued

  • D - as Defined by the MSGLEVEL parameter in the CTJPARM member. Default

The following table describes parameters for automatic saving of generated reports.

Tab.JV.6.2a Control-M JCL Verify Auto-Save Reports parameters

Criteria

Description

SAVE REPORTS

Whether to save reports generated through IOA or Edit-Macro. Valid values are:

  • D - Save the reports based on the parameters (JREPPREF, JREPVOL, and JREPUNIT) set in CTJPARM.

  • Y - Save the reports based on the parameters (JREPPREF, JREPVOL, and JREPUNIT) set on this screen.

  • N - Do not save reports.

JREPPREF

Defines a prefix for the flat file that contains the saved reports. Up to 19 characters.

Besides this prefix, the file name also includes the date and time when saved and the name of the verifying JCL.

JREPVOL

Defines the VOLUME where reports are saved.

To use SMS to manage the saving location, leave this parameter blank.

If you specify a value for JREPVOL, you must also specify a value for JREPUNIT.

JREPUNIT

Defines the UNIT where reports are saved.

To use SMS to manage the saving location, leave this parameter blank.

The criteria are associated with each user and are saved in the following profile variables:

  • SJVDJES (verify that the JES2 or JES3 statements are correct)

  • SJVDDSEX (verify dataset existence)

  • SJVDDSAU (verify file access privileges)

  • SJVDPGEX (load modules existence test)

  • SJVDUTL (the utility validation)

  • SJVDMSGL (minimum level of message severity to be issued)

  • SJVDCND (Conditional allocation consideration)

  • SJVDSVRP (whether to save reports)

  • SJVDPREF (prefix for file names of saved reports)

  • SJVDVOL (the VOLUME where reports are saved)

  • SJVDUNIT (the UNIT where reports are saved)

Control-M JCL Verify Facility (JV screen)

The Control-M JCL Verify Facility (JV screen) enables you to apply rules for verification, reformatting, and enforcement processes to entire libraries or individual members.

To verify, reformat, or enforce job members

  1. Enter JV in the option line of the IOA Primary Option Menu.

    The Control-M JCL Verify Facility - Entry Panel opens (see the following figure).

  2. In the LIBRARY field, enter the name of the library where the job members you want to verify, reformat, or enforce are located.

  3. In the MEMBER field, enter one of the options, described in the tablebelow, to indicate which job members you want to process, or leave the field blank for displaying the list of members, as shown in the figure following the table.

    Fig.JV.6.4 Control-M JCL Verify FACILITY - ENTRY PANEL

    Tab.JV.6.3 CTJVER options for MEMBER field

    Enter a...

    To perform...

    blank

    to open a list of all the job members in the specified library (Start the job verification by entering E or S in the OPT column next to the job member name. Note: E or S produce the same results. Start the reformatting process by entering R. Start the enforcement process by entering F.)

    *

    to process all the job members in the specified library

    mask

    to specify a mask for processing a group of job members

    name

    to specify the name of the job member to be processed

    Fig.JV.6.5 Control-M JCL Verify FACILITY - Members list

  4. In the OPT column next to the name of a member, type S or E to verify the member, R to reformat the member, and F to enforce the member.

  5. Press ENTER.

    A report is displayed, consisting of the JCL statements with the Control-M JCL Verify informative, warning, and error report messages appearing where applicable. To save the changed JCL, use the appropriate ISPF command.

    If the return code is greater than 04, reformatting and enforcement will not be performed. All the error messages and the rule's DO MSGs will be displayed at the beginning of the JCL.

Control-M JCL Verify Rule Definition Facility (JR screen)

To create or modify rules

  1. Enter JR in the option line of the IOA Primary Option Menu.

    The Control-M JCL Verify Rule Definition - Entry Panel opens (see the following figure).

  2. In the TABLE field, do one of the following:

    • enter the name of an existing table that contains the rule that you want to modify

    • enter the name of an existing table where you want to create a new rule

    • enter the name of a table that you want to create for containing new rules

    • leave the field blank for displaying a list of tables, from which you can select a table

  3. In the RULE field, enter the name of the rule that you want to modify, or leave the field blank for displaying the list of rules.

  4. In the TYPE field, do one of the following:

    • type ENF for enforcement rules

    • type REF for reformatting rules

    • leave the field blank for site standards rules

  5. Press ENTER.

    A list of tables containing rules is displayed.

  6. In the OPT column next to the name of a table, type S to select the table. Press ENTER.

    A list of the rules that the selected table contains is displayed.

  7. In the OPT column next to the name of a rule, do one of the following:

    • type S to select the rule and press ENTER. The Control-M JCL Verify rule definition panel opens for editing the rule.

    • type D to delete the rule and press ENTER. The rule is removed from the list of rules.

    • type I to create a new rule and press ENTER. The Control-M JCL Verify rule definition panel opens. Enter a name in the RULE field, and fill in any other fields, before exiting the rule definition panel by pressing F3. When exiting the table that contains this new rule, do one of the following:

      • type Y in the SAVE field to save the new rule in the table

      • type Y in the CREATE field and specify a new table name in the TABLE field, to save the new rule in a new table (Note: The new table will also include the rules from the previous table, in addition to the new rule.)

      • type N in either the SAVE field or CREATE field to avoid saving the new rule

  • type C to copy the rule and press ENTER. Specify the table to where you want the rule copied. Optionally, specify a new rule name if you want to change the name of the copied rule.

    Fig.JV.6.6 Control-M JCL Verify RULE DEFINITION - ENTRY PANEL

For more information about the Control-M JCL Verify Rule Definition Facility, see Reformatting, Enforcement, and Site Standards Verification.

Job verification from Control-M interfaces

Verifies all the JCLs pointed from or in-streamed in all the job definitions in the table. The verifications are according to the defaults specified in the JD option. The output of the verifications is displayed in view mode. The following table indicates which commands and options are available for invoking job verification from the various Control-M interfaces.

Tab.JV.6.4 Options and commands for verification from Control-M interfaces

Screen #/Description

Interface

Pop-up confirmation window

Option

Command

2

Control-M Job Scheduling Definition

 

 

 

 

Table List

 

 

E

 

Order/Force

 Y
(VERIFY JCL)

 

Job List

 

E

 

Order/Force

Y
(VERIFY JCL)

 

Job Scheduling Definition

 

 

JVER

View JCL

 

 

CTJXVER
(global name of edit macro)

3

Control-M Active Environment Display

 

 

Job List

 

E

 
 

Rerun/Restart

 Y
(Verify JCL)

 

Zoom and Save

  

 

JVER

View JCL

  

 

CTJXVER
(global name of edit macro)

If MULTJOBS=Y is specified in the CTMPARM member, only the first job will be submitted from the JCL member by Control-M. Therefore, if the JCL member to be verified contains more than one job, only the first job will be verified.

Return Codes

Tab.JV.6.5 Return Codes

Code

Description

0

Operation performed successfully.

4

Control-M JCL Verify discovered that the verified resource is not in the required status at the time of the verification. For example, an input dataset does not exist. Review the status and decide if there is a need to make a change in the job.

8

Control-M JCL Verify discovered a problem in the job that will cause it to fail with a JCL error or to be rejected by JES2 or JES3, either during job submission or execution. Correct the JCL in the job.

12

Error in the CTJXVER parameters or statements. Review the previous error messages in JOBLOG and SYSPRINT, and then correct the parameters or the control statements.

16 and above (except for 24, 30, and 112)

Internal error in the Control-M JCL Verify product. Try again. If the problem reoccurs, contact BMC Customer Support.

20

Invalid input parameter. Internal error.

24

Under ISPF: Control-M JCL Verify is not APF-authorized.

30

GETMAIN failed. The user needs to increase the TSO region.

32

GETMAIN error during initialization. Increase user region size.

34

IOA INIT failed. Review the TSO user's JESLOG for additional messages, and contact BMC Customer Support.

35

CTJAPI INIT failed. Review the TSO user's JESLOG for additional messages, and contact BMC Customer Support.

36

GETMAIN error during initialization. Increase user region size.

38

A parameter scan error. One or more input parameters are not valid. Perform CTJXVER P to correct the values. If the problem reoccurs, contact BMC Customer Support.

42

Error on IKJCT441. Internal error, check TSO user's JESLOG for additional messages, and contact BMC Customer Support.

46

No data returned from the Verify function (empty buffer). Internal error, check TSO user's JESLOG for additional messages, and contact BMC Customer Support.

50

An abend occurred returning from recovery routine MLIJ10034T. Review TSO user's JESLOG for additional messages, and call BMC Customer Support.

54

Control-M JCL Verify password is invalid or expired.

58

The specified member or library does not exist.

60

The CTJMON monitor is down or has not been started.

112

Under all environments except ISPF: Control-M JCL Verify is not APF-authorized.