Create Reports Using the CA Easytrieve Reporting Service › Macros › SYSVCDEF Macro

SYSVCDEF Macro

The SYSVCDEF macro provides common definitions for global variables that various utility macros and subroutines use. SYSVCDEF includes the SMF record definitions needed by the canned reports. Invoke it as the first noncomment statement in the CA Easytrieve program.

The SYSVCDEF macro supports the following keyword parameters:

EACH

Determines the length of each reporting interval. The SELECT-BY-TIME subroutine of the SYSVPROC macro uses this parameter to set the TSTAMP value for each SMF record. For most reports, SMF data is aggregated for each reporting interval. Specify one of the following:

n DAY

Reporting interval is n days.

MONTH

Reporting interval is one month.

n HOUR

Reporting interval is n hours.

n MIN

Reporting interval is n minutes.

RECORD

Set the TSTAMP value for each SMF record set to the actual timestamp, without adjustment. In practice, this value prevents data aggregation.

Default: DAY

FROM

Determines the starting timestamp for SMF record selection. The SELECT-PROC subroutine uses this value to exclude SMF records which have timestamps earlier than the provided value. The timestamp is specified as YYYY/MM/DD-HH:MM.

Default: ALL, which allows all records to be selected.

PRODUCT

Indicates the name of the product that produced the SMF records. This name is used to filter the SMF records. Typically, the SEGMENT specification automatically sets this value.

Default: Null string, ''

RECSTYPE

Specifies the SMF record subtype that contains the desired data. Typically, the SEGMENT specification automatically sets this value.

Default: 0

RECTYPE

Specifies the SMF record type for the SYSVIEW IMS records. The SEGMENT specification automatically sets this value when SEGMENT is the name of a section in a standard MVS or RMF record.

Default: 255

SEGMENT

Indicates the name of the primary data segment type to extract. SEGMENT is used to:

• Determine RECTYPE and RECSTYPE when appropriate
• Set up variables that can be used for stepping through the segments with the SYSVFOR macro

Default: Null string, ''

SHIFT

Determines the time range for selecting data. The SELECT-PROC subroutine uses SHIFT to exclude SMF records that do not fall within the specified time range. The range is specified as h1:m1 h2:m2.

• h1:m1 is the starting time for the shift.
• h2:m2 is the ending time for the shift.
• If h1:m1 is greater than h2:m2, then two time ranges are assumed: h2:m2 24:00, and 00:00 h1:m1.

Default: 00:00 24:00

SUBSYS

Indicates the name of the subsystem that produced the SMF records. SUBSYS is used to filter the SMF records. Typically, SUBSYS is set automatically from the SEGMENT specification.

Default: Null string, ''

TO

Determines the ending timestamp for SMF record selection. The SELECT-PROC subroutine uses TO to exclude SMF records that have timestamps later than the provided value. The timestamp is specified as YYYY/MM/DD-HH:MM.

Default: ALL, which allows all records to be selected.