Shadow Z/SQL to VSAM Installation Guide
Total Page:16
File Type:pdf, Size:1020Kb
Shadow z/SQL to VSAM Installation Guide Version 7.4 March 2013 Notices Edition Publication date: March 2013 Book number: Product version: Shadow VSAM z/SQL Installation Guide Copyright © Rocket Software, Inc. 1999–2013. All Rights Reserved. © Rocket International CV 1999–2013. All Rights Reserved. Trademarks Rocket is a registered trademark of Rocket Software, Inc. For a list of Rocket registered trademarks go to: www.rocketsoftware.com/about/legal. All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names of their respective owners. Examples This information might contain examples of data and reports. The examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. License agreement This software and the associated documentation are proprietary and confidential to Rocket Software, Inc., are furnished under license, and may be used and copied only in accordance with the terms of such license. Note This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when exporting this product. Contact information Website: www.rocketsoftware.com Rocket Software, Inc. Headquarters 77 4 th Avenue, Suite 100 Waltham, MA 02451–1468 USA Tel: +1 781 577 4321 Fax: +1 617 630 7100 Contacting Global Technical Support If you have current support and maintenance agreements with Rocket Software, you can access the Rocket Customer Portal and report a problem, download an update, or read answers to FAQs. The Rocket Customer Portal is the primary method of obtaining support. To log in to the Rocket Customer Portal, go to: www.rocketsoftware.com/support If you do not already have a Rocket Customer Portal account, you can request one by clicking “Need an account?” on the Rocket Customer Portal login page. 1 Rocket Shadow Product Overview Shadow provides a real-time integration solution that utilizes bi-directional Events, Data, and Services to solve business challenges. In supporting Real-Time Enterprise (RTE), this product is able to offer interoperability between distributed .NET and J2EE environments and legacy systems. Shadow’s mainframe integration products include: • Shadow z/Direct – direct data/program access • Shadow z/Events – real-time events • Shadow z/Services – Web services o z/Services Distributed o z/Services CICS o z/Services Consumption • Shadow z/Components – Java and .NET components • Shadow z/Presentation – Web-enablement of mainframe assets • Shadow Studio – GUI interface • Rocket Shadow Drivers for ODBC, JDBC, and ADO.NET Shadow is a multi-threaded, native runtime product, that supports the integration of Web services for Service-Oriented Architecture (SOA), real-time events for Event-Driven Architecture (EDA), SQL access for direct data and transactional access, as well as automatic presentation layer generation for extending screen-based applications to the Web. With Shadow, organizations have a mainframe integration infrastructure that at its core delivers a secure, reliable, and scalable framework for all mainframe integration. Figure 2-1. Shadow Server Shadow z/SQL Shadow z/SQL provides developers with direct SQL access to mainframe data and applications (business logic and screens) utilizing industry standard ODBC, JDBC or ADO.net. As a mainframe integration solution, Shadow z/SQL utilizes a multi-threaded, mainframe server component to enable performance and scalability capabilities, while also providing monitoring and diagnostics. Shadow ANSI SQL 92 support Shadow SQL 92 engine provides ANSI 92 SQL support for IBM CICS VSAM and IBM Information Management System (IMS) DB data sources, using either the Shadow for ODBC or JDBC driver with the Shadow Server. Shadow Studio Shadow Studio is a graphical interface tool and comprehensive integrated development environment (IDE) built on the Eclipse framework. It provides integration within the IDE to expose mainframe applications and data as Web services, real-time business events or as direct SQL calls. This allows one development environment to handle any integration requirement without any detailed knowledge of the mainframe or distributed technologies. Shadow Drivers The Rocket Shadow Drivers for ODBC, JDBC, and ADO.NET are on the client side of the Rocket Shadow product set. They are multi-threaded, high-performance components that provide applications with transparent access to z/OS data, programs, and screens via ODBC, JDBC, and ADO.NET. The Rocket Shadow Drivers perform data and SQL dialect conversations, dynamic-to-static SQL conversions, data compression, and network optimization in conjunction with the Shadow Server. 2 Download Following artifacts are included in your download: • Studio installation • Documentation • JDBC and ODBC Drivers • readme.txt . This file contains information that helps you install. It also contains the JCL for the first job of the install • ShadowPac.bin ShadowPac server install file. • Shadow maintenance files: please see ptf$read.txt for installation instructions 3 Installation of Shadow Studio A wizard will guide through the steps of Studio installation, making it a very easy procedure. Shadow Studio comes with JDBC driver installed, if you don’t want to install additional drivers, skip to chapter 5. 4 Driver installation Shadow Drivers come with readme.txt files which describe in details installation components and steps for different platforms. Also within the driver installation folder you will find SAMPLE directory which contains samples of using ODBC and JDBC drivers. 5 Installing Shadow Server This chapter provides the required and optional steps for installing the Shadow Server. The Shadow Server is the server component of Rocket Shadow and is required for Shadow z/SQL. Before You Begin Installation Installation Files You have downloaded following files: ■ readme.txt. This file contains information that helps you decide which install method to use. It also contains the JCL for the first job of both install methods. ■ ShadowPac install file. (ShadowPac.bin) ShadowPac Install File The ShadowPac install file is an MVS sequential data set in EBCDIC format. It contains a PDS that was compressed using the IBM AMATERSE program. The z/OS data set attributes for the file are: ■ Organization = PS ■ Record Format = FB ■ Record Length = 1024 ■ Block Size = 27648 ■ First Extent Cylinders = 220 ■ Second Extent Cylinders = 20 The file must be downloaded as a binary file. After You Install Because the libraries created by the install are maintained by SMP/E, we recommend that you make a copy of the target libraries to use in your production environment when you have completed the Shadow installation. Member COPYTGT in the HLQ.INSTALL library contains a job that can be used to create the production libraries. This allows you to install maintenance without disrupting the production environment. After installing maintenance using SMP/E, refresh the production libraries from the target libraries. Customizing Variables for the Install Jobs You must customize all jobs before they are submitted, using the variables described in the following table: Variable Description ?pkgpath? The directory name where ShadowPac.bin and the product's SMP/E package archive files are stored. ?pkgname? The name of the file in the pkgpath directory where the ShadowPac.bin file is stored. ?PACDSN? The name of the MVS data set that contains the downloaded ShadowPac.bin file. ?MGMTCLAS? Specifies a 1 to 8-character SMS data management class name. This parameter is required only in an installation that uses DFSMS. Otherwise it should not be specified. ?STORCLAS? Specifies a 1 to 8-character SMS data storage class name. This parameter is required only in an installation that uses DFSMS. Otherwise it should not be specified. ?HLQ? Specifies the 1 to 26-character data set name high-level qualifier(s) used for Shadow product target and distribution libraries. ?HLQREL? Specifies the 1 to 26-character data set name high-level qualifier(s) used for the libraries created by the SMP/E package extract process. ?HLQSMP? Specifies the 1 to 26-character data set name high-level qualifier(s) used for the SMP/E control libraries, such as the CSI and SMPPTS. ?DLBZONE? Specifies the 1 to 7-character name for the SMP/E distribution zone name. ?TGTZONE? Specifies the 1 to 7-character name for the SMP/E target zone name. NOTE: The values of ?HLQ?, ?HLQREL?, and ?HLQSMP? can be the same. Required Installation Steps Make sure that you have followed the instructions in "Before You Begin Installation. Step 1: Installing Shadow Server Take the following steps to install Shadow Server: a Run the UNTERSE job located in readme.txt. This job unterses the Shadow Server ShadowPac install file into an MVS PDS, and creates the INSTALL library. This library has the data set name HLQ.INSTALL. b Run the INSTPAC job located in the INSTALL library. This job creates the libraries by using the PDS created in Step 1a. See Appendix A "Shadow Data Sets" for a list of the product data sets created by the INSTPAC job. Step 2: Define New Slip Traps (optional) Take the following steps: 1 Add the following slip traps to the system PARMLIB data set member IEASLPxx: SLIP SET,C=U0222,ID=U222,A=NODUMP,END SLIP SET,C=U0322,ID=U322,A=NODUMP,END SLIP SET,C=U0522,ID=U522,A=NODUMP,END Shadow Server provides the ability to monitor and limit resources for client connections. If resource limits are exceeded, Shadow can automatically cancel the client connections. The Shadow Server issues user abends (as opposed to system abends) to cancel these connections and, in some instances, z/OS may take an SVC dump for these abends. Shadow Server uses the following slip traps: Slip Trap Description U0222 Abend Issued for the following situations: When a connection is cancelled manually by an individual using the Shadow Server KILL option under the Remote User Display.