OSI/MHS Configuration and Management Manual

Management Environment for OSI/MHS
OSI/MHS Configuration and Management Manual—424827-003
2-29
APPL Objects
The following sequence of commands adds user application number 27 to MS group 6,
and first establishes, then alters, the application password. The user performs these
actions using the required attributes ACCESS-TYPE, ACCESS-NAME, and
USER-PASSWORD. ACCESS-NAME specifies the message store group that serves
this APPL. The remaining five attributes are not specifically required, but they are one
combination of APPL attributes that can define an O/R name, which is required. The
O/R name will be used, along with the password, to validate the later attempts of the
user to access the message store.
ASSUME APPL $ZMHS
ADD #MS6A027, ACCESS-TYPE MS, ACCESS-NAME MESSTOR6, &
USER-PASSWORD POTZrEBIE, ISO-COUNTRY-NAME UK, &
ADMD BT, SUR-NAME DAVIS, GIVEN-NAME SHARON, &
INITIALS A
START #MS6A027
In the previous example, the user password is misspelled. In the following example,
the error is corrected and checked. (Remember that once you have established a
password, you have no way to look at it.)
STOP #MS6A027
ALTER #MS6A027, USER-PASSWORD POTrZEBIE
START #MS6A027
STATUS #MS6A027
Later, the UA represented by this user application is no longer required, so the APPL
object must be suspended and, when there is no longer activity on the APPL object,
deleted. (Use the STATUS APPL command or the STATS APPL command to see that
no activity is on the APPL object.)
SUSPEND APPL $ZMHS.#MS6A027
DELETE APPL $ZMHS.#MS6A027
Notice that the ASSUME command in the previous example is no longer in effect,
because the APPL object was created in an earlier SCF session.
Examples of Commands for Gateway APPL Objects
The following are examples of commands for gateway APPL objects.
You can define one of two types of APPL objects that the gateway can use: generic or
specific.
An example of a generic APPL object is a set of gateway correspondents; the set does
not specify any personal name or common name attributes. It might, for example,
specify an organization name, representing the members of an organization.