Administering the SNA Components

 

This chapter discusses the following topics:

• Administration Facilities

• The SNACRM and PU 2.1 Servers

• The SNACRM Monitor

• Activating and De-Activating Links

 

---

Administration Facilities

The topics in this section cover activities an administrator performs with the System Network Architecture Communications Resource Manager (SNACRM) to maintain BEA eLink Java Adapter for Mainframe WLS Edition (JAM) applications.

The interface to the stack administration and configuration is dependent on the stack provider and thus cannot be covered in this guide. Refer to vendor publications for the stack(s) used in your environment.

 

---

The SNACRM and PU 2.1 Servers

The SNACRM is a server that communicates directly with the PU 2.1 server to provide SNA connectivity. These servers can be started manually. The PU 2.1 server must always be started before the SNACRM. Both servers must be started before starting the associated SNA domain gateway.

Starting the PU2.1 Server

Refer to the operational documentation provided by your SNA stack vendor for information about starting the PU2.1 server. The SNA stack must be running and active before you start the SNACRM.

Starting the SNACRM

When you start the SNACRM from the UNIX command line, the SNACRM Command Line Console puts its prompt in a window, and if exited, shuts down all of the active links. On Windows NT, the SNACRM can be started in its own window, however, no prompt is displayed and no console commands are available. Please refer to SNACRM in Command Reference Pages for more detailed information.

 

---

The SNACRM Monitor

You can use the SNACRM monitor to set trace levels for a selected SNACRM and the associated APPC stacks. You also can observe link activity and display trace status, link status, and link statistics.

Note: The SNACRM monitor does not show trace data. This data is captured in a file under the APPDIR directory (where APPDIR is the variable name associated with the application directory). Please contact BEA Customer Support for help in locating the trace file(s) and interpreting them.

The JAM software includes two utilities that launch and execute the SNACRM monitor. The xsnacrm utility is designed for UNIX platforms and requires Motif libraries. The jsnacrm utility is designed for Windows NT platforms and supplies both a Java-based application and an applet.

The following discussion relates to the Windows NT-based SNACRM monitor only. Refer to xsnacrm in Command Reference Pages for detailed information about the UNIX-based SNACRM monitor.

The BEA eLink Java Adapter for Mainframe WLS Edition software CDROM contains the following files associated with the jsnacrm utility:

• bealogo.gif

• jsnacrm.html

• jsnacrm.jar

• moncrm.jar

• moncrm.x509

Prerequisite for Running the JSNACRM Utility on an NT Platform

The jsnacrm utility is written in Java as both an application and an applet. The application launches and executes like any other Java application and can be set up so it is accessible from the Windows desktop. The applet launches and executes from a network browser.

Running the Java Applet Version

The following sections describe how to set up and run the Java applet version of the JSNACRM utility.

Prerequisites for Running the Java Applet Version

You must have either Netscape Communicator 4.x or Internet Explorer 4.x or 5.x installed on your NT Windows system. You also must have the Java plug-in installed on your system. You can download this plug-in from the following internet location:

http://java.sun.com/products/plugin

Note: If the Java plug-in is not already installed on your system, when you attempt to open the jsnacrm.html file, the program prompts you for an automatic download of the plug-in by the browser.

Next, you must set up your system to accept code signed by the identity moncrm. To do this, perform the following steps:

1. Create the identity moncrm in your JDK 1.1 identity database. By entering the parameter true, you establish moncrm to be a trusted identity.

   javakey -c moncrm true

2. Import the moncrm certificate into your identity database. To associate the certificate with the identity, use the nickname moncrm as the first argument to the javakey command.

   javakey -ic moncrm %TUXDIR%\bin\moncrm.x509

Starting the Java Applet

To start the Java applet in an existing browser, open the file:

<tuxedo-path>\bin\jsnacrm.html

To build a shortcut to start the Java applet using a separate instance of your network browser, enter the following command:

<browser-pathname> %TUXDIR%\bin\jsnacrm.html

Running the Java Applet Version

Set up your applet version to monitor either a local or remote SNACRM. To do this, you make selections on the Java Plug-in Properties control panel. This control panel is automatically downloaded with the plug-in and is initiated from the Windows Start Programs pop-up menu. Refer to online documentation about the control panel at the following Internet location:

http://java.sun.com/products/plugin/1.1.1/docs

When the Monitor screen displays (Figure 2-1), enter the address of the SNACRM that you want to monitor in the field at the top of the screen.

To monitor a local SNACRM, select Applet Host from the Network Access drop-down menu. Type the following in the Enter SNACRM Address panel:

//localhost:port

where:

localhost

Explicitly specifies the local host.

port

Specifies the port number of the SNACRM on the local host.

To monitor a remote SNACRM, select Unrestricted from the Network Access drop down menu. Type the following in the Enter SNACRM Address panel:

//remotehostname:address

where:

remotehostname

Specifies the remote host.

address

Specifies the network address of the SNACRM on the remote host.

The GUI contains two screen areas that require user entry and four screen areas that display information about the SNACRM being monitored. Status messages are displayed at the bottom of the screen. The GUI screen functions are listed in Table 2-1 and shown in Figure 2-1.

Table 2-1 SNACRM Monitor Screen Functions

Display Section	Function
SNACRM Address	This is where you enter the address of the SNACRM to be monitored.
Selected SNACRM	Displays the name of the SNACRM at the address entered in the address field.
Trace Status	Displays the currently selected trace options.
Trace Options	Stop CRM Trace disables SNACRM tracing and closes the trace file, if it exists. Set Minimum CRM Trace establishes tracing of only major events. This level is sufficient only to determine the sequence of application conversations. Set Medium CRM Trace establishes minimum tracing plus tracing of all I/O buffers. Set Maximum CRM Trace establishes medium tracing plus tracing of all APPC verbs. Start APPC Stack Trace establishes tracing of the APPC stack. Generally shows the parameters and results of all API calls. Depending on the stack being used, other options such as vendor-specified environment variables also may have to be activated. May be selected along with any of the previous Trace Options. Stop APPC Stack Trace disables APPC stack trace, if established.
Link Status	Displays the current status of all remote links for the selected SNACRM. (Text may be scrolled.)
Link Statistics	Displays the current statistics for all remote links for the selected SNACRM. (Text may be scrolled.)
Message Line	Displays messages showing either the results of automatic connection attempts or commands issued to change the trace options.

Figure 2-1 The SNACRM Monitor Running as an Applet on a Network Browser

Running the Java Application Version

The Java application version displays and operates identically to the applet version. Refer to screen definitions and functions discussed under "Running the Java Applet Version."

To build a shortcut for starting the Java application version, perform the following steps:

1. Enter the command:

   jrew -classpath %ClassPath%;jsnacrm.jar jsnacrm

2. Start the application in the directory %TUXDIR%\bin so it can find its files.

To run from a command window, perform the following steps:

1. Change directory to %TUXDIR%\bin.

2. Enter the command:

   jrew -classpath %ClassPath%;jsnacrm.jar jsnacrm

 

---

Activating and De-Activating Links

The JAM gateway software provides a command line tool you can use to activate and de-activate links that have been defined in the JM_SNALINKS section of the jcrmgw.cfg file. This tool consists of two commands and their associated parameters: crmlkon and crmlkoff.

Note: If a link to a remote host is de-activated and re-activated by the host, the JAM software normally re-establishes the link automatically. If this does not occur, you can use the crmlkon command to re-establish the link.

Using the crmlkon Command

You can start one or more SNA links with this command. Use the following syntax:

crmlkon -n<hostname:port> [-v -i -h] <linkname> ... 

where:

-n

indicates that the parameters immediately following are the hostname and port of the machine running the SNACRM where the linkname is located.

hostname:port

specifies the IP host name and port of the machine running the SNACRM where the linkname is located.

-v

specifies that this command displays verbose output.

-i

causes the command to ignore errors and attempt to start all links specified on the command line.

h

invokes a help screen that shows the syntax usage for this command.

linkname

specifies the link name(s) to start.

Note: There is no notification that the link(s) started with the crmlkon command are activated. Use the SNACRM monitor to verify a link is active. Refer to The SNACRM Monitor for more information.

Using the crmlkoff Command

You can stop one or more SNA links with this command. Use the following syntax:

crmlkoff -n<hostname:port> [-v -i -h] <linkname> ... 

where:

-n

indicates that the parameters immediately following are the hostname and port of the machine running the SNACRM where the linkname is located. This is required.

hostname:port

specifies the IP host name and port of the machine running the SNACRM where the linkname is located.

-v

specifies that this command displays verbose output.

-i

causes the command to ignore errors and attempt to stop all links specified on the command line.

h

invokes a help screen that shows the syntax usage for this command.

linkname

specifies the link name(s) to start.

Note: There is no notification that the link(s) stopped with the crmlkoff command are de-activated. Use the SNACRM monitor to verify a link is not active. Refer to The SNACRM Monitor for more information.