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

Define the Forced Inactivation Details

Some resource classes let you specify the following forced inactivation details:

• How to force the inactivation of the resource
• What to do if the forced inactivation is successful
• What to do if the forced inactivation is not successful

To define the forced inactivation details for the resource

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

   The Force Inactivation Details panel appears.

   The TF (terminate by force) command uses the information on this panel. The T (terminate) command might also use this information if a time-out action of Try Force Inactivation is specified on the Inactivation Details panel.

   Note: For information about how to use the TF and T commands, see the User Guide.

2. Specify the information required to force the resource to stop. For an example, see a template distributed with the product.
   • If the forced 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 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 one of the return codes in the following table, 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 indicate 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 forced 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 to force the stopping of the resource, the region cannot force the resource to stop when required. Instead of trying to force the resource to stop, the region places the resource in the MANUAL operation mode. The exception is when the resource has a type of LOGICAL.