Progress
Client Deployment
Guide


Using the PROLIB Utility

The PROLIB utility allows you to create and maintain standard libraries and generate memory-mapped libraries. This is the syntax to start the PROLIB utility:

Operating System

Syntax
UNIX
Windows
prolib library-name parameter [ file-name ... ]
[ parameter [ file-name ... ] ... ]

library-name

Specifies the name of an r-code library. The library name must have a .pl extension.

parameter

Specifies what action to take on the library. Table 6–1 lists the parameters and their descriptions.

Table 6–1: PROLIB Utility Parameters 
Parameters
Description
-create
Creates a new standard library.
-makeshared
Generates a memory-mapped library from a standard library.
-add
Adds files to a standard library.
-replace
Replaces files in a standard library.
-delete
Deletes files from a standard library.
-list
Lists library information such as library name, format, code page, and file contents.
-extract
Extracts files from a standard library. This parameter copies a file from the library into another file, outside of the library, and gives it the same name.
-yank
Extracts files from a standard library and places them in the current working directory.
-compress
Compresses a standard library by making a copy of it.
-nowarn
Suppresses any warning message that might occur during the operation of the primary parameters. If you add a file to a standard library with the -add and -nowarn parameters, and the file already exists in the library, PROLIB replaces the file.
-pf
Allows you to supply command-line arguments in a parameter file. You cannot use -pf in a parameter file.
-verbose
Directs PROLIB to display processing information that is ordinarily suppressed.
-date
Specifies the format of the date as it appears when you use the -list parameter.

When specifying a parameter, you do not have to type the complete parameter name. You can type the minimally unique string for each parameter (for example, -l for -list and -e for -extract).

The -nowarn and -verbose parameters modify the behavior of the -create, -makeshared, -add, -replace, -delete, -list, -extract, and -yank parameters.

You can place the -nowarn, -pf, and -verbose parameters anywhere on the command line. They affect the processing of all other specified parameters.

You must place the -create parameter before all other parameters. PROLIB processes parameters in left-to-right order as they appear on the command line. If an error occurs during the PROLIB command, PROLIB terminates. This behavior occurs so that options specified later in the command line, which might depend on the failed option, do not execute.

You cannot use the -add, -replace, -delete, -extract, -yank, or -compress parameters with a memory-mapped library (that is, when you specify a memory-mapped library in library-name).

file-name

Specifies the name of an r-code file, or a memory-mapped library file when using the -makeshared parameter.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095