Previous Topic: OPTION Statement

Next Topic: PRIORITY Statement


PARMS Statement

The PARMS statement is optional. It lets you specify optional parameters to CA JARS during execution.

The date format indicator defines the date format on all report control statements and VSE job accounting records. If VSE data is to be processed, this must be the same as the supervisor date option specified at system generation time, either month/day/year or day/month/year.

The three date fields on the PARMS statement are used as the header dates for all reports generated in a given run. The date fields are alphanumeric and are not edited by CA JARS. They have no relationship to the selection or rejection of input accounting records. This function is controlled by the CRITERIA statement.

If omitted, the report begin date defaults to the lower limit date criteria as defined on the CRITERIA statement (if present). Similarly, 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. If omitted, the report run date is filled with the current system date.

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 EDP cost for an installation for a given time period. This value computes the distributed charge amount available for display. For example, if the total EDP cost for an installation is $60,000 for a given period of time, then all computer users for that period should theoretically account for this amount on a pro rata basis. If a certain customer or inhouse department used 10 percent of the total computer effort, then they should account for $6,000 toward the EDP budget.

Note: This is the distributed charge based on resources used versus the EDP cost, not the total charge based on resources used versus a billing algorithm.

The input exit name is an eight-character field identifying an exit routine to be given control each time an SMF record is read by CA JARS.

The account exit name is an eight-character field identifying an exit routine to be given control each time a record is about to be written to the account file.

The max line count field adjusts 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 report-level control statements. This feature is provided so that production runs which use many user-supplied statements do not have to list the control statements.

The dollar sign print flag provides 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 special characters. The default is to force the use of dollar signs where appropriate.

The sort core size field defines the amount of main storage to be used for sorting. A three-digit numeric value represents the amount of storage in 1K byte increments which overrides the default value of 960K. This default was established so large amounts of data, for example an entire month of data, could be processed efficiently. A daily run may not require as much storage. Be sure that the region size on the EXEC statement (JCL) accommodates the value coded here for SORT CORE SIZE AND 512K for CA JARS itself.

The sort message indicator causes the sort/merge program to display messages to the printer via the parameter MSG=AP. The default for this parameter is MSG=CP, specifying that only critical messages are to be printed.

Position

Field Length

Field Name

Notes

1

1

Reserved

Not used

2-9

8

Statement Type

PARMS

10

1

Date Format Indicator

blank: mm/dd/yy indicates date
1: dd/mm/yy option used

11-18

8

Report Begin Date


Defaults to dates on CRITERIA statement

19-26

8

Report End Date

27-34

8

Report Run Date

Defaults to current date in system

35-42

8

Operating Cost

Must be blank or numeric; 99999999V (dollars). If operating cost is used, you should have RATE statement for calculating cost.

43-50

8

Input Exit Name

blanks: no exit requested
xxxxxxxx: member or alias name

51-58

8

Account Exit Name

59-60

2

Max Line Count

Maximum lines per output report page; default is 60

61

1

Control Statement
Print Flag

blank: print control statements
1: suppress printing user-defined control statements
JARS system control statement always prints

62

1

Dollar Sign Print Flag

blank: print dollar signs
1: suppress printing dollar signs

63

1

Reserved

Not used

64-66

3

Sort Core Size

Core size for sort in K bytes; default is 960K

67

1

Reserved

Not used

68

1

Sort Message Indicator

blank: print CRITICAL messages only
1: print ALL messages

69-80

12

Reserved

Not used