Troubleshooting
Problem
IBM i Access Client Solutions (ACS) has the ability to test connectivity to IBM i with the PING plugin. This is equivalent to the CWBPING utility that comes with IBM i Access for Windows.
Symptom
Need to test connectivity to the IBM i System for IBM i Access Client Solutions.
Cause
N/A
Environment
Linux, Windows, MAC
Diagnosing The Problem
N/A
Resolving The Problem
The CWBPING utility comes with all versions of Client Access including the latest called IBM i Access for Windows. This utility is used to test connectivity to the IBM i from Windows. It is better than just a ping (echo) request because it performs a three-way TCP/IP handshake with the server and disconnects from the server properly.
IBM i Access Client Solutions (ACS) is a multi-platform client, so the CWBPING utility is not included. The equivalent to the CWBPING utility is the PING plugin.
To use the PING plugin, you should do the following:
1. Open a command prompt (bash shell or terminal window on Linux or MAC).
2. Change directory to the location of the acsbundle.jar file or the appropriate binary included in the Start Programs folder for ACS.
Examples
Testing Host servers:
java -jar acsbundle.jar /plugin=ping /system=192.168.1.135
java -jar acsbundle.jar /plugin=ping /system=MySystemName
Testing Host servers that are SSL-enabled:
java -jar acsbundle.jar /plugin=ping /system=192.168.1.135 /ssl=1
The above examples use the Java -jar to execute acsbundle.jar directly. Normally, you do not need to do it that way. You should use one of the appropriate binaries included in the Start_Programs directory.
Example
acslaunch_win-32.exe /plugin=ping /system=MySystemName
Note: If the certificate is not installed when testing SSL, it will prompt you to install it automatically if a valid certificate exists.
Reference Information
The following information is included in Section 9.1.11 of the GettingStarted.txt file located in the Documentation directory included with the ACS client:
/PLUGIN=ping /SYSTEM=<system>
Options include the following:
| /SSL=<1/0> | Turn SSL on or off. |
| /ACCEPTALLCERTS=<1/0> | Whether or not to automatically add all SSL certificates to the trusted set (when using SSL). |
| /SERVERAUTH=<1/0> | Turn SSL Server authentication on or off (default is off). This option is disregarded if not testing SSL. |
| /GUI=<1/0> | Toggle GUI window on/off (default is off if launched from command-line). |
| /PORTS=<port1,port2> | A comma-separated list of ports to test. It can be numbers or service names (for example, /PORTS=as-signon, as-sts). If not specified, a default set of ports is tested. Specifying .CONSOLE will check a list of console specific ports. |
| /TIMEOUT=<seconds> | Specify a timeout value, in seconds. |
This plugin checks the connectivity to the IBM i by opening a connection to the
appropriate port. If verifying an SSL connection, an SSL handshake is attempted.
If it is launched from the main GUI, or invoked with /GUI=1, this plugin displays
a dialog. If launched from the command-line without /GUI=1, output is sent to
the console.
By default, the following services are checked:
o as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda
o as-signon
This function can be launched from the main GUI by the following:
o System Configurations
o Select a system and then Edit
o General tab
o Verify Connection
Was this topic helpful?
Document Information
Modified date:
18 December 2019
UID
nas8N1019883