LOGGER subcommand output

Use the LOGGER subcommand to diagnose errors in the system logger address space. The dump must include the system logger private storage. Status is provided for:

the state of the address space
the coupling facility structures in use by system logger
log streams and log stream connections
the logger tasks (TCBs)
queued work (RQEs)
stack information
logger module names and addresses

Use IPCS LOGGER in conjunction with the MVS™ command D LOGGER or IXCMIAPU TYPE(LOGR) DETAIL(YES) report to provide supporting diagnostic information. The IPCS LOGGER subcommand has no parameters. Figure 1 is an example of a LOGGER report.

Figure 1. Example: LOGGER report

 System Logger Report
 --------------------
 LOGR Couple Dataset Level:   HBB6603

           System Logger Asid:           0014
           System Logger state information
           ----------------------------
              Available
              Ctrace is active
              System level recovery performed
              Couple Dataset available
              SMS has been checked
 Report for Generalized tasks
 ----------------------------

 BLF01 Tcb Address           007E2B68
 BLF01 Request Que           00000000
              Waiting For work
 WORKT Tcb Address           007E24B0
 WORKT Request Que           00000000
              Waiting For work
 F1TTT Tcb Address           007E2220
 F1TTT Request Que           00000000
              Waiting For work
 A1TSK Tcb Address           007E29D0
 A1TSK Request Que           05823880
              Processing work or initializing

 M1TSK Tcb Address           007E1E88
 M1TSK Request Que           00000000
              Waiting For work
 A1HSM Tcb Address           007E2740
 A1HSM Request Que           00000000
              Waiting For work
 L1TSK Tcb Address           007E1A60
 L1TSK Request Que           05824840
              Processing work or initializing

 LSTSK Tcb Address           007E17D0
 LSTSK Request Que           05823B20
              Processing work or initializing

 THE Following Requests Are Queue to ALLOC


 REQUEST: 05823880
   Function. 00000004  STOKEN... 00000050  00000001  STATE.... 00000000
    ASID(X'0014')


 THE Following Requests Are Queue to INVENTORY
 REQUEST: 05824840
   Function. 0000002B  STOKEN... 00000000  00000000  STATE.... 00000000
 REQUEST: 05822E00
   Function. 00000001  STOKEN... 00000080  00000001  STATE.... 22222222
    ASID(X'0020')

 THE Following Requests Are Queue to LSTSK
 REQUEST: 05823B20
   Function. 00000006  STOKEN... 00000000  00000000  STATE.... 00000000

 Report for Connection subtask:
 -------------------------------

 CTA: 05800008
         Structure Latch                   05A50CE8
         Tcb Address                       007E1408
         Connection Sequence               00000001
         Failure Count                     00000000
         Structure Sequence                00000000
              Initialized
              Allocated
              TaskAttached
              Associated

 Register Information for Stack Entry 01 of  02
 ---------------------------------------------

 Ep Name: IXGW1TSK addr: 03D17368 in Module: IXGW1TSK addr: 03D17368

  GENERAL PURPOSE REGISTER VALUES
      0-3  05858ABC  05A5215C  00000058  00000000
      4-7  05A51F1E  01599228  058230A0  05800000
      8-11 01599000  00000058  00000000  03D18367
     12-15 03D17368  05A52018  83D18264  83D1C810
  ACCESS REGISTER VALUES
      0-3  007E2B68  00000000  00000000  00000000
      4-7  00000000  00000000  00000000  00000000
      8-11 00000000  00000000  00000000  00000000
     12-15 00000000  00000000  00000000  00000001


 Register Information for Stack Entry 02 of  02

 ---------------------------------------------

 Ep Name: IXGC4DIS addr: 03D1C810 in Module: IXGC4DIS addr: 03D1C810

  GENERAL PURPOSE REGISTER VALUES
      0-3  06050003  83D20766  83BD8360  00000000
      4-7  05A52A0C  03D20E48  05A52AE4  05A52DE4
      8-11 015A08C0  03D1F80D  03D2080C  03D1E80E
     12-15 015A28C0  00FD2330  03D1D80F  03D1C810
  ACCESS REGISTER VALUES
      0-3  007E2B68  00000000  00000000  00000000
      4-7  00000000  00000000  00000000  00000000
      8-11 00000000  00000000  00000000  00000000
     12-15 00000000  00000000  00000000  00000001
 EcbList: 05A50B60
      Count.... 00000002
      Ecb@..... 05800028   Ecb@..... 0582509C

 ECB: 05800028
                00000000
              Is being processed
 ECB: 0582509C
                40000000
              Posted
              Is being processed

 Report For Structure: LIST03           Conname: IXGLOGR_SY2

 STRCB: 0581C0F8
      Structure Information:
         Asynchronous Write Count           0000
         Current Connect Token              C9E7C3D3  D6F0F0F2  7F6D9308  00010004
         Saved rebuild Conn Token           C9E7C3D3  D6F0F0F2  7F6D9308  00010004
      Structure Status:
              Structure is connected
              Structure is allocated
              Structure is failure isolated
              Structure FUll
              Non-Volatile
              PreRebuild was failure Independent
              Structure is failure Independent
              Disconnect Normal
      Rebuild Status:
              A rebuild is not in progress
 Report for Logstream:  IXJRME36.STREAM3

 LCB: 05806998


      DSSEQ.... A0000000
              Config2 Logstream

              Logstream Available
              DUPLEX=YES
              DUPLEXMODE=COND
              SMF Buffer available
              RMNAME specified on define
              Resource manager connected
              Structure Full
              Store In mode

 Report for Logstream Connector in: ASID(X'0022')

 LCCB: 0581BA78
         Sequence Number                            0000001B
         Asynchronous Events Count                  00000000
         Connectors Ttoken                          00000088  00000001  0000000D  007E1200

              Read and Write Authorization



 Report for Logstream Connector in: ASID(X'0017')

 LCCB: 0581F468
         Sequence Number                            00000019
         Asynchronous Events Count                  00000000
         Connectors Ttoken                          0000005C  00000004  00000003  007E1B68

              Read and Write Authorization


 Report for Logstream Connector in: ASID(X'0042')

 LCCB: 0581F708
         Sequence Number                            00000012
         Asynchronous Events Count                  00000000
         Connectors Ttoken                          00000108  00000001  00000005  007E15B8

              Read and Write Authorization
 Report for Logstream:  IXJRME36.STREAM1

 LCB: 05806278
      DSSEQ.... ........

              Config2 Logstream
              Logstream Available
              DUPLEX=YES
              SMF Buffer available
              RMNAME specified on define
              disconnect waiting for wow
              Disconnect Pending
              Store Thru mode


 Report for LOGGER Modules:

 Ep Name: IXGAIMM  at address: 06119C20    Csect: IXGAIMM  at address: 06119C20
 Ep Name: IXGAIMM9 at address: 06119F70    Csect: IXGAIMM  at address: 06119C20
 Ep Name: IXGAIAFP at address: 0609BB48    Csect: IXGAIAFP at address: 0609BB48
 Ep Name: IXGAIAF9 at address: 0609BCF8    Csect: IXGAIAFP at address: 0609BB48
 Ep Name: IXGAIALC at address: 061221C0    Csect: IXGAIALC at address: 061221C0
 Ep Name: IXGAIAL9 at address: 061225D8    Csect: IXGAIALC at address: 061221C0
 Ep Name: IXGAIAUS at address: 0609CB38    Csect: IXGAIAUS at address: 0609CB38
 Ep Name: IXGAIAU9 at address: 0609D3A0    Csect: IXGAIAUS at address: 0609CB38

Relevant MVS system commands

The list below provides a subset of MVS system commands that can be useful diagnostic aids when the system logger encounters a problem. For a full description of these commands, and a complete list of all MVS system commands, see z/OS MVS System Commands.

D GRS,Latch,Jobname=IXGLOGR to show all latches held by logger address space.
D GRS,ANALYZE,LATCH,DEPENDENCY,JOBNAME=IXGLOGR,DETAIL to show the dependencies of all latch sets created in the logger address space. See System logger latch conventions for a description of logger latches.
D GRS,RES=(SYSZLOGR,*) to show ENQs that are held by the logger. The major name is SYSZLOGR. The minor name contains the log stream name.
D GRS,Ct o show any latch or ENQ contention. Tip: The preferred method of trying to determine ENQ contention is D GRS,ANALYZE,BLOCKER and latch contention is D GRS,ANAYLZE,LATCH,BLOCKER,DETAIL.
D GRS,RNL=A to show additional RNL information.
D XCF,STR to display summary information about all coupling facility structures that are in the sysplex.
D XCF,STR,STRNAME=logger_structure to show details of the specified logger structure.
D XCF,COUPLE,TYPE=LOGR to display LOGR couple data set details.
D TRACE,COMP=SYSLOGR to display the component trace status of system logger.
D LOGGER,options to display information about the system logger. For details on the options that can be specified, see z/OS MVS System Commands. To interpret the output of the D LOGGER command, see message IXG601I in z/OS MVS System Messages, Vol 10 (IXC-IZP).
SETLOGR FORCE to clean up logstream resources related to a system logger logstream when the logstream becomes unusable. Logger will attempt to release all the related resources for the logstream based on the request.
FORCE IXGLOGR,ARM to take down the logger address space. Do not use CANCEL or FORCE without specifying ARM.
START IXGLOGRS to bring up the system logger address space.
D A,IXGLOGR to display the system logger address space.
D LOGREC to display information about the logrec log stream.
D C,HC to display information about the operlog log stream.

Relevant IPCS commands

The following IPCS commands can be particularly useful for displaying the information in a system logger dump. For a full description of these commands, see z/OS MVS IPCS Commands.

IP CTRACE COMP(SYSLOGR) FULL OPTIONS(options) to format LOGR ctrace, if the dataspace was dumped and ctrace was running.
IP ANALYZE RESOURCE to identify Latch or ENQ contention.
IP VERBX LOGDATA to format the logrec buffer records that were in storage when the dump was generated.
IP LOGGER to format data in the system logger address space.
IP CBF address STR(control block) to format and display any of the following logger control blocks:
- IXGARTE
- IXGBFTK
- IXGBLK1
- IXGDMTK
- IXGDRCT
- IXGINV
- IXGLBCB
- IXGLCB
- IXGLCCB
- IXGLSAB
- IXGPCNTL
- IXGRQE
- IXGSTRCB
IP CBF address STR(LSE) to format linkage stack entries.
IP CBF address FORMAT(IXGIPSTK) to format a logger stack address. IP LOGGER uses this command internally.