TCAPCoordReq

Requests that the subsystem be taken out of service and have all traffic routed to its backup point code.

Prototype

DWORD TCAPCoordReq ( CTAHD ctahd, S16 spId, U8 aSsn)

Argument

Description

ctahd

Context handle returned by ctaCreateContext.

spId

TCAP service access point to which the caller is bound.

aSsn

Affected subsystem number.


Return values

Return value

Description

TCAP_SUCCESS

 

CTAERR_BAD_ARGUMENT

Natural Access handle is invalid, or an invalid message buffer has been used.

CTAERR_DRIVER_SEND_FAILED

Message buffer was not sent to the board. Call TCAPGetApiStats and check the txLastErr field to find the error.

CTAERR_INVALID_HANDLE

Natural Access handle is invalid.

CTAERR_OUT_OF_MEMORY

TCAP service queue is full and another request could not be queued to the TCAP layer.


Details

Generates a SCCP subsystem-out-of-service-request (SOR) to the backup signaling point as specified in the SAP configuration.