A performance dictionary record holds specific information about each data field in a performance data record. It derives its information from predefined CICS® fields, and from any user-defined fields in the MCT specified for the CICS run. For programming information about the performance dictionary and data records, see the CICS Customization Guide. For information about the MCT definitions, see the CICS Resource Definition Guide.
To enable you to process SMF data sets that contain performance data records but not a dictionary record, DFHMNDUP writes a dictionary record to a sequential data set. The dictionary record is written to a data set specified on a DD statement with a ddname of SYSUT4. You must put this data set in front of any data set(s) you are processing and which contain performance data. You provide control information for the DFHMNDUP program in the SYSIN data set so that it can generate the correct dictionary record for the performance data you are processing. The values that are specified are used to construct the fields in the SMF Header and Product section. The relationship of DFHMNDUP SYSIN parameters to SMF fields is shown in Table 5.
SYSIN PARM | SMF Dsect field | Meaning |
---|---|---|
DATE | SMFMNDTE | Date record moved |
GAPPLID | SMFMNPRN | Product name (Generic APPLID) |
JOBDATE | SMFMNRSD | Job execution date |
JOBNAME | SMFMNJBN | Jobname of CICS job |
JOBTIME | SMFMNRST | Job execution time |
SAPPLID | SMFMNSPN | Specific APPLID |
SYSID | SMFMNSID | System identification |
TIME | SMFMNTME | Time record moved |
UPPERCASE | n/a | Uppercase output |
USERID | SMFMNUIF | User identification |
You specify control information for the DFHMNDUP program on the following parameters:
For example 96354 represents the 20th December 1996 and the date 2005354 represents the 20th December 2005. If you do not specify a date, the current date is used.
Remember that "generic" and "specific" applids apply only to systems that use XRF. CICS systems that do not use XRF have only one applid, which is the value defined in the "APPLID=3D" parameter.
Note, in particular, that you cannot use both VTAM generic resources and XRF. If you use VTAM generic resources, you should specify only one name on the APPLID system initialization parameter.
For example, the date 96354 represents the 20th December 1996 and the date 2005354 represents the 20th December 2005. If you do not specify a date, the current date is used.
If you do not specify a time, the current time is used.
You can enter each parameter on a separate line, with the parameter keyword starting in column one. Alternatively, you can enter all of the parameters on a single line, starting in column one, with each parameter separated by a comma. If your CICS used a default MCT, you can enter the MCT parameter as ‘MCT=NO’, ‘MCT=’, or ‘MCT=,‘.
For example, you can use the following three methods to specify the same control information for the DFHMNDUP program:
//SYSIN DD *
MCT=NO
SYSID=MVSA
GAPPLID=DBDCCICS
SAPPLID=DBDCCIC1
DATE=89256
TIME=000001
/*
//SYSIN DD *
MCT=
SYSID=MVSA
GAPPLID=DBDCCICS
SAPPLID=DBDCCIC1
DATE=89256
TIME=000001
/*
//SYSIN DD *
MCT=,SYSID=MVSA,GAPPLID=DBDCCICS,SAPPLID=DBDCCIC1,
DATE=89256,TIME=000001
/*