Working With System Image Definitions › Define a Resource to a System Image › Define the Inactivation Details

Define the Inactivation Details

Some resource classes let you specify the following inactivation details:

• How to inactivate the resource normally
• What to do if the inactivation is successful
• What to do if the inactivation is not successful

To define the inactivation details for the resource

1. Press F8 (Forward) from the Activation Details panel.

   The Inactivation Details panel appears.

   The T (terminate) command uses the information on this panel.

   Note: For information about how to use the T command, see the User Guide.

2. Specify the information required for stopping the resource. For an example, see a template distributed with the product.
   • If the stopping method is simple, specify a system command, time-out and status change information, and the expected completion message.

     You can extend the message definition.

   • If the stopping method is complex, use a process.

     Note: You can use the $NCL process to execute an NCL procedure.

     If you use a process, your process must set the return code to one of the following values, to notify the region to set the correct actual state of the resource:

     • 0 notifies the region to set the actual state to INACTIVE, indicating that the process is successful.
     • 12 notifies the region to do nothing. For example, the process might have set the state already by using the SETSTATE macro.

       Use this method only if the set state is acceptable to the INACTIVE desired state. The acceptable states are INACTIVE and STOPPING. If the result of the process is unacceptable, set the return code to, for example, 8 to indicate that the process failed to achieve the desired state.

     • 99 notifies the region to proceed the same way as if a system command has been issued (that is, wait for the expected completion message and possibly perform time-out processing).
     • Other return codes indicates that the process is unsuccessful.

       If time-out processing is specified, the region performs the processing immediately. The region does not wait for the period specified in the Timeout After field.

       If time-out processing is not specified, the region does not change the actual state. The region can proceed no further with the automated stopping of the resource. The automation status is set to FAILED, and the logical state is forced to INERROR.

   Note: If you provide no command or process for stopping the resource, the region cannot stop the resource when required. Instead of trying to stop the resource, the region places the resource in the MANUAL operation mode. The exception is when the resource has a type of LOGICAL.