Requests data to be transmitted to a specified signaling point.
DWORD NMSAPI M3uaSendData ( CTAHD ctahd, S16 sapId, U32 opc, U32 dpc, U8 lnkSel, U8 priority, U8 *data, S16 length, U8 srvInfo)
Argument |
Description |
ctahd |
Natural Access handle. |
sapId |
Service access point ID. Specify the same value used for ctaOpenServices. |
opc |
24-bit, 14-bit, or 16-bit originating point code to be inserted in the outgoing message. |
dpc |
24-bit, 14-bit, or 16-bit destination point code of the remote system. |
lnkSel |
Link selector passed to an SGP to choose the link to send data over. Value is masked based on the configured slsLen. Masking results in ranges from 0 through 15 for slsLen=4, 0 through 31 for slsLen=5, or 0 through 255 for slsLen=8. |
priority |
Priority of the message. Valid range is 0 (lowest) through 3 (highest). |
data |
Pointer to the address of a buffer of data to transmit. |
length |
Length (in octets) of the data in the data field. |
srvInfo |
Service information octet (SIO) associated with this message. |
Return value |
Description |
M3UA_SUCCESS |
|
M3UA_INVBOARD |
Invalid board number. |
M3UA_NOT_BOUND |
ctaOpenServices not previously called. |
M3UA_OSERROR |
Lower-level drivers or task returned an error. |
M3UA_RESOURCE |
Host running out of buffers to send to the board. See the Details section for more information. |
Both opc and dpc are passed as 32-bit values. For example, the 24-bit point code 5.49.7 is passed as 0x053107.
lnkSel is an 8-bit value that is masked by M3UA based on the configured slsLen. The lower four bits of lnkSel are used as the sls value if slsLen is configured as 4, the lower five bits of lnkSel are used as the sls value if slsLen is configured as 5, and no masking is performed and the entire 8-bit lnkSel is used as the sls value if slsLen is configured as 8. For more information, see M3UANwkCfg.
The user data consists of the upper layer data. For example, when constructing an ISUP message, the first byte of user data is the first byte of the circuit identification code (CIC). The user application is responsible for any byte-order translation necessary for all data in the data field.
The SIO must be unique for each application. The service information field is composed of service indicator and network indicator fields.
If you receive an M3UA_RESOURCE error, perform one or more of the following tasks:
Increase the number of host buffers in ctaOpenServices. See Using ctaOpenServices.
Monitor M3UAEVN_CONGEST indications to determine when the number of available buffers is running low. Traffic could then be throttled before the buffer pool is exhausted. See Controlling congestion.
Reduce other host to board traffic, including management function traffic.
For more information, see Transferring data.