CA EPIC for z/vse Release Notes r5.2
This documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the Documentation ) is for your informational purposes only and is subject to change or withdrawal by CA at any time. This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosed by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and CA. Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy. The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the terms of this notice. The manufacturer of this Documentation is CA. Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors. Copyright 2010 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
CA Product References This document references the following CA products: CA EPIC for z/vse CA CIS for z/vse CA SORT for VSE
Contact CA Technologies Contact Technical Support For your convenience, CA Technologies provides one site where you can access the information you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following: Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product Provide Feedback If you have comments or questions about CA Technologies product documentation, you can send a message to techpubs@ca.com. If you would like to provide feedback about CA Technologies product documentation, complete our short customer survey, which is available on the CA Support website at http://ca.com/docs.
Contents Chapter 1: Introducing CA EPIC for z/vse 7 The Features... 8 Chapter 2: Enhancements to Existing Features 9 Support for IBM 359x Series Tape Drives... 9 Improved ACL Support... 9 Support for Hardware Tape Encryption... 10 Support for High-Capacity DASD... 10 Support for IBM VTS FASTREADYMOUNT Feature... 10 Remove AUTOATTACH requirement for VGS interface... 10 Support AUTOATTACH without CP modifications... 11 AUTOATTACH Support of 4 Digit Device Addresses... 11 Improved Tape Reblocking... 11 Tape Initialization Improvements... 11 TSIDMNT RETAIN EXD=CDT+NNN Parameter... 11 Support SCRATCH from TSIO0401... 12 Chapter 3: Upgrade Considerations 13 Convert a CA EPIC for z/vse 5.1 DSN Catalog (TSIDCLN)... 13 File Sharing Considerations... 13 Additional SDL Entries Required... 14 Catalog Sharing and High-Capacity DASD... 14 Changes to Install Procs... 14 MSHP Component Code Change... 14 IBM ACL Changes... 15 Chapter 4: Discontinued Features 17 VSAM Support Stabilized... 17 Contents 5
Chapter 1: Introducing CA EPIC for z/vse CA EPIC for z/vse (CA EPIC for z/vse) is an automated tape and disk management system that improves VSE data center performance. By automating resource allocation, CA EPIC for z/vse improves tape and DASD usage without additional overhead. CA EPIC for z/vse exploits the features of new operating system releases as they become available and provides state-of-the-art storage management features and functions such as its online catalog management facility. Chapter 1: Introducing CA EPIC for z/vse 7
The Features The Features CA EPIC for z/vse contains the following major features: DSN Catalog Online Management System The online facility offers user-customizable displays so you can define screens to suit your needs. It also offers a comprehensive help system at both the function and field level, giving you the flexibility, functionality and ease-of-use that you need. Further, CA EPIC for z/vse offers a single batch job that lets you create a data set, automatically catalog it and modify it to meet your requirements. VM Tape Control CA EPIC for z/vse helps you control tape drives under VM without manually attaching and detaching them when you use more than one virtual machine. You can control ASCII and unlabeled tapes the same way you control tapes with standard labels. VM support is provided that includes automatic ATTACH/DETACH of tape drives and submission of CP commands through JCL. Security CA EPIC for z/vse manages, secures, and reports on the entire storage infrastructure. Its auditing features include data set status and usage reports, basic job accounting, activity logging, and tape exception reports. Process Automation Through its many automation features, CA EPIC for z/vse helps you control the allocation, use, and release of data set resources with accuracy and efficiency. You can implement conditional execution based on date, time, job completion, and condition codes. Tape Drive and DASD Optimization Tape functions are designed to improve response at the operator console while increasing tape drive usage. Disk facilities improve DASD space and channel usage. Device Availability CA EPIC for z/vse controls the allocation of tape drives and DASD so they are not assigned to a job until needed, leaving drives free for other partitions and CPUs. 8 Release Notes
Chapter 2: Enhancements to Existing Features This chapter documents improvements made to existing features of CA EPIC for z/vse. Improved features include the following: Support for IBM 359x Series Tape Drives Improved ACL Support Support for Hardware Tape Encryption Support for High-Capacity DASD Support for IBM VTS FASTREADYMOUNT Feature Remove AUTOATTACH requirement for VGS interface Support AUTOATTACH without CP modifications AUTOATTACH Support for 4 Digit Device Addresses Improved Tape Reblocking Tape Initialization Improvements TSIDMNT RETAIN EXD=CDT+NNN Parameter Support SCRATCH from TSIO0401 Support for IBM 359x Series Tape Drives Support for tape drives 3590, 3590-E, 3590-H, 3592, 3592-E05 and 3592-E06 have been added. Improved ACL Support Multiple ACLs from multiple vendors are now supported. Chapter 2: Enhancements to Existing Features 9
Support for Hardware Tape Encryption Support for Hardware Tape Encryption Datasets written to 3592 tape drives can now use the hardware encryption feature for those devices. KEKL (Key Encryption Key Label) information can be stored in the EPIC catalog in a named package called a KMODEL. The KMODEL name is used to relate EPIC datasets to the desired encryption keys. In addition, new tape MODES are available to specify that encryption is desired for a dataset. When an encrypted tape is created, EPIC AVR routines will select an encryption capable tape drive, retrieve the KEKL information from the catalog, and pass it to VSE. For input, EPIC will AVR an encryption capable tape drive and the key exchange will be handled by VSE. Currently, the IBM drives 3592-E05 (TS1120) and 3592-E06 (TS1130) support hardware tape encryption. Support for High-Capacity DASD Support for High-Capacity CKD DASD devices with greater than 4095 cylinders, such as IBM models 3390-9, 3390-27, and 3390-54, is now available. Note: If you share these disks with a system running an earlier release of CA EPIC for z/vse, compatibility PTFs are required for the older systems. For more information, contact CA Technical Support. Support for IBM VTS FASTREADYMOUNT Feature The IBM Virtual Tape Server FASTREADYMOUNT feature is supported in two ways: 1. If a tape mounted by an ACL is rejected by EPIC because of a problem with the label, message EP013 will be written to the console to indicate a problem with the volume label. The tape will be unloaded and a new MOUNT will be issued to the ACL. Previously no error message was displayed 2. To allow EPIC to use the VTS FASTREADYMOUNT tapes, specify EPIC startup option EPS104=Y. EPS104=Y will relax EPIC's label screening for the following tape volumes: a. Mounted by an ACL for output b. In SCRATCH status in the EPIC catalog If EPS104=N (the default), the 'empty' tapes will be rejected by EPIC. Remove AUTOATTACH requirement for VGS interface When set to YES, option EPS100 removes EPIC's requirement for the AUTOATTACH feature to support an IBM ACL through the VSE Guest Server (VGS) interface. This option does not affect the ACL's accessed through LCDD or native VSE. 10 Release Notes
Support AUTOATTACH without CP modifications Support AUTOATTACH without CP modifications Allow the use of EPIC's AUTOATTACH feature without the requirement for changes to the VM/CP nucleus. Two startup options, EPS102 and EPS103, have been added to facilitate the following: EPS102='Y' directs CA EPIC for z/vse to use standard CP 'ATTACH' and 'DETACH' commands rather than EPIC's 'VATTACH' and 'VDETACH'. EPS103='Y' directs CA EPIC for z/vse to use the 'SILENT' parameter when the CP ATTACH and DETACH commands are issued, to suppress the responses from the CP command. EPS103 does not have any effect unless EPS102 is set to Y. Z/VM 4.3 or higher is required for this option. AUTOATTACH Support of 4 Digit Device Addresses With this release, the AUTOATTACH restriction that a virtual CUU address must match the real address has been removed. Three or four digit real device addresses can be specified on the AFF= parameter on the UCB command of the TSIDSMNT utility. CP ATTACH commands built by AUTOATTACH uses the AFF= specification for the real device address. Option EPS102=YES is a requirement for this enhancement. Improved Tape Reblocking Where VSE support is available (VSE/ESA 2.6 and up), the maximum allowed blocksize for EPIC tape reblocking has been raised from 32K to 64K. BLKSZ=OPT will result in 32K blocks rather than 16K, and BLKSZ=MAX will result in 64K blocks rather than 32K. Tape Initialization Improvements The TSIDINIT utility now has an ACL interface to ease the task of initializing ACL resident carts (IBM only). Specifying ACL=(address) rather than CUU=(address) results in the automatic mounting of the cart on the designated drive for initialization. TSIDMNT RETAIN EXD=CDT+NNN Parameter A new TSIDMNT RETAIN parameter, EXD=CDT+nnn, allows the expiration of the dataset to be calculated as a number of days after the creation date. Chapter 2: Enhancements to Existing Features 11
Support SCRATCH from TSIO0401 Support SCRATCH from TSIO0401 Online screen TSIO0401 has been enhanced to facilitate scratching of tapes when only the volume serial number is known. Entering 'S' scratches the corresponding prime catalog version. If active multifile versions exist on the tape, the scratch command is rejected. 12 Release Notes
Chapter 3: Upgrade Considerations The following items require special attention when upgrading from a previous release: Convert a CA EPIC for z/vse 5.1 DSN Catalog (TSIDCLN) You must change the catalog to accommodate the 64k tape reblocking enhancement. If you are upgrading from CA EPIC for VSE Version 5.1, do the following: Activate the new version of CA EPIC for z/vse Back up the DSN Catalog with the TSIDUTL BACKUP command. Run the TSIDCLN utility to initialize new fields in your version 5.1 DSN Catalog. TSIDCLN can be rerun as needed. Example // JOB TSIDCLN // EXEC TSIDCLN UPGRADE 52 /* /& If you intend to share the DSN catalog with systems running EPIC for z/vse 5.1, you must run TSIDCLN at least once a day to keep the catalog records updated. We suggest including it in your daily EPIC maintenance, after the backup of the catalog and recorder files. The utility only updates records introduced by a 5.1 system since the last UPDATE 52 run. When the 5.2 migration is accomplished on all systems, the TSIDCLN step can be removed. File Sharing Considerations The DSN catalog, Recorder file, and ERD file can be shared between releases 5.1 and 5.2, assuming that the catalog has been updated with TSIDCLN (above). Important! In a multi-release shared environment, you must perform daily backup and scratch maintenance from a r5.2 system. Chapter 3: Upgrade Considerations 13
Additional SDL Entries Required Additional SDL Entries Required In release 5.2, 47 available entries are required in the VSE System Directory List (SDL). This is 25 entries more than that were used in release 5.1. Note: For more information, see Determining Space Requirements in the Installation and System Guide. Catalog Sharing and High-Capacity DASD Support for High-Capacity DASD devices, such as IBM models 3390-9, 3390-27, and 3390-54, that have 4096 cyclinders or more, is provided with this release. Support for these devices is also provided for 5.1 with CA EPIC for z/vse PTF QO87699. This PTF must be applied to your 5.1 system if you intend to share the catalog between releases. Changes to Install Procs The member IESMSGS.PROC has been renamed EPIMSGLD.PROC to avoid confusion with the IBM proc of the same name. The DCOMOBJS.PROC, used in 5.1 to load the online manager files, has been removed in 5.2. The GSS 5.0 utility GSSUTIL is now used for this function. See Creating the Online Manager Executable Files in Chapter 2 of the CA EPIC Install and System Guide for more information. MSHP Component Code Change The IBM Maintain System History Program (MSHP) component code prefix for CA EPIC for z/vse has changed from 7965 in release 5.1, to the 0202 in 5.2. A separate MSHP file, one that does not contain ant 5.1 entries, must be used for applying r5.2 maintenance. Note: For more information, see MSHP Considerations in the Installation and System Guide. 14 Release Notes
IBM ACL Changes IBM ACL Changes If an IBM ACL is supported through VM with the VSE Guest Server (VGS) interface, CA EPIC now requires that the LIBCONFG LIST configuration member be defined for the VGS server. While the VGS documentation states that the file is not required in a single library environment, the VSE LBSERV interface cannot react properly to the library name without it. For more information on LIBCONFG LIST, see the Appendix D: VSE Guest Support in the IBM publication DFSMS/VM Removable Media Support. Chapter 3: Upgrade Considerations 15
Chapter 4: Discontinued Features This chapter documents the CA EPIC for z/vse features that have been discontinued in this release. VSAM Support Stabilized CA EPIC control of VSAM files, as specified in CA EPIC startup option VSAM=Y/N, will no longer be supported on VSE releases beyond z/vse r4.2. Chapter 4: Discontinued Features 17