CADeliver BestPractices ENU
CADeliver BestPractices ENU
This documentation and any related computer software help programs (hereinafter referred to as the "Documentation") are for your informational purposes only and are 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 used or disclosed by you except as may be permitted in 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 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 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 THE END USER 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 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 11 Restart and Tracking (CA 11) CA Deliver (CA Deliver) CA Mainframe Software Manager (CA MSM) CA Output Management Web Viewer (CA OM Web Viewer) CA Spool (CA Spool) CA View (CA View)
Contact CA
Contact Technical Support For your convenience, CA provides one site where you can access the information you need for your Home Office, Small Business, and Enterprise CA 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 product documentation, you can send a message to [email protected]. If you would like to provide feedback about CA product documentation, complete our short customer survey, which is also available on the CA Support website, found at http://ca.com/docs. Best Practices Guide Process These best practices represent years of product experience, much of which is based on customer experience reported through interviews with development, technical support, and technical services. Therefore, many of these best practices are truly a collaborative effort stemming from customer feedback.
To continue and build on this process, we encourage users to share common themes of product use that might benefit other users. Please consider sharing your best practices with us. To share your best practices, contact us at [email protected] and preface your email subject line with "Best Practices for product name" so that we can easily identify and categorize them.
Contents
Chapter 1: Introduction 7
Purpose of this Guide .......................................................................... 7 Audience ...................................................................................... 7 Mainframe 2.0 Overview ....................................................................... 7 Mainframe 2.0 Features ........................................................................ 8
11
Installation ................................................................................... 11 CA Common Services ..................................................................... 12 Installation in a Test Environment.......................................................... 12 Use a Common CA High Level Qualifier Symbolic ............................................ 13 Downward Compatibility................................................................... 14 Implementation .............................................................................. 14 Library Authorization ...................................................................... 14 Multiple System Images with Shared Database and Checkpoint File .......................... 15 Configuration ................................................................................. 15 Initialization Parameters .................................................................. 15 Cross-Memory Services Parameters ........................................................ 17 Bundle Initialization and Timing Parameters ................................................ 18 Scheduled Distribution .................................................................... 19 Data Set Collector ........................................................................ 19 Direct Archival to CA View ................................................................. 20 Archive Reports Parameter ................................................................ 20 Integration and Interface Points ............................................................... 21 Integrate CA View with CA Deliver ......................................................... 21 Integrate Email Notification by way CA Spool, CA OM Web Viewer ............................ 21 Automate Job Reruns ..................................................................... 22
Index
23
Contents 5
Chapter 1: Introduction
This section contains the following topics: Purpose of this Guide (see page 7) Audience (see page 7) Mainframe 2.0 Overview (see page 7) Mainframe 2.0 Features (see page 8)
Audience
The intended audience of this guide is systems programmers and administrators who install, configure, deploy, and maintain the product.
Chapter 1: Introduction 7
We follow the IBM z/OS packaging standards using SMP/E, with some additional CA qualities of service added, to make installation simple and consistent. Additionally, through the synchronization of product releases and the use of common test environments, we will declare a yearly mainframe software stack that includes many new releases with enhanced functionality. This stack is certified for interoperability across the CA mainframe product portfolio and the base IBM z/OS product stack.
Best Practices Management Integrates with IBM Health Checker for z/OS to verify that deployed software follows our best practices. The health checks continually monitor the system and software to provide feedback on whether the software continues to be configured optimally. Best Practices Guide Provides best practices for product installation and configuration. Note: For additional information about the CA Mainframe 2.0 initiative, see http://ca.com/mainframe2.
Chapter 1: Introduction 9
Installation
Use CA MSM to acquire, install, and maintain your product. Business Value: CA MSM provides a common way to manage mainframe products. CA MSM provides a web interface, which works with Electronic Software Delivery (ESD) and standardized installation and management of mainframe products. You can use it to download and install CA Deliver. CA MSM lets you download product and maintenance releases over the Internet directly to your system from the CA Support website. After you use CA MSM to download your product or maintenance, you use the same interface to install the downloaded software packages using SMP/E. Additional Considerations: After you install the product, use the CA Deliver Installation Guide to set it up. CA MSM can continue to help you maintain your product. More Information: For more information about CA MSM, see the CA Mainframe Software Manager Guide. For more information about product setup, see the CA Deliver Installation Guide.
Installation
CA Common Services
Make sure you have installed the most current release of CA Common Services. Business Value: The latest release of CA Common Services contains the most current infrastructure updates, allowing you to successfully use the latest features, and preventing potential errors that can occur from using out-of-date services. Note: CA Common Services r11 SP8 is required to take advantage of the Health Checker feature. More Information: For more information on CA Common Services, see the Installation Guide.
Installation
Implementation
Downward Compatibility
Use direct archival from CA Deliver r11.5 to either CA View r11 or CA View 11.5 databases. Business Value: Maintains compatibility between CA Deliver r11.5, CA View r11, and CA View 11.5 databases. If CA Deliver is used to archive reports to several CA View databases, it is not necessary to invest excessive time and resources to immediately upgrade all of the databases at the same time that Deliver is upgraded to r11.5. Alternatively, it would be less resource-intensive, and would reduce the risk of configuration errors, to gradually upgrade the CA View databases to the r11.5 level. Additional Considerations: CA View r11.5 is also downward compatible with CA Deliver r11. Therefore, if it is preferable to upgrade CA View first, both CA Deliver r11.5 and r11 reports and bundles can be archived and reprinted from a CA View r11.5 database. Note: A cross memory region is limited to accessing a single version of CA Deliver. A CA Deliver r11.5 cross memory region cannot access a CA Deliver r11 database. More Information: For additional details on the cross-product compatibility of CA View and CA Deliver, refer to the Upgrade Considerations section of Introduction chapter in the CA Deliver Installation Guide.
Implementation
Once installation is complete, CA Deliver can be implemented. This section discusses the best practices for implementing CA Deliver.
Library Authorization
APF-authorize the target library by adding an entry for CAI.CAILIB to member IEAAPFxx of SYS1.PARMLIB. Business Value: Running an APF-authorized library ensures that CA Deliver executes with the appropriate permissions and approvals.
Configuration
Configuration
Initialization Parameters
When starting a CA Deliver system of the first time, it is a good practice to focus on the basic initialization parameters that comprise the minimum requirements for successful startup. After that occurs, examine the other initialization parameters to add more detailed processing options for your environment Business Value: Focusing on a basic subset of the initialization parameters will simplify a first-time installation and result in a faster implementation of CA Deliver. Additional options and parameters can be specified later, based on the evaluation of business requirements at your site. Additional Considerations: The following initialization parameters are the minimal requirements to specify when starting a CA Deliver system for the first time.
Configuration
Database Names Set NAME to the high level qualifier of the CA Deliver database and SAR to the high level qualifier of the primary CA View database. System Identifier Set SYSID to specify the parameter that identifies the CA Deliver started task. If multiple started tasks are run on the same system image, their SYSID parameters must be different. Pre-spool processing Set JOBCLSL to the job classes and SYSCLSL to the SYSOUT classes where Deliver will intercept reports using pre-spool processing. Post-spool Processing Set NETCLSL, NETDEST, and NETFORM to the SYSOUT class, destination, and form where Deliver will pick up reports from JES using post-spool processing. Post-spool processing is referred to as the CA Deliver Network Input Interface. Use NETONLY to state whether or not CA Deliver will only do post-spool processing. Archival Parameters Use the ARCHnn parameters to specify criteria for the archival of reports into CA View. You can specify up to 99 ARCHnn parameters. Use ARCH to specify the default ARCH parameter to use if a report definition does not specify an ARCH parameter. History Tracking Parameters Use HDETAIL, BNDLHDTL, and MAXHIST to specify whether detail history is being kept and how many generations of historical data are to be kept. Bundling Parameters Use BNDLMOUT and OUTPUT together to allow bundled reports with unlike attributes to be printed together. To avoid performance degradation when multiple RMOSTCs access the same database, only one started task should have BOT=YES specified. The other started tasks should have BOT=NO specified.
Configuration
Daily Cycle Parameters Use TIME, BEGINDAY, and DAYS to specify the time of day and the days of the week when the CA Deliver daily cycle and bundle cycles are to occur. If there will be multiple CA Deliver RMOSTCs accessing the same database, we suggest that BOT=YES, and TIME be set in one RMOSTC only, and BEGINDAY be set to the same value in each RMOSTC. The other tasks should have BOT=NO and TIME=0000. More Information: See the Initialization Parameters chapter of the CA Deliver Reference Guide.
Configuration
More Information: See Installing Online Interfaces chapter in the CA Deliver Installation Guide for complete information.
Configuration
Scheduled Distribution
Use the Scheduled Distribution feature to control report production. This feature can control a document distribution based on the day of a week. Business Value: Customers requiring printed or emailed output based on a particular distribution ID can specify which days of the week reports are to be sent. This can reduce report distribution and printing costs by eliminating unnecessary or redundant production work. Additional Considerations: A DAYS field has been added to the distribution specifications to identify the days of week that the recipient is to receive output. The default is Y (yes); the recipient will receive a new report each day of the week. The field can be set to Y (yes) or N (no) for each day of the week from Monday to Sunday. The DAYS field can be specified on the Report Definition Attribute Distribution Specification panel and the Distribution List Distribution Specifications pane.
Configuration
Index
A
Archive Reports Parameter 20 Audience 7 Automate Job Reruns 22
P
Purpose of this Guide 7
S
Scheduled Distribution 19
B
Bundle Initialization and Timing Parameters 18
U
Use a Common CA High Level Qualifier Symbolic 13
C
CA Common Services 12 CA Product References iii Configuration 15 Contact CA iii Cross-Memory Services Parameters 17
D
Data Set Collector 19 Direct Archival to CA View 20 Downward Compatibility 14
I
Implementation 14 Initialization Parameters 15 Installation 11 Installation and Configuration 11 Installation in a Test Environment 12 Integrate CA View with CA Deliver 21 Integrate Email Notification by way CA Spool, CA OM Web Viewer 21 Integration and Interface Points 21 Introduction 7
L
Library Authorization 14
M
Mainframe 2.0 features 8 Mainframe 2.0 Features 8 Mainframe 2.0 overview 7 Mainframe 2.0 Overview 7 Multiple System Images with Shared Database and Checkpoint File 15
Index 23