Queue Manager Manual

Step 6: Configuration
Installation and Management
46517 Tandem Computers Incorporated 4–13
Do not directly edit the files that CDPQDEF generates, which are secured “O-OO” to
discourage editing. If you wish to change configuration information, either customize
the Queue Manager by adding information to customizing files as described later in
this section or change information in the Queue Manager DEFINE file and rerun
CDPQDEF.
Step 5: Initialization The GPQINIT OBEY file contains the commands that invoke programs to create and
initialize the Queue file. Initialization is performed to install a new system or
component or to start over and reinitialize an existing system.
The GPQINIT file is written to the configuration subvolume by definition program
CDPQDEF if you specify INITIAL in the execution command. Running this OBEY file
constitutes the initialization phase of the Queue Manager and applies only to
initialization, not to redefinition, of the Queue Manager.
After you run the CDPQDEF program with INITIAL specified, execute the OBEY file
by specifying the following command:
1> OBEY GPQINIT
OBEY file GPQINIT requires that files GPQFUP and GPQLOAD reside in the
configuration subvolume. These files are generated at the same time GPQINIT is
generated by the CDPQDEF program.
When GPQINIT executes, expect to get messages that indicate errors. For example,
GPQINIT purges files before creating them. If these files do not exist, which is true the
first time you install the Queue Manager, you get warning messages about the
nonexistent files. Ignore these messages, but examine all messages for exceptions.
The files generated exclusively for the initial phase are used once to establish the
database used by Queue Manager. After initialization has completed successfully,
purge these files to reduce the possibility of destroying files by accidentally repeating
the OBEY GPQINIT step. The files to be purged are GPQINIT, GPQFUP, and
GPQLOAD.
Step 6: Configuration Execution of CDPQDEF sets up PATHWAY configuration information for the Wait
Manager and the Entry Manager. If you are configuring Queue Manager as part of a
TRANSFER system, the TRANSFER XCNFG program will access the files generated
by CDPQDEF and GPQINIT to define the Queue Manager components of the
TRANSFER PATHWAY system. See the TRANSFER Installation and Management Guide
for more on the XCNFG program.
If you are configuring Queue Manager as part of a PATHWAY system without
TRANSFER, you can include in your PATHWAY configuration file the appropriate
server definitions defined in the file GPQCNFG. Refer to the example of a Queue
Manager cold start at the end of this section.