SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-2
Control Verbs
Control Verbs
Control, or Control-operator, verbs are intended for use by control-operator TPs, that is
programs that assist the control operator in performing functions related to the control of
an LU.
ACTIVATE-SESSION Verb
Use the ACTIVATE-SESSION verb to activate a session explicitly. This verb does not
start a conversation; it simply initiates an LU-LU session through sending or requesting
a BIND.
To use ACTIVATE-SESSION, a TP must have session-control authorization. Session-
control authorization is determined by the SESSION-CONTROL attribute of the TPN
object , configured using SCF. (TPN is the mnemonic for TP name.)
Request Details
REQ-UOW-CODE
This field must contain the value 2001, which identifies the ACTIVATE-SESSION
verb.
AS-PARTNER-LUNAME
This is the name of the remote LU that will participate in the LU-LU session.
The remote LU name must have been configured as a partner of the local LU.
The remote LU name must be in uppercase letters.
Request Format
?SECTION ACTIVATE-SESS-REQ,TANDEM
01 ACTIVATE-SESS-REQ.
02 AS-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 AS-PARAMETERS.
03 AS-PARTNER-LUNAME PIC X(8).
03 AS-MODENAME PIC X(8).
Reply Format
?SECTION ACTIVATE-SESS-REP,TANDEM
01 ACTIVATE-SESS-REP.
02 ASR-HEADER.
03 REP-UOW-ID PIC X(2).
03 REP-VERB-CODE PIC 9(4) COMP.
03 REP-RETURN-CODE PIC S9(4) COMP.
03 REP-RETURN-CODE-DETAIL PIC S9(4) COMP.