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 (REFTBL) Entry
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 - Reference Table (REFTBL) Entry
*
*     +-------------------------------------------------------+
*   0 |                       REFNAME                         |
*     +------+------------------------------------------------+
*   8 |:FLG1 | 9
*     +------+
*
*** REFCB - Reference Table (REFTBL) Entry
          
*** 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 V4R1.0.
Last updated on 12 Jul 2001 at 14:02:19 EDT.
Copyright IBM Corporation, 1990, 2001