M3uaSendData

Requests data to be transmitted to a specified signaling point.

Prototype

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 values

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.


Details

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:

For more information, see Transferring data.