ISUPStatusReq

Sends a global or circuit-specific message to the far exchange.

Prototype

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 values

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.


Details

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


Example

#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);