SNAX/APC Application Programming Manual

Verb Definitions

SNAX/APC Application Programming Manual—138786

3-3

ACTIVATE-SESSION Verb

AS-MODENAME

This field specifies the PTNR-MODE under which the session will be established.

If the field contains blanks (spaces), the default MODE-NAME is implied.

The MODE-NAME must have been configured under the partner LU name specified

in the first field of this verb.

Return Codes

The possible return codes for ACTIVATE-SESSION are:

RC-ACTIVATION-FAILURE-NO-RETRY

RC-ACTIVATION-FAILURE-RETRY

RC-LU-MODE-SESSION-LIM-EXCEEDED

RC-PARAMETER-ERROR (with one of the following detail codes):

RCD-INVALID-MODENAME

RCD-INVALID-PARTNER-NAME

These return codes are described in detail in the previous section.

Considerations

•

ACTIVATE-SESSION can be used only to activate sessions with the local LU

named in the TP-READY request. An operator TP can use ACTIVATE-SESSION

to bring up all sessions before starting the TPs that engage in conversations. For

parallel-session LUs, the ACTIVATE-SESSION verb will also be served as with

single session LUs. In other words, only one session will be activated even if both

local and remote LUs are parallel-session LUs, and the number of active sessions

has not exceeded the session limit of the specified (LU,MODE) entry. In order to

activate more than one session, multiple ACTIVATE-SESSION verbs must be

issued.

The operator TP must issue the following sequence of verbs for each local LU:

TP-READY (local)

ACTIVATE-SESSION (partner, mode)

(and so on)

TP-END

•

If an ACTIVATE-SESSION verb is processing when SNAX/APC receives a

CANCEL system message from the application program, SNAX/APC replies to the

cancelled IPC immediately. The ACTIVATE-SESSION verb is allowed to finish

normally. After SNAX/APC finishes processing the verb, SNAX/APC deallocates

the conversation and frees the internal resources.

Note. There is a difference between this action and the action necessary for

DEACTIVATE-SESSION.