Adding systems

To define a new system definition to z/OSMF, use the Add > System action provided in the Systems table. This action is listed only if you are authorized to define new system definitions.

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 following steps:

1. In the Systems table, select Add > System from the Actions menu. The Add System wizard is displayed. Click Next to proceed.
2. On the System Information page, complete the following steps:
   1. In the System name field, enter the name specified for the system on the SYSNAME parameter in the IEASYSxx parmlib member. The system name is required and must be 1-8 characters long; the valid characters are alphanumeric (A-Z, a-z, and 0-9) and special (@ # $) characters.
   2. In the System nickname field, enter a unique name for the system definition or click Generate Nickname to create a nickname that is based on the system name you specified. The nickname is required, must be unique, and must be 1-40 characters long; the valid characters are alphanumeric characters (A-Z, a-z, and 0-9), hyphens (-), and special characters ($ _ # @). Nicknames are case sensitive; for example, SYSTEM1 and System1 are unique values.
   3. In the Sysplex name field, enter the 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. The sysplex name is required and must be 1-8 characters long; the valid characters are alphanumeric (A-Z, a-z, and 0-9) and special (@ # $) characters.
   4. In the System description field, enter additional information about the system. The description is optional and can contain a maximum of 256 characters.
   5. In the z/OS version and release field, select or type the 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. The version and release is optional.
   6. In the JES member name field, enter the 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. The JES member name is optional. If specified, the name must be 1-8 characters long; the valid characters are alphanumeric (A-Z, a-z, and 0-9) and special (@ # $) characters.
   7. In the JES type field, select or specify the type for the primary job entry subsystem running on the system. The type is either JES2 or JES3. The JES type is optional.
   8. In the CPC name field, enter the name specified for the central processor complex (CPC) at the support element (SE) of that processor complex. The CPC name is optional. If specified, it can contain a maximum of 40 characters including alphanumeric characters (A-Z, a-z, and 0-9), hyphens (-), and special characters ($ _ # @).
   9. In the CPC serial field, enter the serial number of the CPC. You can use the DISPLAY M=CPU command to determine the CPC serial. For more instructions, see the topic about determining the CPC type, model, and serial number in z/OS MVS Product Management. The CPC serial is optional. If specified, it must contain 5 or 7 alphanumeric characters (A-Z, a-z, and 0-9).
   10. Click Next to proceed.
3. On the z/OSMF Information page, indicate whether a z/OSMF instance or an application server is running on the system you are adding. If so, complete the following steps:
   1. In the URL field, enter one of the following values:
      • The URL used to access the z/OSMF instance that resides in the same sysplex as the system identified in the System name field. The z/OSMF URL must begin with https, and must end with /zosmf or /zosmf/. For example, https://myzosmf.mydomain.com:32208/zosmf.
      • 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.

      The URL can contain a maximum of 4,000 characters, including alphanumeric characters (A-Z, a-z, 0-9), blanks, mathematical symbols (+ - = | ~ ( ) { } \), punctuation marks (? , . ! ; : ' " / [ ]), and special characters (% $ # @ _ ^ *). If the A z/OSMF instance or an application server is running on the system option is selected, the URL is required.

   2. In the HTTP proxy to use when communicating with this z/OSMF instance field, select the HTTP proxy definition that specifies the settings required for z/OSMF to establish an HTTPS connection with the system. Select one of the following options:
      • Use the default proxy. Currently, the default proxy is proxy-name. Select this option to always use the HTTP proxy definition that is identified as the default proxy in the HTTP Proxies table. The name of the HTTP proxy definition that is currently the default is provided.
      • Use the selected proxy. Select this option to specify the HTTP proxy definition to use. Then, select an HTTP proxy definition from the list, or click Select and select an HTTP proxy definition from the table. If no settings are required for z/OSMF to establish an HTTPS connection with the system, select No Proxy.

   Click Next to proceed.

4. On the FTP Server page, indicate whether an FTP or SFTP server is running on the system you are adding. If so, select the server definition that specifies the settings required to access the FTP or SFTP server. Click Next to proceed.
5. On the Groups page, assign the system to one or more groups. To do so, select a group from the Available Groups table and click Add to add it to the Selected groups field. The system will be assigned to all the groups listed in the Selected groups field. Assigning a system to a group is optional. Click Next to proceed.
6. On the Summary page, review the system definition. To make changes, click Back to return to the appropriate page. When complete, click Finish to add the system.