Pathway/XM System Management Manual

Configuring the Pathway/XM Environment
Compaq NonStop™ Pathway/XM System Management Manual—426761-001
4-5
Input to PXMCFG
Then you run PXMCFG, specifying your configuration source file as the input file and
giving a file name to be used for the SuperCTL file. For detailed syntax of the
command you use to run PXMCFG, refer to Starting PXMCFG on page 10-2. The
PXMCFG utility creates a new SuperCTL file, builds the initial configuration of the
Pathway/XM environment as specified in your source file, and places that configuration
in the SuperCTL file.
Input to PXMCFG
A PXMCFG source file consists of a sequence of SET, RESET, and ADD statements.
The SET and RESET statements define default parameters that can apply to all objects
of a given type. The ADD statement defines, and adds to the configuration, specific
objects of a given type. For examples, refer to Appendix F, Example Configuration
Source Files.
If you are migrating an existing Pathway application to the Pathway/XM environment,
you can start up your existing PATHMON environment, reset the statistics counters, and
then use BUILDCFG and PXMCNVRT to generate an initial PXMCFG source file.
You can then modify this source file as needed. For details, refer to Appendix E,
Migrating Pathway Applications to the Pathway/XM Environment.
How the PXMCFG Utility Builds the SuperCTL File
PXMCFG builds the SuperCTL file in two stages:
1. First, in the definition stage, it processes the statements in the input file in order and
creates the object definitions.
2. Second, in the distribution stage, it calculates the number of PATHMON processes
and TCP processes needed to balance the transaction workload and makes initial
processor assignments for PATHMON, TCP, PB, LCS, and server processes.
PXMCFG reports any errors it finds in the source file. After you have run PXMCFG,
check the output listing and correct any errors; then re-run PXMCFG if necessary.
After PXMCFG has run successfully, the SuperCTL file contains all of the process and
object definitions needed to start the Pathway/XM environment. However, no running
processes are created until you run PXMCOM, open the SuperCTL file, and issue the
necessary START commands.
Output from PXMCFG
The PXMCFG utility provides a diagnostic listing in its output file. This listing is
similar to a compiler output listing. The first part of the listing consists of a copy of the
statements from the input file, interleaved with any error and warning messages; the
second part provides summary information. For examples, refer to Appendix F,
Example Configuration Source Files.
If you are migrating to a new configuration, the summary includes summary information
of the migration PLAN objects also.
Example 4-1
shows the summary portion of a sample PXMCFG run.