AOFRJ3RC Routine

This routine performs the recovery action against a monitored object in a JES3 environment.

When AOFRJ3RC is called, it checks whether the system that it is running that holds the JES3 global processor. If not AOFRJ3RC terminates without any further action.

The syntax of the AOFRJ3RC routine is as follows:

jes3apl

Specifies the name of an APL of category JES3.

msg-type

Specifies the message type within the given JES3 APL that the recovery commands are to be read from:

pass-interval: Specifies the time interval that AOFRJ3RC should wait before executing the next pass. The format is in NetView notation ( mm, hh:mm, hh:mm:ss or :ss).
RESET: If RESET is specified AOFRJ3RC stops the recovery.

AOFRJ3RC looks into the MESSAGE/USER DATA policy definition of the specified JES3 APL. It issues the command that is defined for PASS1 of the given message type. As long as there are commands in higher passes it sets up a NetView timer that re-calls AOFRJ3RC after the given pass interval. Whenever AOFRJ3RC is executed the command that is defined for the next pass is issued as long as one exists.

If RESET is specified instead of a pass interval any pending timer is killed and processing stops.

The return code is always zero.

Note: AOFRJ3RC issues the recovery commands in a fire-and-forget manner. It does not check whether the recovery action has the desired result. This is done by the monitor. After one or more monitor intervals the health status changes to a less severe one if the recovery shows an effect. If you want to stop recovery actions when the health status returns to NORMAL, for example, you have to code a HEALTHSTATE command that calls AOFRJ3RC with RESET.