Using the PICTURE macro

The PICTURE macro describes a Monitor II session report to RMF™. Use the PICTURE macro to replace the USER description or add or replace any entry in either ERBBMENU or ERBFMENU. The PICTURE macro is located in SYS1.MACLIB.

The syntax of the macro and the meaning of each operand are as follows:

ID=name

The option or menu item that will identify the report.

The name must consist of one to eight alphameric characters. The first character must not be ‘R’; RMF takes ‘R’ to be a request to recall a report. For a display report, this name will appear on the menu frame.

GATHER=gathername

The name of the module RMF is to invoke to gather data for the report.

PFK=n

The PF key number associated with the report, where n is a one-digit or two-digit decimal identifier in the range of 1 to 24. For a display report, this number appears in the menu frame. If a PF key is not specified, the report is not associated with a PF key.

REPORT=reportname

The name of the module RMF is to invoke to format the header lines and data line(s) for the report.

RBLEN=length

The length of the relocate block generated by the data gatherer for each line in the report.

RPTTYP={R|T}

The type of report. T indicates a table report; R indicates a row report.

TITLE=‘title’

An optional report title. The title specified appears in the menu frame for a display session. The title must be enclosed in single quotation marks. Use a double quotation mark to represent any quotation mark used in the title. The title can contain up to 50 printable characters. However, a maximum of 35 characters can be printed or displayed; therefore, a title longer than 35 characters will be truncated to fit into the menu frame.

DGTEXT=‘dgdefaults’

The default operands that are passed to the data-gathering routine for the report. This field is optional; it is used when the report requires operands. The text must be enclosed in single quotation marks, and the maximum length of the text is 32 characters. Any characters are valid between the quotation marks. Use two quotation marks to represent any quotation mark used in the text. When more than 32 characters are specified, the text is truncated.

DRTEXT=‘drdefaults’

The default operands that are passed to the data-reporting routine for the report. This field is optional; it is used when the report requires operands. The text must be enclosed in single quotation marks. Use two single quotation marks to represent any quotation marks used in the text. Any characters are valid between the quotation marks. When more than 32 characters are specified, the text is truncated.

MAXRBS=nnn

The initial number of relocate blocks. This number is equivalent to the maximum number of data lines in the report. The field is optional; when it is omitted, the default is 1 when RPTTYP=R is specified, indicating a row report. When RPTTYP=T is specified, indicating a table report, the field defaults to zero; however, enough storage is provided to allow a relocate block for each address space possible in the system. The maximum value possible for MAXRBS is 32,767.

FBLEN=len

The total length of all data control sections of the SMF record. The default value is 0.

HELP={'*'|'panelname'}]

Name of ISPF panel (maximal 8 characters) that contains help for this report. If HELP is requested on this report during a Monitor II ISPF display session, the panel 'panelname' will be shown, if there is no message pending. If this option is omitted, '*' is generated by default which causes the tutorial displayed in such a case. The option has no effect for the TSO RMFMON session and for background sessions.

Except of GATHER, REPORT, TITLE, DGTEXT, DRTEXT, and HELP, all options are ignored, if the current picture is the second definition for a report with the same ID.