Trailing-Edge
-
PDP-10 Archives
-
BB-JF18A-BM
-
sources/diu/diucrx.req
There are 4 other files named diucrx.req in the archive. Click here to see a list.
! COPYRIGHT (C) DIGITAL EQUIPMENT CORPORATION 1986.
! ALL RIGHTS RESERVED.
!
! THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND
! COPIED ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH
! THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR
! ANY OTHER COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE
! AVAILABLE TO ANY OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE
! SOFTWARE IS HEREBY TRANSFERRED.
!
! THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT
! NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL
! EQUIPMENT CORPORATION.
!
! DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF
! ITS SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL.
! *********************************************************************************************************************************
! Created 2-NOV-1984 08:58:50 by VAX-11 SDL V2.1 Source: 23-MAR-1984 16:53:17 DRACULA:[RICHARDSON.CRX]CRX.SDL;26
! *********************************************************************************************************************************
LIBRARY 'BLI:XPORT';
!*** MODULE crx$record_description_tree ***
literal crx$k_major_version = 1;
literal crx$k_minor_version = 3;
!
!
! Structure Declarations for the CDD Record Description Extractor
!
! Version 1.3
!
! Chip Nylander
! 13-May-1983
!
! Modifications:
!
! Version Date Who Description
! ------- ----------- --- -----------
!
! 1.1 31-May-1983 CGN Added crm$w_ref_length and
! crm$a_reference to support the new
! CDD$K_REC_REFERENCE attribute.
!
! Added crx$b_description_cnt and
! crx$a_description to support root
! descriptions.
!
! Added crm$v_string_type and
! crm$v_compute_type.
!
! Added crm$w_max_digits.
!
! Added crm$v_debug_flag to help
! interpret debugging dumps.
!
! Added crm$v_first_child.
!
! Added cro$l_max_length,
! cro$l_max_member_length, cro$l_min_offset,
! and cro$l_min_member_offset
!
! 1.2 14-Mar-1984 CGN Added crm$v_blank_when_zero to support
! CDD$K_REC_BLANK_WHEN_ZERO.
!
! Added crm$v_right_justified to support
! CDD$K_REC_RIGHT_JUSTIFIED.
!
! Added crm$w_initial_length and
! crm$a_initial_value to support
! CDD$K_REC_INITIAL_VALUE.
!
! Added crm$v_source_type_trunc,
! crm$v_reference_trunc, crm$v_initial_value_trunc,
! and crs$v_string_trunc to flag truncated
! strings.
!
! Added crm$v_facility_use_1 to 6 to
! allow client facilities to mark nodes
! for their own purposes.
!
! Added cro$w_tag_val_cnt, cro$a_tag_values,
! and the new crx_literal_list node to support
! support CDD$K_TAG_VALUES. (crx_literal_list
! nodes support literal value sets in
! general, but tag values are the only
! use currently).
!
! Add crs$v_binary_string to distinguish
! binary strings from text strings.
!
! Delete all references to CDD$K_REC_LITERALS,
! since the attribute has been removed
! from the protocol documentation and it
! looks like nobody will ever support or
! use it.
!
! 1.3 23-Mar-1984 CGN Added cro$l_total_length.
!
! 4 4-June-85 CLR Use facility-use-bit 3 to flag
! fullword-allocated initial values.
!
!
! The general form of the record description returned by the record.
! extractor is that of an acyclic graph. The root node is crx_record,
! which points to the crx_member node for the first member of the record.
! All record members at the same logical level are linked as siblings,
! and crx_member points to the crx_member node for it's first subfield,
! if any.
!
! The crx_dimension, crx_overlay, and crx_stringlist nodes are
! optional subgraphs of crx_members which have those attributes.
!
! All facility-specific information is isolated in optional facility-specific
! nodes. These nodes are pointed to by the nodes for which facility-specific
! attributes are present. Facility-specific information for only one facility
! at a time may be present in the record description tree.
! As new facilities are supported by the record extractor, new
! facility-specific nodes will be defined. Likewise, as additional
! facility-specific information is defined for supported facilities,
! the facility-specific nodes will be enhanced.
!
! All non-facility-specific information contained by a cdd record description
! is returned. Not all of it is necessarily interesting. The protocol and
! core_level field, for example, will always be the same (otherwise the record
! description would not have been extracted); they are returned for
! completeness.
!
! Each field is either "required" or "optional", and either "core" or
! "non-core".
!
! A "required" field is one which will always contain a value in any
! occurence of it's containing node type; a language processor
! does not have to consider the case of that attribute being
! undefined or absent. An "optional" field is one which might not contain
! a value; a language processor must consider the case of that attribute
! being undefined or absent. By convention, a numeric field that contains
! no value is zero; a character field that contains no value is blank.
! For those fields (e.g. lower_bound) for which zero is a valid value, a flag
! is defined to differentiate a zero value from a non-value.
!
! A "core" field is one whose value must not be ignored by a language
! processor if it contains a value. A non-core field is one which may be
! ignored if a language processor does not wish to process it.
!
! A field which is neither "core" nor "non-core" is not a cdd attribute;
! such a field is provided to aid in processing of the "core" and "non-core"
! fields.
!
! For more information, see "VAX-11 Common Data Dictionary Protocol for
! Storing Record Descriptions".
!
!
literal crx$k_record = 1;
literal crx$k_member = 2;
literal crx$k_overlay = 3;
literal crx$K_DIMENSION = 4;
literal crx$k_stringlist = 5;
literal crx$k_pli_specific = 6;
literal crx$k_literal_list = 7;
literal crx$s_max_string = 255; ! maximum length string allowed
!
! Note that, for all following data structures, the first longword
! is a backpointer, the second longword, if non-zero, is the address
! of a subgraph, and the first byte of the third longword is a
! self-identification byte.
!
literal crx$s_protocol = 10;
$FIELD crx_record$FIELDSET =
SET
! cdd record node
crx$l_mbz = [$ADDRESS], ! must be zero
crx$a_root = [$ADDRESS], ! root crx_member node
! (optional core)
crx$b_id = [$BYTE], ! always CRX$K_RECORD
! (required)
crx$b_core_level = [$BYTE], ! protocol level - currently
! should be 4
! (required core)
crx$t_protocol = [$STRING (10)], ! protocol - should be
! "CDD$RECORD"
! (required core)
crx$w_facility_code = [$SHORT_INTEGER], ! facility code for facility-
! specific info, if any
! (optional)
crx$b_description_cnt = [$BYTE], ! number of strings in
! description stringlist
! (required)
!crx$t_reserved = [$STRING (1)], ! [preserve longword alignment]
crx$a_facility = [$ADDRESS], ! facility-specific node
! for record
! (optional non-core)
crx$l_format = [$LONG_INTEGER], ! format - currently should be
! CDD$K_REC_FIXED or
! CDD$K_REC_VARIABLE
! (required core)
crx$a_description = [$ADDRESS] ! address of crx_stringlist
! which documents the record
! (optional non-core)
TES;
LITERAL diu$s_crx_record = $FIELD_SET_SIZE;
LITERAL crx$s_crx_record = $FIELD_SET_SIZE * %upval;
MACRO crx_record = BLOCK [diu$s_crx_record] FIELD (crx_record$FIELDSET) %;
LITERAL crm$s_name = 31;
$FIELD crx_member$FIELDSET =
SET
! subaggregate or field node
crm$a_previous = [$ADDRESS], ! backpointer to previous node
! (required)
crm$a_next = [$ADDRESS], ! next member node this level
! (optional core)
crm$b_id = [$BYTE], ! always CRX$K_MEMBER
! (required)
crm$b_description_cnt = [$BYTE], ! number of strings in
! description stringlist
! (required)
crm$w_source_length = [$SHORT_INTEGER], ! source_type length
! (required)
crm$w_ref_length = [$SHORT_INTEGER], ! reference length
! (required)
crm$w_children_cnt = [$SHORT_INTEGER], ! number of children or overlays
! (required)
crm$b_tag_variable_cnt = [$BYTE], ! number of strings in
! tag_variable stringlist
! (required)
crm$b_dimensions_cnt = [$BYTE], ! number of dimensions
! (required)
crm$b_name_length = [$BYTE], ! member name length
! (required)
crm$t_name = [$STRING (31)], ! member name
! (optional core)
!crm$t_reserved = [$STRING (2)], ! [preserve longword alignment]
crm$a_description = [$ADDRESS], ! address of crx_stringlist
! which documents the member
! (optional non-core)
crm$a_source_type = [$POINTER], ! address of a string
! which is the pathname of a
! type-definition of which
! this field is an occurence
! (optional non-core)
crm$A_REFERENCE = [$POINTER], ! address of a string
! which is the pathname of a
! record to which this field
! points
! (optional non-core)
crm$a_children = [$ADDRESS], ! root of children list
! if datatype <> OVERLAY then
! this will point to a crx_member
! node; if datatype = OVERLAY
! then this will point to a
! crx_overlay node.
crm$a_tag_variable = [$ADDRESS], ! crx_stringlist which is the
! fully qualified name of
! an overlay's tag variable.
! valid only if datatype = OVERLAY
! (optional non-core)
crm$L_LENGTH = [$LONG_INTEGER], ! bit-length of field or, for
! arrays, each element
! (optional core)
crm$l_offset = [$LONG_INTEGER], ! bit-offset from parent field
! (optional core)
crm$l_member_length = [$LONG_INTEGER], ! bit-length of entire field;
! same as length for scalars,
! larger for arrays.
! (required)
crm$l_member_offset = [$LONG_INTEGER], ! bit-offset from beginning of
! record
! (required)
crm$l_string_units = [$LONG_INTEGER], ! for bit and character strings,
! the number of units (bits or bytes)
! (required)
crm$a_dimensions = [$ADDRESS], ! root of crx_dimension list
! (optional core)
crm$l_total_cells = [$LONG_INTEGER], ! for fields with dimensions,
! the total number of cells
! in the array
! (required)
crm$a_facility = [$ADDRESS], ! facility-specific node
! for member
! (optional non-core)
crm$w_datatype = [$SHORT_INTEGER], ! datatype
! (required core)
crm$w_digits = [$SHORT_INTEGER], ! number of digits
! (optional non-core)
crm$w_max_digits = [$SHORT_INTEGER], ! maximum legal digits
! (required)
crm$w_scale = [$SHORT_INTEGER], ! scale factor
! (optional core)
crm$b_base = [$BYTE], ! mode for digits and scale
! (optional core)
crm$v_column_major = [$BITS (1)], ! for fields with dimensions,
! 1 if stride is column-major
! (required)
crm$v_string_type = [$BITS (1)], ! 1 if datatype is string type
! (required)
crm$v_compute_type = [$BITS (1)], ! 1 if datatype is computational
! (required)
crm$v_debug_flag = [$BITS (1)], ! debugging aid
! (required)
crm$v_first_child = [$BITS (1)], ! set if this is first child
! in a children list
! (required)
crm$v_blank_when_zero = [$BITS (1)], ! 1 if field blank when zero
! (optional non-core)
crm$v_right_justified = [$BITS (1)], ! 1 if field right justified
! (optional non-core)
crm$v_source_type_trunc = [$BITS (1)], ! 1 if source_type string was truncated
crm$v_reference_trunc = [$BITS (1)], ! 1 if reference string truncated
crm$v_initial_value_trunc = [$BITS (1)], ! 1 if initial_value string truncated
! Use of facility-specific bits in DIU:
! Bit 1 is used during record tree creation, and its use for other
! purposes should be avoided, at least until record tree creation
! is complete.
! Bit 2 is used to mark a field in a tree as having been "used" in a transform,
! for purposes of doing MOVE OTHERS MATCHING. If the field has been
! involved in a transform, the bit is set.
! Bit 3 is used to indicate that the initial value in this member block
! is allocated in fullwords rather than in ASCII characters.
! Bit 4 is not currently used.
! Bits 5 and 6 are combined to form a 2-bit field indicating what datatype
! mapping applies. DIL_SRC indicates that the datatypes are DIL ones.
crm$v_facility_use_1 = [$BITS (1)], ! for callers, not used by CRX
crm$v_facility_use_2 = [$BITS (1)], ! for callers, not used by CRX
crm$v_facility_use_3 = [$BITS (1)], ! for callers, not used by CRX
crm$v_facility_use_4 = [$BITS (1)], ! for callers, not used by CRX
crm$v_facility_use_5 = [$BITS (2)], ! for callers, not used by CRX
!crm$v_facility_use_6 = [$BITS (1)], ! for callers, not used by CRX
!crm$b_reserved_byte = [$BYTE], ! [preserve longword alignment]
crm$a_initial_value = [$POINTER], ! address of a binary string
! which is the initial value
! for this field
! (optional non-core)
crm$w_initial_length = [$SHORT_INTEGER] ! length of initial_value string
! in bytes
! (required)
TES;
LITERAL diu$s_crx_member = $FIELD_SET_SIZE;
LITERAL crm$s_crx_member = $FIELD_SET_SIZE * %upval;
MACRO crx_member = BLOCK [diu$s_crx_member] FIELD (crx_member$FIELDSET) %;
$FIELD crx_overlay$FIELDSET =
SET
! info for one overlay
cro$a_previous = [$ADDRESS], ! backpointer to previous node
! (required)
cro$a_next = [$ADDRESS], ! next overlay node this level
! (optional core)
cro$b_id = [$BYTE], ! always CRX$K_OVERLAY
! (required)
!cro$t_reserved = [$STRING (1)], ! [preserve longword alignment]
cro$w_fields_cnt = [$SHORT_INTEGER], ! number of immediate children
! in fields list
! (required)
cro$a_fields = [$ADDRESS], ! list of overlay crx_members
! (required core)
cro$l_max_length = [$LONG_INTEGER], ! length of longest immediate
! member
! (required)
cro$l_min_offset = [$LONG_INTEGER], ! smallest offset of immediate
! members
! (required)
cro$l_max_member_length = [$LONG_INTEGER], ! member_length of longest
! immediate member
! (required)
cro$l_min_member_offset = [$LONG_INTEGER], ! smallest member_offset of
! immediate members
! (required)
cro$a_tag_values = [$ADDRESS], ! root of crx_literal_list
! which contains the tag
! values and ranges for
! this overlay
! (optional non-core)
cro$w_tag_values_cnt = [$SHORT_INTEGER], ! number of literals and ranges
! in tag_values list
! (required)
cro$l_total_length = [$LONG_INTEGER] ! length of concatenated members
! (required)
TES;
LITERAL diu$s_crx_overlay = $FIELD_SET_SIZE;
LITERAL cro$s_crx_overlay = $FIELD_SET_SIZE * %upval;
MACRO crx_overlay = BLOCK [diu$s_crx_overlay] FIELD (crx_overlay$FIELDSET) %;
$FIELD crx_literal_list$FIELDSET =
SET
! member of a literal value
! set list
crl$a_previous = [$ADDRESS], ! backpointer to previous node
! (required)
crl$a_next = [$ADDRESS], ! next crx_literal_list node
! (optional core)
crl$b_id = [$BYTE], ! always CRX$K_LITERAL_LIST
! (required)
!crl$b_reserved = [$BYTE], ! [preserve alignment]
crl$w_literals_cnt = [$SHORT_INTEGER], ! number of literals in
! literals stringlist
! (required)
crl$a_literals = [$ADDRESS] ! address of a stringlist of
! binary strings.
! if literals_cnt is 1, then
! this is a singular literal
! value. if literals_cnt
! is 2, then this is a range.
! (I realize that using a
! stringlist here may be
! slightly inconvenient, but
! that's the structure in the
! CDD record protocol, and it
! seems prudent to follow a
! consistent mapping. This
! also means that any utility
! procedures that work for
! the other stringlists also
! work for these.)
TES;
LITERAL diu$s_crx_literal_list = $FIELD_SET_SIZE;
LITERAL crl$s_crx_literal_list = $FIELD_SET_SIZE * %upval;
MACRO crx_literal_list = BLOCK [diu$s_crx_literal_list] FIELD (crx_literal_list$FIELDSET) %;
$FIELD crx_dimension$FIELDSET =
SET
! info for one dimension
crd$a_previous = [$ADDRESS], ! backpointer to previous node
! (required)
crd$a_next = [$ADDRESS], ! next crx_dimension node
! (optional core)
crd$b_id = [$BYTE], ! always CRX$K_DIMENSION
! (required)
crd$b_depend_item_cnt = [$BYTE], ! number of string in
! depend_item stringlist
! (required)
!crd$t_reserved = [$STRING (2)], ! [preserve longword alignment]
crd$l_lower_bound = [$LONG_INTEGER], ! lower bound of dimension
! (optional core)
crd$l_upper_bound = [$LONG_INTEGER], ! upper bound of dimension
! (optional core)
crd$l_stride = [$LONG_INTEGER], ! number of bits covered in
! a single stride by this
! dimension
! (optional core)
crd$a_depend_item = [$ADDRESS], ! crx_stringlist which is the
! fully qualified name of
! the field upon which the
! actual number of subscript
! value is conditioned
! (optional non-core)
crd$l_min_occurs = [$LONG_INTEGER], ! minumum number of occurences
! this dimension may have
! (optional non-core)
crd$v_lower_bound_fl = [$BITS (1)], ! existence flag for lower_bound
! (required)
crd$v_upper_bound_fl = [$BITS (1)], ! existence flag for upper_bound
! (required)
crd$v_stride_fl = [$BITS (1)], ! existence flag for stride
! (required)
crd$v_min_occurs_fl = [$BITS (1)] ! existence flag for min_occurs
! (required)
TES;
LITERAL diu$s_crx_dimension = $FIELD_SET_SIZE;
LITERAL crd$s_crx_dimension = $FIELD_SET_SIZE * %upval;
MACRO crx_dimension = BLOCK [diu$s_crx_dimension] FIELD (crx_dimension$FIELDSET) %;
$FIELD crx_stringlist$FIELDSET =
SET
! member of a stringlist
crs$a_previous = [$ADDRESS], ! backpointer to previous node
! (required)
crs$a_next = [$ADDRESS], ! next crx_stringlist node
! (optional core)
crs$b_id = [$BYTE], ! always CRX$K_STRINGLIST
! (required)
! (required)
crs$v_string_trunc = [$BITS (1)], ! 1 if string was truncated
crs$v_binary_string = [$BITS (1)], ! 1 if bit string
!crs$v_reserved = [$BITS (6)], ! [preserve longword alignment]
$align (BYTE)
crs$w_string_length = [$SHORT_INTEGER], ! length of string, in bytes
crs$a_string = [$POINTER] ! address of string
! (required core)
TES;
LITERAL diu$s_crx_stringlist = $FIELD_SET_SIZE;
LITERAL crs$s_crx_stringlist = $FIELD_SET_SIZE * %upval;
MACRO crx_stringlist = BLOCK [diu$s_crx_stringlist] FIELD (crx_stringlist$FIELDSET) %;
literal crx$k_pli_facility = 135;
$FIELD crx_pli_specific$FIELDSET =
SET
! pli-specific information
! for one record or member
crx_pli$a_previous = [$ADDRESS], ! backpointer to previous node
! (required)
crx_pli$l_mbz = [$ADDRESS], ! must be zero
crx_pli$b_id = [$BYTE], ! always CRX$K_PLI_SPECIFIC
! (required)
crx_pli$b_name_length = [$BYTE], ! length of name string
! (required)
crx_pli$w_picture_length = [$SHORT_INTEGER], ! length of picture string
! (required)
crx_pli$a_picture = [$POINTER], ! address of string
! which is the pli-specific
! picture
! (optional non-core)
crx_pli$a_name = [$POINTER] ! address of string
! which is the pli-specific
! name
! (optional non-core)
TES;
LITERAL diu$s_crx_pli_specific = $FIELD_SET_SIZE;
LITERAL crx_pli$s_crx_pli_specific = $FIELD_SET_SIZE * %upval;
MACRO crx_pli_specific = BLOCK [diu$s_crx_pli_specific] FIELD (crx_pli_specific$FIELDSET) %;