Micro Focus Mainframe Access Installation Guide 6.0 Standalone Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com © Copyright 2012-2020 Micro Focus or one of its affiliates. MICRO FOCUS, the Micro Focus logo and Mainframe Access Installation Guide are trademarks or registered trademarks of Micro Focus or one of its affiliates. All other marks are the property of their respective owners. 2020-06-02 ii Contents Mainframe Access Installation Guide ...............................................................5 Introduction ......................................................................................................................... 5 Communications .......................................................................................................6 Security .................................................................................................................... 7 Data Set Services .................................................................................................... 7 Administration ...........................................................................................................7 Dependent Address Space Services ....................................................................... 8 Mainframe Access Services .....................................................................................8 Migration information ...........................................................................................................8 Migrating from z/Server Scheduler to MFA TSO Application Server ........................8 General Migration Actions ........................................................................................ 9 Installation requirements ..................................................................................................... 9 Machine requirements ..............................................................................................9 Software requirements ........................................................................................... 10 Mainframe Access Configuration Utility ............................................................................ 10 Prerequisites .......................................................................................................... 11 Starting the Mainframe Access Configuration Utility .............................................. 11 Operation ................................................................................................................11 Configuration parameters reference .......................................................................13 Host Installation .................................................................................................................18 Preparing the Installation ........................................................................................19 Installation procedure ............................................................................................. 19 Troubleshooting .................................................................................................................42 Abend Codes ..........................................................................................................43 LU6.2 Diagnostic Information ................................................................................. 44 Mainframe Access Host Error Codes ..................................................................... 50 Mainframe Access Remote IMS Error Codes ........................................................ 51 IBM SAF and RACF Error Codes ...........................................................................52 Mainframe Access Audit Report Program .............................................................. 61 Obtaining a VTAM Buffer Trace .............................................................................. 63 Obtaining an MFA Server Trace ............................................................................. 67 Customizing Data Connect .............................................................................................. 68 Introduction ............................................................................................................68 Samples for Configuration .....................................................................................68 JCL Change for Data Connect ............................................................................... 69 Configuring Access to External Library Management Systems ........................................ 69 About External Library Management ......................................................................69 Panvalet .................................................................................................................69 Librarian ................................................................................................................. 72 Endevor ................................................................................................................. 74 ChangeMan ZMF ................................................................................................... 76 Configuring Access to Enterprise Server Mainframe Subsystem Support ....................... 81 Prerequisites .......................................................................................................... 81 MFA Server Configuration for ES/MSS .................................................................. 81 Technical Details .................................................................................................... 84 Console Commands ..........................................................................................................85 Introduction .............................................................................................................85 Console Commands ...............................................................................................86 Mainframe Access Messages ........................................................................................... 91 Mainframe Access Server Messages .....................................................................91 Status Codes and Error Messages ...................................................................... 120 Contents | 3 Configuration reference ...................................................................................................123 Mainframe Access Server configuration parameters ............................................123 Copyright and Disclaimer ..............................................................................156 4 | Contents Mainframe Access Installation Guide Introduction Mainframe Access is the OS/390 and z/OS server for Micro Focus development environments. It is a common component providing access to host resources for environments. One installation of Mainframe Access can support all of these products, providing connectivity to any number of DB2, IMS, and CICS systems located anywhere in an enterprise. It can also provide access to JES facilities, VSAM data sets, non-VSAM data sets, and data controlled by external library management products such as Panvalet, Librarian and Endevor. Note: Mainframe Access is supported on z/OS and OS/390 environments. Unless specifically stated otherwise, references to z/OS also apply to OS/390. Mainframe Access is data and transaction middleware that exploits the best features of workgroup and enterprise architectures. Micro Focus client programs can achieve the same performance levels, security, and data integrity that native mainframe applications deliver. The technology requires no changes to existing mainframe security, database, and transaction processing systems. Mainframe Access provides access to: • DB2 for z/OS and OS/390 from clients. • CICS transactions and data from clients. • IMS data from clients via the Remote IMS Serve. • Non-relational data sets (VSAM, sequential, partitioned, etc.) from Mainframe Access Client. • Mainframe source control systems the Mainframe Access Client. • JES2 and JES3 from the Mainframe Access Client. The figure below illustrates the relationships between Mainframe Access, its client systems and the z/OS services it provides. Mainframe Access Installation Guide | 5 Communications Mainframe Access provides comprehensive support for communications between PC clients and mainframe servers. Mainframe Access supports both TCP/IP and LU6.2 protocols. Mainframe Access' ability to bridge client TCP/IP connections to SNA LU6.2 server connections eliminates the need to install, configure and maintain SNA software packages on your client and server workstations. You can even access any DB2 for z/OS and OS/390 database using TCP/IP client connections, without the need for specific levels of DB2 software. Normally, DB2 Version 5.1, or later, is required for TCP/IP access. Mainframe Access, however, dynamically associates TCP/IP client connections with traditional LU6.2 DRDA connections to the DB2 systems. Details are as follows: • TCP/IP Communications Mainframe Access has two TCP/IP socket listeners, one for TCP/IP clients using proprietary protocols and one for HTTP clients. The listeners accept client connection requests and examine the request data to determine the target server or internal destination for the request. When the target server is external, the client connection is then associated with an LU6.2 connection to the target server. For each target