SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-101
TP-READY Verb
TR-APC-LUNAME
is the name of the local LU. If the TP was dispatched, the LU name is contained in
the DISPATCH-TP request. If a TP is not dispatched, the TP programmer can write
the TP such that it reads an LU name as a process-startup PARAM message. The
LU name can be up to eight characters long; the LU name must be in uppercase
letters and must be in the configuration database. If this field contains an asterisk
(*), and the TR-LOCAL-ATTACH-INDICATOR field contains the value N,
SNAX/APC queues the TP-READY request to wait for an incoming attach request
on any local LU.
TR-LOCAL-TPNAME
is the name of the local TP. If the TP was dispatched, the TP name is contained in
the DISPATCH-TP request. TPs not dispatched can receive their own names as a
startup PARAM message. The TP name must be in uppercase letters and must be in
the configuration database. Although the TPN can be up to 16 characters long,
dispatched TPNs must be 15 characters or less (because of PATHMON restrictions
on server names).
See also the information, “Queuing TP-READY Requests,” in Section 1 of this
manual.
An ATTACH is created using the (MC)ALLOCATE verb.
TR-SYNC-SUPPORT-INDICATOR
“Y” indicates that this TP requires sync support; “N” indicates that it does not.
Reply Details
The TP-READY verb reply has four parameters in addition to the standard SNAX/APC
reply header. These are as follows:
RESERVED-2
This field is reserved, and is not used by SNAX/APC. It may be ignored by the TP.
LU-LENGTH
For sync support only, this component of the LUWID contains the length of the LU-
NAME field which follows.
LU-NAME
For sync support only, this component of the LUWID contains the name of the LU
that created the LUWID.
Note. This is the name that must be used in the ATTACH. If the TP name used in
the Attach is not exactly the same as the name specified in the TP-READY, the
request will be rejected.