clscrs_register_server

The clscrs_register_server API modifies the server attributes. The attributes for the server are contained in the input server list. The op_status list contains the results of the modify operation for each server but 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 and it must be created and destroyed for each API call.

Note:

Since Oracle currently supports, only, the CLSCRS_FLAG_REG_UPDATE flag will always need to be passed. The flags apply to all servers in the input entity list.

Parameters

Input:

  • in_entitylist: The list of server categories you want to register.
  • flags: CLSCRS_FLAG_QUEUE
  • CLSCRS_FLAG_FORCE
  • CLSCRS_FLAG_REG_UPDATE
  • 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.

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_server(clscrs_crsentitylist *in_entitylist, uword flags,
                       clscrs_msgf2 msgf, void *msgarg,
                       clscrs_crsentitylist *op_status);