FFSTSetConfiguration

FFSTSetConfiguration sets the FFST configuration parameters.

You should use FFSTQueryConfiguration to obtain the current settings before using this function. This allows you to change the desired parameters without affecting others.

Syntax
FFSTSetConfiguration(pConfigParms);

Parameters

 * pConfigParms (PCONFIGPARMS) - input : Pointer to FFST configuration parameters.

Returns

 * rc (APIRET) - returns: Return code.

FFSTSetConfiguration returns the following values:

From FFSTSetConfiguration to application 1000195     Invalid config user buffer size address 1000200     Invalid config address 1000205     Invalid config revision number 1000210     Invalid config packet size 1000215     Invalid config dump file wrap 1000220     Invalid config dump file directory size 1000225     Invalid config keep dup dump 1000230     Invalid config dump file directory name address 1000235     Invalid config dump file directory name length 1000240     Invalid config no disabled products 1000245     Invalid config disabled products address 1000250     Invalid config vendor tag address 1000255     Invalid config tag address 1000260     Invalid config revision address 1000265     Invalid config message popup

Return codes for file errors during Configuration processing 0x16570     Config file open error 0x16571     Config file search error 0x16572     Config file write error

Return code for an insufficient buffer passed to Configuration 0x1657A     Config insufficient buffer

Return code for invalid dump file directory driver passed to FFSTSetConfiguration. 0x1657B     Invalid config dump file dir drive

Return codes for an invalid drive or path passed to FFSTSetConfiguration. 0x1657C     Invalid drive requested 0x1657D     Invalid path requested

/*-*/ /* Return codes from FFSTProbe, FFSTQueryConfiguration,*/ /* FFSTSetConfiguration or other FFST processing. */ /*-*/ Return codes for shared memory errors 0x16580      Get shared mem error 0x16581      Alloc shared mem error 0x16582      Free shared mem error

Return codes for semaphore errors 0x1658A      Semaphore timeout error 0x1658B      Semaphore open error 0x1658C      Semaphore release error 0x1658D      Semaphore close error 0x1658E      Semaphore request error 0x17111      Semaphore g error

Return codes for dump engine processing which may be posted to the SysLog. 0x16595      Dump hdr file open error 0x16596      Index file open error 0x16597      Dump file open error 0x16598      Memory allocation error 0x16599      Queryfs error 0x1659a      Dump wrap error 0x1659b      Trace rename error 0x17222      Proc dump rename error

Return codes that may be in the SysLog during Worker bringup 0x165a1      Create config semaphore error 0x165a2      Create dump semaphore error 0x165a3      Worker alloc shared mem error 0x165a4      Worker get shared mem error 0x165a5      Create pct semaphore error 0x165a6      File already exists 0x165a7      Specified file not found 0x165a8      Dump validation error 0x165a9      Config memory filled

0x165aa      Worker setconfig error 0x165ab      Worker pipe not created 0x17005      Worker ffst config not okay 0x165ac      Worker mutexsem not released 0x17010      Worker already active 0x17015      Worker initworker failed 0x17050      Worker not active

Remarks
The library FFST.LIB must be linked with object files that use FFSTSetConfiguration

The packet_revision_number parameter defines if pointers point to ASCII or UniCode character data.

Example Code

 * 1) define INCL_FFST
 * 2) include 

PCONFIGPARMS   pConfigParms; APIRET         rc;            /*  Return code. */

rc = FFSTSetConfiguration(pConfigParms); 

The following example will instruct FFST to stop wrapping dumps. The rest of the parameters are left to their earlier values.  #define INCL_FFST #include  #include   APIRET rc;

CONFIGPARMS FFSTConfig; PCONFIGPARMS pFFSTConfig  *FFSTConfig;

FFSTConfig.dump_file_wrap = FFST_DUMP_WRAP_OFF; /* Set dump wrap to off*/ /* set rest of the parameters to indicate no change */

FFSTConfig.dump_file_directory_size = FFST_DUMP_FILE_DIRECTORY_SIZE_NO_CHANGE; FFSTConfig.keep_dup_dump = FFST_KEEP_DUP_DUMP_NO_CHANGE; FFSTConfig.dump_file_directory_length = FFST_DUMP_FILE_DIERCTORY_LENGTH_NO_CHANGE; FFSTConfig.no_of_disabled_products = FFST_NO_OF_PROBE_DISABLED_PRODUCTS_NO_CHANGE; FFSTConfig.dump_file_directory = NULL; FFSTConfig.PProductData = NULL;

rc = FFSTSetConfiguration( pFFSTConfig); if (rc |= 0)                                      /* If Problem   */ {                                      /* reason       */ printf("FFSTConfigure error: return code = %d",rc); return; } 

Related

 * FFSTQueryConfiguration