Example 1:
Display the current operational status of the System Logger.
DISPLAY LOGGER,STATUSExample 2:
Display all log streams with one or more connections for the system
that match the log stream name starting with the letters logstr.
DISPLAY LOGGER,CONN,LSN=logstr*Example 3:
Display all log streams with at least one active connection in
the sysplex that matches the log stream name starting with the letters logstr.
DISPLAY LOGGER,CONN,SYSPLEX,LSN=logstr*Example 4:
Display all defined log streams for the sysplex that match the
log stream name of loga and structure names that start with list.
DISPLAY LOGGER,L,LSN=loga,STRN=list*Example 5:
Display all defined log streams for the sysplex that start with logstr and
have a DASD only configuration.
DISPLAY LOGGER,L,LSN=logstr*,DASDONLYExample 6:
Display all defined log streams for the sysplex and sort by structure
name starting with the letters list.
DISPLAY LOGGER,STR,STRN=list*Example 7:
The following command displays details of all the
log streams on the system with connections to the specified job name:
DISPLAY LOGGER,CONN,JOBNAME,DETAILThe IXG601I message output is displayed as follows:
CONNECTION INFORMATION BY LOGSTREAM FOR SYSTEM SY1
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ----- ------
NICKJ.TEST.LOGSTREAM LIST01 00002 DISCONNECT PENDING
DUPLEXING: STAGING DATA SET
STGDSN: IXGLOGR.NICKJ.TEST.LOGSTREAM.PLEX1
VOLUME=ALL001 SIZE=0040000 % IN-USE=30
GROUP: PRODUCTION
DISCONNECT PENDING FOR 0003 MINUTES
FORCE DISCONNECT IN PROGRESS
JOBNAME: LOGTEST1 ASID: LOGTAS1
R/W CONN: 0003
RES MGR./CONNECTED: no
IMPORT CONNECT: no
JOBNAME: LOGTEST2 ASID: LOGTAS2
R/W CONN: 0003
RES MGR./CONNECTED: no
IMPORT CONNECT: no
NUMBER OF LOGSTREAMS: 000001Example 8:
The following command displays inventory information
by log stream for either the sysplex (DISPLAY LOGGER,CONN,SYSPLEX)
or system (DISPLAY LOGGER,L):
DISPLAY LOGGER,CONN,SYSPLEX
DISPLAY LOGGER,LThe IXG601I message output is displayed as follows:
INVENTORY INFORMATION BY LOGSTREAM
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ----- ------
NICKJ.TEST.LOGSTREAM1 LIST01 00000 AVAILABLE
NICKJ.TEST.LOGSTREAM2 LIST02 00003 IN USE
SYSNAME: SY1
DUPLEXING: LOCAL BUFFERS
SYSNAME: SY2
DUPLEXING: STAGING DATA SET
SYSNAME: SY3
DUPLEXING: LOCAL BUFFERS
GROUP: PRODUCTION
NICKJ.TEST.LOGSTREAM3 LIST03 00001 IN USE
SYSNAME: SY2
DUPLEXING: LOCAL BUFFERS
GROUP: TEST
NUMBER OF LOGSTREAMS: 000003Example 9:
The following command displays the status of the system
logger:
DISPLAY LOGGER,STSYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVE
LOGR CDS IS NOT AVAILABLE
LOGGER SERVICES DISABLED FOR GROUP: TESTExample 10:
The following command displays the log streams defined
to any structure in the sysplex:
DISPLAY LOGGER,STRINVENTORY INFORMATION BY STRUCTURE
STRUCTURE GROUP CONNECTED
--------- ----- ---------
LIST01 TEST
OA08553.LOG.STREAM NO
LIST02
*NO LOGSTREAMS DEFINED* N/A
LONG_STRUCT_NAME PRODUCTION
NICKJ.TEST.LOG.STREAM NO
NICKJ.TEST.LOG.STREAM2 YES
NUMBER OF STRUCTURES: 3Example 11:
The following command displays the status of system
logger and requests any outstanding data set recalls be listed (from
the oldest to the most recent):
DISPLAY LOGGER,ST,REC SYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVE
LOGGER DATA SET RECALLS
GROUP: PRODUCTION
SECONDS DATA SET NAME
00000038 IXGLOGR.TEST102.STREAM01.A0000000
00000173 IXGLOGR.TEST102.STREAM02.A0000003
GROUP: TEST
SECONDS DATA SET NAME
00000014 IXGLOGR.TEST103.STREAM04.A0000002
00000014 IXGLOGR.TEST103.STREAM03.PLEX1SYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVE
LOGGER DATA SET RECALLS
GROUP: PRODUCTION
NO DATA SET RECALLS WAITING
GROUP: TEST
NO DATA SET RECALLS WAITING SYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVE
LOGGER SERVICES DISABLED FOR GROUP: TEST
LOGGER DATA SET RECALLS
GROUP: PRODUCTION
SECONDS DATA SET NAME
00000088 IXGLOGR.TEST102.STREAM01.A0000000
00000223 IXGLOGR.TEST102.STREAM02.A0000003
GROUP: TEST
LOGGER NO LONGER RECALLING DATA SETS ASYNCHRONOUSLYExample 12:
The following command displays the status of system
logger and the z/OS® IBM zAware log stream
client related settings, and z/OS IBM zAware client
state information, when ZAI SERVER is specified in IXGCNFNN parmlib.DISPLAY LOGGER,STatus,ZAISYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVEZAI LOGSTREAM CLIENTS: AVAILABLE [| ACTIVE | NOT AVAILABLE
| QUIESCED]
BUFFERS IN USE: 00 GB 0000 MB
LOGGER PARAMETER OPTIONS
KEYWORD SOURCE VALUE
----------------- -------- ----------------------------------------
ZAI
SERVER HOST IPL (NN) HOST.ZAWARE.SERVER.LOCATION
PORT DEFAULT 2001
LOGBUFMAX DEFAULT 02
LOGBUFWARN DEFAULT 75
LOGBUFFULL DEFAULT MSG
Example 13:
Display all log streams defined in the LOGR Couple Data Set and
if the log stream is in use, indicate when ZAI(YES) is specified for
the log stream.
DISPLAY LOGGER,L
IXG601I 08.45.59 LOGGER DISPLAY 671
INVENTORY INFORMATION BY LOGSTREAM
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ------ ------
COPYLOG.SOURCE *DASDONLY* 000001 IN USE
SYSNAME: SY1
DUPLEXING: STAGING DATA SET
GROUP: PRODUCTION ZAI CLIENT: YES
ZOBES.STRLOG.STRM130 LIST01 000000 AVAILABLE
NUMBER OF LOGSTREAMS: 000002Example 14:
Display all log streams with one or more connections for the command target system and indicate when ZAI(YES) is specified for the log stream.
If system logger has established a socket connection to the IBM zAware server for the log stream, then the line with '...ZAI CLIENT: YES - CONNECTED' will be included in the message.
In the case of:
'LOG BLOCKS SENT TO SERVER OK: blkok, FAILED: blkfailed' - blkok
- Number of log blocks sent to the IBM zAware server successfully during this connection.
- blkfailed
- The number of log blocks that were attempted to be sent over the socket to the IBM zAware server, but eventually failed to be sent. System logger moves on to the next buffered log block for the log stream to send to the IBM zAware server.
- offload-datasetname
- Current offload data set name for the log stream. When this z/OS system
is not allocated to the current offload data set, then the low level
qualifier will be revealed as ’????????’.
D LOGGER,C,LSN=*,D
IXG601I 08.47.06 LOGGER DISPLAY 674
CONNECTION INFORMATION BY LOGSTREAM FOR SYSTEM SY1
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ------ ------
SYSPLEX.OPERLOG STR_OPERLOG 000001 IN USE
DUPLEXING: STAGING DATA SET
STGDSN: IXGLOGR.SYSPLEX.OPERLOG.PLEX1
VOLUME=SMSVL6 SIZE=000540 (IN 4K) % IN-USE=001
GROUP: PRODUCTION ZAI CLIENT: YES - CONNECTED [| CONNECTING |
NOT CONNECTED | QUIESCED]
ZAIDATA: OPERLOG
LOG BLOCKS SENT TO SERVER OK: blkok, FAILED: blkfailed
CURRENT OFFLOAD DSN: IXGLOGR.SYSPLEX.OPERLOG.A0000000
JOBNAME: CONNECTW ASID: 001B
R/W CONN: 000001 / 000000
RES MGR./CONNECTED: *NONE* / NO
IMPORT CONNECT: NO
NUMBER OF LOGSTREAMS: 000001Example 15:
Display all log streams connected on the command target system
that match the log stream name starting with the letters SYSPLEX and
has ZAI(YES) specified.
DISPLAY LOGGER,CONN,LSN=SYSPLEX*,ZAIExample 16:
The following command displays the status of the
system logger and the z/OS IBM zAware log stream
client related settings, and requests that system logger verify the IBM zAware server
can be accessed for any potential z/OS IBM zAware log stream
client(s). DISPLAY LOGGER,STATUS,ZAI,VERIFY
The IXG601I IXG607I and IXG380I messages sample output are displayed as follows:
SYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVEZAI LOGSTREAM CLIENTS: AVAILABLE
BUFFERS IN USE: 00 GB 0000 MB
ZAI VERIFY INITIATED, CHECK FOR MESSAGES IXG37X, IXG38X
LOGGER PARAMETER OPTIONS
KEYWORD SOURCE VALUE
----------------- -------- -------------------------------------------
ZAI
SERVER HOST IPL (NN) HOST.ZAWARE.SERVER.LOCATION
PORT DEFAULT 2001
LOGBUFMAX DEFAULT 02
LOGBUFWARN DEFAULT 75
LOGBUFFULL DEFAULT MSGIXG380I ZAI LOGSTREAM CLIENT ESTABLISHED
FOR DISPLAY ZAI,VERIFY
Example 17:
Display the system logger initialization and processing
parameter options. Assume the following before the display command
is issued:
SYS1.PARMLIB members IXGCNFNN, IXGCNFN1 and IXGCNFN2 exist and
contain the following statements:
IXGCNFNN
CTRACE(CTILOG01)
IXGCNFN1
MONITOR OFFLOAD
WARNALLOC(5)
ACTIONALLOC(15)
IXGCNFN2
MONITOR OFFLOAD
ACTIONRECALL(26)- IEASYSxx member that was used during IPL contained IXGCNF=NN,
- SET IXGCNF=(n1,n2) command was specified,
- 4.SETLOGR MONITOR,OFFLOAD,ACTIONALLOC(20) command was used.
- SETLOGR ZAI,PORT(11112) command was also used.
DISPLAY LOGGER,IXGCNF
SY1 IXG607I 18.00.56 LOGGER DISPLAY 395
LOGGER PARAMETER OPTIONS
KEYWORD SOURCE VALUE
----------------- -------- -------------------------------------------
CTRACE IPL (NN) CTILOG01
MONITOR OFFLOAD
WARNALLOC SET (N1) 00005
ACTIONALLOC SETLOGR 00020
WARNRECALL DEFAULT 00060
ACTIONRECALL SET (N2) 00026
ZAI
SERVER DEFAULT NONE
PORT SETLOGR 11112
LOGBUFMAX DEFAULT 02
LOGBUFWARN DEFAULT 75
LOGBUFFULL DEFAULT MSGNote: For the keyword CTRACE, the value (CTILOG01 here)
represents the last specified CTiLOGnn member but might not reflect
the current used logger CTRACE options if an error occurred trying
to use the member. To view in use options, issue a D TRACE,COMP=SYSLOGR
command.
Example 18:
The following command displays the system logger parameter specifications
and reveals the keyword provided in parmlib IXGCNFAV put into effect
via a SET IXGCNF=AV command:
d logger,IXGCNF
SY1 IXG607I 11.26.11 LOGGER DISPLAY 610 C
LOGGER PARAMETER OPTIONS
KEYWORD SOURCE VALUE
----------------- -------- -------------------------------------------
CTRACE DEFAULT CTILOG00
MONITOR OFFLOAD
WARNALLOC DEFAULT 00030
ACTIONALLOC DEFAULT 00060
WARNRECALL DEFAULT 00060
ACTIONRECALL DEFAULT 00120
MONITOR LSPRIMARY
CONSUMPTIONALERT SET (AV) SUPPRESS
ZAI
SERVER DEFAULT NONE
PORT DEFAULT 2001
LOGBUFMAX DEFAULT 02
LOGBUFWARN DEFAULT 75
LOGBUFFULL DEFAULT MSG Example 19:
The following command displays additional details on the named
log stream on the system from which the command was issued:
d logger,c,lsn=test1.mylog,detail
SY1 IXG601I 17.28.04 LOGGER DISPLAY 624
CONNECTION INFORMATION BY LOGSTREAM FOR SYSTEM SY1
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ------ ------
TEST1.MYLOG LIST01 000001 IN USE
DUPLEXING: LOCAL BUFFERS
GROUP: PRODUCTION
CURRENT OFFLOAD DSN: IXGLOGR.TEST1.MYLOG.A0000001
JOBNAME: WRITEJOB ASID: 0023
R/W CONN: 000000 / 000001
RES MGR./CONNECTED: *NONE* / NO
IMPORT CONNECT: NO