SNAX/APC Configuration and Management Manual

Introduction
SNAX/APC Configuration and Management Manual—138787
1-6
LU 6.2 Verb Categories
Conversational Verbs
The following types of conversational verbs have been defined for LU 6.2 and are
supported by SNAX/APC. All conversational verbs are fully documented in Section 2
of the SNAX/APC Application Programming Manual.
•
Basic conversation verbs are intended for use by service transaction programs,
performing end-user services such as CNOS actions.
•
Mapped conversation verbs are intended for use by the application programmers
who write the application TPs. Mapped conversations are easier to code than basic
ones because the programmer does not have to be concerned with the structure of
the underlying data stream. SNAX/APC actually converts the mapped conversation
into a basic (GDS format) conversation before data is transmitted. (A further
description of the GDS format may be found in Section 3 of the SNAX/APC
Application Programming Manual.)
The syntax and parameters of most basic and mapped verbs are the same, though
return codes may differ. Mapped verbs have the same names as the basic verbs, but
have the prefix MC-. In many places in our documentation, you will find entries
such as (MC)SEND-DATA, which indicates a reference to both the mapped verb
MC-SEND-DATA and the basic verb equivalent, SEND-DATA.
•
Independent verbs can be used with either basic or mapped conversations.
SNAX/APC supports two independent verbs, GET-TYPE and GET-TP-
PROPERTIES. GET-TYPE is used to inquire if the current conversation is basic or
mapped. GET-TP-PROPERTIES is used to get information pertaining to the TP
issuing the verb.
•
A further type, Tandem verbs, is not part of the LU 6.2 protocol as defined by IBM,
but have been implemented in SNAX/APC. These verbs are TP-READY and TP-
END.
Control Operator Verbs
There are three categories of control operator verbs:
•
CNOS verbs are used to control the number of sessions between LUs. See Part II,
SCF Reference for SNAX/APC
for further details.
•
LU definition verbs, which define and modify the local LU’s operating parameters,
are implemented by the SCF subsystem in SNAX/APC. Section 2, Planning for
SNAX/APC, of this manual introduces the concepts the LU’s parameters and
Section 3, Using SNAX/APC
and Part II, SCF Reference for SNAX/APC cover the
operational use of the SCF command equivalents.
•
Session control verbs are implemented as SCF commands. A comparison of session
control verbs and equivalent SCF commands may be found in Appendix D,
Comparison of LU 6.2 Control Operator Verbs and SNAX/APC
. Two verbs,
ACTIVATE-SESSION and DEACTIVATE-SESSION, can be directly issued by the
TP itself. These two session control verbs are documented in Section 2 of the
SNAX/APC Application Programming Manual.