OSI/MHS Management Programming Manual
Commands and Responses
OSI/MHS Management Programming Manual—424824-001
5-79
ADD GROUP
address is unused. The SPI-NULL value for this structure is 255.
ZTSELECTOR contains the following fields:
ZLENGTH
is the length of the string field in bytes. This value must be an even number
in the range 0 through 64.
ZSTRING
is the OSI address TSEL. This value must be a hexadecimal string of the
length specified in ZLENGTH.
ZNSAP
is a structure that defines the network service access point (NSAP) part of the
OSI address used by this group for receiving associations from adjacent MTAs.
This structure identifies a network layer entity. The SPI-NULL value for this
structure is 255. ZNSAP contains the following fields:
ZLENGTH
is the length of the string field in bytes. This value must be an even number
in the range 2 through 40 bytes.
ZSTRING
is the OSI address NSAP. This value must be a hexadecimal string of the
length specified in ZLENGTH.
ZTRANSMIT-MODE
is the mode of operation of an MR process within this group. The SPI-NULL
value for this token is 255. The possible values are:
ZMHS-VAL-TM-NORMAL
ZMHS-VAL-TM-DRAIN
ZMHS-VAL-TM-DRAIN means that an MR group continues to transmit to local
or remote recipients messages it is currently processing, but that it does not
accept any incoming messages from any source. That is, the MR group refuses
incoming associations or message transfers from remote MTAs and all local
message submissions from MS APPL objects and GATEWAY objects.
Eventually, an MR group operating in DRAIN mode is emptied of all it
messages; it reaches an idle state.
ZMHS-VAL-TM-NORMAL means that an MR group is capable of both sending
and receiving messages. This is the usual mode of operation for an MR group
Typically, ZMHS-VAL-TM-DRAIN mode is used to empty the messages from
an MR group prior to deletion of that MR group. In this context, an MR group
operating in ZMHS-VAL-TM-NORMAL mode is stopped, altered such that it is
in ZMHS-VAL-TM-DRAIN mode, and then restarted. When the MR group is
empty of messages, it can be stopped and deleted.