REPORT
REPORT {CPM|IPM}
[,INTERVAL={30|nn|HOUR|QTR|HALF|SMF}]
[,RUNTIME={1440|nnnn}]
[,SYNCH={00|nn|HOUR|QTR|HALF|SMF}]
[.CSA=({32|nnnn},{32|nnnn},{0|nnnn})]
[,SMFRECID={240|nnn}]
[,DSNLIST=(dsn1,...,dsn101)]
[,DSN='dsn']
[,ALTDSN='dsn']
[,SMF={NO|YES}]
[,DISP=NEW]
[,GBLS={NO|YES|1000...|9000}]
[,SRVCLASS={SYSSTC|WLM-RULE}]
[.WKQE=({32|nnnn},{32|nnnn})]This statement is required for all BMC Software products that use the CMF MONITOR Extractor.
Note
You can use system symbols with the DSN, DSNLIST, and ALTDSN parameters of the REPORT statement.
REPORT statement controls include the following Extractor functions:
monitoring mode
runtime value
recording interval
location of where data is to be recorded
For example, Extractor output is written to SMF, if all of the following conditions exist:
SMF=YES and SMFRECID parameters are specified.
DSN, ALTDSN, and DSNLIST parameters are not specified.
Monitoring modes | One REPORT statement must be specified for each monitoring mode, continuous (CPM) or intermittent (IPM). | |
Sampler and record types | The REPORT statement controls both the RECD and GBLS samplers, which produce CMF type 240-11 and 240-00 user records, respectively. | |
Analyzer statements and reports | none Note The GBLS=YES parameter must be defined on the REPORT control statement for
| |
Other BMC Software products | The REPORT control statement must be defined in the Extractor control statement set for BMC products that use the CMF MONITOR Extractor, which includes the MainView for z/OS product. | |
Parameters
The parameters for the REPORT control statement are:
| CPM or IPM | specifies whether the Extractor and all of its samplers are to operate in continuous (CPM) or intermittent (IPM) mode This positional parameter must be specified. |
|---|---|
| INTERVAL= | specifies a number, representing minutes, or a keyword parameter The default is 30 minutes. The maximum allowable numeric value is 60; the minimum allowable numeric value is 1. Note The INTERVAL parameter works in conjunction with the SYNCH parameter. Keyword parameters are described in the following list:
Note The INTERVAL parameter works in conjunction with the SYNCH parameter. If you define INTERVAL=SMF, do not define a value for the SYNCH parameter, unless you define Double SYNCH=SMF. It is not necessary to define both parameters, because defining one of these parameters with the SMF value causes the Extractor to use the same recording and synchronization values defined to SMF. |
| RUNTIME= | specifies the number of minutes that the execution of the Extractor is to remain active. This parameter is intended primarily for use with IPM mode. CPM mode should be allowed to run as long as possible so that long-term trending data can be collected. The default is 1440 (untimed), which is also the maximum value. If the specified interval is greater than run time, the run time uses the default of 1440. The minimum value is 2. Note This time value is for elapsed time, not CPU time. |
| SYNCH= | specifies the number of minutes into the hour to which the recording interval is synchronized The recording interval is defined by the INTERVAL parameter. The SYNCH parameter works in conjunction with the INTERVAL parameter by determining the start time of recording, whereas the INTERVAL parameter defines the amount of time that passes between the times that records are gathered by the Extractor. The maximum SYNCH value is 60 minutes; the minimum value is 00, which is the default. Keyword parameters define the same time values as they do for INTERVAL, Note If you define SYNCH=SMF, do not define a value for the INTERVAL parameter, unless you define INTERVAL=SMF. It is not necessary to define both parameters, because defining one of these parameters with the SMF value causes the Extractor to use the same recording and synchronization values defined to SMF. |
| CSA= | specifies the amount of extended CSA to be allocated to the Extractor The CSA parameter provides three subparameters to specify the size of the initial and subsequent blocks of CSA, respectively, and the maximum amount of CSA that can be allocated to the CPM/IPM monitor. The parameter is coded as one, two, or three subparameters, each separated by a comma and all enclosed in parentheses as follows. The first subparameter specifies the size of the initial allocation of CSA. If not specified, the default value is 32K. During CPM/IPM monitor initialization, FNQEs are allocated contiguously from this block if the size of the block permits. (For performance reasons FNQEs and WKQEs are allocated contiguously, if possible.) After all of the FNQEs have been allocated, the WKQEs are allocated. If possible, they are also allocated from this area. If not, a new block of CSA is allocated from which they are then allocated. The second subparameter specifies the size of the second and all subsequent blocks of CSA that can be allocated by the CSA Manager. If not specified, the default value is 32K. At least one secondary CSA block is always allocated with the intention of containing CSA that is required by samplers for control areas, data areas, and code segments. Thereafter, additional CSA is allocated as needed for the duration of the life of the CPM/IPM monitor execution. |
| SMFRECID= | specifies the ID to be assigned to the CMF MONITOR user records that are written by the Extractor If you intend to write CMF MONITOR records to SMF, SMFRECID must be defined. The value specified must be between 128 and 255. The default value is 240. Note The SMFRECID value must be unique from all other SMF record IDs used by software on your system. CMF MONITOR is unable to verify this condition for you. If SMF=YES is specified, SMFRECID must also be specified. |
| DSNLIST= | specifies the names of up to 101 pre-allocated, cataloged data sets that can be used by CMF Extractor to record its output Data sets are dynamically allocated. If this option is used, do not include the ddnames CMFCPMxx or CMFIPMxx in the CMF MONITOR Extractor JCL, and do not define the SMF=YES parameter in the REPORT statement. You can use this parameter instead of the DSN and ALTDSN parameters. You can specify DSNLIST=NULLFILE if you want the records to be discarded. This option can be useful if you are using IPM mode for running either CMF MONITOR Online or MainView for z/OS and do not need the records. |
| DSN= | specifies the name of a preallocated, cataloged data set that can be used by CMF Extractor to record its output The data set is dynamically allocated. If this option is used, do not include the ddnames CMFCPMxx or CMFIPMxx in the CMF MONITOR Extractor JCL, and do not define the SMF=YES parameter in the REPORT statement. Do not use this parameter if you use the DSNLIST parameter. |
| ALTDSN= | specifies the name of a pre-allocated, cataloged data set that is to be flipped to when the data set specified by DSN fills up with recorded data Use this parameter only if you also use the DSN parameter. If ALTDSN is used, do not include the ddnames CMFCPMxx or CMFIPMxx in the CMF MONITOR Extractor JCL, and do not define the SMF=YES parameter to the REPORT statement. |
| SMF= | specifies whether data should be written to the SMF data sets or an SMF logstream If SMF=YES is specified, SMFRECID must also be specified explicitly. NO is the default. Note
|
| DISP=NEW | specifies at initialization that the primary CMF MONITOR Extractor output data set is to be rewritten from the beginning If you are recording to SMF, the DISP=NEW parameter is not required. The DISP=NEW parameter applies only at CMF MONITOR Extractor initialization, when the primary output data set is first opened. When the primary data set becomes full and an alternate data set is switched to by the CMF MONITOR Extractor, the disposition automatically switches to MOD, and DISP=NEW has no effect. Note If you are using VSAM data sets and the first data set has already been opened (by the PERUSE utility, for example), the CMF MONITOR Extractor skips that data set. For more information about Extractor utilities, see Using. |
| GBLS= | specifies whether the global sampler is to gather data needed for the Link Pack Area (LINKPACK) report You can specify YES, NO, or a numeric value. NO is the default. NO specifies that no global sampling takes place and that CMF type 11 records are suppressed. YES specifies that global sampling is to take place and CMF type 11 records are to be created. If you use a value of YES, the sampling rate will be a default of 1000 milliseconds. If you want global sampling with a sampling rate other than 1000 milliseconds, you can specify the desired sampling rate as any multiple of 1000 between 1000 and 9000, for example, GBLS=2000, GBLS=8000, and so on. |
| SRVCLASS= | specifies whether the MVS PAS is to run in the SYSSTC service class SYSSTC or WLM-RULE can be specified. SYSSTC is the default. If SYSSTC is specified, upon CPM mode initialization and at the end of every recording interval of CPM mode, CMF MONITOR assigns the MVS PAS to the SYSSTC service class if it does not run in this service class. If WLM-RULE is specified, the MVS PAS runs in the service class determined by WLM classification rules. This service class should have an execution velocity goal of at least 80%. |
| TZOVRLAP= | controls the writing of records with overlapping local times when a backward Daylight Saving time change is detected
|
| WKQE= | controls the allocation of WKQEs The WKQE parameter is coded as one or two subparameters, each separated by a comma and all enclosed in parentheses as follows: WKQE=({32|nnnn},{32|nnnn}) The first subparameter specifies the initial number of WKQEs to be allocated during CPM or IPM initialization. The second subparameter specifies the number of WKQEs to be allocated when more WKQEs are needed than are available. Note BMC recommends omitting the CSA parameter, or specifying the default values. |
Examples
Example
REPORT IPM,INTERVAL=QTR,RUNTIME=30,SMFRECID=187,DSN='CMF.IPM.OUTPUT',
ALTDSN='CMF.IPM.ALT.OUTPUT'The CMF MONITOR Extractor is running in IPM mode. The CMF MONITOR Extractor writes SMF type 70 and CMF type user records with an ID of 187 every quarter-hour over a 30-minute period. The data is written to data set CMF.IPM.OUTPUT, and if that data set is filled, an alternate data set, CMF.IPM.ALT.OUTPUT is allocated.
Example
REPORT CPM,INTERVAL=30,SMFRECID=188The Extractor runs in CPM mode and writes SMF records and CMF type user records with an ID of 188 every 30 minutes. Defaults are used for CSA area (80K) and the runtime period (unlimited).
Example
REPORT IPM,RUNTIME=120,SMFRECID=199,SMF=YESThe CMF MONITOR Extractor runs in IPM mode and writes SMF records and CMF type user records with an ID of 199. The Extractor runs for 120 minutes. Data is written to the same destination to which SMF writes (SMF data sets or an SMF logstream). Defaults are used for the sampling interval (30 minutes) and CSA area size (80 K).
Comments
Log in or register to comment.