SwitchMgrQuery

Type

SwitchKit API message

Description

Use the SK_SwitchMgrQuery to allow an application to find out the current configuration state of the SwitchManager. If the SwitchManager is in the process of configuring when an application connects to LLC, SK_SwitchMgrQuery will notify the application of this state.

If you have the application/LLC set to channel recovery method 2 or 3, where channels are taken out of service, it is the application’s responsibility to take the channels back into service when the first application watching a specific channel group connects to LLC using ForceGroupState. Without SK_SwitchMgrQuery, when SwitchManager is being started while the application is also starting up, there may be a condition where the application will take channels inservice prior to the configuration being complete. This can cause critical configuration messages from SwitchManager to fail since the channel is already in-service.

Sent by

Application or Converged Services Administrator (CSA).

Arguments

The following table shows the arguments that you can modify:

Argument

Description

QueryType

This field can be set to:

• 0 = SK_SMQ_CONFIG_STATUS

• 0 = SK_SMQ_IDLE

• 1 = SK_SMQ_CONFIGURING

C Structure

typedef struct {

UBYTE QueryType;

UBYTE reserved18[252];

} SK_SwitchMgrQuery;

C Structure Response

typedef struct {

unsigned short DataSize;

int Status;

UBYTE TLVCount;

UBYTE Data[246];

} SK_SwitchMgrQueryAck;

C++ Class

class SKC_SwitchMgrQuery : public SKC_ToolkitMessage {

public:

UBYTE getQueryType() const;

void setQueryType(UBYTE x);

};

C++ Class Response

class SKC_SwitchMgrQueryAck : public SKC_ToolkitAck {

public:

unsigned short getDataSize() const;

void setDataSize(unsigned short x);

int getStatus() const

void setStatus(int x);

UBYTE getTLVCount() const;

void setTLVCount(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};