SNAX/APC Application Programming Manual

Using the Application Program Interface
SNAX/APC Application Programming Manual—138786
1-5
Version Levels of the IPC Header
DEACTIVATE-SESSION
If the IPC version code is S1, the LU has to be a single-session LU. If the LU is a
parallel-session LU, the IPC is rejected.
If the IPC version code is S2 or S3, the form of the verb specifies the session ID.
The LU may use single or parallel sessions.
DISPLAY-STATUS
If this verb is issued where a parallel-session LU is in use, or used with an IPC
version code S2 or S3, the IPC will be rejected.
GET-ATTRIBUTES and MC-GET-ATTRIBUTES
If the verb is issued with an IPC version code of S1, a maximum of 8 bytes is
allowed for the uninterpreted form of the partner LU name. If this attribute is
configured fully qualified, only the network LU name will be returned (the network
ID will not be returned). Also, the ID of the session being used by the conversation
will not be returned.
If the verb is issued with an IPC version code of S2 or S3, a maximum of 17 bytes is
allowed for the uninterpreted form of the partner LU name. If this attribute is
configured as fully qualified, both the network LU name and the network ID will be
returned. Also, the session ID of the session being used by the conversation will be
returned.
TP-READY
If the verb is issued with an IPC version code of S5, sync point operation is
supported. If IPC version code S5 is used in the TP-READY, S5 should be used for
the entire conversation.
Control Operator TP Functions
SNAX/APC provides two control operator verbs: ACTIVATE-SESSION and
DEACTIVATE-SESSION.
The ACTIVATE- SESSION verb activates one session each time it is issued, up to the
maximum number configured for the partner (LU, mode) pair.
The DEACTIVATE-SESSION verb deactivates one session each time it is issued.
It has a different form depending on whether the IPC VERSION-CODE is S1 or S2.
If the local LU is a parallel-session LU, the verb cannot be issued with an IPC version
code of S1.
Note. To deactivate a session using this verb, your application will need to know the
session ID. This may be obtained using the GET-ATTRIBUTES or MC-GET-
ATTRIBUTES verb (with an IPC version code of S2 or S3). This verb can only be
issued in a conversation, so if you want to deactivate a session, you must first find
the session ID while a conversation is still active on that session.