IBM Support

II06950: INSTRUCTIONS FOR SETTING AND INTERPRETING AN O/C/EOV TRACE 566528413 5795DF107

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • INTRAN

Error description

  • The O/C/EOV trace provides a trace of the major control
    blocks used by OPEN, CLOSE, and End of Volume as they are
    passed from module to module.  Below is an explanation of how
    to set the trace and an attempt to explain how to interpret
    some of the more important fields in the trace.
         To set the trace, specify or add the DCB parm
    DIAGNS=TRACE on the DD statement for which the trace is
    desired and run the job.  For HSM, which does dynamic
    allocations for its data sets, the trace is activated via
    the following HSM 'PATCH' commands.
         PATCH .MCVT.+F2 X'00' /* TRACE O/C/EOV FOR TAPE */
         PATCH .MCVT.+F3 X'00' /* TRACE O/C/EOV FOR DASD */
    See the DFHSM Diagnosis Guide for additional information.
         The O/C/EOV routines will create a GTF USR=FFF record
    each time a major O/C/EOV routine is exited.  Therefore
    GTF must be active and collecting USR=FFF records if you
    are running the O/C/EOV trace.
         When you have the trace data, the easiest way to view
    it is via IPCS, command panel (option 4), command
    "GTF USR(FFF)"  Note that USR(FFF) must be specified since
    the IPCS default is to not format USR records.  Hint for
    ease of usage:  If you encounter a lot of "IPCS DETECTED
    A VIRTUAL STORAGE SHORTAGE" messages while viewing a large
    trace, specify "GTF USR(FFF) PRINT NOTERM", then issue
    a "CLOSE PRINT" command, then use ISPF "BROWSE' to browse
    the trace data set directly.
         There are two slightly different formats for the
    trace output depending on whether the PTF for OY47958 is
    applied or not.  An example of both formats is included
    below.
         Some of the more important fields in the trace are:
    DCB:  A copy of the DCB OPEN is currently processing.
          Note that Device Interface begins at offset 0 in the
          DCB and that Access Method Interface begins at offset 31.
    WKAREA1:  The first part of the O/C/OEV workarea.  This area
          often contains either a DSCB (indicated by a X'F1' at
          offset 0, or tape labels (indicated by VOL1, HDR1, or
          HDR2 at offset 0).  It can also contain messages or can
          be used as just a workarea.
    WKAREA2:  This is a copy of the JFCB (or a copy of the user's
          copy of the JFCB in the case of OPEN TYPE=J).  The JFCB
          is just an incore representation of the DD statement so
          in addition to the DSNAME, there may be BLKSIZE, LRECL,
          VOLUME information, etc. in the JFCB.  See the MVS
          DIAGNOSIS:  DATA AREAS manual for a complete description
          of the fields contained in the JFCB.
    WKAREA3:  This is the ECB/IOB used by O/C/EOV to perform such
          functions as reading tape labels etc..  If you are
          experiencing I/O errors during O/C/EOV processing, this
          MAY be a good place to look.
    WKAREA4:  CCWs used in conjunction with ECB/IOB above.
    WKAREA5:  Internal flags used by O/C/EOV, generally of no
          interest, and pointers to various control blocks:
          ASCB, TCB, JSCB, DSAB QDB, DSAB, DEB extension, TIOT,
          UCB, User's DCB, Copied DCB (the one O/C/EOV actually
          manipulates), parmlist, etc.
    WTG TABLE:  WTGMODNM and WTGMODID together are an EBCDIC
          representation of the module we are exiting.
                WTGMODNM and WTGENTRY together are an EBCDIC
          representation of the module we are going to.
          Note:  with OY47958 this is also formatted in English.
    
    O/C/EOV Trace without OY47958:  Note that the trace is
    truncated on the right, but the fields should still be
    fairly self-explanatory.
    
    USRFF FFF ASCB 00F95B80            JOBN GENERJO
              DCB      DEVICE INTERFACE
                       00000000  00000000  00000000  00000000  00000
                       DCBBUFNO  DCBBUFCB  DCBBUFL   DCBDSORG  DCBIO
                       00        000001    0000      4000      00000
                       DCBMACRF  DCBIFLGS  DCBDEBAD  DCBOFLGS
                       2000      00        8E12C8    03
                       ACCESS  METHOD INTERFACE
                       002000    00000001  000088E4  00000000  00000
    USRFF FFF ASCB 00F95B80            JOBN GENERJO
              WKAREA 1 VOL LBL, FILE LBL, DSCBS, OR MSG AREA   +10
                       00000000  00000000  00000000  00000000  00000
                       +28       +2C       +30       +34       +38
                       00000000  00000000  00000000  00000000  00000
                       +50       +54       +58       +5C       +60
                       00000000  00000000  00000000  00000000  00000
    USRFF FFF ASCB 00F95B80            JOBN GENERJO
               WKAREA 2 JFCB-JFCBDSNM
                        C4C6D7F3  4BE3C5E2  E34BC4C1  E3C14040  4040
                        (CONT.)   JFCBELNM            JFCBTSDM  JFCD
                        40404040  40404040  40404040  80        0004
                        /JFCBFLSQ JFCBVLSQ  JFCBMASK            JFCB
                        0000      0000      00000000  00000400  5C00
                        JFCBUFL   JFCEROPT  DEV CHAR  JFCDEN    JFCL
                        0000      00        00        00        0000
                        JFCNCP    JFCNTM    SEGMENTS            JFCC
                        00        00        00000000  00        00
                        JFCBVOLS
                        E2E3D6D9  C1F84040  40404040  40404040  4040
                        JFCBPQTY  JFCBCTRI  JFCBSQTY  RESERVED  JFCB
                        000000    00        000000    00        0000
                        JFCBSPTN
                        00
     USRFF FFF ASCB 00F95B80            JOBN GENERJO
               WKAREA 3 DXECB
                        20000000
                      * IOB-IOBFLAG1        IOBFLAG2  IOBSENS0  IOBS
                        02                  00        00        00
                        IOBSTAT1  IOBCNT    IOBSIOCC  IOBSTART  IOBW
                        00        0000      00        8E1438    00
                        DXDAADDR
                        00000000  00000000
                      * DEB-DXDEBDEB        DEBOFLGS  DEBIRBAD  DEBO
                        00000000            00        000000    00
                        DEBNMEXT  DEBUSRPG  DEBPRIOR  DEBECBAD  DEBP
                        01        000000    00        000000    0F
                        DEBUCBAD  DEBBINUM  DEBSTRCC  DEBSTRHH  DEBE
                        FAB1E8    0000      004E      0000      004E
                      * DCB-DCBIFLGS/DCBDEBAD
                        008E1404
     USRFF FFF ASCB 00F95B80            JOBN GENERJO
               WKAREA 4 7 CCW'S-DXCCW1      DXCCW2              DXCC
                        00000000  00000000  00000000  00000000  0000
                        DXCCW6              DXCCW7
                        00000000  00000000  00000000  00000000
                      * REG SAVE-DXREG9     DXREGA    DXREGB    DXRE
                        008D6054            00FAB1E8  00000000  008E
                      * MOD IDS-DXCALLID    DXRETID   DXRETTTR  DXRE
                        0000                F5C1      D9CBB0    00
                        DXABCODE  DXSAVID   DXSAVADR  DXSAVOFF
                        0000      0000      000000    00
     USRFF FFF ASCB 00F95B80            JOBN GENERJO
               WKAREA 5 DXWORK    DXWORK1   DXWORK2   DXWORK3   DXWO
                        00000000  00000000  00000000  00000000  0020
                        DXVOLSR3            DXVOLSEQ  DXNOUNIT  DXUN
                        00000000  0000      0001      0000      0000
                        DXASCBAD  DXTCBADR  DXJSCBAD  DXDSABQD  DXDS
                        00F95B80  008F1698  008FF6B4  008DDFE0  008D
                        DXUDCBAD  DXPDCBAD  DXUDCBPL  DXUDCBML  DXPR
                        00008968  008E1248  0000      0058      0000
                        DXATCOM1  DXATCOM2  DXATCOM3  DXATCOM4  DXAT
                        00000000  00000000  008E1784  00000000  0000
     USRFF FFF ASCB 00F95B80            JOBN GENERJO
               WTG TBL  WTGMODNM            WTGMODID  WTGMODEP  NOT
                        C9C6C7F0  F1F9      F3C1      00000000  0000
                        WTGPATHS  *WTGENTRY-WTGIDTTR  WTGCORE
                        0084      F4C10000  00        8E12C8
    
    O/C/EOV trace with OY47958:  Same truncation.
    
     USRFF FFF ASCB 00F6B400            JOBN HSM
               DCB      DEVICE INTERFACE
                        00000000  00000000  00000000  00000000  0000
                        DCBBUFNO  DCBBUFCB  DCBBUFL   DCBDSORG  DCBI
                        00        000001    0000      4000      0000
                        DCBMACRF  DCBIFLGS  DCBDEBAD  DCBOFLGS
                        0024      00        8D2B78    03
                        ACCESS  METHOD INTERFACE
                        000024    00000001  00000001  00004000  0000
     USRFF FFF ASCB 00F6B400            JOBN HSM
               WKAREA 1 VOL LBL, FILE LBL, DSCBS, OR MSG AREA   +10
                        00000000  00000000  00000000  00000000  0000
                        +28       +2C       +30       +34       +38
                        00000000  00000000  00000000  00000000  0000
                        +50       +54       +58       +5C       +60
                        00000000  00000000  00000000  00000000  0000
               WKAREA 2 JFCB-JFCBDSNM
                        STGHSM.HMIGTAPE.DATASET
                        E2E3C7C8  E2D44BC8  D4C9C7E3  C1D7C54B  C4C1
                        (CONT.)   JFCBELNM            JFCBTSDM  JFCD
                        40404040  40404040  40404040  00        0000
                        /JFCBFLSQ JFCBVLSQ  JFCBMASK            JFCB
                        0001      0000      00000000  00002400  5D00
                        JFCBUFL   JFCEROPT  DEV CHAR  JFCDEN    JFCL
                        0000      00        04        00        0000
                        JFCNCP    JFCNTM    SEGMENTS            JFCC
                        00        00        00000000  00        00
                        JFCBVOLS
                        F0F1F5F9  F9F74040  40404040  40404040  4040
                        JFCBPQTY  JFCBCTRI  JFCBSQTY  RESERVED  JFCB
                        000000    00        000000    00        0000
                        JFCBSPTN
                        00
     USRFF FFF ASCB 00F6B400            JOBN HSM
               WKAREA 3 DXECB
                        20000000
                      * IOB-IOBFLAG1        IOBFLAG2  IOBSENS0  IOBS
                        02                  00        00        00
                        IOBSTAT1  IOBCNT    IOBSIOCC  IOBSTART  IOBW
                        00        0000      00        8D2CE8    00
                        DXDAADDR
                        00000000  00000000
                      * DEB-DXDEBDEB        DEBOFLGS  DEBIRBAD  DEBO
                        00000000            00        000000    00
                        DEBNMEXT  DEBUSRPG  DEBPRIOR  DEBECBAD  DEBP
                        01        000000    00        000000    0F
                        DEBUCBAD  DEBBINUM  DEBSTRCC  DEBSTRHH  DEBE
                        FC88E0    0000      01CF      0000      01CF
                      * DCB-DCBIFLGS/DCBDEBAD
                        008D2CB4
     USRFF FFF ASCB 00F6B400            JOBN HSM
               WKAREA 4 7 CCW'S-DXCCW1      DXCCW2              DXCC
                        00000000  00000000  00000000  00000000  0000
                        DXCCW6              DXCCW7
                        0F000000  00000000  00000000  00000000
                      * REG SAVE-DXREG9     DXREGA    DXREGB    DXRE
                        008E011C            00FC88E0  002DBAAD  008D
                      * MOD IDS-DXCALLID    DXRETID   DXRETTTR  DXRE
                        0000                F5C2      DADFA0    00
                        DXABCODE  DXSAVID   DXSAVADR  DXSAVOFF
                        0000      0000      000000    00
     USRFF FFF ASCB 00F6B400            JOBN HSM
               WKAREA 5 DXWORK    DXWORK1   DXWORK2   DXWORK3   DXWO
                        00000000  00000000  00000000  00000000  0000
                        DXVOLSR3            DXVOLSEQ  DXNOUNIT  DXUN
                        00000000  0000      0001      0000      0000
                        DXASCBAD  DXTCBADR  DXJSCBAD  DXDSABQD  DXDS
                        00F6B400  008D1B38  008FFB7C  008E7FE0  008E
                        DXUDCBAD  DXPDCBAD  DXUDCBPL  DXUDCBML  DXPR
                        004368C8  008D2AF8  0000      0058      0000
                        DXATCOM1  DXATCOM2  DXATCOM3  DXATCOM4  DXAT
                        00000000  000C0000  008D2EDC  00000000  0000
                        TIME: A765C117 58F28C00   08:19:29.092392
     USRFF FFF ASCB 00F6B400            JOBN HSM
               WTG TBL  WTGMODNM            WTGMODID  WTGMODEP  NOT
                        C9C6C7F0  F1F9      F3C1      00000000  0000
                        WTGPATHS  *WTGENTRY-WTGIDTTR  WTGCORE
                        0080      F4C10000  00        8D2B78
               EXITING MODULE
                        IFG0193A
               ENTERING MODULE
                        IFG0194A
    

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    II06950

  • Reported component name

    V2 LIB INFO ITE

  • Reported component ID

    INFOV2LIB

  • Reported release

    001

  • Status

    INTRAN

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    1993-05-06

  • Closed date

  • Last modified date

    1993-05-07

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19N","label":"APARs - OS\/390 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
14 December 2020