To use CSPack in production mode, you'll need to customize its behavior by creating a PFF file. You can then use the PFF file as a command line parameter for CSPack.exe (the associated filename of this utility). For example, if you name your PFF file "MyPack.pff", you can run CSPack by doing the following from the DOS prompt or a desktop icon:
C:\Program Files\CSPro 7.1\CSPack.exe MyPack.pff
This assumes CSPro was installed in the default directory. Your PFF file must have a ".pff" extension.
The PFF file is a text file so you can create and modify it using any text editor (such as Notepad or Wordpad). Any combination of upper and lower case text may be used. Or, you can run CSPack once, and a PFF file will be automatically created for you—it will be named "CSPack.pff", and will be placed in the same folder as your selected application. The following is an example of a CSPack PFF file.
The [Run Information] block is required and must appear exactly as shown in the example above
The [Files] block is required and defines all files that could be used by CSPack. The three entries are optional.
- Application= is the name of the application to be backed up. It must have an extension .ent, .bch, or .xtb.
- Listing= indicates the name of the listing file that will be created.
- ZipFile= is the name of the ZIP file that will be produced by CSPack.
The [Parameters] block is optional.
- ViewListing= determines whether or not the CSPack report is displayed with TextViewer at the end of the run. If ViewListing=Never, then the report is not displayed. If ViewListing=OnError, then you will only see the report if any error occurred during ZIP operation. If ViewListing=Always, then the results will always be shown. If the line is missing the results will be displayed by default.
- ViewResults= determines whether you view the newly created ZIP file. Available options are "Yes" and "No." If the PFF file was automatically generated, this entry will default to "No." If the line is missing the results will be shown.
- Silent= determines whether or not to run CSPack interactively, and can be "Yes" or "No." If running silently, the main CSPack dialog box will not be displayed and the pack operation will take place without user intervention. If Silent="Yes", the PFF file must contain Application and ZipFile entries in the [Files] section.
- PackInclude= specifies whether to include any extra files in the ZIP file. Options, which can be separated by commas, include:
- InputFile: includes the application's input data file
- ExternalFiles: includes any data files associated with the application's external dictionaries
- UserFiles: includes any files associated with the application as user files (generated in logic)
- VSImages: includes any value set images associated with the application's dictionaries
- Resources: includes any files in the application's resource folders