isupValidateCircuit

Sends a request to validate the given circuit and blocks the calling application while waiting for a response.

Note: This function is not supported in BICC. If this function is invoked for BICC, the ISUP stack layer reports a service unavailable alarm message.

Prototype

short isupValidateCircuit ( U8 board, U32 circId)

Argument

Description

board

TX board number.

circId

Identifier of the circuit to validate.


Return values

Return value

Description

ISUP_SUCCESS

 

ISUP_BOARD

board is out of range.

ISUP_DRIVER

Error occurred accessing the driver.

ISUP_FAILED

Task on the TX board returned a failure.

ISUP_UNBOUND

Application failed to call isupInitMgmtAPI prior to this call.


Example

S16  status;
U8   boardNum=1;
U32  circuitId=1;

if ((status = isupValidateCircuit(boardNum, circuitId)) != ISUP_MGMT_SUCCESS)
{
    printf( "Board %d Circuit %d Validate Request failed: status = %d\n", boardNum,
        circuitId, status );
}
else
{
    printf( Successfully validated circuit %d on board %d\n", circuitId, boardNum );
}