GLOBAL statement


A single GLOBAL statement specifies information that pertains to each report you request.

The GLOBAL statement must be the first control statement that is specified. This statement contains keywords that control how the report is formatted:

COMPANY

specifies the title that is centered on the second line of all report header; the text must be enclosed within single quotation marks

INTERVAL

specifies the interval lengths in either seconds (S) or minutes (M)

The range of INTERVAL values is from 5S to 3600S. The default is 1M (one minute); however, if you specify a value of less than 5S (5 seconds), the value 5S is used.

Note

This keyword is ignored unless the RUNTIME keyword is specified.

LINECT

specifies how many lines of data are printed before a page break; the default is 60 lines

Note

If you specify a value outside the range of 2 to 32760 lines, the default value is used.

OUTDD

specifies the DD name that is defined in the CMFMON CMFRPORT JCL to which the CMFMON reports are written

Note

This parameter is mutually exclusive with the SYSOUT parameter. If both are specified, the following error message is issued:

CMFMG24E SYSOUT AND OUTDD PARAMETERS ARE MUTUALLY EXCLUSIVE

If the named DD statement is not found, CMBRPORT terminates with a return code and the following error message:CMFMG25E OUTDD PARAMETER NAMES DD THAT IS NOT IN STEP JCL

Further, DCB attributes of the data set specified by the DD statement specified OUTDD parameter must be:

RECFM=FBA,

LRECL=133,

BLKSIZE= some multiple of 133

If the output data set has attributes other than these, CMBRPORT terminates with a return code of 8, and the following error message:

CMFMG26E OUTDD DD STATEMENT NAMES FILE WITH INCORRECT ATTRIBUTES

RECTYPE

specifies which type of records are to be analyzed:

  • Specify CMF for analyzing records that are produced by CMF (default).
  • Specify RMF for analyzing records that are produced by RMF.

RUNTIME

specifies (in minutes) the length of time the CMFMON batch session is to remain active for running reports with real-time data

The range of RUNTIME values is from 1 to 10080 (one week).

Note

If your reports are produced based on historical data from a data set (specified with the CMF79 DD statement), this keyword is ignored.

If your reports are produced based on data from the XDS data buffer, you must omit this keyword.

SYSID

specifies the four-character SYSID of the system on which you want to produce reports

If you do not specify this keyword, the default value depends on the data source:

  • For historical data from a data set, data from all systems is included in the reports.
  • For real-time data, and data from the XDS data buffer, data from the local system is included in the reports. To obtain data from another system for your CMFMON batch reports, you not only must use the SYSID keyword but also must make sure that data from the remote system is available. For more information, see Using data from remote systems.

SYSOUT

specifies the sysout class of the data sets containing the output reports

Only alphanumeric values are valid. The default value is A.

Each report control statement generates a separate, dynamically allocated data set.

Note

If the CMF79MSG DD statement is not specified on the job JCL, a message data set is also allocated to this sysout class.

This parameter is mutually exclusive with the OUTDD parameter. See the explanation of the OUTDD parameter.

Report control statements

The following list shows the control statements that define the reports to be produced.

The reports themselves are listed in the Batch report control statements table.

  • ARD
  • ARDJ
  • ASD
  • ASDJ
  • ASRM
  • ASRMJ
  • CHANNEL
  • DDMN
  • DEVICE
  • DEVV
  • IOQ
  • PGSPP
  • PGSPS
  • SENQ
  • SENQR
  • SPAG
  • SRCS
  • TRX

You can use keywords with these statements to organize and to filter the contents of the reports. The same keywords are used with all control statements (except for GLOBAL). These keywords are described in Keywords for report control statements.





 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*