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.
|
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 |
|
|
40 |
An error occurred in the processing to open or read the disk configuration definition file or metric collection parameter file. |
|
44 |
|
|
48 |
|
|
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