clscrs_request_action

The clscrs_request_action API instructs Oracle Clusterware to run an action on a named set of resources. In the first argument, you can specify either a list of resource IDs or a filter. Specifying a filter enables the query and action to take place in a single call. The filter searches all registered resources.

Parameters

Input:

  • action_name: The name of the action to be performed.
  • ridlist: The list of resources or resource instance IDs to stop, or a filter.
  • env: Specify environment arguments to the stop operation.
  • msgf: User message callback, which can be NULL.
  • msgarg: User callback argument, which can be NULL.
  • flag: Either async or queue options.

Output:

op_status: The resource list that holds the status of the action operation for each resource.

Returns

  • CLSCRS_STAT_INVALID_RESNAME: Displays if ridlist is empty.
  • CLSCRS_STAT_AUTHORIZATION_FAILURE: Displays when authorization fails.
  • CLSCRS_STAT_SUCCESS: Displays if the request completes successfully for all requested entities or if no entities match a filter.
  • CLSCRS_STAT_FAILURE: Displays if at least one resource or resource ID does not stop successfully.
  • CLSCRS_STAT_CONNECTION: Displays if there is a communication error.

CLSCRS_STAT

clscrs_request_action(oratext *action_name, clscrs_splist *ridlist,
                      clscrs_env env, clscrs_msgf2 msgf,
                      void *msgarg, uword flag, clscrs_reslist *op_status);