IZUPRMxx reference information
The IZUPRMxx parmlib member specifies options for z/OSMF. SYS1.SAMPLIB contains a copy of the IZUPRMxx member that you can copy to SYS1.PARMLIB and modify.
Syntax rules for IZUPRMxx
For general rules of parmlib member syntax, see z/OS MVS Initialization and Tuning Reference.
- Use columns 1-71 for data; columns 72-80 are ignored.
- If a statement is omitted, the default is used.
- You can enter one or more statements on a line, or use several lines for one statement.
- Blanks are treated as delimiters. The system interprets multiple blanks as
a single blank. You can use blanks between parameters and values. For example, all of the following
parameter specifications are equally valid:
SESSION_EXPIRE(495) SESSION_EXPIRE (495) SESSION_EXPIRE ( 495 )
- Comments can appear in columns 1-71 and must begin with "/*" and end with "*/". Any number of blank lines can appear between statements to improve readability.
- Enter values in uppercase, lowercase, or mixed case. The system converts input to uppercase,
unless the values are enclosed in single quotation marks, which are processed without altering the
case. These values that you set for these parameters might require mixed casing, and therefore should be enclosed in single quotation marks:
- INCIDENT_LOG UNIT
- Enclose any value that contains special characters in single quotation marks.
- You can use system symbols in IZUPRMxx. Suppose, for example, that your installation
defines a symbol in IEASYMxx for the Java directory, such as
JAVA80='/usr/lpp/java/J8.0_64'. To reference this symbol on the JAVA_HOME parameter in IZUPRMxx, specify the symbol as follows:
JAVA_HOME(&JAVA80). The example in Syntax format of IZUPRMxx shows the use of a system symbol in IZUPRMxx.
- Enclose any value that is the same as a keyword in single quotation marks so that the system interprets the value as a value and not as a keyword.
- Enclose values in single quotation marks, according to the following rules:
- Two single quotations next to each other on the same line are processed as a single quotation
mark. For example, the system interprets
- If the length of a parameter and its value exceeds 71 characters, it requires multiple lines. Specify the first part of such a value in columns 1-71 and use as many subsequent lines as necessary to complete it. When a value spans multiple lines, place one quotation mark at the beginning of the value, stop the value in column 71 of the line, continue the value in column 1 of the next line, and complete the value with one quotation mark.
- Two single quotations next to each other on the same line are processed as a single quotation mark. For example, the system interprets
- You can specify multiple IZUPRMxx parmlib members on the IZU= parameter of IEASYSxx. If the same statement is used more than once, either in the same member or in multiple members, the value from the last occurrence is used. For example, suppose that your installation uses two members, IZUPRM01 and IZUPRM02. If the HOSTNAME parameter is specified in both IZUPRM01 and IZUPRM02, the system uses the HOSTNAME value from IZUPRM02.
Syntax format of IZUPRMxx
HOSTNAME('*') HTTP_SSL_PORT(443) INCIDENT_LOG UNIT('SYSALLDA') JAVA_HOME('&JAVA80_HOME') /* System symbol used to define Java home directory */ KEYRING_NAME('IZUKeyring.IZUDFLT') LOGGING('*=warning:com.ibm.zoszmf.*=info:com.ibm.zoszmf.environment.ui=finer') RESTAPI_FILE ACCT(IZUACCT) REGION(65536) PROC(IZUFPROC) /* Common TSO logon proc, account, and region size, used by all plug-ins by default. */ COMMON_TSO ACCT(IZUACCT) REGION(50000) PROC(IZUFPROC) SAF_PREFIX('IZUDFLT') CLOUD_SAF_PREFIX ('IYU') CLOUD_SEC_ADMIN(userid) SEC_GROUPS USER(IZUUSER),ADMIN(IZUADMIN),SECADMIN(IZUSECAD) SESSION_EXPIRE(495) TEMP_DIR('/tmp') CSRF_SWITCH(ON) SERVER_PROC(IZUSVR1) ANGEL_PROC(IZUANG1) AUTOSTART(LOCAL) AUTOSTART_GROUP('IZUDFLT') USER_DIR('/global/zosmf/') UNAUTH_USER(IZUGUEST) WLM_CLASSES DEFAULT(IZUGHTTP) LONG_WORK(IZUGWORK) /* Uncomment the following statement and any plugins that are desired */ /* PLUGINS( INCIDENT_LOG,COMMSERVER_CFG,WORKLOAD_MGMT,RESOURCE_MON, CAPACITY_PROV,SOFTWARE_MGMT,SYSPLEX_MGMT,ISPF ) */
IBM-supplied defaults for IZUPRMxx
There is no default IZUPRMxx parmlib member. IBM provides a sample IZUPRM00 parmlib member in the SAMPLIB data set.
Syntax format of IZUPRMxx shows the IBM-supplied IZUPRM00 member. Notice that the PLUGINS statement is commented out; to use it, you must remove the comment characters.
Statements and parameters for IZUPRMxx
- Specifies the host name, as defined by DNS, where the z/OSMF server is located. To use the local
host name, enter asterisk (*), which is equivalent to
@HOSTNAMEfrom previous releases. If you plan to use z/OSMF in a multisystem sysplex, IBM recommends using a dynamic virtual IP address (DVIPA) that resolves to the correct IP address if the z/OSMF server is moved to a different system.Rules: Must be a valid TCP/IP HOSTNAME or an asterisk (*).Default: *
- Identifies the port number that is associated with the z/OSMF server. This port is used for SSL
encrypted traffic from your z/OSMF configuration. The default value, 443, follows the Internet
Engineering Task Force (IETF) standard.
By default, the z/OSMF server uses the SSL protocol SSL_TLSv2 for secure TCP/IP communications. As a result, the server can accept incoming connections that use SSL V3.0 and the TLS 1.0, 1.1 and 1.2 protocols.The z/OSMF server port uses Java SSL encryption to protect its outbound HTTPS connections. Therefore, it is not necessary (or possible) to configure AT-TLS on the z/OSMF server port. If you attempt to do so, the z/OSMF server will encounter HTTP connection failures and errors, such as the following, in the server logs directory:
Rules: Must be a valid TCP/IP port number.Value range: 1 - 65535 (up to 5 digits)Default:
IZUG476E: The HTTP request to the secondary z/OSMF instance "209" failed with error type "CertificateError" and response code "0"
javax.net.ssl.SSLException: Unrecognized SSL message, plaintext connection?
- INCIDENT_LOG UNIT('device-name')
- Specifies the device to be used for storing data sets and z/OS UNIX files for the FTP jobs that are used for the Incident Log plug-in.Rules: You must specify a generic name (such as “3390”) or an esoteric name (such as “DISK”). The esoteric name SYSALLDA, which is used by default, is automatically defined by the system to include all direct-access disk devices.Default:
- Specifies the fully qualified path name for IBM 64-bit SDK for z/OS, Java Technology Edition on
your system. Rules:
- Must be a valid z/OS UNIX System Services path name.
- Must begin with a forward slash (/).
- Must specify a full or absolute path name.
- Specifies the key ring name for the z/OSMF
server. The format is
IZUKeyring.<SAF_PREFIX>.Rules: Must be the name of a valid RACF profile in the DIGTRING class.Note: The IZUSEC job contains statements that include the generation of digital certificates and the key ring. The value that is specified here must match the key ring name that you defined for z/OSMF in the IZUSEC job or by entering equivalent commands.Default:
- Initial trace state for the z/OSMF server. These
settings are read when the server is started. Changes to this value are provided,
when necessary, by IBM Support.
- 1 - 2048 characters
- Case sensitive.
- RESTAPI_FILE ACCT(account-number) REGION(region-size) PROC(proc-name)
- Specifies values for the TSO logon procedure that is used internally by the z/OS data set and
file REST interface services. Except for the account number, it is recommended
that you use the defaults, which should be adequate for most z/OS installations. If you specify
alternative values, you must ensure that the z/OSMF
user and z/OSMF administrator security groups are
authorized to use the logon procedure name and account number that you specify,
and that the region size is at least 65536 kilobytes (KB).
All z/OSMF users must have TSO segments that are defined in the external security manager, such as RACF. Failure to have a TSO segment for each user ID prevents some z/OSMF functions from working.
- Account number to be used for the TSO/E logon procedure that is used for
the z/OS data set and file REST interface services.Rules: A valid accounting number for your installation.Default: IZUACCT
- Region size (in kilobytes) to be used for the TSO/E logon procedure for the z/OS data set and file REST interface services. Value range: 65536 – 2096128Default: 65536
- TSO/E logon procedure to be used for operations with the z/OS data set and file REST interface services. It is recommended that you accept the
default procedure, IZUFPROC, which is supplied by IBM as a cataloged procedure in
SYS1.PROCLIB.Rules: Must be a valid partitioned data set member name.Default: IZUFPROC
- COMMON_TSO ACCT(account-number) REGION(region-size) PROC(proc-name)
- Specifies values for the TSO/E logon procedure that is used internally for various z/OSMF
activities. This setting is applicable if your z/OSMF
- z/OS console REST interface services
- Software Management task
- Workflows task
Except for the account number, it is recommended that you use the default values, which should be adequate for most z/OS installations. If you specify alternative values, you must ensure that the z/OSMF user and z/OSMF administrator security groups are authorized to use the logon procedure name and account number that you specify, and that the region size is at least 50 MB. For more information, see Updating your system for the z/OSMF REST interfaces.
All z/OSMF users must have a TSO segment that is defined in the USER profiles that are used by the external security manager, such as RACF. Failure to have a TSO segment for each user ID prevents some z/OSMF functions from working.
- Account number to be used for the common TSO/E logon procedure for
z/OSMF.Rules: A valid accounting number for your installation.Default: IZUACCT
- Region size (in kilobytes) to be used for the common logon procedure for z/OSMF. Value range: 50000 – 2096128Default: 50000
- TSO/E logon procedure to be used for z/OSMF. It is recommended that you accept the default
procedure, IZUFPROC, which is supplied by IBM as a cataloged procedure in SYS1.PROCLIB.Rules: Must be a valid partitioned data set member name.Default: IZUFPROC
- SAF profile prefix that is prepended to the names of any resource profile names to be used for
the z/OSMF core functions and optional
plug-ins.Note: The IZUxxSEC sample jobs contain commands that include the SAF profile prefix for creating resource profile names. The value that is specified here must match the prefix name that you define for z/OSMF in the IZUxxSEC jobs or by entering equivalent commands.Rules:
- Must follow the rules for RACF profile names.
- 1 – 8 characters.
- SAF profile prefix that is prepended to the names of any groups to be used for authorizing users
to IBM Cloud Provisioning and Management for z/OS task activities.Note: The IZUPRSEC sample job contains commands that include the group name for creating authorizations for IBM Cloud Provisioning and Management for z/OS. The value that is specified here must match the prefix name that you define for Cloud Provisioning authorizations in the IZUPRSEC job or by entering equivalent commands.Rules:
- Must follow the rules for RACF profile names.
- 1 – 8 characters.
- Specifies the security administrator user ID to be used for automatic security management in Cloud Provisioning. When specified, automatic security
updates are performed under this user ID. Otherwise, if this value is omitted, security updates for
Cloud Provisioning must be performed manually by your
security administrator.The user ID that is specified here must be connected to the z/OSMF security administrator group, which is named IZUSECAD by default. The IZUPRSEC job in SYS1.SAMPLIB contains a commented RACF command for creating this authorization. Minimally, this user ID requires:
- READ access to the ZMFCLOUD class resource profile IZUDFLT.ZOSMF.SECURITY.ADMIN.
- Authorization to manage resource profiles in the ZMFAPLA and ZMFCLOUD resource classes.
- Authorization to manage security groups.
During regular operations with Cloud Provisioning, your installation might periodically update Resource Management domains and tenants to add or remove users. Such changes require updates to your security setup. By specifying a user ID for the CLOUD_SEC_ADMIN keyword, you indicate that automatic security is to be used for performing user authorizations. If so, the authorizations are performed automatically by the Resource Management task, by using a security REXX exec that is provided by the external security manager. For example, IBM supplies the REXX exec izu.provisioning.security.config.rexx for use with RACF.
For more information, see Automatic security management for Cloud Provisioning.
If the CLOUD_SEC_ADMIN value is changed, the new setting applies only to domains that are created after the change. Any existing domains continue to operate with manual or automated security, based on the value that was in effect when these domains were created.Rules:
Default: None. If you do not provide a valid z/OS user ID, the Resource Management task does not perform automatic security updates.
- Must follow the rules for z/OS user IDs.
- 1 – 8 characters.
- SEC_GROUPS USER(group-name),ADMIN(group-name),SECADMIN(group-name)
- Specifies group names for the base set of z/OSMF
security groups: user, administrator, and z/OS security administrator.
- Security group to be used for the z/OSMF user
role. The user IDs that are connected to this group are considered to be z/OSMF users.Default: IZUUSER
- Security group to be used for the z/OSMF
administrator role. The user IDs that are connected to this group are considered to be z/OSMF administrators.Default: IZUADMIN
- Group name to be used for the z/OS Security Administrator role. This group is permitted to the
Workflows task.Default: IZUSECAD
- Amount of time (in minutes) for the session timeout. z/OSMF user sessions expire when this period elapses. For
more information, see Re-authenticating in z/OSMF.Value range: 30-999999Default: 495
- Temporary directory for various z/OSMF activities. This setting is applicable if your z/OSMF configuration uses:
The temporary directory is used, as follows:
- Incident Log task
- Workflows task.
- Incident Log task uses this directory for sending z/OS UNIX file attachments through FTP.
- Workflows task uses this directory for storing temporary files.
Users of these z/OSMF tasks require write access to the temporary directory. Otherwise, the task might fail with an authorization error (the user encounters message ICH408I).
In IBM Cloud Provisioning and Management for z/OS provisioning, a number of functions are performed by using workflows. For example, a software template is comprised of one or more workflows. Therefore, any user who is involved in IBM Cloud Provisioning and Management for z/OS provisioning is also a potential user of the Workflows task. You must ensure that these users have write access to the TEMP_DIR location.Rules:
- Must be a valid z/OS UNIX path name.
- Must specify the full or absolute path name, and a maximum of 255 characters between slashes.
- Indicates whether Cross Site Request Forgery (CSRF) custom header checking is enabled for REST
API requests. By default, CSRF_SWITCH is set to ON to ensure that your
installation is protected against CSRF attacks. However, in some limited cases, such as for testing,
you might choose to temporarily disable CSRF checking by setting CSRF_SWITCH=OFF. However, it is
recommended that you leave this setting enabled to prevent CSRF attacks. For more information, see
IBM z/OS Management Facility Programming Guide.Default: ON
- Specifies the name of the started procedure that is used to start the z/OSMF server on this
system. It is recommended that you use the default started procedure, which should be adequate for
most z/OS installations. If you specify an alternative procedure name, ensure that the z/OSMF user
and z/OSMF administrator security groups are authorized to the started procedure name. Rules: Must specify a valid partitioned data set member name.Default: IZUSVR1
- Specifies the started procedure that is used to start the z/OSMF angel process on this system.
It is recommended that you use the default started procedure, which should be adequate for most z/OS
installations. If you specify an alternative procedure name, ensure that the z/OSMF user and z/OSMF
administrator security groups are authorized to the started procedure name.With the installation of APAR PI88651, the ANGEL_PROC statement specifies both the name of the angel process and its started procedure name.Example: ANGEL_PROC(IZUANG1) indicates that both the angel procedure member name and angel process name are IZUANG1.
If you plan to use an alternative angel name, see Considerations for using a named angel for more information.Rules: Must specify a valid partitioned data set member name.Default: IZUANG1
- Specifies whether the z/OSMF server is to be started automatically on this system. The valid settings for AUTOSTART are, as follows:
- Indicates that the system is to automatically start the z/OSMF server.
- Indicates that the z/OSMF server is not to be autostarted on the local z/OS system.
- IBM recommends that you specify LOCAL for all systems in a sysplex, or let it default to LOCAL, if you are using shared file systems for the z/OSMF data directory for each AUTOSTART group. If all systems in a sysplex are part of the same AUTOSTART group, the default, /global/zosmf, will allow this. z/OSMF will start only on one system in the sysplex, if the sysplex has only one AUTOSTART group.
- If you have more than one AUTOSTART group in a sysplex, you should use a shared file system for each one, with a unique mount point. For example, if you have AUTOSTART groups that are named ZOSMFA and ZOSMFB, you might use /global/zosmf/zosmfa for the first and /global/zosmf/zosmfb for the second. In this case, specifying LOCAL on all systems results in z/OSMF starting on one system per AUTOSTART group.
- When the z/OSMF server has been started automatically on another system in the same AUTOSTART group in the same sysplex, requests for z/OSMF services that originate on the local system are routed to the remote server.
- When AUTOSTART(CONNECT) is specified for every system in a sysplex, the z/OSMF server is not autostarted on any system in the sysplex. The z/OSMF server can be started using the operator START command or by automation when no other z/OSMF server is active in the system’s AUTOSTART group.
If a z/OSMF server fails, it must be restarted to restore z/OSMF operations for the autostart group. The server can be restarted on this system or another system, regardless of whether the system is specified as AUTOSTART(LOCAL) or AUTOSTART(CONNECT), using the START command or through automation.
- Associates the local system with other systems that can share an autostarted z/OSMF server.
AUTOSTART_GROUP defines a domain for z/OSMF work and associated persistent data
within a sysplex. By default, one autostart group that is called IZUDFLT exists per sysplex. To
associate the z/OSMF server on this system with a different autostart group, specify the desired
name here. Rules:
- Must consist of 1-32 alphanumeric characters (A-Z, a-z, 0-9) or special characters (#, $, or @).
- Alphabetic characters are case insensitive.
- z/OSMF data directory path. By default, the z/OSMF data
directory is located in /global/zosmf. If you want to use a different path
for the z/OSMF data directory, specify that value here, for example:
Every autostart group within a sysplex must have a unique specification for USER_DIR. If you plan to use an autostarted z/OSMF server, this file system must be mounted when you IPL the system. Otherwise, the z/OSMF server cannot be autostarted.
If you specify both
USER_DIR=in IZUPRMxx and
USERDIR=on the PRC statement of the started procedure, the system uses the path that is specified by
USERDIR=in the started procedure.Rules: Must be a valid z/OS UNIX path name.Default: /global/zosmf/
- Represents an unauthenticated user. Provides an unknown user with basic privileges to access the
z/OSMF log-in page, but nothing more.
- Must follow the rules for z/OS user IDs.
- 1 – 8 characters.
- WLM_CLASSES DEFAULT(class-name)
- Specifies the WLM transaction classes for managing z/OSMF work.
- WLM transaction class to be used for managing z/OSMF work, except for long-running work. See the description of the LONG_WORK(class-name) statement.Rules: Must specify a valid WLM transaction class name.Default:
- WLM transaction class to be used for managing the execution of long-running work. Rules: Must specify a valid WLM transaction class name.Default:
- Specifies the optional plug-ins to be made available in your configuration.
Enter one or more of the plug-in identifiers that are shown in Table 1.
Table 1. z/OSMF optional plug-ins and associated plug-in IDs Plug-in ID Plug-in name CAPACITY_PROV Capacity Provisioning COMMSERVER_CFG Network Configuration Assistant INCIDENT_LOG Incident Log ISPF ISPF RESOURCE_MON Resource Monitoring SOFTWARE_MGMT Software Deployment SYSPLEX_MGMT Sysplex Management WORKLOAD_MGMT Workload Management ZERT_ANALYZER IBM zERT Network Analyzer
After a plug-in is enabled, you might later decide to remove it. To do so, edit the IZUPRMxx parmlib member and remove the plug-in identifier from the PLUGINS statement. Then, restart the z/OSMF server. This action removes the plug-in tasks from the z/OSMF navigation area. Any residual data that is associated with the plug-in is saved in z/OSMF, in case you decide to enable it again later.Default: No optional plug-ins are enabled by default.
Example of IZUPRMxx parmlib member
- Port 30443.
- System symbol for the Java home directory. The symbol must also be defined in your IEASYMxx member.
- On startup, the system autostarts a z/OSMF server.
- The autostarted z/OSMF server processes requests from all systems that are
members of the z/OSMF autostart group
- These optional plug-ins are selected: Network Configuration Assistant, Software Deployment, and Sysplex Management. The plug-ins are enabled for use when your installation completes the required host system customization. See Customizing your z/OS system for the z/OSMF plug-ins.
HTTP_SSL_PORT(30443) JAVA_HOME('&JAVA80_HOME') /* System symbol used to define Java home */ AUTOSTART(LOCAL) AUTOSTART_GROUP(IZUDFLT) PLUGINS(COMMSERVER_CFG,SOFTWARE_MGMT,SYSPLEX_MGMT)