OSI/AS Programming Manual

Parameter Structures
DDL Definitions
A–18 056783 Tandem Computers Incorporated
ZAPS-DDL-TOKENS has two uses. In indications, it defines the availability and
ownership of session tokens. In token give and token please requests, and in requests
and responses that use basic concatenation, it identifies which tokens you are giving or
asking for. For an explanation of the session tokens, see Section 2. For lists of the valid
values for the individual procedure calls, see Section 3. For further information about
tokens, see the OSI session service standard, ISO 8326.
DEFINITION ZAPS-DDL-TOKENS.
02 ZRELEASE TYPE ZAPS-DDL-ENUM1.
02 ZDATA TYPE ZAPS-DDL-ENUM1.
02 ZMINORSYNC TYPE ZAPS-DDL-ENUM1.
02 ZMAJORSYNC TYPE ZAPS-DDL-ENUM1.
02 ZACTIVITY REDEFINES ZMAJORSYNC
TYPE ZAPS-DDL-ENUM1.
END
The possible values for each of the 02-level fields are as follows:
CONSTANT ZAPS-VAL-TOKEN-NOVALUE VALUE 0.
CONSTANT ZAPS-VAL-TOKEN-GIVE VALUE 1.
CONSTANT ZAPS-VAL-TOKEN-PLEASE VALUE 2.
CONSTANT ZAPS-VAL-TOKEN-ACCEPTOR-CHOICE VALUE 3.
CONSTANT ZAPS-VAL-TOKEN-NOTAVAILABLE VALUE 4.
CONSTANT ZAPS-VAL-TOKEN-OWNED VALUE 5.
CONSTANT ZAPS-VAL-TOKEN-NOTOWNED VALUE 6.
For information on which tokens are available with which functional units, see
Table 3-1 in Section 3.
ZAPS-VAL-TOKEN-NOVALUE is used to show that you are not interested in the
value of this token in the current procedure.
ZAPS-VAL-TOKEN-GIVE has two uses. Use it in a give token request primitive (by
calling APS_TOKEN_GIVE_ or by using the basic concatenation feature) to give the
token to the remote application. The session service provider uses it in the give token
indication primitive to tell your application that the remote application is giving your
application the token.
ZAPS-VAL-TOKEN-PLEASE has two uses. Use it in a please token request primitive
(by calling APS_TOKEN_PLEASE_ or by using the basic concatenation feature) to ask
for the token from the remote application. The session service provider uses it in the
please token indication primitive to tell you that the remote application is requesting
the token from your application.
ZAPS-VAL-TOKEN-ACCEPTOR-CHOICE shows that the application requesting a
connection or resynchronization leaves the token ownership open. The application
accepting the request can choose the initial owner of the token.