OSI/AS Programming Manual

Parameter Structures
DDL Definitions
A–6 056783 Tandem Computers Incorporated
Parameter Structures Some reference parameters to the APS procedures are defined by structures from the
ZAPSDDL file. These structures are used as data types for the procedure parameters,
and are named in parentheses in the descriptions of those parameters in Section 3. The
following pages provide general information about these structures. Explanations for
the individual fields in each structure and the values each field can assume follow the
DDL code for each structure. Named values described in the field explanations are
cross-referenced under “Named Values,” later in this appendix.
ZAPS-DDL-ACTIVITY-ID contains the identifier of an activity. This field can have
any value you supply. The case of alphabetic characters (uppercase or lowercase) in
the value is significant. The maximum length is six bytes; the minimum length is one
byte.
DEFINITION ZAPS-DDL-ACTIVITY-ID.
02 ZLEN TYPE ZAPS-DDL-INT1.
02 ZVAL PIC X(6).
END
ZLEN is the length, in bytes, of the activity identifier. Valid values are 1 through 6.
ZVAL is the value of the activity identifier itself.
ZAPS-DDL-AE-TITLE defines an ACSE application entity title (AE title). See ZAPS-
VAL-AE-TITLE-xxx later in this appendix for the values of ZAE-TITLE-TYPE.
DEFINITION ZAPS-DDL-AE-TITLE.
02 ZAE-TITLE-TYPE TYPE ZAPS-DDL-INT1.
02 ZAE-TITLE-FORMAT2.
03 ZAE-QUALIFIER-ISPRESENT TYPE ZAPS-DDL-ISPRESENT.
03 ZAE-QUALIFIER TYPE ZAPS-DDL-INT2.
03 ZAP-TITLE TYPE ZAPS-DDL-OBJ-ID.
END
ZAE-TITLE-TYPE is either ZAPS-VAL-AE-TITLE-FORMAT0, ZAPS-VAL-AE-TITLE-
FORMAT2 or ZAPS-VAL-AE-TITLE-NOCONTENT. ZAPS-VAL-AE-TITLE-
FORMAT0 identifies that an AE title is not present. ZAPS-VAL-AE-TITLE-FORMAT2
identifies an AE title in format 2. ZAPS-VAL-AE-TITLE-NOCONTENT indicates that
the AE title has no content, because it was received in a format unrecognized by
OSI/AS (for example, format 1). OSI/AS does not support AE titles in format 1.
ZAE-TITLE-FORMAT2 specifies an AE title in format 2. It can contain either an
application entity qualifier, an application process title, or both.
ZAE-QUALIFIER-IS-PRESENT specifies whether an application entity qualifier
(AE qualifier) is present. The value is either ZAPS-VAL-PRESENT or ZAPS-VAL-
ABSENT.