Use the PRINT command to print the contents of MVS™ logs, and to find information about records logged on them.
>>-PRINT--+-----------------------+-----------------------------> | .-ALL-. | '-+-----+--CICSVR--CICS-' >--+-NAME--(--log stream name--)-+------------------------------> '-COPY------------------------' >--+---------------------------+--------------------------------> '-STARTIME--(--timestamp--)-' >--+---------------------------+------------------------------->< '-STOPTIME--(--timestamp--)-'
STARTTIME(2001.159/:23:00)
You cannot substitute commas, blanks, and so on, for the time values, but you can omit values from the right. For example, if you specify STARTTIME(2001.159), CICS VR assumes that the time segment is 00:00:00.
EXCLUDE FILEID(DD1),TERMID(T1)
The utility ignores log records that have a FILEID of DD1 and TERMINALID of
T1. If you want to ignore log records that have a FILEID of DD2 or TERMINALID
of T2, specify two EXCLUDE commands as follows: EXCLUDE FILEID(DD2)
EXCLUDE TERMID(T2)
There is no limit on the number of EXCLUDE (and INCLUDE)
commands that you can specify. INCLUDE FILEID(DD1),TERMID(T1)
The
Journal Print utility only uses log records that have a FILEID of DD1 and
TERMINALID of T1. If you want the Journal Print utility to use log records
that have a FILEID of only DD1 or TERMINALID of T1, specify two INCLUDE commands
as follows: INCLUDE FILEID(DD1)
INCLUDE TERMID(T1)
There is no limitation on the number of INCLUDE (and EXCLUDE)
commands. The CICS VR Journal Print Utility can be started by submitting a batch job that runs the utility program, DWWJUP.
//*-------------------------------------------------------*/
//* Print the mvslog */
//*-------------------------------------------------------*/
//PRIINT JOB ,CICSVR,MSGCLASS=H,CLASS=A,MSGLEVEL=(1,1),
// REGION=4096K,NOTIFY=USERID
//PRINTLOG EXEC PGM=DWWJUP
//STEPLIB DD DSN=DWW.SDWWLOAD,DISP=SHR /* CICSVR LOADLIB */
// DD DSN=DWW.SDWWLENU,DISP=SHR
//DWWPRINT DD SYSOUT=*
//DWWMSG DD SYSOUT=*
//DWWIN DD *
PRINT ALL NAME(CICS.MVSLOG1)
//*
//*-------------------------------------------------------*/
//* Print the copy of the mvslog */
//*-------------------------------------------------------*/
//PRIINT JOB ,CICSVR,MSGCLASS=H,CLASS=A,MSGLEVEL=(1,1),
// REGION=4096K,NOTIFY=USERID
//PRINTLOG EXEC PGM=DWWJUP
//STEPLIB DD DSN=DWW.SDWWLOAD,DISP=SHR /* CICSVR LOADLIB */
// DD DSN=DWW.SDWWLENU,DISP=SHR
//DWWPRINT DD SYSOUT=*
//DWWMSG DD SYSOUT=*
//DWWLOG DD DSN=DWW.LOGCOPY,DISP=SHR /* COPY OF THE MVSLOG */
//DWWIN DD *
PRINT CICSVR COPY
//*
The Journal Print Utility filtering is started by
adding EXCLUDE and INCLUDE, or EXCLUDE or INCLUDE commands
to the command input in the DWWIN dd statement.
EXCLUDE FILEID(DD3) TRANSACTIONID(APQ4)
EXCLUDE TERMINALID(TST2)
Assume the five commands below are specified
in one job step. Since multiple EXCLUDE and INCLUDE commands
are specified in one step, the Journal Print utility processes a log record
against all EXCLUDE commands before the log record is processed
against all INCLUDE commands.INCLUDE FILEID(DD1,DD2)
INCLUDE FILEID(DD3) TERMINALID(TST1)
INCLUDE FILEID(DD4) TRANSACTIONID(APQ1,APQ2,APQ3)
EXCLUDE FILEID(DD3) TRANSACTIONID(APQ4)
EXCLUDE TERMINALID(TST2)
Exclude all records
that have both a FILEID of DD3 and TRANSACTIONID of APQ4, or exclude all records
that have a TERMINALID of TST2.
This example is exactly
like the previous example. When the log record has been processed using the
exclude criteria, it is processed using the include criteria. If the log record
was not excluded by the EXCLUDE command:
Include
all records that have a FILEID of DD1 or DD2, or include all records that
have a FILEID of DD3 and TERMINALID of TST1, or Include all records that have
a FILEID of DD4 and TRANSACTIONID of APQ1, APQ2, or APQ3
INCLUDE FILEID(DD1)
INCLUDE TERMID(T1)
Assume the five commands below are specified
in one job step. Since multiple INCLUDE or EXCLUDE commands
are specified in one step, the Journal Print utility processes a log record
against all EXCLUDE commands before the log record is processed
against all INCLUDE commands.INCLUDE FILEID(DD1,DD2)
INCLUDE FILEID(DD3) TERMINALID(TST1)
INCLUDE FILEID(DD4) TRANSACTIONID(APQ1,APQ2,APQ3)
EXCLUDE FILEID(DD3) TRANSACTIONID(APQ4)
EXCLUDE TERMINALID(TST2)
Exclude all records
that have both a FILEID of DD3 and TRANSACTIONID of APQ4, or Exclude all records
that have a TERMINALID of TST2.
If the log record was not
excluded by any of the EXCLUDE commands, it is processed
using the include criteria. For the remaining records (the log records that
were not excluded by the EXCLUDE command).
Include
all records that have a FILEID of DD1 or DD2, or| Include all records that
have a FILEID of DD3 and TERMINALID of TST1, or Include all records that
have a FILEID of DD4 and TRANSACTIONID of APQ1, APQ2, or APQ3
Keyword | Synonym |
---|---|
FILEID | DD, DDNAME |
TERMID | TERMINALID |
TRANSID | TRANSACTIONID |