When you install DataGate for the IBM i you select a TCP/IP port over which DataGate connects to the IBM i. DataGate’s default port is 5042 but you may have changed that at installation. See this article if you need to know what TCP/IP port your DataGate instance uses.

A common problem with DataGate for IBM i connectivity is for its TCP/IP port to be blocked or otherwise not available at runtime. While you can use ping to check the IP connection to the server you cannot use \\ping check whether the DataGate port is available. You need to use telnet` to confirm that connectivity through a specific TCP/IP port is available.

This article shows how to use both ping and telnet to confirm DataGate connectivity.

Step 1. Confirm Telnet is enabled on your Windows installation

Ping is installed by default on Windows 10. A Telnet client ships with Windows 10 but may not be installed. To confirm telnet is installed:

Open "Programs and Features" from the Windows Control Panel.

downloads/images/km7Xbo4XWv.png

From "Programs and Features" click the "Turn Windows features on or off" link to display the dialog below.

downloads/images/OptionalFeatures_ywNdSOx8dm.png

From the "Windows Features" dialog make sure the "Telnet Client" is checked. If it is not, click it before clicking OK; otherwise just click OK.

Step 2. Use ping to prove IP connectivity

Press Windows Key + R to show the Run dialog. Type cmd and click OK to open a DOS command box.

downloads/images/explorer_Hn28MgQWcq.png

in the resulting DOS box, type

If ping is successful, your IP connection is open and working and is shown as such as in the image below.

downloads/images/cmd_JvNoDbT8dD.png

If ping fails you’ll see at least one Request timed out. message. If you get this error, you’ll need to check your IP address or computer name, and maybe have your network administrators help you.

Don’t continue with Step 3. until ping succeeds.

Step 3. Use telent to prove the TCP/IP port is open

Step A. Make sure your instance of DataGate for the IBM i has been started on the IBM i.

See this article for how to confirm ASNA DataGate is running on your IBM i.

Step B. Use the Windows telnet client to confirm the port is open

Press Windows Key + R to show the Run dialog. Type cmd and click OK to open a DOS command box.

downloads/images/explorer_Hn28MgQWcq.png

in the resulting DOS box, type

If the telnet connection succeeded the DOS box simply goes blank (usually all black–depending on your color scheme.) A blank DOS box indicates success–no text of any kind is displayed when the TCP/IP port is available.

If the telnet connection failed the DOS box displays a message as shown below:

If you get this message, before you assume the port is not working, go back to Step 3A and make sure your instance of DataGate for the IBM i has been started on the IBM i and then try the telnet test again.

If you’re sure your instance of DataGate for IBM is running and you get this telnet error, the TCP/IP isn’t opened. You’ll need to get with your network administrator and check firewall settings and anything else that may be blocking your TCP/IP port.

Other helpful DataGate for IBM i articles.