You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > RegisterAsRedundantApp
Type
SwitchKit API message
Description
The SK_RegisterAsRedundantApp message is used by the function sk_registerAsRedundant().
If an application needs to register for membership into a Redundant Application Pool (RAP), the application must call the function sk_registerAsRedundant(). The function then uses the SK_RegisterAsRedundantApp message to register the application for membership into a RAP.
To remove an application from a pool, the application calls the function sk_deregisterAsRedundant(), which then also uses the message to take a member out of the pool.
A SK_RegisterAsRedundantAppAck message is an acknowledgment by the LLC, indicating the completion of the original request.
Sent by
Function sk_registerAsRedundant()
Arguments
You can modify the following arguments:
Argument |
Description |
---|---|
AppName |
AppName is the application name of the requesting application. The name can be obtained by calling sk_getConnectionName(). |
RedundantAppPoolID |
The RedundantAppPoolID is a string that uniquely identifies the class of application wishing to be treated as redundant applications. Notes: RAP IDs are case sensitive. |
RedundantAppPriority |
RedundantAppPriority is a value indicating the current priority of the application. The higher the value, the more likely it is that the LLC will select the application as primary. Predefined values are: SK_RED_APP_PRI_MONITOR (0) SK_RED_APP_PRI_REMOVED (-1) |
DataSize |
Size of the data |
Data |
Data bytes |
C Structure
typedef struct {
int AppName;
char RedundantAppPoolID[32];
int RedundantAppPriority;
unsigned short DataSize;
UBYTE Data[211];
} SK_RegisterAsRedundantApp;
C Structure Response
typedef struct {
int Status;
int AppName;
char RedundantAppPoolID[32];
int RedundantAppPriority;
} SK_RegisterAsRedundantAppAck;
C++ Class
class SKC_RegisterAsRedundantApp : public SKC_ToolkitMessage {
public:
int getAppName() const;
void setAppName(int x);
const char *getRedundantAppPoolID() const;
void setRedundantAppPoolID(const char *x);
int getRedundantAppPriority() const;
void setRedundantAppPriority(int x);
unsigned short getDataSize() const;
void setDataSize(unsigned short x);
const UBYTE *getData() const;
UBYTE *getData();
void setData(UBYTE *x);
};
C++ Class Response
class SKC_RegisterAsRedundantAppAck : public SKC_ToolkitAck {
public:
int getStatus() const;
void setStatus(int x);
int getAppName() const;
void setAppName(int x);
const char *getRedundantAppPoolID() const;
void setRedundantAppPoolID(const char *x);
int getRedundantAppPriority() const;
void setRedundantAppPriority(int x);
};