JCL for metric collection program

Mainframe Analytics Recorder User Guide

Version
10.1.x
Audience
anonymous
Part Number
MK-92HC226-08
ft:lastEdition
2026-01-30

Program name

JYTMMAIN

Function

Collects metric information and outputs SMF records. Start the JYTMMAIN program from the console by using the START command. If JYTMMAIN is started by a job or TSO, the program will terminate with an error.

Syntax

//EXEC PGM=JYTMMAIN[,PARM='CHECK']

Parameters

CHECK

The checks below are performed. Metric information is not collected. If this parameter is specified, the program can be started as a job.

  • Analysis and syntax check for metric collection parameters

  • Consistency check between the read disk configuration definition file and the metric collection parameter file

  • Validity check of I/O destination devices

Return codes

The following table lists and describes the return codes of the metric collection program.

Table. Return codes of the metric collection program

Return code

Meaning

0

The program ended successfully.

4

The program was forcibly terminated.

12

The program was not started by using the START command.

24

An attempt to write to SMF records failed.

36

  • The user does not have the necessary RACF permissions for execution.
  • The load module is not registered for APF authorization.

40

An error occurred in the processing to open or read the disk configuration definition file or metric collection parameter file.

44

  • A region shortage occurred.
  • An error occurred while the module was being loaded.

48

  • The parameter specified in the metric collection parameter file is invalid.
  • There is a syntax error in the disk configuration definition file.

52

DD (SYSPRINT) has not been defined.

64

The program ended abnormally.

Examples of cataloged procedures for startup of the metric collection program

//RSSTC PROC MEMBER=RSPRM00                                                     
//*********************************************************************
//*                                                                    
//* All Rights Reserved.
//* Copyright (C) 2024, 2026, Hitachi Vantara, Ltd.
//*                                                                    
//*********************************************************************
//JYTMMAIN EXEC PGM=JYTMMAIN,TIME=1440,REGION=4096K
//RSPARM   DD DSN=HITACHI.Vnnnnnn.HDSRSAMT(&MEMBER),DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//RSLOG01  DD DSN=USER01.RSLOG01,DISP=OLD,VOL=SER=WKVL01,UNIT=DASD
//RSLOG02  DD DSN=USER01.RSLOG02,DISP=OLD,VOL=SER=WKVL01,UNIT=DASD
  • EXEC statement

    Because the program is a resident program, specify TIME=1440 in the EXEC statement so that the program does not time out. In addition, specify one of the following so that the output messages do not cause a shortage of spool space.

    • Specify Purge as the output class of the job log and system messages.
    • Use the JOB statement keyword of the START command to specify that the JESLOG dataset is to be output by using the SUPPRESS setting.
  • RSPARM DD statement

    Specify the names of the dataset and member in which metric collection parameters are stored.

    Specify a dataset that has the following attributes.

    • DSORG: PO (member of PDS)
    • RECFM: F|FB
    • LRECL: 80
    • BLKSIZE: A multiple of LRECL

Examples of JCL for checking metric collection parameters

Specify CHECK for the PARM operand.

//USERIDA  JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID
//*********************************************************************
//*                                                                    
//* All Rights Reserved.
//* Copyright (C) 2024, 2026, Hitachi Vantara, Ltd.
//*                                                                    
//*********************************************************************
//JYTMMAIN EXEC PGM=JYTMMAIN,PARM='CHECK',REGION=4096K
//RSPARM   DD DSN=HITACHI.Vnnnnnn.HDSRSAMT(MEMBER),DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//RSLOG01  DD DSN=USER01.RSLOG01,DISP=OLD,VOL=SER=WKVL01,UNIT=DASD
//RSLOG02  DD DSN=USER01.RSLOG02,DISP=OLD,VOL=SER=WKVL01,UNIT=DASD