Previous Topic

Next Topic

Book Contents

Book Index

Verification mode

In verification mode, the CTJXVER edit macro uses the following syntax:

CTJXVER [P]

When CTJXVER is invoked without the P option, the verification tests are performed using the latest default parameters.

Note: CTJXVER takes the value of VERIFICATION CRITERIA from the User IOA Profile or the site default profile member which is in the IOA Profile library (not the ISPF Profile library). The user must enter the JD screen in the IOA online environment to set the defaults (if needed). The user profile is saved only when the user exits the IOA online environment.

To set new default parameters, invoke CTJXVER with the P option. A window opens (see the following figure) allowing you to set the new parameters, before the verification.

Fig.JV.7.1 Control-M JCL Verify Defaults Facility

--------------   CONTROL-M/JCL VERIFY DEFAULTS FACILITY  ------------

COMMAND ===>

 

ENTER THE PARAMETERS BELOW:                                                 

MEMBER =>           LIBRARY =>                                              

USER=>          PROCDD=>          LINKDD =>                                 

NODE=>          SYSTEM=>          IOA ENV=>          AUTO ROUTE=> Y (Y/N/D)

SUMMARY FORMAT ===> D  (T/M/N/D)    T - TABLE  M - MESSAGES  N - NO SUMMARY

MESSAGE ID     ===> D  (Y/N/D)      Y - SHOW MSGID  N - HIDE MSGID D-DEFAULT

RULE TRACE     ===> D  (Y/N/D)      SHOW 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)    ODATE=>       (YYMMDD)

SITE STANDARDS RULES                 ==> D  (Y/N/D)    ENV => GENERAL

UTILITIES VALIDATION                 ==> Y  (Y/N/D)

MESSAGE LEVEL                        ==> D  (I/W/E/D)

 

Y - ALWAYS CHECK   N - NEVER CHECK    S - NO SPACE CHECK U - UTILITIES CHECK

E - ERRORS         W - WARNING        I - INFORMATION    D - DEFAULT

PRESS ENTER TO CONTINUE, END OR PF03/PF15 TO EXIT

The following table describes the configuration parameters of the Control-M JCL Verify Defaults panel and indicates the modes in which they are available (verification, reformatting, or enforcement). These parameters are only available under the ISPF editor.

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

Criteria

Description

VER

ENF

REF

SAVE CHANGES

Save the invocation parameter values into the user's profile member in the IOA.PROF library.

Valid values are:

  • N - NO (default)
  • Y - YES

Y

Y

Y

USER

Name of user who is currently logged on.

Y

N

N

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, seeJES2/3 Predefined PROCLIBs.

Y

Y

Y

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.

Y

N

N

NODE

Indicates the computer where the verification is being performed.

Y

Y

Y

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 *.

Y

Y

Y

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

Y

Y

Y

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.

Y

N

N

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.

Y

N

N

MESSAGE ID/

MSGID

Display message ID. Valid values are:

  • Y - Show Control-M JCL Verify messages and summary with message ID. Default.
  • 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.

Y

N

N

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.

Y

Y

Y

The following table describes the criteria that are available only in verification mode for verifying the JCL members:

Tab.JV.7.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 later 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

Note:

  • 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 criteria are associated with each user and are saved in the following profile variables:

Parent Topic

Syntax