Open System Services Management and Operations Guide (G06.29+, H06.07+)

Open System Services Monitor
Open System Services Management and Operations Guide527191-005
12-29
ALTER SERVER Command
OUT filename
specifies the name of a Guardian output file for informational messages. You can
either read this file with a text editor or display it with the FUP COPY command.
SERVER server_processname
specifies the server being altered. server_processname has the following form:
[$ZPMON.]servername
servername
specifies the name of the server to be altered. Only names currently defined in
the ZOSSSERV file are valid values. The first character of the name must be a
pound sign (#).
The $ZPMON prefix can be omitted if you have previously specified $ZPMON
in an SCF ASSUME command.
You can specify the following options in any order. You must specify at least one
option:
AUTORESTART ntimes
specifies the persistence count of the server, where ntimes is an integer value in
the range 0 through 10. The persistence count is the number of times the OSS
Monitor will automatically restart the server during a 10-minute period.
The persistence count helps to prevent excessive attempts at restarting or an
endless loop during restart. The OSS Monitor counts the number of restart
attempts for each server during the previous 10 minutes; this number is the current
persistence count.
Once the current persistence count for a server reaches the number specified for it
by AUTORESTART, the OSS Monitor no longer attempts to restart the server and
generates an EMS event so that the operator can attempt to identify and correct a
possible problem. After the problem is corrected, the operator must take an action
that causes the current persistence count to be reset to 0; otherwise, the server
and any associated filesets will not be automatically restarted.
A server’s current persistence count is reset to 0 at the following times:
When the OSS Monitor starts or restarts
When an SCF STOP SERVER, START SERVER, or ALTER SERVER
command for the affected server is completed
When a START FILESET command for a fileset managed by the affected OSS
name server is completed
After the server has run for 10 minutes without being restarted