Initializes an SCCP user service access point configuration buffer to default values that can be passed to SccpSetUSapCfg.
SCCP_STATUS SccpInitUSapCfg ( SccpUSapCfg *pCfg, S16 swType)
Argument |
Description |
pCfg |
Pointer to the address of the SCCP SAP configuration parameters buffer: typedef struct
|
swType |
Switch type used by the SCCP service access point: SCCP_SW_ITU88 SCCP_SW_ITU92 SCCP_SW_ITU96 SCCP_SW_ANS88 SCCP_SW_ANS92 SCCP_SW_ANS96 |
Return value |
Description |
SCCP_SUCCESS |
|
SCCP_NULLPTR |
Null pointer was specified for pCfg. |
SCCP_SWTYPE |
Invalid switch type was specified for swType. |
Prior to calling SccpSetUSapCfg to send the configuration block to the SCCP layer, the application can change the default values within the specified range for any fields other than those denoted as internal or unused.
Default values for the SccpUSapCfg structure that can be overridden by the calling application are listed in the following table.
Note: SccpUSapCfg structure members not listed in the following table are either unused or for internal use only. These fields are set to correct values by SccpInitUSapCfg and must not be overridden by the application.
All values listed in the following table can be modified on the first call to SccpSetUSapCfg. On subsequent calls to SccpSetUSapCfg, only parameters listed in bold can be modified. Those fields not in bold are ignored on subsequent calls.
Field |
Range |
Default value |
Description |
swType |
SCCP_SW_ANS88 SCCP_SW_ANS92 SCCP_SW_ANS96 SCCP_SW_ITU88 SCCP_SW_ITU92 SCCP_SW_ITU96 |
SCCP_SW_ANS92 |
Protocol variant used for this SAP. |
bkupPcInd |
0 or 1 |
0 |
Set to 1 if a backup point code is to be configured. |
bkupPc |
Hex number |
none |
Point code where this subsystem is backed up. Enter 1.1.1 as 0x00010101. |
aicEnabled |
0 or 1 |
0 |
Set to 1 to enable application inactivity timer. |
numAltOpc |
0 - 8 |
none |
Number of alternate point codes. |
usapAltOpc |
N/A |
none |
Array of alternate point codes. |
usapAltOpc[i].numConPc |
0 to |
0 |
Number of concerned point codes in the conPcList. |
usapAltOpc[i].usapOpc |
Hex number |
none |
Originating point code for this USAP. |
usapAltOpc[i].conPcList |
Hex number |
none |
Up to SCCP_MAXCONPC point codes, each entered as a hex value. Enter 1.1.1 as 0x00010101. |
AddrMaskList[i].length |
0 to SCCP_LENADR |
none |
Length of the address mask in bytes. Set to 0 if a mask is not used. |
AddrMaskList[i].strg |
0 to SCCP_LENADR |
none |
An address mask describing which digits to match when performing a global title translation. |
useMsk |
0 or 1 |
0 |
Set to 1 if an addrMsk is defined. |
hopCnt |
1 - 15 |
10 |
Hop count value used on outgoing SCCP messages from this SAP. |
qThresh1 |
1 - 2000 |
600 |
Number of messages outstanding to a higher level task (TCAP) or an application at which inbound congestion level 1 starts. |
qThresh2 |
1 - 2000 |
900 |
Number of messages outstanding to a higher level task (TCAP) or an application at which inbound congestion level 2 starts. |
qThresh3 |
1 - 2000 |
1200 |
Number of messages outstanding to a higher level task (TCAP) or an application at which inbound congestion level 3 starts. |
The addrMsk can be composed of only 0 and f. Each byte contains two hexadecimal digits. SccpAsciiMaskToBcd can be used to convert an ASCII string into the correct format. As an example, FFF masks off everything but the first three digits of a global title. The result is then compared to the various global titles configured. The mask FFFFFFFFFF does not mask off any digits.
An addrMsk of a single 0 (zero) matches all global titles. Any global title masked with an addrMsk of 0 (zero) matches an ADDRESS section of 0 (zero).