Using the Logger › Process and View Log Streams › SUBSYS Statement—Specify Parameters

SUBSYS Statement—Specify Parameters

You can specify parameters on the SUBSYS statement of your CA SYSVIEW log stream using the following syntax:

//ddname DD DISP=SHR,DSN=log.stream.name,
// SUBSYS=(LOGR,exitname,'SUBSYS-opts1','SUBSYS-opts2')
//         DCB=BLKSIZE=nnnnn

exitname

Name of the LOGR exit module. This module must reside in a linklist data set.

• IXGSEXIT - IBM supplied exit
• GSVXLGEX - CA SYSVIEW exit

SUBSYS-opts1

Available opts1 parameters:

{ FROM=(yyyy/ddd,hh:mm:ss) |OLDEST   }
{,TO=(yyyy/ddd,hh:mm:ss)   |YOUNGEST }
{,DURATION=(nnnn,HOURS)              }
{,GMT| LOCAL                         }

FROM=

Indicates the start time of the log stream to process. The first block is the one with a time stamp later than or equal to the specified time.

OLDEST - Indicates the first block read is the oldest block on the log stream.

yyyy/ddd - Specifies the start date

hh:mm:ss - Specifies the start time

The FROM keyword is mutually exclusive with the DURATION keyword.

Default: OLDEST

TO=

Indicates the ending time of the log stream to process. The last block is the one with a time stamp earlier than or equal to the specified time.

YOUNGEST - Indicates the last block read is the youngest block on the log stream.

yyyy/ddd - Specifies the end date

hh:mm:ss - Specifies the end time

The FROM keyword is mutually exclusive with the DURATION keyword.

Default: YOUNGEST

DURATION=

Specifies which blocks to process.

Syntax: DURATION=(nnnn,HOURS)

Requests the last nnnn hours up to the youngest block be processed. The "last nnnn hours" is calculated based on the allocation time of the DD.

The first block is the one with a time stamp greater than or equal to the calculated start time. The last block read is the youngest block on the log stream at the time of allocation.

The DURATION keyword is mutually exclusive with the TO and the FROM keywords.

GMT | LOCAL

Specifies whether the time is local time (based on the time zone offset at the time the log was written) or GMT time.

Default: GMT

SUBSYS-opts2

Available opts2 parameters:

FORWARD OLDTOYOUNG|BACKWARD YOUNGTOOLD

Specify FORWARD to read records from oldest to youngest.

Specify BACKWARD to read records from youngest to oldest.

Default: FORWARD

CNT=nnnnnnnn

Limits the number of records read.

Default: 0, no limit.

NOMSGS

Displays no messages, including error messages.

STATS|NOSTATS

Displays a statistics report.

Default: STATS

EXPAND|NOEXPAND

Expands compressed log records.

Default: EXPAND

TRACE|NOTRACE

Displays event trace points. No message is logged for the Converter event.

Default: NOTRACE

WARN|NOWARN

Displays the return/reason code message for warning results.

Default: NOWARN

TRUNCMSG|NOTRUNCMSG

Displays a message when an output record is truncated.

Default: NOTRUNCMSG

DELETE|NODELETE

Deletes blocks older than the oldest block read.

RDW|NORDW

Returns a record including RDW.

Do not include RDW, bump by 4 bytes.

Default: RDW

Note: If conflicting options are coded, the result of the last specified option is used.

Example: SUBSYS Syntax

The following examples show the SUBSYS statement syntax with optional parameters included:

//LOGFILE  DD DISP=SHR,DSN=log.stream.name,
//         SUBSYS=(LOGR,GSVXLGEX,
//         'FROM=OLDEST,TO=YOUNGEST,GMT',
//         'STATS,FORWARD,CNT=1000')

//LOGFILE  DD DISP=SHR,DSN=log.stream.name,
//         SUBSYS=(LOGR,GSVXLGEX,
//         'FROM=(2005/001,00:00:00),TO=(2005/365,23:59:59),GMT',
//         'STATS,FORWARD')

//LOGFILE  DD DISP=SHR,DSN=log.stream.name,
//         SUBSYS=(LOGR,GSVXLGEX,,'BACKWARD,CNT=1000')

The following example is suggested if a log is being used as input to a CA Easytrieve report:

//SMFIN    DD DISP=SHR,DSN=log.stream.name,
//         SUBSYS=(LOGR,GSVXLGEX,
//         'FROM=OLDEST,TO=YOUNGEST',
//         'STATS,FORWARD,NORDW'),
//          DCB=(DSORG=PS,RECFM=VB,LRECL=32756,BLKSIZE=32760)