Discovering systems

When you start the z/OSMF server, z/OSMF creates a system definition for the z/OSMF host system and for each system that belongs to the same JES2 multi-access spool (MAS) or JES3 complex as the host system. If you add new systems to that JES2 MAS or JES3 complex after starting the server, use the Discover action provided in the Systems table to automatically create system definitions for those systems.

About this task

To add system definitions for systems that belong to a different sysplex, JES2 MAS, or JES3 complex, or for application servers that host the server-side code for imported plug-ins, complete the steps provided in help topic Adding systems.

When z/OSMF discovers systems, z/OSMF retrieves the hostname or IP address from the system's network card. If your installation is using a networking technology, such as dynamic VIPA, that generates an alternative hostname or IP address, z/OSMF will not retrieve that alternate value. In this case, you must modify the URL in the system definition z/OSMF creates for the discovered system.

During the discovery process, conflicts can occur between the discovered systems and one or more existing systems. A conflict occurs when a discovered system has the same sysplex and system name as a system already defined in the Systems table, but one or more other system attributes differ. In this case, the conflicts must be resolved before the system can be added.

Procedure

To discover systems and resolve any conflicts, complete the following steps:

In the Systems table, select Discover from the Actions menu. This action is listed only if you are authorized to define new system definitions.
If no conflicts exist between the discovered systems and the existing system definitions, in the Discovered Systems window, complete the following steps:
1. Specify a unique nickname for each system, or accept the default nickname. For instructions on using an editable table, complete the steps provided in help topic Modifying the data in a table cell.
2. Click OK to add the system definitions to the Systems table.
If conflicts exist between the discovered systems and the existing system definitions, in the Discovered Systems wizard, complete the following steps:
1. On the Welcome page, review the list of systems that were discovered. Then, click Next.
2. On the Modify Nicknames page, specify a unique nickname for the system or accept the default nickname. Then, click Next. This page is displayed if at least one discovered system does not conflict with an existing system definition.
3. On the Resolve Conflicts page, select one of the following options to resolve the conflict:
  - Do not add the discovered system. Select this option if you do not want to add the system to the Systems table. Typically, you would select this option if you are planning to delete the system, if nothing is running on the system, or if you prefer to use an existing system definition.
  - Add discovered system, using a unique nickname to differentiate it from previously added systems. Select this option if the discovered system does not currently exist in the Systems table. Then, in the Nickname field, specify a unique nickname for the discovered system to differentiate it from existing systems that have the same system and sysplex name.
  - Update an existing system definition, and change its z/OS® Version and Release, JES Member Name, and JES Type to the value specified for the discovered system. Select this option if an existing system definition and a discovered system are defining the same system and the values in the existing system definition are outdated. Then, in the System to Update table, select the existing system definition so that its conflicting attributes can be changed to the values specified for the discovered system.
  A separate Resolve Conflicts page is provided for each discovered system that conflicts with one or more existing system definitions. After you provide a resolution for each conflict, click Next to proceed to the Summary page.
4. On the Summary page, review your selections. To make changes, click Back to return to the appropriate page. When complete, click Finish to perform the action listed in the Actions column.