Parameter file generation utility - pf2src

Name

pf2src

Purpose

Converts a .pf file to the corresponding C source and header files containing required Natural Access compliant parameter data structures.

Usage

pf2src [options] ParameterFileName.pf

where options are:

Option

Specifies...

-w

Not to overwrite existing source and header files.

-x

An extension parameter table should be generated (rather than a standard parameter table).

-s filename

File name for both the generated C source file and header file. The default is to use the same file name as the .pf file.


Description

pf2src converts a .pf parameter description file to the corresponding C source and header files. These files contain data structures needed by the call to dispRegisterService. The data structures must be registered as either a standard parameter table or an extension parameter table.

For a standard parameter table, the generated C label is _xxxParmDescTable.

For an extension parameter table, the generated C label is _xxxExtParmDescTable.

Procedure

  1. Create a .pf file (for example, tikparm.pf). Refer to the Natural Access Developer's Reference Manual.

  2. Run pf2src to create the associated source and header file. For example:

  3. pf2src tikparm.pf

This example creates the files tikparm.c and tikparm.h.

In the call to dispRegisterService in xxxDefineService, use the appropriate parameter table argument. For example, in tikDefineService, the call to dispRegisterService contains a _tikParmDescTable as the standard parameter table argument.

Note: Typically, the call to pf2src is embedded in the makefile for your service. Refer to the makefile for the tik service.