The IMS Interface › Executing the Wizard Report Writer › Control Statements › PARMS Statement

PARMS Statement

The PARMS statement, identified by the statement type PARMS, is optional. It provides optional execution parameters to the Wizard Report Writer.

The three date fields on the PARMS statement are used as the header dates for all reports produced in a given execution. The date fields are alphanumeric and are not edited by the Wizard Report Writer. The date fields have no relationship to the selection or rejection of input records. This function is controlled by the CRITERIA statement discussed in detail earlier in this chapter.

If omitted, the report begin date defaults to the lower limit date criteria as defined on the CRITERIA statement (if present). In the same manner, the report end date assumes the upper limit date criteria value on the CRITERIA statement. In the absence of a CRITERIA statement, the begin and end dates are filled by the earliest and latest input record dates encountered, respectively.

The report run date is filled with the current system date, if omitted. Nonblank date fields on the PARMS statement override the defaults and are moved to their respective positions in the heading information for each report generated in a given run.

The operating cost field may be used to introduce the total IMS cost for an installation for a given period of time. This value is then used in computing the distributed charge output data element amount available for display by the user.

Maximum line count is used to adjust the maximum number of lines to be printed per page of output. A two-digit numeric value overrides the default value of 60 lines per page.

The control statement print flag suppresses the printing of all control statements so that production reports which may use many user-supplied statements do not have to list the control statements.

The dollar sign print flag field provides you with the option of producing financial reports with or without the dollar sign ($) appearing in charge-related output data elements. This is particularly useful for installations using a print chain with a limited number of dollar sign characters. The print rate can be increased considerably by avoiding the printing of many special characters. The default is to force the use of dollar signs where appropriate.

Sort core size may be used to define to the Wizard Report Writer the amount of main storage to be used by the sorting operation. A three-digit numeric value represents the amount of storage in 1K byte increments which overrides the storage option default value.

The sort message indicator causes the sort/merge program to display all of its messages in accordance with the installation's defaults. The default for this parameter is CRITICAL. As a substitute for the record counts, the Wizard Report Writer prints a concise message stating the number of records sorted for each invocation of the sort/merge program.