SCF Reference Manual for the Kernel Subsystem

The ALTER PROCESS command is described in the next subsection. The ALTER SUBSYS command
is described on page 92.
ALTER PROCESS Command
Use the ALTER PROCESS command to change one or more attributes of a process controlled by
the Kernel subsystem manager process.
ALTER [ / OUT file-spec / ]
PROCESS $ZZKRNgpname [ , attribute-spec ]...
PROCESS $ZZKRN.gpname
is the name of a process controlled by the Kernel subsystem manager process. You can omit
PROCESS, $ZZKRN, and #gpname if you have specified them with an ASSUME command.
attribute-spec
identifies the attribute names and values for the object specified in the command. The attributes
are:
ASSOCPROC name
AUTORESTART n
BACKUPCPU n
CPU { ALL | FIRST | FIRSTOF (n,n1,...) | n | (n,n1,...) }
DEFAULTVOL $vol[.subvol ]
EXTSWAP { $vol | [[$vol.]subvol.]filename }
HIGHPIN { ON | OFF }
HOMETERM $device[.#subdevice]
INFILE { $device | [[$vol.]subvol.]filename }
LIBRARY [[$vol.]subvol.]filename
MEMPAGES n
NAME $name
OUTFILE { $device | [[$vol.]subvol.]filename }
PFSSIZE n
PRIMARYCPU n
PRIORITY n
PROGRAM [[$vol.]subvol.]filename
SAVEABEND { ON | OFF }
STARTMODE { KERNEL | SYSTEM | APPLICATION | MANUAL | DISABLED }
STARTUPMSG "text"
STOPMODE { SPI | STANDARD | SYSMSG }
TYPE { FOXMON | SUBSYSTEM-MANAGER | OTHER }
USERID { groupname.username | groupnum,usernum }
ASSOCPROC name
specifies the name of an OSS application to be run as part of a named generic process, whose
persistence is monitored by the Kernel subsystem’s persistence-manager process ($ZPM). The
OSH that launches the process must also be made persistent. Thus, when you specify the
ASSOCPROC attribute, you must also:
• Specify the name of an OSH process in the NAME attribute
• Specify the OSH object file in the PROGRAM attribute.
• Use the STARTUPMSG attribute to specify the startup message that is sent to the OSS
application.
Thus, the PROCESS object consists of two distinct persistent processes: the OSH process and
the OSS application process. An ABORT, DELETE, or START command issued to this object
affects both processes.
AUTORESTART n
specifies the number of times that the $ZPM persistence manager attempts to restart this process
within a 10-minute interval after an abnormal termination. The process abends or stops by a
means other than the ABORT command.
86 SCF Commands for the Kernel Subsystem