OSI/AS Management Programming Manual

Sensitive and Nonsensitive Commands
Commands and Responses
5–6 056785 Tandem Computers Incorporated
Sensitive and
Nonsensitive
Commands
Commands are divided into two groups: sensitive commands and nonsensitive
commands. A command is classified as either sensitive or nonsensitive based on its
impact on the subsystem and on whether a user must have proper security to use it.
Sensitive commands are used to add or delete objects, start or stop objects, alter object
attributes, reset statistics counters, or perform some other function that can have a
significant impact on the status or operation of an object. The only users allowed to
issue sensitive commands are members of the Guardian 90 super group or of the
Guardian 90 user group that owns the OSI manager process.
The sensitive OSI/AS commands and their functions are as follows:
ABORT Abruptly places an object in the STOPPED state.
ACTIVATE Returns a suspended (ZCOM-VAL-SUMSTATE-SUSP) object to the
STARTED state.
ADD Defines an object to the OSI/AS subsystem.
ALLOWOPENS Allows new connections to objects controlled by a specified process
after new connections have been disallowed with FORBIDOPENS.
ALTER Alters the values of one or more of an object’s attributes.
DELETE Removes an object from the OSI/AS subsystem.
FORBIDOPENS Disallows new connections to objects controlled by a specified
process.
RESETSTATS Gets the contents of an object’s statistics counters and resets the
counters.
START Places an object in the STARTED state.
STOP Places an object in the STOPPED state.
SUSPEND Places an object in the suspended state (ZCOM-VAL-SUMSTATE-
SUSP).
TRACE Starts or stops generating trace records for an object.
Nonsensitive commands do not affect the operation or status of an object; therefore
these commands can be issued by any user. The nonsensitive OSI/AS commands and
their functions are as follows:
GETVERSION Returns an object’s software-release version information.
INFO Returns an object’s current attribute values.
LISTOBJECTS Returns the names and types of various objects.
LISTOPENS Returns information about the opens of a specified process or
subdevice.
STATISTICS Returns the contents of an object’s statistics counters.
STATUS Returns current status information about an object.