|
|
Home > Products > JET > JET 3270 > How To...
JET 3270 How To...
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.
Click
on a link below to learn "How To..."
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:
-
If
a JET 3270 window appears but no Untitled Session Settings dialog
box appears:
-
If
no JET 3270 window appears:
-
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.
Back
to top
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 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.
You can use either an existing session (to that host) or create a
new session:
-
If
you see a new JET 3270 window and a Session Settings dialog box,
you are creating (and opening) a new JET 3270 session.
For Hostname enter the name of the 3270 host. Also deselect
"Start Connection Automatically". Ensure any other
important session settings are also correct (e.g. port, security
details).
Click OK.
-
If
you see a row of buttons with the names "New Window",
"New Session", etc., click "New Window". You
will see a JET 3270 window and a Session Settings dialog box.
For Hostname enter the name of the 3270 host. Also deselect
"Start Connection Automatically". Ensure any other
important session settings are also correct (e.g. port, security
details).
Click OK.
If you don't see "New Window", but do see "New
Session", click that instead. You won't see a new JET 3270
window, but you will see a Session Settings dialog box. You can
then enter the host details as described above.
-
If
you see a dialog box titled "Open Session", select the
session for the 3270 host you are interested in, then click
"Open".
If none of the sessions apply to the host you are interested in,
click "Cancel". You should then see a row of buttons
as described in the previous option. Follow the instructions for
that option.
-
If
you see the JET 3270 screen painted inside either a new window
or your main browser window, then JET 3270 has already opened a
particular session. Ensure that the session is to the host in
which you are interested by clicking the Session
Settings toolbar icon, or selecting "Settings"
from the "Session" menu.
-
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
-
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.
You can use either an existing session (to that host) or create a
new session:
-
If
you see a new JET 3270 window and a Session Settings dialog box,
you are creating (and opening) a new JET 3270 session.
For Hostname enter the name of the 3270 host. Also deselect
"Start Connection Automatically". Ensure any other
important session settings are also correct (e.g. port, security
details).
Click OK.
-
If
you see a row of buttons with the names "New Window",
"New Session", etc., click "New Window". You
will see a JET 3270 window and a Session Settings dialog box.
For Hostname enter the name of the 3270 host. Also deselect
"Start Connection Automatically". Ensure any other
important session settings are also correct (e.g. port, security
details).
Click OK.
If you don't see "New Window", but do see "New
Session", click that instead. You won't see a new JET 3270
window, but you will see a Session Settings dialog box. You can
then enter the host details as described above.
-
If
you see a dialog box titled "Open Session", select the
session for the 3270 host you are interested in, then click
"Open".
If none of the sessions apply to the host you are interested in,
click "Cancel". You should then see a row of buttons
as described in the previous option. Follow the instructions for
that option.
-
If
you see the JET 3270 screen painted inside either a new window
or your main browser window, then JET 3270 has already opened a
particular session. Ensure that the session is to the host in
which you are interested by clicking the Session
Settings toolbar icon, or selecting "Settings"
from the "Session" menu.
-
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 start of the data
logged 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.
You can use either an existing session (to that host) or create a
new session:
-
If
you see a new JET 3270 window and a Session Settings dialog box,
you are creating (and opening) a new JET 3270 session.
For Hostname enter the name of the 3270 host. Also deselect
"Start Connection Automatically". Ensure any other
important session settings are also correct (e.g. port, security
details).
Click OK.
-
If
you see a row of buttons with the names "New Window",
"New Session", etc., click "New Window". You
will see a JET 3270 window and a Session Settings dialog box.
For Hostname enter the name of the 3270 host. Also deselect
"Start Connection Automatically". Ensure any other
important session settings are also correct (e.g. port, security
details).
Click OK.
If you don't see "New Window", but do see "New
Session", click that instead. You won't see a new JET 3270
window, but you will see a Session Settings dialog box. You can
then enter the host details as described above.
-
If
you see a dialog box titled "Open Session", select the
session for the 3270 host you are interested in, then click
"Open".
If none of the sessions apply to the host you are interested in,
click "Cancel". You should then see a row of buttons
as described in the previous option. Follow the instructions for
that option.
-
If
you see the JET 3270 screen painted inside either a new window
or your main browser window, then JET 3270 has already opened a
particular session. Ensure that the session is to the host in
which you are interested by clicking the Session
Settings toolbar icon, or selecting "Settings"
from the "Session" menu.
-
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.
Back
to top
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
Back
to top
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.
Back
to top
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.
Back
to top
Configuring your host for secure sessions
JET 3270 enables you to start secure, encrypted sessions in
the following client environments:
- Netscape Communicator 4.06 or later
- Microsoft Internet Explorer 4.01 SP1 or later with the
Enhanced (128 bit) RSA security provider. Recent changes to U.S. export
laws have enabled Microsoft to permit the distribution of their
high
encryption products worldwide.
You can not start secure connections in Netscape 6 or later.
To start secure sessions, you must also 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:
| _fontSecurity Level | _fontFMID |
|---|
| _fontLow | _fontJTCP35T |
| _fontMedium | _fontJTCP35L |
| _fontHigh | _fontJTCP35K |
See: IBM documentation for more information
- For V2R7, these are:
| _fontSecurity Level | _fontFMID |
|---|
| _fontLow | _fontJTCP373 |
| _fontMedium | _fontJTCP372 |
| _fontHigh | _fontJTCP37K |
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.
| _fontSecurity Level | _fontProduct ID |
|---|
| _fontLow | _font5769AC1 |
| _fontMedium | _font5769AC2 |
| _fontHigh | _font5769AC3 |
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)
|
