HP-UX SNAplus2 R7 Administration Guide

Administering SNAplus2
Using the Motif Administration Program
If a 3270 emulation program is using LUs on the node when you disable the SNAplus2 software, all 3270 emulation
sessions using these LUs end. The program continues to run, but the user cannot use the sessions until the software
is re-enabled. If the RJE workstation program is running, it automatically exits. Applications using the APPC,
CSV, LUA, NOF, or MS APIs are notified by a
COMM_SUBSYSTEM_ABENDED
return code, HLLAPI applications
by a
HARC_SYSTEM_ERROR
return code, and CPI-C applications by a
CM_PRODUCT_SPECIFIC_ERROR
return code.
To disable the SNAplus2 software, enter the following command at the HP-UX command prompt:
snap stop
If SNAplus2 is disabled successfully, snap stop returns an exit code of
0. Any other exit code indicates that an
error occurred and that the SNAplus2 software was not disabled. Refer to HP-UX SNAplus2 Diagnostics Guide for
more information about exit code values.
3.4 Using the Motif Administration Program
The Motif administration program provides a user-friendly interface for configuring SNAplus2. This program is
the recommended tool for administering SNAplus2, because it guides you through the configuration process and
minimizes the information you need to provide to create a workable configuration.
You can also use the Motif administration program to manage the SNAplus2 system while it is active. The
administration program enables you to make and apply changes to the configuration while SNAplus2 is active. You
can add, modify, and remove resources (in most cases, even when the node and its resources are active), and use
the modified configuration immediately for continued operation.
The Motif administration program displays up-to-date status information through the same interface that is used for
configuration, providing easy access to status information for both domain and node resources.
Alternatively, you can use SNAplus2 commands for configuration and system management. A summary of config-
uration and management commands is provided in Section 3.5, Using the Command-Line Administration Program.
3.4.1 Invoking the Motif Administration Program
To use the Motif administration program for SNAplus2, first make sure that SNAplus2 is enabled as described in
Section 3.3.2, Enabling SNAplus2 Servers. (As with any X/Motif application, you may also need to set up the
DISPLAY environment variable to indicate a suitable X server.)
To start the Motif administration program running in the background, issue the following command:
xsnapadmin &
Alternatively, if you installed SNAplus2 under the Common Desktop Environment (CDE) and Motif is already
running, you can double-click on the
SNA Administration icon in the Application Manager window to start SNAplus2.
In a client/server environment, SNAplus2 displays the Domain window.
For a standalone system, SNAplus2 normally displays the Node window. However, if you have not yet configured
the local node, it displays a help screen offering help with configuring the node for the first time.
Note
This guide uses the term window to describe Motif windows that display information about
SNAplus2 resources. A window can contain one or more sections, or panes. A dialog is a
Motif window on which you can enter information.
68