Install the z/OSMF cataloged procedures

Description

z/OSMF requires that several cataloged procedures be installed on your system, as described in this topic.

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: z/OSMF
When change was introduced: z/OS V2R1.
Applies to migration from: z/OS V1R13.
Timing: Before installing z/OS V2R2.
Is the migration action required? Yes.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: None.
Related IBM® Health Checker for z/OS® check: None.

Steps to take

z/OSMF requires that the following cataloged procedures be installed on your system:
  • Started procedures for the z/OSMF server: z/OSMF processing is managed through the z/OSMF server, which runs as a pair of started tasks on your system, IZUANG1 and IZUSVR1.
  • Logon procedure for the z/OS data set and file REST interface: When you install the PTFs for APAR PM98630 and the corequisite APARs, z/OSMF requires that a TSO logon procedure be installed in your system proclib. The procedure is used internally by the z/OS data set and file REST interface services.

    IBM supplies a default procedure, IZUFPROC, which you must install prior to configuration. The default procedure should be sufficient for most z/OS installations. Review the procedure before installing it, however, to ensure that it is suitable for use in your environment.

    If appropriate, you can use an alternative logon procedure, if it provides the same function as the shipped IZUFPROC procedure. Specifically, your logon procedure must contain, at a minimum, all of the DD statements from IZUFPROC; these must reference your system data sets that contain the z/OS UNIX REXX exec programs and ISPF libraries. Also, if your installation uses an actual (non-temporary) data set for ISPFPROF, the logon procedure must be configured to allow profile sharing.

IBM supplies the catalogued procedures for z/OSMF in your order, as follows:
  • ServerPac and CustomPac orders: For a ServerPac order, IBM supplies the cataloged procedures in SYS1.IBM.PROCLIB. For a CustomPac order, you can rename this data set through the installation dialog.
  • CBPDO orders: For a CBPDO order, the data set name is SYS1.PROCLIB; you can rename this data set.

    During installation, you can optionally catalog the data set, or you can defer this step.

Ensure that the z/OSMF catalogued procedures reside in the SMP/E defined PROCLIB, as follows:
  • ServerPac and CustomPac users: Ensure that SYS1.IBM.PROCLIB (or whatever you renamed it to) resides in the JES PROCLIB concatenation. Or, copy its contents to a data set in the JES PROCLIB concatenation.
  • CBPDO users: Ensure that SYS1.PROCLIB (or whatever you renamed it to) resides in the JES PROCLIB concatenation (and is catalogued). Or, copy its contents to a data set in the JES PROCLIB concatenation.

Note that these steps are the same as you would do for any SMP/E installed cataloged procedure that is provided with z/OS.

Reference information

For information about starting the started tasks, and optionally setting them up to start after every IPL, see IBM z/OS Management Facility Configuration Guide.