SNAX/APC Application Programming Manual

Application Prototype Simulator
SNAX/APC Application Programming Manual—138786
4-8
Control Verbs
Control Verbs
Control (or Control-operator) verbs are intended for use by control-operator TPs, which
are programs that assist the control operator to control an LU.
ACTIVATE-SESSION (SF1)
The ACTIVATE-SESSION verb activates a session explicitly. This verb does not start a
conversation: it initiates an LU-LU session by sending or requesting a Bind Even for
parallel-session LUs, each occurrence of the ACTIVATE-SESSION verb activates only
one session. For multiple sessions, the verb has to be used multiple times.
To use the ACTIVATE-SESSION verb, the TP that APS represents must have session
control authorization. Session control authorization is determined by the value assigned
to the SESSIONCONTROL attribute of the TP. Only a TP with a value of YES for this
attribute can activate a session. The SCF name for the TP is TPN, and the attribute is set
when the TPN object is added or subsequently altered.
Request Fields
APC Server Name
specifies the SNAX/APC server. You must specify the SNAX/APC server that you
specified in the last TP-READY verb.
Partner LU Name
specifies the name of the partner LU with which you want to establish an LU-LU
session. The partner LU name must be configured as a partner of the local LU
specified in the last TP-READY verb.
SNAX/APC Application Prototype Simulator (APS) System (T9096D30 15FEB95 21c)
Request: Activate_Session Resource ID: 1 0 0 1 0 0
APC Server Name: SNAXAPCS01
Partner LU Name: LUR_____
Mode Name: ________
Reply: Activate_Session
IPC Return Code: 0 IPC Ok
IPC Return Code Detail: 0 IPC Ok
UOWs In: 0001 UOWs Out: 0001
Header Return Code: 0 RC Ok
Request Completed
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16
TPR Aloc Deal TPE R&W RTS SD SE Cnf Cnfd GA Send Prnt Hex Rcov Exit
ActS Dact MPrc MRcI MFls Gtyp GTP A(T) E(T) Exit