IBM Z Open Development Version 1.0 Host Configuration Guide IBM SC27-9297-01 IBM Z Open Development Version 1.0 Host Configuration Guide IBM SC27-9297-01 Note Before using this information, be sure to read the general information under “Notices” on page 27. Second edition (March 2019) This edition applies to IBM Z Open Development Version 1.0 and to all subsequent releases and modifications until otherwise indicated in new editions. IBM welcomes your comments. You can send your comments by mail to the following address: IBM Corporation Attn: Information Development Department 53NA Building 501 P.O. Box 12195 Research Triangle Park NC 27709-2195 USA You can fax your comments to: 1-800-227-5088 (US and Canada) When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 2015, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ............... v Customization setup ........... 11 PARMLIB changes ............ 12 Tables ............... vii Set the z/OS UNIX definitions in BPXPRMxx .. 12 Product enablement in IFAPRDxx ...... 12 LINKLIST definitions in PROGxx ...... 14 About this document ......... ix Requisite LINKLIST and LPA definitions ... 15 Who should use this document ........ ix PROCLIB changes ............ 16 ELAXF* remote build procedures ...... 16 Host Configuration Guide ...... 1 Security definitions ............ 18 idz.env, the environment configuration file .... 18 Chapter 1. Planning.......... 3 Migration considerations .......... 3 Chapter 3. Other customization tasks 21 Planning considerations .......... 3 z/OS UNIX subprojects .......... 21 Product overview............ 3 REXEC or SSH setup .......... 21 Skill requirements ........... 4 Include preprocessor support ........ 22 Time requirements ........... 4 Preinstallation considerations ......... 4 Chapter 4. Security definitions .... 23 Installation user ID ........... 5 Requirements and checklist ......... 23 Requisite products ........... 5 Define the data set profiles ......... 23 Required resources ........... 5 Verify the security settings ......... 24 Preconfiguration considerations ........ 6 Product selection ............ 6 Chapter 5. Migration guide ...... 25 Workload management .......... 7 Migration considerations .......... 25 Resource usage and system limits ...... 7 Backing up the previously configured files ... 25 Required configuration of requisite products... 7 Migrate to version 1.0 ........... 25 User ID considerations .......... 7 Server considerations .......... 8 Notices .............. 27 Predeployment considerations ........ 8 Programming interface information ...... 29 Client checklist ............. 9 Trademarks .............. 29 Terms and conditions for product documentation.. 29 Chapter 2. Basic customization .... 11 Requirements and checklist ......... 11 © Copyright IBM Corp. 2015, 2019 iii iv IBM Z Open Development Version 1.0: Host Configuration Guide Figures 1. idz.env: environment configuration file 19 © Copyright IBM Corp. 2015, 2019 v vi IBM Z Open Development Version 1.0: Host Configuration Guide Tables 1. Required resources .......... 5 6. Match load modules to functions ..... 15 2. Administrators needed for required tasks 6 7. Sample ELAXF* procedures ....... 16 3. Administrators needed for optional tasks 6 8. ELAXF* high-level qualifier checklist .... 17 4. Client checklist: Mandatory parts...... 9 9. ELAXF* .............. 18 5. Client checklist: Optional parts ...... 9 10. Security setup variables ........ 23 © Copyright IBM Corp. 2015, 2019 vii viii IBM Z Open Development Version 1.0: Host Configuration Guide About this document This document discusses the configuration of IBM® Z Open Development on your z/OS® host system. The following names are used in this document: v IBM Explorer for z/OS is called z/OS Explorer. v IBM z/OS Debugger is called z/OS Debugger. v IBM Z Open Development is called Z Open Development. v z/OS UNIX System Services is called z/OS UNIX. v Customer Information Control System Transaction Server is called CICSTS, abbreviated to CICS®. This document is part of a set of documents that describe Z Open Development host system configuration. Each of these documents has a specific target audience. To complete the Z Open Development configuration, you are not required to read all documents. v IBM Z Open Development Host Configuration Guide (this document) describes in detail all planning tasks, configuration tasks, and options (including optional ones) and provides alternative scenarios. v IBM Z Open Development Host Configuration Reference describes Z Open Development design and gives background information for various configuration tasks of Z Open Development, z/OS components, and other products (such as WLM) related to Z Open Development. For the most up-to-date versions of this document, see the Z Open Development Knowledge Center available at https://www.ibm.com/support/knowledgecenter/ SSUFAU/zod_welcome.html. For the most up-to-date versions of the complete documentation, including installation instructions, white papers, podcasts, and tutorials, see the library page of the IBM Z Open Development website (https://www.ibm.com/support/ docview.wss?uid=ibm10738975). Who should use this document This document is intended for system programmers who are installing and configuring IBM Z Open Development. This document lists in detail the steps that are needed to do a full setup of the product, including some non-default scenarios. Background information that can help you to plan and execute the configuration can be found in the IBM Z Open Development Host Configuration Reference. To use this document, you must be familiar with the z/OS UNIX System Services and MVS™ host systems. © Copyright IBM Corp. 2015, 2019 ix x IBM Z Open Development Version 1.0: Host Configuration Guide Host Configuration Guide © Copyright IBM Corp. 2015, 2019 1 2 IBM Z Open Development Version 1.0: Host Configuration Guide Chapter 1. Planning Use the information in this chapter to plan the installation and deployment of Z Open Development. The following subjects are described: v “Migration considerations” v “Planning considerations” v “Preinstallation considerations” on page 4 v “Preconfiguration considerations” on page 6 v “Predeployment considerations” on page 8 v “Client checklist” on page 9 For a complete list of the Z Open Development hardware and software requirements, including prerequisites and corequisites, see the Software Product Compatibility Reports (SPCR) tool (https://www.ibm.com/software/reports/ compatibility/clarity/index.html). Migration considerations Chapter 5, “Migration guide,” on page 25 describes changes to the installation and configuration of this release with respect to previous releases of the product. Use this information to plan your migration to the current release of Z Open Development. Planning considerations Product overview Z Open Development consists of a client, installed on the user's personal computer, and a server, installed on one or more host systems. Both client and host are installed on top of IBM Explorer for z/OS. This documentation contains information for a z/OS host system. The client provides developers with an Eclipse-based development environment that facilitates a uniform graphical interface to the host, and that, among other things, can offload work from the host to the client, saving resources on the host. The host portion consists of several permanently active tasks and tasks that are started ad hoc. These tasks allow the client to work with the various components of your z/OS host system, such as MVS data sets, TSO commands, z/OS UNIX files and commands, job submit, and job output. The host components of Z Open Development are shared by multiple products offered by IBM. Z Open Development enhances the basic access functionality provided by z/OS Explorer. Z Open Development provides features like rich, language-aware editors with error feedback. For information about Z Open Development itself, how it interacts with your system, and with the prerequisite and co-requisite products, see the Z Open Development Host Configuration Reference. The IBM Explorer for z/OS Host Configuration Reference gives similar information for z/OS Explorer, which is a requisite for Z Open Development. © Copyright IBM Corp. 2015, 2019 3 To learn more about the functionality that is offered by Z Open Development, see the Z Open Development Knowledge Center at https://www.ibm.com/support/ knowledgecenter/SSUFAU/zod_welcome.html, or your local IBM representative. Skill requirements SMP/E skills are needed for a Z Open Development host installation. The configuration of Z Open Development requires more than the typical system programming permissions and expertise, so assistance from others might be needed. Table 2 on page 6 and Table 3 on page 6 list the administrators who are needed for the required and optional customization tasks. Time requirements The amount of time that is required to install and configure the Z Open Development host system components depends on various factors such as these: v The current z/OS UNIX and TCP/IP configuration v The availability of prerequisite software and maintenance v The availability of a user, who has successfully installed the client, to test the installation and report any problems that might occur Experience has shown