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/iX 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).
