isupGetUSapCfg

Sends a get configuration request to the TX board and blocks the calling application while waiting for a response. A user service access point configuration for the board is returned. The received configuration parameters are placed in the configuration buffer supplied by the application.

Prototype

short isupGetUSapCfg ( U8 board, IsupUSapCfg *cfg, U16 sapId)

Argument

Description

board

TX board number.

cfg

Pointer to the IsupUSapCfg structure where the requested configuration information is returned. Refer to isupInitUSapCfg for the structure definition.

sapId

ISUP service access point.


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;
IsupUsapCfg  cfg;
S16          sapId=1;


if ((status = isupGetUsapCfg(boardNum, &cfg, sapId)) != ISUP_MGMT_SUCCESS)
{
    printf( "Board %d Service Access Point %d Get USAP Configuration Request
        failed: status = %d\n", boardNum, sapId, status );
}
else
{
    printf("Successfully obtained USAP configuration information for service access
        point %d on board %d\n", sapId, boardNum);

/* The structure cfg structure contains the returned USAP configuration information */

}