Configuring IPMonitor v1.0, automatic mode
IPMonitor v1.0 for Java, automatic mode is a Java applet that you can use to collect trace
information containing the session data flowing between a client and a host. You can access
it from the Start Session with the IPMonitor option on the session icon's start menu. This
option is available after you have added the IPMonitor
parameter to the
session HTML file. Z and I Emulator for Web servers running on Win32, AIX, Sun Solaris,
OS/2, Novell Netware, i5/OS, OS/400, MVS/390, and Linux all support the
IPMonitor
parameter, however, only 3270 display, 5250 display, and VT
display sessions support IPMonitor tracing.
You can add the IPMonitor
parameter to session HTML files in two ways:
- by configuring debugging options using the Deployment Wizard.
-
by adding the
IPMonitor
parameter to the APPLET tag in an HTML file.
Configuring debugging options using the Deployment Wizard
- Open the Z and I Emulator for Web Deployment Wizard to create a new or edit an existing HTML file.
- Click through the windows until you reach the Additional Options window.
- Click the Advanced Options button.
- Click Problem Determination in the left tree view.
- Select Advanced.
- Enter the name of the log file in the 'Log file name' field. The Deployment Wizard provides the default file name trace.txt, but you can change it if you wish. For Unix-based client platforms, include the absolute path to where you want to save the file. For Windows client platforms, if you do not specify an absolute path, the log file will be saved to the client desktop.
- Select 'Enable IPMonitor trace'. If you are using the HTML-based model, the 'Session name' field is prefilled with the name of the current sessions that you are configuring. If you are using the Configuration server-based or Combined models, you must manually enter the name of the session that you want to trace.
- Click OK.
- Finish creating your HTML file.
Adding the IPMonitor
parameter to
the APPLET tag of a session HTML file
The IPMonitor
parameter has already been added to the APPLET tag of the
client with problem determination
(
defaultdebug.html
), but is commented out. Use a text editor to
uncomment the IPMonitor
parameter to use the parameter with either of
these clients.
You can only use the Deployment Wizard to edit files that you have created with the Deployment Wizard. You cannot use the Deployment Wizard to edit the client with problem determination . |
To add the IPMonitor
parameter to HTML files you have created without
using the Deployment Wizard, use a text editor to edit the HTML file. The session must
include the problem determination components. Change:
<APPLET archive="hod.jar,sccbase.jar" CODE="com.ibm.eNetwork.HOD.HostOnDemand.class" WIDTH=584
HEIGHT=450>
to:
<APPLET archive="hoddbg.jar,sccbase.jar" CODE="com.ibm.eNetwork.HOD.HostOnDemand.class" WIDTH=584
HEIGHT=450>
and add the following parameter to the applet tag:
<PARAM NAME=IPMonitor VALUE="[<option_tag=<option_value>,...]">
For example,
<PARAM NAME=IPMonitor VALUE="SessionName=My Session,TraceFile=c:\mydirectory\trace.trc">
adds the option Start Session with IPMonitor to the menu when you right click the icon for the session named "3270 to myhost" on the Z and I Emulator for Web desktop. Selecting this option starts the session and also starts IPMonitor. The trace file is saved to
c:\mydirectory\trace.trc
.
Enclose the string that follows VALUE= in quotes.
Without quotes, the HTML parser stops parsing the string as soon as it
reaches a space. This may cause some of the IPMonitor
settings you want to set to be discarded by the HTML parser. |
There is also a sample file, ipmon.html
that can show you how to use
this parameter. It is located in the x:\zieforweb\lib\samples\IPMonitor
directory.
Trace Option | Supported Values | Description |
---|---|---|
SessionName
|
Any session name available on the Z and I Emulator for Web desktop, spelled exactly as it appears in the session properties, and as it is displayed below the session icon. | Specifies the name of the session that you want to have started along with IPMonitor. If no session name is specified, IPMonitor can be run by all 3270 display, 5250 display, and VT display sessions defined for the Z and I Emulator for Web desktop you logged on to. |
TraceFile
|
Any valid file name. | Specifies the trace file name that the IPMonitor trace is saved to. If no file name is specified, IPMonitor saves the trace file to output.tlg in the path specified in the JVM system property "user.dir". |
When you select Start Session with IPMonitor from the session icon's start menu, the IPMonitor v1.0 for Java, automatic mode appears first, and then the session starts.
Related topics: