Skip to main content
Version: v3.0.x LTS

Configuring z/OSMF

Configuring z/OSMF

For client-side components to communicate with the mainframe, z/OSMF requires configuration to make this happen.

Required role: systems programmer

Complete the following IBM z/OSMF configuration tasks for the implementation of Zowe CLI, Zowe Explorer for Visual Studio Code, or the Zowe IntelliJ Plug-in.

note

If you are connecting to the mainframe with methods other than a z/OSMF profile, you do not need to configure z/OSMF. Other connection options might include using FTP, or your custom API.

Obtaining z/OSMF installation and configuration materials

Before you start the configuration process, review Overview of z/OSMF in the IBM Documentation.

Installing and configuring z/OSMF

Zowe client-side components were designed and tested to integrate with z/OSMF running on IBM version 2.5 z/OS mainframe systems. To use Zowe client-side components, ensure that your z/OS system meets the requirements that are described in the following table:

RequirementDescription
AXR (System Rexx)The AXR (System Rexx) component lets z/OS perform Incident Log tasks. It also lets REXX execs execute outside of conventional TSO and batch environments.
For more information, see Communicating with System REXX on the IBM Documentation.
CEA (Communications Enabled Applications) ServerCEA server is a co-requisite for the CIM server. The CEA server lets z/OSMF deliver z/OS events to C-language clients.
z/OSMF requires the CEA server to perform the following types of tasks:
  • Problem determination
  • Sysplex
  • z/OS classic interfaces
  • z/OS Operator Console
Notes:
  • Start the CEA server before you start z/OSMF (the IZU* started tasks).
  • Set up CEA server in Full Function Mode and assign the TRUSTED attribute to the CEA started task.
For more information, see Customizing for CEA on the IBM Documentation.
CIM (Common Information Model) Serverz/OSMF requires the CIM server to perform the following types of tasks:
  • Capacity provisioning
  • Problem determination
  • Workload management
Note: Start the CIM server before you start z/OSMF (the IZU* started tasks).
For more information, see Configuring the CIM server for your system on the IBM Documentation.
For more information on how to perform asynchronous operations, review the required authorizations for z/OSMF on the IBM Documntation.
Console CommandThe CONSOLE and CONSPROF commands must exist in the authorized command table.
Java versionIBM® 64-bit SDK for z/OS®, Java™ Technology Edition V8 SR4 FP10 (5655-DGH) or higher is required. However, we experienced problems accessing z/OSMF 2.2 using Java version 8. If you use z/OSMF 2.3, Java version 8.0_64 is required.

For more information, see Software prerequisites for z/OSMF on the IBM Documentation.
Maximum region sizeTo prevent exceeds maximum region size errors, ensure that you have a TSO maximum region size of at least 65536 KB for the z/OS system.
User IDsUser IDs require a TSO segment (access) and an OMVS segment. During workflow processing and REST API requests, z/OSMF may start one or more TSO address spaces under the following job names:
  • userid
  • substr(userid, 1, 6)//CN (Console)
Example: (userid = USRMY01, USRMY0CN )

Selecting and configuring your z/OSMF plug-ins

Plug-inFunctionalityTask
(Optional) Cloud PortalThe Cloud Portal plug-in lets you make software services available to marketplace consumers and it adds the Marketplace and Marketplace Administration tasks to the z/OSMF navigation tree.For information about how to enable the plug-in, see Cloud provisioning marketplace on the IBM Documentation.
Configuration AssistantThe Configuration Assistant plug-in lets z/OSMF configure TCP/IP policy-based networking functions.
For more information about the functionality that the plug-in provides, see Network Configuration Assistant and Security Configuration Assistant on the IBM Documentation.
For information about how to enable the plug-in, see Updating z/OS for the Configuration Assistant plug-in on the IBM Documentation.
ISPFThe ISPF plug-in lets z/OSMF access traditional ISPF applications.
For information about the functionality that the plug-in provides, see ISPF task overview on the IBM Documentation.
For information about how to enable the plug-in, see Updating z/OS for the ISPF service on the IBM Documentation.
Workload ManagementThe Workload Management plug-in lets z/OSMF operate and manage workload management service definitions and policies.
For information about the functionality that the plug-in provides, see Workload Management task overview on the IBM Documentation.
For information about how to enable the plug-in, see Updating z/OS for the Updating z/OS for the Workload Management service on the IBM Documentation.