Open System Services Installation Guide (H06.16+, J06.05+)

5 STOPOSS Utility
The STOPOSS utility stops the OSS filesets (but not the OSS processes).
Usage Considerations:
HP recommends that you log on with a user ID in the SUPER group ID to run STOPOSS.
The STOPOSS utility, the files it accesses, and the processes it stops must be appropriately
secured for access by users other than the super ID, according to your site’s security guidelines.
See “Licensing the OSS Monitor to the Super Group in the Open System Services Management
and Operations Guide for a possible approach.
STOPOSS is on the installation subvolume ZOSSINS. You must run STOPOSS from ZOSSINS.
If $ZSMP and/or $NULL are specified in the EASYSETUP^STARTUP PARAM and are not
running, or if $ZPMON is not running when STOPOSS is run, STOPOSS starts the missing
process so that it can complete its function, then stops the process again before completing.
If you used OSSSETUP to configure $ZSMP or you manually configured $ZSMP as a generic
process using the recommended values defined in “Starting the OSS Monitor as a Persistent
Process” in the Open System Services Management and Operations Guide, $ZSMP will not
restart itself because its AUTORESTART value is 0. If $ZSMP does not have an AUTORESTART
value of 0, you must use the SCF ABORT command and then the SAFECOM STOP command
to permanently stop $ZSMP.
The OSS Monitor does not use the $NULL process or require the $ZSMP process for its own
startup. However, stopping $NULL or $ZSMP could affect the functioning of other products
or subsystems.
You can embed the STOPOSS command in a system shutdown file as follows:
== Stop the OSS subsystem, filesets, and servers:
#Push #Defaults
Volume $SYSTEM.ZOSSINS
Run STOPOSS
#Pop #Defaults
The keyword Run is optional, but it is required if #PMSEARCHLIST does not include #DEFAULTS.
Running STOPOSS
To use STOPOSS:
1. If you have installed the SPI definition files on a volume other than $SYSTEM, enter this
command at the TACL prompt:
PARAM EASYSETUP^EMSVOL $vol-name
where vol-name is the name of the volume on which Event Management Service (EMS)
subvolume (ZSPIDEF) resides. This subvolume must contain the event definition files ZOSSTACL
and ZEMSTACL. The default value for this param is $SYSTEM. You are not required to have
installed SPI definition files, but if the SPI definition files are not installed in the specified
location, this utility will not generate EMS events. For more information about this param and
about enabling EMS event logging, see Table 3 (page 15).
2. If you want STOPOSS to stop the $NULL, $ZSMP, or both $NULL and $ZSMP processes, enter
one of these commands at the TACL prompt:
PARAM EASYSETUP^STARTUP $NULL
PARAM EASYSETUP^STARTUP $ZSMP
PARAM EASYSETUP^STARTUP $ZSMP $NULL
For more information about this param, see Table 3 (page 15).
Running STOPOSS 41