OSI/MHS Configuration and Management Manual

Management Environment for OSI/MHS
OSI/MHS Configuration and Management Manual—424827-003
2-28
APPL Objects
Examples of Commands for MS APPL Objects
The following are examples of commands for MS APPL objects.
The following example shows nonsensitive commands you can use to obtain
information about OSI/MHS user applications:
INFO APPL $ZMHS.#APPL
∗
INFO APPL $ZMHS.#APPL009, DETAIL
NAMES APPL $ZMHS.
∗
NAMES APPL $ZMHS.#MS1A
∗
STATUS APPL $ZMHS.#MS6A184
STATUS APPL $ZMHS.#MS6A
∗
, SEL STARTED
STATUS Displays the operational status of an MS APPL object.
STOP Changes the state of an APPL object from STARTED or
SUSPENDED to STOPPED.
You must stop a user application before you delete it.
For message-store APPL objects:
To be sure of stopping a user application, you must include the
FORCED option in the STOP command. If the application’s UA is
already associated with the subsystem, specifying NORMAL or
omitting both options causes the STOP command to fail with an error
message. However, the results of STOP with the FORCED option are
that the subsystem aborts the association, and the UA receives an
error message the next time it tries to access the message store.
These results are the same as the results of an ABORT command.
SUSPEND Changes the state of an APPL object from STARTED to
SUSPENDED.
For message-store APPL objects:
To be sure of suspending a user application, you should include the
FORCED option in the SUSPEND command. If the application’s UA
is already logged on to the subsystem, specifying NORMAL or
omitting both options causes the SUSPEND command to fail with an
error message. The SUSPEND command with the FORCED option
suspends the application regardless of whether the UA is associated
with the subsystem.
You cannot alter the attributes of a user application while it is
suspended. Normally, you suspend it when its UA becomes obsolete.
This action gives the UA time to retrieve previously delivered
messages before you stop the application and delete it, denying the
UA access to the subsystem permanently
For gateway APPL objects:
This command has no effect on gateway APPL objects.