Previous Topic: Remote validation optionsNext Topic: ChekPlex logging


ChekPlex operator commands

ChekPlex accepts operator commands through CA GTS.

Format

Use the following format when issuing operator commands to ChekPlex:

F CAGTS,CMDCP CMD
CAGTS

Specifies the CA GTS started task name.

CMDCP

Indicates the command is for ChekPlex. This is a required keyword.

CMD

Specifies the ChekPlex command.

Commands

The following ChekPlex commands are available:

DEBUG(OFF|ON|v|vv)

The DEBUG command defines the debug level for ChekPlex. The number of debugging messages issued to the CPDEBUG DD in CA GTS depends on this setting. Setting this parameter to ON will slow down execution.

Use this option only when Support requests it.

The following command sets the debug level to standard for started task DAL01:

F DAL01,CMDCP DEBUG(ON)

The following command sets the debug level to very verbose for started task DAL02:

F DAL02,CMDCP DEBUG(vv)

DEBUGDD(ddname)

The DEBUGDD command defines the ddname used for the ChekPlex debug messages. This ddname must be allocated in the CA GTS initialization JCL and in the LOGGER parm member. Output to this ddname is produced only if DEBUG(ON) is specified.

Use this option only when Support requests it.

The following command defines CPDEBUG as the ddname for debug messages:

F DAL01,CMDCP DEBUGDD(CPDEBUG)

HARDEN[(dsname_prefix)]

The HARDEN command specifies that ChekPlex is to create catalogued files for the dynamically allocated work files that are used to store input JCL, input Procedures, and output reports.

The dsname_prefix value is optional and defines the data set name prefix to be used when creating the catalogued files. GTS and ChekPlex must have authorization to the specified prefix or security errors may occur.

If HARDEN is specified without dsname_prefix, then work file allocation returns to the default state of creating temporary, system-generated files and they are deleted after they are no longer required.

Use this option only when Support requests it.

The following command enables work file cataloging with a prefix of MY.RESULTS:

F DAL01,CMDCP HARDEN(MY.RESULTS)

The following command disables work file cataloging:

F DAL01,CMDCP HARDEN

STATUS

The STATUS command displays tracking information about each active ChekPlex remote validation request on a particular GTS server address space. The display informs you: which phase is currently being processed, when the phase began, and how long the phase has been processing.

There are 11 unique ChekPlex phases:

  1. Request in Local Server
  2. Request sent to Target Server
  3. Request in Target Server
  4. File allocation phase
  5. JCLCheck 'kernel'
  6. SYSPRINT handling
  7. SYSTERM handling
  8. SYSGRAPH handling
  9. Request left Target Server
  10. Request back in Local Server
  11. Request left Local Server

The following is an example of the STATUS command:

CACP04450I Request#  RCA_addr  TimeStrt  Duration  ChekPlex_Phase
CACP04460I --------  --------  --------  --------  --------------------
CACP04470I 00000003  364DC530  04:02:13  00:00:00  7) SYSTERM handling
CACP04470I 0000000E  2D5DC3B0  04:39:08  00:02:50  2) Request sent to Target
                                                      Server GTSJM11
CACP04470I 0000000F  2D5DC3B0  04:39:08  00:02:50  2) Request sent to Target
                                                      Server GTSJM31
CACP04470I 00000013  2D82E0E0  04:41:54  00:00:04  5) JCLCheck 'kernel'