DynamicConfig

Type

EXS SwitchKit API message

Purpose

Use the SK_DynamicConfig message to dynamically update the Excel platform configuration without restarting the SwitchManager. This message includes an argument, ConfigMode, which determines whether the specified file content will be saved by SwitchManager for future reconfiguration.

Description

When SwitchManager receives a DynamicConfig message, it will send the configuration referenced in the message to the Excel platform immediately. Those messages are maintained on the Excel platform. The filename must be relative to the SwitchManager process.

Sent by

Converged Services Administrator or Application

Arguments

The following table shows the user modifiable arguments for this message:

Argument

Description

ConfigMode

 

This enables or disables writing the content of the specified file into the current configuration file used by Switch Manager. The options are:

SK_CONFIGSWITCH_APPEND - 0x00

SK_CONFIGSWITCH_SEND_NOAPPEND - 0x04

Filename

The filename of the file containing the configuration information to parse and send. Location should be relative to SwitchManagers installation directory.

C Structure

typedef struct {

UBYTE ConfigMode;

char Filename[230];

} SK_DynamicConfig;

C Structure Response

typedef struct {

int Status;

} SK_DynamicConfigAck;

C++ Class

class SKC_DynamicConfig : public SKC_ToolkitMessage {

public:

UBYTE getConfigMode() const;

void setConfigMode(UBYTE x);

const char *getFilename() const;

void setFilename(const char *x);

};

C++ Class Response

class SKC_DynamicConfigAck : public SKC_ToolkitAck {

public:

int getStatus() const;

void setStatus(int x);

const UBYTE *getReserved() const;

UBYTE *getReserved();

void setReserved(UBYTE *x);
};