Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

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 fields used in the Reference Table (REFTBL).

 

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

(contains links to field and bit definitions)
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 VM/ESA 2.4.0.
Last updated on 18 Aug 1999 at 09:17:07 EDT.
Copyright IBM Corporation, 1990, 1999