Queue Manager Manual

Step 4: Define Queue Manager
Installation and Management
4–12 46517 Tandem Computers Incorporated
REDEFINE
provides for changing reconfigurable parameters for the Queue Manager for an
existing Queue Manager configuration. REDEFINE is optional and is assumed if
you specify neither REDEFINE nor INITIAL.
Here is an example of a run command:
1> RUN CDPQDEF /OUT $S.#pqout , NOWAIT/ trancnfg INITIAL
This command specifies processing for the initial installation of the Queue Manager
and specifies that DEFINE file DEFINEPQ resides on subvolume TRANCNFG. In this
example the TRANSFER user-DSV is the current default subvolume. CDPQDEF
writes the generated files to subvolume TRANCNFG and the listing to the spooler file
#PQOUT. NOWAIT returns immediate control to the terminal while execution
continues. CDPQDEF checks input data for required parameters and performs some
parameter checking. If CDPQDEF finds input errors, it issues a message to the listing
file. If CDPQDEF execution results in errors, make the indicated corrections in the
DEFINEPQ file and rerun CDPQDEF. Continue this process until execution results in
this message: “CDPQDEF finished successfully”.
If the definition run is for the initial installation of the Queue Manager, CDPQDEF
uses configuration information to generate files that initialize the Queue file. These
files are:
GPQINIT, which is a GUARDIAN 90 command interpreter OBEY file that contains
commands to invoke programs that create and initialize the Queue file.
GPQFUP, which contains File Utility Program (FUP) commands to create the
Queue file.
GPQLOAD, which contains NALOAD commands to add the configuration names
to the name directory.
Note If the Queue Manager definition parameters specify that the PATHWAY system is other than a
TRANSFER PATHWAY system, CDPQDEF does not generate the file GPQLOAD and the file GPQINIT
does not invoke NALOAD.
For both INITIAL and REDEFINE runs, CDPQDEF generates a file to be used for
configuring Queue Manager. The file generated on the configuration subvolume is
GPQCNFG, which contains the PATHWAY configurations for the Entry and Wait
Manager servers.
If any file that CDPQDEF generates exists in the configuration subvolume when
CDPQDEF executes, CDPQDEF moves the file to a new subvolume, writes the newly
generated file to the configuration subvolume, and issues a message telling the
location of the old, moved file.