lshost

Use the lshost command to view host systems that are added to the copy services management server.

Syntax

Read syntax diagramSkip visual syntax diagramlshost-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-rnumber-voffonIP_Address ...ZOS_NATIVE_CONNECTION -

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-s
Specifies that default information for each host system is displayed.
-l
Specifies that the following detailed information for each host system is displayed:
Column Label Details
Host System

If the IBM® z/OS® host system is the system on which the copy services management server is installed, ZOS_NATIVE_CONNECTION is shown in this column.

For AIX® and z/OS host systems that are connected by using an IP address or host name, the IP address or host name is shown.

Port The port number for the connection to the host system.
Type The type of host system. One of the following values is shown:
AIX
The host is an AIX system.
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 high availability (HA) environments that have an active and standby management server, the status of the connection between the remote 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 displays. This status might be because the HA configuration is disconnected or the status was not sent from the remote copy services management server.

Connection Message If connection to the host system failed, an error message is shown.
-fmt { default | xml | delim | stanza }
Specifies the format of the output. You can specify one of these values:
default
Specifies that the output is displayed in tabular format using spaces as delimiters between columns. This is the default value.
xml
Specifies that the output is displayed in XML format.
delim
Specifies that output is displayed in a tabular format using commas as delimiters between columns.
To use a character other than a comma as the delimiter, specify -fmt delim -delim char , where char represents the character that you want to use as the delimiter. For example, if you want to use a colon (:) as the delimiter, use the following -fmt parameter:
-fmt delim -delim :
If you use a shell metacharacter as the delimiting character, enclose the character in quotation marks or single quotation marks. A blank space is not a valid character.
stanza
Specifies that the output is displayed as one keyword-value pair per line.
-p { on | off }
Specifies whether to display one page of text at a time or all text at once.
on
Displays one page of text at a time. Pressing any key displays the next page. This is the default value when the command is run in interactive mode.
off
Displays all text at once. This is the default value when the command is run in single-shot mode.
-hdr { on | off }
Specifies whether to display the table header. You can specify one of these values:
on
Displays the table header. This is the default value.
off
Hides the table header.
-r number
Specifies the number of rows per page to display when the -p parameter is specified. You can specify a value of 1 - 100. The default value is 22.
-v { on | off }
Specifies whether to enable verbose mode. You can specify one of these values:
on
Enables verbose mode.
off
Disables verbose mode. This is the default value.
IP_Address | ZOS_NATIVE_CONNECTION | -
If you want to view specific host systems only, specifies the IP or host name for the host system or the value ZOS_NATIVE_CONNECTION.
If you want to list 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.

Example: Listing all host systems

The following command lists default information about all host systems that are added to the copy services management server.

csmcli> lshost 

The following output is returned:

Host System Port Type    Local Status
======================================================
192.0.2.0   9930 AIX     Connected    
192.0.2.1   9990 Unknown Disconnected 

Example: Listing detailed information for all host systems

The following command lists detailed information about the host system connections.

csmcli> lshost -l 

The following output is returned:

Host System Port Type   Local Status Remote Status Connection Message
=====================================================================
192.0.2.2   5858 ZOS_IP Connected    -             -

Example: Listing information for the native Z/OS host system

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

csmcli> lshost ZOS_NATIVE_CONNECTION 

The following output is returned:

Host System             Port Type       Local Status 
====================================================
ZOS_NATIVE_CONNECTION   5858 ZOS_NATIVE Connected