clscrs_register_servercategory

The clscrs_register_servercategory API registers the server categories that you specify in the input server category list. The attributes for the server category are contained in the input server category list. The op_status list contains the results of the register operation for each server category and contains no valid attributes. The caller must create and populate the in_entitylist and must create the op_status list. Both of these lists must be destroyed by the caller. The op_status list cannot be reused with another API call. It must be created and destroyed for each API call.

One or more attributes of an already registered server category can be modified by passing the CLSCRS_FLAG_REG_UPDATE flag. The flags apply to all server categories in the input entity list.

Parameters

Input:

  • in_entitylist: The list of server categories you want to register.
  • flags: CLSCRS_FLAG_REG_UPDATE
  • CLSCRS_FLAG_QUEUE
  • CLSCRS_FLAG_FORCE
  • CLSCRS_FLAG_NONE

See Also:

CLRSCRS_FLAG enum for more details

  • msgf: User message callback, which can be NULL.
  • msgarg: User callback argument, which can be NULL.

Output:

op_status: The entity list that holds the status of the register operation for each server category.

Returns

  • CLSCRS_STAT_SUCCESS: Indicates that all input server categories are successfully registered.
  • CLSCRS_STAT_FAILURE: Displays if at least one server category cannot be registered.
  • CLSCRS_STAT_CONNECTION: Displays if there is a communication error.
  • CLSCRS_STAT_WRONG_ACTIVE_VERSION: Displays if you use the API before you have upgraded the cluster to Oracle Clusterware 12c.
  • CLSCRS_STAT_INVALID_ARGS: Displays if any of the server categories in the input entity list do not have attributes.

CLSCRS_STAT

clscrs_register_servercategory(clscrs_crsentitylist *in_entitylist, uword flags,
                               clscrs_msgf2 msgf, void *msgarg,
                               clscrs_crsentitylist *op_status);