Sends a global or circuit-specific message to the far exchange.
DWORD ISUPStatusReq ( CTAHD ctahd, SuId suId, SiInstId suInstId, SiInstId spInstId, Bool globalFlg, CirId circuit, U8 eventType, SiStaEvnt *statEvnt)
Argument |
Description |
ctahd |
Natural Access handle returned by ctaCreateContext. |
suId |
ISUP service access point. |
suInstId |
Service user instance ID. |
spInstId |
Service provider instance ID. |
globalFlg |
True (non-zero) if this is a global request; false (zero) if this is a circuit-specific request. |
circuit |
For circuit-specific requests, the circuit index with which this request is associated. For circuit group specific requests, this argument must identify one member of the circuit group. |
eventType |
Type of status request. Refer to the Details section for a list of valid values. |
statEvnt |
Pointer to the caller's status event structure containing all parameters (IEs) included in the message to the far exchange. |
Return value |
Description |
ISUP_SUCCESS |
|
CTAERR_BAD_ARGUMENT |
One or more arguments are invalid. |
CTAERR_DRIVER_SEND_FAILED |
Error occurred accessing the TX driver. |
CTAERR_INVALID_CTAHD |
Natural Access handle is invalid. |
The following table lists the valid status request types for eventType:
Status request type |
Description |
CONTCHK |
Continuity check (not supported in BICC) |
CONTREP |
Continuity report |
LOOPBCKACK |
Loop back acknowledgment (not supported in BICC) |
CIRRESERVE |
Circuit reservation request |
CIRRESERVEACK |
Circuit reservation acknowledgment |
CIRGRPQRYREQ |
Circuit group query request |
CIRGRPQRYRSP |
Circuit group query response |
CIRBLKREQ |
Circuit block request (not supported in BICC) |
CIRBLKRSP |
Circuit block response (not supported in BICC) |
CIRUNBLKREQ |
Circuit unblock request (not supported in BICC) |
CIRUNBLKRSP |
Circuit unblock response (not supported in BICC) |
CIRRESREQ |
Circuit reset request |
CIRGRPBLKREQ |
Circuit group block request |
CIRGRPBLKRSP |
Circuit group block response |
CIRGRPUNBLKREQ |
Circuit group unblock request |
CIRGRPUNBLKRSP |
Circuit group unblock response |
CIRGRPRES |
Circuit group reset request |
CIRGRPSET |
Circuit group set request |
CIRGRPGET |
Circuit group get request |
#define SAP_ID 0
DWORD status;
SiStaEvnt staEvnt;
CTAHD FstCtaHd = Valid CTA Handle;
SiInstId suInstId = 0;
SiInstId spInstId = 0;
SuId suId = SAP_ID;
CirId circuit = 2;
memset(&staEvnt, 0, sizeof(SiStaEvnt));
status = ISUPStatusReq( FstCtaHd, suId, suInstId, spInstId, 0, circuit, CIRBLKREQ,
&staEvnt);
if(status != ISUP_SUCCESS)
printf("ISUPStatusReq() failed sending BLOck request, status = %d\n", status);
else
printf("BLOck request sent for circuit %ld\n", circuit);