JET 3270 Documentation
JET 3270 2.4E  
 
Table of Contents
Previous
Next

Configuration

Creating a web page which will load JET 3270

The portion of JET 3270 which runs inside the user's web browser is known as a JavaTM applet. The applet is a set of class files. Class files are the compiled Java code. These class files are provided with the JET 3270 distribution as a "Cabinet" file (JET32704.cab) and as JAR archives (JET3270E.jar and JET3270J.jar). The cabinet files are used by Microsoft Internet Explorer and the JAR archives are used by Netscape Communicator (JET3270E.jar) and Java Compatible browswers (JET3270J.jar).

To include a JET 3270 applet in a web page, the web page needs to include an <APPLET> tag that specifies CODE=JET3270.class. In addition you need to specify ARCHIVE=JET3270E.jar or ARCHIVE=JET3270J.jar - depending on the intended browser - and specify a "cabbase" parameter set to "JET32704.cab" (see below for an example). If the intended browser is Netscape Communicator use JET3270E.jar and if it is a Java Compatible browswer use JET3270J.jar.

The applet also needs a space on the screen into which it can draw. This is specified by the WIDTH= and HEIGHT= attributes of the <APPLET> tag. A simple HTML web page example follows:

<HTML>
<TITLE>JET 3270 example</TITLE>
<APPLET CODE=JET3270.class ARCHIVE=JET3270E.jar WIDTH=300 HEIGHT=20>
<PARAM NAME="cabbase" VALUE="JET32704.cab">

Your Web Browser is not currently Java-enabled.

</APPLET>

</HTML>

Note that the text "Your Web Browser..." will only appear in browsers that are not Java-enabled, or which have their Java support currently disabled. A user must have a Java-enabled web browser such as Microsoft's Internet Explorer 5 or Netscape Communicator 4.5 and must have support for Java programs currently turned on.

There are several web page editors that will allow you to insert a reference to an applet without the web page designer being aware of the HTML commands that the editor generates. It is equally valid for the web page designer to use such an editor so long as the CODE, ARCHIVE, WIDTH and HEIGHT attributes and the "cabbase" parameter are set correctly. Note also that class file names are case sensitive.

Although there are many other class files for the JET 3270 applet stored in the JET32704.cab, JET3270E.jar and JET3270J.jar files, the web page designer need not specify these in the <APPLET> tag. The web browser will automatically identify the other class files that the JET 3270 applet needs.

When the web browser receives the <APPLET> tag, it automatically requests that the web server transfer the appropriate cabinet file (in this case JET32704.cab) or JAR archive (in this case JET3270E.jar or JET3270J.jar), and begins executing JET 3270.

Applets can be "configured" by including parameters embedded in the <APPLET> tag. The web page designer can include parameters using <PARAM> tags. Refer to Applet Parameters for more information.

Applet parameters

Preferences are organised into a number of groups. For each group the preferences can come from either those the user selects on the Change Preference Set window or the web page used to load JET 3270. Preferences coming from the web page are applet parameters.

Applet parameters are specified with <PARAM> tags enclosed by the <APPLET> and </APPLET> tags. An example of an <APPLET> tag which loads JET 3270 and supplies two parameters, port and cursor_type, is:

<APPLET CODE=JET3270.class ARCHIVE=JET3270E.jar WIDTH=300 HEIGHT=40>
<PARAM NAME="cabbase" VALUE="JET32704.cab">
<PARAM NAME="port" VALUE="5000">
<PARAM NAME="cursor_type" VALUE="underline_no_blink">

Your Web Browser is not currently Java-enabled.

</APPLET>

Use the following <PARAM> tags to specify JET 3270 preferences:

NAME VALUE type Default Value Description
alarm_audio File name bell.au Audio clip file that JET 3270 plays when it sounds an alarm
audio_enabled yes, no yes Whether JET 3270 attempts to sound any alarms
auto_scale_font yes, no no Whether JET 3270 automatically chooses the largest font that can completely fit a full screen within the window size given to JET
auto_scale_print_font yes, no yes Whether JET 3270 automatically chooses the font size used for printing screen images
background_colour Colour black Colour of main terminal screen background
charset One of:
--IBM037
--IBM273
--IBM277
--IBM278
IBM037 IBM code page used to interpret data received from TN3270 server
cursor_colour Colour white Colour of cursor
cursor_type One of:
--underline_no_blink
--underline_blink
--block_no_blink
--block_blink
block_no_blink Type of cursor display in normal mode
cache_logon_script yes, no no Use the browser's cache when loading the logon script
colour0 Colour black Colour with 3270 colour identification X'F0'
colour1 Colour blue Colour with 3270 colour identification X'F1'
colour2 Colour red Colour with 3270 colour identification X'F2'
colour3 Colour pink Colour with 3270 colour identification X'F3'
colour4 Colour green Default colour and colour with 3270 colour identification X'F4'
colour5 Colour cyan Colour with 3270 colour identification X'F5'
colour6 Colour yellow Colour with 3270 colour identification X'F6'
colour7 Colour white Colour with 3270 colour identification X'F7'
debug yes, no no Provide debugging & tracing information
default_colour Colour green Colour of text with default foreground colour in normal intensity fields in extended colour mode
default_intensified_colour Colour white Colour of text with default foreground colour in intensified fields in extended colour mode
disable_connect yes, no no Disable the user's ability to specify a host to connect to.
disable_new_window yes, no no Disable the user's ability to create new JET 3270 windows.
help_source One of:
--code_base
--platypus
--custom
code_base Location from which help files are loaded
help_custom_url HTTP URL (no default) URL of location from which help files are loaded if "help_source" is "custom".
host free text (host name or IP address) Web server from which JET 3270 was loaded Default host name to which JET 3270 will connect
insert_cursor_type One of:
--underline_no_blink
--underline_blink
--block_no_blink
--block_blink
underline_no_blink Type of cursor display in insert mode.
intensified_protected_colour Colour white Colour of text in intensitfied, protected fields in base colour mode
intensified_unprotected_colour Colour red Colour of text in intensified, unprotected fields in base colour mode
key_activity_timeout Integer 0 Minutes JET 3270 waits before disconnecting due to no key activity.
key_for_3270_key_name Text, space separated list of Input Events See Default Keyboard Mapping for defaults List of Input Events that map to the 3270 key
lu_resource Text (empty) LU resource name requested when JET 3270 connects
last_script_key Integer 0 Index of the last script_key_n applet parameter
logon_script_url URL or empty (empty) URL of script which is run immediately after connecting
port Integer 23 TCP/IP port number of TN3270 server program
print_font Font Monospaced-plain-9 or Courier-plain-9 The name, style and point size of the font used when printing screen images when auto_scale_print is no
prompt_host yes, no yes Whether JET 3270 when automatically initiating a connection prompts the user to enter a hostname and port.
normal_protected_colour Colour blue Colour of text in normal intensity, protected fields in base colour mode
normal_unprotected_colour Colour green Colour of text in normal intensity, unprotected fields in base colour mode
screen_font Font Monospaced-plain-12 or Courier-plain-12 The style and point size of the font used on the terminal screen.
screen_keyboard One of:
--all
--misc
misc Which keys are in the screen keyboard
screen_keyboard_font Font SansSerif-plain-8 The font name, style and piont size of the font used on the screen keyboard
script_key_n Text, space seperated URL and list of input events (no default) URL of a script and a list of the input events that map to it
selection_colour Colour lightGray Colour for selected text during copy and cut operations
show_keyboard yes, no yes Whether JET 3270 shows the on-screen keyboard
show_statusbar yes, no yes Whether JET 3270 shows the status bar
show_toolbar yes, no yes Whether JET 3270 shows the toolbar
start_connection yes, no yes Whether JET 3270 will automatically initiate a connection to the host when it first starts and when a new terminal window is created.
start_new_window yes, no yes Whether JET 3270 will automatically create a new terminal emulator window when it first starts.
terminal_type One of:
--IBM-3278-2-E
--IBM-3278-3-E
--IBM-3278-4-E
--IBM-3278-5-E
IBM-3278-2-E Preferred terminal type
toolbar_size One of:
--small
--large
small Toolbar icon size

For information regarding allowed values for parameters that require colour values, refer to Colour Values.

If a parameter name is not specified correctly, or its value is invalid, JET 3270 uses the default value for that parameter.

Table of Contents | Previous | Next
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.