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.
short isupValidateCircuit ( U8 board, U32 circId)
Argument |
Description |
board |
TX board number. |
circId |
Identifier of the circuit to validate. |
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. |
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 );
}