For z/OS platforms

Activating the automatic restart management (ARM) feature on the angel

You use this procedure to activate the IBM® z/OS® automatic restart management (ARM) feature on the angel.

Before you begin

To use automatic restart management (ARM) with angel, you must activate the ARM component itself, which means you must:
  1. Allocate an ARM couple data set.
  2. Start the automatic restart management policy.
  3. Install the latest version of the angel process, regardless of which product it is bundled with.
If ARM is not active, angel issues an error message to the hardcopy log.

About this task

You are not required to change the ARM policy. However, you need to modify this policy if you want to create custom restart groups.

This procedure includes steps that can enable the z/OS automatic restart manager on the angel.

Procedure

The angel can use ARM services to restart automatically during unexpected failures. Use these steps to use the angel with ARM.

  1. if the ARM is not started, issue these operator commands to start the ARM policy.
    SETXCF COUPLE,TYPE=ARM,PCOUPLE=(dsname,vvvvvv) SETXCF 
    START,POLICY,TYPE=ARM
    where
    dsname
    The data set name for the couple data set
    vvvvvv
    The volume serial of the volume on which the couple data set resides
  2. Update the angel proc.
  3. Issue the angel START command with the ARMEL option specified with the elementName.
    START BBGZANGL, ARMEL=<elementName>
    You can specify an element name by coding the ARMEL parameter on the operator START command to successfully register with ARM services. The ARMEL is 1 - 16 characters inclusive, and must use the following characters only: A-Z 0-9 # $ @ _
    Note: The element name must be unique on the LPAR. Two angels cannot be registered with an element name that is already in use with the ARM services.
  4. Optional: You can check the status by displaying all registered address spaces (including the address spaces of server instances). Issue the command
    d xcf,armstatus,detail

Results

The z/OS automatic restart manager feature is now active. Any further failures automatically restart the angel. The angel is unregistered from ARM after a clean shutdown.