OSI/FTAM Configuration and Management Manual

FTAM Management Environment
OSI/FTAM Configuration and Management Manual—421944-001
2-20
SU (Subdevice) Objects
PROCESS Object Names
The form of the object name for the PROCESS object determines if a command destined
for an initiator or a responder process will be sent to that process directly or if it will be
sent through the APLMGR process. Tandem FTAM supports two object-name formats
for PROCESS objects.
The first format names processes directly using the external Guardian process name, as
in the following examples:
ACTIVATE PROCESS \MARS.$AMGR
INFO PROCESS $FTR1, DETAIL
NAMES PROCESS $FTI2
When you use this format, the command goes directly to the specified APLMGR,
initiator, or responder process.
The second object-name format routes a command to an initiator or a responder process
indirectly, through the APLMGR process. In this format, the process name consists of
four parts: an optional system name, the external Guardian name of the APLMGR
process, a keyword identifying the type of process (#FTAMI for an initiator or #FTAMR
for a responder), and the internal name of the process.
The following examples illustrate the use of this object-name format:
ACTIVATE PROCESS \MARS.$AMGR.#FTAMR.FTR1
ABORT PROCESS $AMGR.#FTAMR.FTR1
STATUS PROCESS $AMGR.#FTAMI.FTI2
If you issue a command to retrieve information (such as INFO or STATUS), you should
receive the same information regardless of which object-name format you use.
SU (Subdevice) Objects
An SU object defines a data communications subdevice associated with an FTAM
initiator or responder process. This object type allows you to manage and monitor
subdevice activity.
An initiator process creates an initiator subdevice when an application first calls the
FTM_INITIALIZE_REQ_ procedure to establish an association. The initiator discards
the subdevice when it is no longer in use, and it does not create a new subdevice until a
user requests another association.
When you start a responder process, that process initially creates a number of responder
subdevices equal to the number specified in the MAXATTACH attribute for the
PROCESS object. When a responder subdevice is no longer in use, the responder’s
default action is to discard the subdevice, then automatically create (regenerate) a new
one to replace it. The ALLOWSU attribute for responder PROCESS objects allows you
to stop the automatic regeneration of subdevices.