Sends a TCAP service access point (SAP) configuration parameter block to the specified TX board to define or update the configuration for a specific TCAP SAP.
S16 TCAPSapCfg ( U8 board, TcapSapCfg *cfg, U16 sapId)
|
Argument |
Description |
|
board |
TX board number to which this request is directed. |
|
cfg |
Pointer to the address of the SAP configuration parameters buffer. The buffer's format is specified in TCAPInitSapCfg. |
|
sapId |
Service access point being defined. |
|
Return value |
Description |
|
TCAP_SUCCESS |
|
|
TCAPM_BADSAP |
SAP ID is either out of range or the call was made prior to calling TCAPGenCfg. |
|
TCAPM_BOARD |
board is out of range. |
|
TCAPM_DRIVER |
Error occurred accessing the driver. |
|
TCAPM_FAILED |
Task on the TX board returned a failure. |
|
TCAPM_NULLPTR |
Null pointer was specified for cfg. |
|
TCAPM_SWTYPE |
Protocol selector switch type is invalid. |
|
TCAPM_TIMEOUT |
Request timed out. |
|
TCAPM_UNINIT |
Application failed to call TCAPInitMgmtAPI prior to this call. |
This function can be called any time after the general configuration is downloaded to the TX board using TCAPGenCfg but before any application attempts to bind to this SAP for transaction processing.
An existing TCAP SAP can be redefined to change one or more of its configuration parameters by calling TCAPSapCfg a second time, but only if there is no application currently bound to the SAP.
cfg must be initialized with TCAPInitSapCfg prior to this call.