isupCircCfg

Sends a circuit configuration buffer to the TX board and blocks the calling application while waiting for a response.

Prototype

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 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.


Details

An application must set the field values in the IsupCircCfg structure before calling isupCircCfg. Set the values in any of the following ways:

isupCircCfg is typically called once for each configured circuit.

Example

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