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 Explorer plug-in for IntelliJ IDEA.

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:

Requirement	Description
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) Server	CEA 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) Server	z/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 Command	The CONSOLE and CONSPROF commands must exist in the authorized command table.
Java version	IBM® 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 size	To 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 IDs	User 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-in	Functionality	Task
(Optional) Cloud Portal	The 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 Assistant	The 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.
ISPF	The 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 Management	The 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.