Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### REFCB

Prolog

Control Block Contents
REFCB DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### REFCB Prolog

     Name       : DMSREFCB
     Description: Reference Table (REFTBL) Entry
     DSECT      : REFCB
     Function   : Maps the entries in the Reference Table (REFTBL),
                  better known as the Loader Table.

#### REFCB Control Block Content

#### REFCB DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      REFCB          Reference table entry mapping
    0000    0 Character    8 REFNAME        ESD symbolic name
    0008    8 Bitstring    1 REFFLG1        Flag byte
              ...1 ....      REFNOLIB       X'10' Do not use TXTLIB to
                                            resolve
              .1.. ....      REFLENZ        X'40' CSECT LENGTH IS ZERO
              ..1. ....      REFALIAS       X'20' Found as ALIAS in TXTLIB
              1... ....      REFUND         X'80' Undefined symbol
              .... .1..      REFCXDTR       X'04' CXD value from TRANPR table
              1... ...1      REFCXD         X'81' Resolve CXD
              1... ..1.      REFCOM         X'82' Define common area
              1... ..11      REFWEX         X'83' Weak external reference
    0008    8 Bitstring    1 REFALIGN       Alignment for pseudo register,
                                            initially 0=BYTE 1=HW 3=FW 7=DW
                                            Later as EQUATES below
              .111 11..      REFPRB         X'7C' PR with BYTE alignment
              .111 11.1      REFPRH         X'7D' PR with HALFWORD alignment
              .111 111.      REFPRF         X'7E' PR with FULLWORD alignment
              .111 1111      REFPRD         X'7F' PR with DOUBLEWORD
                                            alignment
    0009    9 Bitstring    3 REFINFO        Reserved for compatibility In CMS
                                            5.5 and later, this field
                                            contains the ESD address field
                                            information that was extracted
                                            from the ESD record. It is used
                                            with the REFINF31 field to
                                            produce the absolute address of
                                            the loaded TEXT file. Used in
                                            GENMOD process. This field will
                                            be set for ESD type O/SD, 1/LD,
                                            4/PC type entry.
    000C   12 Bitstring    4 REFVAL         Absolute address (in object deck)
                                            in CMS releases prior to 5.5.
                                            Assigned value for PR and COMMON
                                            Start of chain WAITING FOR
                                            UNDEFINED SYMBOL to be resolved
                                            In CMS 5.5 and later, this field
                                            reflects the entry point
                                            associatd with the ESD records of
                                            the loaded TEXT file once the
                                            load is completed.
    0010   16 Bitstring    1 REFFLG2        Flag byte
              1... ....      REFCMD         X'80' Command line name - must
                                            resolve
              .1.. ....      REFRMODE       X'40' 0=RMODE 24 1=RMODE ANY
              ..11 ....      REFAMODE       X'30' 01=AMODE 24, 10=AMODE
                                            31,11=AMODE ANY
              ..11 ....      REFAMANY       X'30' AMODE ANY
              ..1. ....      REFAM31        X'20' AMODE 31
              ...1 ....      REFAM24        X'10' AMODE 24
              .... 1...      REFICS         X'08' ICS alter length waiting
                                            for match
              .... .1..      REFLBT         X'04' Name was located in TXTLIB
              .... ..1.      REFCSD         X'02' Section definition (SD)
                                            entry
              .... ...1      REFNEG         X'01' Negative relocation factor
    0011   17 Bitstring    3 REFADDR        ICS CSECT length
    0010   16 Bitstring    4 REFQCONA       In CMS 5.5 and later, this field
                                            contains pointer to RLD buffers
                                            that contain the location of Q
                                            typ contstants that may need to
                                            be resolved to reflect correct
                                            offset value.
    0014   20 Bitstring    4 REFINF31       Relocation factor 31-bit address
                                            for ESD type entry, may have: max
                                            length for 5/CM entry, length for
                                            6/PR/XD entry, reloc value for
                                            0/SD entry reloc value for 1/LD
                                            entry reloc value for 4/PC entry
                                            In CMS 5.5 and later, when this
                                            field and the value in the
                                            REFINFO field are added together,
                                            the absolute location of the
                                            loaded TEXT is produced.
              00000018       REFLEN         *-REFCB REFTBL entry length

#### REFCB Storage Layout

    *** REFCB - Control Block in REFCB
    *
    *     +-------------------------------------------------------+
    *   0 |                       REFNAME                         |
    *     +------+------------------------------------------------+
    *   8 |:FLG1 | 9
    *     +------+
    *
    *** REFCB - Control Block in REFCB

    *** Overlay for REFFLG1 in REFCB
    *
    *     +------+--------------------+---------------------------+
    *   8 |:ALIGN|      REFINFO       |          REFVAL           |
    *     +------+--------------------+---------------------------+
    *  10 |:FLG2 |      REFADDR       | 14
    *     +------+--------------------+
    *
    *** Overlay for REFFLG1 in REFCB

    *** Overlay for REFFLG2 in REFCB
    *
    *     +---------------------------+---------------------------+
    *  10 |         REFQCONA          |         REFINF31          |
    *     +---------------------------+---------------------------+
    *  18
    *
    *** Overlay for REFFLG2 in REFCB

#### REFCB Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    REFADDR        0011
    REFALIAS       0008 20
    REFALIGN       0008
    REFAMANY       0010 30
    REFAMODE       0010 30
    REFAM24        0010 10
    REFAM31        0010 20
    REFCMD         0010 80
    REFCOM         0008 82
    REFCSD         0010 02
    REFCXD         0008 81
    REFCXDTR       0008 04
    REFFLG1        0008
    REFFLG2        0010
    REFICS         0010 08
    REFINFO        0009
    REFINF31       0014
    REFLBT         0010 04
    REFLEN         0014 00000018
    REFLENZ        0008 40
    REFNAME        0000
    REFNEG         0010 01
    REFNOLIB       0008 10
    REFPRB         0008 7C
    REFPRD         0008 7F
    REFPRF         0008 7E
    REFPRH         0008 7D
    REFQCONA       0010
    REFRMODE       0010 40
    REFUND         0008 80
    REFVAL         000C
    REFWEX         0008 83

This information is based on z/VM V4R4.0.
Last updated on 28 Jul 2003 at 08:17:14 EDT.
Copyright IBM Corporation, 1990, 2003