CWBPING - Test the connection to the server
Use this command from a console prompt to determine if an IBM® i connection can be successfully established, or to help determine the cause of a connection failure.
CWBPING checks of the status of the IBM i host servers. The name of the communications provider is shown, as well as the result of connecting to each of the host socket servers. To see detailed messages, use the (/v) verbose option.
Syntax
cwbping system [/v] [/pl:#]
[/al:#] [/serv:name] [/port:#] [/user:userid] [/password:password]
[/all]
Parameters
- system = name of the server
- /v = verbose output
- /pl:# = port mode (0 = Server services file, 1 = Local services
file, 2 = Standard port ) Note: If the /port:# is specified, the port mode is ignored.
- /al:# = address mode
- 0 = Always use gethostbyname
- 1 = Lookup after 1 hour
- 2 = Lookup after 1 day
- 3 = Lookup after 1 week
- 4 = Never use gethostbyname, use configured IP address
- 5 = Lookup once after each PC restart
Note: If the system name is specified as an IP Address, the address mode will be ignored. - /serv:name = name of the service to connect to (i.e. /serv:telnet
or /serv:ftp) Note: Any TCP/IP service name can be used. For example, see CWBCO1003 or you local services file.
- /port:# = port number to connect to in decimal (i.e. /port:23
or /port:21) Note: Any TCP/IP port number can be used. For example, see CWBCO1003 or your local services file.
- /user:userid = IBM i user ID to use only if the server requires security on startup
- /password:password = IBM i password to use only if the server requires security on startup
- /all = verify all possible servers, by default only common servers are verified.
Examples
To check the status of the IBM i host servers named System1 with address 198.51.100.34:
cwbping System1
Alternatively, you can check the status using the IP address:
cwbping 198.51.100.34 /v