Selecting a system

Some z/OSMF tasks prompt you to select the system to be used for a particular operation. In which case, you may be given the option to select the system from a pull-down menu or to select it from the Systems table. In the latter case, the Select System page is displayed. Use the Select System page to select the system definition that specifies the settings required for z/OSMF to access the system. You can select only one system definition.

The Systems table lists the system definitions that are defined to z/OSMF. For a description of the columns or actions, see Columns in the Systems table or Actions for systems.

For more information about systems, see the following help topics:

Columns in the Systems table

Table 1. Columns in the Systems table
Column Description
Nickname Unique name assigned to the system definition.
Sysplex Name of the sysplex where the z/OS® system is a member. The name is the value specified for the SYSPLEX parameter of the cross-system coupling facility (XCF) couple data set format utility.
System Name Name specified for the system on the SYSNAME parameter in the IEASYSxx parmlib member.
Description Additional information about the system or group.
Groups Comma-separated list of the groups to which the system is assigned.
URL URL used to access the z/OSMF instance that resides in the same sysplex as the system identified in the System Name column. Or, the URL used to access the application server that is hosting the server-side code for imported plug-ins that are not hosted on the z/OSMF server.
z/OS Version and Release Version and release of the z/OS image installed on the system. The version and release has the format z/OS VxxRyy where V stands for version, xx is the version number, R stands for release, and yy is the release number. For example, z/OS V2R1.
JES Member Name JES2 multi-access spool (MAS) member name or JES3 complex member name that is assigned to the primary job entry subsystem (JES) that is running on the system.
JES Type Type for the primary job entry subsystem running on the system. The type is either JES2 or JES3.
CPC Name Name specified for the central processor complex (CPC) at the support element (SE) of that processor complex.
CPC Serial Serial number of the CPC.
FTP Server Name of the server definition that specifies the settings required to access the FTP or SFTP server that is running on the system.
HTTP Proxy Name of the HTTP proxy definition that specifies the settings required to access the system through an HTTP or SOCKS proxy server.
Activity State of the system definition. If the system definition is being modified, the lock icon and the Being modified link are displayed. Otherwise, this column is blank.

To view the user ID of the user who is modifying the system definition and the date and time the user started modifying it, click the icon or link. To obtain the lock for the system definition, complete the steps provided in help topic Locking objects in z/OSMF.

Single Sign-on Status Indicator of whether the system is enabled for single sign-on (SSO). The status can be one of the following values:
  • Enabled: The system is the primary z/OSMF instance.
  • Enabled with sysplex-name.system-name: The Lightweight Third Party Authentication (LTPA) key is synchronized with the key being used by the specified system (sysplex-name.system-name). The key might not be activated. To activate the key, restart the z/OSMF server on the system identified in the Nickname column.
    Tip: For SSO to work, the system identified by sysplex-name.system-name must be the primary system and the date the LTPA key was generated must match the date the key was generated on the primary system. Otherwise, the key for the primary and secondary z/OSMF servers will not match. In which case, SSO will fail and users will be prompted for login credentials.

To display the date on which the LTPA credentials were generated, place your cursor over the status. If the date for the primary and secondary z/OSMF servers do not match, re-enable single sign-on for the secondary z/OSMF servers. Then, restart the secondary z/OSMF servers.

Depending on your security policy, you might be required to regenerate the LTPA key before enabling SSO. For instructions, see Changing the LTPA key used for single sign-on.

If the status is blank, SSO is not enabled for the system.

Last Modified Date and time the system definition was last modified. This column is hidden by default. To display it, use the Configure Columns action.
Modified By User ID of the user who last modified the system definition. This column is hidden by default. To display it, use the Configure Columns action.
Created Date and time the system definition was created. This column is hidden by default. To display it, use the Configure Columns action.
Created By User ID of the user who created the system definition. This column is hidden by default. To display it, use the Configure Columns action.
Locked Date and time the system definition was locked. This column is blank if the system definition is not currently locked. This column is hidden by default. To display it, use the Configure Columns action.
Locked By User ID of the user who locked the system definition. This column is blank if the system definition is not currently locked. This column is hidden by default. To display it, use the Configure Columns action.

Actions for systems

The actions are described in the following tables:

  • Targeted actions. Actions that apply to the selected system definition. To use a targeted action, select only one system definition.
  • General actions. Actions that apply to system definitions. No selection is required.
  • Table actions. Actions that apply to the entire table. No selection is required.
Table 2. Targeted actions
Action Description
Modify Modify the selected system definition. This action is listed in the Actions menu and the context menu only if you are authorized to modify system definitions.
View View the selected system definition.
Copy Create a copy of the selected system definition. This action is listed in the Actions menu and the context menu only if you are authorized to copy system definitions.
Remove Remove the selected system definitions. This action is listed in the Actions menu and the context menu only if you are authorized to remove system definitions.
Associate HTTP Proxy Associate the selected system definition with an HTTP proxy definition. This action is listed in the Actions menu and the context menu only if you are authorized to associate system definitions with an HTTP proxy definition.
Enable Single Sign-on Synchronize the LTPA key used on the primary z/OSMF server and the selected z/OSMF server. This action is listed in the Actions menu and the context menu only if you are authorized to enable single sign-on.
Clear Login Credentials Remove your login credentials for the selected system from the lightweight third-party authentication (LTPA) cache. Doing so allows you to provide a different user ID and password or pass phrase the next time z/OSMF needs to authenticate with the system.
Table 3. General actions
Action Description
Discover Discover the systems that are members of the sysplex where z/OSMF is running.
Add Add one of the following items to z/OSMF:
  • System. Add a new system definition. This action is listed in the Actions menu only if you are authorized to define new system definitions.
  • Group. Add a new group to use for organizing systems.
Change LTPA Key Change the password used to protect the LTPA keys file. This action is listed in the Actions menu only if you are authorized to change the password.
HTTP Proxies Display the HTTP Proxies page so that you can specify the settings for z/OSMF to use when traversing the HTTP or SOCKS proxy servers in your installation.
View Topology Display a graphical representation of the systems listed in the Systems table. In the topology, the systems will be grouped according to the value selected in the View systems by field.
Table 4. Table actions
Action Description
Configure Columns Select the columns to display in the table, specify the order of those columns, and designate which columns should be fixed in position when the table is scrolled horizontally.
Hide Filter Row Remove the filter row from view. This action is listed only when the filter row is displayed in the table.
Show Filter Row Display the filter row. This action is listed only when the filter row is not displayed in the table.
Clear Sorts Clear the sort from all of the columns in the table. This action is disabled if no sorting is specified in the table.