showhost

Edit online

Use the showhost command to show information about host system connections server.

Syntax

Parameters

-help | -h | -?: Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-port port: Specifies the port to use to access the host system if other than the default port. If a port is not specified, the default port is 5858 for z/OS® and 9930 for AIX®.
IP_Address | ZOS_NATIVE_CONNECTION | -: Specifies the IP or host name for the host system or the value ZOS_NATIVE_CONNECTION.; If you want to show information for an AIX host system or a z/OS host system that is connected by using an IP address or host name, enter the IP address or host name for this parameter.; If the copy services management server is installed on the host system, enter ZOS_NATIVE_CONNECTION for this parameter.; Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The dash is supported only in single-shot mode.

The information that is listed for each host system depends on the host system type, as shown in the following tables:

AIX Host Systems

Column Label	Details
IP Address	The IP address or host name for the host system.
Port	The port number for the connection to the host system.
Type	The type of host system.
Local Status	The status of the connection between the copy services management server and the host system.
Remote Status	In high availability (HA) environments that have an active and standby management server, the status of the connection between the remote copy services management server and the host system. If you are running the lshost command on the active server, the remote server is the standby server. If you are running the command on the standby server, the remote server is the active server. If the status of a host connection at the remote copy services management server cannot be determined, `Unknown` is displayed. This status might be because the HA configuration is disconnected or the status was not sent from the remote copy services management server.
Sessions	The sessions that are associated with the host system. Sessions are shown only if the Open HyperSwap® feature is enabled for the session.

IBM® z/OS

Column Label	Details
IP Address	The IP address or host name for the host system.
Port	The port number for the connection to the host system.
Type	The type of host system. One of the following values is shown: ZOS_NATIVE The host is the z/OS system on which the copy services management server is installed. ZOS_IP The host is a z/OS system that is connected by using an IP address or host name.
Local Status	The status of the connection between the copy services management server and the host system.
Remote Status	In HA environments that have an active and standby management server, the status of the connection between the remote copy services management server and the host system. If you are running the lshost command on the active server, the remote server is the standby server. If you are running the command on the standby server, the remote server is the active server. If the status of a host connection at the remote copy services management server cannot be determined, `Unknown` is displayed. This status might be because the HA configuration is disconnected or the status was not sent from the remote copy services management server.
System Name	The name of the host system. If there is no connection to the host system, `Unknown` is displayed.
Sysplex Name	Shows the name of the sysplex that the host system is in, if applicable. If there is no connection to the host system, `Unknown` is displayed.
User Name	The user name for the host system. The user name is shown only if the host system is connected by using an IP address or host name.

Example: Showing the connection properties for an AIX host system

The following command lists the connection properties for an AIX host system that is connected by using the IP address 192.0.2.0.

csmcli> showhost 192.0.2.0

The following output is returned:

IP Address    192.0.2.0          
Port          9930         
Type          AIX          
Local Status  Disconnected 
Remote Status -            
Sessions      -

Example: Showing the connection properties for a z/OS host system that is connected by using an IP address

The following command lists the connection properties for z/OS host system that is connected by using the IP address 192.0.2.1.

csmcli> showhost 192.0.2.1

The following output is returned:

IP Address    192.0.2.1          
Port          5858                         
Type          ZOS_IP                       
Local Status  Connected                    
Remote Status -                            
System Name   SYSTEM1                      
Sysplex Name  SYSPLEX1                     
User Name     ABCUSER

Example: Showing the connection properties for a native z/OS host system

If the copy services management server is installed on the z/OS host system, the following command lists the connection properties for the host system.

csmcli> showhost ZOS_NATIVE_CONNECTION

The following output is returned:

IP Address    ZOS_NATIVE_CONNECTION           
Type          ZOS_NATIVE                       
Local Status  Connected                    
Remote Status -                            
System Name   SYSTEM2                      
Sysplex Name  SYSPLEX2