Sends an SCCP network service access point (NSAP) configuration parameter block to the specified TX board to define or update the configuration for a specific SCCP NSAP.
SCCP_STATUS SccpSetNSapCfg ( U8 board, SccpNSapCfg *pCfg, U16 sapId)
Argument |
Description |
board |
TX board number. |
pCfg |
Pointer to the address of the service access point configuration parameters buffer. The format is specified in SccpInitNSapCfg. |
sapId |
Network service access point ID. |
Return value |
Description |
SCCP_SUCCESS |
|
SCCP_BADDIGIT |
addrMsk contains invalid digits. |
SCCP_BOARD |
board is out of range. |
SCCP_BUFLEN |
addrMsk.length is out of range. |
SCCP_DRIVER |
Error occurred accessing the driver. |
SCCP_EXCEEDMAXCFG |
sapId exceeds the maximum specified through SccpSetGenCfg. |
SCCP_HOPCOUNT |
hopCnt is out of range. |
SCCP_NOGENCFG |
SccpSetGenCfg has not been called. |
SCCP_NULLPTR |
Null pointer was specified for pCfg. |
SCCP_PARAM |
Invalid parameter was detected. Check the txalarm log. |
SCCP_POINTCODE |
Either dpcLen or dpc is out of range. |
SCCP_RANGE |
One of the following is out of range: maxMsgLen, txQThr, spId, or ssf. |
SCCP_RESOURCES |
TX board resource is exhausted. Check the txalarm log. |
SCCP_SWTYPE |
Invalid switch type was specified. |
SCCP_TIMEOUT |
Request timed out. |
SCCP_UNINIT |
Application failed to call SccpMgmtInit prior to this call. |
This function can be called any time after the general configuration is downloaded to the TX board, but before any application attempts to send data for transaction processing.
The first time SccpSetNSapCfg is called after a download of the TX board, all the parameters listed in SccpInitNSapCfg can be modified. On any subsequent call to SccpSetNSapCfg (without downloading the board), only some parameters can be modified. These are listed in bold in SccpInitNSapCfg. Those fields not in bold are ignored on subsequent calls.
SccpSetNSapCfg always sends a value for dstInst equal to that specified for board, regardless of the value specified in the buffer pointed to by pCfg.
pCfg must have been previously initialized with SccpInitNSapCfg.