This page has instructions explaining how to perform some important
JET 3270 tasks.
The JET 3270
Documentation
has further information about installing, configuring and using JET
3270.
Creating, saving and using a local
session
Here is an example of how to create, save and use a new local session.
The example assumes that your workstation is connected to the
Internet so that JET 3270 can connect to the Library of Congress
TN3270 server at locis.loc.gov.
If your workstation is not connected to
the Internet but can access a local TN3270 server then you should be
able to get similar results by substituting the hostname of the local
TN3270 server where locis.loc.gov appears.
- Start JET 3270 from the original Shortcut.htm file.
Note: Another web page can be used to start JET 3270 for this
example if the web page does not have any applet parameters that start
with disable_ set to
yes.
- If JET 3270 is running within the browser window:
- Click the Close Session toolbar button (trash can/garbage bin icon).
- Click New Window.
A JET 3270 window and Untitled Session Settings dialog box
appear.
- If a JET 3270 window appears but no Untitled Session Settings
dialog box appears:
- From the Session menu select Close.
- Click New Window.
A JET 3270 window and Untitled Session Settings dialog box
appear.
- If no JET 3270 window appears:
- Click New Window.
A JET 3270 window and Untitled Session Settings dialog box
appear.
- Enter locis.loc.gov
for Hostname on the Untitled
Session Settings dialog box.
- Click Colours in the Category list.
The Colours panel is displayed with Cursor Colour selected.
- Click the Choose Colour button.
The Colour Selector dialog box appears.
- Select yellow from the list.
- Click OK on the Colour Selector dialog box.
The Colour Selector dialog box disappears. The Cursor Colour square
is yellow.
- Click Background Colour.
- Click the Choose Colour button.
- Select brown from the list.
- Click OK.
The Background Colour square is brown.
- Click Display in the Category list.
The Display panel is displayed.
- Select TimesRoman for Font.
- Select 12 for Font Size.
- Click OK on the Session Settings dialog box.
The Session Settings dialog box disappears. The background colour
and screen keyboard on the JET 3270 window
change. JET 3270 attempts to connect to the host.
- Select Save As... from the Session menu.
A Save Session As dialog box appears.
- Enter LibraryOfCongress for the session name.
- Click Save.
- Select Close from the Session menu.
The JET 3270 window disappears.
- Click the Open Session in New Window button.
An Open Session dialog box appears.
- Select LibraryOfCongress from the Local list.
- Click Open.
A JET 3270 window appears.
The background colour is brown and the
screen keyboard buttons are in a larger Times Roman font.
JET 3270 attempts to connect to
locis.loc.gov
. If it
connects successfully
the LOCIS main screen
is displayed with a
yellow cursor.
Starting a Debug Log
Here are instructions on how to make a debug log of a
JET 3270 session. The debug log is used to determine the
cause of a JET 3270 problem.
If you are collecting a debug log to provide to
Platypus Partners support, please ensure that you turn on debug logging
before connecting to the host. Sometimes the events leading up to a
problem are important in assisting our diagnosis.
Internet Explorer with Sun JVM under Windows
Start Internet Explorer.
Start JET 3270 by loading the Shortcut.htm web page
provided in the applet directory of the JET 3270
distribution, or the web page you use to run JET 3270.
Open a JET 3270 session for the 3270 host you are
having problems with.
If you are already connected or connecting to the host, click
the Disconnect from Remote
Host toolbar icon, or select "Disconnect" from the "Connection"
menu. Sometimes the events leading up to a
problem (and in particular, the negotiation exchange with the host
during connection) are important to assist us in resolving your
problem.
Select "Preferences" from the "Session" menu. If the JET
3270 screen is painted inside your main browser window, you
will not have a "Session" menu: instead click the Preferences toolbar
icon.
You will see a Preferences dialog box. Select "Debug" from the
Category list. Click "Enable Debug Logging" to place a tick in the
check box. You may also select to log to either the Java Console or
to a specific file that you select. These instructions assume that
you accept to log to the Java Console. Click OK.
Right-click the Java icon (the Java Steaming Coffee Cup log)
in the status area of the task bar (near the bottom right corner of the
screen). Select Show Console. The Java Console window will appear.
Click the Connect toolbar icon, or select "Connect" from the
"Connection" menu. You will see the host's login screen or a
similar host welcome screen.
Log on to your 3270 host and recreate the JET
3270 problem scenario you are experiencing.
After the problem you have identified has occurred, scroll to
the top of the Java Console. Drag the mouse from the top to the end.
Click the Copy button to copy the data to the clipboard.
Start Notepad (or a text editor). Paste the data
logged from the clipboard into the Notepad window. Save
the data to a file.
Netscape 6 or later
Start Netscape.
Select "Java Console" from the "Tools" submenu of the "Tasks"
The Java Console will appear.
Start JET 3270 by loading the Shortcut.htm web page
provided in the applet directory of the JET 3270
distribution. When you see the Java Security windows,
click on "Grant".
Open a JET 3270 session for the 3270 host you are
having problems with.
If you are already connected or connecting to the host, click
the Disconnect from Remote
Host toolbar icon, or select "Disconnect" from the "Connection"
menu. As mentioned above, sometimes the events leading up to a
problem (and in particular, the negotiation exchange with the host
during connection) are important to assist us in resolving your
problem.
Select "Preferences" from the "Session" menu. If the JET
3270 screen is painted inside your main browser window, you
will not have a "Session" menu: instead click the Preferences toolbar
icon.
You will see a Preferences dialog box. Select "Debug" from the
Category list. Click "Enable Debug Logging" to place a tick in the
check box. You may also select to log to either the Java Console or
to a specific file that you select. These instructions assume that
you accept to log to the Java Console. Click OK.
Click the Connect toolbar icon, or select "Connect" from the
"Connection" menu. You will see the host's login screen or a
similar host welcome screen.
Log on to your 3270 host system and recreate JET
3270 problem scenario you are experiencing. You will
see data flowing between JET 3270 and the host being
logged in the Java Console. If the Java Console becomes
full data will no longer be logged. If this happens,
press the "Clear" button on the Java Console so that
new data will continue to be logged.
After the problem you have identified has occurred,
click the Copy button the Java Console to copy the data to the
clipboard.
Start Notepad (or a text editor). Paste the data
logged from the clipboard into the Notepad window. Save
the data to a file.
Internet Explorer with Microsoft VM under Windows
Start Internet Explorer.
Enable
JavaTM
logging in Internet Explorer. To do this, from the Tools
menu (View menu for 4.01 SP1) select "Internet Options...".
On the "Advanced"
tab click the "Java logging enabled" check box to place
a tick there.
Start JET 3270 by loading the Shortcut.htm web page
provided in the applet directory of the JET 3270
distribution, or the web page you use to run JET 3270.
Open a JET 3270 session for the 3270 host you are
having problems with.
If you are already connected or connecting to the host, click
the Disconnect from Remote
Host toolbar icon, or select "Disconnect" from the "Connection"
menu. As mentioned above, sometimes the events leading up to a
problem (and in particular, the negotiation exchange with the host
during connection) are important to assist us in resolving your
problem.
Select "Preferences" from the "Session" menu. If the JET
3270 screen is painted inside your main browser window, you
will not have a "Session" menu: instead click the Preferences toolbar
icon.
You will see a Preferences dialog box. Select "Debug" from the
Category list. Click "Enable Debug Logging" to place a tick in the
check box. You may also select to log to either the Java Console or
to a specific file that you select. These instructions assume that
you accept to log to the Java Console. Click OK.
Click the Connect toolbar icon, or select "Connect" from the
"Connection" menu. You will see the host's login screen or a
similar host welcome screen.
Log on to your 3270 host system and recreate the JET
3270 problem scenario you are experiencing.
After the problem you have identified has occurred, click the
Disconnect from Remote Host toolbar icon, or select "Disconnect"
from the "Connection" menu.
Internet Explorer writes the Java log to javalog.txt.
For Windows 98 it is in C:\windows\java
For Windows NT it is in C:\winnt\java
Using Windows Explorer or the MS-DOS Prompt make a copy
of the javalog.txt file. (Some programs do not read the
log correctly from the original javalog.txt file,
making a copy avoids this problem.)
Netscape Communicator with Netscape JVM
Start Communicator.
Select "Java Console" from the "Tools" submenu of the "Communicator"
menu (it may be on the "Communicator" menu itself). Communicator's
Java Console will appear.
Start JET 3270 by loading the Shortcut.htm web page
provided in the applet directory of the JET 3270
distribution. When you see the Java Security windows,
click on "Grant".
Open a JET 3270 session for the 3270 host you are
having problems with.
If you are already connected or connecting to the host, click
the Disconnect from Remote
Host toolbar icon, or select "Disconnect" from the "Connection"
menu. As mentioned above, sometimes the events leading up to a
problem (and in particular, the negotiation exchange with the host
during connection) are important to assist us in resolving your
problem.
Select "Preferences" from the "Session" menu. If the JET
3270 screen is painted inside your main browser window, you
will not have a "Session" menu: instead click the Preferences toolbar
icon.
You will see a Preferences dialog box. Select "Debug" from the
Category list. Click "Enable Debug Logging" to place a tick in the
check box. You may also select to log to either the Java Console or
to a specific file that you select. These instructions assume that
you accept to log to the Java Console. Click OK.
Click the Connect toolbar icon, or select "Connect" from the
"Connection" menu. You will see the host's login screen or a
similar host welcome screen.
Log on to your 3270 host system and recreate JET
3270 problem scenario you are experiencing. You will
see data flowing between JET 3270 and the host being
logged in the Java Console. If the Java Console becomes
full data will no longer be logged. If this happens,
press the "Clear" button on the Java Console so that
new data will continue to be logged.
After the problem you have identified has occurred,
scroll up to the top of the Java Console. Drag the
mouse from the top to the end. Press Ctrl-C to copy the data to the
clipboard.
Start Notepad (or a text editor). Paste the data
logged from the clipboard into the Notepad window. Save
the data to a file.
Internet Explorer under Mac OS X
Start Console. This application is part of Mac OS X, it is in the
Utilities folder of the Applications folder.
Start Internet Explorer.
Start JET 3270 by loading the Shortcut.htm web page
provided in the applet directory of the JET 3270
distribution, or the web page you use to run JET 3270.
Open a JET 3270 session for the 3270 host you are
having problems with.
If you are already connected or connecting to the host, click
the Disconnect from Remote
Host toolbar icon, or select "Disconnect" from the "Connection"
menu. As mentioned above, sometimes the events leading up to a
problem (and in particular, the negotiation exchange with the host
during connection) are important to assist us in resolving your
problem.
Select "Preferences" from the "Session" menu. If the JET
3270 screen is painted inside your main browser window, you
will not have a "Session" menu: instead click the Preferences toolbar
icon.
You will see a Preferences dialog box. Select "Debug" from the
Category list. Click "Enable Debug Logging" to place a tick in the
check box. You may also select to log to either the Java Console or
to a specific file that you select. These instructions assume that
you accept to log to the Java Console. Click OK.
Click the Connect toolbar icon, or select "Connect" from the
"Connection" menu. You will see the host's login screen or a
similar host welcome screen.
Log on to your 3270 host system and recreate the JET
3270 problem scenario you are experiencing. You will see
data flowing between JET 3270 and the host being logged in
the console.log window of Console.
After the problem you have identified has occurred, select
the console.log window of Console. Select "Select All" from the
Edit menu. Select Copy from the Edit menu to copy the data to the
clipboard.
Start TextEdit. Paste the data logged from the clipboard into the
TextEdit window. Add a line at the end of the data saying "-- Java
Console.log --".
Select the "Java Console.log" window of Console. Select "Select
All" then Copy from the Edit menu.
Paste the data into the TextEdit window below the data from
console.log. Save the data to a file.
Please create an email message, attach the log file,
and send it to us at:
jetsupport@platypuspartners.com
You will receive confirmation that your JET 3270
problem is in our support queue, problem status updates,
and a fix (if necessary) when ready.
Configuring to automatically open a
web session
You can make JET 3270 automatically open a web session in a new window
the first time it runs on a client. To do this set the applet
parameters in the page used to load JET 3270 as follows:
| Name |
Value |
| last_web_session |
0 |
| startup_operation |
open_session_new_window |
| startup_session |
session_name |
| web_session_name_0 |
session_name |
| web_session_url_0 |
url |
For session_name use the name you choose. For
url use the fully
qualified URL pointing to the web session on your web server. For
example, if the web server's name is intranet.acme.com and the web
session file is called Accounts in the jet/session subdirectory of
the web server's document directory then the URL might be:
http://intranet.acme.com/jet/session/Accounts
Users can change their preferences so that the web session is not
opened in a new window when JET 3270 subsequently runs on their
client. To change the preferences back to automatically opening a web
session in a new window users can follow these steps:
- Select Preferences from the Session menu
- Select Startup from the Category list
- Select Open Session in New Window for Startup Operation
- Click OK
Configuring the LU resource for host
print
Here are instructions on how to configure the LU resource name.
- Start JET 3270 by loading the Shortcut.htm file distributed with the
release.
- Click the New Window button.
- On the Session Settings dialog box, enter the host name and port number.
- Select Telnet Options in the Category list.
- For LU Resource Name, enter the LU pool or LU name defined to the IBM
host. You may need to talk with your IBM system administrator to find
out the name of an LU pool or LU name that you can use that has the
attributes you desire (e.g. being able to dynamically associate a
printer session with it).
- Click Apply then Close.
- Select Connect from the Connection menu.
Creating and using a logon script
Here is an example of a simple logon script.
The example requires that your workstation is connected to the
Internet so that JET 3270 can connect to the Library of Congress
TN3270 server at locis.loc.gov.
- Using a text editor, create a file named "scriptloc.txt" with the
following contents:
# Script to search for "platypus" in the LOC catalogue
waitfor "Choice:"
send "1[enter]"
send "3[enter]"
send "b platypus[enter]"
- Start JET 3270 from the original Shortcut.htm file
- If JET 3270 is running within the browser window:
- Click the Close Session toolbar button (trash can/garbage bin icon).
- If a JET 3270 window appears:
- From the Session menu select Close.
- Click New Window.
A JET 3270 window and Untitled Session Settings dialog box
appear.
- Enter locis.loc.gov for Hostname.
- Click Logon in the Category list.
- Click Choose File...
The Logon Script dialog box appears.
- Navigate to and select the scriptloc.txt file.
- Click Open or OK.
The Logon Script File dialog box disappears. The Logon Script URL
textfield has the file: URL for scriptloc.txt.
- Click Apply then Close
The Untitled Session Settings dialog box disappears.
- Select Connect from the Conneciton menu.
JET 3270 connects to the Library of Congress host. The Stop
Script toolbar button is enabled. JET 3270 navigates to
the book search prompt and searches for "platypus". The Stop
Script toolbar button is disabled.
To exit the Library of Congress host:
- Type "exit", press Enter.
- Type "12", press Enter.
- Type "12", press Enter.
Enabling Host Printing to Local Printers
Here are instructions on how to configure JET 3270 to start
an Associated Printer session.
- Start JET 3270 by loading the Shortcut.htm file distributed with the
release.
- Click the New Window button.
- On the Session Settings dialog box, enter the host name and port number.
- Select Print in the Category list.
- Ensure that the "Enable Host Printing to Local Printers" checkbox is
selected. Note that you may also need to set the "LU Resource"
attribute depending on your host configuration. You should talk with
your IBM system administrator to find out the name of an LU pool or LU
device name that you can use with which a dynamically associated
printer can be assigned.
- Click Apply then Close.
- Select Connect from the Connection menu.
Configuring your host for secure
sessions
JET 3270 enables you to start secure, encrypted sessions.
To start secure sessions, you must correctly install and
configure a suitable SSL-enabled TN3270 server on your host. This can
be any TN3270 server that specifically supports the SSL and/or TLS
protocols. Products known and tested with JET 3270 are:
- On S/390 systems, Communications Server for OS/390 V2R6 or later.
- On AS/400 systems, OS/400 V4R4 or later.
The following is a starting point for installing and configuring
your host system for secure sessions. However, you should ensure that
you follow the documentation for your particular SSL-enabled TN3270
server.
Server Certificate
You must define a server certificate to your SSL-enabled host
TN3270 server. The subject name of the certificate must match the IP
host name of your host. This is an important requirement to enable the
SSL protocol to detect what is termed "man-in-the-middle" attack -
whereby a computer could be inserted between the client and the
host. We strongly advise that you use the fully qualified domain name
to enable clients from anywhere in your organisation (or perhaps
outside of your organisation) to correctly match the name of the
certificate subject against the name of the host to which they are
connected.
You can use either a certificate issued by a trusted Certificate
Authority (e.g. Thawte, Verisign), or a self-signed certificate. To
obtain a certificate from a trusted Certificate Authority, you must
make an application to one of the Certificate Authorities. After they
have verified your identity, they will issue you with the
certificate. It is advisable to only use self-signed certificates for
testing. This is because each client that accesses the host must have
the self-signed certificate installed in their browser as a "trusted"
certificate. This is not necessary for certificates signed by a
trusted Certificate Authority. Most SSL-enabled TN3270 servers
normally provide their own method for creating self-signed
certificates.
Important Note: If you are using
Communications Server for OS/390 on your IBM host, V2R8 or earlier,
the IBM Key Manager (IKEYMAN) software contains a defect whereby you
will not be able to successfully use a Verisign "Global Site"
Certificate. This is because these certificates are signed by an
intermediate CA certificate, which is in turn signed by a trusted root
certificate. The IKEYMAN defect results in Communications Server for
OS/390 not sending the intermediate CA certificate during SSL
negotiations. However, the intermediate CA certificate's presence is
required for the end-user's client to be able to verify your global
certificate. Our recommendation is to use a Verisign "Secure Site"
certificate until IBM rectify this problem.
S/390 - Installing and configuring for Communications Server for OS/390
Required Software:
- Communications Server for OS/390 (provides the TN3270 Server software)
- In addition, one of the optional security modules must be installed.
If you are supporting JET 3270 clients running under
Microsoft Internet Explorer, only the high level security
module is supported: You must install the high level security
module. If your JET 3270 clients are only running under
Netscape Communicator, high, medium and low security
configurations on the host are supported.
- For V2R6, these are:
| Security Level | FMID |
|---|
| Low | JTCP35T |
| Medium | JTCP35L |
| High | JTCP35K |
See: IBM documentation for more information
- For V2R7, these are:
| Security Level | FMID |
|---|
| Low | JTCP373 |
| Medium | JTCP372 |
| High | JTCP37K |
See: IBM documentation for more information
- For V2R8, these are:
- SecureWay Communications Server Security Level 1
- SecureWay Communications Server Security Level 2
- SecureWay Communications Server Security Level 3
See: IBM documentation for more information
If you have obtained, or are thinking about obtaining, a Verisign
"Global Site" certificate, read the Important
Note regarding IBM's IKEYMAN software.
In your Communication Server PROFILE data set, add a TELNETPARMS block
which includes a SECUREPORT statement.
For example:
TELNETPARMS
SECUREPORT 992 KEYRING MVS TCPCS.KEYRING
ENDTELNETPARMS
Where TCPCS.KEYRING is the name of a file containing a set of
certificates, one of which is your server certificate.
See: IBM documentation for more information.
AS/400 - Installing and configuring for OS/400
The minimum required OS/400 level is V4R4. The required software to install is:
- 5769SS1 Option 34 (Digital Certificate Manager)
- and one of the security levels for the Cryptographic Access Provider.
If you are supporting JET 3270 clients running under
Microsoft Internet Explorer, only the high level security
module is supported: You must install the high level security
module. If your JET 3270 clients are only running under
Netscape Communicator, high, medium and low security
configurations on the host are supported.
| Security Level | Product ID |
|---|
| Low | 5769AC1 |
| Medium | 5769AC2 |
| High | 5769AC3 |
You must use the Digital Certificate Manager to add a System
(Server) Certificate. If you wish to create a self-signed System
Certificate, you must also add a Certificate Authority for testing
purposes. When the System Certificate is created, select Telnet Server
as one of the applications to which to assign the certificate.
Perform:
ENDTCPSVR (to stop the currently running Telnet Server)
STRTCPSVR (to re-start the Telnet Server)
NETSTAT OPTION(*CNN) (to check if the Telnet Server is now listening
on port 992)
