OSI/MHS Management Programming Manual

Commands and Responses
OSI/MHS Management Programming Manual—424824-001
5-292
SUSPEND APPL
NORMAL
The application name is suspended only if the application name is not currently
in use (logged on). This the default.
FORCED
The application is suspended whether or not an application name is in use
(logged on).
Tokens in Response Buffer
ZSPI-TKN-DATALIST
introduces a data list, as described in the SPI Programming Manual; the final
ZSPI-TKN-ENDLIST ends the data list. These tokens enclose the other response
tokens only if the value of the header token ZSPI-TKN-MAXRESP is not 0.
ZCOM-TKN-OBJTYPE
ZCOM-TKN-OBJNAME
are described in the SPI Common Extensions Manual.
ZSPI-TKN-RETCODE
ZSPI-TKN-ERRLIST
ZSPI-TKN-ENDLIST
ZSPI-TKN-CONTEXT
are described in the SPI Programming Manual.
Operational Notes
•
SUSPEND APPL is a sensitive command.
•
To reverse the effects of the SUSPEND command, use the ACTIVATE command.
•
The SUSPENDED state disallows MS applications from transmitting or receiving
messages using this application name. Pre-existing messages can be read or deleted,
however. Suspending an MS application and processing its existing messages is
preparatory to deleting it.
•
When the MS APPL is in the SUSPENDED state, incoming messages for the APPL
object will be rejected with an NDN (non-delivery notification).
•
The SUSPENDED state is not intended to be used for reconfiguration. ALTER
APPL is not supported for this state, since applications can continue to be logged on
and to access the database while in the SUSPENDED state. Any altered retrieval
parameters will not take effect since the message retrieval parameters are retrieved
only during logon.