Previous Topic: IPCS Parameters to Print the LoggerNext Topic: Self-Documenting Error Recovery Routines


SVTSIPCS Operands

Operands are as follows:

SVTS(SVTn)

Specifies the subsystem ID number of the CA Vtape subsystem for which to display information. This value correlates to the last character of the CA Vtape subsystem (SVTn, where n must be between 1 through 8). The operand defaults to 1 which is the subsystem ID number of SVT1.

NOLOG

Specifies that no historical logging data be displayed.

VOLUMES

Specifies which Virtual Volumes to include in the report. ALL prints all Virtual Volumes, NONE does not print any, and ONLY(nnn) prints the Virtual Volumes that match the first three qualifying alphanumeric characters.

PRINT

Indicates the PRINT keyword that is part of IBM's IPCS VERBX command and if supplied writes to the IPCSPRNT DDNAME. The PRINT keyword must not be included within quotes. Output is written to the SYSTRPRT DDNAME, so specifying DUMMY helps to limit the output.

The following is an example of the IPCSPRNT DDNAME:

//IPCSPRNT DD DISP=(,CATLG),DSN=SVTS.TEMP.IPCS.PRINT,       
// SPACE=(CYL,(5,5),RLSE),UNIT=SYSALLDA,
 // DCB=(LRECL=137,RECFM=VBA,BLKSIZE=23476)        
LOG

Appends the Logger report to the regular IPCS report.

LOGONLY

Formats the Logger report exclusively.

ACTIVE

Indicates the default. Specifies that the IPCS SETDEF keyword (either a Dump or the Active system) controls the input to the Logger print engine.

NOACTIVE

When specified, instructs the Logger print engine to ignore the SETDEF keyword. If this option is not specified ACTIVE is generated.

LEVEL(n)

Overrides the detail level the Logger print engine formats. The value n must be between 1 through 3.

If LEVEL is not specified, all records, regardless of their Logger Detail Level, are included. Specify a lower detail level than the one that the data was recorded at filters all events that are generated for a Logger Level Detail greater than the supplied value. Specifying a greater detail level than the one that the data was recorded at has no effect. Level(3) may generate thousands of lines for only a few minutes of logging. Adjust the IPCSPRNT DD SPACE parameter accordingly.

DDNAME(xxxxxxxx)

When specified, indicates that the input to the Logger print engine is supplied by the specified DDNAME xxxxxxxx value. This parameter is independent of parameters ACTIVE/NOACTIVE and NOACTIVE and specified to process only input from the supplied DDNAME. The supplied xxxxxxxx value must match a DDNAME allocated to the Job Step that is pointing to a valid Log Stream name or a sequential data set containing extracted external Logger data.

The following is a typical example of how to code a Log Stream DDNAME using IBM's LOGR subsystem parameter to filter records based on date and time.

//LOGR     DD DISP=SHR,DSN=VTAPE.LOG,SUBSYS=(LOGR,,
 // FROM=(2002/302,12:00),TO=(2002/302,15:23),LOCAL'),
 // DCB=(RECFM=U,BLKSIZE=24576)

Examples of the IPCS command

VERBX SVTSIPCS PRINT

In this example, the IPCS print engine takes all the CA Vtape defaults and writes a copy of the output to the IPCSPRNT DDNAME. The options in effect are VOLUMES(ALL) and NOLOG.

VERBX SVTSIPCS 'LOGONLY(NOACTIVE,DDNAME(LOGR))'

In this example, the IPCS print engine generates the output that is based on the external Logger events pointed to by DDNAME LOGR and does not include the typical internal control blocks and Virtual Volumes data.

SETD DA('SYS1.P390.DMP00017') NOCONFIRM
VERBX SVTSIPCS 'LOGONLY(ACTIVE,LEVEL(1))' PRINT

In this example, the IPCS print engine looks in the dump 'SYS1.P390.DMP00017' for the internal Logger dataspace and formats all events at level 1. A copy of the output is written to the IPCSPRNT DDNAME.

SETD ACTIVE NOCONFIRM
VERBX SVTSIPCS 'LOGONLY'

In this example, the IPCS print engine writes the output to the SYSTRPRT DDNAME and only formats the data from the active running system's internal Logger dataspace.

SETD ACTIVE NOCONFIRM
VERBX SVTSIPCS 'LOG(ACTIVE)'

In this example, the IPCS print engine prints the traditional internal control blocks and all Virtual Volume information with data from the internal Logger dataspace. The input is the live system and output is written to the SYSTRPRT DDNAME.