Sends a circuit configuration buffer to the TX board and blocks the calling application while waiting for a response.
short isupCircCfg ( U8 board, IsupCircCfg *cfg)
Argument |
Description |
board |
TX board number. |
cfg |
Pointer to the IsupCircCfg structure to send. Refer to isupInitCircCfg for the structure definition. |
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. |
An application must set the field values in the IsupCircCfg structure before calling isupCircCfg. Set the values in any of the following ways:
Call isupInitCircCfg to set the fields to default values.
Set each field value from within the application.
Call isupInitCircCfg and then override specific field values before passing the IsupCircCfg structure to isupCircCfg.
isupCircCfg is typically called once for each configured circuit.
S16 status;
U8 boardNum = 1;
IsupCircCfg cfg;
/* Populate IsupCircCfg structure before calling isupCircCfg */
if ((status = isupCircCfg(boardNum, &cfg)) != ISUP_MGMT_SUCCESS)
{
printf( "Board %d Semd Circuit Configuration Request failed: status = %d\n",
boardNum, status );
}
else
printf( “Successfully sent board circuit information to board %d\n", boardNum );
}