Setting Up CA GMI › Define a z/OS Host

Define a z/OS Host

After starting the Windows Client you need to connect the Windows Client to the z/OS server component. In order to connect the Windows Client to the z/OS server component, you must first define the z/OS server or servers that you plan to use. The Windows Client Host List feature is used to define z/OS server connections.

You can define as many z/OS servers as you want and you can simultaneously connect to as many z/OS servers as you want (as long you have installed and configured the z/OS server component on them).

To define a z/OS host

Note: The following procedure assumes you have started the Windows Client and the Host List dialog is not displayed. If the Host List dialog is already displayed then you can skip step 1.

1. Click the Host List icon () in the Windows Client Toolbar.

   The Host List dialog appears as shown in the following sample.

   

2. Click the New Host icon () in the Host List dialog.

   The Host Definition dialog appears as shown in the following sample.

   

3. Complete the Host Definition dialog, the field options are:

   Host

   Provides the Host Name displayed in the Host List dialog.

   Agent Name

   Provides the name of the agent that collects data from the host. Select z/OS if it is not already displayed.

   IP Address

   Defines the IP address or server name of the z/OS host to which you are connecting.

   Port Number

   Defines the port number of the z/OS host to which you are connecting.

   User ID

   (Optional) Provides the user ID, which is sent to the host in encrypted form. If you do not specify a user ID then you must enter it every time you try to connect the Windows Client to the z/OS host.

   Password

   (Optional) Provides the password, which is sent to the host in encrypted form. If you do not specify a password then you must enter it every time you try to connect the Windows Client to the z/OS host.

   Note: You also have the option of providing the z/OS host user ID and not the password when setting up your Host Definition; this is often done at sites where security policies require Passwords to be changed periodically.

   Confirmation

   Confirms the password, if you provide a password then you must provide the same password in the confirmation field.

   Host Trace

   (Optional) Creates a trace on the host of all the messages exchanged between the z/OS host and the Windows Client. For more information about this field click the Help icon.

   PC Communication Trace

   (Optional) Indicates if the system should save the messages relating to host-client communication in a log file. For more information about this field click the Help icon.

4. Click Test to test your connection information.

   The Windows Client advises you if your connection to the z/OS host is successful.

5. Click Save.

   The Windows Client stores the host definition. The new host definition appears in the Host List dialog. The Host List dialog displays all your defined hosts and their connection status.

   The following is a sample of the Host List dialog showing the different connection status icons.