VINBK | Back to Index page

| Prolog Control Block Contents VINBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

VINBK Prolog | Top of page

     NAME       : HCPVINBK
     DESCRIPTION: VMDUMP invocation block
     DSECT      : VINBK
     FUNCTION   : To record parameters specific to this
                  invocation of VMDUMP/diagnose X'94'.  This
                  control block is destroyed after each
                  invocation.  This is in contrast to the
                  VDUBK, which relates to a specific VMDUMP
                  file, and exists across invocations done in
                  'continuous mode'.
     LOCATED BY : VDUVINPT pointer
     CREATED BY : HCPVMPAR
     DELETED BY : HCPVMPAR
     REFERENCES : None
     RELOCATION CONSIDERATIONS : None
     COMMENTS   : None

VINBK Control Block Content | Top of page

     VINBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      VINBK          VMDUMP invocation block
    0000    0 Signed       4 VINERR         Severe error code
    0004    4 Signed       4 VININFO        Informational error code
    0008    8 Signed       4 VINFSTPM       SDF record position of first
                                            pagemap
    000C   12 Address      4 VINTOKPT       Pointer within the input buffer
                                            of where the last token was
                                            found. (Start of buffer if no
                                            tokens found yet.)
    0010   16 Signed       4 VINTOKLF       Characters left in input buffer
    0014   20 Signed       4 VINLSTLN       Length of last token found (Zero
                                            if none found yet.)
    0018   24 Character   36 VINTOKST       The storage to store VINTOKEN
    003C   60 Signed       4 VINTOKLN       Length of VINTOKEN
    0040   64 Character   32 VINUSRST       The storage to store VINUSR
    0060   96 Signed       4 VINUSRLN       Length of VINUSR
    0064  100 Signed       4 VINTOKIX       Index into HCPVGT's option tbl
                                            telling what operand was found
       The VINFRST and VINANY flags are exact copies of VDUFRST
       and VDUANY flags.  The VDUFRST and VDUANY flags are set by
       ORing VINFRST and VINANY with VDUFRST and VDUANY following
       parsing.  They must be exact matches.
    0068  104 Signed       2 VINDMPFL (0)   Dump options given on this
                                            invocation. Must match VDUFLAGS
                                            exactly.
    0068  104 Bitstring    1 VINFRST        Flags which must be specified on
                                            first dump-type invocation
              1... ....      VINTSELF       X'80' VINTSELF 'TO SELF' was
                                            specified
              .1.. ....      VINTO          X'40' VINTO 'TO' or 'SYSTEM' was
                                            specified
              ..1. ....      VINNRTRN       X'20' VINNRTRN 'NORETURN' was
                                            specified
              .... 1...      VINNODMP       X'08' VINNODMP 'NODUMP' was
                                            specified
    0069  105 Bitstring    1 VINANY         Flags which can be specified
                                            anytime
              ..1. ....      VINDUMP        X'20' VINDUMP 'DUMP' was
                                            specified
              ...1 ....      VININLIN       X'10' VININLIN Inline range found
                                            VDUSRDON and is never set in in
                                            this block.
              .... ..1.      VINSR          X'02' VINSR 'SR' was specified
    006A  106 Bitstring    1 VINVGTFL       HCPVGT processing flags
              1... ....      VINSRCH        X'80' VINSRCH Search for a
                                            VINTOKIX
              .1.. ....      VINDMPDW       X'40' VINDMPDW DUMP Address token
                                            is 8 bytes long
    006B  107 Bitstring    1 VINSTAT        Status flags
              1... ....      VINDUMPO       X'80' VINDUMPO A dump option
                                            (range, DCSS, format, etc.) was
                                            specified
              .1.. ....      VINDIAG        X'40' VINDIAG Called due to
                                            diagnose
    006C  108 Signed       4 VINMSGNM       Message number returned by
                                            HCPERMSG for output
    0070  112 Dbl-Word     8 * (0)
    0070  112 Bitstring    8 VINSRPG (0)    User SR address
    0070  112 Signed       4 VINSRPHI       High word
    0074  116 Signed       4 VINSRPLO       Low word
    0078  120 Address      4 VINASDBK       Anchor of ASDBK chain
    007C  124 Address      4 VINCURAS       ASDBK address for the address
                                            space qualifier in effect
    0080  128 Bitstring    1 VIN$END (0)    Defines end of control blk

VINBK Storage Layout | Top of page

    *** VINBK - VMDUMP invocation block
    *
    *     +---------------------------+---------------------------+
    *   0 |          VINERR           |         VININFO           |
    *     +---------------------------+---------------------------+
    *   8 |         VINFSTPM          |         VINTOKPT          |
    *     +---------------------------+---------------------------+
    *  10 |         VINTOKLF          |         VINLSTLN          |
    *     +---------------------------+---------------------------+
    *  18 |                                                       |
    *     =                       VINTOKST                        =
    *     |                           +---------------------------+
    *  38 |                           |         VINTOKLN          |
    *     +---------------------------+---------------------------+
    *  40 |                                                       |
    *     =                       VINUSRST                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  60 |         VINUSRLN          |         VINTOKIX          |
    *     +------+------+------+------+---------------------------+
    *  68 |:FRST |VINANY|:VGTFL|:STAT |         VINMSGNM          |
    *     +------+------+------+------+---------------------------+
    *  70 |         VINSRPHI          |         VINSRPLO          |
    *     +---------------------------+---------------------------+
    *  78 |         VINASDBK          |         VINCURAS          |
    *     +---------------------------+---------------------------+
    *
    *** VINBK - VMDUMP invocation block

VINBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    VIN$END        0080
    VINANY         0069
    VINASDBK       0078
    VINCURAS       007C
    VINDIAG        006B 40
    VINDMPDW       006A 40
    VINDMPFL       0068
    VINDUMP        0069 20
    VINDUMPO       006B 80
    VINERR         0000
    VINFRST        0068
    VINFSTPM       0008
    VININFO        0004
    VININLIN       0069 10
    VINLSTLN       0014
    VINMSGNM       006C
    VINNODMP       0068 08
    VINNRTRN       0068 20
    VINSR          0069 02
    VINSRCH        006A 80
    VINSRPG        0070
    VINSRPHI       0070
    VINSRPLO       0074
    VINSTAT        006B
    VINTO          0068 40
    VINTOKIX       0064
    VINTOKLF       0010
    VINTOKLN       003C
    VINTOKPT       000C
    VINTOKST       0018
    VINTSELF       0068 80
    VINUSRLN       0060
    VINUSRST       0040
    VINVGTFL       006A

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:34 EDT.
Copyright IBM Corporation, 1990, 2020