Troubleshooting › Problem Determination Using IPCS › IPCS Command and Parameters to Print the Logger

IPCS Command and Parameters to Print the Logger

Use the IPCS command to specify options for running the Logger print engine.

This command has the following format:

VERBX BESIPCS '[BES(BESn)] +
                NOLOG | [LOG(see note)] | [LOGONLY(see note)]'
                PRINT

Note: Valid subcommands for LOG and LOGONLY are:

ACTIVE | NOACTIVE |,LEVEL(n) |,DDNAME(nnnnnnnn)

The following BESIPCS operands are available:

BES(BESn)

Specifies the subsystem ID number of the CA Tape Encryption subsystem for which to display information. This value correlates to the last character of the CA Tape Encryption subsystem (BESn, where n must be between 1 and 8). The operand defaults to 1, which is the subsystem id number of BES1.

NOLOG

(Optional) Specifies that no historical logging data be displayed.

PRINT

(Optional) Writes the output to the IPCSPRNT DDNAME. The PRINT keyword is part of IBM's IPCS VERBX command. Do not include the PRINT keyword in quotes. Output is always written to the SYSTRPRT DDNAME, so specifying DUMMY helps to limit the output.

LOG

(Optional) Appends the Logger report to the regular IPCS report.

Note: See the subparameters under LOGONLY for available valid values for this parameter.

Default: ACTIVE

LOGONLY

(Optional) Formats the Logger report exclusively.

Note: These subparameters apply to LOG and LOGONLY.

ACTIVE

(Default) Specifies that the input to the Logger print engine is controlled by the IPCS SETDEF keyword (either a Dump or the Active system).

NOACTIVE

(Optional) Instructs the Logger print engine to ignore the SETDEF keyword. If this option is not specified, the default of ACTIVE is used.

LEVEL(n)

(Optional) Overrides the detail level the Logger print engine will format. The value n must be between 1-3.

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

DDNAME(xxxxxxxx)

(Optional) 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 should be 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.

Examples: DDNAME

This example shows how to use the IPCSPRNT DDNAME:

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

This example shows how to code a Log Stream DDNAME using IBM's LOGR subsys parameter to filter records based on date and time:

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