Run-time environment

OMPROUTE is a z/OS® UNIX application, and it requires a z/OS UNIX file system to operate. It can be started from an MVS™ started procedure, from the z/OS shell, or from AUTOLOG (see step 2 for restrictions on using AUTOLOG to start OMPROUTE). OMPROUTE must be started by a RACF-authorized user ID, and it must be in an APF authorized library.

OMPROUTE uses the MVS operator's console, syslogd, CTRACE, and STDOUT for its logging and tracing. The MVS operator's console and syslogd are used for major events such as initialization, termination, and error conditions. CTRACE is used for tracing the receipt and transmission of OSPF/RIP packets and communications between OMPROUTE and the TCP/IP stack. In addition, OMPROUTE can be configured to use CTRACE for detailed tracing and debugging. STDOUT is used for detailed tracing and debugging.

When syslogd is active and /dev/console is defined in the syslog.conf file, OMPROUTE logging messages are directed to syslogd and to the MVS console. If syslogd is active and /dev/console is not defined, OMPROUTE logging messages are directed to syslogd only.

When syslogd is inactive, OMPROUTE logging messages are directed to the OMPROUTE JES joblog and to the MVS console.

If OMPROUTE tracing or debugging is enabled, the output can be directed to STDOUT, the JES joblog, or OMPROUTE CTRACE. Additionally, the logging messages (that is, interface initialization messages) can be found in syslogd, provided it is active at the time of tracing or debugging. Syslogd directs urgent OMPROUTE messages to the MVS console.

Tip: If you enable OMPROUTE tracing without syslogd active, large amounts of data can be written to the console.

OMPROUTE uses a standard message catalog. The message catalog must be in the z/OS UNIX file system. The directory location for the message catalog path is set by the environment variables NLSPATH and LANG.

Configuration of OMPROUTE is accomplished using an OMPROUTE configuration file. For details on the statements in the OMPROUTE configuration file, see z/OS Communications Server: IP Configuration Reference.

Display of OMPROUTE information is performed using the DISPLAY or MODIFY command. Modification of OMPROUTE information is performed using the MODIFY command. For details on OMPROUTE's DISPLAY and MODIFY commands, see z/OS Communications Server: IP System Administrator's Commands.