1. How do I Remove IBM Host
On-Demand Cached Client?
It immediately removes all previous
versions of the Cached Client.
What is the current version of Host
On-Demand that is available for testing
3. What browsers are
supported by Host On-Demand 12.0.2?
4. What client operating
systems are supported for Host On-Demand 12.0.2?
The following browsers are
supported for you to download the Host
On-Demand client from a remote Host
2-enabled browsers and Java 2 plug-ins:
Explorer 10, and 11
Java 2 plug-in installed.
2.0, 3.2.2, 6.0.3, and 6.0.4
Firefox 1.0, 2.0, 3.0, 3.5, 3.6, 4.x,
14.0.1, 17, 18
A Java-2 enabled browser requires a Java
Supported Java 2 plug-ins are:
Oracle Sun Java 8 Update 144
On 64-bit platforms, only 32 bit browsers
and 32-bit JRE's are supported by HOD.
5. Installing the
Oracle Sun JRE(Java Runtime Environment):
- Windows Server 2008 (Standard and
- Windows 2008 R2(Standard and Enterprise
- Windows 7 (Professional, Enterprise, and
- Windows 8 Pro 32 and 64 bit
- Windows 8 Enterprise 32 and 64 bit
- Windows 8 32 and 64 bit
- Windows 10
- AIX 5L 5.2, 5L 5.3, 6.1, 7.1
- Sun Solaris 8, 9, and 10
- Red Hat Enterprise Linux 3.0, 4.0, and 5.0
(WS, ES, and AS)*
- SuSE Linux Enterprise Server 8.0, 9.0,
10.0, and 11
- SuSE Linux Enterprise Desktop 8.2, 9.0,
8.0 Workstation and Server
- Citrix Metaframe 1.8 for Windows Terminal
Server 4.0 and 1.8 for
Windows 2000 Server
- Citrix Metaframe XP Presentation
for Windows Feature Release V2 and
- Citrix XenApp V5.0, V6.0
- Mac OS X 10.2.1 and 10.3, and 10.4
- Mac 10.7.5 with Safari 6.0.3
- Mac 10.8.3 with Safari 6.0.3
*(32-bit and 64-bit versions)
Go to the following web page: www.java.com
You have the recommended Java installed(Version
8 Update 144).
For a Windows platform,
Click Free Java Download
Click Agree and Start Free Java
Click Run on the File
Download Security Warning window.
Click Install on the Java
Setup Welcome window.
Uncheck the Yes,I want
Bing Toolbar for Internet Explorer ,then Next.
Click Close on the Java
Setup Complete window.
Click the Verify Java Version
button to verify that java has been
The following messages should be displayed:
Verified Java Version
6. How do you
start a HOD Host-Directed Print session?
- Select either of the
links for "HOD Host-Directed Print" on the
HOD home page(http://3270.its.state.nc.us):
Host-Directed Print(slow/modem ISP
Host-Directed Print(fast ISP connection)
- This brings you to a
screen with 4 icons.
The icons to use for TLS Host-Directed
Display for Printer"
- Right-click the "3270
TLS Printer" icon, then select "Properties".
- Click on the "Printer"
tab, of the "Properties" window.
Decide if you are going to use your default
Decide if you are going to use a "Printer
Click "OK" at the bottom of the "Properties"
window, to take you back to the screen with
the 4 icons.
- Double-click the "3270
TLS Display for Printer" icon, to start both
a 3270 TLS Display session and a 3270 TLS
- In the "3270 TLS
Printer" window, verify the Session is
"Connected" and the Device status is
Also verify the connection ID at the top of
the TLS Printer window:
ZNHTnnnn, where nnnn equals the same
for both the
Printer and Terminal sessions.
The ZNHPnnnn is the printer ID that you
assign, once you are
logged into your application.
7. What ports are used by
When configuring a
firewall to support Host On-Demand, you should
take into account:
- Port 80 (HTTP)
- Port 443 (HTTPS)
- Port 992 (3270 TLS
- Port 993 (3270 TLS
Printer and TLS Display for Printer)
- Ports 50000 to 50040,
inbound and outbound (TLS FTP)
- Port 21 (TLS FTP control
8. How do you use on-line
help in Host On-Demand?
Help is available
from all IBM Host On-Demand windows.
9. Is there any
other on-line documentation for Host
You can access help in these ways:
To return to the Host
On-Demand window or session, click Back,
or close the browser window in which Help
- Click Help in a window.
- Click Help on a host session menu bar.
See IBM Host On-Demand Knowledge
10. New features in Host On-Demand(HOD)
See IBM Host On-Demand
Version 12 Information Center:
click: What's new
Procedure for correcting a HOD Cached Client
download problem when the error message is:
Error: Downloaded file does not match
signature. MD5 of downloaded file is xxxxx
should be yyyyy
Remove the HOD cached client via the
See "#1" in the FAQ list.
If the users workstation has a Java
plug-in installed, Clear the Java plug-in
cache, from the Java icon in the Control
If using Internet Explorer(IE), clear the
IE browser cache: Tools > Internet
Options > Temporary Internet Files >
Delete Files.. Make sure you select
Delete all off-line content under
Temporary Internet Files.
the browser and access the HOD cached
client again. If the error occurs again,
continue with the following steps.
Make sure to remove all remnants of the
cached client. Use the Search/Find
utility. Search for the HODCC directory.
And any files named *.ccr*. Delete them
manually if necessary.
Restart the browser, and download the HOD
cached client again.
If none of the previous steps work, delete
the java plug-in completely
And reinstall it.
The HOD Java Web Start client allows users
to start HOD without a browser,
from the HOD Java Web Start icon(JWSHODN) on
the Windows Desktop, after it
is initially downloaded from a browser window.
Users can start a HOD session from Java Web
Start icon(JWSHODN). Closing a browser
does not end a HOD session. If the user
attempts to close the HOD desktop and there
are active sessions running, the user is
prompted to make sure he/she wants to close
all sessions. If so, the sessions are
terminated cleanly to prevent problems that
occur when there are sessions running in the
browser and the browser is abruptly closed.
Java Web Start requires a supported
java version installed on the users
The latest java can be downloaded at www.java.com.
Installing the HOD Java Web Start client
requires a browser, such as Internet
To install the HOD Java Web Start
client, perform the following steps:
Specify the full URL of the HOD HTML file
in your browser:
This URL will also be made available from
a link on HOD home page:
A pop-up window will ask if you want to
add a shortcut on the desktop and in the
start menu. Click YES
The Web Start client begins installing
immediately. A window shows the progress
of the installation. When the installation
completes, the installation code
immediately launches the HOD Web Start
client. The user does not have to restart
Launching the HOD Java Web Start client
after initial installation:
Launch the HOD Java Web Start client by
double-clicking the JWSHODN
icon on the Windows desktop.
** Do not rename the JWSHODN
icon on the Windows desktop. The
** will no longer work if HOD is updated.
remove the HOD Web Start client, complete
both of the following steps:
Double click the Java icon in the Windows
Control Panel, to open the Java Control
On the General tab, under Temporary
Internet Files, click View.
In the Java Cache Viewer window, select
Show: Applications, from the pull down
Click JWSHODN to highlight it.
Click the red X button on the toolbar, to
remove the JWSHODN application.
Launch HODRemove.html in your browser:
At the message, Do you want to remove all
Host On-Demand cached clients installed from
this server? Click OK.
This completes removing the HOD Web Start
Why does a Pop-up Blocker
interfere with running HOD?
HOD cached client and the HOD Web Start
client both display a pop-up Window,
requiring you to click OK, before the HOD
client download starts.
Pop-up Blocker software on
your workstation is enabled, the HOD client
download can not proceed.
you use a Windows XP SP2 workstation, with
the Internet Explorer browser, be sure
the Pop-up Blocker in Internet Explorer is
turned off, before downloading
the HOD cached client or the HOD Java Web
See the following link, for further
Other software that contains a Pop-up
Blocker that could interfere with
running HOD includes:
1.) I am trying to start a Host
On-Demand(HOD) session but I keep getting a
screen with the following message below the
connect to server/host scc.its.state.nc.us
and port 992.
If there is also a message
above the lower gray border, between the key
icons(PF1 - PF6) and
the black part of the HOD terminal window:
a COMM 657 or
MA? a --\--657
This is usually because you work
for a business whose computers are protected
by an internet firewall, and this
firewall does not allow an outbound telnet
connection on port
So, what can I do to get
my secure HOD session to connect ok?
Request that your firewall
Administrator open outbound telnet port 992 on
The above explanation also applies to
port 993 if you are attempting to start
a HOD Host-Directed Print session.
*** A Java issue(Java 6 Update 6)
causes a COMM 657 error. See FAQ#21
2.) I am trying to start a
Host On-Demand(HOD) session but I keep
blank black screen
with the following message below the screen:
certificate has expired(Comm 666)
There is also the message
above the lower gray border, between the key
(PF1 - PF6) and the black part of
the HOD terminal window:
MA? a COMM
666 or MA?
So, what can I do to get
my secure HOD session to connect ok?
A HOD user is attempting to
start a HOD 3270 session and has an incorrect
set on their Windows
Verify that the HOD user
has the correct system date on their Windows
double-clicking the time
on the Windows desktop,
to open the Date
and Time Properties window.
Verify the date is the
current date, especially the current year.
If the date is incorrect,
update the date to the correct date,
then start a HOD 3270
15. What to do when you
get the WarningSecurity window below, when
Click [_} Always trust content from
this publisher then click [Run].
For further info on what causes a Security
Warning message on starting HOD?
for the IBM HOD tech note.
16. When using HOD secure FTP to upload
a file from your workstation to the mainframe
server, how do you change the mainframe files
default record length
from 256 characters of data per record to 110
characters of data per record?
1) Start the HOD FTP session by
double-clicking the FTPTLS icon on the HOD
Enter your User ID and Password in the FTP
2) In the HOD FTPTLS window, find
the file in your local directory that you
to the mainframe, and click it to highlight
3) In the HOD FTPTLS window,
click Actions at the top of the window, then
Command, in the drop-down box.
4) In the Quote command window,
enter in upper-case: SITE LRECL=110
5) Click OK
6) Click the Send selected files
to Host button in the middle of the FTPTLS
right-click the selected file to display a
drop-down box and
Files to Host.
7) The file should then be
uploaded to the mainframe server in the
8) To verify the file format on
the mainframe, in the FTPTLS window, click in
Directory window to highlight it. Then
click View then
the drop-down box. Then click View then
the drop down box. In the Host
Directory Listing window,
find the file
and its attributes to verify the
17. When using HOD secure FTP to upload
a file from my workstation to the
mainframe server, the
following Host On-Demand window appears with
message: Error while
trying to send file to server. OK
18. What to do if the HOD Java Web
Start shortcut icon(JWSHODN) disappears after
more information of this message, open the
Status Bar History window
at the bottom of your
FTPTLS window by clicking the up-arrow to
of the blue lightening bolt
symbol. Scroll to the bottom of the
History messages then
scroll up to the first set of error messages.
The following error
messages will probably appear:
501 Invalid data
set name xxxxxxxxx. Use MVS Dsname
Error while trying
to send file to server.
conventions refers to the format
of the file name on the
File names are organized in a hierarchy whose
separated with dots.
For example: DEPT01.SYSTEM01.FILE01
Each level in the hierarchy
can be up to 8 characters long.
The total file name length
is a maximum of 44 characters including dots.
1) Click Start -> Setting
-> Control Panel -> double-click Java
2) Under the General Tab, and
under Temporary Internet Files, click View,
to open the
Java Cache Viewer window.
Applications" is the default view to display the
3) Right-click the "JWSHODN"
application, then select "Install Shortcuts", to
new desktop shortcut icon.
4) Click "Close" to shut down
the Java Cache Viewer.
5) Click "OK" to close the
Java Control Panel, then close the Control
19. What to do if the HOD Java Web
Start shortcut icon fails to be created.
This appears to be an issue with
the browser, Internet Explorer(IE) 9.
When clicking on the http link to
start the HOD Web Start client, an orange
pop-up window at the bottom of the
"Do you want to open or save
JWSHODN.jnlp from scc.its.state.nc.us?
If you click "Open", the HOD Web
Start client begins loading and then a pop-up
window titled, "Create Shortcut",
contains the error message: "Unable to create
a shortcut for JWSHODN." "OK"
After clicking "OK", the HOD Web
Start client completes loading but the shortcut
icon will not be created on the
A workaround for this issue is to
start the HOD Web Start client from the same
http address used previously. An
orange pop-up window at the bottom of the
window asks: Do you want to open or
save JWSHODN.jnlp from scc.its.state.nc.us?
If you click the down arrow next to
the "Save" button, and select "Save as", a
"Save As" pop-up window
opens. In the "Save As" window, click
"Desktop" on the
left side, then click the "Save"
button, and the HOD Web Start icon will be
created on the Windows desktop.