Checking log stream status
To display information about the status of CICS log streams, a
batch job should issue the IXCMIAPU command:
LIST LOGSTREAM NAME(streamname) DETAIL(YES)
You can use wildcards to select multiple log streams. For example,
the following job produces a report on the system log streams for
CICS region IYLX4:
//IYLXLIST JOB NOTIFY=WILLIN,MSGCLASS=A
//LOGLIST EXEC PGM=IXCMIAPU
//SYSPRINT DD SYSOUT=A,DCB=RECFM=FBA
//SYSIN DD *
DATA TYPE(LOGR) REPORT(NO)
LIST LOGSTREAM NAME(WILLIN.IYLX4.DFH*) DETAIL(YES)
Figure 1 shows a typical response
to this command, with system logs streams for CICS region IYXL4.
Figure 1. Example output produced by the LIST
LOGSTREAM NAME command
LOGSTREAM NAME(WILLIN.IYLX4.DFHLOG) STRUCTNAME() LS_DATACLAS()
LS_MGMTCLAS() LS_STORCLAS() HLQ(IXGLOGR) MODEL(NO) LS_SIZE(0)
STG_MGMTCLAS() STG_STORCLAS() STG_DATACLAS() STG_SIZE(0)
LOWOFFLOAD(40) HIGHOFFLOAD(85) STG_DUPLEX(YES) DUPLEXMODE(UNCOND)
RMNAME() DESCRIPTION() RETPD(0) AUTODELETE(NO)
DASDONLY(YES)
MAXBUFSIZE(64000)
LOG STREAM ATTRIBUTES:
User Data:
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
LOG STREAM CONNECTION INFO:
SYSTEMS CONNECTED: 1
SYSTEM STRUCTURE CON CONNECTION CONNECTION
NAME VERSION ID VERSION STATE
-------- ---------------- -- ---------- ----------
MV28 0000000000000000 00 00000000 N/A
LOG STREAM DATA SET INFO:
DATA SET NAMES IN USE: IXGLOGR.WILLIN.IYLX4.DFHLOG.<SEQ#>
Ext. <SEQ#> Lowest Blockid Highest GMT Highest Local
----- -------- ---------------- ----------------- ---------------
*00001 A0000007 0000000000496BAB 07/18/97 08:29:13 07/18/97 09:29:
NUMBER OF DATA SETS IN LOG STREAM: 1
POSSIBLE ORPHANED LOG STREAM DATA SETS:
DATA SET NAMES:
--------------------------------------------
IXGLOGR.WILLIN.IYLX4.DFHLOG.A0000037
IXGLOGR.WILLIN.IYLX4.DFHLOG.A0000404
NUMBER OF POSSIBLE ORPHANED LOG STREAM DATA SETS: 2
LOGSTREAM NAME(WILLIN.IYLX4.DFHSHUNT) STRUCTNAME() LS_DATACLAS()
LS_MGMTCLAS() LS_STORCLAS() HLQ(IXGLOGR) MODEL(NO) LS_SIZE(0)
STG_MGMTCLAS() STG_STORCLAS() STG_DATACLAS() STG_SIZE(0)
LOWOFFLOAD(0) HIGHOFFLOAD(80) STG_DUPLEX(YES) DUPLEXMODE(UNCOND)
RMNAME() DESCRIPTION() RETPD(0) AUTODELETE(NO)
DASDONLY(YES)
MAXBUFSIZE(64000)
LOG STREAM ATTRIBUTES:
User Data:
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
LOG STREAM CONNECTION INFO:
SYSTEMS CONNECTED: 1
SYSTEM STRUCTURE CON CONNECTION CONNECTION
NAME VERSION ID VERSION STATE
-------- ---------------- -- ---------- ----------
MV28 0000000000000000 00 00000000 N/A
LOG STREAM DATA SET INFO:
DATA SET NAMES IN USE: IXGLOGR.WILLIN.IYLX4.DFHSHUNT.<SEQ#>
Ext. <SEQ#> Lowest Blockid Highest GMT Highest Local
----- -------- ---------------- ----------------- ---------------
*00001 A0000000 0000000000001F1E 07/16/97 12:52:22 07/16/97 13:52:
NUMBER OF DATA SETS IN LOG STREAM: 1
POSSIBLE ORPHANED LOG STREAM DATA SETS:
NUMBER OF POSSIBLE ORPHANED LOG STREAM DATA SETS: 0
If you are using coupling facility log streams, the IXCMIAPU LIST STRUCTURE NAME(structname) DETAIL(YES) command is useful in finding the status of CICS log stream structures. For further information about these commands, see z/OS MVS Setting Up a Sysplex.