HP 3000 Manuals HP 3000 Manuals
Introducing the GENCAT Utility
GENCAT.PUB.SYS is the program that formats, incorporates your
modifications, and unformats (expands) the message catalog files. GENCAT
is menu-driven with HELP available in each step.
GENCAT has an online HELP facility. To access HELP, enter the index
number for HELP from the menu, or a "?" in response to any prompt that
does not have a menu selection for HELP.
Explanations of GENCAT error messages are given in Appendix A.
Types of Files
GENCAT uses or creates four types of files:
* Source - You create source files; they contain the sets of messages
for your application. Source files are EDIT/V-compatible, ASCII
files. Creating a source file is described in this chapter.
* Formatted - These files are created by GENCAT from your source files.
They contain a directory to the messages (as well as the messages)
for quick access. The files are formatted in binary and are not
EDIT/V-compatible. Formatted files are accessed by your application;
the application then outputs the messages. Creating formatted files
is described in this chapter.
* Maintenance - You create these ASCII files in an EDIT/V-compatible
format. Maintenance files contain corrections to your source files,
such as adding, deleting, or replacing messages and sets. Creating
maintenance files is described in Chapter 4.
* Collision - When you use a maintenance file to modify your source
file, GENCAT creates a collision file on your request. This ASCII,
EDIT/V-compatible file contains all the changes made to the source
file by a given maintenance file. If you use the collision file as a
maintenance file on a previously modified source file, you will get
the original source. Creating collision files is described in
Chapter 4.
GENCAT dialog examples are given throughout this manual. The operations
are performed on the example files: SOURCE, FORMAT, MAINT, and COLISION.
They are source, formatted, maintenance, and collision files
respectively. Operations on the example files show you how to use GENCAT
for your own message catalogs.
Using GENCAT in Batch Mode
To run GENCAT from a batch job, enter your responses to GENCAT prompts in
the INFO = string after specifying the execution of the GENCAT utility.
Type the GENCAT menu numbers and your file names in the same order as you
would interactively. Separate your responses by semicolons. Submit the
job in the usual manner.
An example of formatting a source file, named SOURCE, to the formatted
file, FORMAT, with GENCAT is:
!JOB Jobname,User/Userpass.Acct/Acctpass,Group/Groupass
!Run GENCAT.PUB.SYS;INFO = "3;SOURCE;FORMAT;0"
!EOJ
If GENCAT encounters an error while formatting, expanding, or modifying a
catalog, it will abort the job.
For information on formatting with GENCAT, refer to the end of this
chapter. For information about creating jobs, refer to the MPE XL
Commands Reference Manual (32650-90003).
GENCAT JCWs
GENCAT sets one of three Job Control Words (JCWs) at the conclusion of a
formatting, maintenance, or expansion operation: GCFORMAT, GCMAINT, or
GCEXPAND, respectively. If the operation completes successfully, the
appropriate JCW is set to zero; if it fails, the JCW is set to the GENCAT
error number. These errors are listed in Appendix A.
For information about JCWs, refer to Command Interpreter Access &
Variables Programmer's Guide (32650-90011).