SccpSetNSapCfg

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.

Prototype

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 values

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.


Details

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.