Definition of the PARM parameter
By entering the selection criteria through the PARM parameter, you can make the CX10CVBS program selectively copy records.
If no PARM parameter is entered, the entire data set is copied. The PARM parameter format for the program is
PARM='TYPE=xxx, SMFrecID[,SUB= nn][/[STARTAFT= n][,STOPAFT= n]]
Table 1 defines the CX10CVBS parameters. Examples of how to define PARM parameter values are shown in Table 2.
Table 1. CX10CVBS parameters
Parameter | Definition | |
|---|---|---|
TYPE=xxx | Defines the type of records to be processed from the input data set defined in the //SYSUT1 DD statement and copied to the output data set defined in the //SYSUT2 DD statement One of the following values can be defined for xxx: | |
RMF | Only RMF data recorded to the input data set by the RMF data gatherer is copied to the output data set. This value can verify that the RMF data is not corrupted by a system outage. | |
SMF | Only SMF data recorded to the input data set is copied to the output data set. This value can verify that the SMF data is not corrupted by a system outage. | |
CPM | Only CPM data recorded to the input data set by the CMF Extractor or type 79 records produced by the CMFMON Write Facility are copied to the output data set. | |
IPM | Only IPM data recorded to the input data set by the CMF Extractor is copied to the output data set. | |
CPR | Only CPM data recorded to the input data set by the CMF Extractor is copied, and CMF flags in the reserved field SMF7xRV2 are reset, thereby making the CMF data look exactly like RMF data. | |
IPR | Only IPM data recorded to the input data set by the CMF Extractor is copied, and CMF flags in the reserved field SMF7xRV2 are reset, thereby making the CMF data look exactly like RMF data. | |
SMF recID | Defines the ID of the specific SMF or CMF user record type(s) to be selected from the input data set You can define multiple values to the SMFrecID subparameter, if several record types are to be copied at once. In this case, the values must be enclosed in parentheses. Up to 16 record IDs can be specified. The default ID for CMF MONITOR records is 240. The following values show default ranges of record types for the SMFrecID subparameter, when a specific TYPE value is defined. Specific record types can also be defined if they are within the valid range of default values for any of the TYPE subparameters. | |
RMF | 70 through 79 If the SMFrecID value is omitted for TYPE=RMF, all RMF records (70 through 79) are copied. | |
SMF | 1 through 255 If the SMFrecID value is omitted for TYPE=SMF, all SMF records (1 through 69 and 80 through 127) are copied. | |
CPM | 70 through 79, and 128 through 255 If the SMFrecID value is omitted for TYPE=CPM, all CPM records are copied. | |
IPM | 70 through 79, and 128 through 255 If the SMFrecID value is omitted for TYPE=IPM, all IPM records are copied. | |
CPR | 70 through 79 CPM records, formatted to be like RMF records | |
IPR | 70 through 79 IPM records, formatted to be like RMF records | |
SUB=nn | Valid only with TYPE=CPM or TYPE=IPM; the following values are valid: 00 01 02 03 04 05 06 07 09 11 12 13 14 16 18 19 20 21 23 24 27 29 50 69 If the SUB=nn value is omitted, all CPM or IPM records are copied, and the SMFrecID value determines the SMF record ID for CMF Extractor user records. If the SMFrecID value is 70 through 79, then only the specific SMF record type is copied, and the SUB=nn value is ignored. | |
STARTAFT=n | Defines a starting point in the input data set for copy records This subparameter causes CX10CVBS to skip n records before beginning the copy operation. This subparameter must be preceded by a slash. | |
STOPAFT=n | Defines an ending point in the input data set for copy records This subparameter causes CX10CVBS to stop the copy operation after n records are skipped or copied. This subparameter must be preceded by a slash if no STARTAFT parameter is defined. If a STARTAFT parameter is defined, the STOPAFT parameter must be preceded with a comma. | |
Because of the many different record types and ID combinations that can be specified, examples are shown in Table 2.
Table 2. Examples of PARM values used to copy records selectively
Types of records to be copied | PARM=Value | Notes |
|---|---|---|
CMF CPM device activity user records (240-05) | TYPE=CPM,,SUB=05 | SMF RECID 240 is defaulted |
CMF CPM device activity user records (222-05) | TYPE=CPM,222,SUB=5 | SMF RECID 222 is used |
CMF IPM RMF type enqueue records (77) | TYPE=IPM,77 | none |
all RMF records (70 through 79) | TYPE=RMF | none |
SMF user records (128) | TYPE=SMF,128 | none |
RMF CPU records (70) | TYPE=RMF,70 | none |
all CMF CPM records (240) | TYPE=CPM | SMF RECID 240 is defaulted |
all CMF CPM records (230) | TYPE=CPM,230 | SMF RECID 230 is used |
CMF CPM global and LPA user records (240-11) and (240-16) | TYPE=CPM,,SUB=(11,16) | SMF RECID 240 is defaulted |
CMF CPM global and LPA user records (241-11) and (241-16) | TYPE=CPM,241,SUB=(11,16) | SMF RECID 241 is used |
RMF CPU and channel records | TYPE=RMF,(70,73) | none |
CMF CPM type 70 and 74 records and associated user records (240s) | TYPE=CPM,(240,70,74),SUB=(01,5) | none |
5th through 8th RMF CPU records | TYPE=RMF,70/STARTAFT=4,STOPAFT=8 | none |
copy CPM data removing CMF flags to make records identical to RMF-generated records. | TYPE=CPR | none |
copy 20 CPM records | Type=CPM/STOPAFT=20 | none |