Previous Topic: Lowering Password Violation CountsNext Topic: Tracing SAF Events

Using the ACFSERVE Commands › ACFSERVE Command Syntax › Restarting the CA ACF2 for VM Service Machine

Restarting the CA ACF2 for VM Service Machine

The ACFSERVE RESTART command gradually quiesces the CA ACF2 for VM service machine and restarts it. We recommend this method of quiescing CA ACF2 for VM. We do not recommend using the CP FORCE command or the CMS HX command. You must have the unscoped SECURITY privilege in your logonid record to issue this command. The system operator can also issue this command. The syntax for this command is:

ACFServe RESTART [dump]
dump

Represents an optional operand that causes the CA ACF2 for VM service machine to perform a dump before restarting.

The CA ACF2 for VM service machine finishes any current requests, puts the requests made after you issued the ACFSERVE RESTART command into a wait mode, closes all database files, then logs off. Then, the CA ACF2 for VM service machine is autologged and restarted. You should only use the ACFSERVE RESTART command in emergency situations. For example:

Changes to rules on one system in a shared database environment do not affect a rule cached on another system. When you restart the CA ACF2 for VM service machine, all caches are cleared and reset. The ACFSERVE RESTART command does not refresh the cache. The refresh is a byproduct of IPLing CMS. The restart function can adversely affect system performance.

You must format and reserve any new disks added to the DISKLST operand of the @SMF macro. See the Installation Guide for detailed information.

The ACFSERVE RESTART command does an internal reload of the ACFFDR. All values in the ACFFDR are refreshed except those the @ADDRSIZ and @SYSID macros define.

The CA ACF2 for VM service machine detects unexpected error conditions and performs error processing. This capability reduces the possibility that the
CA ACF2 for VM service machine hangs through a VM READ or disabled wait state until CP forces the CA ACF2 for VM service machine off or you issue a CP FORCE command. For example, the CMS HX command stops the service machine and normally causes a VM READ. The CA ACF2 for VM service machine intercepts detect this error condition, take a dump, and logoff.