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

#define INCL_FFST
#include <os2.h>

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 <unichar.h>
  #include <os2.h>
  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