You are here: CSP Developer’s Guide: Overview > 4 EXS API Application Development > Reconfiguration Considerations

Reconfiguration Considerations

You should design your host application to ensure correct reconfiguration after resets.

Power-up

When you return power to the CSP, it retains the system software load but resets the configuration to default values. The host must restore the customizations (such as custom protocols) but it must wait until the Poll message indicates that the CSP is ready to take configuration. Review all fields in the Card Status Report message to verify the contents of the CSP.

Voice Recorded Announcements are stored in non-volatile flash memory, and are preserved even during power failures.

Single Matrix Controller Reset

Use the Poll message to detect a single Matrix Controller reset. The Matrix Controller state changes from initialize, to standby, to active or switchover, to boot. If the Matrix Controller has a valid system software load, it retains the load. The Poll message also indicates the Matrix Controller state changing from boot, to initialize, to standby, and then to active.

The CSP sends Card St atus Report messages for all cards. The CSP retains the configuration that was last sent by the host (except when the CSP is being powered down or when a card is being removed).

When a single Matrix Controller is reset, all calls that were previously connected are torn down and the information on all of the in-service channels reports to the host with the DS0 Status Change message. The host determines the cause of the reset.

If a software fault caused the reset, please send the Fault Log to Dialogic Technical Support. To obtain Fault Logs, send the Fault Log Query message to the CSP.

Standby Matrix Controller Reset

The host is notified of a standby Matrix Controller reset two ways:

• The Poll message from the standby Matrix Controller indicates that the Matrix Controller state has changed from Initialize or Standby to Boot.

• The Poll message from the active Matrix Controller indicates that the standby Matrix Controller has reset.

The system software load is retained. The Poll messages of the standby Matrix Controller indicate the return to the standby state. Any information shared by the active and standby Matrix Controller is sent to the standby from the active Matrix Controller.

The active Matrix Controller sends a Card Status Report message to the host reporting on the standby Matrix Controller. The Poll message reports that the adjacent Matrix Controller is not responding to the Polls. A Matrix Controller reset does not affect connected calls or calls that are in the process of setup.

Active Matrix Controller Reset

The active Matrix Controller sends Poll messages to the host to report a reset. The Poll messages report the Matrix Controller state changes as it transitions from Active, to Boot, to Initialize, to Standby. The standby Matrix Controller sends Poll messages that report the Matrix Controller state changes from Standby, to Switchover, to Active.

When the standby Matrix Controller changes to the active state, the CSP sends Card Status Report messages for all cards to the host applications. The Matrix Controller retains the configuration. We recommend creating your host application so that it verifies that the Matrix Controller has retained the configuration. You can use the configuration tags that are returned in the Card Status Report messages, as well as the tags that the application stores for each line card.

The application should prepare itself to communicate with the new active Matrix Controller. The CSP maintains connections for all channels that were connected before the switchover occurred. But calls that were in the process of setup are torn down. The CSP sends the DS0 Status Change message to the host to report all of the in-service channel states. If a software fault occurs, please notify Dialogic Technical Support.

Line Card Reset

When a line card resets, the CSP notifies the host with the Card Status Report message. The cards maintain their software load and configuration. Your application should check the configuration tag to confirm that configuration is intact.

All calls associated with the card, both connected and in the process of setup, are torn down. The DS0 Status Change message informs the host of the affected channel states. If the CSP is configured for line card redundancy, your application can configure the standby line card and can instruct it to become active.

DSP Card Reset

The CSP sends the Card Status Report message to the host to report a DSP card reset. The card maintains its software load and configuration. Use the configuration tag to verify the card configuration. The CSP removes the DSP resources from service during the reset. If a second card has the same configuration, DSP resources are maintained.

Channel Purge

If the CSP cannot appropriately correlate conditions relating to a channel, a channel purge occurs. The channel purge ensures that the CSP retains channels when an unexpected condition occurs, such as the following:

• Unexpected signaling conditions

• Unexpected results of related channels

• Timeouts

When a channel purges, the host receives a set of three DS0 Status Change messages with the following values:

• Channel Status: 0x01 (Out-of-Service)

• Channel Status: 0x00 (Purge)
Purge Status: See Purge Status Values for purge reason

• Channel Status: 0x02 (In-Service)

If a channel purges, the host may not receive acknowledgments for outstanding call processing messages sent to the purged channel. Therefore, design all host applications to handle a channel purge.

RAN. Recorded messages provided to callers for various reasons.
Digital Signal Processor