VERSION 5.3
Administrator Guide
July 2002
COPYRIGHT This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of SERENA Software, Inc. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by SERENA Software, Inc. SERENA Software, Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this book. Copyright © 2001, 2002 SERENA Software Inc. All rights reserved.
TRADEMARKS ChangeMan, Comparex, StarTool, StarWarp, UltiMIS, ULTIMIZER, Eye-Spy, Eye-Spy/390, Detect+Resolve, SERNET, eChange Man and Change Transfer are registered trademarks of SERENA Software, Inc. Serena, Merge+Reconcile, FULL.CYCLE, eHealing, eFull.Cycle, eRequestMan, ChangeXpress, ChangeContent, StarProbe, StarSpy, StarTest, StarSuite, and SER10TY are trademarks of SERENA Software, Inc. IBM, IMS, DB2, DFSMShsm, RACF, MVS/ESA, and MVS are trademarks and registered trademarks of the International Business Machines Corporation in the United States, other countries, or both. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners. Publication Date: July 19, 2002
CONTENTS About This Book
9
Before You Begin Name Change Objective Audience Components / Scope Manual Organization. Related Publications. Support Using Online Help
9 9 9 9 9 11 11 12 13 13 13 13
Online Tutorial Online Help Screens Online Error Messages
Chapter 1:
Introduction What is the ChangeMan ZMF Administrator Guide ChangeMan ZMF Administrator Global Administrator Application Administrator Security Administrator ChangeMan ZMF Monitor General Administrator
Chapter 2:
15 15 15 16 16 16 16
What is ChangeMan ZMF? Change Packages Impact Analysis Checkout Staging Audit Recompile and Relink Freeze Promotion Approval Production Installation
19 19 20 20 21 21 22 22 22 23
3
Contents
Baseline Libraries and Delta Decks Backout Management Facilities Emergency Changes
Chapter 3:
Pre-Implementation Decisions Customizing ChangeMan ZMF for Your Site Modify Skeletons Implement Exits Establish Initial History Records
Managing Library Space Allocating Staging Libraries Allocating Baseline Libraries Allocating Promotion Libraries Allocation Production Libraries
Using Baseline Libraries for Production Libraries Setting Up Remote Sites for Production Libraries Setting Up Security Security Entities Securing Libraries Granting User Access
Setting Up User Restrictions Allow Temporary Change Packages Work Request and Department Number Required Planned Installation Calendar Disable Installation Calendar Normal Business Hours Overlay Prior Staged Component Checkout Enforcement Allow Concurrent Checkout Validate Version During Staging Staging Restriction Level Audit Level Designated Procedures Secured Components Approval Lists
Other Considerations Global Parameters for Staging Library Allocation Application Parameters for Staging Library Allocation Edit Staging Recovery Mode Query Of Available Users Options Keep Baseline By Site
4
23 23 24
25 25 25 25 26 26 26 27 27 27 28 28 29 30 33 34 35 35 35 36 36 36 36 37 37 37 37 38 38 38 39 39 39 39 40 40
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Remote Sites
Package Approvals Promotion And Demotion How Does Promotion Work Promotion Library Cleanup Promotion Security Promotion Rule Promotion Rule By Promotion Level Promotion Rule 0 First Promote Other Restrictions And Options Promotion Paths Approvals and Promotion Promotion Libraries In SYSLIB Concatenations
Enterprise Change Packages Staging Versions Staging Versions Installed Staging Versions Enabled Serena™ ChangeMan® M+R Licensed Considerations For Staging Versions
Implementation Checklist ChangeMan ZMF Administrator Duties
Chapter 4:
40 40 41 41 42 43 43 45 45 46 46 47 47 48 48 49 49 49 50 50 50 52
Setting Up Global Administration Accessing the Global Administration Options Setting up Global Parameters Defining Library Types And Staging Library Attributes Defining the Languages Defining the Compiling Procedures Defining Reason Codes Defining Sites Locking or Unlocking Application Definitions Setting the Planned Installation Calendar Creating or Updating the Global Notification File Enabling the Global Notification Facility Creating Global Notification Messages Updating the Global Notification Message
Accessing the Global Selectable Options Using Package User Records
55 56 72 79 80 81 82 86 88 90 90 91 92 94 95
5
Contents
Chapter 5:
Setting Up Application Administration How Global Settings affect Application Settings Accessing Application Administration Creating a New Application Updating Existing Applications Locks on Application Administration
Setting Application Parameters Defining Library Types And Staging Library Attributes Library Type Order Defining Library Types for a New Application Updating Application Library Types
Defining the Languages Defining the Compiling Procedures Setting Up Planned Approvals Setting Up Unplanned Approvals Defining Application Sites Defining Sites For A New Application Updating Application Site Information
Configuring Promotion Sites, Levels, and Libraries Promotion Definition Order Configuring Promotion For A New Application Update Promotion For An Application
Configuring Baseline Libraries Allocating Baseline Libraries
Defining Optional Component Descriptions, Procedure, and Security Defining Component General Information Deleting Components Updating the components in either component list.
Designate Optional Component Compiling Procedures Setting Component Security Specify the component to be updated. Access a Package Driven Security List. Complete the Component Level Security Panel. Delete a component’s security entries. Delete, enter or update component secured ID’s.
Deleting an Application Accessing the Application Selectable Options Panel Updating the Global Notification File Configuring Production Libraries Configuring Temporary Packages for ALL Sites
6
97 97 98 99 100 100 111 111 112 119 122 123 124 127 129 129 131 132 133 133 140 144 144 147 147 149 149 150 152 152 153 153 153 154 154 155 155 158 159
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Chapter 6:
Custom Modifications Initial Skeleton Modifications Customizing ChangeMan ZMF User Exits In ChangeMan ZMF ISPF Skeletons In ChangeMan ZMF ChangeMan ZMF Utilities
Chapter 7:
Monitoring Site and Application Packages Accessing the Monitor Option Panel Querying Package Information
Packages in Limbo Acting on Packages Closing a Super or Complex Package Manually Submitting a Package in Limbo for Installation
Installation Jobs Monitoring the ChangeMan ZMF Internal Scheduler Reviewing the Internally Scheduled Packages List Acting on the Packages
Chapter 8:
164 164 165 165 166 166 167 170 171 171
Configuring Remote Sites Overview of Remote Sites How does it Work? Setting Up Remote Sites Globally Maintaining Remote Sites Setting up Remote Sites for Applications Establishing a Remote Site - Global Administrator Selecting a Remote Site - Application Administrator Updating an Existing Site - Application Administrator Enabling the Network Data Mover
Chapter 9:
161 161 161 162 162
173 173 174 175 176 176 179 179 180
Defining and Running ChangeMan ZMF Reports ChangeMan ZMF Reports SAS or Assembler Report Programs Generating Reports With SAS Generating Reports Without SAS
Defining and Running Reports: Global Administrator Accessing Global Reports Run Reports: Global Administrator Baseline Analyzer Report: Global Administrator Link Date Report: Global Administrator
183 185 185 186 187 187 190 192 192
7
Contents
DB2 Object Dependency Report: Global Administrator
Defining and Generating Reports: Application Administrator Accessing Application Reports Define Reports: Application Administrator Run Reports: Application Administrator Baseline Analyzer Report: Application Administrator Link Date Report: Application Administrator DB2 Object Dependency Report
Baseline Analyzer Report Baseline Analyzer Report Sample Baseline Analyzer Report
Link Date Report Link Date Report Example Link Date Report Data
Chapter 10:
Housekeeping Tasks Cleaning Up Backup Libraries
Running Reports Log Activities (CMNBAT30)
207 207 208 214 219 221 222
Index
223
Bypass Cleanup of Backup Libraries Perform Package Processing for Backup Library Cleanup Perform Commit Processing for Backup Library Cleanup Considerations for Cleaning up Backup Libraries
8
193 193 193 194 196 198 198 199 199 199 202 204 204 205
ABOUT THIS BOOK BEFORE YOU BEGIN See the README for the latest updates and corrections for this manual. A printed copy of the README is included in the Serena™ ChangeMan® ZMF distribution box. The latest version of the README is available on the Serena eSupport self-service Web site at Support.Serena.com. After you logon, click FTP Downloads from the main portal, navigate to the Documentation folder, and then to the ChangeMan ZMF folder.
NAME CHANGE This document describes Serena™ ChangeMan® ZMF, Software Change Manager for z/OS & OS/390. This product of SERENA Software, Inc., was previously called Change Man. The new name more clearly reflects the role of the product in the Serena™ ChangeMan® family of products. Note that the product was also called Serena ChangeMan for z/OS & OS/390.
OBJECTIVE The ChangeMan ZMF 5.3 Administrator Guide provides information about how Serena™ ChangeMan® ZMF may be configured, and it provides instructions for administering that configuration.
AUDIENCE This document is intended for ChangeMan ZMF administrators. This document assumes no prior knowledge of ChangeMan ZMF.
COMPONENTS / SCOPE The members delivered in ChangeMan ZMF libraries include these components: •
SERNET (known previously as Serena/Network), which manages communication for ChangeMan ZMF and other Serena mainframe products.
•
Serena ChangeMan ZMF, which provides comprehensive, automated configuration management.
•
SER10TY License Manager, which manages SERtificates used to enable licensed Serena mainframe software on authorized CPUs.
9
About This Book
•
10
Components for all selectable options of Serena ChangeMan ZMF. If you license one or more of these options, the components are enabled through the SER10TY License Manager.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
MANUAL ORGANIZATION. This chapter…
Contains this information…
About This Book
Information about this publication. Contact information for Serena Software.
1
Description of the Administrator Guide; nomenclature, instructions for obtaining help.
2
Description of new features and functions of ChangeMan ZMF 5.3, notes on changes to user procedures.
3
Description of key concepts, package lifecycle, and library management.
4
Detailed discussion of functions and settings, and descriptions that must be made before implementation.
5
Detailed description of Global Administration panels and entries
6
Detailed description of Application Administration panels and entries
7
Instructions for managing failed installs and managing the internal scheduler.
8
Description of sites, instructions for setting up global sites.
9
Details about ChangeMan ZMF utility programs, their parameters and execution.
10
Description of ChangeMan ZMF exit programs and how they change system behavior.
11
Description of ChangeMan ZMF reporting functions, details about selected reports.
12
Detailed discussion of housekeeping (maintenance) tasks.
RELATED PUBLICATIONS. Title
Description
ChangeMan ZMF 5.3 Installation Guide
Step by step instructions for initial installation of ChangeMan ZMF. Assumes no prior version or that the existing version will be overlaid by the installation.
11
About This Book
Title
Description
ChangeMan ZMF 5.3 System Messages
Description of messages issued from ChangeMan ZMF, SERENET, and ChangeMan ZMF options.
ChangeMan ZMF 5.3 Customization Guide
Technical information about ChangeMan ZMF that is useful for modifying the delivered product to fit your needs.
These manuals are included on the Serena EPIC CD-ROM in Adobe Acrobat format. The files are password protected (case sensitive). The CD-ROM also contains the Adobe Acrobat Reader for viewing, searching, and printing the manual.
SUPPORT Serena Software provides technical support on the Internet through the Serena eSupport self-service Web site. To access the eSupport site, go to http://support.serena.com and login with your ID and password to see the eSupport Customer Portal. From there, you can: •
Report new issues.
•
Search our problem-tracking system for information about existing problems.
•
View a knowledge base of frequently asked questions and helpful product hints.
•
Query the call tracking database to obtain the current status of an open issue.
•
Access our FTP server to download product fixes and documentation in PDF format.
•
Subscribe to one of our mailing list servers (LISTSERVE) to receive the latest product information by e-mail.
If you need a password or ID, please e-mail or call the appropriate support department for your country United States, Canada
United Kingdom, Germany, Austria, France, Switzerland, BENELUX
Support Hours
Monday through Friday 5:00 A.M. to 5:00 P.M. (Pacific Time)
Monday through Friday 7:30 A.M. to 6:30 P.M. (United Kingdom Time)
E-mail
[email protected]
[email protected]
URL
http://support.serena.com
http://support.serena.com
Phone
877.696.1850
44 1494 765888
Facsimile
650.522.6698
44 1494 766888
For support in all other countries, please contact your local distributor.
12
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
For product questions or requests, you may need to first contact a designated representative in your company before calling Serena Customer Support.
USING ONLINE HELP Online help is the primary source of information about ChangeMan ZMF. Online help is available as a tutorial, through Help screens, and in ISPF error messages.
Online Tutorial ChangeMan ZMF includes an online Tutorial that provides information about its features and operations, from high-level conceptual descriptions to detailed descriptions of screen fields. To view the Tutorial Table of Contents, select option T from the Primary Option Menu or jump to it by typing =T and pressing ENTER. Press PF1 from anywhere in the Tutorial for a complete list of Tutorial navigation commands and PF keys.
Online Help Screens If you have questions about how a particular ChangeMan ZMF screen works, you can view a help panel by pressing PF1 from anywhere on the screen.
Online Error Messages If you make an invalid entry, or if you make an invalid request for a function, ChangeMan ZMF displays a short error message in the upper right corner of the screen. Press PF1 to display a long error message that provides details about the error condition. Remember that the long message does not display automatically. You must request the long message by pressing PF1.
13
About This Book
14
INTRODUCTION
1
WHAT IS THE CHANGEMAN ZMF ADMINISTRATOR GUIDE This guide is intended for ChangeMan ZMF global and application administrators as well as for security administrators. It assumes that the administrator has a thorough knowledge of ChangeMan ZMF functions, and is familiar with MVS™ and the security system in use.
CHANGEMAN ZMF ADMINISTRATOR As an administrator, your responsibilities depend on your administrative domain. You may be any or all of the following:
Global Administrator If you are the global administrator, it is your responsibility to set the high-level rules (called parameters) of your site's implementation process. They can be as restrictive or liberal as you choose. For example, you have the option to completely prohibit or allow your site's developers to check out components to their personal libraries. Note
Rules are set for ChangeMan ZMF users on two levels. The global administrator sets them first, and these choices can be further restricted on an application by application basis by the application administrator.
It is also your responsibility to specify to ChangeMan ZMF the systems with which it interacts and the details regarding the staging library allocation. For example, as the global administrator you may choose CA-Panvalet® as your baseline library storage means. You specify many other details, including procedures used for compiling (depending on languages for source), maximum allowance for schedule package installation on a daily basis, notification vehicles for people who need information on packages awaiting approval, and so forth.
15
Chapter 1: Introduction
Application Administrator If you are the application administrator, it is your responsibility to set rules of your application's implementation process. They can only be as liberal as the values which are set by the global administrator (although you can further restrict your users). For example, if the global administrator lets users at the site check components out to their personal libraries, you can restrict your users from checking out components to their personal libraries. But if the global administrator has already restricted their access, you cannot override the global administrator's decision and give them permission. Like the global administrator, you also set staging library information as well as determine compiling procedures for the languages used in your application's development. In addition, you configure the promotion libraries (if any) and baseline libraries used by your application. You create approval lists that are used by ChangeMan ZMF to notify strategic people in your development process that a change package is ready to be moved on to the next level of integration, testing, or into production. In fact, no matter whether you are a global or an application administrator, you are capable of running reports for the site or the applications; you may also be responsible for setting up remote site information (if you have remote sites).
Security Administrator As the security administrator, you assist and consult with the global and application administrators on site, user, library and component level security using the security package in use at your site. You are expected to be an expert in that system's functions and capabilities and you set up the overall security of your development process.
ChangeMan ZMF Monitor As a ChangeMan ZMF monitor, you oversee packages and work closely with users during the implementation process, and you may be involved in resubmitting installation jobs if there are problems at package installation time. Also, you have the ability to hold packages back from installation as well as change the status of packages in limbo.
General Administrator As the general administrator, you may be an expert in the periodic housekeeping tasks for ChangeMan ZMF such as starting up and shutting down each ChangeMan ZMF instance, updating the query information, backing up or recovering the package master, or clearing the activity log. You may customize ChangeMan ZMF by implementing user exits, using and updating the services, creating custom reports, setting up the SYSOUT facility, or updating skeletons. Finally, you may also be a specialist in setting up the administration for the many selectable options which can be purchased individually for the unique needs of your site.
16
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
All of the responsibilities described above, except for customizing ChangeMan ZMF skeletons and administration for selectable options, are described further in this document. Information about skeletons is contained in the ChangeMan ZMF Customization Guide, and the selectable option information is contained in the individual selectable option manuals. The global, application, and monitor administrative domains described above require that you have been defined to the individual security entities as such. See “Setting Up Security” on page 28 for further details.
17
Chapter 1: Introduction
18
WHAT IS CHANGEMAN ZMF?
2
ChangeMan ZMF is a software change management product that integrates, automates, and controls the essential components of the software management lifecycle. With ChangeMan ZMF, the implementation of effective software management control is simplified.
CHANGE PACKAGES A Change Package is a grouping of all the components (Source, Copybook, Load, JCL, control cards, compiling procedures, documentation, and other components) required to implement a software change into production. You can build Change Packages for any type of change, including permanent, emergency, temporary, simple, and complex changes. A variety of information can be associated with a Change Package. For example, reasons for the change, contingency plans, special implementation instructions, work request numbers, and contact lists can all be captured when the Change Package is created. All Change Packages are referenced in the Package Master, a control file that contains the significant information regarding current and previous Change Packages. At creation time, a unique Change Package number is assigned to facilitate cross referencing. When a programmer adds components to a Change Package, that information is added to the Package Master.
IMPACT ANALYSIS To analyze the impact of changes, many organizations rely on data from a variety of sources, such as batch library scans and cross reference files. This method makes it difficult to maintain all sources of data and verify that they are current. ChangeMan ZMF provides a comprehensive facility to capture, query, and enforce relationships between components. These relationships include not only the traditional ones, such as a source and executable relationship, but also other relationships based on common references to copybooks, SQL Include components, CA-Panvalet® ++INCLUDE components, CA-Librarian® - INC components, Called Subroutines, and JCL fields such as program name, filename, or data set name.
19
Chapter 2: What is ChangeMan ZMF?
CHECKOUT Checkout enables you to reintroduce components residing in baseline or promotion libraries to the change cycle. Generally, production level components are checked out for modification. However, you can check out any previous version of a baseline component. Depending on how ChangeMan ZMF is configured, one can check out components: •
To personal libraries
•
To staging libraries
•
Only if they are associated with change packages
•
In batch
•
Online
•
Concurrently with other components
If your site has applications that require parallel development, you can configure ChangeMan ZMF to allow concurrent checkout of components. ChangeMan ZMF has an automated process for managing this concurrent development. As part of this process, ChangeMan ZMF ensures that each owner of a version is aware of the actions of the other owners. After you check out components and make necessary modifications, ChangeMan ZMF records the components and the associated change package for further impact analysis. This ensures that your developers are always working with the proper version of a component.
STAGING Staging is the process of introducing newly developed (or previously developed) components into the change cycle for modification or enhancement, and packaging with related change package components. When you stage a component, ChangeMan ZMF recognizes the type of component that you are staging and copies it into a staging library of corresponding type (source, load, JCL, documentation, copybook, etc.). Staged components are also associated with a pre-defined change package, which is the vehicle used to move components through the change cycle and track the history of change management activities for each staged component. In change management systems other than ChangeMan ZMF, staging libraries are merely pre-production holding areas shared by one or more application groups. After components are tested in development libraries, they are copied into staging libraries prior to production implementation. ChangeMan ZMF staging libraries are more than pre-production holding libraries. Components can be modified and tested in protected ChangeMan ZMF staging libraries. Moreover, when you stage source components, they are compiled and the resulting load modules are identified, helping you to maintain the integrity of source-to-load relationships.
20
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
In addition, ChangeMan ZMF maintains up-to-date records of all staging activities for packages and components. For example, when you stage a source component, the time that the component was staged is recorded, along with the name of any associated load modules, or copybooks, and the compiling procedures and linkage parameters used during the compile. This information is kept in ChangeMan ZMF's master file, the package master. You can view this component and package information any time by using the query function. ChangeMan ZMF further extends the concept of staging by providing a means of isolating components from other changes in progress. This prevents uncontrolled and unknown copybooks and subroutines from being inadvertently referenced, allowing parallel or concurrent development without the risk of accidental overlays. The stable coexistence of multiple versions of a single component simplifies the blending of changes.
AUDIT The ChangeMan ZMF audit process enables you to ensure correct synchronization of components and procedures. Because of the range of features offered by the Package Master and the Impact Analysis database, ChangeMan ZMF maintains control of current and past modifications and component versions. Therefore, potential production problems can be identified before they impact production. The audit function inspects the staging library contents of an evolving change package with respect to baseline library contents. The inspection looks for situations such as a package that shows no change from the baseline library, or a package that contains an LOD component that does not match its SRC component. Recognizing such out-of-sync situations helps you detect code that is inconsistent with your development procedure and other code problems. Examples of out-of-sync situations that the ChangeMan ZMF audit addresses include: •
Copybooks that have been changed after a source program has been compiled.
•
Source programs that must be recompiled due to a copybook change.
•
Called subroutines that have been changed after a referencing source program has been compiled and linked.
With ChangeMan ZMF you can enforce by application whether you want an audit, and if so, whether you want to correct or leave potential uncovered problems.
RECOMPILE AND RELINK The Recompile and Relink functions are intended to introduce components into packages in special circumstances. Neither Recompile nor Relink copies the source into the package, but instead keeps the output of the process. This may be helpful if: •
A copybook has changed, but not the referencing source (Recompile).
•
The source code is not available for a driver, but a change is made to a subroutine (Relink).
21
Chapter 2: What is ChangeMan ZMF?
•
It is necessary to perform a composite link where the resulting load component name does not have accompanying source (Relink).
Both Recompile and Relink use the component’s history from the package master. For example, Relink picks up the link options that were used when the program was last compiled. Both Recompile and Relink can be used to resolve certain types of out-of-sync situations found during the audit of a package.
FREEZE Another unique ChangeMan ZMF feature is the ability to freeze Change Packages. When the Change Package is ready for the next phase of the change implementation lifecycle, a freeze is performed to prevent further modifications. The freeze also positions the Change Package for promotion or approval. Traditional methods accomplish this function by moving components from the development libraries to a separate set of libraries or, in some cases, separate environments. ChangeMan ZMF controls your updates in conjunction with your security system, so component movement is no longer necessary. If further modifications are required, you can unfreeze a Change Package, and the approval process is reset.
PROMOTION ChangeMan ZMF has the ability to promote Change Packages through multiple shared, pseudo-production promotion environments. These promotion environments are secured as if they are production, and ChangeMan ZMF controls all updates. ChangeMan ZMF considers shared promotion environments a place where full integrated system testing may be performed. When the time comes for a full system or an integrated system test, authorized approvers promote the acceptable components into the promotion environments. When testing is complete and the Change Package is approved, ChangeMan ZMF removes the components from the promotion environments. All production installation occurs from the Change Package staging environment. With ChangeMan ZMF, you define your testing methodology and the number of testing levels that are required.
APPROVAL Approvals for change package installation are performed online, eliminating the requirement for manual approval processes. During the ChangeMan ZMF approval process, authorized approvers can indicate that the change package is acceptable for production implementation, or they have the option to reject or review the change and generate a checklist of questionable or unclear items for the programmer to resolve.
22
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
ChangeMan ZMF relies on your security system; it does not use internal personnel tables. Approval lists of specific USERIDs or approving entities are defined to your security system so that electronic approvals can be collected. For each application, a variety of approvers can be included on the approver list. Separate approval lists can be created for scheduled, planned changes and for unplanned, emergency changes, or you can choose to use an approval hierarchy. With ChangeMan ZMF, you have the flexibility to make these choices.
PRODUCTION INSTALLATION ChangeMan ZMF is actively involved in the management and control of actual production component installation. Component installation can be automated through the ChangeMan ZMF internal scheduling system, or through the ChangeMan ZMF direct interface with a job scheduling system. In addition to component movement, ChangeMan ZMF performs other production installation activities such as DB2 Plan binding. ChangeMan ZMF also has a unique change quantity threshold facility that allows you to control the number of changes that occur in a given time period. For example, you may want to limit the number of change packages that are installed during month-end processing.
BASELINE LIBRARIES AND DELTA DECKS ChangeMan ZMF recognizes that your software components are a vitally important business asset. It gives you the ability to store your production source components in a structure that works for your organization. Components can be stored in PDS’s, CA-Librarian files or CAPanvalet files. Components can be segregated by application or by categories, such as batch versus online. Equally, applications can share libraries. ChangeMan ZMF automatically stores prior versions of components. These versions can be stored as full copies (inherent for load components), or as delta decks. It uses a unique reverse base/delta technique known as stacked reverse deltas. With this technique, the current version of the component is the base, and delta decks are created to backtrack to previous versions.
BACKOUT MANAGEMENT FACILITIES Comprehensive backout management requires more than simply backing up the components of a change. In addition to backing up the source, it is important to recreate the executable component from the source and ensure that the recreation takes place properly. ChangeMan ZMF has comprehensive backout management facilities. In addition to source components, the prior functioning executable components can be automatically backed up. If a backout becomes necessary, ChangeMan ZMF automatically restores these executable components to production. It also performs all necessary DB2 Plan rebinding automatically.
23
Chapter 2: What is ChangeMan ZMF?
Because ChangeMan ZMF is package driven, it backs out all the components of a change automatically.
EMERGENCY CHANGES Critical abends occur at inopportune times and require immediate attention. Because ChangeMan ZMF contains the ability to create Unplanned Change Packages, and the ability to maintain a separate list of approvers for unplanned changes, emergency changes are safe, fast and easy to perform. Additionally, because of the facility (optional) to concurrently check out components, ChangeMan ZMF provides notification to any developer affected by the change so that the emergency fix can be incorporated globally into all change packages. ChangeMan ZMF does not impede the emergency change process by requiring that the component be released, reassigned, or renamed by the original owner.
24
PRE-IMPLEMENTATION DECISIONS
3
This chapter provides you with important considerations that you may take up after ChangeMan ZMF has been installed, but before you set it up for your sites, applications, and users.
CUSTOMIZING CHANGEMAN ZMF FOR YOUR SITE Modify Skeletons For most batch processing jobs, ChangeMan ZMF uses a library of customized ISPF skeletons. Skeletons consist of programming logic and variables, and you communicate with them through the values entered on ChangeMan ZMF panels. In the appropriate skeleton, these values are substituted for variables, creating the JCL and other parameters necessary for submitting batch jobs. (See the “Serena™ ChangeMan® ZMF Skeleton Reference” manual about tailoring skeletons.)
Implement Exits ChangeMan ZMF contains exits, which are routines that you can modify and implement to customize different user tasks in different functions. (See the Serena™ ChangeMan® ZMF Customization Guide).
Establish Initial History Records ChangeMan ZMF keeps information about components (also called history) in the Component Master file. This information includes compile and link options for the component. These options are used during the compile, recompile and relink processes. It may be beneficial to pre-load this information before components are accessed through ChangeMan ZMF. CMNBAHST allows you to establish an initial history record for components. (Utility CMNBAHST is described in the Serena™ ChangeMan® ZMF Customization Guide.)
25
Chapter 3: Pre-Implementation Decisions
MANAGING LIBRARY SPACE To build, distribute, install and back out change packages, ChangeMan ZMF allocates and accesses a number of data sets. There are administrative functions at the global and application level that provide you with the capability to enter and update information about how these data sets are named and allocated. ChangeMan ZMF provides modules that you can implement to help you manage library space more effectively. See the descriptions of SEREX001, CMNEX015, and CMNEXINS. The staging libraries are always allocated using PDS; the other libraries may be allocated using whatever storage method your site prefers. Since there is only one backup of production (called the hot backup), it is stored using PDS (independent of how you specify the storage means for the actual library.)
Allocating Staging Libraries The staging library allocation is always managed through the administration panels during set-up. (See “Setting Up Global Administration” on page 55)
Allocating Baseline Libraries ChangeMan ZMF baseline libraries may be pre-allocated outside of ChangeMan ZMF, or the application administrator may allocate PDS baselines through ChangeMan ZMF during application set-up. The following table describes the ways you can store the production and prior versions of components in baseline libraries.
26
Storage Means
Number of Levels Stored
Comments
Full PDS
2-10
The production version of a component is stored in full PDS format. There is an additional PDS library for each prior version level.
Stacked Reverse Delta
2-999
The production version of a component is stored in full PDS format. Prior versions are stored in proprietary reverse delta deck format. All reverse delta decks are stacked in a single PDS library.
Librarian
2-10
The production version of a component is stored in a CA-Librarian file. There is an additional CALibrarian file for each prior version level.
Librarian Archie
2-255
The production version of a component and all prior versions are stored in a single CA-Librarian file.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Storage Means
Number of Levels Stored
Comments
Panvalet
2-10
The production version of a component and all prior versions are stored in a single CA-Panvalet library.
Reverse Delta Deck PDS
2-10
The production version of a component is stored in full PDS format. Prior versions are stored in proprietary reverse delta deck format. There is an additional PDS library of reverse delta decks for each prior version level. Note: This storage means is obsolete for new baseline libraries, but existing baselines with this storage means are supported.
Allocating Promotion Libraries Promotion libraries must be allocated outside of ChangeMan ZMF administration. After the libraries are allocated, they are defined to ChangeMan ZMF while setting up Promotion (“Configuring Promotion Sites, Levels, and Libraries” on page 132)
Allocation Production Libraries See “Using Baseline Libraries for Production Libraries” on page 27 below for a discussion of baseline versus production libraries. If you decide to use production libraries, they are allocated outside of ChangeMan ZMF. The section “Configuring Production Libraries” on page 158 explains how to define the libraries.
USING BASELINE LIBRARIES FOR PRODUCTION LIBRARIES ChangeMan ZMF has the ability to synchronize baseline libraries and production libraries. This can be useful when development and production processing occur in different locations. If your production applications run at the same site as your baseline libraries, you may not need to set up separate ChangeMan ZMF production libraries. Remember, ChangeMan ZMF baseline libraries can be standard PDS’s and can be accessed by external tasks. Eliminating ChangeMan ZMF production libraries where possible could result in significant DASD savings.
27
Chapter 3: Pre-Implementation Decisions
SETTING UP REMOTE SITES FOR PRODUCTION LIBRARIES An alternative to using baseline libraries for your production libraries is to set up additional ChangeMan ZMF subsystems. This allows you to segregate packages still in development from production level packages. You define one subsystem as your development site and the additional subsystems as remote sites where production level packages can be distributed and installed. Baseline libraries reside at the development site and production libraries are kept on the remote site CPU. You set up remote sites during global administration by configuring your ChangeMan ZMF subsystems as either D (Development site) or DP (Development and Production site) for the subsystem you designate as your development site, and P (Production site) for the subsystem you designate as your production site. If you initially invest in a single subsystem, but are planning to incorporate remote site subsystems in the future, configure your single subsystem as DP, not ALL. Setting up as an ALL site enables you to have both development and production libraries on a single CPU, but prohibits you from attaching remote sites.
SETTING UP SECURITY ChangeMan ZMF allows you to choose the security system which is used in your environment as a control layer between users and sensitive ChangeMan ZMF functionality, projects, and data. ChangeMan ZMF supports CA-ACF2®, RACF®, and CA-Top Secret® as security systems. We have attempted to provide enough detail in this section to help you set up the security that ChangeMan ZMF requires. However, this section is not intended to replace your security package documentation. Read the manuals provided with your security product if there are questions about specific procedures related to that product. It is recommended that the global administrator defines the entity names for the resources. The global administrator must have direct authority or the immediate assistance of other people who are responsible for security changes. When using ChangeMan ZMF, users must first pass the security system check to log on to TSO. The user then attaches to the ChangeMan ZMF subsystem. ChangeMan ZMF is now in control and can perform security checks on the user's TSO ID to determine their authorization level. ChangeMan ZMF ties into the security system to ensure that only authorized users have access to certain functions. For instance, only those TSO ID's assigned to a particular application may create change packages, and only specific ID's may approve those packages for installation into production.
28
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Security Entities The way ChangeMan ZMF allows only specific people access to certain functions is by the use of entity names. Some of these names are fixed by internal convention, while others are decided entirely by your administrators. A single TSO-ID, multiple TSO-IDs, or a group name can be associated with the entity name to allow access to the restricted functions. When a user attempts to perform a potentially sensitive function, ChangeMan ZMF performs an “entity check.” This check is posed to your security system - CA-ACF2, RACF, or CA-Top Secret. If the user's TSO ID is associated with the entity name, he is allowed to proceed. Otherwise, a message is displayed on screen stating the user's lack of authorization. Of course, anyone may sign on to ChangeMan ZMF to use non-restricted functions such as querying packages, reviewing the log, and using the Tutorial. Setting up the necessary security is a two phase operation for some functions. First, ChangeMan ZMF must be defined to your security system; then, the security information must be defined to ChangeMan ZMF. The following table lists the expected entity names, the function they apply to, and whether they require definition in ChangeMan ZMF. The first five entity names, prefixed CMN, are fixed names and are always checked at the beginning of a session. The Serena™ ChangeMan® ZMF Installation Guide directs your efforts in producing these entities. Entity
Function
Define to ChangeMan ZMF
CMNGBADM
Global Administration authority
Associated TSO-ID’s or groups
CMNLCADM
Application Administration authority
Associated TSO-ID’s or groups
CMNREVRT
Revert authority
Associated TSO-ID’s or groups
CMNBKOUT
Backout authority
Associated TSO-ID’s or groups
CMNMON
Monitor authority
Associated TSO-ID’s or groups
(varies)
Staging restriction level
Define when setting application parameters
(varies)
Checkout restriction level
Define when setting application parameters
(varies)
Application approvers
Define when setting application approval
(varies)
Application promoters
Define when setting application promotion
3 to 4 character application mnemonic
Application users
Associated TSO-ID’s or groups
29
Chapter 3: Pre-Implementation Decisions
The last five entities are optional and installation dependent. They are determined by the administrators. (See “Setting Up Global Administration” on page 55 for setting global parameters and see “Setting Up Application Administration” on page 97 for setting application parameters.) Administrators, approvers, and promoters must also be application users to gain access to specific applications.
Securing Libraries One of the fundamental design criteria of ChangeMan ZMF is that it guarantees the source/ load relationship. This can only happen if ChangeMan ZMF alone has access to the source code staged and the load component created. Through your security system, you can ensure that ChangeMan ZMF has exclusive access to application baseline libraries, production (temporary, backup) libraries, and staging libraries. For each application, you can authorize specific users read only access or no access to their application libraries. ChangeMan ZMF must be defined to your security system as a Resource Class, as a started task, and given proper authority to update, create, and delete data sets. Naturally, ChangeMan ZMF would never delete your baseline libraries, but it must be the only one to update them with the most current versions in production, as well as maintaining prior versions. Likewise with the production, temporary, and backup libraries in your production environment, users must be denied access (and ChangeMan ZMF allowed access) to ensure the source/load relationship.To accomplish this, refer to your security system's manuals. The individual package staging libraries are created and updated by users, but only through ChangeMan ZMF. So, again, only ChangeMan ZMF is allowed create and update access.
30
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
BKUP
DATA SET USER
SECURITY
PROD TEMP Production
ACF2, RACF & TOP SECRET
Change Man
-2 -1
Multiple Access Levels 0
Baseline CPY
USER
LOD
Read Only Access SRC
Staging
The following table shows the libraries, the recommended format for generic names, and the access level required by ChangeMan ZMF. Only RACF and CA-Top Secret systems require the protection steps listed; CA-ACF2 sites must define the ChangeMan ZMF instance with access to all data sets and by default so that users do not have access to the libraries. (RACF and CA-Top Secret's use of ALTER is equivalent to CA-ACF2's use of ALLOC.) Library
Recommended Format
RACF
CA-Top Secret
CA-ACF2
Baseline
prj.BASE.*
Update
Update
Update
Development (optional)
prj.DEV.*
Read/Update
Read/Update
Read/ Update
Staging
prj.CMNSTAGE.*
Altera
Altera
Altera
Updateb
Updateb
Updateb
Updateb
Updateb
Updateb
Promotion Production
(your target library names)
31
Chapter 3: Pre-Implementation Decisions
Library
Recommended Format
RACF
CA-Top Secret
CA-ACF2
Temporary
prj.TEMP.*
Updateb
Updateb
Updateb
Backup
prj.BKUP.*
Updateb
Updateb
Updateb
a.
b.
Alter is required when using CMNUPDAT or CMNCOPY with the REALLOC parameter as ChangeMan ZMF must be able to delete and reallocate a data set. CMNUPDAT is run mainly in the installation jobs against Baseline and Production libraries. The ChangeMan ZMF Administrator must determine whether or not to allow ChangeMan ZMF to reallocate these libraries via the REALLOC parameter of CMNUPDAT. Update if the user will be editing in place from stage of a non-ChangeMan ZMF controlled development library. Read if just a simple stage from a non-ChangeMan ZMF controlled library.
Baseline Recommendations If you use the stacked reverse delta format (SRD), baseline 0 should probably have UPDATE access, while baseline -1, etc. should probably be given ALTER access. The reason has to do with the format of the baseline -1 file. Normally, this file starts relatively small and grows over time at a steady rate, thus the file must be constantly reallocated. By comparison, the baseline 0 file remains approximately static in size after compression. If the SRD format is not used, then UPDATE should be sufficient for both baseline 0 and baseline -1 and following.
Production and Temporary Recommendations The production and temporary libraries have a different consideration than baseline libraries. Often they start small and continue to grow. If the growth is substantial then ALTER access may be needed, otherwise, UPDATE access should be sufficient. Development (or Personal) Recommendations If you want to stage components from an external development library, ChangeMan ZMF must have read access to that library or that request fails. If you want to check out components to an external development library, ChangeMan ZMF must have write access to that library or that request also fails. It is recommended that ChangeMan ZMF be granted read/update access to all external data sets that users may stage from or check out to. Thus, access to many hundreds of data sets may be required. Such extensive access does not allow users to read/update development data sets if they do not also have personal access. ChangeMan ZMF determines a user's personal access to a development data set before acting upon the request. For example, assume that ChangeMan ZMF has read/write access to the development data set CMN.DEV.SOURCE . A ChangeMan ZMF user must have at least read access to this data set before staging from it. Personal write access is required before ChangeMan ZMF permits the checkout of components to this data set.
32
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Granting User Access ChangeMan ZMF operates under the userid of the SERNET started task. A ChangeMan ZMF user request is processed using the authority of the SERNET userid, not the authority of the user's logon ID. Access to system resources are granted to the SERNET userid through your security system. For example, if a user initiates a COBOL compile during a ChangeMan ZMF session, it appears as though the user has submitted a batch job. Actually, the JCL was submitted by the ChangeMan ZMF instance through SERNET in response to an authorized user request. If the user attempts to run a similar process outside of ChangeMan ZMF, the update of protected libraries must be disallowed. The following areas must be considered when setting up security, specifically granting user access to: •
Session utility data sets.
•
Batch job submission.
•
Viewing and purging batch job output.
Refer to the Serena™ ChangeMan® ZMF Installation Guide or the individual security system documentation for details on RACF, CA-ACF2, or CA-Top Secret.
Session Utility Data Sets ChangeMan ZMF may allocate a number of utility/work data sets during each user session. These data sets are cataloged, manipulated, and (normally) deleted by ChangeMan ZMF automatically. Processes that use these data sets fail if installation security prohibits their creation. Affected functions include: •
ISPF file tailoring of all batch jobs
•
Editing of staging data sets
•
On-line file comparisons
•
Baseline browse
The default naming convention for these utility data sets allocates data set names that start with the concatenated value of ISPF variables &ZPREFIX and &ZUSER. However, by use of exit CMNEXINS it is possible to tailor the data set names to reflect your installation’s naming conventions. In many installations, this means that the data sets begin with the value of the user's logon ID. ChangeMan ZMF must have allocate access to data set names that begin with the logon ID of all potential ChangeMan ZMF users. If such access is contrary to security policies, an exit is available to vary the utility data set names so they conform to installation requirements.
Submitting Batch Jobs •
User Initiated Requests - Compiles, Batch Checkout, Or Audit
33
Chapter 3: Pre-Implementation Decisions
The user is presented with a job card that may be changed before submission. Most often, users want to run jobs that begin with their logon ID. In the same manner that ISPF handles the printing of its own log and list data sets, ChangeMan ZMF appends an alphabetic character and/or automatically increments it between job submissions. For example, after job USER01A is submitted, the next suggested job name is USER01B. (The user may type over this value.) •
Implementation Jobs - Production Install And Baseline Ripple Except for the job name, job cards are built with information supplied via the global and/or application administration parameters. The default implementation job names begin with the 3 to 4 character application mnemonic, followed by the last two digits of the ChangeMan ZMF skeleton, followed by the last 2 to 3 digits of the change package number. For example, the baseline ripple JCL is built using skeleton CMN30. The baseline ripple job name for package “ABCD000123” would be ABCD3023. The baseline ripple job name for package “XYZ000456” would be XYZ30456.
Both categories of jobs are submitted by ChangeMan ZMF and run with the access associated to the SERNET started task. The SERNET instance requires authority to submit jobs with variable job names, account codes, and other job card parameters. If such access is contrary to security policies, an exit is available to restrict and/or vary the job card information that is allowed.
Viewing and Purging Batch Job Output Users normally access SDSF, IOF or some other output manager to see the output of the jobs they have run. ChangeMan ZMF users may want to view (and possibly purge) the output of the jobs they have initiated via the ChangeMan ZMF instance. Installations may limit the jobs that a user may access on the output queue, particularly if they were initiated by an alternate logon ID; i.e., ChangeMan ZMF. Such restrictions should be removed and/or access should be granted to a range of job names, and potential ChangeMan ZMF users should be advised of what job names they can or cannot access.
SETTING UP USER RESTRICTIONS A primary function of ChangeMan ZMF is to protect and regulate your valuable code. To do this, there are specific choices to be made about ChangeMan ZMF functions. For example, do you want to allow two users to work on the same component at the same time? Many of these choices are set by parameters in ChangeMan ZMF itself. Part of this implementation of ChangeMan ZMF is setting these parameters in the global and application administration functions. By setting these parameters, you further define the functions the end users have and access. In the above example, the parameter would be “Allow Concurrent Checkout”. If this parameter is set to “no”, only one person can work on the component at any given time. “Setting Up Global Administration” on page 55 and “Setting Up Application Administration” on page 97 detail the set up requirements and identifies some of the policies you may want to set.
34
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Allow Temporary Change Packages A temporary change package is not permanent and may never be rippled into baseline. It is automatically deleted from production after a specified number of days (the user provides this information). The staging library contents associated with temporary change packages are placed into temporary libraries which are concatenated ahead of production libraries. They are never rippled into baseline and are deleted from the temporary libraries after a specified number of days by ChangeMan ZMF. If the you restrict this option, the user is not allowed to select this change package option during package creation. If you allow temporary packages, users are required to enter the number of days the package is to remain in production after installation (duration number of days).
Work Request and Department Number Required The work request number as well as the department number can be used to track change packages in certain ChangeMan ZMF batch reports. They can also be used to select viewing of package information within the Query function. If you require all applications (and their users) to enter a work request number or a department number during change package creation, then users are not allowed to finish creating a change package without entering this information. (ChangeMan ZMF performs no validation checks on the number, but only that one is entered.)
Planned Installation Calendar If you are the global administrator, you can set up a Planned Installation Calendar which limits the maximum number of planned changes that can be installed for any given date in the forthcoming 52 weeks. See “Setting up the Installation Calendar” in “Chapter 4. Setting up Global Administration”. Setting the maximum number to zero stops any planned package from being planned for installation on that date (unplanned change packages are not restricted by the calendar). This a zero implies a non business day. A planned package cannot be scheduled for installation on a date that has already reached its maximum limit. For the user, this information is accessible from the Dates option in the Build Change Package Menu. The user does not update the actual calendar. During package creation, they enter the desired installation date for each remote site selected to receive the package. ChangeMan ZMF verifies that the date is available and increments the calendar accordingly. If the date entered is not available (either the maximum allowable packages have been met or the date is blocked), the user is not be able to create the change package until a valid date is entered. Unplanned change packages are not affected by this calendar.
35
Chapter 3: Pre-Implementation Decisions
Disable Installation Calendar This option allows you to completely disable the Planned Installation Calendar. When a user creates a change package, ChangeMan ZMF only checks the install date to verify if it is a valid date, and disregards the maximum packages criteria.
Normal Business Hours The application Planned Approval list is incorporated into any change package that is created within normal business hours. An unplanned package uses the Unplanned Approval list if it is created outside of normal business hours. Normal business hours are defined in Global Administration Parameters.
Overlay Prior Staged Component This situation only occurs if more than one user is attempting to re-stage components within a change package. (Of course, all users may stage and re-stage components as many times as they need to, but this option refers to two or more users working in the same change package and attempting to re-stage [overlay] each other's components.) If overlaying a previously staged component is allowed, ChangeMan ZMF issues a warning to the user requesting the staging of an already-staged component (already staged by another user within the same package), and inform the first user that the component has been overlaid.
Checkout Enforcement You can set the checkout enforcement rule such that if a component exists in baseline, it must be checked out before it can be staged. There are levels to this rule:
36
Level
Rule
1
Any component may be staged regardless of whether it exists in baseline or has been checked out to a package. ChangeMan ZMF does not check for the component's existence in the baseline libraries.
2
Users attempting to stage a component that exists in the baseline but has not been checked out must pass a security system ENTITY CHECK before the stage can proceed. The entity name is specified in the application parameter generation. Staging is not allowed if the user does not pass the entity check.
3
Disallow anyone from staging a component which exists in the baseline library but has not been checked out to the package requesting the stage.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Allow Concurrent Checkout This rule is used to dictate whether a user can check out components that are already checked out to another package. It only applies to planned packages, not emergency packages.
Validate Version During Staging This option validates the component versions during staging. If the same component is in motion in two different packages, the first package to baseline ripple can force the user of the other package to halt development and recheckout the latest version of the component.
Staging Restriction Level This option restricts who is allowed to stage NEW components. New components are not yet associated or checked out to a package. Level
Rule
1
All users can work on new components. This means they can stage components that are not yet associated with a packages (called development driven staging) as well as stage component that are associated with a package (called package driven staging).
2
Allows only users who have been defined to a special entity by their TSO ID to stage new components. Otherwise, they can only check out and stage components that are associated with a change package.
3
Does not allow you to stage new components, only ones currently associated with a package. This effectively disables development driven staging.
Audit Level You cannot freeze the change package without passing audit. The Audit Level in application administration sets the maximum return code that audit may produce and still allow your change package to pass the audit: Audit Code
Explanation
0
Audit is never required. It may be performed, but this is optional.
1
Audit is required but any return code (except ABEND) is acceptable.
2
Audit is required but the return code must not exceed (12). This means that there are out-of-sync situations within this set of staging libraries
37
Chapter 3: Pre-Implementation Decisions
Audit Code
Explanation
3
Audit is required but the return code must not exceed (8). This means that there are no out-of-sync situations within the staging libraries but there are out-of-sync situations within the baseline.
4
Audit is required but the return code must not exceed (4). This means that there are no out-of-sync situations in both staging and baseline sets of libraries, but there is at least one component of a staging library that is identical to the corresponding component in baseline (duplicate).
5
Audit is required but the return code must not exceed (0). This means that there are no out-of-sync situations and no duplicates.
Designated Procedures If the administrator has chosen to designate a compiling procedure for one of the application's components with force level 1, then any user wishing to freeze a change package with the selected component MUST perform the last stage request with the designated procedure. ChangeMan ZMF allows staging with alternate procedures during package development, but the final stage (before attempting to freeze) must be performed with the designated compile procedure for each component. If force level 2 is chosen, then any user wishing to stage the component must use the designated compile procedure. When designating a procedure for the component, the application administrator may have entered extra compile and/or link options (you can use CMNEX025 for component level parsing).
Secured Components If the administrator has chosen to secure one of the application's components to specific TSO-ID's, generic TSO-ID's, or to an Entity, then ONLY the TSO IDs associated with the component are allowed to check out or stage the component during change package development.
Approval Lists The administrator has set up a list of approvers for this application's change packages, entity names associated with each approver description, and whether the approver will be called upon to approve packages (generated for another application) which impact this application. More than one TSO ID can be associated with each entity name so that packages can be approved when your regular approver is absent. When unplanned packages are created outside normal business hours, only the abbreviated list of approvers needs to be met. However, the installed package remains on the list of packages to be approved until the complete approval list is met. (This is called “Post Approval” and it is intended to facilitate emergency change packages.)
38
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
OTHER CONSIDERATIONS Global Parameters for Staging Library Allocation If you are the global administrator, you set up a model for the staging data set names, size allocation specifications, and types of libraries to be allocated, so that each time a user creates a change package, the package's staging libraries are allocated based on certain standards. The data set names follow this model: •
Four consecutive question marks “????” must appear where the application mnemonic (three or four alphanumeric characters) is to be substituted.
•
Seven consecutive pound signs “#######” must appear where the package number (.#000123) is to be substituted.
•
Example:????.CMNSTAGE.#######
•
Result: DEMO.CMNSTAGE.#000001.SRC
Application Parameters for Staging Library Allocation If you are the application administrator, you determine which library types are required to be generated as staging libraries for each application. If you choose to defer staging library allocation, ChangeMan ZMF does not allocate the library type at package creation time. (The user has the option during package creation to request allocation of any of the deferred library types.) If the user makes a stage/checkout request for any component of the deferred type, then the staging library is automatically allocated based on the size parameters chosen for the application.
Edit Staging Recovery Mode This application level parameter causes ChangeMan ZMF to store all of the user's edits to change packages so that they can recover them in the event that their TSO session fails. After the failure, upon reentering ChangeMan ZMF, they have a choice of recovering or canceling the recovery. If you set the recovery mode to off then the user's profile also has recovery mode set to off. If you turn it on (after it has been off for a period of time) the user needs to reset their profile. Otherwise, the recovery process does not work. Have the user complete the following steps to reset their user profile after you update this parameter. 1. Access any Package Driven List (you can do this through staging, recompiling or relinking). 2. Edit a component by typing E next to the package you want to edit. 3. Type profile at the command line. The user profile information is displayed. 4. Type recover on (or recover off) at the command line.
39
Chapter 3: Pre-Implementation Decisions
Query Of Available Users Options Beginning with Version 4.1.0, you can query source component staging information after the package has been frozen. If you implement customized user option panel names, or add customized panels and want to enable users to query information about them, edit panels CMNQRY22, CMNSTG04, CMNSTG05, CMNRCMP1. Link each of these four panels to any user option names or panels you have customized.
Keep Baseline By Site If the baseline is kept by site, each remote site's set of baseline libraries are maintained by applications at the development site, and users are required to select from a remote site list when making requests from baseline, such as checkout or utility rename/scratch.
Remote Sites The global administrator has determined whether or not there are any remote production sites, how to transmit to them, and by what name they shall be known. The application administrator has chosen from the global list only those remote sites that are appropriate to application; thus the application's users may send change packages only to the remote sites designated for the application. (The user may select any or all of the remote sites from the application's list.)
PACKAGE APPROVALS The application administrator must set up two approval lists for each application. •
Planned Approvals This list of approvals is automatically incorporated into all planned packages. It is also included in unplanned packages that are created during normal business hours. Normal business hours are defined in application administration.
•
Unplanned Approvals This list of approvals is automatically incorporated into unplanned packages that are created outside of normal business hours, which are defined in application administration.
Unplanned Approvals are intended to provide an alterative list of approvers for emergency changes that are urgent and may be needed at a time when approvers in Planned Approvals are not available. Important considerations when defining Planned and Planned Approvals in application administration include: •
40
The type of approval list incorporated into an unplanned package depends on system time that the package was created and on the definition of normal business hours in application administration. The package install time is not considered.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
•
If an unplanned package is created with Unplanned Approvals, the Planned Approvals are added to the package after the package is installed. The package is displayed on the CMN120 Unplanned Packages Pending Post Approval report until all approvals are granted. An approval that is defined in both Unplanned and Planned Approvals does not need to be approved a second time.
•
Approvals that are defined as Linked Package Approver in the Planned and Unplanned Approval lists are included in a package only when a package is linked to other packages using Serena™ ChangeMan® Enterprise Change Portal.
•
Approvals may be dynamically added to packages at Freeze by exit program CMNEX009 based on package conditions such as the presence of a library type or a the existence of a value in a Package User Variable.
•
Restrictions can be placed on who can approve a package by setting Approval Restrictions in Application Parameters.
•
The order of approval notification is influenced by the Hierarchical Approval Process indicator in Global Parameters.
PROMOTION AND DEMOTION Promotion is a ChangeMan ZMF facility that applies the changes in a package to libraries used for testing and other purposes. Promotion can populate libraries used for: •
Batch testing where test libraries are coded in STEPLIB or JOBLIB statements in common application testing JCL.
•
Online testing where application testing libraries are coded in region JCL.
•
Unit testing where libraries are loosely controlled and populated by any developer who wants to run a test.
•
Quality Assurance test libraries that must be tightly controlled and can only be populated by the QA testing coordinator.
•
Training environments where software changes must be available for training classes before they are installed into production.
•
Any purpose that requires package components to be copied into a fixed set of libraries.
How Does Promotion Work Promotion copies components from package staging libraries into libraries that an enterprise uses for application testing or other purposes. Promotion may also be configured to execute additional processes to prepare promoted components for execution. Such processes might include CICS PHASEIN, DB2 bind, and IMS™ gens. Demotion deletes components from libraries that were populated by promotion. Demotion may also execute processes such as CICS PHASEIN, DB2 bind, and IMS gens to adapt an environment to the changes made by demotion.
41
Chapter 3: Pre-Implementation Decisions
Each set of libraries that promotion can target is represented by a promotion level. The ChangeMan ZMF Administrator defines promotion levels for each application with the library types that can be promoted and the names of the libraries that are targeted for each type. Library types for promotion usually include the executable components in your package and may also include nonexecutable types like source code. However, a promotion level does not have to include all library types in an application. Each promotion level is defined under a site. Promotion can populate libraries and prepare executables on local sites, which means environments that are on the same MVS image as the ChangeMan ZMF server. Promotion can also populate libraries and prepare executables on remote sites, which means environments that are on MVS images separate from the image where the ChangeMan ZMF server runs. Full promote and demote operate at the package level. All components in a package that are eligible for promotion are promoted or demoted together. The current promotion level is recorded at the package and the component level. Selective promote and demote operate on individual components in a change package. The package promotion level remains the same, but the component promotion level changes. Since application test libraries are often shared with other developers and projects, promotion looks for potential overlays by comparing the names of package components eligible for promotion against the directories of the target libraries. The person promoting the package is given a choice whether to proceed and overlay matching components in the promotion libraries or cancel the promotion request. Promotion must not be confused with the physical movement of components through a series of test libraries and into production libraries. Promotion always copies components from package staging libraries into target promotion libraries. Likewise, at baseline ripple and install, package components are copied from package staging libraries into baseline and production libraries.
Promotion Library Cleanup ChangeMan ZMF is delivered with the promotion facility configured to provide the maximum level control over the contents of promotion libraries. Promotion can be configured to satisfy other priority requirements. In the maximum control configuration, when a package is promoted from one level to another, promotion libraries at the prior level are cleaned up. ChangeMan ZMF deletes the components from the libraries in the prior promotion level, unless a component originally promoted from the package was overlaid by promotion from another package. Promotion libraries are also cleaned up when a promoted package is baselined or installed. This configuration assumes that promotion libraries used for testing are concatenated over baseline libraries or production libraries or copies of these libraries. The objective is to guarantee that if no packages are promoted to a set of test libraries, those libraries are empty, and the test environment behaves exactly like production because it is running only production components.
42
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
In some testing environments, such as those that use databases and/or data dictionaries, it is not possible to concatenate promotion libraries over production libraries. Components must accumulate in the promotion environment as packages are cycled through development, testing, and install. To satisfy this requirement, ChangeMan ZMF skeletons must be modified to disable promotion library cleanup at promotion, demotion, and install. If promotion cleanup is disabled, the package lifecycle must be carefully analyzed to discover when orphans might be inadvertently left in promotion libraries, and when package components might not be copied to a particular accumulation library at all.
Promotion Security Each promotion level in an application is associated with a security entity, which is defined in the mainframe security system (RACF, CA-ACF2, or CA-Top Secret). By working with the security administrator to grant or deny userid access to the promotion security entities in the security system, the ChangeMan ZMF administrator can limit who can promote and demote packages in a particular promotion level. For example, all developers might be permitted to promote packages to a unit test promotion level. Only Quality Assurance test coordinators might be permitted to promote packages to a QA test promotion level.
Promotion Rule The behavior of the promotion function is governed by the Promotion Rule. The administrator selects a Promotion Rule for each application that provides the level of management for change packages, components, and promotion libraries that is required by the application.
43
Chapter 3: Pre-Implementation Decisions
The following table describes how the Promotion Rule determines the requirements for promoting and demoting packages and components. Rule 0
Restrictions Full and selective promote and demote are allowed without freezing the package first. Requires the following sequence to change a promoted component:
1
•
Selective unfreeze (only if the package is frozen)
•
Edit
•
Stage (“Restage”)
•
Selective freeze of the component (only if the package is frozen)
•
Selective promotion to any level up to the package promotion level.
Requires that the package be frozen for promote and demote. Requires the following sequence to change a promoted component:
2
•
Selective demote of the component
•
Selective unfreeze
•
Edit
•
Stage
•
Audit package
•
Selective freeze of the component
•
Selective promotion back to the package promotion level.
Requires that the package be frozen for promote and demote. Requires the following sequence to change a promoted component:
44
•
Selective demote of the component
•
Selective unfreeze
•
Edit
•
Stage
•
Audit package
•
Selective freeze of the component
•
Selective promotion through all intermediate levels to the package promotion level.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Rule 3
Restrictions Requires that the package be frozen for promote and demote. Requires the following sequence to change a promoted component:
4
•
Full demote of the package
•
Selective unfreeze of the component
•
Edit
•
Stage
•
Audit package
•
Selective freeze of the component
•
Full promotion through all promotion levels up to the original promotion level.
Requires that the package be frozen for promote and demote. Requires the following sequence to change a promoted component:
Note
•
Full demote of the package
•
Revert the package to development status
•
Edit
•
Stage
•
Audit package
•
Freeze package
•
Full promotion through all intermediate levels to the package promotion level.
The Promotion Rule does not change the requirements for audit. If audit is required before freeze, then audit is required before selective freeze.
Promotion Rule By Promotion Level Normally, all promotion levels in all sites in an application are governed by the Promotion Rule coded in application administration parameters. However, the level of control over promotion usually differs between lower promotion levels used for developer unit testing and higher promotion levels used for systems testing, quality assurance testing, and user acceptance testing. exit program CMNEX027 can be used to assign different promotion rules to different promotion levels. This exit can also be used to assign other promotion restrictions to individual promotion levels.
Promotion Rule 0 If the Promotion Rule is set to 0 for an application (or for a promotion level with exit program CMNEX027), many promotion controls are relaxed. These relaxed rules may be appropriate for certain uses like populating libraries used in early component testing.
45
Chapter 3: Pre-Implementation Decisions
In addition to the requirements listed in the Promotion Rule table above, the relaxed controls for Promotion Rule 0 include: •
Components that are not ACTIVE that are in library types eligible for promotion are bypassed and a message is displayed.
•
Re-staging a component sets the component promotion level to 0. The package promotion level is not changed.
•
Package may be promoted to levels that are not the next contiguous level.
Promotion Rule 0 must be used with caution because it allows different visions of a component to exist in promotion libraries and staging libraries.
First Promote When a package is at promotion level 0 (not promoted), special procedures apply to the first promotion action. These procedures, specially in combination with Promotion Rule 0, can be useful for promoting individual package components for testing before the entire package is ready for testing. •
A package component may be selectively promoted when the change package is at Level 0 (not promoted). A selective promote in these circumstances is labeled a first promote.
•
When all components are promoted to the same level as the first promote, the package promotion level is changed to that level. The package may be fully promoted or demoted from this new level.
•
After a first promote, a package cannot be promoted until all components are selectively promoted to that level.
Other Restrictions And Options These are general rules for promoting and demoting packages and components:
46
•
Except for first promote, a component cannot be selectively promoted to a promotion level higher than the package promotion level.
•
Except for first promote, the package promotion level is set only by a full promotion. The package promotion level is reset after a full demotion, not after all components have been selectively demoted.
•
A package may not be promoted or demoted if components are at different promotion levels above the 0 level. Components may need to be selectively promoted or demoted to align components at the package level.
•
A package may not be promoted to the current package promotion level. A component may not be selectively promoted to its current component promotion level.
•
Promotion or demotion for local sites is accomplished in one batch job. Promotion or demotion for remote sites requires three batch jobs, one of which runs at the remote location.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
•
All promotion jobs that are initiated on the user’s MVS image obtain JOB card information from the Promote Options Panel. Promotion jobs that run at remote sites obtain JOB card information from the Site Definition in application administration. Job names for jobs that run at remote sites may be modified with exit program CMNEX008.
Promotion Paths When promotion is defined for an application, the administrator creates each promotion level under a site defined in Application Administration. The administrator can set the Force Demotion field for sites in the promotion definition to allow packages to be promoted to levels in more than one site at the same time. Sites may also be defined so that packages must be demoted in other sites before they can be promoted to levels in that site. Levels, sites, and the Force Demotion field may be configured to provide multiple promotion paths within the same application. Here are some alternative promotion path definitions. •
Define each level under a unique site so that the Force Demotion field can be used to allow promotion or any or all promotion levels at the same time.
•
Define all levels under one site to provide a single promotion path for all packages. If there is only one promotion site defined in an application, the promotion function skips over the site selection panel when a package is promoted or demoted.
•
Group promotion levels under several sites to create multiple promotion paths. There might be a path for packages with online system changes and a different path for packages with batch system changes.
•
Use sites for special promotion purposes. A promotion level with training environment libraries as targets might be defined under a unique site. A package containing new software would be promoted to this level on a certain calendar date to support training classes no matter where the package was promoted in other sites.
Approvals and Promotion Approvals and promotion are separate facilities. •
Users authorized to promote packages to a level may promote frozen packages to that level no matter what approvals have been granted.
•
Users authorized for approval can approve frozen packages no matter where a package may be promoted.
•
The last approver initiates distribution and/or scheduling regardless of the last promotion level reached.
The package lifecycle always requires approvals. The package lifecycle does not require that packages be promoted before they are baselined and installed. However, security entities for promotion and approvals may be used to provide a procedure that mixes promotion privileges with approval responsibility, as in the following example:
47
Chapter 3: Pre-Implementation Decisions
•
The QA coordinator is permitted update authority to a promotion security entity to allow her to promote packages to the QA test environment.
•
The QA coordinator is permitted update authority to an approval security entity to allow her to enter an approval labeled “QA Testing”.
The QA coordinator should only approve a package for “QA Testing” after she has promoted the package, the package has been tested, and she has examined QA test results. Note
Planned and Unplanned Approval definitions include an “Order No.” field. When this field is incorrectly called an “approval level”, users often confuse its purpose with the function of a “promotion level”.
Promotion Libraries In SYSLIB Concatenations Library concatenations for SYSLIB DD statements in compile and link edit JCL are automatically build by ChangeMan ZMF skeletons. These skeletons put staging libraries at the top of the concatenation and baseline libraries at the bottom. Promotion libraries are placed between staging and baseline libraries. You may exclude individual promotion libraries from these SYSLIB concatenations by coding the SYSLIB Exclude field in the promotion library definition in application administration. The SYSLIB Exclude field only has meaning for like-copy and like-load library types.
ENTERPRISE CHANGE PACKAGES Change packages on multiple ChangeMan ZMF instances and change packages on multiple Serena™ ChangeMan® DS servers can be linked to provide a cross-platform software change lifecycle. These enterprise change packages are managed by Serena™ ChangeMan® Enterprise Change Portal (ECP). When ChangeMan ECP links a ChangeMan ZMF change package to other packages, ChangeMan ECP takes control over parts of the package lifecycle. After a package is linked, these functions can be performed only through ChangeMan ECP: •
Freeze
•
Revert
•
Final approval
The link package function in ChangeMan ZMF is enabled by the global and application administrators, who set the Allow Linked Packages parameter in Global and Application Administration Parameters. The application administrator also sets up planned and unplanned approvals that can be approved only through ChangeMan ECP. The LNK PKG field on these approvals must be set to YES, and the security entity for these approvals must be restricted to enterprise change package coordinators who use ChangeMan ECP.
48
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
STAGING VERSIONS The staging versions facility can save an unlimited number of versions of a package component that a developer might create in a staging library between the time the component is first added to the package and the time the package is baselined. Staging versions may be created only for components that can be edited from the Stage: Package Components panel. Staging versions are stored as full copies in a compressed format in a VSAM file. Each version may be labeled with an optional 35-character description. Some features of staging versions are available if the staging versions facility has been installed. More features of the staging versions facility are available for package components in a library type if the facility has been enabled for the library type by the application administrator. The merge facility of staging versions is only available if your company has licensed Serena™ ChangeMan® M+R.
Staging Versions Installed The staging versions facility is installed if the HPSPLIB and HPSIN DD statements are included in the SERNET started procedure for the ChangeMan ZMF instance. These features are available if the staging version facility has been installed: •
The “VC” Staging Selection Code can be used to display the Version Control panel for any component that is on the Stage: Package Components panel.
•
The Version Control panel always shows a STG version and usually a BAS version. These versions are pointers to the component in the staging library and baseline library respectively.
•
From the Version Control panel, the STG and BAS versions can be browsed, viewed, and compared.
Staging Versions Enabled The staging versions facility may be enabled for a library type by setting the Save Staging Versions parameters in Global and Application Library Types. These features are available in library types for which the staging version facility has been enabled. •
Users can add a component change description each time they create a new version of a package component on the Stage: Package Components panel.
•
Users can save a staging version whenever they change a component on the Stage: Package Component panel.
49
Chapter 3: Pre-Implementation Decisions
•
The administrator can make ChangeMan ZMF create a staging version every time a staging library member in the enabled library type is changed, or ChangeMan ZMF can ask if the user wants to overlay the component in the staging library without first creating a staging version.
•
From the Version Control panel, the user can browse and view staging versions.
•
Users can compare any two staging versions listed on the Version Control panel.
•
Administrators can delete staging versions listed on the Version Control panel.
Serena™ ChangeMan® M+R Licensed If your company has licensed ChangeMan M+R, and your administrator has installed the software, you can merge three to eight versions listed on the Version Control panel to create a new version of the component. ChangeMan M+R is automatically invoked, and the Base and derivative versions are automatically assigned.
Considerations For Staging Versions You must consider the following issues before you decide to install or enable save staging versions: •
If the staging versions facility is installed, ChangeMan ZMF reads one of the staging version VSAM files whenever a user performs a function that replaces a member in a staging library. This VSAM read might have an adverse affect on ChangeMan ZMF response time.
•
If the staging versions facility is installed and enabled for a library type, ChangeMan ZMF writes to the save staging version VSAM files whenever a user saves a staging version. This VSAM write might have an adverse affect on response time.
You can disable staging versions for a library type by changing the Save Staging Versions parameter to NO in the library type definition in Application Parameters. You can de-install the staging package facility by removing the HPSPLIB and HPSIN DD statements from the SERNET started task JCL. You can then delete the three staging version VSAM files.
IMPLEMENTATION CHECKLIST The following checklist is a high-level overview of the steps to implement ChangeMan ZMF. Some of the items have been covered in more detail earlier in this chapter. Since every site is different, and every implementation needs to be tailored for your specific needs, this checklist is only a suggestion of the steps you may wish to take. Most implementations are done one application at a time. The first application may be a real application in your shop, or a test application set up to become familiar with ChangeMan ZMF.
50
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. Form an Implementation Team. This team usually consists of security personnel, application leads, application programmers, systems programmers, operations analysts, managers, et cetera. These are the people that can make and carry out the decisions necessary to implement ChangeMan ZMF. 2. Form an Application Test Team. This team should consist of someone who could perform program tests where required and someone that is extremely familiar with your existing change control process and/or compile and link edit procedures. Additionally, someone that is familiar with ISPF skeletons would be a large plus but this process could be learned if required. Your security administrator must be on alert as changes are needed periodically during the initial phases of implementation. 3. Conduct an implementation planning session with appropriate staff to determine how ChangeMan ZMF will help control the current environment and what the flow of the entire process should be. 4. Identify ALL libraries that will be managed by ChangeMan ZMF for the application. 5. Locate ALL compile/link edit procedures that will be required for integration into ChangeMan ZMF for the application. If current procedures are in skeleton format, all skeletons must be expanded and all symbolic variables must be resolved. This means that you have to review all the options for the compile/link edit procedures. 6. Identify ALL language types that will be required for integration into ChangeMan ZMF for the application (i.e., ASM, COBOL, DB2, CICS). If multiple versions of a language are required, that must also be noted. Each of these languages must have compile/link edit procedures that have been identified above. 7. Ensure the installation security package has been altered properly as outlined in the security portion of the ChangeMan ZMF documentation. This must include the set up of required ChangeMan ZMF entity names, association of the appropriate userids to those entity names, and set up of the proper data set access rules for the ID associated with the subsystem. 8. Have two TSO ID’s available for use in ChangeMan ZMF. •
The first ID must have the following privileges: — All five ChangeMan ZMF entity privileges — External authority for update of custom skeleton library
•
The second ID is a standard TSO ID with no additional authority to ChangeMan ZMF. This ID only has access to a specific application, and it must not have any administrative capabilities. It is used for testing/debugging the system. Remember to grant this ID access to data sets and batch jobs as outlined earlier in this chapter.
9. The subsystem should be brought up, security resource rules established and set up for a test application, and the global and application administrative parameters should be defined with liberal rules. These initial administrative decisions may be made more restrictive later as you become more familiar with the product. Finish setting up the test application by defining libraries, languages, procedures, et cetera. (These processes are detailed in Chapter 4 and Chapter 5 of this Administrator Guide.)
51
Chapter 3: Pre-Implementation Decisions
10. If you are using the DB2 option, the installation procedures for DB2 should be followed, ensuring that the ID associated with the subsystem has SYSADM OR BIND/ADD authority for all DB2 programs. For more information on the DB2 option see the Serena™ ChangeMan® ZMF DB2 Option manual. 11. Identify all ChangeMan ZMF exits that will assist in the enforcement of shop standards for customization, if required. (See the Serena™ ChangeMan® ZMF Customization Guide) 12. Have test programs for each of the above language types so that the STAGE process may be completely tested. The resultant size (length) of the linked component is a good indicator of the ChangeMan ZMF process producing an equivalent load component to the one currently in production. In other words, the load components should be the same size if the skeletons invoked the same compile/link edit procedures. Running a parallel test of those components is a final test. When the above tasks have been completed, you are ready to move through a phased implementation of ChangeMan ZMF. Many of the above tasks must be performed for each new application that is moved under ChangeMan ZMF control, for example, identifying the libraries necessary. Other tasks, such as setting up the subsystem security rules, are one time only items and do not need to be performed again.
CHANGEMAN ZMF ADMINISTRATOR DUTIES The person who will become the ChangeMan ZMF administrator should be very involved in the implementation process. Not only will this help familiarize the administrator with the product, but he/she can be involved in the decisions about functions that he/she may later have to teach to users. In addition, the administrator traditionally has many other duties in the supervision of ChangeMan ZMF. They can include:
52
•
Consider the implementation needs of your sites, including space allocation for libraries as well as security needs. (See “Setting Up Global Administration” on page 55.)
•
Set global parameters for your ChangeMan ZMF installation. (See “Setting Up Global Administration” on page 55.)
•
Consult on and/or set application parameters. (See “Setting Up Application Administration” on page 97.)
•
Set the global and/or application parameters for remote sites. (See “Configuring Remote Sites” on page 173.)
•
Produce and browse reports for your sites or specific applications. (See “Defining and Running ChangeMan ZMF Reports” on page 183.)
•
Customize ChangeMan ZMF for your site. Customization includes the implementation of exits and tailoring skeletons. (See the Serena™ ChangeMan® ZMF Customization Guide.)
•
Continually monitor ChangeMan ZMF for packages in limbo as well as packages whose installation you wish to expedite or prohibit “Monitoring Site and Application Packages” on page 163.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
•
Periodically execute housekeeping functions such as starting up and shutting down the ChangeMan ZMF instance, backing up the Package Master, clearing the logs, updating the query component relationship information. (See “Housekeeping Tasks” on page 207.)
•
Act as primary contact for questions, problems and suggestions forwarded to Serena Customer Support.
53
Chapter 3: Pre-Implementation Decisions
54
SETTING UP GLOBAL ADMINISTRATION
4
This chapter explains how to set up and change global administration for your ChangeMan ZMF instance. Some entries in global administration define general use parameters and functions. Other global administration entries limit the range of choices available when defining parameters and functions for applications.
ACCESSING THE GLOBAL ADMINISTRATION OPTIONS Perform these steps to access the Global Administration Options panel. 1. On the ChangeMan ZMF Primary Option Menu, select option A and press ENTER. The Administration Options panel is displayed: CMNADMOM ------------------- ADMINISTRATION OPTIONS --------------------------OPTION ===> A Application - Perform application administration functions G Global - Perform global administration functions Press ENTER to process; Enter END command to exit.
2. On the Administration Options panel, type G and press ENTER. The Global Administration Options panel is displayed: CMNGAMEN --------------- GLOBAL ADMINISTRATION OPTIONS --------------------OPTION ===> 1 2 3 4 5 6 7 D I N O R S
Parms Library Language Procedures Reason Codes Sites Lock/Unlock Dates Impact Notify Options Reports Skeleton
-
Generate global parameters Generate library types Generate language names Generate compiling procedures Generate reason codes for unplanned packages Generate site information Lock or unlock application parameters Update the installation calendar Perform impact analysis maintenance Update the global notification file Configure selectable options Generate Change Man batch reports Create, update, and test skeleton procedures
Press ENTER to process; Enter END command to exit.
55
Chapter 4: Setting Up Global Administration
SETTING UP GLOBAL PARAMETERS As a global administrator you can set parameters to govern the action of users. If you set these global parameters liberally, you allow the application administrator more choice in configuring ChangeMan ZMF at the application level. The application parameters can be more restrictive than the global parameters, but they cannot be more liberal. This allows more control over sensitive applications while allowing other applications more latitude. Note
The rules you set up for ChangeMan ZMF during global administration are not application specific—they affect all applications.
To setup the global parameters, complete the following steps, which consists of accessing five Global Parameters panels. 1. From the Global Administration Options menu (CMNGAMEN), select option 1. The Global Parameters Part 1 of 6 panel (CMNGGP01) is displayed: CMNGGP01 -------------- GLOBAL PARAMETERS - PART 1 OF 6 --------------------COMMAND ===> SUBSYSTEM: M
RLS option: YES
CHANGE MAN ENVIRONMENT JOB ENTRY SYSTEM SITE NODE NAME LOGICAL UNIT OR SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL SECURITY SYSTEM CHANGE MAN SECURITY RESOURCE INSTALLATION JOB SCHEDULER SCHEDULER INTERVAL IF CMN TRANSMISSION VEHICLE NORMAL BUSINESS HOURS: FROM AGING - INSTALLED PACKAGES - STAGING DATASETS
===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===>
A (A/D/DP/P) JES2 (JES2 or JES3) U510ALL P393 3390 (Generic disk unit) SAF $CHGMAN CMN 005 IEBCOPY 0001 32 8
(SAF, RACF, ACF2, or TSS) (CMN, Manual or Other) (Minutes) (IEBCOPY or Other) TO ===> 0002 (HHMM format) (0 to 999 days) (0 to 999 days)
Press ENTER to process; Enter END command to exit.
The following table describes the fields of the Global Parameters Part 1 of 6 panel (CMNGGP01) and the valid information that you can enter in the fields.
56
Field
Description
SUBSYSTEM
Displays the subsystem ID that you are currently logged onto
RLS option
Type Yes or No to indicate whether you wish to activate record level sharing (RLS). An activated RLS allows several ChangeMan ZMF instances to run different applications and share the same package master.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
CHANGEMAN ENVIRONMENT
Type one of the following: A (All environment has both development and production on one machine. It does not manage libraries in ChangeMan ZMF P (production) environments. D (Development environment allows change packages to be built, approved, promoted, distributed to remote sites, rippled into Baseline libraries, but not installed into Production libraries. This choice is appropriate for a data center where changes are developed, but where production processing does not occur. DP (Development and production environment allows change packages to be built, approved, promoted, distributed to remote sites, rippled into Baseline libraries, and installed into Production libraries. This choice is appropriate for a data center where changes are developed, installed into production, and distributed to remote sites for production installation. P (Production environment is a production center, also referred to as a remote site. No development is performed on this machine) Note: Once you choose an environment type, do not change it.
JOB ENTRY SYSTEM
Type the name of the job entry system (JES2 or JES3) used at your site.
SITE NODE NAME
Type a common name or nickname for this ChangeMan ZMF instance.
LOGICAL UNIT OR SYSTEM NAME
Type the logical unit or system name (SMF ID) where this ChangeMan ZMF instance runs.
DEFAULT UNIT NAME
Type the generic unit name for DASD to be used for dynamic allocations for this ChangeMan ZMF instance. This field may be left blank if DEFAULT VOLUME SERIAL is used.
DEFAULT VOLUME SERIAL
Type the DASD volume serial number to be used for dynamic allocations for this ChangeMan ZMF instance. This field may be left blank if DEFAULT UNIT NAME is used.
SECURITY SYSTEM
Enter the name of the security system used at your site. This field must match the setting in the SERLCSEC module. See the Serena™ ChangeMan® ZMF Installation Guide. SAF is an acronym for System Authorization Facility, an interface defined by MVS that enables programs to use system authorization services to protect access to resources such as data sets and MVS commands. SAF provides a common interface for IBM RACF, CA-ACF2, and CA-Top Secret where your security rules are defined. If you use TCP/IP to communicate with ChangeMan ZMF, it must use SAF to interface to your security system.
57
Chapter 4: Setting Up Global Administration
Field
Description
INSTALLATION JOB SCHEDULER
Enter the default scheduling system that displays to users when they are building a change package (in the Installation Instructions panels). The scheduling system controls the submission of the package installation batch jobs. CMN The ChangeMan ZMF internal scheduling system. Allows a user to change this field to either CMN or MANUAL when specifying change package information. When packages use the CMN scheduler, ChangeMan ZMF monitors can delay installation or install the packages early. See “Chapter 8. Monitoring Site/Application Packages” for details. MANUAL Allows a user to manually control the submission of installation and de-installation jobs. Causes the installation process to begin as soon as the package is approved. Package installation can be inhibited by holding the last approval or the package can be installed immediately by approving the package before the scheduled installation date and time. Prohibits the user from changing this field when specifying change package information. OTHER An external scheduler such as CA7, ADC2, CA-Scheduler, and so forth. OTHER causes ChangeMan ZMF to submit a batch job to add the package install job information to the scheduler's database. You must modify skeleton CMN17 to include the batch interface for your site's scheduling system. Allows the user to change this field to either CMN, MANUAL, or OTHER when specifying change package information.
SCHEDULER INTERVAL IF CMN
Specify how often ChangeMan ZMF checks for packages ready to be installed if CMN is the job scheduler type. Enter the information in the MMM format (minutes). The available range is from 1 to 255.
TRANSMISSION VEHICLE
Enter the data transmission vehicle that ChangeMan ZMF uses to transmit messages, change packages, and other data between the development system and the production systems at the remote sites. This variable is used in file tailoring the install jobs. IEBCOPY You can use IEBCOPY if there are no remote sites and DASD is shared between the development and production environments. If your site is an ALL or a DP environment, this field must be IEBCOPY. (Since no real data transfer takes place within both of these environments, only a copy utility is needed.) OTHER Enter OTHER to use a different transmission vehicle.
NORMAL BUSINESS HOURS
58
Enter the time range describing the normal business day in military notation (HHMM).
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
AGING: INSTALLED PACKAGES
Enter the number of days a package record is to remain within the Package Master itself. The package must be in BAS, INS, or TCC status for this value to take effect. Once the aging criteria set here have been met, the package can be deleted through a housekeeping job. We recommend that this value be set at 500. Note: The choices you make here and in the AGING:STAGING DATASETS field described below affect DASD to the extent that the package records continue to take up space until they are deleted.
AGING: STAGING DATASETS
Enter the number of days that staging data sets from a package remain in the systems catalog. The corresponding change package must be in BAS, INS, or TCC status for this value to take effect. To delete the Staging data sets after the package is installed, run the appropriate housekeeping jobs to either delete or archive the package records (see “Chapter 9. Housekeeping Tasks”). The housekeeping job for deletion of the Staging data sets removes them after the aging criteria have been met. After the housekeeping job deletes the Staging data sets for a package, a user can no longer back out the package. The installed package record must exist in the Package Master at the time that its associated staging libraries are deleted. Thus, the installed packages value must be greater than or equal to the staging data sets value.
2. When you have completed entering information on the Global Parameters Part 1 of 6 panel (CMNGGP01) and press ENTER. The Global Parameters Part 2 of 6 panel (CMNGGP02) is displayed: CMNGGP02 -------------- GLOBAL PARAMETERS - PART 2 OF 6 ----------------------COMMAND ===> BASELINE: STACKED REVERSE DELTA PANVALET LIBRARIAN KEEP BASELINE BY SITE REQUIRE WORK REQUEST NUMBER REQUIRE DEPARTMENT NUMBER DISABLE INSTALLATION CALENDAR ALLOW TEMPORARY PACKAGES PROCESS PARTICIPATING PACKAGES BY INSTALLATION DATE HIERARCHICAL APPROVAL PROCESS APPROVER NOTIFICATION VEHICLE: SERNET BATCH ALLOW DESIGNATED PROC OVERRIDE USE GLOBAL NOTIFICATION FILE ALLOW APPLICATION UPDATE TO FILE GLOBAL NOTIFICATION FILE ===>
===> ===> ===> ===> ===> ===> ===> ===>
YES YES YES NO NO NO YES YES
(Y/N) (Y/N) USER DEFINED ===> NO (Y/N or LAM) (Y/N) (Y/N; affects INFO) (Y/N) (Y/N) (Y/N)
(Y/N)
===> NO (Y/N) ===> YES (Y/N) ===> YES (Y/N) ===> YES (Y/N) ===> NO (Y/N) ===> YES (Y/N) ===> YES (Y/N) PROD99.PROFSERV.CMN510N.NOTEFILE
Press ENTER to continue; Enter B to go back 1 screen, or CANCEL to exit.
59
Chapter 4: Setting Up Global Administration
The first five fields of the panel specify the storage means for back levels of Baseline libraries. Except for CA-Panvalet and CA-Librarian, the current level of any baseline library is configured as a PDS. The storage means for the back levels of each particular Baseline library are selected by the Application Administrator (under the Baseline option) based on the means allowed here. A YES in one of these fields lets the Application Administrator choose to use one of these formats for libraries, and enables a particular library format during Application Administration. A NO prevents the Application Administrator from using this storage means, and disables this format during Application Administration.
60
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following describes the fields of the Global Parameter Part 2 of 6 panel (CMNGGP02) and the valid information that you can enter in the fields. Field
Description
STACKED REVERSE DELTA
Enter YES to allow use of the Stacked Reverse Delta format. This storage means uses one PDS for the (0) level, and a second PDS for the -001 through -999 levels. Backup levels are stored in compressed form. This option optimizes disk space utilization. Enter NO to disallow the use of this option.
PANVALET
Enter YES to let users keep backup levels of baseline in CA-Panvalet libraries. This option lets ChangeMan ZMF stage from a CA-Panvalet file and check out from and to a CA-Panvalet file. The systems installer must generate and compile the component SERIFACE, with the CA-Panvalet interface turned on before you choose this option. Enter NO to disallow use of this option.
LIBRARIAN
Enter YES or LAM if you have CA-Librarian Masters. This choice lets ChangeMan ZMF stage from a CA-Librarian file and check out from and to a CA-Librarian file. Enter LAM if you use Library Access Method. (CA-Librarian 3.6 or higher is required.) Use LAM if you plan, during testing, to concatenate PDS COPY libraries with baseline. For example: //SYSLIB // // //
DD DISP=SHR,DSN=CGMZ.CMNSTAGE.#000123.CPY, SUBSYS=LAM DD DISP=SHR,DSN=CMNBASE.LAM.CPY, SUBSYS=LAM
This option implies that you have generated SERIFACE for CA-Librarian. Enter NO to disallow use of this option. USER DEFINED
Enter YES to allow another type of library organization be used. This choice requires file tailoring of install skeletons. It implies that you have generated CMNIFACE for Other. Enter NO to disallow use of these other types of library organizations.
61
Chapter 4: Setting Up Global Administration
Field
Description
KEEP BASELINE BY SITE
Enter YES to allow the Development (D) or Development (DP) Production site to keep a set of Baseline libraries for each additional site that has been generated within their ChangeMan ZMF system. Use if an application has multiple sites, and you want to maintain Baseline libraries at each site. With YES, you receive subsequent prompts at baseline library definition, and package build, to indicate which site is being selected. Enter NO if remote site Baseline libraries are not to be maintained. When you enter NO, the Baseline libraries are only kept at the DP or D site. NO is the recommended option because it: Prevents duplications of DASD Makes the maintenance of skeletons easier Keeps multiple sites synchronized Note: You can only select one site at package creation time and all checkouts are from the baselines associated with that site. You cannot install to two sites in the same package when you keep baselines by site. Audit only runs against the baselines/site selected at package create time and only the baseline/site libraries selected at that time are concatenated in batch jobs for that package. Use package query (option Q.P) to see which sites were included in the package.
REQUIRE WORK REQUEST NUMBER
Enter YES to require users to enter a work request number during package creation.
REQUIRE DEPARTMENT NUMBER
Enter YES to require users to enter a department number during package creation. Enter NO to let the entry of a department number be optional.
DISABLE INSTALLATION CALENDAR
This option lets the Global Administrator disable the Planned Installation Calendar. When you create a change package, ChangeMan ZMF only checks the install date to verify if it is a valid date, and disregards the maximum packages criteria.
Enter NO to let the entry of a work request number be optional.
Enter YES to let users specify any date for the schedule installation date of packages. Enter NO to dictate the scheduling of package installation by the Planned Installation Calendar. ALLOW TEMPORARY PACKAGES
Temporary change packages are placed into production and concatenated ahead of Production libraries. They are never rippled into Baseline and are deleted from the production environment after the number of days specified at package creation. Enter YES to let temporary change packages be created. Enter NO to disallow users to create temporary change packages
62
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
PROCESS PARTICIPATING PARCKAGES BY INSTALLATION DATE
* This option is for audit. Audit can process participating package groups within a Complex or Super package base on the installation date of participating packages. Participating packages defined to a Complex or Super package that have not been baselined and have installation dates that are equal to or earlier than the participating package containing the component to be compiled or link-edited are included as part of the SYSLIB concatenation. Enter YES to process and audit participating packages within a Complex or Super package by the installation date. Enter NO to process and audit all participating packages defined to a Complex or Super package.
HIERARCHICAL APPROVAL PROCESS
Enforce the numeric approval sequence specified in the Order Number field of the Planned Approvals and Unplanned Approvals in application administration. When the approval sequence is enforced, notification is sent to userids and e-mail addresses in coded in User(s) to Notify only when approvals at lower is executed as each approval becomes “pending” approval. At freeze, all Users to Notify at the lowest Order Number for the lowest numeric in the sequence specified in the approval Order Number. Notification of “Users to notify” at the next sequential Order Number occurs when all approvals at the previous Order Number have been entered. Type NO to notify all approval “Users to notify” at all Order Numbers when the package is frozen.
APPROVER NOTIFICATION VEHICLE
Enables notification vehicles for this ChangeMan ZMF instance. Notification vehicles are used to notify an approver about packages pending approval. You can enable more than one. SERNET - Send notification data through SERNET to ChangeMan ECP, which will format an e-mail message and send through SMTP. BATCH - File tailor skeleton CMN$$NTF and submit the generated JCL with Job Card Information defined in Application Administration Parameters. Note: Notification through MVS SEND is always available.
ALLOW DESIGNATE PROC OVERRIDE
Use this option to allow or prohibit the update of a component’s LOD TYPE value specified within the Application’s DESIGNATED COMPILE PROCEDURE option. A YES entered here allows update to a component’s LOD TYPE value. This value overrides the TARGET TYPE value specified at the Application’s LIBRARY TYPE option. A NO entered here prohibits the update to a component’s LOD TYPE value; in this case the LOD TYPE field displays in browse only mode.
USE GLOBAL NOTIFICATION FILE
Activates or deactivates the Global Notification Facility. This is a facility that enables administrators to send online messages to end users. See “Creating or Updating the Global Notification File” on page 90. for details. NO deactivates the GNF. The GNF option does not display on the Primary Option Menu (CMN@PRIM), and the ALLOW APPLICATION UPDATE PARAMETER field is automatically set to NO. YES activates the GNF. The GNF option displays on the Primary Option Menu (CMN@PRIM). If you enter YES, you must also fill in the ALLOW APPLICATION UPDATE TO FILE field and the GLOBAL NOTIFICATION FILE NAME field.
63
Chapter 4: Setting Up Global Administration
Field
Description
ALLOW APPLICATION UPDATE TO FILE
This field controls the display of the GNF option on the Application Administration Options panel (CMNLAMEN), as well as update access to the GNF. Enter NO to not display the GNF option during application administration. Updates to the notification file are disallowed. Enter YES to display the GNF option during application administration. Application Administrators are allowed update access to the notification file
GLOBAL NOTIFICATION FILE NAME
Note
Defines the data set name where authorized GNF users can specify and edit a notification message. If you specify NO in the USE GLOBAL NOTIFICATION FILE field, this field is not required and is always stored as blank. If you specify YES in the USE GLOBAL NOTIFICATION FILE field, you must enter a PDS or SEQUENTIAL data set that follows standard naming conventions.
The Delta Deck storage means is obsolete for new baseline libraries. However, existing baselines with this storage means are supported.
3. When you complete entering information on the Global Parameters Part 2 of 6 panel (CMNGGP02)panel, press ENTER. The Global Parameters Part 3 of 6 panel (CMNGGP03) is displayed: CMNGGP03 -------------- GLOBAL PARAMETERS - PART 3 OF 6 --------------------COMMAND ===> AUDIT LEVEL CHECKOUT ENFORCEMENT RULE ALLOW CONCURRENT CHECKOUT ALLOW CHECKOUT TO PERSONAL LIB. STAGING RESTRICTION LEVEL SAVE TO PERSONAL & STAGING LIBS OVERLAY PRIOR STAGED MODULE VALIDATE VERSION DURING STAGING PROMOTION/DEMOTION RULE
===> ===> ===> ===> ===> ===> ===> ===> ===>
0 1 YES YES 1 NO YES NO 0
(0,1,2,3,4,5) (1,2,3) (Y/N) (Y/N) (1,2,3) (Y/N) (Y/N) (Y/N) (0,1,2,3,4)
VALIDATE ISPF LIBRARIES ISPLLIB ===> YES (Y/N) ISPMLIB ===> YES (Y/N) ISPPLIB ===> YES (Y/N) ISPSLIB ===> YES (Y/N)
Press ENTER to continue; Enter B to go back 1 screen, or CANCEL to exit.
64
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following table describes the fields on the Global Parameters Part 3 of 6 panel (CMNGGP03) and the valid information that you can enter on the panel. Field
Description
AUDIT LEVEL
Enter the numeric value that dictates the Audit level that must be passed before a change package can be frozen. 0—Audit is recommended, but is optional. 1—Audit is required, but any return code (except ABEND) is acceptable. This is the default option. 2—Audit is required, and the return code must not exceed 12. This implies that there are out-of-sync situations within the Staging libraries. 3—Audit is required, and the return code must not exceed 8. This implies that there are no out-of-sync situations within the Staging libraries, but there are out-of-sync situations with respect to the Baseline libraries. 4—Audit is required, and the return code must not exceed 4. This implies that there are no out-of-sync situations within the Staging libraries or the Baseline libraries, but at least one component of the Staging library is a duplicate of its Baseline counterpart. 5—Audit is required, and the return code must not exceed 0. This implies that there are no out-of-sync situations within either the Staging libraries or the Baseline libraries and no duplicates exist.
CHECKOUT ENFORCEMENT RULE
Enter the numeric value that dictates the rule that must be passed before a component (not new components, but components that exist in the Baseline) can be staged. The administrator can restrict who stages components that are not first checked out from baseline. 1—Checkout is optional. Any component can be staged, regardless of whether it exists in Baseline or has been checked out to a package. ChangeMan ZMF does not check for the component's existence in the Baseline libraries. 2—Checkout is required unless the user passes an entity check. Users attempting to stage a component that exists in the Baseline but has not been checked out must pass a security system ENTITY CHECK before the stage can proceed. The entity name is specified in the application parameter generation. Staging is not allowed if the user does not pass the entity check. 3—Checkout is mandatory. Disallow anyone from staging a component that exists in the baseline library but has not been checked out to the package requesting the stage.
ALLOW CONCURRENT CHECKOUT
Enter YES to let a component be checked out to personal or Staging libraries. (Allow concurrent checkout of components that are already included in a change package. During installation, the second checked out component overlays the first.) Enter NO to prevent a component be checked out if it resides in another package. (This prevents users from checking out components that are already checked out to a package.) This rule applies to the same package as well as other packages that share the same Baseline library. It does not apply to unplanned (emergency) packages.
ALLOW CHECKOUT TO PERSONAL LIB
Enter YES to let users check out to a personal library. Enter NO to require all checkouts to go to Staging libraries. This rule does not apply to unplanned (emergency) packages.
65
Chapter 4: Setting Up Global Administration
Field
Description
STAGING RESTRICTION LEVEL
Enter the appropriate numerical value to determine which users are allowed to stage new components. From the user's view, it regulates the Stage Development Driven user option in the Stage Options panel (CMNSTG00). 1—Lets all users access both Development Driven (stage components into a package without checking them out) and Package Driven stage options. 2—Requires user to pass an entity check before they are allowed to stage any components via the Stage Development Driven option. Only TSO ID’s associated with the ENTITY name are allowed to use both stage options. The entity name, which must be defined to your security system, is specified in Staging Restriction Level in the application parameters. 3—All users are required to check out all components to a package before staging, effectively disabling the Stage Development Driven Option
SAVE TO PERSONAL & STAGING LIBS
This rule applies to edit in Staging when a personal or Development library is involved. Enter YES to allow updates to Staging and personal libraries. Enter NO to allow updates to the Staging library only when a component is staged from a Development library and then edited through ChangeMan ZMF.
OVERLAY PRIOR STAGED MODULE
If one user in an application has staged a source component, and another user tries to stage another version of the same component in the same change package, this field dictates whether overlaying of the first component is allowed. Enter YES to let any previously staged component be overlaid. ChangeMan ZMF issues a confirmation request before overlaying the component. Enter NO to allow only a single owner of a component. This option is not enforced against members that are checked out to the package in batch. More than one user can access the same component within the same change package. Entering a NO in this field prevents overlaying of the same component by another user. (This is based on the ISPF statistics in the user’s personal library. If those statistics do not match what is defined as the user ID in the staging package, ChangeMan ZMF does not allow an overlay.) The determining factor for the overlay is the TSO ID in the package.
VALIDATE VERSION DURING STAGING
This function ensures the integrity of a Baseline library component between Checkout and Staging. Users must check out components (not stage from development libraries) for this function to be in effect. This option is also affected by the STAGING RESTRICTION LEVEL field. If the Baseline version of a component has been altered after a user has checked it out (for example, another package has been installed that contains this component), staging of that component is prevented. Enter YES to enforce this validation (requires a regression test). Enter NO to ignore the validation.
66
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
PROMOTION/ DEMOTION RULE
Enter the appropriate numeric value of the rule to regulate the movement of components from Promotion libraries to Staging libraries (for editing) and back again. For an overview of Promotion in the ChangeMan ZMF cycle, see “What is ChangeMan ZMF?” on page 19. 0—Allows Promotion and Demotion of components, even when the change package has not been frozen. This is liberal Promotion and Demotion. This option allows re-editing of components in Staging, without requiring a demotion. Thus, different versions of a component can exist simultaneously in Staging and Promotion libraries. For example, if a component at promotion level 2 is edited in Staging, its promotion level is shown as “0” on the promotion panel. However, the component still exists in the level 2 library. It is the user’s responsibility to monitor these versions and demote previously promoted components, if desired. Rules 1 through 4 restrict promotion to frozen (FRZ) packages only: 1—Requires selective Demotion of a component followed by selective Refreeze, Edit, and Promotion directly back to the package's promotion level. 2—Requires selective Demotion of a component followed by selective Refreeze, Edit, and Promotion through all intermediate promotion levels. 3—Requires full Demotion of the entire package followed by a selective Refreeze, Edit, and Promotion through all intermediate promotion levels. 4—Requires full Demotion of the entire package followed by a Revert of the entire package to DEV status.
VALIDATE ISPF LIBRARIES
Validates the ISPF library concatenation used in a ChangeMan ZMF client against the library concatenation coded in the SERNET started procedure. When an ISPF client session is started, the ISPF library concatenation used to connect to ChangeMan ZMF is superseded by the concatenation coded in the SERNET started procedure. The VALIDATE ISPF LIBRARIES function ensures that no unauthorized libraries are subsequently concatenated for ChangeMan ZMF execution by a LIBDEF in the user’s TSO session. The VALIDATE ISPF LIBRARIES function also verifies the ISPF library concatenation used in ChangeMan ZMF cataloged procedure CMNxJOBS. This prevents users from substituting a procedure with unauthorized libraries by using a JCLLIB statement in the JOB STATEMENT INFORMATION on ChangeMan ZMF panels that invoke the batch API.
ISPLLIB
Type YES to validate ISPF load library concatenation (data set names and order). Type NO to bypass validation of the ISPF load library concatenation.
ISPLIB
Type YES to validate ISPF message library concatenation (data set names and order). Type NO to bypass validation of the ISPF message library concatenation.
ISPLPLIB
Type YES to validate ISPF panel library concatenation (data set names and order). Type NO to bypass validation of the ISPF panel library concatenation.
ISPLSIB
Type YES to validate ISPF skeleton library concatenation (data set names and order). Type NO to bypass validation of the ISPF skeleton library concatenation.
67
Chapter 4: Setting Up Global Administration
4. After you have completed entering information in the fields of the panel, press ENTER. The Global Parameters Part 4 of 6 panel (CMNGGP04) is displayed: CMNGGP04 -------------- GLOBAL PARAMETERS - PART 4 OF 6 ----------------------COMMAND ===>
JOB NAME INCREMENT OVERRIDE USE ZPREFIX IN BATCH JOBS CREATE COMPONENT WORK RECORDS FORCE AUDIT OF UNPLANNED PACKAGES BYPASS STAGING LIBRARY ENQUEUES ALLOW LINK PACKAGES MEMO DELETE EMPTY PACKAGES ONLY
===> ===> ===> ===> ===> ===> ===>
NO NO NO NO NO YES NO
(Y/N) (Y/N) (Y/N) (Y/N) (Y/N) (Y/N) (Y/N)
APPROVAL RESTRICTIONS: PACKAGE CREATOR CANNOT APPROVE PACKAGE WORKER CANNOT APPROVE ONLY 1 APPROVAL PER USER ID
===> NO ===> NO ===> NO
DISPLAY PACKAGE USER OPTION PANEL(S)
===> YES (Y/N)
(Y/N) (Y/N) (Y/N)
Press ENTER to continue; Enter B to go back 1 screen, or CANCEL to exit.
The following table describes the fields on the Global Parameters Part 4 of 6 panel (CMNGGP04) and the valid information that you can enter on the panel: Field
USE ZPREFIX IN BATCH JOBS
CREATE COMPONENT WORK RECORDS
68
Description YES
Do not increment the job name suffix for batch jobs submitted for background processing; force background processing for a userid to single-thread. This rule applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
Determines if ChangeMan ZMF uses the userid to construct a TSO profile to identify the variable pools when a TSO session is opened for batch API processing. YES
Use &ZPREFIX instead of &ZUSER in the PROFILE PREFIX command in batch TSO sessions for batch API functions. This rule applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
Determines if component work records are created when a package component is changed. Component work records show who has updated a package component. Component work records can be accessed from the package component list. YES
Create a component work record when a package component is updated. This rule applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
FORCE AUDIT OF UNPLANNED PACKAGES
Determines if audit is required for unplanned packages.
BYPASS STAGING LIBRARY ENQUEUES
ALLOW LINK PACKAGES
MEMO DELETE EMPTY PACKAGES ONLY
This option is only in effect if the Audit Level is higher than 0. YES
Require audit before freeze for unplanned packages. A bad return code from audit will not prevent freeze for unplanned packages. This rule applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
Determines if all staging libraries in a package are enqueued while a delete request from the Stage Package Component panel is processed. YES
Disable the staging library enqueue for component delete processing. This rule applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
Determines if applications can be defined to allow packages to be linked to other change packages through ChangeMan ECP. Refer to the ChangeMan ECP Linked Package facility. Linked packages are subject to delete, freeze, approval, and revert restrictions. YES
Permit applications to be defined that allow packages to be linked to other packages through ChangeMan ECP.
NO
Prohibit package linking in this ChangeMan ZMF instance.
Prohibit package Memo Delete if a change package contains any components. This restriction also applies to packages that contain only scratch or rename utility requests. YES
Require all applications to specify YES for this parameter in Application Administration to restrict Memo Delete.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
APPROVAL RESTRICTIONS
The next three fields on this panel limit a user’s approval authority for a planned package, even though they may otherwise be permitted to approval to that package. Approval restrictions controlled by these parameters do not apply to unplanned packages.
PACKAGE CREATOR CANNOT APPROVE
Prohibits the user who created a package from entering an approval for that package, even if they are authorized by the security system to enter approvals. This option applies only to planned packages. Approvals for unplanned packages are not effected by this option. YES
Prohibit users from entering an approval for a package that they created. This restriction applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
69
Chapter 4: Setting Up Global Administration
Field
Description
PACKAGE WORKER CANNOT APPROVE
Prohibits a user who has worked on a component in a package from entering an approval for that package, even if they are authorized by the security system to enter approvals.
ONLY 1 APPROVAL PER USER ID
DISPLAY PACKAGE USER OPTION PANEL(S)
This option applies only to planned packages. Approvals for unplanned packages are not effected by this option. YES
Prohibit a user who worked on a package component from entering an approval for the package. This restriction applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters. level.
Prohibits one user from entering more than one approval for a package, even if they are authorized by the security system to enter those approvals. This option applies only to planned packages. Approvals for unplanned packages are not effected by this option. YES
Restrict each userid to only one approval per package. This restriction applies to all applications.
NO
Allow YES or NO entry for this option in Application Administration Parameters.
Determines if the panels that contain the Package User Record fields are displayed when users access these functions: Package Create, Package Update, Package Query. YES
Display the panels containing Package User Record fields.
NO
Hide the panels containing Package User Record fields.
5. After you have completed entering information in the fields of the panel, press ENTER. The Global Parameters Part 5 of 6 panel (CMNGGP05) is displayed: CMNGGP05 -------------- GLOBAL PARAMETERS - PART 5 OF 6 --------------------COMMAND ===> STAGING LIBRARY MODEL DATASET NAME: DEV MODEL DSNAME PRD MODEL DSNAME
===> PROD99.CMN.Q510ALL.????.####### ===> PROD99.CMN.Q510ALL.????.#######
- “????” is placeholder for application name. - “#######” is placeholder for package number (.#000123). - (press for more information) PACKAGE MASTER COMPONENT MASTER DELAY FILE
===> PROD99.CMNSYS.Q510ALL.CMNPMAST ===> PROD99.CMNSYS.Q510ALL.CMNCMPNT ===> PROD99.CMNSYS.Q510ALL.CMNDELAY
EMAIL SERVER ADDRESS: TCP/IP ADDRESS ===> 111.111.111.111 PORT NUMBER ===> 22222
Press ENTER to continue; Enter B to go back 1 screen, or CANCEL to exit.
70
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following table describes the fields on the Global Parameters Part 5 of 6 panel (CMNGGP05) panel and the valid information that you can enter in the fields. Field
Description
DEV MODEL DSNAME
Enter the model data set name for Staging libraries in the development environment. Four questions marks (????) in the data set name are replaced with the appropriate application mnemonic. Seven pound signs (#######) are replaced with the change package number. ChangeMan ZMF uses the model data set name when it allocates each Staging library. Development and production Staging libraries are created for each change package (but note exception below). A separate Staging library is created for each library type in the package. The data set names are generated using the patterns entered here. If you are generating parameters for an ALL environment, use the same pattern in the PRD MODEL DSNAME as well
PRD MODEL DSNAME
Enter the model data set name for staging libraries in the production environment. Replacements are made as described above. If the environment is D or DP, you must also enter this information in the Site definition (Global Administrator option 6). This identifies the installation libraries for each remote site to the development site
PACKAGE MASTER
The name of the package master, component master, and delay files used by the ChangeMan ZMF session.
COMPONENT MASTER DELAY FILE ECP WEB SERVER ADDRESS
The TCP/IP address and port number of the Web server where ChangeMan ECP runs. ChangeMan ECP will send notifications through your SMTP E-mail server. This information is required if the SERNET approval notification vehicle is activated. See “APPROVER NOTIFICATION VEHICLE” on page 63.
TCP/IP ADDRESS
The TCP/IP address of the Web server where ChangeMan ECP runs.
PORT NUMBER
The port number of the Web server where ChangeMan ECP runs.
Note
For environments where packages are installed at remote sites (DP environment), you must use different patterns to differentiate between Development and Production libraries. If this is a DP environment using IEBCOPY as the transmission vehicle, use identical names for both fields. It is recommended that at least one node be fixed and contain the letters CMN (the standard abbreviation for ChangeMan ZMF). The four letters following CMN can be any letters that are easily recognizable in the user's environment.
71
Chapter 4: Setting Up Global Administration
6. After entering information in the Global Parameters Part 5 of 6 panel (CMNGGP05), press END. The Global Parameters Part 6 of 6 panel (CMNGGP06) is displayed: CMNGGP06 -------------- GLOBAL PARAMETERS - PART 6 OF 6 --------------------COMMAND ===> JOB STATEMENT INFORMATION: ===> //CMNSTART JOB (X170,374),GLOBAL,_______________________________________ ===> // CLASS=U,MSGCLASS=9_______________________________________ ===> //* JOBCARD FROM GLOBAL PARAMETERS PART 5 OF 5 PANEL CMNGGP05___________ ===> //*_____________________________________________________________________ This job card will be used when the package installation jobs are built at freeze time. The job name will change to reflect package and install transaction numbers. The job card can be overridden at the Application Administration "PARMS" option and the Global Administration DB2 option. Press ENTER to generate global parameters. Enter B to go back 1 screen or CANCEL to exit.
This job card information is used when the package installation jobs are built at Freeze time. Specifically, ChangeMan ZMF uses it when submitting batch jobs for distributing change packages, acknowledging distribution, installing change packages, acknowledging installation, backing out change packages, and rippling an application's baseline files. The job name is set to reflect package and installation transaction numbers This is the only job card information that the Global and Application Administrators provide. Users are required to set up similar job cards for batch API jobs such as Staging and Freezing. Information provided here is used as the default for the Application Administrator, who can modify it at the application level. The Global Administrator for DB2 can also override it. The global parameters are generated after you press ENTER.
DEFINING LIBRARY TYPES AND STAGING LIBRARY ATTRIBUTES A library type definition sets processing rules for the components stored under that library type. The definition also sets the data set attributes for the package staging library that is allocated for the library type. The Global Administrator defines the library types that are available to applications. Global administration will contain library types for all unique component types and processing requirements that might be required in any application. Library types can be changed at the application level, but they should be standardized on global definitions to simplify administration maintenance. To define a global library type, follow these steps.
72
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. On the Global Administration Options panel, type 2 on the Option line and press ENTER. The Global Library Types Part 1 of 2 panel is displayed. The first time you access this panel to define global library types, the panel is empty. CMNCGLT0 -------------- GLOBAL LIBRARY TYPES PART 1 OF 2 -- Row 1 to 17 of 150 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. Enter * in line command field for global staging libraries selection list. LIB LIKE DEFER TARGET SEL. TYPE DESCRIPTION (S/C/L/P)(Y/N) TYPE OPT. '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ '''' ___ ____________________________________________ _ _ ___ __ ******************************* Bottom of data ********************************
After you have entered library type definitions, the Global Library Types Part 1 of 2 panel might look like this. CMNCGLT0 -------------- GLOBAL LIBRARY TYPES PART 1 OF 2 -- Row 1 to 17 of 150 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit.
'''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' ''''
LIB TYPE CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC
LIKE DEFER TARGET SEL. DESCRIPTION (S/C/L/P)(Y/N) TYPE OPT. Copybooks___________________________________ C Y ___ __ Control Statements (PARMLIB)________________ P Y ___ __ DB2 Bind Control____________________________ P Y ___ __ DB2 DBRM____________________________________ P Y ___ __ Job Execution JCL___________________________ P Y ___ __ Link Edit Control Statements________________ P Y ___ __ Compressed Stage Listings___________________ P Y ___ __ Load Modules________________________________ L Y ___ __ BMS MAP Load Modules________________________ L Y ___ __ BMS MAP Copybook (DSECT)____________________ C Y ___ __ BMS MAP Source______________________________ S Y MAP __ Object Code_________________________________ P Y ___ __ JCL Cataloged Procedures____________________ P Y ___ __ DB2 Package Bind Control____________________ P Y ___ __ ISPF Skeletons______________________________ P Y ___ __ Source Code_________________________________ S Y LOD __
73
Chapter 4: Setting Up Global Administration
The following table describes the fields on the Global Library Types Part 1 of 2 panel. Field
Description
Line Command
Type a line command to the left of a panel row.
LIB TYPE
S
Select to see the next panel for this library type.
I
Insert a blank library type row.
R
Repeat an existing library type row.
D
Delete an existing library type row.
Type a three character library type. Some library types are reserved. These types have built-in attributes, and they are used in particular internal processes.: ASC
APS painted screens (ChangeMan ZMF APS Option) - DCB must be RECFM=F/FB, LRECL=240
CPY
Copybooks - Defaults to Like-Copy (see the definitions for the LIKE types below.) DCB must be RECFM=F/FB, LRECL=80
CTC
Control Statements - Defaults to Like-PDS. DCB must be RECFM=F/ FB, LRECL=80
DBB
DB2 Bind Control Statements (ChangeMan ZMF DB2 Option) - Defaults to Like-PDS. Used by the ChangeMan ZMF DB2 Selectable Option. DCB must be RECFM=F/FB, LRECL=80
DBR
DB2 DBRM (ChangeMan ZMF DB2 Option) - Defaults to Like-PDS. Used by the ChangeMan ZMF DB2 Selectable Option. DCB must be RECFM=F/FB, LRECL=80
DOC
Documentation. Defaults to Like-PDS. DCB must be RECFM=F/FB/V/ VB
JCL
JCL - Defaults to Like-PDS, although libraries with this type are included in Impact Analysis JCL relationships. DCB must be RECFM=F/FB, LRECL=80
LCT
Link Edit Control Statements - Defaults to Like-PDS. DCB must be RECFM=F/FB, LRECL=80
LOD
Load Modules - Defaults to Like-Load. DCB must be RECFM=U.
LST
Compressed Stage Listings - Defaults to Like-PDS. Cannot be explicitly staged. DCB must be RECFM=F/FB, LRECL=80.
PRC
SRC DESCRIPTION
74
Cataloged JCL Procedures - Default to Like-PDS, although libraries with this type are included in Impact Analysis JCL relationships. DCB must be RECFM=F/FB, LRECL=80 Source Code - Defaults to Like-Source. DCB must be RECFM=F/FB, LRECL=80
Enter freeform text describing the library type.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
LIKE (S/C/L/P)
Type a one-character LIKE code to define behaviors and characteristics of a library type. S
C
L
Like-Source - Components in Like-Source library types are staged through a batch job defined by a Language and Procedure assigned to the component to create a component in a Like-Load library type. Every Like-Source library type must have a TARGET TYPE in its Library Type Definition. There is a source-load relationship between every LikeSource component and a Like-Load component. Members in LikeSource libraries are analyzed for Impact Analysis CPY relationships. Like-Copy - Components in Like-Copy library types are not processed through a procedure by stage. Like-Copy libraries are included in SYSLIB concatenations for copybook libraries. Members in Like-Copy libraries are analyzed for Impact Analysis CPY relationships. Like-Load - Components in Like-Load libraries are assumed to be the product of a stage procedure performed on a Like-Source component. Like-Load libraries are included in SYSLIB concatenations for load libraries. Members in Like-Load libraries are analyzed for Impact Analysis LOD relationships. Like-PDS -Components in Like-PDS library types are not processed through a procedure by stage. Like-PDS libraries are not included in SYSLIB concatenations for copybook or load libraries. Members in LikePDS libraries are not analyzed for Impact Analysis relationships.
P
Blank
Like-Other - If you leave the LIKE field blank in a Library Type Definition, the type is referred to as “Like-Other”. Components in Like-Other library types are staged through a batch job created from an ISPF skeleton named CMN$$xxx where xxx is the Like-Other library type. You must code Like-Other skeletons from a model named CMN$$OTH delivered from SERENA. Like-other libraries are not analyzed for Impact Analysis relationships. Like-Other components are not analyzed by Audit.
DEFER
Y
Defer allocation of the staging library for this types until the fist component of the type is staged or checked out.
N
Allocate the stage library for this type when the change package is created, even though there may never be any members of this library type in the package.
TARGET TYPE
Type a Like-Load target library type for each Like-Source library type.
SELECTABLE OPTION
Use this field to associate a library type with a ChangeMan ZMF selectable option that you have licensed. The behavior of the library type may require further definition in administration panels or ISPF skeletons. A
APS Option
D
DB2 Option
I
IMS Option
If you have a large number of library types (more than 40), you can alphabetize library types on the Global Library Types Part 1 of 1 panel to make it easy to locate a global library type when you define application library types.
75
Chapter 4: Setting Up Global Administration
a) To add a library type, type I (Insert) in the line command above where you want to insert the library type and press ENTER. An empty library type entry is inserted on the panel. b) To delete a library type, type D (Delete) in the line command for the library type and press ENTER. 2. For each library type on the Global Library Types Part 1 of 2 panel, you must complete a second panel of information. Type S in the line command for a library type and press ENTER. The Global Library Types Part 2 of 2 panel is displayed. The first time you access this panel for a library type, the panel is empty: CMNCGLT1 -------------- GLOBAL LIBRARY TYPES PART 2 OF 2 -------------------COMMAND ===> LIBRARY TYPE: CPY - Copybooks LIKE VALUE: C DEFER VALUE:
Y
STAGING DATASET ATTRIBUTES: GENERIC UNIT NAME ===> (Generic group name or unit) VOLUME SERIAL ===> (Required if GENERIC UNIT unspecified) SPACE UNITS ===> (TRK, CYL or BLK) PRIMARY QUANTITY ===> (In above units) SECONDARY QUANTITY ===> (In above units) DIRECTORY BLOCKS ===> RECORD FORMAT ===> RECORD LENGTH ===> BLOCK SIZE ===> DATA SET TYPE ===> (LIBRARY for PDSE, PDS for pds, or blank) OTHER OPTIONS: CHECKOUT COMPONENT DESCRIPTION ===> NO (Y/N) CHECKOUT COMPONENT ACTIVITY FILE ===> NO (Y/N) COMPONENT ACTIVITY FILE TYPE ===> SAVE STAGING VERSIONS ===> (YES/NO/OPT) Press ENTER to process; Enter END command to exit.
76
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
After you have entered information on the Global Library Types Part 2 of 2 panel, it might look like this. CMNCGLT1 -------------- GLOBAL LIBRARY TYPES PART 2 OF 2 ---------------------COMMAND ===> LIBRARY TYPE: CPY - Copybooks LIKE VALUE: C DEFER VALUE:
Y
STAGING DATASET ATTRIBUTES: GENERIC UNIT NAME ===> 3390 (Generic group name or unit) VOLUME SERIAL ===> (Required if GENERIC UNIT unspecified) SPACE UNITS ===> TRK (TRK, CYL or BLK) PRIMARY QUANTITY ===> 1 (In above units) SECONDARY QUANTITY ===> 1 (In above units) DIRECTORY BLOCKS ===> 5 RECORD FORMAT ===> FB RECORD LENGTH ===> 80 BLOCK SIZE ===> 0 DATA SET TYPE ===> PDS (LIBRARY for PDSE, PDS for pds, or blank) OTHER OPTIONS: CHECKOUT COMPONENT DESCRIPTION ===> NO (Y/N) CHECKOUT COMPONENT ACTIVITY FILE ===> NO (Y/N) COMPONENT ACTIVITY FILE TYPE ===> SAVE STAGING VERSIONS ===> NO (YES/NO/OPT) Press ENTER to process; Enter END command to exit.
The following table describes the fields on the Global Library Types Part 2 of 2 panel. Field
Description
GENERIC UNIT NAME
Type the DASD generic group or unit device name to be used for allocating staging libraries for this library type. This field may be left blank if the VOLUME SERIAL field is used.
VOLUME SERIAL
Type the DASD volume serial number where stage libraries are to be allocated for this library type. This field may be left blank if the GENERIC UNIT NAME field is used.
SPACE UNITS
Type the units to be used for the primary and secondary space allocations for staging libraries for this library type. TRK
Allocate space in tracks.
CYL
Allocate space in cylinders.
BLK
Allocate space in blocks.
PRIMARY QUANTITY
Type the primary space, secondary space, and directory block allocation to be used for the staging libraries for this library type.
SECONDARY QUANTITY
Use the MINIMUM space allocations, especially the PRIMARY QUANTITY. ChangeMan ZMF dynamically reallocates stage libraries if extents or directory blocks are exhausted as the change package grows.
DIRECTORY BLOCKS
Unused space in PDS stage libraries is freed when the change package is frozen. ChangeMan ZMF does not automatically compress stage libraries, but you can compress stage libraries for a package with the ZP Package List command.
77
Chapter 4: Setting Up Global Administration
Field
Description
RECORD FORMAT
Type the staging library record format for this library type. Valid values include: F, FA, FB, FBA, FBM, FM, FS, V, VA, VB, VBA, VBM, VM, U Legend: F - Fixed length records V - Variable length records U - Undefined format records B - Blocked records S - Standard blocks A - ASA printer control characters M - Machine code printer control characters
RECORD LENGTH
Type the logical record length for components in this library type.
BLOCK SIZE
Type the staging library block size for this library type. You may enter 0 to let SMS calculate the best block size for the storage device.
DATA SET TYPE
Type LIBRARY for PDSE stage libraries. Leave the field blank or type PDS for PDS stage libraries.
CHECKOUT COMPONENT DESCRIPTION
YES
Copy the Component General Description from the Package Master to the change package when a component is checked out. Allow developers to create or update the Component General Description through a change package.
NO
Do not copy the Component General Description from the Package Master to the change package when a component is checked out. Prevent developers from creating or updating the Component General Description in a change package. The Component General Description can always be created or updated through Application Administration.
CHECKOUT COMPONENT ACTIVITY FILE
YES
Automatically checkout a second component with the same name in a second library type when you checkout a component in this library type. The second library type specified below in the COMPONENT ACTIVITY FILE TYPE field. The second library type is called a “Component Activity File” here, but it can be any like-PDS library type defined to this application. If you check out a component to a personal library, the Activity File is checked out to the staging library. If there is no Activity File member with the same name in baseline, you must create one (stage from development) in your package. If there is no matching Activity File member, Audit flags a SYNCH6! Checkout components in this type without checking out a second component with the same name in another library type.
NO COMPONENT ACTIVITY FILE TYPE
78
Type the library type of the Component Activity File. This field is only required if YES is specified in the CHECKOUT COMPONENT ACTIVITY FILE field.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
SAVE STAGING VERSIONS
Restricts how the application library type can be defined to save a previous version in a staging library before it is overlaid by a new version from edit-in-stage, checkout, or stage from development. See “Staging Versions” on page 49 YES
The application library type must always be defined to save staging versions.
NO
The application library type can never be defined to save staging versions.
OPT
The application administrator can define the library type to always save staging versions, never save staging versions, or prompt the developer to make a choice.
3. When you are finished updating fields on the Global Library Type Part 2 of 2 panel, press ENTER to return to the Global Library Types 1 of 2 panel. 4. When you are finished updating library type definitions on the Global Library Type Part 1 of 2 panel, press PF-3 or type END and press ENTER to store the application library type definitions in the ChangeMan ZMF Package Master File.
DEFINING THE LANGUAGES You provide ChangeMan ZMF with all of the language names available in this environment. ChangeMan ZMF can still process component types if source and like source language types are not defined here, but when you define them, users are able to reference these component types by language. The Application Administrators select from this list when individual applications are set up. This information can also be used as a selection list from within the global options whenever necessary. To define the languages, take the following steps: 1. Select option 3 on the Global Administration Options panel. The Global Language Names panel (CMNGGLNG) is displayed: CMNGGLNG ------------------- GLOBAL LANGUAGE NAMES ---------------------------COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit.
'''' '''' '''' ''''
LANGUAGE COBOL2__ COBOL __ ASM __ PLI __
79
Chapter 4: Setting Up Global Administration
2. Define a standard language or update an existing standard language on the panel. The standard language names you define is associated with the language assumption feature of ChangeMan ZMF. This feature assists users who neglect to explicitly define the language type of a source or like-source component type that they stage. The language assumption feature searches the code of the staged component, matches its language name to the standard language names you define, and names it. 3. Type END to save your entry.
DEFINING THE COMPILING PROCEDURES This option is used to enter all the different procedures that are needed to compile and link source components. This information is displayed for selection during any application level change package staging. Thus, it must include all of the procedures for change installation of all applications. Even if your application does not contain any source components, you must enter a compile procedure. To define the compiling procedures, take the following steps. 1. Select option 4 from the Global Administration Options panel. The Compile Procedure List panel (CMNPRCNM) is displayed: CMNPRCNM ------------------- COMPILE PROCEDURE LIST --------------------------COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. Enter * in LANGUAGE or PROCEDURE fields for selection list. LANGUAGE PROCEDURE DESCRIPTION '''' COBOL2__ ________ _____________________________________________
This panel lists all of the pre-defined compiling procedures. Skeletons for these procedures must exist in the custom skeletons library (see Serena™ ChangeMan® ZMF Skeleton Reference for details). 2. Create or update the rows of the list, and type END to save your changes. The following table describes the fields of the panel.
80
Column
Description
LANGUAGE
Enter the language name for the compile procedure. If you want to select from a list of available language names, enter *. The Language Name Selection List is displayed.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Column
Description
PROCEDURE
Enter the procedure name. If you want to select from a list of procedure names, enter *. You cannot use a numeric or special character in the fourth position of the procedure name.
DESCRIPTION
Enter the procedure description, which can be up to 44 alphanumeric characters.
DEFINING REASON CODES This option is used to enter all available reason codes and descriptions for unplanned permanent or temporary change packages. When creating this change package, the user must choose a code from the Reason Code List. To define reason codes, take the following steps 1. Select option 5 on the Global Administration Options panel. The Reason Code List panel (CMNRSNCD) is displayed: CMNRSNCD ---------------------- REASON CODE LIST -----------------------------COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. CODE DESCRIPTION '''' 004 User error__________________________________
2. Create or update the rows of the list, and type the END command to save your changes. The following tables describes the field on the Reason Code List panel. Column
Description
CODE
Enter the reason code in alphanumeric format, for example, E01 or 01E.
REASON DESCRIPTION
Enter the reason description with a maximum of 44 alphanumeric characters.
81
Chapter 4: Setting Up Global Administration
DEFINING SITES A site specifies target information for a promotion process or an install process. A site may be local or remote. Local Site
A target that is on the same LPAR as the development ChangeMan ZMF instance. A target on a different LPAR from the ChangeMan ZMF instance can be defined as a local site if it shares DASD and catalogs with the ChangeMan ZMF development LPAR, and no DB2 binds are required.
Remote Site
A target that is on a different LPAR than the development ChangeMan ZMF. instance that does not share DASD and catalogs, or that requires DB2 binds.
You must define a site for each production ChangeMan ZMF environment that is a target for installs. Every promotion level definition must be associated with a site. Perform the following steps to define a site: 1. On the Global Administration Options panel, select option 6. The Global Site List Part 1 of 2 panel is displayed. The first time you access this panel to define global sites, the panel is empty: CMNGRST1 ---------------- GLOBAL SITE LIST PART 1 OF 2 ----- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> HALF Enter END command to save changes or CANCEL to exit. SITE NAME '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ ******************************* Bottom of data ********************************
82
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
After you have entered site names on the Global Site List Part 1 of 2 panel, it might look like this. CMNGRST1 ---------------- GLOBAL SITE LIST PART 1 OF 2 ------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> HALF Enter END command to save changes or CANCEL to exit. SITE NAME '''' Q510DP__ '''' N510DP__ '''' LOCAL01_ ******************************* Bottom of data ********************************
The following table describes the fields on the Global Site List panel. Field
Description
SITE NAME
Type a nickname for a promotion or install target. The site name must begin with an alphabetic character. Site names should convey the purpose of the site in the context of promotion and/or install. Developers pick install site names from a list when they create a package, and they pick a promotion site name from a list when they promote their package.
The order of site names on the Global Site List Part 1 of 2 panel is not significant. a) To insert a new site, type I (Insert) in the command line above the point where you want the new site to appear and press ENTER. An empty site definition line is inserted. b) To delete an existing site, type D (Delete) in the line command for the site you want to delete and press ENTER. 2. For each site on the Global Site List Part 1 of 2 panel, you must complete a second panel of information. Type S in the line command for the site and press ENTER.
83
Chapter 4: Setting Up Global Administration
a) If the ChangeMan ZMF instance you are using to make this update is an A (All) environment, the Site Definition Part 2 of 2 panel is displayed: CMNGPRST --------- N510DP SITE DEFINITION - PART 2 OF 2 ----------------------COMMAND ===> LOGICAL UNIT/SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL PRD STAGING MODEL DSNAME TRANSMISSION VEHICLE SITE SITE ===> ===> ===> ===>
===> ===> (Generic disk unit) ===> ===> ????.CMNSTAGE.####### ===> (IEBCOPY or Other)
JOB STATEMENT INFORMATION: JOB STATEMENT INFORMATION: //CMNSTART JOB ,ACCOUNT INFORMATION,____________________________________ // CLASS=?,MSGCLASS=?_______________________________________ //*_____________________________________________________________________ //*_____________________________________________________________________
Press ENTER to process; Enter END command to exit.
b) If the ChangeMan ZMF instance you are using to make this update is DP (Development/Production) environment, the Site Information Part 2 of 2 panel is displayed: CMNGRST2 --------- Q510DP SITE INFORMATION - PART 2 OF 2 ---------------------COMMAND ===> CHANGE MAN SUBSYSTEM ID LOGICAL UNIT/SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL CHANGE MAN DELAY FILE PRD STAGING MODEL DSNAME TRANSMISSION VEHICLE TIME DIFFERENCE SITE ===> ===> ===> ===>
===> ===> ===> (Generic disk unit) ===> ===> ===> ????.CMNSTAGE.####### ===> (IEBCOPY or Other) ===> (+/-HHMM)
JOB STATEMENT INFORMATION: //CMNSTART JOB ,ACCOUNT INFORMATION,____________________________________ // CLASS=?,MSGCLASS=?_______________________________________ //*_____________________________________________________________________ //*_____________________________________________________________________
Press ENTER to process; Enter END command to exit.
84
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The first time you access either of these panels, the fields are mostly blank. After you have entered site information on the Site Information Part 2 of 2 panel, it might look like this.: CMNGRST2 ---------- Q510DP SITE INFORMATION - PART 2 OF 2 --------------------COMMAND ===> CHANGE MAN SUBSYSTEM ID LOGICAL UNIT/SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL CHANGE MAN DELAY FILE PRD STAGING MODEL DSNAME TRANSMISSION VEHICLE TIME DIFFERENCE
===> A ===> QREMOTE ===> SYSDA (Generic disk unit) ===> ===> PROD142.PROFSERV.CMN510N.CMNDELAY ===> PROD99.CMN.QREMOTE.????.####### ===> IEBCOPY (IEBCOPY or Other) ===> -0100 (+/-HHMM)
SITE JOB STATEMENT INFORMATION: ===> //CMNSTAR JOB (X170,374),'GLOBAL Q510DP SITE',_________________________ ===> // CLASS=A,MSGCLASS=9______________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.
The following table describes the fields on these panels. Field
Description
CHANGEMAN SUBSYSTEM ID
Type the subsystem ID of the target ChangeMan ZMF instance for this site.
LOGICAL UNIT/ SYSTEM NAME
If you are defining a local site, type the LOGICAL UNIT OR SYSTEM NAME used in Global Administration Parameters.
Not required in an A environment, and not displayed on the panel.
If you are defining a remote site, type the logical unit or system name (SMF ID) that is used by your transmission software to locate the target site. DEFAULT UNIT NAME
Type the generic unit name for DASD to be used for dynamic allocations at the target site. This field may be left blank if DEFAULT VOLUME SERIAL is used.
DEFAULT VOLUME SERIAL
Type the DASD volume serial number to be used for dynamic allocations at the target site. This field may be left blank if DEFAULT UNIT NAME is used.
CHANGEMAN DELAY FILE
Type the fully qualified data set name (no quotes) for the VSAM Delay file at the target site. (Not required for A environments.)
PRD STAGING MODEL DSNAME
If you are defining a local site, type the DEV MODEL DSNAME from Global Administration Parameters. If you are defining a remote site, type the model data set name for staging libraries at the target site. Four question marks (????) in the data set name are replaced by the appropriate application mnemonic. Seven pound signs (#######) are replaced by the change package number. Not required in an A environment, and not displayed on the panel.
85
Chapter 4: Setting Up Global Administration
Field
Description
TRANSMISSION VEHICLE
If you are defining a local site, type IEBCOPY.
TIME DIFFERENCE
Type the difference in system clock time between this site and the development site where change packages are created.
If you are defining a remote site, type OTHER to include transmission steps in promote JCL or install JCL.
Enter a positive time difference in hours and minutes (+hhmm) if this site is to the east of the development site. Enter a negative time difference (-hhmm) if this site is to the west of the development site. The default time difference is +0000. The time difference parameter is used to verify that the package install date and time that you enter when you create a package is a time that has not already passed at a remote site. SITE JOB CARD INFORMATION
Enter the default job card to be used at the target site.
3. When you are finished updating fields on the Site Definition Part 1 of 2 panel, press ENTER to return to the Global Site List Part 1 of 2 panel. 4. When you are finished updating site definitions on the Global Site List Part 1 of 2 panel, press PF-3 or type END and press ENTER to store the site definitions in the ChangeMan ZMF Package Master file.
LOCKING OR UNLOCKING APPLICATION DEFINITIONS As the Global Administrator, you can lock or unlock application definitions with the Lock/ Unlock Applications panel. When an application is locked, the Application Administration Options cannot be used to update the application definition, and application administration panels are displayed in browse mode. The only functions an application administrator can execute when an application is locked are: •
Update the Global Notification File if that function is allowed by the global administration parameters.
•
Submit reports from the Report Selection List panel.
•
Submit the Baseline Analyzer Report and the Link Date Report.
Application Administration Options also display in browse mode when another administrator is updating an application. If that administrator’s session is interrupted, the application status may display IN USE, even through no one is currently updating the application. The Global Administrator must unlock the application to make the application definition available for update. To lock, unlock, or reset an application definition: 1. On the Primary Option Menu, select option A and press Enter. The Administration Options panel is displayed.
86
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
2. On the Administration Options panel, select option G and press Enter. The Global Administration Options menu is displayed. 3. On the Global Administration Options panel, select option 7 and press Enter. The Lock/ Unlock Applications panel is displayed: CMNGBULP ------------------ LOCK/UNLOCK/RESET IN USE --------- Row 1 to 6 of 6 COMMAND ===> SCROLL ===> PAGE Enter L (lock), U (Unlock) or R (Reset in use flag). APPL DESCRIPTION STATUS _ APS QA DP Test Application _ BET QA DP Test Application LOCKED _ CCW Ulrica’s Test QA system _ DAM1 Don’s test application IN USE _ DEMO DEMO APPL MAY BE DELETED AND REDEFINED _ T510 Test v510 application for use by all LOCKED ******************************* Bottom of data ********************************
The following table describes the fields on the Lock/Unlock Applications panel. Field
Description
Line Command
Type a line command to change the application status. L
Lock the application to prohibit changes to application administration. Unlock the application to allow changes to application administration.
U
Reset the “in use” indicator.
R APPL
Displays application mnemonics defined to ChangeMan ZMF.
DESCRIPTION
Displays the application descriptions.
STATUS
Indicates if the application is available for update. LOCKED
The Global Administrator has locked the application. Application administration cannot be changed until the Global Administrator unlocks the application. Application administration panels are displayed in browse mode.
UNLOCKED
The Global Administrator has just unlocked the application. Application administration is available for update.
IN USE
Another administrator is currently updating application administration. Application administration panels are displayed in browse mode. The Global Administrator has just reset the “in use” indicator. Application administration is available for update.
RESET
Application administration is available for update.
Blank
87
Chapter 4: Setting Up Global Administration
4. On the Lock/Unlock Applications panel, type L (lock), U (unlock), or R (Reset) in the line command for an application and press Enter. The STATUS field is updated to LOCKED, UNLOCKED, or RESET. Application availability is changed immediately. 5. Press PF-3, or type END on the Command line and press Enter to exit the Lock/Unlock Applications panel. You cannot “CANCEL” changes you made.
SETTING THE PLANNED INSTALLATION CALENDAR The Planned Installation Calendar limits the number of planned packages that may be scheduled for install on the same calendar day. This restriction does not apply to unplanned packages. To update the Planned Installation Calendar, perform the following steps: 1. On the Global Administration Options panel, type D and press ENTER. 2. If the ChangeMan ZMF instance you are using to make this update is an A (All) environment, the Planned Installation Calendar panel is displayed immediately. This panel is described in step 3c below. 3. If the ChangeMan ZMF instance you are using to make this update is not an A (All) environment, the Calendar Options panel is displayed: CMNCLDOM ---------------------- CALENDAR OPTIONS -----------------------------OPTION ===> 1 Site - Display or update installation calendar by site 2 Composite - Display a composite installation calendar Press ENTER to process; Enter END command to exit.
a) On the Calendar Options panel, type 2 and press ENTER, and the Planned Installation Calendar panel shows in display mode. This panels displays the total number of installs that may be scheduled across all sites and the total number of installs that have already been scheduled. The # and MAX numbers displayed for each day on this panel represent the sum of the # and MAX numbers for all sites. b) On the Calendar Options panel, type 1 and press ENTER, and the Site Selection List panel is displayed: CMNRMTSL --------------- DEMO - SITE SELECTION LIST ---------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> HALF SITE NAME _ Q510DP _ N510DP _ LOCAL01
88
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
c) On the Site Selection List panel, type S on the line command for a site name and press ENTER. The Planned Installation Calendar panel is displayed: CMNCLNDR ----------- PLANNED INSTALLATION CALENDAR -------- CALENDAR UPDATED Press ENTER to update calendar or END command to exit. STARTING MON TUE WED THU FRI SAT SUN TOTALS DATE # MAX # MAX # MAX # MAX # MAX # MAX # MAX # MAX 2000/04/10 000 022 000 022 000 022 000 022 000 022 000 022 000 022 0000 0154 2000/04/17 000 022 000 022 000 022 000 022 000 022 000 022 000 022 0000 0154 2000/04/24 000 022 000 022 000 022 002 022 001 022 000 022 001 022 0004 0154 2000/05/01 000 022 000 022 000 022 000 022 000 022 000 022 000 022 0000 0154 2000/05/08 000 022 000 022 000 022 000 022 000 022 000 022 000 022 0000 0154 2000/05/15 000 022 000 022 000 022 000 022 000 022 000 022 000 022 0000 0154
The following table describes the fields on the Planned Installation Calendar panel. Field
Description
STARTING DATE
This is the calendar date for the first day in the row. Each row displays seven days. The Starting Date will be the day before the current system date to include packages scheduled for install on the prior calendar date due to a negative Time Difference specified in the Site definition in Global Administration.
#
Displays the total number of packages scheduled for installed on that day at this site.
MAX
A data entry field for the maximum number of planned packages that may be scheduled for install on that day for this site. The maximums are initially set to zero for all dates. To reset MAX for all dates. type SETALL nnn on the command line. To set MAX for a all occurrences of a day of the week, enter SETddd nnn (example: SETMON 123). To reset the MAX for one date, over typing the MAX number for that day. To block scheduling installs for any planned packages on a given date, leave MAX at zero for that day. To set MAX to an unlimited number of unplanned packages for all days or for a specific day, type SETALL 255 or SETddd 255 on the command line. The value of the maximum number of planned packages is displayed as UNL. Note: If a site was created only for promotion to a local site, leave MAX set to zero for all dates.
TOTALS #
Displays the total number of packages scheduled for instal in that week at this site.
TOTALS MAX
Displays the maximum number of planned packages that may be scheduled for install in that week at this site.
The # and TOTALS # fields are automatically incremented when change packages are created. These fields are automatically decremented when change packages are rescheduled or installed.
89
Chapter 4: Setting Up Global Administration
CREATING OR UPDATING THE GLOBAL NOTIFICATION FILE Administrators use the Global Notification facility to pass information to ChangeMan ZMF users. You can use this facility to inform users about: •
Scheduled down time.
•
Scheduled maintenance changes to ChangeMan ZMF.
•
Work-arounds for recently discovered problems.
•
Upcoming ChangeMan ZMF education or discussion sessions.
When a user connects to ChangeMan ZMF after an administrator updates the Global Notification File, this ISPF short message is displayed in the upper right corner of the Primary Option Menu: “NOTIFICATION UPDATED”. If the user presses PF1, this long message is displayed: CMN1116I - Option-N file last updated 07/15/2002
13:57 last read 07/14/2002
The short message persists on the Primary Option Menu until the user selects option N (Notify) to display the Global Notification File. BROWSE WSER239.WSER239.D197B7EF.T36A5D91.OUTLIST Line 00000000 Col 001 080 Command ===> Scroll ===> HALF ********************************* Top of Data ********************************** Notification Date: 07/15/2002 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday July 20 when Maintenance Package 58 will be applied. See the ChangeMan page on the Intranet for a description of the changes that will be made. -----------------------------------------------------------------------Notification Date: 06/10/2002 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 16 when Main ten ace Package 57 will be applied. See the ChangeMan page on the Intranet for a description of the changes that will be made. ******************************** Bottom of Data ********************************
The global administrator allocates the Global Notification File and enables the Global Notification Facility. Global administrators update the file with information for users, and they can grant application administrators the same privilege.
Enabling the Global Notification Facility Follow these steps to allocate a Global Notification File and enable the Global Notification Facility.
90
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. Outside of ChangeMan ZMF, allocate a permanent Global Notification File as a partitioned or sequential data set. Use any of these file characteristics: Data Set Organization
DSORG=PS or PO
Record Format
RECFM=FB, FBM, FBA, VB, VBM, or VBA
Logical Record Length
LRECL maximum 256
Serena recommends that you allocate a small sequential file with a fixed record length of 80 bytes. A single track of 3390 equivalent disk has room for over 600 lines of notification messages. If you allocate a PDS, ChangeMan ZMF will reallocate the library if it ever runs out of extents or directory space. However, the trade-off is that a PDS accumulates unusable space and should be compressed periodically. Note
If you allocate the Global Notification File as a PDS, create a member in the library with at least one (blank) record. When you specify the data set name in global administration parameters below, use the fully qualified PDS member name.
2. In your security system, grant the SERNET instance userid UPDATE access to the file you allocated. (Grant ALTER access if you allocated a PDS so ChangeMan ZMF can reallocate this library.) Administrators and users do not need access granted in your security system because they access the file through ChangeMan ZMF. 3. From the Global Administration Options panel (CMNGAMEN), select option 1. The Global Parameters Part 1 of 6 panel (CMNGGP01) is displayed. 4. Press Enter. The Global Parameters Part 2 of 6 panel (CMNGGP02) is displayed. 5. On the Global Parameters Part 2 of 6 panel (CMNGGP02), enter information to define the Global Notification Facility. a) In the Use Global Notification File field, type Yes. b) In the Allow Application Update To File field, type Yes if you want application administrators to update the Global Notification File that is displayed to all ChangeMan ZMF users. c) In the Global Notification File field, type the data set name of the file you allocated. 6. Press Enter continuously until you are returned to the Global Administration Options panel (CMNGAMEN)
Creating Global Notification Messages Follow these steps to create your first Global Notification message for ChangeMan ZMF users.
91
Chapter 4: Setting Up Global Administration
1. From the Global Administration Options panel (CMNGAMEN), select option N. An ISPF edit session is opened for an empty ChangeMan ZMF temporary file. ISREDDE2 WSER239.WSER239.D197B7EF.T3A87376.OUTLIST Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. '''''' '''''' '''''' '''''' '''''' '''''' '''''' '''''' '''''' '''''' '''''' '''''' '''''' ****** **************************** Bottom of Data ****************************
2. Using ISPF functions, edit the temporary file to create the message that you want ChangeMan ZMF users to see. ISREDDE2 WSER239.WSER239.D197B7EF.T3ADCD39.OUTLIST Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 000002 Notification Date: 06/10/2002 000003 000004 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 000005 16 when Maintenance Package 57 will be applied. See the ChangeMan page on 000006 the Intranet for a description of the changes that will be made. 000007 ****** **************************** Bottom of Data ****************************
3. Press PF3 to exit the edit session. ChangeMan ZMF copies the temporary file back to the Global Notification File. Type Cancel to exit the edit session without saving your entries.
Updating the Global Notification Message Follow these steps to update the Global Notification File with new messages for ChangeMan ZMF users.
92
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. From the Global Administration Options panel (CMNGAMEN), select option N. An ISPF edit session is opened for a ChangeMan ZMF temporary file that contains the current contents of the Global Notification File. Note
If the global administrator specified Yes In the Allow Application Update To File field, you can access this function from the Application Administration Functions panel (CMNLAMEN).
ISREDDE2 WSER239.WSER239.D197B7EF.T3BEC7B8.OUTLIST Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 000002 Notification Date: 06/10/2002 000003 000004 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 000005 16 when Maintenance Package 57 will be applied. See the ChangeMan page on 000006 the Intranet for a description of the changes that will be made. 000007 ****** **************************** Bottom of Data ****************************
2. Using ISPF functions, insert lines to type new a new message that you want displayed to all ChangeMan ZMF users. Add new messages at the top of the file. ISREDDE2 WSER239.WSER239.D197B7EF.T3C3AE58.OUTLIST Data set copied Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 000002 Notification Date: 07/15/2002 000003 000004 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday July 000005 20 when Maintenance Package 58 will be applied. See the ChangeMan page on 000006 the Intranet for a description of the changes that will be made. 000007 000008 -----------------------------------------------------------------------000009 000010 Notification Date: 06/10/2002 000011 000012 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 000013 16 when Maintenance Package 57 will be applied. See the ChangeMan page on 000014 the Intranet for a description of the changes that will be made. 000015 ****** **************************** Bottom of Data ****************************
3. Press PF3 to exit the edit session. ChangeMan ZMF copies the temporary file back to the Global Notification File. Type Cancel to exit the edit session without saving your entries.
93
Chapter 4: Setting Up Global Administration
ACCESSING THE GLOBAL SELECTABLE OPTIONS The Global Administrator can access the various selectable options that have been acquired for this data center. Access the Global Selectable Options. 1. Select option O on the Global Administration Options panel. The Global Selectable Options panel is displayed. •
The highlighting of this panel differs depending on which options your site has installed.
•
If no selectable options have been purchased by your data center, no options are listed.
2. Select the number for the option that you want to view and press ENTER. A Global Selectable Options panel (CMNGBSOP) similar to the following is displayed: CMNGBSOP ----------------- GLOBAL SELECTABLE OPTIONS -------------------------OPTION ===> 1 2 3 4 5
APS DB2 INFO OFM IMS
-
Change Man APS administrative functions Maintain DB2 information Specify Info/Management change rule Configure Online Forms Manager IMS Control Region IDs, and Library Sub-Type information
Press ENTER to process; Enter END command to exit.
The following table lists each possible options and a brief description of it. For complete details about using the option, see the individual ChangeMan ZMF option manuals.
94
Option
Description
APS
Lets you checkout and stage APS and non-APS entities as ChangeMan ZMF components.
DB2
Maintain DB2 programs, DB2 Data Request Components (DBRMs), and DB2 plans.
INFO
Administration panels related to ServiceDesk/390, the IBM Information Management (INFO/MAN) interface.
OFM
This option enables you to create and utilize customized forms as panels within ChangeMan ZMF. Full support of the mechanisms for completing, submitting, and approving forms within a change package is provided together with a notification facility to inform approvers when a form is submitted for their approval.
IMS
This option allows you to define IMS control regions and library sub-type information for ChangeMan ZMF implementation.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
USING PACKAGE USER RECORDS ChangeMan ZMF allows sites to store user data in a Package Master record associated with a given package. In Version 4.1.6, this was done with the CMNEX100 user exit. Now, under ChangeMan ZMF 5.3, this is done with a Global Option. It is enabled by turning on “Display Package User Option panel(s)” in Global Administration. When this option is turned on, Package User panels are available at create, update, and query time. These two modifiable panels (CMNDPUP1 and CMNDPUP2) are in the main panel library. As administrator, you can customize these panels to allow the user to store data in the Package User Record. There are currently the following variables available to you: USR0101 - USR0115 1 byte USR0201 - USR0211 2 bytes USR0301 - USR0310 3 bytes USR0401 - USR0410 4 bytes USR0801 - USR0810 8 bytes USR1601 - USR1605 16 bytes USR4401 - USR4405 44 bytes USR7201 - USR7205 72 bytes Please note that USR0199 is reserved for internal use as an indicator for the second panel display. This must be included on the first panel. You can only use the variables listed above. Any others you put on the panel are not stored in the Package Master file. Package User records can be edited via the update function of the Build menu (option ‘E’), or from the package list using the ‘UE’ line command. Only character data can be stored in these fields. This data is available to the same user exits that the old CMNEX100 data was, specifically: CMNEX002, CMNEX003, CMNEX009, CMNEX023, and CMNEX024. In the assembler code for the exits, the naming convention IXP$* is used, with ‘*’ indicating the numeric portion of the above variable names. Note: You must run conversion utility CMNRFMT to make data stored under Version 4 exit program CMNEX100 available as Package User Data under Version 5. See the Serena™ ChangeMan® ZMF Migration Guide.
95
Chapter 4: Setting Up Global Administration
96
SETTING UP APPLICATION ADMINISTRATION
5
This chapter explains how to set up and change administration for ChangeMan ZMF applications. Entries in application administration define the rules for managing the change lifecycle in each application.
HOW GLOBAL SETTINGS AFFECT APPLICATION SETTINGS Application fields can only be configured within the scope of the corresponding global fields. For example, if the Global Administrator restricted a particular field to NO at the global level, you cannot change the field definition to YES at the application level. The same applies to other types of fields (besides YES or NO). For example, if the staging restriction level in the global parameters is set to 3 (the most restrictive level), the staging restriction level at the application level cannot be 1 or 2; it must be a 3. However, if the staging restriction level at the global level is set to 1, then the staging parameter at the application level can be set to 1, 2, or 3. The following recommendations may help you set the application variables. •
Choose a three or four-character mnemonic that identifies the application. CMNEX004 controls the mnemonics you can use.
•
Gather the actual library names for Baseline, Production, Temporary, Backup, and Development.
•
Decide which library types will be used by all applications, maintained in Baseline, and installed into Production.
•
Determine the average space allocation needed for an update to the application (We recommend space in terms of tracks and at least 20 directory blocks.).
ACCESSING APPLICATION ADMINISTRATION Follow these steps to access application administration options.
97
Chapter 5: Setting Up Application Administration
1. On the Primary Option Menu, type A and press ENTER. The Administration Options panel is displayed: CMNADMOM ------------------- ADMINISTRATION OPTIONS --------------------------OPTION ===> A Application - Perform application administration functions G Global - Perform global administration functions Press ENTER to process; Enter END command to exit.
2. On the Administration Options panel, type A and press ENTER. The Application Administration Options panel is displayed: CMNLAMEN ------------- APPLICATION ADMINISTRATION OPTIONS --------------------OPTION ===> APPLICATION ===> DEMO 1 2 3 4 5 6 7 8 B C D N O P R
Parms Library Language Procedures Pln Approvals Upl Approvals Promotion Sites Baseline Component Delete Notify Options Production Reports
-
(Blank for list)
Generate application parameters Generate library types Generate language names Generate compiling procedures Create planned approval list Create unplanned approval list Configure promotion libraries Configure site information Configure baseline libraries Update component information, procedures, security Delete an application Update the Global Notification File Configure selectable options Configure production libraries Generate application batch reports
Press ENTER to process; Enter END command to exit.
Creating a New Application Perform these steps to create a new application. 1. On the Application Administrative Options panel, type the mnemonic for the new application in the APPLICATION field. The application mnemonic must be three or four characters long, and the first character of the mnemonic must be alphabetic or national (@ $ #). 2. Type 1 on the Option line and press ENTER. The Application Parameters Part 1 of 3 panel is displayed. You must start on this panel to define a new application. Note
98
Your security administrator must add the application mnemonic to the resource class and grant you UPDATE access before you can create the application in ChangeMan ZMF. See “Pre-Implementation Decisions” on page 25.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Updating Existing Applications There are two ways to access an existing application for update:
Single Application 1. On the Application Administration Options panel, type the application mnemonic in the APPLICATION field. 2. Type one of the administration options on the Option line, and press ENTER. The first panel for that option is displayed.
Application List 1. On the Application Administration Options panel, leave the APPLICATION field blank, leave the Option line blank, and press ENTER. The Application List panel is displayed: CMNPLST2 ---------------------- APPLICATION LIST ------------- Row 1 to 5 of 5 COMMAND ===> SCROLL ===> PAGE LINE COMMANDS: 1-Gen Parms 5-Pln. Apprv B-Baseline O-Options
2-Libraries 6-Unp. Apprv C-Component P-Production
3-Language 7-Promotion D-Delete R-Reports
4-Procedures 8-Sites N-Notify
APPL DESCRIPTION HIGHEST # STATUS _ $MIK Test application for CMN510 000001 _ IMS1 IMS Application 000009 _ NAVI SCRIPTION ADDED VIA RPC 000155 _ DEMO DEMO APPL MAY BE DELETED AND REDEFINED 000002 LOCKED _ T510 Test v510 application for use by all 000012 IN USE ******************************* Bottom of data ********************************
The following table describes the fields on the Application List panel. Field
Description
Line Command
Type a one-character application administration option listed at the top of the panel.
APPL
Displays application mnemonics defined to ChangeMan ZMF.
DESCRIPTION
Displays the application descriptions.
HIGHEST #
Displays the number of change packages that have been created in an application since the application was first defined.
99
Chapter 5: Setting Up Application Administration
Field
Description
STATUS
Indicates whether the application is available for update. LOCKED
IN USE
The Global Administrator has locked the application. Application administration cannot be changed until the Global Administrator unlocks the application. Application administration panels are displayed in browse mode. Another administrator is currently updating application administration. Application administration panels are displayed in browse mode. Application administration is available for update.
Blank
2. On the Application List panel, type an application administration option number in the line command for the application you want to update and press ENTER. The first panel for that option is displayed.
Locks on Application Administration You cannot update application administration if the application is locked or in use. •
Access to application administration may be locked by the Global Administrator. In this case, the following message is displayed when you select an Application Administration Option: CMN5175I - Application parameters globally locked for update. The Global Administrator must unlock the application before you can update the application definition. See “Locking or Unlocking Application Definitions” on page 86
•
Another administrator is currently updating the application definition. In this case, the following message is displayed when you select an Application Administration Option: CMN5176I - Application parameters currently being updated by USER238. When the other administrator finishes their update, the application definition becomes available for update. If message CMN5176I displays when no other administrator is updating the application, the Global Administrator must reset the “in use” indicator. “Locking or Unlocking Application Definitions” on page 86
SETTING APPLICATION PARAMETERS You set and generate your ChangeMan ZMF application parameters from the Application Parameters panels. Many of the application level parameters are a subset of global parameters, but they are tailored for the individual needs of each application's developers. The information you enter during this process is used as a default for change package creation; and in some cases, as boundaries for the change package process. By individually defining each application, you manage the implementation process through ChangeMan ZMF.
100
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
You can think of the parameter generation as a set of rules by which the users are governed. Many of the parameters set in these panels are originally set at the global level. Typically, these global parameters are very liberal, allowing the full spectrum of choice. The individual application level parameters can be more restrictive, tightening down on any sensitive application areas while allowing other applications more latitude. If the parameter is governed by the Global Administrator's choices for the same parameters a reference back to the global tables has been included. Note
If the Global Administrator restricted any settings at the global level you cannot change the field definition to a less restricted setting at the application level.
1. Select option 1 on the Application Administration Options menu (CMNLAMEN). The Application Parameters Part 1 of 3 panel (CMNGLP01) is displayed: CMNGLP01 --------APPLICATION PARAMETERS - PART 1 OF 3 ----------------------COMMAND ===>
APPLICATION DESCRIPTION ===> OPTIONAL MODEL TO COPY OPTIONAL SKELETON RELEASE ID NORMAL BUSINESS HOURS FROM KEEP BASELINE BY SITE ALLOW TEMPORARY PACKAGES AUDIT LEVEL CHECKOUT ENFORCEMENT RULE ENTITY CHECK IF RULE 2 ALLOW CONCURRENT CHECKOUT ALLOW CHECKOUT TO PERSONAL LIB. STAGING RESTRICTION LEVEL ENTITY CHECK IF LEVEL 2 OVERLAY PRIOR STAGED MODULE VALIDATE VERSION DURING STAGING PROMOTION/DEMOTION RULE
===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===>
TO ===>
(Clone an application) (* for list) (HHMM) (Y/N) (Y/N) (0,1,2,3,4,5) (1,2,3) (Y/N) (Y/N) (1,2,3) (Y/N) (Y/N) (0,1,2,3,4)
Press ENTER to continue; Enter END command to exit.
The following table describes the fields on the panel and the valid information that you can enter on the panel. Field
Description
APPLICATION DESCRIPTION
Enter a 40-character description of this application.
OPTIONAL MODEL TO COPY
Enter the application mnemonic that you want to use as a model for this application's parameters. This is optional if another application has been generated that has many of the same parameters. Use this option to “copy forward” and then modify where needed.
OPTIONAL SKELETON RELEASE ID
Enter the release identifier to be used at this site. If you want to select from a list of available release ID’s, type *. The Release ID (Selection) List is displayed.
101
Chapter 5: Setting Up Application Administration
Field
Description
NORMAL BUSINESS HOURS
Enter the time range describing the normal business day in military notation (HHMM). If a user creates an unplanned change package outside of these hours, the package only requires the abbreviated approval list to be promoted or installed. To always attach an abbreviated approval list for unplanned change packages, enter one minute for the range of your normal business day. For example, enter 0300 to 0301. ChangeMan ZMF always attaches an abbreviated approval list to unplanned change packages except between 3:00 a.m. and 3:01 a.m.
KEEP BASELINE BY SITE
Baseline libraries are maintained for each application. Enter YES to allow the Development or Development Production site to keep a set of Baseline libraries at that site for each additional site that has been generated within their ChangeMan ZMF system. Use if an application has multiple sites and you want to maintain Baseline libraries at each site. Enter NO if remote site Baseline libraries are not to be maintained. Only keep a single set of Baseline libraries for the site. This is the recommended option to choose because it:
ALLOW TEMPORARY PACKAGES
•
Prevents duplications of DASD
•
Makes the maintenance of skeletons easier
•
Keeps multiple sites synchronized
Temporary change packages are placed into production and concatenated ahead of Production libraries. They are never rippled into Baseline and are deleted from the production environment after a number of days specified at package creation. Enter YES to let temporary change packages be created. Enter NO to disallow users to create temporary changes.
AUDIT LEVEL
Enter the numeric value that dictates the Audit level that must be passed before a change package can be Frozen. 0—Audit is recommended but entirely optional. 1—Audit is required but any return code (except ABEND) is acceptable. This is the default option. 2—Audit is required and the return code must not exceed 12. This implies that there are “out-of-sync” situations within the Staging libraries. 3—Audit is required and the return code must not exceed 8. This implies that there are no “out-of-sync” situations within the Staging libraries, but there are “out-ofsync” situations with respect to the Baseline libraries. 4—Audit is required and the return code must not exceed 4. This implies that there are no “out-of-sync” situations within the Staging libraries or the Baseline libraries, but at least one component of Staging library is a “duplicate” of its baseline counterpart. 5—Audit is required and the return code must not exceed 0. This implies that there are no “out-of-sync” situations with either the Staging libraries or the Baseline libraries and no “duplicates” exist.
102
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
CHECKOUT ENFORCEMENT RULE
Enter the numeric value that dictates the rule that must be passed before a component (not new components, but components that exist in the Baseline) can be staged. The administrator can restrict who stages components that are not first checked out from Baseline. 1—Checkout is optional. Any component can be staged, regardless of whether it exists in Baseline or has been checked out to a package. ChangeMan ZMF does not check for the component's existence in the Baseline libraries. 2—Checkout is required unless the user passes an entity check. Users attempting to stage a component that exists in Baseline, but has not been checked out, must pass a security system ENTITY CHECK before the stage can proceed. The entity name is specified in the application parameter generation. Staging is not allowed if the user does not pass the entity check. 3—Checkout is mandatory. Disallow anyone from staging a component that exists in the Baseline library but has not been checked out to the package requesting the stage.
ENTITY CHECK IF LEVEL 2
If rule 2 of the above checkout enforcement rules was selected, enter the Entity Name. This is the name used for the entity check when users sign on to ChangeMan ZMF and select the Stage function. Those users whose TSO ID has been associated to the entity name are allowed to stage components that have not been checked out to their package but exist in the application's Baseline library.
ALLOW CONCURRENT CHECKOUT
Enter YES if components can be checked out to personal or Staging libraries. (This allows concurrent checkout of components that are already included in a change package. During installation the second, checked-out component overlays the first.) Enter NO if components cannot be checked out if they reside in another package. (This prevents users from checking out components that are already checked out to a package.) This rule applies to the same package as well as to other packages. It is disregarded for unplanned (emergency) packages.
ALLOW CHECKOUT TO PERSONAL LIB
Enter YES to let users check out to a personal library.
STAGING RESTRICTION LEVEL
This option restricts who is allowed to stage new components and who does maintenance. From the user's view, it regulates the Stage Development Driven user option in the Stage Options panel (CMNSTG00).
Enter NO to require all checkouts to go to Staging libraries. This rule is disregarded for unplanned (emergency) packages.
1—Allow all users access to both Development Driven (stage components into a package without checking them out) and Package Driven stage options. 2—Users are required to pass an entity check before being allowed to stage any components via the Stage Development Driven option. Only TSO IDs associated with the ENTITY name are allowed to use both stage options. The entity name, which must be defined to your security system, is specific in the Staging Restriction Level in the application parameters. 3—All users are required to CHECKOUT all components to a package before staging, effectively disabling the Stage - Development Driven Option.
103
Chapter 5: Setting Up Application Administration
Field
Description
ENTITY CHECK IF 2 ABOVE
If Staging Restriction 2 (above) was selected. This is the name used for the entity check when users sign on to ChangeMan ZMF and select the Stage Function. Those users whose TSO ID has been associated to the entity name are allowed to stage from a development driven list.
OVERLAY PRIOR STAGED COMPONENT
If one user in an application has staged source components and another user tries to stage another version of the same component in the same change package, this field dictates whether overlaying of the first component is allowed. Enter YES to let any prior staged component be overlaid. A confirmation warning request is issued by ChangeMan ZMF before this is done. Enter NO to enforce a single owner of a component. This option is not enforced against members that are checked out to the package in batch. Note: More than one user can access the same component within the same change package. Entering a NO in this field prevents the overlaying of the same component by another user. This is based on what the ISPF statistics are in the user’s personal library. If those statistics do not match what is defined as the user ID in the staging package, then ChangeMan ZMF does not allow an overlay. The TSO ID in the package is a determining factor for the overlay. For example, if the TSO ID on panel CMNSTG01 (described in the Serena™ ChangeMan® ZMF User Guide) is SER20, then only SER20 is able to bring in a different copy of the component.
104
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
VALIDATE VERSION DURING STAGING
This function ensures the integrity of a Baseline library component between checkout and staging. Users must check out components (not stage from Development libraries) for this function to be in effect. This option is also affected by the STAGING RESTRICTION LEVEL field. If the baseline version of a component has been altered after a user has checked it out (for example, another package has been installed that contains this component), staging of that component is prevented. Enter YES to enforce this validation (require a regression test). Enter NO to ignore the validation.
PROMOTION/ DEMOTION RULE
Enter the numeric value that regulates the movement of components from Promotion libraries to Staging (for editing) and back again. For an overview of Promotion in the ChangeMan ZMF cycle, see “What is ChangeMan ZMF?” on page 19. 0—Allows the Promotion and Demotion of components even if the change package has not yet been frozen. This is liberal Promotion and Demotion. It allows re-editing of components in the staging library, without forcing a Demotion. Thus, different versions of a component can exist simultaneously in Staging and Promotion libraries. For example, if a component at promotion level 2 is edited in staging, its promotion level is shown as 0 at the promotion panel. However, the component still exists in the level 2 library. It is the responsibility of the users to monitor these versions and demote previously promoted components, if desired. Rules 1 through 4 restrict Promotion to frozen (FRZ status) packages only: 1—Requires selective Demotion of a component followed by selective Refreeze, Edit, and Promotion directly back to the package's promotion level. 2—Requires selective Demotion of a component followed by selective Refreeze, Edit, and Promotion through all intermediate promotion levels. 3—Requires full Demotion of the entire package followed by a selective Refreeze, Edit, and Promotion through all intermediate promotion levels. 4—Requires full Demotion of the entire package followed by a Revert of the entire package to DEV status.
105
Chapter 5: Setting Up Application Administration
2. After you have completed entering information in the fields of the panel, press ENTER. The Application Parameters Part 2 of 3 panel (CMNGLP02) is displayed: CMNGLP02 -------------- APPLICATION PARAMETERS - PART 2 OF 3 ---------------COMMAND ===>
JOB NAME INCREMENT OVERRIDE USE ZPREFIX IN BATCH JOBS CREATE COMPONENT WORK RECORDS FORCE AUDIT OF UNPLANNED PACKAGES BYPASS STAGING LIBRARY ENQUEUES ALLOW LINK PACKAGES MEMO DELETE EMPTY PACKAGES ONLY
===> ===> ===> ===> ===> ===> ===>
NO NO NO NO NO NO NO
(Y/N) (Y/N) (Y/N) (Y/N) (Y/N) (Y/N) (Y/N)
APPROVAL RESTRICTIONS: PACKAGE CREATOR CANNOT APPROVE PACKAGE WORKER CANNOT APPROVE ONLY 1 APPROVAL PER USER ID
===> NO ===> NO ===> NO
(Y/N) (Y/N) (Y/N)
ALLOW DESIGNATED PROC OVERRIDE
===> NO
(Y/N)
Press ENTER to continue; Enter B to go back 1 screen, or CANCEL to exit.
The following table describes the fields on the Application Parameters Part 2 of 3 panel (CMNGLP02) and the valid information that you can enter on the panel: Field
Description
JOB NAME INCREMENT OVERRIDE
Determines if the job name suffix is incriminated in batch jobs submitted for background processing (batch API jobs). This option applies if:
USE ZPREFIX IN BATCH JOBS
106
•
The job name in the JOB STATEMENT INFORMATION field consists of a userid and a one-character suffix.
•
You select Batch (background) as the processing mode for stage or checkout, or you run Audit Auto Resolve.
YES
Do not increment the job name suffix for batch jobs submitted for background processing; force background processing for a userid to single-thread.
NO
Increment the job name each time a job is submitted for background processing.
Determines if ChangeMan ZMF uses the userid to construct a TSO profile to identify the variable pools when a TSO session is opened for batch API processing. YES
Use &ZPREFIX instead of &ZUSER in the PROFILE PREFIX command in batch TSO sessions for batch API functions.
NO
Use &ZUSER in the PROFILE PREFIX command in batch TSO sessions for batch API functions.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
CREATE COMPONENT WORK RECORDS
Determines if component work records are created when a package component is changed. Component work records show who has updated a package component. Component work records can be accessed from the package component list. YES NO
Create a component work record when a package component is updated. Do not create component work records.
FORCE AUDIT OF UNPLANNED PACKAGES
BYPASS STAGING LIBRARY ENQUEUES
ALLOW LINK PACKAGES
Determines if audit is required for unplanned packages. This option is only in effect if the Audit Level is higher than 0. YES
Require audit before freeze for unplanned packages. A bad return code from audit will not prevent freeze for unplanned packages.
NO
Allow freeze without audit for unplanned package.
Determines if all staging libraries in a package are enqueued while a delete request from the Stage Package Component panel is processed. YES
Disable the staging library enqueue for component delete processing.
NO
Enqueue all staging libraries for a package while processing a delete request.
Allows packages in this application be linked to other change packages through ChangeMan ECP. Refer to the ChangeMan ECP Linked Package facility. Linked packages are subject to delete, freeze, approval, and revert restrictions. YES
Allow packages in this application to be linked to other packages through ChangeMan ECP.
NO
Prohibit package linking in this application.
MEMO DELETE EMPTY PACKAGES ONLY
YES
Prohibit package Memo Delete if a change package contains any components or utility requests (scratch or rename).
APPROVAL RESTRICTION S
The next three fields on this panel limit a user’s approval authority for a planned package, even though they may otherwise be permitted to approval to that package. Approval restrictions controlled by these parameters do not apply to unplanned packages.
PACKAGE CREATOR CANNOT APPROVE
Prohibits the user who created a package from entering an approval for that package, even if they are authorized by the security system to enter approvals.
NO
Permit Memo Delete when a package contains components or utility requests.
This option applies only to planned packages. Approvals for unplanned packages are not effected by this option. YES
Prohibit users from entering an approval for a package that they created.
NO
Allow users to approve a package that they created, if they are authorized.
107
Chapter 5: Setting Up Application Administration
Field
Description
PACKAGE WORKER CANNOT APPROVE
Prohibits a user who has worked on a component in a package from entering an approval for that package, even if they are authorized by the security system to enter approvals. This option is in effect only if the CREATE COMPONENT WORK RECORDS option is YES. This option applies only to planned packages. Approvals for unplanned packages are not effected by this option.
ONLY 1 APPROVAL PER USER ID
ALLOW DESIGNATE PROC OVERRIDE
108
YES
Prohibit a user who worked on a package component from entering an approval for the package.
NO
Allow a user who has worked on a package component to approve the package, if they are authorized.
Prohibits one user from entering more than one approval for a package, even if they are authorized by the security system to enter those approvals. This option applies only to planned packages. Approvals for unplanned packages are not effected by this option. YES
Restrict each userid to only one approval per package.
NO
Allow a userid to enter more than one approval for a package, if they are authorized.
Allows specification of a different target load type in a Designated Compile Procedure than the Target Type defined for the like-source type in Application Library Types. YES
Allow a different like-load type to be entered in the LOD Type field on the Component List panel (the second panel for Designated Compile Procedure definitions).
NO
Restrict the Old Type field to the same value as the Target Load in Application Library Types.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
3. After you have completed entering information in the fields of the panel, press ENTER. The Application Parameters Part 3 of 3 panel (CMNGLP03) is displayed: CMNGLP03 ------------- NAVI PARAMETERS - PART 3 OF 3 -------------------------COMMAND ===> AGING - INSTALLED PACKAGES - STAGING DATASETS DEFAULT UNIT NAME DEFAULT VOLUME SERIAL REQUIRE WORK REQUEST NUMBER REQUIRE DEPARTMENT NUMBER HIERARCHICAL APPROVAL PROCESS SAVE TO PERSONAL & STAGING LIBS EDIT STAGING RECOVERY MODE ON
===> ===> ===> ===> ===> ===> ===> ===> ===>
30 14 3390
(0 to 999 days) (0 to 999 days) (Generic disk unit)
NO NO NO NO NO
(Y/N; affects INFO) (Y/N) (Y/N) (Y/N) (Y/N)
JOB CARD INFORMATION: ===> //NAVIAPPL JOB (X170,374),'APPL NAVI',__________________________________ ===> // CLASS=U,MSGCLASS=9_______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to generate application parameters. Enter B to go back 1 screen or CANCEL to exit.
The following table describes the fields of the Application Parameters Part 3 of 3 panel (CMNGLP03) and the information that you can enter on the panel. Field
Description
AGING INSTALLED PACKAGES
Enter the number of days that you wish the package record to remain in the Package Master.
AGING STAGING DATASETS
Enter the number of days that you wish the staging data sets from the package to remain in the systems catalog.
Since the installed package record must exist in the Package Master at the time its associated Staging libraries are deleted, the value in this field must be greater than or equal to the value in the Aging Staging Datasets field. Also, the status of the package must be BAS, INS, or TCC.
The value in this field must be less than or equal to the value in the Aging Installed Packages field. Also, the status of the corresponding change package must be BAS, INS, or TCC. To delete or archive the package records, run the appropriate housekeeping job. NOTE: The housekeeping job deletes the staging data sets after the package installation date. Once the staging data sets are deleted, you cannot backout the package.
109
Chapter 5: Setting Up Application Administration
Field
Description
DEFAULT UNIT NAME
Enter the generic unit name for disk packs that all dynamic allocations use unless otherwise specified (for example, SYSDA). It is the type of disk device to use for allocation of (non-temporary) data sets by ChangeMan ZMF. This is the disk device in which ChangeMan ZMF allocates the X.REMOTESITE and the.PACKAGE set of the staging data sets. This field can be left blank if you specify the Default Volume Serial in the DEFAULT VOLUME SERIAL field. (If this field and the default volume serial are left blank, it could lead to the use of temporary disk device usage, for example, 3390. The allocated data sets are then subject to being scratched without notification.)
DEFAULT VOLUME SERIAL
Enter the volume serial number that all dynamic allocations use unless specified elsewhere in ChangeMan ZMF.
REQUIRE WORK REQUEST NUMBER
Enter YES to require users to enter a work request number during package creation.
REQUIRE DEPARTMENT NUMBER
Enter YES to require users to enter a department number during package creation.
HIERARCHICA L APPROVAL PROCESS
Type YES to notify package approval “User to notify” in the sequence specified in the approval Order Number. Notification of “Users to notify” at the next sequential Order Number occurs when all approvals at the previous Order Number have been entered.
The serial number of the volume to use for allocation of (nontemporary) data sets by ChangeMan ZMF. This field is not required if the DEFAULT UNIT NAME field has been set. This is the serial number of the volume in which ChangeMan ZMF allocates the X.REMOTESITE and the.PACKAGE set of the staging data sets.
Enter NO to make the entry of a work request number optional.
Enter NO to make the entry of a department number optional.
Type NO to notify all approval “Users to notify” at all Order Numbers when the package is frozen. SAVE TO PERSONAL & STAGING LIBS
110
Enter YES to update Staging and Personal libraries. Enter NO to allow updates to the Staging library only when a component is staged from a Development library and then edited through ChangeMan ZMF.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
EDIT STAGING RECOVERY MODE ON
Indicate whether the edit staging recovery mode is on. Enter YES to allow users to keep track of all changes made to a component. These changes are stored in a development data set. If an ABEND occurs, users can recover the changes when reentering ChangeMan ZMF. Note: To activate the Recovery Process during a ChangeMan ZMF Edit-In-Staging session, this field must be ON. Enter NO to not allow users to recover the changes when reentering ChangeMan ZMF after an ABEND occurs.
JOB CARD INFORMATION
This job card information is used when the package installation jobs are built at Freeze time. Specifically, ChangeMan ZMF uses it when submitting batch jobs for distributing change packages, acknowledging distribution, installing change packages, acknowledging installation, backing out change packages, and rippling an application's baseline files. The job name is set to reflect package and installation transaction numbers This is the only job card information that the Global and Application Administrators provide. Users are required to set up similar job cards for batch API jobs such as Staging and Freezing.
4. Press ENTER to save and generate the application parameters.
DEFINING LIBRARY TYPES AND STAGING LIBRARY ATTRIBUTES A library type definition sets processing rules for the components stored under that library type. The definition also sets the data set attributes for the package stage library that is allocated for the library type. The Application Administrator defines the library types in each application. Application library types are copied from global library type definitions. Only library types defined in global administration can be defined in an application. However, an application does not have to contain all of the library types defined in global administration.
Library Type Order The order that library types are listed on the Application Library Types Part 1 of 2 panel determines the order that library types are processed in some ChangeMan ZMF functions. (This panel is shown on page 113.)
111
Chapter 5: Setting Up Application Administration
Library Concatenations ChangeMan ZMF uses the library type definition order when it includes stage libraries in library concatenations for batch job JCL. The following table lists some library concatenations that depend on the library type definition order. JCL ddname
Library Type
Used in batch jobs...
SYSLIB
LIKE-C types
Copybook expansion steps running ChangeMan ZMF program CMNWRITE Copybook libraries in compile and assemble jobs Copybook libraries in BMS MAP gens Copybook libraries in IMS PSB/DBD gens
SYSLIB
LIKE-L types
Load libraries in link edit Load libraries in IMS PSB/DBD gens
INCLIB
Target Type
Load libraries in link edit.
OBJLIB
Object library types defined in skeleton CMN$$VAR
Object libraries in link edit
The staging library sequence in concatenations matches the order of application library types definitions. The order of promotion and baseline libraries is not affected by library type definitions on the Application Library Type Part 1 of 2 panel.
Audit Auto-Resolve The Auto-Resolve feature of audit submits recompile and relink jobs to automatically resolve out-of-synch conditions in a change package. Recompile jobs are submitted before relink jobs. The sequence of recompile and relink jobs is determined by the order of library type definitions on the Application Library Type Part 1 of 2 panel. If you code Like-Source library types for subroutines before Like-Source library types for calling programs, Audit Auto-Resolve submits recompile jobs for subroutines before submitting recompile jobs for calling programs. If you code Like-Load library types for subroutines before Like-Load library types for calling programs, Audit Auto-Resolve submits relink jobs for subroutines before submitting relink jobs for calling programs. Processing subroutines before calling programs is the most efficient way to resolve all out-ofsynch conditions in the fewest number of steps.
Defining Library Types for a New Application Perform these steps to define the library types for a new application.
112
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. On the Application Administration Options panel, type 2 on the Option line and press ENTER. The Application Library Types Part 1 of 2 panel is displayed: CMNCLLT0 ------------ DEMO - LIBRARY TYPES PART 1 OF 2 ----- Row 1 to 15 of 17 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit.
'''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' ''''
LIB TYPE CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC
LIKE DEFER TARGET SEL. DESCRIPTION (S/C/L/P)(Y/N) TYPE OPT. Copybooks___________________________________ C Y ___ __ Control Statements (PARMLIB)________________ P Y ___ __ DB2 Bind Control____________________________ P Y ___ __ DB2 DBRM____________________________________ P Y ___ __ Job Execution JCL___________________________ P Y ___ __ Link Edit Control Statements________________ P Y ___ __ Compressed Stage Listings___________________ P Y ___ __ Load Modules________________________________ L Y ___ __ BMS MAP Load Modules________________________ L Y ___ __ BMS MAP Copybook (DSECT)____________________ C Y ___ __ BMS MAP Source______________________________ S Y MAP __ Object Code_________________________________ P Y ___ __ JCL Cataloged Procedures____________________ P Y ___ __ DB2 Package Bind Control____________________ P Y ___ __ ISPF Skeletons______________________________ P Y ___ __ Source Code_________________________________ S Y LOD __
The following table describes the fields on the Application Library Types Part 1 of 2 panel. Field
Description
Line Command
Type a line command to the left of a panel row. S
Select to see the next panel for this library type.
I
Insert a blank library type row.
R
Repeat an existing library type row.
D
Delete an existing library type row.
*
Display a selection list of available library types.
113
Chapter 5: Setting Up Application Administration
Field
Description
LIB TYPE
Type a three character library type. Some library types are reserved. These types have built-in attributes, and they are used in particular internal processes.:
DESCRIPTION
114
ASC
APS painted screens (ChangeMan ZMF APS Option) - DCB must be RECFM=F/FB, LRECL=240
CPY
Copybooks - Defaults to Like-Copy (see the definitions for the LIKE types below.) DCB must be RECFM=F/FB, LRECL=80
CTC
Control Statements - Defaults to Like-PDS. DCB must be RECFM=F/ FB, LRECL=80
DBB
DB2 Bind Control Statements (ChangeMan ZMF DB2 Option) - Defaults to Like-PDS. Used by the DB2 Selectable Option. DCB must be RECFM=F/FB, LRECL=80
DBR
DB2 DBRM (ChangeMan ZMF DB2 Option) - Defaults to Like-PDS. Used by the DB2 Selectable Option. DCB must be RECFM=F/FB, LRECL=80
DOC
Documentation. Defaults to Like-PDS. DCB must be RECFM=F/FB/V/ VB
JCL
JCL - Defaults to Like-PDS, although libraries with this type are included in Impact Analysis JCL relationships. DCB must be RECFM=F/FB, LRECL=80
LCT
Link Edit Control Statements - Defaults to Like-PDS. DCB must be RECFM=F/FB, LRECL=80
LOD
Load Modules - Defaults to Like-Load. DCB must be RECFM=U.
LST
Compressed Stage Listings - Defaults to Like-PDS. Cannot be explicitly staged. DCB must be RECFM=F/FB, LRECL=80.
PRC
Cataloged JCL Procedures - Default to Like-PDS, although libraries with this type are included in Impact Analysis JCL relationships. DCB must be RECFM=F/FB, LRECL=80
SRC
Source Code - Defaults to Like-Source. DCB must be RECFM=F/FB, LRECL=80
Enter freeform text describing the library type.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
LIKE (S/C/L/P)
Type a one-character LIKE code to define behaviors and characteristics of a library type. S
Like-Source - Components in Like-Source library types are staged through a batch job defined by a Language and Procedure assigned to the component to create a component in a Like-Load library type. Every Like-Source library type must have a TARGET TYPE in its Library Type Definition. There is a source-load relationship between every LikeSource component and a Like-Load component. Members in LikeSource libraries are analyzed for Impact Analysis CPY relationships.
C
Like-Copy - Components in Like-Copy library types are not processed through a procedure by stage. Like-Copy libraries are included in SYSLIB concatenations for copybook libraries. Members in Like-Copy libraries are analyzed for Impact Analysis CPY relationships.
L
Like-Load - Components in Like-Load libraries are assumed to be the product of a stage procedure performed on a Like-Source component. Like-Load libraries are included in SYSLIB concatenations for load libraries. Members in Like-Load libraries are analyzed for Impact Analysis LOD relationships.
P
Like-PDS -Components in Like-PDS library types are not processed through a procedure by stage. Like-PDS libraries are not included in SYSLIB concatenations for copybook or load libraries. Members in LikePDS libraries are not analyzed for Impact Analysis relationships.
Blank
Like-Other - If you leave the LIKE field blank in a Library Type Definition, the type is referred to as “Like-Other”. Components in Like-Other library types are staged through a batch job created from an ISPF skeleton named CMN$$xxx where xxx is the Like-Other library type. You must code Like-Other skeletons from a model named CMN$$OTH delivered from SERENA. Like-other libraries are not analyzed for Impact Analysis relationships. Note: Like-Other components are not analyzed by Audit.
DEFER
Y
Defer allocation of the staging library for this types until the fist component of the type is staged or checked out.
N
Allocate the stage library for this type when the change package is created, even though there may never be any members of this library type in the package.
TARGET TYPE
Type a Like-Load target library type for each Like-Source library type.
SELECTABLE OPTION
Use this field to associate a library type with a ChangeMan ZMF selectable option that you have licensed. The behavior of the library type may require further definition in administration panels or ISPF skeletons. A
APS Option
D
DB2 Option
I
IMS Option
115
Chapter 5: Setting Up Application Administration
When the Application Library Types Part 1 of 2 panel is first displayed for a new application, all of the library types defined on the Global Library Types Part 1 of 2 panel are displayed The definitions displayed on this panel are the same as those in global administration. Note
Library type definitions should be standardized across all applications. You should not change the fields displayed for a library type on the Application Library Types Part 1 of 2 panel. If you need a unique definition for a library type, you should define a new global library type.
2. If a library type is not needed for this application, or if you wish to change the order of the definitions by deleting and redefining a library type, type D (Delete) in the line command for the library type on the Application Library Types Part 1 of 2 panel and press ENTER. The library type is deleted. 3. To add a library type to the Application Library Types Part 1 of 2 panel that you previously deleted: a) Type I (Insert) in the line command above where you want to insert the library type and press ENTER. An empty library type entry is inserted on the panel. b) Type * in the line command for the empty library type definition and press ENTER. The Global Library Type Selection List panel is displayed: CMNGLTPL ------------- GLOBAL LIBRARY TYPE SELECTION LIST - Row 1 to 20 of 151 COMMAND ===> SCROLL ===> PAGE
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
LIB CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC TST
DESCRIPTION Copybooks Control Statements (PARMLIB) DB2 Bind Control DB2 DBRM Job Execution JCL Link Edit Control Statements Compressed Stage Listings Load Modules BMS MAP Load Modules BMS MAP Copybook (DSECT) BMS MAP Source Object Code JCL Cataloged Procedures DB2 Package Bind Control ISPF Skeletons Source Code Test Library Type
c) On the Global Library Type Selection List panel, type S in the line command for any global library type that you want to add at the insert point on the Application Library Type Part 1 of 2 panel. You may select multiple library types, but you can not scroll down to select global library types from multiple pages of the Global Library Type Selection List at one time. d) Press ENTER to return to the Application Library Type Part 1 of 2 panel, where the new library types have been added at the insertion point.
116
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
4. There is a second panel for each library type that defines additional processing rules and the staging library attributes for a library type. Type S in the line command for a library type and press ENTER. The Application Library Types Part 2 of 2 panel is displayed: CMNCLLT1 ------------ DEMO - LIBRARY TYPES PART 2 OF 2 -----------------------COMMAND ===> LIBRARY TYPE: CPY - Copybooks LIKE VALUE: C DEFER VALUE:
Y
STAGING DATASET ATTRIBUTES: GENERIC UNIT NAME ===> 3390 (Generic group name or unit) VOLUME SERIAL ===> (Required if GENERIC UNIT unspecified) SPACE UNITS ===> TRK (TRK, CYL or BLK) PRIMARY QUANTITY ===> 1 (In above units) SECONDARY QUANTITY ===> 1 (In above units) DIRECTORY BLOCKS ===> 5 RECORD FORMAT ===> FB RECORD LENGTH ===> 80 BLOCK SIZE ===> 0 DATA SET TYPE ===> PDS (LIBRARY for PDSE, PDS for pds, or blank) OTHER OPTIONS: CHECKOUT COMPONENT DESCRIPTION ===> NO (Y/N) CHECKOUT COMPONENT ACTIVITY FILE ===> NO (Y/N) COMPONENT ACTIVITY FILE TYPE ===> SAVE STAGING VERSIONS ===> NONE ALWAYS/NONE/PROMPT Press ENTER to process; Enter END command to exit.
The following table describes the fields on the Application Library Type Part 2 of 2 panel. Field
Description
GENERIC UNIT NAME
Type the DASD generic group or unit device name to be used for allocating staging libraries for this library type. This field may be left blank if the VOLUME SERIAL field is used.
VOLUME SERIAL
Type the DASD volume serial number where stage libraries are to be allocated for this library type. This field may be left blank if the GENERIC UNIT NAME field is used.
SPACE UNITS
Type the units to be used for the primary and secondary space allocations for staging libraries for this library type. TRK
Allocate space in tracks.
CYL
Allocate space in cylinders.
BLK
Allocate space in blocks.
PRIMARY QUANTITY
Type the primary space, secondary space, and directory block allocation to be used for the staging libraries for this library type.
SECONDARY QUANTITY
Use MINIMUM space allocations, especially the PRIMARY QUANTITY. ChangeMan ZMF dynamically reallocates stage libraries if extents or directory blocks are exhausted as the change package grows.
DIRECTORY BLOCKS
Unused space in PDS stage libraries is freed when the change package is frozen. ChangeMan ZMF does not automatically compress stage libraries, but you can compress stage libraries for a package with the ZP Package List command.
117
Chapter 5: Setting Up Application Administration
Field
Description
RECORD FORMAT
Type the staging library record format for this library type. Valid values include: F, FA, FB, FBA, FBM, FM, FS, V, VA, VB, VBA, VBM, VM, U Legend: F - Fixed length records V - Variable length records U - Undefined format records B - Blocked records S - Standard blocks A - ASA printer control characters M - Machine code printer control characters
RECORD LENGTH
Type the logical record length for components in this library type.
BLOCK SIZE
Type the staging library block size for this library type. You may enter 0 to let SMS calculate the best block size for the storage device.
DATASET TYPE
Type LIBRARY for PDSE stage libraries. Leave the field blank or type PDS for PDS stage libraries.
CHECKOUT COMPONENT DESCRIPTION
YES
Copy the Component General Description from the Package Master to the change package when a component is checked out. Allow developers to create or update the Component General Description through a change package.
NO
Do not copy the Component General Description from the Package Master to the change package when a component is checked out. Prevent developers from creating or updating the Component General Description in a change package. The Component General Description can always be created or updated through Application Administration.
CHECKOUT COMPONENT ACTIVITY FILE
YES
Automatically checkout a second component with the same name in a second library type when you checkout a component in this library type. The second library type specified below in the COMPONENT ACTIVITY FILE TYPE field. The second library type is called a “Component Activity File” here, but it can be any like-PDS library type defined to this application. If you check out a component to a personal library, the Activity File is checked out to the staging library. If there is no Activity File member with the same name in baseline, you must create one (stage from development) in your package. If there is no matching Activity File member, Audit flags a SYNCH6!
NO
COMPONENT ACTIVITY FILE TYPE
118
Checkout components in this type without checking out a second component with the same name in another library type.
Type the library type of the Component Activity File. This field is only required if YES is specified in the CHECKOUT COMPONENT ACTIVITY FILE field.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
SAVE STAGING VERSIONS
This field dictates whether a component in a staging library is saved before it is overlaid by a new version from edit-in-stage, checkout, or stage from development. ALWAYS
The previous version is always saved in a staging version before overlay.
NONE
The previous version is never saved before overlay.
PROMPT
The developer may choose not to save a staging version if the following are true: The developer is replacing or overlaying the component in the staging library, not deleting it. The ID on the component in the staging library is the same as the developer’s TSO userid.
When this panel is first displayed for a library type in a new application, the fields on the panel are the same as the fields on the Global Library Types Part 2 of 2 panel for the library type. Note
You may adjust the values displayed on the Application Library Types Part 2 of 2 to fit the needs of the application you are defining. Library type standardization does not need to include the attributes and rules displayed on this panel.
5. When you are finished updating fields on the Application Library Type Part 2 of 2 panel, press ENTER to return to the Application Library Types 1 of 2 panel. 6. When you are finished creating library type definitions on the Application Library Types Part 1 of 2 panel, press PF-3 or type END and press ENTER to store the application library type definitions in the Package Master file.
Updating Application Library Types Perform these steps to update application library type definitions.
119
Chapter 5: Setting Up Application Administration
1. On the Application Administration Options panel, type 2 on the Option line and press ENTER. The Application Library Types Part 1 of 2 panel is displayed: CMNCLLT0 ------------ DEMO - LIBRARY TYPES PART 1 OF 2 ---- Row 1 to 16 of 150 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. Enter * in line command field for global staging libraries selection list.
'''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' ''''
LIB TYPE CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC TST
LIKE DEFER DESCRIPTION (S/C/L/P)(Y/N) Copybooks___________________________________ C Y Control Statements (PARMLIB)________________ P Y DB2 Bind Control____________________________ P Y DB2 DBRM____________________________________ P Y Job Execution JCL___________________________ P Y Link Edit Control Statements________________ P Y Compressed Stage Listings___________________ P Y Load Modules________________________________ L Y BMS MAP Load Modules________________________ L Y BMS MAP Copybook (DSECT)____________________ C Y BMS MAP Source______________________________ S Y Object Code_________________________________ P Y JCL Cataloged Procedures____________________ P Y DB2 Package Bind Control____________________ P Y ISPF Skeletons______________________________ P Y Source Code_________________________________ S Y Test Library Type___________________________ P Y
TARGET TYPE ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ MAP ___ ___ ___ ___ LOD ___
SEL. OPT. __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __
See the table that starts on page page 113 that describes fields on this panel. Note
Library type definitions should be standardized across all applications. You should not change the fields displayed on the Application Library Types Part 1 of 2. If you need a unique definition for a library type, you should define a new global library type.
2. To delete a library type from the Application Library Types Part 1 of 2 panel, type D (Delete) in the line command for the library type and press ENTER. 3. To add a library type to the Application Library Types Part 1 of 2 panel: a) Type I (Insert) in the line command above where you want to insert the library type and press ENTER. An empty library type entry is inserted on the panel.
120
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
b) Type * in the line command for the empty library type definition and press ENTER. The Global Library Type Selection List panel is displayed: CMNGLTPL ------------- GLOBAL LIBRARY TYPE SELECTION LIST - Row 1 to 20 of 151 COMMAND ===> SCROLL ===> PAGE
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
LIB CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC TST
DESCRIPTION Copybooks Control Statements (PARMLIB) DB2 Bind Control DB2 DBRM Job Execution JCL Link Edit Control Statements Compressed Stage Listings Load Modules BMS MAP Load Modules BMS MAP Copybook (DSECT) BMS MAP Source Object Code JCL Cataloged Procedures DB2 Package Bind Control ISPF Skeletons Source Code Test Library Type
c) On the Global Library Type Selection List panel, type S in the line command for any global library type that you want to add at the insert point on the Application Library Type Part 1 of 2 panel. You may select multiple library types, but you can not scroll down to select global library types from multiple pages of the Global Library Type Selection List at one time. d) Press ENTER to return to the Application Library Type Part 1 of 2 panel, where the new library types have been added at the insertion point.
121
Chapter 5: Setting Up Application Administration
4. To update additional processing rules or the staging library attributes for a library type, type S in the line command for the library type on the Application Library Types Part 1 of 2 panel. The the Application Library Types Part 2 of 2 panel is displayed: CMNCLLT1 ------------ DEMO - LIBRARY TYPES PART 2 OF 2 -----------------------COMMAND ===> LIBRARY TYPE: CPY - Copybooks LIKE VALUE: C DEFER VALUE:
Y
STAGING DATASET ATTRIBUTES: GENERIC UNIT NAME ===> 3390 (Generic group name or unit) VOLUME SERIAL ===> (Required if GENERIC UNIT unspecified) SPACE UNITS ===> TRK (TRK, CYL or BLK) PRIMARY QUANTITY ===> 1 (In above units) SECONDARY QUANTITY ===> 1 (In above units) DIRECTORY BLOCKS ===> 5 RECORD FORMAT ===> FB RECORD LENGTH ===> 80 BLOCK SIZE ===> 0 DATA SET TYPE ===> PDS (LIBRARY for PDSE, PDS for pds, or blank) OTHER OPTIONS: CHECKOUT COMPONENT DESCRIPTION ===> NO (Y/N) CHECKOUT COMPONENT ACTIVITY FILE ===> NO (Y/N) COMPONENT ACTIVITY FILE TYPE ===> SAVE STAGING VERSIONS ===> NONE ALWAYS/NONE/PROMPT Press ENTER to process; Enter END command to exit.
See the table that starts on page page 117 that describes fields on this panel. Note
You may adjust the values displayed on the Application Library Types Part 2 of 2 to fit the needs of the application you are defining. Library type standardization does not need to include the attributes displayed on this panel.
5. When you are finished updating library type definition fields on the Application Library Type Part 2 of 2 panel, press ENTER to return to the Application Library Types 1 of 2 panel. 6. On the Application Library Type Part 1 of 2 panel, press PF-3 or type END and press ENTER to store the application library type definitions in the ChangeMan ZMF Package Master File.
DEFINING THE LANGUAGES You provide ChangeMan ZMF with all of the language names available in this environment. ChangeMan ZMF can still process component types if source and like source language types are not defined here, but when you define them, users are able to reference these component types by language. The Application Administrators select from this list when individual applications are set up. This information can also be used as a selection list from within the global options whenever necessary. To define the languages, take the following steps:
122
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. Select option 3 on the Application Administration Options panel. The Application Language Names panel (CMNCLLNG) is displayed: CMNCLLNG ------------------- APPLICATION LANGUAGE NAMES ---------------------------COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit.
'''' '''' '''' ''''
LANGUAGE COBOL2__ COBOL __ ASM __ PLI __
2. Define a standard language or update an existing standard language on the panel. The standard language names you define is associated with the language assumption feature of ChangeMan ZMF. This feature assists users who neglect to explicitly define the language type of a source or like-source component type that they stage. The language assumption feature searches the code of the staged component, matches its language name to the standard language names you define, and names it. 3. Type END to save your entry.
DEFINING THE COMPILING PROCEDURES This option is used to enter all the different procedures that are needed to compile and link source components. This information is displayed for selection during any application level change package staging. Thus, it must include all of the procedures for change installation of all applications. Even if your application does not contain any source components, you must enter a compile procedure. To define the compiling procedures, take the following steps. 1. Select option 4 from the Application Administration Options panel. The Application Compile Procedures panel (CMNCLPRC) is displayed: CMNCLPRC ------------------ APPLICATION COMPILE PROCEDURE -----------------------COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. Enter * in LANGUAGE or PROCEDURE fields for selection list. LANGUAGE PROCEDURE DESCRIPTION '''' COBOL2__ ________ _____________________________________________
This panel lists all of the pre-defined compiling procedures. Skeletons for these procedures must exist in the custom skeletons library (see the Serena™ ChangeMan® ZMF Skeleton Reference manual for details).
123
Chapter 5: Setting Up Application Administration
2. Create or update the rows of the list. The following table describes the fields of the panel. Column
Description
LANGUAGE
Enter the language name for the compile procedure. If you want to select from a list of available language names, enter *. The Language Name Selection List is displayed.
PROCEDURE
Enter the procedure name. If you want to select from a list of procedure names, enter *. The Procedure Selection List is displayed. You cannot use a numeric or special character in the fourth position of the procedure name.
DESCRIPTION
Enter the procedure description, which can be up to 44 alphanumeric characters.
SETTING UP PLANNED APPROVALS The Planned Approvals definition determines who must approve packages, the order of approvals, and how approvers are notified that their approval is required. See “Package Approvals” on page 40 for a discussion of the difference between Planned and Unplanned Approval lists. To create or update a Planned Approvals list, follow these steps. 1. On the Application Administration Options panel, type 5 on the Option line and press ENTER. The Planned Approvals Part 1 of 2 panel is displayed: CMNCAPLD ---------- DEMO - PLANNED APPROVALS PART 1 OF 2 ----- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE Define an approval list for all planned packages; Use line command S to supply recipient notification. Enter END command to save changes or CANCEL to exit. SECURITY ORDER INT. LNK APPROVER DESCRIPTION ENTITY NO. APR. PKG '''' Enterprise Change Coordinator_______________ CMNECP__ 00 ___ YES '''' Development Manager_________________________ CMNDVMGR 10 YES ___ '''' Quality Assurance Manager___________________ CMNQAMGR 20 ___ ___ '''' Change Control______________________________ CMNQAMGR 30 ___ ___ ******************************* Bottom of data ********************************
124
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following table describes the fields on the Application Planned Approvals Part 1 of 2 panel. Field
Description
Line Command
Type a value line command. S
Select to see the next panel for this approval
I
Insert a blank approval row.
R
Repeat an existing approval
D
Delete an existing approval
APPROVER DESCRIPTION
Type a description of the approval. To avoid excessive maintenance, do not use an approver’s name.
SECURITY ENTITY
Type the security entity name that is used to grant authority to TSO userids to enter this approval. You must define this security entity in our security system. Grant the appropriate authority TSO userids in your security system to grant approver authority to individuals. See “Pre-Implementation Decisions” on page 25 for details.
ORDER NO.
Type an order number if an approval hierarchy is required. Order number 00 may be approved at any time. A group of approvals with the same non-zero order number may be approved in any order. Start with order numbers 10 and increment by 10 so that other approvers can be added later. Link Package approvals automatically reset their order numbers to 00.
INT. APR.
LNK PKG
Indicates whether this approval is added to participating packages in other applications that are defined on the Affected Applications panel of participating packages in this application. This approval is added only if it is different from approvals in the affected application. YES
Add this approval to participating package in applications listed on the Affected Applications panel of participating packages in this application.
Blank or NO
Do not add this approval to participating packages in affected applications.
Indicates whether this approval is added to packages that are linked to other change packages through ChangeMan ECP. YES
Add this approval to linked packages.
Blank or NO
Do not add this approval to linked packages.
125
Chapter 5: Setting Up Application Administration
2. On the Plannced Approvals Part 1 of 2 panel, type S on the line command for an approval and press Enter. The Planned Approvals Part 2 of 2 panel is displayed: CMNCAPL1 ---------- DEMO - PLANNED APPROVALS PART 2 OF 2 ----- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> CSR Press END command to exit. APPROVER: Development Manager ENTITY: CMNDVMGR ORDER NO: 10 Vehicle User(s) to Notify '''' MVSSEND_ USER120,USER84______________________________ '''' SERNET__
[email protected]__________________________ '''' SERNET__
[email protected]__________ ******************************* Bottom of data ********************************
The following table describes the fields on the Planned Approvals Part 2 of 2 panel. Field
Description
Vehicle
Type the vehicle used to notify approvers about packages pending approval. You may use any vehicle activated in Global Administration Parameters. You can also use MVSSEND.
User(s) to Notify
BATCH
BATCH - File tailor skeleton CMN$$NTF and submit the generated JCL with Job Card Information defined in Application Administration Parameters.
SERNET
Send notification data through SERNET to ChangeMan ECP, which formats an e-mail message and send through SMTP.
MVSSEND
Issue an MVS SEND message to TSO user IDs.
Type the appropriate user identifications for the notification vehicle. Separate multiple user identifications with commas.: E-mail Address or Mailing List
Use with the SERNET vehicle. Also use with the BATCH vehicle if REXX program CMNSMTP has been activated in skeleton CMN$$NTF.
TSO Userid
Use for vehicle MVSSEND,
The information on the Planned Approvals Part 2 of 2 panel is used to: •
Notify an approver that there is a package awaiting for their approval.
•
Allow queries for packages awaiting approval based on TSO userids entered in User(s) to Notify.
These rules apply when you are setting up approval notifications:
126
•
Approver notification is not required for an approval.
•
You can create multiple notifications for an approval.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
•
You can create multiple notifications using the same vehicle.
SETTING UP UNPLANNED APPROVALS The Unplanned Approvals definition determines who must approve packages, the order of approvals, and how approvers are notified that their approval is required. See “Package Approvals” on page 40 for a discussion of the difference between Unplanned and Planned Approval lists. To create or update an Unplanned Approvals list, follow these steps. 1. On the Application Administration Options panel, type 6 on the Option line and press ENTER. The Unplanned Approvals Part 1 of 2 panel is displayed: CMNAAPLD --------- DEMO - UNPLANNED APPROVALS PART 1 OF 2 ---- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE This approval list applies to all UNPLANNED packages created during non-business hours. Use line command S to supply recipient notification. Enter END command to save changes or CANCEL to exit. SECURITY ORDER LNK APPROVER DESCRIPTION ENTITY NO. PKG '''' Enterprise Change Coordinator_______________ CMNECP__ 00 YES '''' Operations Supervisor_______________________ CMNOPNS_ 10 ___ ******************************* Bottom of data ********************************
The following table describes the fields on the Application Planned Approvals Part 1 of 2 panel. Field
Description
Line Command
Type a value line command. S
Select to see the next panel for this approval.
I
Insert a blank approval row.
R
Repeat an existing approval.
D
Delete an existing approval.
APPROVER DESCRIPTION
Type a description of the approval. To avoid excessive maintenance, do not use an approver’s name.
SECURITY ENTITY
Type the security entity name that is used to grant authority to TSO userids to enter this approval. You must define this security entity in our security system. Grant the appropriate authority TSO userids in your security system to grant approver authority to individuals. See “Pre-Implementation Decisions” on page 25 for details.
127
Chapter 5: Setting Up Application Administration
Field
Description
ORDER NO.
Type an order number if an approval hierarchy is required. Order number 00 may be approved at any time. A group of approvals with the same non-zero order number may be approved in any order. Start with order numbers 10 and increment by 10 so that other approvers can be added later. Link Package approvals automatically reset their order numbers to 00.
LNK PKG
Indicates whether this approval is added to packages that are linked to other change packages through ChangeMan ECP. YES
Add this approval to linked packages.
Blank or NO
Do not add this approval to linked packages.
2. On the Unplanned Approvals Part 1 of 2 panel, type S on the line command for an approval and press Enter. The Unplanned Approvals Part 2 of 2 panel is displayed: CMNAAPL1 --------- DEMO - UNPLANNED APPROVALS PART 2 OF 2 ---- Row 1 to 1 of 1 COMMAND ===> SCROLL ===> PAGE Press END to save changes or CANCEL to exit. APPROVER: Operations Supervisor ENTITY: CMNOPNS ORDER NO: 10 Vehicle User(s) to Notify '''' MVSSEND_ USER567____________________________________ ******************************* Bottom of data ********************************
The following table describes the fields on the Planned Approvals Part 2 of 2 panel.
128
Field
Description
Vehicle
Type the vehicle used to notify approvers about packages pending approval. You may use any vehicle activated in Global Administration Parameters. You can also use MVSSEND. BATCH
BATCH - File tailor skeleton CMN$$NTF and submit the generated JCL with Job Card Information defined in Application Administration Parameters.
SERNET
Send notification data through SERNET to ChangeMan ECP, which formats an e-mail message and send through SMTP.
MVSSEND
Issue an MVS SEND message to TSO user IDs.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
User(s) to Notify
Type the appropriate user identifications for the notification vehicle. Separate multiple user identifications with commas.: E-mail Address or Mailing List
Use with the SERNET vehicle. Also use with the BATCH vehicle of REXX program CMNSMTP has been activated in skeleton CMN$$NTF.
TSO Userid
Use for vehicle MVSSEND,
The information on the Unplanned Approvals Part 2 of 2 panel is used to: •
Notify an approver that there is a package awaiting for their approval.
•
Allow queries for packages awaiting approval based on TSO userids entered in User(s) to Notify.
These rules apply when you are setting up approval notifications: •
Approver notification is not required for an approval.
•
You can create multiple notifications for an approval.
•
You can create multiple notifications using the same vehicle.
DEFINING APPLICATION SITES A site specifies target information for a promotion process or an install process. A site may be local or remote. Local Site
A target that is on the same LPAR as the development ChangeMan ZMF instance. A target on a different LPAR can be defined as a local site if it shares DASD and catalogs with the ChangeMan ZMF development LPAR and no DB2 binds are required.
Remote Site
A target that is on a different LPAR than the development ChangeMan ZMF instance, or that requires DB2 binds.
Sites are defined in global administration. Application Administrates select sites for an application from those global definitions. ChangeMan ZMF permits you to alter a site definition at the application level, but Sites are selected from those global administration definitions for use in an application. You must define an application site for each production ChangeMan ZMF environment that is a target for installs. Every promotion level definition must include a site.
Defining Sites For A New Application Perform these steps to defines sites for a new application.
129
Chapter 5: Setting Up Application Administration
1. On the Application Administration Options panel, type 8 on the Option line and press ENTER. The Application Site List Part 1 of 2 panel is displayed. The first time you access this panel to define sites for a new application, the panel is empty: CMNCLRST -------------- DEMO - SITE LIST PART 1 OF 2 ------- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. Enter * in line command field for global list. SITE NAME '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ '''' ________ ******************************* Bottom of data ********************************
2. Type * in the line command for the first blank Site Name and press ENTER. The Global Site Selection List panel is displayed: CMNGRSTL ----------------- GLOBAL SITE SELECTION LIST -------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE SITE NAME _ Q510DP _ N510DP _ LOCAL01 ******************************* Bottom of data ********************************
3. On the Global Site Selection List panel, type S in the line command for one or more global sites that you want to define in the new application. Press ENTER, and all selected sites are added to the Application Site Part 1 of 2 panel at the insertion point. 4. Continue selecting sites from the Global Site Selection List panel until all sites needed for the application are listed on the Application Site Part 1 of 2 panel.
130
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
5. There is a second panel of information for each site on the Application Site Part 1 of 2 panel. Type S in the line command for a site and press ENTER. The Application Site Information List Part 2 of 2 panel is displayed: CMNRSTJB ---------- LOCAL01 SITE INFORMATION - PART 2 OF 2 -------------------COMMAND ===> SITE ===> ===> ===> ===>
JOB STATEMENT INFORMATION: //CMNSTART JOB (X170,374),APPL-DEMO,____________________________________ // CLASS=U,MSGCLASS=9_______________________________________ //* JOBCARD FROM DEMO APPL PARMS 3 OF 3 PANEL CMNGLP03__________________ //*_____________________________________________________________________
Press ENTER to process; Enter END command to exit.
6. The jobcard information displayed on the Application Site Information Part 2 of 2 panel is used to build JCL for jobs that run at the selected site. Update this information as required. 7. When you are finished updating the jobcard information Application Site Information Part 2 of 2 panel, press ENTER to return to the Application Site List Part 1 of 2 panel. 8. When you are finished updating site definitions on the Application Site List Part 1 of 2 panel, press PF-3 or type END and press ENTER to store the site definitions in the ChangeMan ZMF Package Master file.
Updating Application Site Information Perform these steps to update application site definitions. 1. On the Application Administration Options panel, type 8 on the Option line and press ENTER. The Application Site List Part 1 of 2 panel is displayed: CMNCLRST -------------- DEMO - SITE LIST PART 1 OF 2 --------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. Enter * in line command field for global list. SITE NAME '''' Q510DP__ '''' N510DP__ '''' LOCAL01_ ******************************* Bottom of data ********************************
2. To delete an application site on the Application Site List Part 1 of 2 panel, type D (Delete) in the line command for the site and press ENTER. 3. To add a library type on the Application Site List Part 1 of 2 panel: a) Type I (Insert) in the line command above where you want to insert the site and press ENTER. An empty site entry is inserted on the panel.
131
Chapter 5: Setting Up Application Administration
b) Type * in the line command for the site definition and press ENTER. The Global Remote Site Selection List panel is displayed: CMNGRSTL ----------------- GLOBAL SITE SELECTION LIST -------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE SITE NAME _ Q510DP _ N510DP _ LOCAL01 ******************************* Bottom of data ********************************
c) On the Global Site Selection List panel, type S in the line command for one or more global sites that you want to add to the application. Press ENTER, and all selected sites are added to the Application Site Part 1 of 2 panel at the insertion point. 4. To update jobcard information for a site, type S in the line command for a site on the Application Site Part 1 of 2 panel and press ENTER. The Application Site Information List Part 2 of 2 panel is displayed: CMNRSTJB ---------- LOCAL01 SITE INFORMATION - PART 2 OF 2 -------------------COMMAND ===> SITE ===> ===> ===> ===>
JOB STATEMENT INFORMATION: //CMNSTAR JOB (X170,374),'GLOBAL LOCAL01 SITE',TIME=1,_________________ // CLASS=A,MSGCLASS=9______________________________________________ //*_____________________________________________________________________ //*_____________________________________________________________________
Press ENTER to process; Enter END command to exit.
The jobcard information displayed on the this panel is used to build JCL for jobs that run at the selected site. 5. When you are finished updating the jobcard information Site Information Part 2 of 2 panel, press ENTER to return to the Application Site List Part 1 of 2 panel. 6. When you are finished updating site definitions on the Application Site List Part 1 of 2 panel, press PF-3 or type END and press ENTER to store the site definitions in the ChangeMan ZMF Package Master file.
CONFIGURING PROMOTION SITES, LEVELS, AND LIBRARIES The Application Administrator configures promotion for an application by defining a hierarchy of sites, promotion levels, library types, and test library names. When developers, project managers, and test coordinators promote or demote a package in the application, they choose a site and a promotion level as the target for their action. For a discussion of the Promotion function, see “Promotion And Demotion” on page 41.
132
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Promotion Definition Order The order that promotion sites, levels, and library types appear on application administration panels determines the order that promotion libraries are concatenated in batch job JCL. The following table lists some library concatenations that depend on the promotion definition order. JCL ddname
Library Type
Used in batch jobs...
SYSLIB
LIKE-C types
Copybook expansion steps running CMNWRITE Copybook libraries in compile and assemble jobs Copybook libraries in BMS MAP gens Copybook libraries in IMS PSB/DBD gens
SYSLIB
LIKE-L types
Load libraries in link edit Load libraries in IMS PSB/DBD gens
INCLIB
Target Type
Load libraries in link edit.
OBJLIB
Object library types defined in skeleton CMN$$VAR
Object libraries in link edit
Configuring Promotion For A New Application Perform these steps to set up promotion for a new application.
133
Chapter 5: Setting Up Application Administration
1. On the Application Administration Option panel, type 7 on the Option line and press ENTER. The Application Promotion Site List panel is displayed. When this panel is first accessed for a new application, it is empty: CMNLRPMS --------------- DEMO - PROMOTION SITE LIST ---------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> HALF Enter END command to save changes or CANCEL to exit. Enter * in line command field for local list. FORCE INTERNAL READER CLASS SITE NAME DEMOTION (Y/N) SITE LOCAL '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ ******************************* Bottom of data ********************************
2. To populate the Application Promotion Site List panel, type * in the line command for the first empty Site Name entry and press ENTER. The Application Site Selection List panel is displayed: CMNRMTSL --------------- DEMO - SITE SELECTION LIST ---------- Row 1 to 2 of 2 COMMAND ===> SCROLL ===> PAGE SITE NAME _ Q510DP _ N510DP _ LOCAL01 ******************************* Bottom of data ********************************
3. On the Application Site Selection List panel, type S in the line command for each site that you want to define as a promotion target for the new application. Press ENTER, and you return to the Application Promotion Site List panel, where the selected sites are displayed.
134
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
4. Complete the other fields on the Application Promotion Site List panel. The following table describes the fields on that panel. Field
Description
Line Command
Type a line command to the left of a panel row. S
Select to see the next panel for this site.
I
Insert a blank site row.
R
Repeat an existing site.
D
Delete an existing site.
*
Display a selection list of available sites.
SITE NAME
Displays the promotion site nickname copied from an application site definition.
FORCE DEMOTION (Y/N)
Defines the rules for promoting a package to more than one site at the same time
INTERNAL READER CLASS
N
Allow a package to be promoted to this site at the same time it is promoted to another site.
Y
Require a package to be demoted in all other sites before it can be promoted to this site. Require a package promoted to this site to be demoted before it may be promoted in another site.
Defines the output class for submitting job JCL to the internal reader. Promote/ demote to a remote site runs jobs at the target site and on the MVS image where ChangeMan ZMF runs. SITE: Output class for jobs submitted to the internal reader at a remote site. This entry is not used for local sites, but it must always be entered. LOCAL: Output class for jobs submitted to the internal reader on the MVS image where ChangeMan ZMF runs.
135
Chapter 5: Setting Up Application Administration
5. When you have finished entering site information on the Application Promotion Site List panel, it might look like this. CMNLRPMS --------------- DEMO - PROMOTION SITE LIST ---------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> HALF Enter END command to save changes or CANCEL to exit. Enter * in line command field for local list. FORCE INTERNAL READER CLASS SITE NAME DEMOTION (Y/N) SITE LOCAL '''' Q510DP__ N A A '''' N510DP__ N A A '''' LOCAL01_ Y A A '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ '''' ________ _ _ _ ******************************* Bottom of data ********************************
6. You must define promotion levels for each promotion site. On the Application Promotion Site List panel, type S in the line command for a Site Name, and press ENTER. The Application/Site Promotion Levels panel is displayed. When this panel is first displayed for a site, it is empty: CMNLRPM2 ------------ DEMO/Q510DP - PROMOTION LEVELS ------- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit.
NICKNAME ENTITY LEVEL PROCEDURE (* for a list) '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ ******************************* Bottom of data ********************************
136
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
7. Complete a promotion level entry for each promotion environment you want for this application in this site. The table that follows describes fields on the Application/Site Promotion Levels panel. Field
Description
Line Command
Type a line command to the left of a panel row. S
Select to see the next panel for this promotion level.
I
Insert a blank promotion level row.
R
Repeat an existing level.
D
Delete an existing level.
NICKNAME
Type a nickname for the promotion level. Use a nickname that expresses the function of the promotion site, such as UNIT10 for Unit Test at Promotion Level 10.
ENTITY
Type a promotion security entity name. This security entity is used with your security system to authorize a TSO userid to promote/demote to this level.
LEVEL
Type a numeric promotion level. Number promotion levels in increments of 5 or 10 so that more levels can be added in between later.
PROCEDURE
Type the name of the skeleton procedure to be used in ISPF file tailoring to build JCL for promotion jobs. CMN$$PRM CMN$$RPM
For promotion levels with libraries on a local site. If no entry is made, ChangeMan ZMF automatically inserts this skeleton name. For promotion levels with libraries on a remote site.
8. When you have completed defining promotion levels on the Application/Site Promotion Levels panel, might look like this. --------------------- DEMO/Q510DP - PROMOTION LEVELS ------- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit.
NICKNAME ENTITY LEVEL PROCEDURE (* for a list) '''' UNIT10__ ALLDEV__ 10 CMN$$PRM '''' UNIT20__ ALLDEV__ 20 CMN$$PRM '''' SYSTST30 PROJMGR_ 30 CMN$$PRM '''' QATEST40 QAMGR___ 40 CMN$$PRM '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ '''' ________ ________ __ ________ ******************************* Bottom of data ********************************
137
Chapter 5: Setting Up Application Administration
9. For each promotion level on the Application/Site Promotion Levels panel you must define target library types and data set names. Type S on the line command of a promotion level, and the Application/Site Promotion Libraries panel is displayed. The first time this panel is displayed for a promotion level it is blank: ------------------- DEMO/N510DP - PROMOTION LIBRARIES ------ Row 1 to 3 of 12 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. PROMOTION NAME: UNIT10
LEVEL: 10
Enter * in line command field for library type selection list.
LIB '''' ___
'''' ___
'''' ___
SYSLIB EXCLUDE TARGET LIBRARIES _ ____________________________________________ ____________________________________________ ____________________________________________ ____________________________________________ _ ____________________________________________ ____________________________________________ ____________________________________________ ____________________________________________ _ ____________________________________________ ____________________________________________ ____________________________________________ ____________________________________________
Shadow Library Library Library Shadow Library Library Library Shadow Library Library Library
1 2 3 1 2 3 1 2 3
10. To add library types on the Application/Site Promotion Libraries panel, type * in the line command for the first blank entry on the panel and press ENTER. The Library Type Selection List panel is displayed:. CMNLTPSL ---------------- LIBRARY TYPE SELECTION LIST ----- Row 1 to 19 of 151 COMMAND ===> SCROLL ===> PAGE
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
138
LIB CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC TST
DESCRIPTION Copybooks Control Statements (PARMLIB) DB2 Bind Control DB2 DBRM Job Execution JCL Link Edit Control Statements Compressed Stage Listings Load Modules BMS MAP Load Modules BMS MAP Copybook (DSECT) BMS MAP Source Object Code JCL Cataloged Procedures DB2 Package Bind Control ISPF Skeletons Source Code Test Library Type
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
d) On the Library Type Selection List panel, type S in the line command for any application library type that you want to add at the insert point on the Application/Site Promotion Libraries panel. You may select multiple library types, but you can not scroll down to select library types from multiple pages of the Library Type Selection List at one time. Promotion library types usually include executable library types that are tested. However, you may also wish to promote other types to allow for checkout from promotion. e) Press ENTER to return to the Application/Site Promotion Libraries panel, where the new library types have been added at the insertion point. 11. On the Application/Site Promotion Libraries panel, type information in the remaining fields for each library type. The following table describes the fields on the Application/Site Promotion Libraries panel. Field
Description
PROMOTION NAME
Promotion nickname selected on the previous panel.
LEVEL
Promotion level defined on the previous panel.
Line Command
Type a line command to the left of a panel row. I
Insert a blank library type row.
R
Repeat an existing library type.
D
Delete an existing library type.
*
Display a selection list of available library types.
LIB
Application library type for this promotion level.
SYSLIB EXCLUDE
Determines if promotion libraries associated with this library type are excluded from file tailoring during stage, recompile, and relink. Use this parameter to omit LikeCopy and Like-Load from SYSLIB concatenations. These libraries are also excluded from Audit. If you change this flag during a package lifecycle, Audit may find SYNCH15! Y
Exclude promotion libraries from file tailoring at stage, recompile, and relink. Exclude the libraries from Audit processing.
N
Include library in normal processing.
TARGET LIBRARIES
Type the fully qualified data set names of target promotion libraries.
Shadow
A shadow library is a library on the local site that is synchronized with promotion libraries at the remote site. If you leave the shadow library blank, the DSN coded for Library 1 is copied into the shadow library name. A shadow library is required if remote promotion skeleton CMN$$RPM is specified for a promotion level. A shadow library will not be updated if skeleton CMN$$PRM is specified for a promotion level.
Library 1 Library 2 Library 3
Up to three promotion libraries may be targeted for each library type.
139
Chapter 5: Setting Up Application Administration
Promotion library types usually include executable library types. However, you may wish to promote other types to allow for checkout from promotion. 12. To save the new application promotion definition: a) On the Application/Site Promotion Libraries panel, press PF-3 or type END on the Command Line and press Enter. b) On the Application/Site Promotion Levels panel, press PF-3 or type END on the Command Line and press Enter. c) On the Application Promotion Site List panel, press PF-3 or type END on the Command Line and press Enter.
Update Promotion For An Application Perform these steps to update the promotion definitions for an application. 1. On the Application Administration Option panel, type 7 on the Option line and press ENTER. The Application Promotion Site List panel is displayed: CMNLRPMS --------------- DEMO - PROMOTION SITE LIST ---------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> HALF Enter END command to save changes or CANCEL to exit. Enter * in line command field for local list. FORCE INTERNAL READER CLASS SITE NAME DEMOTION (Y/N) SITE LOCAL '''' Q510DP__ N A A '''' N510DP__ N A A '''' LOCAL01_ Y A A ******************************* Bottom of data ********************************
See the table that starts on page page 135 that describes the fields on Application Promotion Site List panel. 2. To delete a site from the Application Promotion Site List panel, type D (Delete) in the line command for the site and press ENTER. 3. To add a site to the Application Promotion Site List panel: a) Type I (Insert) in the line command above where you want to insert the site and press ENTER. An empty site row is inserted on the panel.
140
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
b) Type * in the line command for the empty site definition and press ENTER. The Application Site Selection List panel is displayed: CMNRMTSL --------------- DEMO - SITE SELECTION LIST ---------- Row 1 to 2 of 2 COMMAND ===> SCROLL ===> PAGE SITE NAME _ Q510DP _ N510DP _ LOCAL01 ******************************* Bottom of data ********************************
4. On the Application Site Selection List panel, type S in the line command for each site that you want to add. Press Enter, and you return to the Application Promotion Site List panel, where the selected sites are displayed. 5. Complete the other fields on the Application Promotion Site List panel. 6. To update promotion levels for a promotion site., on the Application Promotion Site List panel, type S in the line command for a Site Name, and press ENTER. The Application/ Site Promotion Levels panel is displayed: --------------------- DEMO/Q510DP - PROMOTION LEVELS ------- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit.
NICKNAME ENTITY LEVEL PROCEDURE (* for a list) '''' UNIT10__ ALLDEV__ 10 CMN$$PRM '''' UNIT20__ ALLDEV__ 20 CMN$$PRM '''' SYSTST30 PROJMGR_ 30 CMN$$PRM '''' QATEST40 QAMGR___ 40 CMN$$PRM ******************************* Bottom of data ********************************
See the table that starts on page page 137 for a description of the fields on this panel. 7. Complete the other fields on the Application/Site Promotion Levels panel.
141
Chapter 5: Setting Up Application Administration
8. To update the library types and promotion libraries for a promotion level, on the Application/Site Promotion Levels panel, type S on the line command for a promotion level, and the Application/Site Promotion Libraries panel is displayed: CMNLRPM3 ----------- DEMO/N510DP - PROMOTION LIBRARIES ------- Row 1 to 3 of 4 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. PROMOTION NAME: UNIT10
LEVEL: 10
Enter * in line command field for library type selection list.
LIB '''' JCL
'''' LOD
'''' MAP
SYSLIB EXCLUDE TARGET LIBRARIES N PROD239.SERN510D.NLOCLV10.JCL_______________ PROD239.SERN510D.NLOCLV10.JCL_______________ ____________________________________________ ____________________________________________ Y PROD239.SERN510D.NLOCLV10.LOD_______________ PROD239.SERN510D.NLOCLV10.LOD_______________ ____________________________________________ ____________________________________________ Y PROD239.SERN510D.NLOCLV10.map_______________ PROD239.SERN510D.NLOCLV10.map_______________ ____________________________________________ ____________________________________________
Shadow Library Library Library Shadow Library Library Library Shadow Library Library Library
1 2 3 1 2 3 1 2 3
See the table that starts on page page 139 for a description of the fields on this panel. 9. To delete a library type with its promotion libraries from the Application/Site Promotion Libraries panel, type D (Delete) in the line command for the library type and press ENTER. 10. To add a library type with promotion libraries to the Application/Site Promotion Libraries panel: a) Type I (Insert) in the line command above where you want to insert the library type and press ENTER. An empty library type row is inserted on the panel.
142
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
b) Type * in the line command for the empty library type row and press ENTER. The Application Site Selection List panel is displayed: CMNLTPSL ---------------- LIBRARY TYPE SELECTION LIST ----- Row 1 to 19 of 151 COMMAND ===> SCROLL ===> PAGE
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
LIB CPY CTC DBB DBR JCL LCT LST LOD MAP MPC MPS OBJ PRC PKG SKL SRC TST
DESCRIPTION Copybooks Control Statements (PARMLIB) DB2 Bind Control DB2 DBRM Job Execution JCL Link Edit Control Statements Compressed Stage Listings Load Modules BMS MAP Load Modules BMS MAP Copybook (DSECT) BMS MAP Source Object Code JCL Cataloged Procedures DB2 Package Bind Control ISPF Skeletons Source Code Test Library Type
c) On the Library Type Selection List panel, type S in the line command for any application library type that you want to add at the insert point on the Application/Site Promotion Libraries panel. You may select multiple library types, but you can not scroll down to select library types from multiple pages of the Library Type Selection List at one time. Promotion library types usually include executable library types that are tested. However, you may also wish to promote other types to allow for checkout from promotion. d) Press ENTER to return to the Application/Site Promotion Libraries panel, where the new library types have been added at the insertion point. 11. Complete the rest of the fields on the Application/Site Promotion Libraries panel. 12. To save your updates to the application promotion definition: a) On the Application/Site Promotion Libraries panel, press PF-3 or type END on the Command Line and press Enter. b) On the Application/Site Promotion Levels panel, press PF-3 or type END on the Command Line and press Enter. c) On the Application Promotion Site List panel, press PF-3 or type END on the Command Line and press Enter.
143
Chapter 5: Setting Up Application Administration
CONFIGURING BASELINE LIBRARIES With Option B on the Application Administration Options panel, you can specify the names of an application's Baseline libraries. ChangeMan ZMF uses these names when it creates batch jobs to “ripple” an application's Baseline libraries after a change package has been installed. ChangeMan ZMF assumes these libraries exist and that it can update them. If you have set Application Parameters to “Keep Baseline by Site =Y” on Part 1 of the Application Parameters panel, then Baseline libraries must be configured for each site. See “Configuring Remote Sites” on page 173 for details.
Allocating Baseline Libraries 1. Select option B on the Application Administration Options panel. The Baseline Configuration Part 1 of 2 panel (CMNCBAS1) is displayed: CMNCBAS1 --- DEMO - BASELINE CONFIGURATION PART 1 OF 2 ----- ROW 1 TO 5 OF 5 COMMAND ===> SCROLL ===> PAGE Enter END command to save changes or CANCEL to exit. Enter * in line command field for library type selection list. BASELINE STORAGE MEANS INSTALL P-Standard PDS PV-Panvalet IN PROD L-Librarian LA-Librarian Archie TYPE LEVELS (Y/N/C) SD-Stacked Reverse Delta ‘’’’ CPY 3__ Y SD ‘’’’ JCL 3__ Y SD ‘’’’ LOD 3__ Y P_ ‘’’’ PRC 3__ Y SD ‘’’’ SRC 3__ Y SD ******************************* Bottom of data ********************************
The following table describes the field of the Application Baseline Configuration Part 1 of 2 panel (CMNCBAS1) and the information that you can enter when creating a new libraries. Field
Description
TYPE
Enter the library type. If you want to select from a list of available library types, enter *. The Library Type Selection List is displayed.
LEVELS
Enter the number of previous levels that you want ChangeMan ZMF to maintain Baseline for each library type. Note: If you specify the storage means as LA (CA-Librarian Archie), the level has a maximum of 255. You enter only one data set name, however, when you select this entry for specifying the actual Baseline data set name on the Application Baseline Configuration Part 2 of 2 panel described below.
144
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
INSTALL IN PRD
This option is for installation in production. Enter Y (Yes) if the library type is to be included in Production libraries as change packages are installed. Enter Y to install temporary packages for ALL sites. Enter N (No) if the library type is only maintained in a development environment. If you want to make Baseline and Production the same physical site, mark all of the rows of this column N, and leave the Production Libraries panels blank. Enter C (Conditional) if the library type exists in a remote site. The library type noted is installed in that remote site.
STORAGE MEANS
Enter one of the following storage means: P - PDS L - CA-Librarian LA - CA-Librarian Archie PV - CA-Panvalet SD - Stacked Reverse Delta Note: Delta libraries must be RECFM=FB.
2. To update an existing library, type S to select a row to specify the actual data set names for the item. The Application Baseline Configuration Part 2 of 2 panel (CMNCBAS2) is displayed: CMNCBAS2 --- DEMO - BASELINE CONFIGURATION PART 2 OF 2 ----- ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. LIBRARY TYPE: SRC - 255 LEVELS MAINTAINED STORAGE MEANS: SD LINE COMMANDS: A - Allocate, V - Verify LEVEL DATASET NAME STATUS _ 0 PROD99.CMN416.ASSEMBLE______________________ _ -254 PROD99.CMN416.DELTA.ASSEMBLE________________ ******************************* BOTTOM OF DATA ********************************
The Application Baseline Configuration Part 2 of 2 panel (CMNCBAS2) specifies the names of an application's Baseline libraries. The rows are already generated when you access the panel. From this panel you can verify or allocate the Baseline library data sets. ChangeMan ZMF uses these names when it creates batch jobs to “ripple” an application's Baseline libraries after a change package has been installed. ChangeMan ZMF assumes these libraries exist and that it can update them. If you have set “Keep Baseline by Site = Y” on the Application Parameter Part 1 of 2 panel (CMNGLP01) then Baseline libraries must be configured for each site. “Configuring Remote Sites” on page 173.
145
Chapter 5: Setting Up Application Administration
3. In a desired row of the Application Parameter Part 1 of 2 panel (CMNGLP01), type A or V to allocate or verify a baseline library. Note •
This option is not available for CA-Librarian or CA-Panvalet. If you typed V in the desired row, the Dataset Information panel (CMNDSINF) is displayed: CMNDSINF-------------------- DATASET INFORMATION ----------------------------COMMAND ===> LIBRARY TYPE: SRC DATASET NAME: PROD99.CMN416.ASSEMBLE GENERAL DATA: VOLUME SERIAL: STR84F DEVICE TYPE: 3380 ORGANIZATION: PDS RECORD FORMAT: FB RECORD LENGTH: 80 BLOCK SIZE: 6000 1ST EXTENT CYLINDERS: 39 SECONDARY CYLINDERS: 12 DATASET DATE INFORMATION: CREATION: 1998/01/06 EXPIRATION: LAST REFERENCED: 1999/06/14
•
CURRENT ALLOCATION: ALLOCATED CYLINDERS: ALLOCATED EXTENTS: MAX. DIR. BLOCKS:
99 6 60
CURRENT UTILIZATION: USED CYLINDERS: USED EXTENTS: USED DIR BLOCKS: NUMBER OF MEMBERS:
88 6 32 191
If you typed A, in the desired row, the Allocate Dataset panel (CMNALCDS) is displayed) CMNALCDS ---------------------- ALLOCATE DATASET -----------------------------COMMAND ===> LIBRARY TYPE: SRC DATASET NAME: PROD99.CMN416.ASSEMBLE GENERIC UNIT NAME ===> 3390 VOLUME SERIAL ===> SPACE UNITS ===> TRK PRIMARY QUANTITY ===> 10 SECONDARY QUANTITY ===> 10 DIRECTORY BLOCKS ===> 50 RECORD FORMAT ===> FB RECORD LENGTH ===> 80 BLOCK SIZE ===> 6000 DATA SET TYPE ===> Press ENTER to allocate; Enter END
(Generic group name or unit) (Required if GENERIC UNIT unspecified) (TRK, CYL or BLK) (In above units) (In above units) (Must be greater than zero)
(Library for PDSE, PDS for PDS, or Blank) command to cancel.
If a Baseline library data set does not exist, the message “Data set not catalogued” displays in the upper right-hand corner, and *ERROR is displayed in the STATUS column next to the data set name.
146
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
DEFINING OPTIONAL COMPONENT DESCRIPTIONS, PROCEDURE, AND SECURITY With Option C, you can define optional components for your applications so that you can do the following: •
Provide general information about the optional component that allows the user to enter or update descriptions for the application's components from either a Baseline driven list or the Package Master driven list of components.
•
Specify component designated compiling procedures that allows the user to specify the required compile procedure to be used before a package can be frozen.
•
Set security information for the component that allows the user to limit access to the application's components by entering those TSO ID’s or entities that are authorized to stage each component.
These records are keyed (made unique) by component name and library type. They are NOT keyed by application. Therefore, Application Administrators can overlay each other's records. Any entries made here apply across all applications. Select whether to define General, Procedures, or Security information on the Component Information Options panel. 1. On the Application Administration Options panel, select option C. The Application Component Information Options menu (CMNCMP00) is displayed: CMNCMP00 ---------- DEMO - COMPONENT INFORMATION OPTIONS ---------------------OPTION ===> G General - Update component general information P Procedures - Specify component designated compile procedures S Security - Maintain component level security information Press ENTER to process; Enter END command to exit.
NOTE: Component Information Options affect ALL applications.
DEFINING COMPONENT GENERAL INFORMATION You can define and update component descriptions. To select the components that you want to define or update, follow these steps:
147
Chapter 5: Setting Up Application Administration
1. Select option G on the Application Component General Information panel (CMNCMP00). The Application Component General Information panel (CMNCMPG1) is displayed: CMNCMPG1 ---------- DEMO - COMPONENT GENERAL INFORMATION ---------------------OPTION ===> LIBRARY TYPE ===>
(Blank for list)
1 Baseline - Select from baseline libraries 2 Package - Process existing component information records Press ENTER to process; Enter END command to exit.
2. At the command line, type 1 (to access the Baseline Driven Component List) or 2 (to access the Package Master Component List), and in a library type in the LIBRARY TYPE field, type a library type. If you leave the LIBRARY TYPE field blank, the Library Type Selection List panel (CMNLTPSL) displays, and you must select a library type before the Baseline or package driven lists display. 3. Press ENTER. •
If you chose option 1, the Baseline Driven Component List panel is displayed: CMNCMPG2 ST - SER.CMNQ.BASE0.PDS -------------------------- ROW 1 TO 20 OF 38 COMMAND ===> SCROLL ===> CSR NAME STATUS _ AAAAAAA7 _ AAAAAA6 _ AAAAA5 _ AAAA4 _ AAA3 _ AA2
•
VV.MM CREATED LAST MODIFIED SIZE INIT MOD 02.01 92/02/22 93/05/27 15:15 1 10 10 02.01 92/02/22 93/05/27 15:16 2 10 8 02.01 92/02/22 93/05/27 15:16 3 10 7 02.01 92/02/22 93/05/27 15:16 4 10 6 02.01 92/02/22 93/05/27 15:17 5 10 6 02.01 92/02/22 93/05/27 15:17 6 10 5
ID SER05 SER05 SER05 SER05 SER05 SER05
If you chose option 2, the Package Master Driven Component List panel (CMNCMP01) is displayed: CMNCMP01 ----------------------- COMPONENT LIST ----------- ROW 1 TO 17 OF 17 COMMAND ===> SCROLL ===> CSR
_ _ _ _ _ _ _
NAME CMNADMSO CMNAPI2 CMNATACH CMNAUD10 CMNBATCH CMNBSAM
TYPE SRC SRC SRC SRC SRC SRC
******************************* BOTTOM OF DATA ********************************
148
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Deleting Components 1. From either the Baseline or Package Master Driven Component Lists, place the cursor in the first column of the library row that you want to change. 2. Type a D in the first column of the desired row in the list to delete a component description. The component row is deleted. 3. Press [END]. If you are working on the Baseline Driven Component List and you have set “Keep Baseline by Site = N” on Part 1 of the Application Parameters panel, ChangeMan ZMF returns you to the Component General Information panel. If you are working on the Baseline Driven Component List and you have set “Keep Baseline by Site = Y” on Part 1 of the Application Parameters panel, the Remote Site Selection List displays so that you can choose another site for component updates. Repeat this procedure for each site you wish to update. If you are working on the Package Master Driven Component List, ChangeMan ZMF returns you to the Component General Information panel.
Updating the components in either component list. 1. From either the Baseline or Package Master Driven Component Lists, place the cursor in the first column of the library row that you want to change and type S. 2. Press [ENTER]. The Component General Description panel (CMNCMPG3) is displayed: CMNCMPG3 ------ C410 - CMNAUD10.SRC GENERAL DESCRIPTION --- ROW 1 TO 13 OF 13 COMMAND ===> SCROLL ===> CSR
Enter END command to save; CANCEL to exit. (maximum 48 lines) '''' This program gathers all the data for the Audit Process_________________ '''' ________________________________________________________________________ '''' ________________________________________________________________________ '''' ________________________________________________________________________ ******************************* BOTTOM OF DATA ********************************
3. Type in a general description of the component. 4. Press END. This saves your changes and returns you to the Baseline or Package Master Driven Component Lists. The STATUS column next to the selected component name in the list now displays CHANGED. Repeat these steps for each approval row that you want to change.
149
Chapter 5: Setting Up Application Administration
DESIGNATE OPTIONAL COMPONENT COMPILING PROCEDURES 1. Select option P on the Component Information Option panel. The Designate Compiling Procedures panel is displayed. If you choose to designate compiling procedures for the application's components, then any user that wants to freeze a change package with the selected component must stage with the procedures entered on the panel (force level 2). If you designate a compiling procedure with force level 1, ChangeMan ZMF allows staging with alternate procedures during package development. However, the final stage (before attempting to freeze) should be performed with the designated compile procedure for each component. CMNCMPP1 ---------- DEMO - DESIGNATED COMPILE PROCEDURES ---------------------OPTION ===> C - Change or Add component procedures D - Delete component procedures blank - List defined procedures COMPONENT NAME LIBRARY TYPE COMPILE PROCEDURE LANGUAGE NAME COMPILE PARMS LINK EDIT PARMS DB2 PRE-COMPILE OTHER OPTIONS FORCE LEVEL
===> ===> ===> ===> ===> ===> ===> ===> ===>
(Full name (Blank for (Blank for (Blank for
or pattern; blank for list) list) list) list)
(Y/N) (Y/N for additional user options) (1-Before Freeze only, 2-Always required)
Press ENTER to process; Enter END command to exit.
The following table describes the field of the Designated Compile Procedures panel (CMNCMPP1). Field
Description
COMPONENT NAME
Enter the full component name or pattern masked name. The pattern can be a combination of letters and an “*” to indicate wildcard information. The first character, however, must be a letter. For example, A* is acceptable, but * is not.
LIBRARY TYPE
Enter the library type. If you want to select from a list of library types, enter a blank in this field. The Library Type Selection List is displayed. This must be either SRC (source) or any of the application's library types that have been set up to be handled “like source.”
COMPILE PROCEDURE
Enter the compiling procedure name. If you want to select from a list of compiling procedures, enter a blank in this field. The Compiling Procedure Selection List is displayed. You can set up as many or as few compiling procedures as you need.
LANGUAGE NAME
150
Enter the language name. If you want to select from a list of language names, enter a blank in this field. The Language Name Selection List is displayed.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Field
Description
COMPILE PARMS
Enter the compiling parameters.
LINK EDIT PARMS
Enter the link edit parameters.
DB2 PRECOMPILE
Enter YES if a DB2 pre-compile is required.
OTHER OPTIONS
The User Options facility allows you to modify the logic within a single ChangeMan ZMF skeleton and tailor that skeleton to fit the processing requirements of many kinds of compile and link procedures.
FORCE LEVEL
Specify the force option:
Enter NO if a DB2 pre-compile is not required.
Enter 1 to let users compile the component with alternate procedures (before the last compile prior to freeze). Users can use any procedure, any compile and link parameters and any user options during staging. However, audit and freeze validate each component and ensure that this designated procedure was used for the final stage. Otherwise, the package fails audit and is not available for freeze. Enter 2 to require users to always use the designated procedure.
2. From this panel, if you know the name of the component for which you are designating procedures, you can update the information from this panel, type C at the command line to change a component's procedure and provide the component name in the COMPONENT NAME field as well as type in entries in each of the required fields of the panel. If you don’t know the name of the component, type a pattern or a blank in the COMPONENT NAME field on the Designated Compiling Procedure panel.
151
Chapter 5: Setting Up Application Administration
3. Press [ENTER]. The Component List panel (CMNCMPP2) is displayed:
CMNCMPP2 ----------------- C410 - COMPONENT LIST ----------- ROW 1 TO 4 OF 27 COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. Enter S line command to select additional options. Enter * in PROC or LANGUAGE field, for list.
_
_
_
_
NAME TYPE LANGUAGE LOD FORCE DB2 COMPILE PARMS PROC TYPE OPT PC LINK EDIT PARMS -----------------------------------------------------------------------C* SRC ASM LOD 1 NO __________________________________ CMNASM __________________________________ -----------------------------------------------------------------------CMN$XMEM SRC ASM LOD 2 NO __________________________________ CMNASM AC=1______________________________ -----------------------------------------------------------------------CMN* SRC ASM LOD 1 NO __________________________________ CMNASM __________________________________ -----------------------------------------------------------------------CMNATACH SRC ASM LOD 2 NO __________________________________ CMNASM AC=1______________________________
Complete the fields on the Component Driven List panel. The fields and behavior for this list are the same as the list on the Designated Compiling Procedure panel (even though the abbreviations for the columns differ slightly from the fields of the Designated Compiling Procedure panel). You complete the fields using the same commands and requirements as the Designated Compiling Procedure panel, except you repeatedly specify component compiling procedures for component rows using the Select (to change and update) and Delete commands in the first column of the desired row on the list. 4. Press END. This saves your changes and returns you to the Designated Compiling Procedure panel.
SETTING COMPONENT SECURITY ChangeMan ZMF lets you set component level security for a particular component or group of components. Before you specify this Component User List, you must first indicate which component you want to update.
Specify the component to be updated. 1. Select option S on the Component General Information panel. The Component Level Security panel is displayed. 2. Update and/or delete user component security access from the Component User List with one of the following methods (the results are the same for either method):
152
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
If you know the names of the components for which you are setting security, you can directly access the user list. To do so, follow these steps: •
Type the full component name in the COMPONENT NAME field.
•
Type the component library type in the COMPONENT TYPE field.
3. Press ENTER. The Component User List panel is displayed. Go to task 3 to complete this panel. Repeat this task for every component that you want to update. If you do not know the names of the components or if you want to set security for a set of components of the same type with a common naming convention, you first access a Package Driven Security List.
Access a Package Driven Security List. 1. Type a pattern in the COMPONENT NAME field. The pattern can be a combination of letters and an “*” to indicate wild card information. An example is: S*. If you leave this field blank, ChangeMan ZMF returns you to the Component Information Options panel. 2. Type the component library type in the COMPONENT TYPE field. 3. Press ENTER. The Component Level Security List panel (CMNCMPS1) is displayed:
CMNCMPS1 ------------ DEMO - COMPONENT LEVEL SECURITY ------------------------COMMAND ===> COMPONENT NAME ===> ABC10000 COMPONENT TYPE ===> SRC
(Pattern or blank for list) (Pattern or blank for list)
Press ENTER to process; Enter END command to exit.
Complete the Component Level Security Panel. 1. This panel is used to select package master components that are needed for security level information updates. 2. Type C and press ENTER at the command line to change a component's procedure. The Component User List panel is displayed. 3. Repeat this step for every component that you want to change.
Delete a component’s security entries. 1. Type D and press [ENTER] to delete a component's security entries. All of the component's security entries are deleted (if you access the Component User List for this component it is blank).
153
Chapter 5: Setting Up Application Administration
2. Repeat this step for each component's security that you want to delete.
Delete, enter or update component secured ID’s. Delete, enter, or update component secured user ID’s for either a Baseline library or the Package Master on the Component User List panel (CMNCMPS2). CMNCMPS2 ----------- C410 - CMNATACH.SRC USER LIST ---------- ROW 1 TO 6 OF 6 COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. USERID ENTITY (Y/N; blank=N) '''' USER00__ N '''' USER02__ N '''' USER08__ N '''' USER06__ N '''' USER32__ N '''' USER05__ N ******************************* BOTTOM OF DATA ********************************
Note
When you protect the application's components only the user IDs entered in this panel are allowed to stage and checkout the selected component during change package development.
DELETING AN APPLICATION Use Option D to confirm a user's request to delete an application. All packages must be physically deleted from an application before the application can be deleted. Packages in MEMO DELETE are considered to be logically deleted. You must run housekeeping to physically delete the logically deleted (MEMO DELETED) packages from the application library. Run Report 100, ‘Application Configuration Report,’ to get a list of all baseline and promotion libraries. Manually delete the libraries listed in Report 100, unless they are currently being used by another application. Packages that are in motion can be deleted. Packages that have been installed and aged are deleted when the appropriate housekeeping task is executed.
Delete an application 1. Select option D on the Application Administration Options panel. The Confirm Delete panel (CMNDPROJ) is displayed.
154
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
2. Press [ENTER] to continue with the deletion or enter the END command to cancel the deletion. CMNDPROJ ----------------------- CONFIRM DELETE ------------------------------COMMAND ===> APPLICATION: DEMO DESCRIPTION: HIGHEST PACKAGE: RELEASE ID: Press ENTER key to confirm delete request; Enter END command to cancel delete request.
The following table describes the fields of the Confirm Delete panel (CMNDPROJ). Field
Description
APPLICATION
Displays the application mnemonic.
HIGHEST PACKAGE
Displays the application's highest package number.
RELEASE ID
Displays the release ID.
ACCESSING THE APPLICATION SELECTABLE OPTIONS PANEL Selecting Option O from CMNLAMEN is the same as selecting this option in CMNGAMEN. The only difference is that during application administration, you can access the Application Selectable Options panel (CMNGBSOP) instead of the Global Options panel. For more details, refer to the discussion in “Accessing the Global Selectable Options” on page 94 as well as the individual manuals that apply to those options.
UPDATING THE GLOBAL NOTIFICATION FILE Administrators use the Global Notification facility to pass information to ChangeMan ZMF users. You can use this facility to inform users about: •
Scheduled down time.
•
Scheduled maintenance changes to ChangeMan ZMF.
•
Work-arounds for recently discovered problems.
•
Upcoming ChangeMan ZMF education or discussion sessions.
155
Chapter 5: Setting Up Application Administration
When a user connects to ChangeMan ZMF after an administrator updates the Global Notification File, this ISPF short message is displayed in the upper right corner of the Primary Option Menu: “NOTIFICATION UPDATED”. If the user presses PF1, this long message is displayed: CMN1116I - Option-N file last updated 07/15/2002
13:57 last read 07/14/2002
The short message persists on the Primary Option Menu until the user selects option N (Notify) to display the Global Notification File. BROWSE WSER239.WSER239.D197B7EF.T36A5D91.OUTLIST Line 00000000 Col 001 080 Command ===> Scroll ===> HALF ********************************* Top of Data ********************************** Notification Date: 07/15/2002 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday July 20 when Maintenance Package 58 will be applied. See the ChangeMan page on the Intranet for a description of the changes that will be made. -----------------------------------------------------------------------Notification Date: 06/10/2002 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 16 when Main ten ace Package 57 will be applied. See the ChangeMan page on the Intranet for a description of the changes that will be made. ******************************** Bottom of Data ********************************
The global administrator allocates the Global Notification File and enables the Global Notification Facility. Global administrators update the file with information for users, and they can grant application administrators the same privilege. If the global administrator enabled the Global Notification facility and set the Allow Application Update To File field to Yes in global administration parameters, follow these steps to update the messages in the Global Notification File that is displayed to all ChangeMan ZMF users.
156
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. From the Application Administration Options panel (CMNLAMEN), select option N. An ISPF edit session is opened for a ChangeMan ZMF temporary file that contains the current contents of the Global Notification File. Note
Although you can update the Global Notification File through the Application Administration Options panel, which may also display an application mnemonic, the updates you enter are displayed to all users of ChangeMan ZMF, not just to users with access to your application...
ISREDDE2 WSER239.WSER239.D197B7EF.T3BEC7B8.OUTLIST Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 000002 Notification Date: 06/10/2002 000003 000004 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 000005 16 when Maintenance Package 57 will be applied. See the ChangeMan page on 000006 the Intranet for a description of the changes that will be made. 000007 ****** **************************** Bottom of Data ****************************
2. Using ISPF functions, insert lines to type new a new message that you want displayed to all ChangeMan ZMF users. Add new messages at the top of the file. ISREDDE2 WSER239.WSER239.D197B7EF.T3C3AE58.OUTLIST Data set copied Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 000002 Notification Date: 07/15/2002 000003 000004 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday July 000005 20 when Maintenance Package 58 will be applied. See the ChangeMan page on 000006 the Intranet for a description of the changes that will be made. 000007 000008 -----------------------------------------------------------------------000009 000010 Notification Date: 06/10/2002 000011 000012 ChangeMan ZMF will be unavailable between 0600 and 0700 on Sunday June 000013 16 when Maintenance Package 57 will be applied. See the ChangeMan page on 000014 the Intranet for a description of the changes that will be made. 000015 ****** **************************** Bottom of Data ****************************
3. Press PF3 to exit the edit session. ChangeMan ZMF copies the temporary file back to the Global Notification File. Type Cancel to exit the edit session without saving your entries.
157
Chapter 5: Setting Up Application Administration
CONFIGURING PRODUCTION LIBRARIES With Option P from the Application Administration Options panel, ChangeMan ZMF lets you configure Production libraries by specifying the names of an application's Production libraries by the application’s type and site. When change packages are installed or backed out, ChangeMan ZMF uses these names to create batch jobs that update Production libraries. ChangeMan ZMF assumes these libraries already exist and that it can update them. If you want to make baseline and production the same physical site, leave these lists blank and mark the entries under INSTALL IN PROD as N. 1. Select option P on the Application Administration Options panel. The Production Libraries panel (CMNCPRDL) is displayed: CMNCPRDL ---------- DEMO - PRODUCTION LIBRARIES -----------------------------COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit. Enter * in line command field for library type selection list. TYPE PRODUCTION DATASET NAME TEMPORARY DATASET NAME BACKUP DATASET NAME '''' ___ ____________________________________________ ____________________________________________ ____________________________________________
2. Specify the names of the applications’ Production libraries. The following table describes the Production Libraries panel (CMNCPRDL). Field
Description
TYPE
Enter the library type. If you want to select from a list of available library types or if you want to select more than one library type, enter *. The Library Type Selection List is displayed.
DATA SET NAME
In each row enter the data set names (Production, Temporary, and Backup libraries, in that order) that ChangeMan ZMF is to associate with the library type (CPY, JCL, PRC, and so forth) for the application's Production libraries at the remote site. If you selected Y in the Install in Prod field on the Baseline Configuration Part 1 of 2 (CMNCBAS1) panel to install temporary packages for ALL sites, enter NULLFILE in both the Production Dataset Name and Backup Dataset Name fields. You can enter data set names that do not currently exist. However, during the building of actual application level change packages, the data sets must have been allocated on accessible packs or the build function aborts.
3. Enter the END command.
158
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
CONFIGURING TEMPORARY PACKAGES FOR ALL SITES Define temporary packages for ALL site configurations. 1. On the Primary Option menu (CMN@PRIM), select option A. The Administrative Options panel (CMNADMOM) is displayed. 2. On the Administrative Options panel, select option A. The Application Administration Options panel (CMNLAMEN) is displayed. 3. On the Application Administration Options panel, enter the name of the application that you want to update in the Application field, and select option B, and press ENTER. The Configure Baseline Libraries (CMNCBAS1) panel is displayed. 4. On the Configure Baseline Libraries panel, enter Y or C in the Install in Prod field for each library type that you want in this application. 5. Press PF3 (END) to save your changes and return to the Application Administration Options panel. 6. On the Application Administration Options panel, select P to define your Production libraries for this application. The Production Libraries panel (CMNCPRDL) is displayed. 7. On the Production Libraries panel, enter NULLFILE in both the Production Dataset Name and Backup Dataset Name fields. 8. Enter the Temporary Dataset Name for each temporary Production library that you want to use. 9. Press ENTER.
159
Chapter 5: Setting Up Application Administration
160
CUSTOM MODIFICATIONS
6
INITIAL SKELETON MODIFICATIONS Serena recommends against including ChangeMan ZMF load libraries in the LINKLIST. Therefore, some ISPF skeletons must be modified to add a JOBCARD statement to batch jobs submitted by ChangeMan ZMF. Other skeletons must be modified to provide dataset names for system libraries that comply with local data center standards. Initial skeleton customization is detailed in the Serena™ ChangeMan® ZMF Customization Guide.
CUSTOMIZING CHANGEMAN ZMF ChangeMan ZMF provides a rules-based environment for software configuration management. Its architecture and design provide processes based on best practices for managing application components through the development lifecycle to guarantee the integrity of production systems and data. The basic definitions of ChangeMan ZMF processing rules established by settings in Global and Application Administration. Serena recognize that SCM best practices can be expressed differently in different companies. ChangeMan ZMF architecture is intended to provide customers with the opportunity to modify details of the development lifecycle process. User exits provide you with access to core processes to expand the options. While user interfaces have expanded beyond the mainframe, many key functions are based on batch processing that can be modified to fit your requirements.
User Exits In ChangeMan ZMF ChangeMan ZMF exits are programs that are called by base product programs. Exits permit you to alter the processing of base product programs depending on the information passed to the exit. Using exits, you can: •
Change defaults and settings for interaction with the operating system.
•
Alter what ChangeMan ZMF will do under specific component, package, or life cycle conditions.
•
Change who has authority to initiate specific ChangeMan ZMF tasks.
•
Change when authorized users can initiate certain tasks.
161
Chapter 6: Custom Modifications
Common reasons for using exits include: •
Adapt ChangeMan ZMF to your data center standards and environment.
•
Enforce your company’s standards, processes, and procedures for software change management.
•
Implement custom processes to manage unique component build processes.
•
Add rule-based flexibility to standard ChangeMan ZMF processing.
The use of exits to provide custom ChangeMan ZMF functions is described in the Serena™ ChangeMan® ZMF Customization Guide.
ISPF Skeletons In ChangeMan ZMF ChangeMan ZMF uses standard ISPF services to build batch job JCL from ISPF skeletons. This approach provides extraordinary flexibility through the use of standard IBM facilities. You can build your own batch processes inside ChangeMan ZMF for component “builds” and other processes. ChangeMan ZMF maintains the integrity of your software change management environment by securing development and production libraries and allowing only authorized access to its functions. Modification of ISPF skeletons to provide custom ChangeMan ZMF functions is described in the Serena™ ChangeMan® ZMF Customization Guide.
ChangeMan ZMF Utilities Utility programs included in ChangeMan ZMF batch processes run under the control of program parameters and SYSIN keyword parameters. You can change utility parameters in delivered ChangeMan ZMF skeletons to adjust component processing to fit your standards and requirements. These utilities can also be included in custom skeletons to provide unique functions you design. ChangeMan ZMF utilities are described in the Serena™ ChangeMan® ZMF Customization Guide.
162
MONITORING SITE AND APPLICATION PACKAGES
7
ChangeMan ZMF lets you monitor your site and applications for change package discrepancies as well as monitor and override user provided installation information. To access any of this functionality the security administrator must have given you access to the monitor functional area. ChangeMan ZMF allows you to monitor your applications for change packages, which show discrepancies or abnormalities including the following: •
Distribution without distribution acknowledgment
•
Installation date has passed
•
Package in APR status in ALL environment
•
Package in INS status in ALL environment
•
Package status not being changed in TCC after duration
•
All Complex/Super packages with OPN status
By querying the applications (or the site) for this information and marking them as being in limbo, you provide filtering criteria for the packages that you want to query. Although the monitor function is similar to the query function, the functionality has been extended to let authorized users: •
Change install dates
•
Change a package's status
•
Edit and submit jobs to production
Change packages which have these discrepancies are considered to be in limbo. You can query the applications for these packages, and act upon the package (such as delete it or postpone its installation). If your site uses ChangeMan ZMF for scheduling, you can monitor a list of packages scheduled for installation, and selectively change, hold, or release installation of the package. The Monitor Option panel (CMNMONIT) allows you to perform the above tasks.
163
Chapter 7: Monitoring Site and Application Packages
ACCESSING THE MONITOR OPTION PANEL The Monitor Option panel (CMNMONIT) lets you select and monitor packages in limbo or the internal scheduler. To access this panel, select option M on the Primary Option Menu. CMNMONIT ---------------------- MONITOR OPTIONS ------------------------------OPTION ===> 1 Limbo - Monitor packages in limbo 2 Scheduler - Monitor the CMN internal scheduler Press ENTER to process; Enter END command to exit.
Querying Package Information The Monitor Packages in Limbo panel (CMNQRYL1) lets you provide Change Package information to query. 1. From the Monitor Option panel, type 1. The Monitor Packages in Limbo panel (CMNQRYL1) is displayed:. CMNQRYL1 ----------------- MONITOR PACKAGES IN LIMBO -------------------------COMMAND ===> SPECIFY SELECTION CRITERIA: PACKAGE ID ===> FROM INSTALL DATE ===> TO INSTALL DATE ===> FROM CREATION DATE ===> TO CREATION DATE ===>
(Full name or pattern; blank for list) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD)
Press ENTER to process; Enter END command to exit.
2. In the PACKAGE ID field, type the name of the package you are going to monitor, or select a package based on the following filter criteria: To select from a list of:
Do this:
Applications
Leave the PACKAGE ID field blank Select an application (enter S) Select one or several packages (enter S)
164
All packages at your site
Enter an * in the PACKAGE ID field
All packages of a certain pattern
Use * pattern masking in the PACKAGE ID field
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
To select from a list of:
Do this:
All packages to be installed in a given date range
In year, month, day format (YYYYMMDD), specify the FROM INSTALL DATE and the TO INSTALL DATE, to list all packages that are scheduled to be installed in that date range Leave the field blank to access all dates Select one or several packages (enter s)
All packages created in a given date range
In year, month, day format (YYYYMMDD), specify the FROM CREATION DATE and the TO INSTALL DATE, to list all packages that were created during that date range Leave the field blank to access all dates Select one or several packages (enter s)
3. Press ENTER. ChangeMan ZMF queries the packages you designated for discrepancies and the Limbo Package List panel (CMNRYL2) is displayed:. CMNQRYL2 --------------------- LIMBO PACKAGE LIST ----------------------------COMMAND ===> SCROLL ===> CSR Enter END command to process or CANCEL to exit. PACKAGE ID STATUS INSTALL CREATION LEVEL LIMBO DESCRIPTION __ DEV ______
TYPE
REQUEST
PACKAGES IN LIMBO The Limbo Package List panel (CMNRYL2) allows you to do any of the following functions: •
Delete, mark for a memo delete, change the installation date, edit and submit the job, or change the status of the package
•
Manually submit a package for installation
Acting on Packages The TYPE column of the Limbo Package List panel (CMNRYL2) displays the reason for flagging a package as limbo. 1. To act on a package in limbo, place the cursor in a desired row and do any of the following: •
Type DE and press ENTER to physically delete the package. The package is marked for deletion, which occurs as soon as you leave this panel.
•
Type MD and press ENTER to memo delete the package. ChangeMan ZMF marks the package for a memo delete.
165
Chapter 7: Monitoring Site and Application Packages
Validate that participating packages are not associated with any super or complex package, and that super or complex packages have no participating packages associated. •
Type CD and press [ENTER] to change the installation date of the package. Type the new change package installation date in the INSTALL field.
•
Type CS and press ENTER to change the package status. Type the new status in the STATUS field.
•
Type S and press ENTER to manually submit a job to install the package. The Submit Job From panel is displayed. It is described in the following section.
2. Press END. This processes the commands. You can type CANCEL at the command line to exit without processing. When changing the status to DEL, validate that participating packages are not associated with any super or complex package, and that super or complex packages have no participating packages associated.
Closing a Super or Complex Package Once created, super and/or complex packages are automatically marked for limbo, you can close a super or complex package by updating its package status from OPN to CLO. For example 1. Specify the line command CS on the desired package row. 2. Enter the desired status (CLO in this example). 3. Press ENTER.
Manually Submitting a Package in Limbo for Installation 1. From the Limbo Package List panel mark a desired package for installation by typing an S in the first column of the row. 2. Press ENTER. A panel similar to the following CMNQRYL4 panel is displayed: CMNQRYL4 B FROM PROD99.CMN416.PANELS ---------------------------------------COMMAND ===> SCROLL ===> CSR NAME STATUS VV.MM CREATED CHANGED SIZE INIT MOD ID _ CMNQRYL4
3. Type S to select the job to submit or type D to deselect the job to submit, and press ENTER. •
*SELECT, displays in the STATUS column if you typed S
•
*DESELECT, displays in the STATUS column if you typed D.
4. Press END. ChangeMan ZMF processes the jobs you selected.
166
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
INSTALLATION JOBS The ChangeMan ZMF install process is accomplished by a sequence of batch jobs. The first job in the sequence is initiated by the Scheduler defined in the package Installation Instructions. The rest of the jobs in the sequence are automatically submitted to the internal reader by the preceding job or by ChangeMan ZMF when successful completion of a preceding job is recorded in the Package Master. When you attempt to restart an install process for a package in Limbo, you must choose which job to restart and you must know whether to submit that job in the development environment or on a ChangeMan ZMF production environment that runs at a remote site. The following table describes ChangeMan ZMF installation jobs, and it indicates where each job runs. If do not have remote production environments, your packages use a subset of these jobs to install your packages. DEVELOPMENT CENTER
REMOTE SITE
Job
Action
Job
Action
10
Package is audited and/or frozen.
10
Staging libraries are received including QSAM package master.
Jobs are created in “...X.&node”. Package is approved. Job 10 is submitted to initiate the distribution. CMNBATCH transaction '10' says distribution initiated and status is changed to DIS. Vehicle is asked to submit job 11 at remote site. 11
Staging libraries are sent to remote site.
Job 11 is submitted. 11
CMNBATCH transaction '11' overlays package records (on PM) with QSAM package master; proper node record is time stamped; status is DIS. Job 14 is submitted. (Only if IEBCOPY is not used.)
14
Job 14 requests vehicle to submit 15 at DEV site.
17
Job 17 is submitted if external (not internal) scheduler is used.
18
Job 18 requests vehicle to submit 19 at DEV site.
167
Chapter 7: Monitoring Site and Application Packages
168
DEVELOPMENT CENTER
REMOTE SITE
Job
Action
Job
Action
15
Job 15 is submitted. (Only if IEBCOPY is used.)
15
CMNBATCH transaction '15' stamps acknowledgment of distribution.
19
Notification to package creator that distribution failed. 21
Perform DB2 bind for production installation. (INSTALL IN PROD = YES).
20
Job 20 is submitted to check if package was previously installed, if not, then it begins installation.
20
CMNBATCH transaction '20' changes package status to 'INS'.
20
Job 24 is submitted. (Only if IEBCOPY is not used.)
20t
If Temporary, Job 20t runs to install members into Temporary libraries.
24
Requests vehicle to submit 25 at DEV site.
28
Requests vehicle to submit 29 at DEV site.
30
Job 30 is submitted if system environment is 'ALL'.
31
If Temporary, Job 31 runs to delete members from temporary libraries.
31t
CMNBATCH transaction '31' changes package status to 'TCC' (Temporary Change Cycled) and date/time stamp. Submit job 35.
25
CMNBATCH transaction '25' changes package status to 'INS.'
29
Notification to package creator that installation failed.
25
If Permanent, Job 30 is submitted.
30
CMNBATCH transaction '30' changes package status to 'BAS' and ripples the baseline.
30
Delete members from promotion libraries based on promotion level and library type.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
DEVELOPMENT CENTER
REMOTE SITE
Job
Job
Action
32
Performs DB2 bind for production installation (INSTALL IN PROD = NO).
34t
Requests vehicle to submit 35t at DEV site.
38t
Requests vehicle to submit 39t at DEV site.
35t
39t
Action
Package status updated to TCC and date/ time stamped when all remote sites have been cycled.
Notification to package creator that the package cycle failed.
CASE: A permanent change must be backed out. Operator makes human decision to back out (full) particular package. Enters backout reasons on panel and ChangeMan ZMF instance copies package to same flat file that was sent from development center. Job 50 is submitted. 49
Job 21 runs the DB2 bind for production backout (INSTALL IN PROD = YES).
50
Backs out the change by copying back from BKUP Libraries. Changes package status to 'BAK'. Job 54 is submitted if IEBCOPY is used, else job 51.
54
50
If system environment is 'ALL', job 55 is submitted.
51
Job 51 transmits a QSAM package master to the development center and requests a vehicle to submit job 54.
56
Job 32 runs the DB2 bind for production backout (INSTALL IN PROD = NO).
58
Job 58 requests vehicle to submit 59 at DEV site.
Reads flat package and transmits reasons. Updates backout reasons into correct package.
55
Job 55 is submitted to reverse ripple the baseline if all remote sites are backed out.
55
Status is changed to 'BAK', * node record is date and time stamped.
169
Chapter 7: Monitoring Site and Application Packages
DEVELOPMENT CENTER
REMOTE SITE
Job
Action
Job
Action
59
Notification to package creator that package backout failed. 64
Job 64 requests vehicle to submit 65 at DEV site.
Package is audited and/or frozen. Jobs are created in “...X.&node”. Package is approved. Job 10 is submitted to initiate the distribution.
MONITORING THE CHANGEMAN ZMF INTERNAL SCHEDULER Once a package has been marked for internal scheduling and distributed, it is under the control of the Internal Scheduler. This tool lets the administrator display a list of scheduled jobs (by entering selection criteria, or blanks for the entire list), and to selectively change, hold, or release jobs. Use this panel to enter criteria for displaying the jobs currently under the control of the Internal Scheduler. 1. From the Monitor Option panel, select option 2. The Monitor Internal Scheduler Part 1 of 2 (CMNMISCH) is displayed: CMNMISCH ---------- MONITOR INTERNAL SCHEDULER - PART 1 OF 2 -----------------COMMAND ===> SPECIFY SELECTION CRITERIA: PACKAGE ID ===> C416 FROM INSTALL DATE ===> 940524 TO INSTALL DATE ===>
(Full name or pattern; blank for list) (YYYYMMDD) (YYYYMMDD)
Press ENTER to process; Enter END command to exit.
170
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
2. To monitor the Internal Scheduler for a package, in the PACKAGE ID field, type in the name of the package you want to monitor, or select a package based on the following filter criteria: To select from a list of...
Do the following...
Applications
Leave the PACKAGE ID field blank Select an application (enter s) Select one or several packages (enter s)
All packages at your site
Enter an * in the PACKAGE ID field
All packages of a certain character string
Use * pattern masking in the PACKAGE ID field
All packages to be installed in a given date range
In year, month, day format (YYYYMMDD), specify the FROM INSTALL DATE and the TO INSTALL DATE, to list all packages that are scheduled to be installed in that date range Leave the field blank to access all dates Select one or several packages (enter s)
3. Press ENTER. ChangeMan ZMF processes your specifications and displays all the internally scheduled jobs which fit the criteria. The Monitor Internal Scheduler Part 2 of 2 (CMNMISC2) panel is displayed: CMNMISC2 ----------- MONITOR INTERNAL SCHEDULER PART 2 OF 2 ------------------COMMAND ===> SCROLL ===> CSR Enter END command to process or CANCEL to exit. PACKAGE ID _
DATE ______
TIME ____
PACKAGE TYPE
REQUEST STATUS
Reviewing the Internally Scheduled Packages List When the Monitor Internal Scheduler Part 2 of 2 (CMNISC2) panel is displayed, you see the jobs that have been internally scheduled. You can also use the following commands: •
Type L (package ID) and press ENTER. The list is positioned to that package's job. You can use this command just like the standard ISPF Locate command.
•
Type L CGM and press ENTER. ChangeMan ZMF positions the job list to the first occurrence of any CGM change package jobs.
Acting on the Packages 1. To act on one of the packages, place the cursor in the appropriate row and perform one of the following actions:
171
Chapter 7: Monitoring Site and Application Packages
•
Type C and press ENTER to change the job's installation date or time. Type in the new date or time in the appropriate column. The STATUS field is flagged with the *CHANGE message.
•
Type D and press ENTER to delete an individual package from the scheduler. The STATUS field is flagged with the *DELETE message.
•
Type H and press ENTER to place a hold on the job. The installation for the package cannot be executed until the hold is removed (using the R command below). The STATUS field is flagged with the *HOLD message.
•
Type R and press ENTER to release a job that has been held. The job is performed at the regularly scheduled date and time, or immediately if these have expired. The STATUS field is flagged with the *RELEASE message.
•
Type S and press ENTER to submit the deinstall job for temporary packages before the temporary duration has expired. The STATUS field is flagged with the *SUBMIT message.
2. Press END. If you have entered line commands to change, delete, hold, release, or submit jobs, this action saves the changes and returns you to part 1 of the Monitor Internal Scheduler Part 1 of 2 panel (CMNMISCH).
172
CONFIGURING REMOTE SITES
8
This chapter contains information about configuring remote sites for ChangeMan ZMF, on a global as well as an application level, and outlines how to enable the Network Data Mover.
OVERVIEW OF REMOTE SITES Remote sites are additional STCs where ChangeMan ZMF installs components. The additional STC can be on: •
A separate computer in another building
•
A separate computer in the same building
•
A logical CPU on the same machine as part of an LPAR (logical partition) without shared DASD
Any of these remote site configurations enables you to develop components on one CPU and distribute and install production level components onto a different CPU. All ChangeMan ZMF functions are performed from the defined development site. The remote site acts only as a receiver of production components. In fact, the only time developers interact with remote sites is when they select which remote site to distribute and install production components to.
HOW DOES IT WORK? When you request remote promotion, ChangeMan ZMF constructs execution JCL based on the administration fields that you specified. (Note that you can have execution JCL libraries similar to the installation JCL libraries.) Next, it invokes your transmission vehicle (IEBCOPY or NDM) to transmit the execution JCL library and copies of any needed Staging data sets to the remote system (site). Then, it uses the remote site’s internal reader to invoke jobs (in the execution JCL library) to copy members from the Staging to the remote promotion libraries. After these jobs complete, ChangeMan ZMF ‘cleans up’ the execution JCL and Staging libraries at the remote site. When it returns successfully, ChangeMan ZMF copies the Staging library members to the shadow library on the originating site (a shadow library as a duplicate or copy of what exists on the remote site). Next, it ‘cleans up’ the execution JCL that resides on that site. Finally, it notifies the user of the success or failure of the promotion request and updates the package master.
173
Chapter 8: Configuring Remote Sites
At installation time, ChangeMan ZMF only needs to transmit execution JCL to the remote site. This is because the execution JCLs sole function is to delete members. (This is similar to demotion). So, ChangeMan ZMF cleans up your promotion libraries at the remote site, as well as the shadow libraries that reside on the originating site. This means that if your remote site is only a test site, but you want it to simulate your production site, you must install ChangeMan ZMF on the test site. By doing this, you ‘synch up’ your production libraries. If you don’t want to install ChangeMan ZMF on the test site and you don’t want to ‘clean up’ the test promotion libraries, you must edit the installation skeletons to remove this functionality. As delivered the only program that is required at the remote site is CMNDELRN. This program must reside in an APF authorized library. The skeletons can be changed to use CMNxxxx or SERxxxx programs also, but that would also require those programs to be in an APF authorized library.
SETTING UP REMOTE SITES GLOBALLY The Global Administrator is responsible for creating, deleting, and updating remote site information for ChangeMan ZMF. This functionality is accessed from the Global Administration Options panel. 1. Set up multiple ChangeMan ZMF subsystems by designating one subsystem for your development site, and one for each remote site. 2. Bring up the Remote Site ChangeMan ZMF instance. 3. Set global parameters. CMNGGP01 -------------- GLOBAL PARAMETERS - PART 1 OF 5 ----------------------COMMAND ===> CHANGE MAN ENVIRONMENT SUBSYSTEM: SINGLE CPU (VSAM NOT SHARED) JOB ENTRY SYSTEM SITE NODE NAME LOGICAL UNIT OR SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL SECURITY SYSTEM CHANGE MAN SECURITY RESOURCE INSTALLATION JOB SCHEDULER SCHEDULER INTERVAL IF CMN TRANSMISSION VEHICLE NORMAL BUSINESS HOURS: FROM AGING - INSTALLED PACKAGES - STAGING DATASETS
===> P ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===>
NO JES2
( A - All, D - Dev, DP - DevProd, P - Prod) (Y/N) (JES2 or JES3)
(Generic disk pack) SAF $CHGMAN CMN 010 IEBCOPY 0800 180 7
(SAF, RACF, ACF2, or TSS) (CMN, Manual or Other) (Minutes) (IEBCOPY or Other) TO ===> 1600 (HHMM format) (0 to 999 days) (0 to 999 days)
Press ENTER to process; Enter END command to exit.
174
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following table describes the fields on the Global Parameters Part 1 of 5 panel (CMNGGP01). Field
Description
CHANGEMAN ENVIRONMENT
Define as a Remote Site.
SITE NODE NAME
Define a unique Site Note Name for this Remote Site.
LOGICAL UNIT OR SUBSYSTEM NAME
This is how systems are defined internally. If your data transmission vehicle is NDM or BDT, enter the logical unit name (the name that NDM or BDT uses to identify this system).
P—Always the configuration at a remote site CPU. The production site receives the installed production level package components from a D or DP site.
If your data transmission vehicle is IEBCOPY, enter the subsystem name (for example: SYSA). INSTALLATION JOB SCHEDULER
Define at development site. If you are using an internal scheduler, define the same one at your development site that you define for your remote site. The only difference between scheduling remote site implementation for a remote site and a single site is that you schedule change package implementation for all of your remote sites. Review the tasks in the section “Setting Up the Installation Calendar” in “Chapter 4. Setting Up Global Administration.” In task 3, when you access the calendar, you have an extra step. The Remote Site Selection List displays, and you select a remote site from the list before updating the calendar. Once you have finished updating the calendar, you return to the Remote Site Selection list so you can select another one for updating. If you do not specify a scheduler, the CMN (default) scheduler is invoked at start up time. When you build a package at the DP site and then install the package, the ChangeMan ZMF scheduler distributes the package to the remote site and sends scheduler information. Therefore, the remote site needs to have the same scheduler either attached or defined.
TRANSMISSION VEHICLE
Define at development site.
4. Customize distribution and installation skeletons. Several skeletons are involved in the distribution and installation of packages to defined remote sites. Customize these skeletons in accordance with the data set names and transmission vehicles you are using at your site.
MAINTAINING REMOTE SITES All Remote Sites require the running of normal maintenance utilities. For information on how to run housekeeping tasks, see “Chapter 9. Housekeeping Tasks.”
175
Chapter 8: Configuring Remote Sites
Note
To prevent unwarranted modification of remote site Production libraries, ChangeMan ZMF omits the display of the Build, Promote, Approve, Freeze, and Delete options from the Primary Menu.
SETTING UP REMOTE SITES FOR APPLICATIONS This section describes an option accessible from the Global Administration Option panel and the Application Administration Option panel that displays a list of remote sites. This list, which is displayed during application level creation of a change package, allows you to create, delete, and update all the remote sites where ChangeMan ZMF is installed. Hence, it includes all the valid sites for change implementation. Note
If this is an ALL site, the remote site capability is limited to remote promotion
ESTABLISHING A REMOTE SITE - GLOBAL ADMINISTRATOR To establish a remote site, do the following: 1. From the Primary Option Menu, select option A on the Primary Option Menu. The Administration Options panel is displayed. 2. From the Administration Options panel, select option G. The Global Administration Options panel is displayed. 3. From Global Administration Options panel, select option 6. The Global Remote Site List panel (CMNGRST1) is displayed: CMNGRST1 ---------------- GLOBAL SITE LIST PART 1 OF 2 ------- Row 1 to 6 of 6 COMMAND ===> SCROLL ===> CSR Enter END command to save changes or CANCEL to exit.
'''' '''' '''' '''' '''' ''''
SITE NAME CMNM____ TEST____ TEST2___ TEST3___ TEST4___ TEST5___
From the The Global Remote Site List panel (CMNGRST1), you can create a new site. 1. With the cursor in the LCMD column of the library row, insert a new line (type I and press ENTER) 2. In the SITE NAME column, using the following rules, type the name of the site: •
Specify up to 8 alphanumeric characters
•
Make the first character of the remote site name alphabetic
3. Press ENTER to save your new site entry.
176
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
4. place the cursor in the LCMD column of the remote site you just added, and type S and press ENTER •
If this is a DP site, the Remote Site Information panel (CMNGRST2) is displayed: CMNGRST2 ----- ----- TEST5 SITE INFORMATION - PART 2 OF 2 --------------------COMMAND ===> CHANGE MAN SUBSYSTEM ID LOGICAL UNIT/SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL CHANGE MAN DELAY FILE PRD STAGING MODEL DSNAME TRANSMISSION VEHICLE TIME DIFFERENCE
===> ===> ===> (Generic disk pack) ===> ===> ===> ????.CMNSTAGE.####### ===> IEBCOPY (IEBCOPY or Other) ===> +0000 (+/-HHMM)
REMOTE SITE JOB STATEMENT INFORMATION: ===> //SERVER JOB (ACCOUNT),SITE JOB CARD MODEL________________________________ ===> //CLASS=?,MSGCLASS=?,NOTIFY=______________________________________________ ===> //*_______________________________________________________________________ ===> //*_______________________________________________________________________ Press ENTER to process; Enter END command to exit.
•
If this is an ALL site, the Test Remote Site Promotion panel (CMNGPRST) is displayed: CMNGPRST --------- TEST5 SITE DEFINITION - PART 2 OF 2 -----------------------COMMAND ===> LOGICAL UNIT/SYSTEM NAME DEFAULT UNIT NAME DEFAULT VOLUME SERIAL TRANSMISSION VEHICLE
===> ===> ===> ===>
(Generic disk pack) (IEBCOPY or Other)
REMOTE SITE JOB STATEMENT INFORMATION: ===> //SERVER JOB (ACCOUNT),SITE JOB CARD MODEL________________________________ ===> //CLASS=?,MSGCLASS=?,NOTIFY=______________________________________________ ===> //*_______________________________________________________________________ ===> //*_______________________________________________________________________ Press ENTER to process; Enter END command to exit.
Provide information for each of the required fields.
177
Chapter 8: Configuring Remote Sites
The following table describes the field on the Remote Site Information panel (CMNGRST2). Field
Description
CHANGEMAN SUBSYSTEM ID
Enter the ChangeMan ZMF subsystem ID or leave this field blank to use the default subsystem ID. (DP only)
LOGICAL UNIT/ SYSTEM NAME
Enter the logical unit or system name.
DEFAULT UNIT NAME
Enter the default unit name to have the X.REMOTESITE production library allocated on. Leave blank if default volume serial is entered.
DEFAULT VOLUME SERIAL
Enter the X.REMOTESITE Staging library for this site to have it allocated on the default VOLSER specified here. Enter the default VOLSER to have the X.REMOTESITEPROD library allocated on. Leave blank if default unit name is entered.
CHANGEMAN DELAY FILE
If this information is being configured for the same site specified on Part 1 of the Global Parameters panel, then specify the same delay file specified there in this field. If not, specify the delay file of the REMOTESITE that is being configured in this field.
PRD STAGING MODEL DSNAME
If this information is being configured for the same site specified on Part 1 of the Global Parameters panel, then specify the DEV staging model dsname specified there in this field. If not, specify the PRD staging model dsname for the REMOTESITE being configured in this field. (DP only)
TRANSMISSION VEHICLE
If this information is being configured for the same site specified on Part 1 of the Global Parameters panel, then specify the transmission vehicle specified there in this field. If not, specify the transmission vehicle for the REMOTESITE being configured in this field.
This is the name defined for the CPU or LPAR for which the remote site is located, and it is associated with the transmission vehicle selected on the CMNGP01 (Global Parameter) panel.
If you specify OTHER and you plan to use the Network Data Mover (NDM), see “Enabling the Network Data Mover” on page 180. TIME DIFFERENCE
Type the difference in system clock time between this site and the development site where change packages are created. Enter a positive time difference in hours and minutes (+hhmm) if this site is to the east of the development site. Enter a negative time difference (-hhmm) if this site is to the west of the development site. The default time difference is +0000. The time difference parameter is used to verify that the package install date and time that you enter when you create a package is a time that has not already passed at a remote site.
REMOTE SITE JOB CARD INFORMATION
Enter the default job card to be used at the site.
5. After entering information on the panel, press ENTER.
178
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
SELECTING A REMOTE SITE - APPLICATION ADMINISTRATOR To establish a remote site, do the following: 1. From the Primary Option Menu, select option A on the Primary Option Menu. The Administration Options panel (CMNADMOM) is displayed. 2. From the Administration Options panel (CMNADMOM), select option A. The Application Administration Options panel (CMNLAMEN) is displayed. 3. From Application Administration Options panel (CMNLAMEN), select option 8. The Application Remote Site List panel (CMNCLRST) is displayed: CMNCLRST -------------- NAVI - SITE LIST PART 1 OF 2 --------- Row 1 to 5 of 5 COMMAND ===> SCROLL ===> Enter END command to save changes or CANCEL to exit. Enter * in line command field for global list. SITE NAME '''' CMNM____ '''' TEST____ '''' TEST2___ '''' TEST3___ '''' TEST4___ ******************************* Bottom of data ********************************
From The Application Remote Site List panel (CMNCLRST), you can create a new site or update an existing site. 1. With the cursor in the LCMD column of the library row, insert a new line (type I and press ENTER) 2. In the SITE NAME column, type the name of the globally defined remote site or type an asterisk in the column to select from the global remote site list. 3. Press ENTER to establish and save your new site.
UPDATING AN EXISTING SITE - APPLICATION ADMINISTRATOR To establish a remote site, do the following: 1. From the Primary Option Menu, select option A on the Primary Option Menu. The Administration Options panel (CMNADMOM) is displayed. 2. From the Administration Options panel (CMNADMOM), select option A. The Application Administration Options panel (CMNLAMEN) is displayed.
179
Chapter 8: Configuring Remote Sites
3. From Application Administration Options panel (CMNLAMEN), select option 8. The Application Remote Site List panel (CMNCLRST) is displayed: CMNCLRST -------------- NAVI - SITE LIST PART 1 OF 2 --------- Row 1 to 5 of 5 COMMAND ===> SCROLL ===> Enter END command to save changes or CANCEL to exit. Enter * in line command field for global list. SITE NAME '''' CMNM____ '''' TEST____ '''' TEST2___ '''' TEST3___ '''' TEST4___ ******************************* Bottom of data ********************************
4. From the Remote Site List Part 1 of 2 panel, place the cursor in the LCMD column of the library row that you want to update, and type S (Select) and press ENTER. The Test Remote Site Information Part 2 of 2 panel (CMNRSTJB) is displayed: CMNRSTJB ---------- TEST5 SITE INFORMATION - PART 2 OF 2 ---------------------COMMAND ===> SITE ===> ===> ===> ===>
JOB STATEMENT INFORMATION: //CMNSTART JOB ,ACCOUNT INFORMATION,____________________________________ // CLASS=?,MSGCLASS=?_______________________________________ //*_____________________________________________________________________ //*_____________________________________________________________________
Press ENTER to process; Enter END command to exit.
5. On the Test Remote Site Information panel (CMNRSTJB), enter the job card information required for any internal jobs that you might submit at the specified remote site. 6. Press ENTER to save your changes, or enter the END command to exit. Repeat the above steps for each remote site that you want to update.
ENABLING THE NETWORK DATA MOVER If your shop possesses at least one remote site and you want to use Network Data Mover (NDM) as the transmission vehicle, refer to member #NDM in the CMNZMF CNTL file, and do the following: 1. Copy member #NDM from the vendor CMNZMF CNTL library into your custom CNTL library. 2. Modify the data set name to conform to your standards for the procedure library.
180
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
3. Create the procedure library by changing all occurrences of $/ to ./ for IEBUPDTE and submit the job. Next, modify CMN$$NDM. 4. Copy skeleton CMN$$NDM from the delivered skeleton library and put it into your custom skeleton library. If the batch module DMBATCH cannot be found in a linklisted library, a Steplib is necessary. 5. Further down in the skeleton is a sign on for SYSIN that reads: SIGNONUSERID=(&RSOWNER)NETMAP=&NDMMAP,ESF=YES
By design, &RSOWNER will not resolve. To prevent ordinary users from seeing the USERID while they browse the skeleton, you must hard code an authorized resource owner USERID outside the skeleton, as follows: //SYSINDDDISP=SHR,DSN=node.NDM.SIGNON A Application - Perform application administration functions G Global - Perform global administration functions Press ENTER to process; Enter END command to exit.
2. On the Administration Options panel, type G and press ENTER. The Global Administration Options panel is displayed: CMNGAMEN --------------- GLOBAL ADMINISTRATION OPTIONS -----------------------OPTION ===> 1 2 3 4 5 6 7 D I N O R S
Parms Library Language Procedures Reason Codes Sites Lock Dates Impact Notify Options Reports Skeleton
-
Generate global parameters Generate library types Generate language names Generate compiling procedures Generate reason codes for unplanned packages Generate site information Lock or reset application parameter locks Update the installation calendar Perform impact analysis maintenance Update the global notification file Configure selectable options Generate Change Man batch reports Create, update, and test skeleton procedures
Press ENTER to process; Enter END command to exit.
187
Chapter 9: Defining and Running ChangeMan ZMF Reports
3. On the Global Administration Options panel, type R and press ENTER. The Define Or Generate ChangeMan Batch Reports panel is displayed: CMNREPT0 -------- DEFINE OR GENERATE CHANGE MAN BATCH REPORTS ----------------OPTION ===> 1 2 3 4 5
Define Reports Analyzer Link Date DB2
-
Define Change Man Batch Reports Generate Change Man Batch Reports Submit Baseline Analyzer Report Submit Link Date Report Submit DB2 object dependency Report
Press ENTER to process; Enter END command to exit.
4. Define Reports: Global Administrator As a global administrator you can: •
Remove standard reports from the ChangeMan ZMF report facility.
•
Add reports that you coded as modifications to SAS program CMNSAS10.
•
Restrict who can run reports.
Follow these steps to define reports in global administration. 1. On the Define Or Generate ChangeMan Batch Reports panel, type 1 and press Enter. The Define Global ChangeMan Reports panel is displayed: CMNREPT1 -------------- DEFINE GLOBAL CHANGE MAN REPORTS --- Row 1 to 16 of 31 COMMAND ===> SCROLL ===> PAGE Enter END command to process or CANCEL to exit. Enter * in line command for default report selection list.
'''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' ''''
188
ID 010 050 060 090 100 110 120 130 140 150 160 170 180 190 200 210
Type U A A A A A A A A A A A A A A A
Report Description Summary of Planned and Unplanned Packages__ Installed Package History Report___________ Installed Simple Package History Report____ Super/Complex Packages Report______________ Application Configuration Report___________ Work Request Number Report_________________ Unplanned Packages Pending Post Approval___ Report of Backed Out Packages______________ Report of Rejected Packages________________ Unplanned Packages by Reason Code__________ Trend Analysis of Planned Packages_________ Trend Analysis of Unplanned Reason Codes___ Component History Report___________________ Trend Analysis of Unplanned Packages_______ Copies, Source and Load Component Report___ Utility (Scratch/Rename) Report____________
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following table describes the fields on the Define Global ChangeMan Report panel. Field
Description
Line Command
Type a line command to insert, repeat, or delete a report row. I
Insert a new report row below the selection.
R
Repeat an existing report row.
D
Delete an existing report.
*
Display the Default Defined Reports Selection List to add a standard report.
ID
Displays the three-character report ID. Report IDs must be unique.
Type
Type a report type to determine who can run the report online.
Report Description
G
Only global administrators can run this report.
A
Application Administrators can run this report, and they may make the report available for users to run. See “Defining and Generating Reports: Application Administrator” on page 193
U
Users in any application can run this report.
Description of the report.
2. If you typed * in the line command, the Default Defined Report Selection List panel is displayed: CMNREPT8 ----------- DEFAULT DEFINED REPORTS SELECTION LIST- Row 1 to 17 of 31 COMMAND ===> SCROLL ===> PAGE Enter END command to process or CANCEL to exit.
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
ID 010 050 060 090 100 110 120 130 140 150 160 170 180 190 200 210 240
Type A A A A A A A A A A A A A A A A A
Report Description Summary of Planned and Unplanned Packages__ Installed Package History Report___________ Installed Simple Package History Report____ Super/Complex Packages Report______________ Application Configuration Report___________ Work Request Number Report_________________ Unplanned Packages Pending Post Approval___ Report of Backed Out Packages______________ Report of Rejected Packages________________ Unplanned Packages by Reason Code__________ Trend Analysis of Planned Packages_________ Trend Analysis of Unplanned Reason Codes___ Component History Report___________________ Trend Analysis of Unplanned Packages_______ Copies, Source and Load Component Report___ Utility (Scratch/Rename) Report____________ Activity Summary by Application____________
189
Chapter 9: Defining and Running ChangeMan ZMF Reports
3. On the Default Report Selection List panel, type S in the line command of the reports that you wish to select, and press Enter. You return to the Define Global ChangeMan Reports panel, where the selected reports have been inserted. 4. To save your updates, press PF-3 or type End on the Command line and press Enter.
Run Reports: Global Administrator Follow these steps to run reports from global administration. 1. On the Define or Generate ChangeMan Batch Reports panel, type 2 and press Enter. The Generate ChangeMan Batch Report panel is displayed: CMNREPT3 ------------- GENERATE CHANGE MAN BATCH REPORTS ---------------------COMMAND ===> APPLICATION ===>
(Full name, pattern or blank for list)
JOB STATEMENT INFORMATION: ===> //USER83V JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=USER83 /*JOBPARM S=ESA5 //*________________________________________ SCROLL ===> PAGE Enter END command to process or CANCEL to exit. Package Number Release ID Report Date Range From To
_ _ _ _ _ _ _ _ _ _ _ _
ID 010 050 060 090 100 110 120 130 140 150 160 170
===> ===> ===> ===>
(optional, (optional, (YYYYMMDD, (YYYYMMDD,
report 500) report 890, blank or mask) optional) optional)
Report Description Summary of Planned and Unplanned Packages Installed Package History Report Installed Simple Package History Report Super/Complex Packages Report Application Configuration Report Work Request Number Report Unplanned Packages Pending Post Approval Report of Backed Out Packages Report of Rejected Packages Unplanned Packages by Reason Code Trend Analysis of Planned Packages Trend Analysis of Unplanned Reason Codes
The following table describes the fields on the Report Selection List panel. Field
Description
Package Number
Type a package number for Report 500: Type a package number to report one package. No masking is allowed. Leave blank to report all packages for the selected applications.
Release ID
Type a Release ID for Report 890: Type a particular Release ID. Type a pattern for a Release ID range, maximum of four characters, using * for a mask or pattern. Leave blank to report all Release IDs.
Report Range
Type a range of inclusive dates for the selected reports. Leave these fields blank to report all dates.
Line Command
S
Select the report.
D
Deselect the report.
ID
Displays the three-character report ID.
Report Description
Displays a description of the report.
You may select multiple reports on the Report Selection List panel. Press PF-8 to page down on the Report Selection List panel, and press PF-7 to page up.
191
Chapter 9: Defining and Running ChangeMan ZMF Reports
3. To run the selected reports, press PF-3 or type End on the Command line and press Enter.
Baseline Analyzer Report: Global Administrator Follow these steps to run the Baseline Analyzer Report from global administration. 1. On the Define Or Generate ChangeMan Batch Reports panel, type 3 in Option and press Enter. The Generate ChangeMan Baseline Analyzer Report panel is displayed: CMNBLA03 -------- GENERATE CHANGE MAN BASELINE ANALYZER REPORT ---------------COMMAND ===> APPLICATION ===>
(Full name or pattern)
JOB STATEMENT INFORMATION: ===> //USER239Z JOB (X170,374),CAMPBELL,CLASS=A,MSGCLASS=H,TIME=1,___________ ===> // NOTIFY=USER239___________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.
The following table describes the fields on the Generate ChangeMan Baseline Analyses Report panel. Field APPLICATION
Description Type the application mnemonic (three or four characters). Type a pattern for an application range, maximum of four characters, using * for a mask or pattern. Type **** to run reports for all applications. Leave this field blank to display the Application Selection List panel from which you may select one application.
JOB STATEMENT INFORMATION
Job card information for your reporting job.
2. After typing information on the Generate ChangeMan Baseline Analyzer Report panel, press Enter. A message is displayed indicating that the job has been submitted. See “Baseline Analyzer Report” on page 199 for a description of the Link Date report.
Link Date Report: Global Administrator Follow these steps to run the Link Date report from global administration.
192
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. On the Define Or Generate ChangeMan Batch Reports panel, type 4 in Option and press Enter. The Generate ChangeMan Link Date Report panel is displayed: CMNLNKD1 ------------ GENERATE CHANGE MAN LINK DATE REPORT -------------------COMMAND ===> JOB STATEMENT INFORMATION: ===> //USER239Y JOB (X170,374),CAMPBELL,CLASS=A,MSGCLASS=H,TIME=1,___________ ===> // NOTIFY=USER239___________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.
2. Review the job card statement information, make any necessary changes. Once you have verified the information, press Enter. A message is displayed indicating that the job has been submitted. See “Link Date Report” on page 204 for a description of the Link Date report.
DB2 Object Dependency Report: Global Administrator The DB2 Object Dependency report is a batch report that analyzes components managed by the DB2 Option of ChangeMan ZMF. See the ChangeMan ZMF DB2 Option Getting Started Guide for information on this report.
DEFINING AND GENERATING REPORTS: APPLICATION ADMINISTRATOR Accessing Application Reports Follow these steps to access the reports in application administration options. 1. On the ChangeMan Primary Option Menu, select option A and press ENTER. The Administration Options panel is displayed: CMNADMOM ------------------- ADMINISTRATION OPTIONS --------------------------OPTION ===> A Application - Perform application administration functions G Global - Perform global administration functions Press ENTER to process; Enter END command to exit.
193
Chapter 9: Defining and Running ChangeMan ZMF Reports
2. On the Administration Options panel, type A and press ENTER. The Application Administration Options panel is displayed: CMNLAMEN ------------- APPLICATION ADMINISTRATION OPTIONS --------------------OPTION ===> APPLICATION ===> 1 2 3 4 5 6 7 8 B C D N O P R
Parms Library Language Procedures Pln Approvals Upl Approvals Promotion Sites Baseline Component Delete Notify Options Production Reports
(Blank for list) -
Generate application parameters Generate library types Generate language names Generate compiling procedures Create planned approval list Create unplanned approval list Configure promotion libraries Configure site information Configure baseline libraries Update component information, procedures, security Delete an application Update the Global Notification File Configure selectable options Configure production libraries Generate application batch reports
Press ENTER to process; Enter END command to exit.
3. On the Application Administration Options panel, type an mnemonic, type R on the Option line, and press ENTER. The Define Or Generate ChangeMan Batch Reports panel is displayed: CMNREPT0 -------- DEFINE OR GENERATE CHANGE MAN BATCH REPORTS ----------------OPTION ===> 1 2 3 4 5
Define Reports Analyzer Link Date DB2
-
Define Change Man Batch Reports Generate Change Man Batch Reports Submit Baseline Analyzer Report Submit Link Date Report Submit DB2 object dependency Report
Press ENTER to process; Enter END command to exit.
Define Reports: Application Administrator As an application administrator you can: •
Remove reports from the reports selection.
•
Add reports to the reports selection list.
•
Restrict who can run reports.
Follow these steps to define reports in application administration.
194
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
1. On the Define Or Generate ChangeMan Batch Reports panel, type 1 and press Enter. The Define Application ChangeMan Reports panel is displayed: CMNREPT2 ------- DEFINE APPLICATION DEMO CHANGE MAN REPORTS Row 1 to 16 of 22 COMMAND ===> SCROLL ===> PAGE Enter END command to process or CANCEL to exit. Enter * in line command for default report selection list.
'''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' '''' ''''
ID 050 060 090 100 110 120 130 140 150 160 170 180 190 200 210 240
Type A A U A A U A A A A A A A A A A
Report Description Installed Package History Report___________ Installed Simple Package History Report____ Super/Complex Packages Report______________ Application Configuration Report___________ Work Request Number Report_________________ Unplanned Packages Pending Post Approval___ Report of Backed Out Packages______________ Report of Rejected Packages________________ Unplanned Packages by Reason Code__________ Trend Analysis of Planned Packages_________ Trend Analysis of Unplanned Reason Codes___ Component History Report___________________ Trend Analysis of Unplanned Packages_______ Copies, Source and Load Component Report___ Utility (Scratch/Rename) Report____________ Activity Summary by Application____________
The following table describes the fields on the Define Application ChangeMan Report panel. Field
Description
Line Command
Type a line command to insert, repeat, or delete a report row. I
Insert a new report row below the selection.
R
Repeat an existing report row.
D
Delete an existing report.
*
Display the Global Defined Reports Selection List to add a report.
ID
Displays the three-character report ID. Report IDs must be unique.
Type
Type a report type to determine who can run the report online.
Report Description
A
Application administrators can run this report.
U
Users authorized for this application can run this report.
Description of the report.
195
Chapter 9: Defining and Running ChangeMan ZMF Reports
2. If you typed * in the line command, the Global Defined Report Selection List panel is displayed: CMNREPT7 ------------ GLOBAL DEFINED REPORTS SELECTION LIST- Row 1 to 17 of 22 COMMAND ===> SCROLL ===> PAGE Enter END command to process or CANCEL to exit.
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
ID 050 060 090 100 110 120 130 140 150 160 170 180 190 200 210 240 250
Type A U A A A A A A A A A A A A A A A
Report Description Installed Package History Report___________ Installed Simple Package History Report____ Super/Complex Packages Report______________ Application Configuration Report___________ Work Request Number Report_________________ Unplanned Packages Pending Post Approval___ Report of Backed Out Packages______________ Report of Rejected Packages________________ Unplanned Packages by Reason Code__________ Trend Analysis of Planned Packages_________ Trend Analysis of Unplanned Reason Codes___ Component History Report___________________ Trend Analysis of Unplanned Packages_______ Copies, Source and Load Component Report___ Utility (Scratch/Rename) Report____________ Activity Summary by Application____________ Activity Summary by Department Number______
3. On the Global Report Selection List panel, type S in the line command of the reports that you wish to select, and press Enter. You return to the Define Application ChangeMan Reports panel, where the selected reports have been inserted. 4. To save your updates, press PF-3 or type End on the Command line and press Enter.
Run Reports: Application Administrator Follow these steps to run reports from application administration. 1. On the Define or Generate ChangeMan Batch Reports panel, type 2 and press Enter. The Generate Application Batch Report panel is displayed: CMNREPT4 --------- GENERATE APPLICATION DEMO BATCH REPORT --------------------COMMAND ===> Job Statement Information: ===> //USER239X JOB (X170,374),CAMPBELL,CLASS=A,MSGCLASS=H,TIME=1,___________ ===> // NOTIFY=USER239___________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.
196
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
2. Type Job Statement Information on the Generate Application Batch Report panel and press Enter. The Report Selection List panel is displayed: CMNREPT6 ------------------- REPORT SELECTION LIST --------- Row 1 to 12 of 31 COMMAND ===> SCROLL ===> PAGE Enter END command to process or CANCEL to exit. Package Number Release ID Report Date Range From To
_ _ _ _ _ _ _ _ _ _ _ _
ID 010 050 060 090 100 110 120 130 140 150 160 170
===> ===> ===> ===>
(optional, (optional, (YYYYMMDD, (YYYYMMDD,
report 500) report 890, blank or mask) optional) optional)
Report Description Summary of Planned and Unplanned Packages Installed Package History Report Installed Simple Package History Report Super/Complex Packages Report Application Configuration Report Work Request Number Report Unplanned Packages Pending Post Approval Report of Backed Out Packages Report of Rejected Packages Unplanned Packages by Reason Code Trend Analysis of Planned Packages Trend Analysis of Unplanned Reason Codes
The following table describes the fields on the Report Selection List panel. Field
Description
Package Number
Type a package number for Report 500: Type a package number to report one package. No masking is allowed. Leave blank to report all packages for the selected application.
Release ID
Type a Release ID for Report 890: Type a particular Release ID. Type a pattern for a Release ID range, maximum of four characters, using * for a mask or pattern. Leave blank to report all Release IDs.
Report Range
Line Command
Type a range of inclusive dates for the selected reports. Leave these fields blank to report all dates. S
Select the report.
D
Deselect the report.
ID
Displays the three-character report ID.
Report Description
Displays a description of the report.
You may select multiple reports on the Report Selection List panel. Press PF-8 to page down on the Report Selection List panel, and press PF-7 to page up.
197
Chapter 9: Defining and Running ChangeMan ZMF Reports
3. To run the selected reports, press PF-3 or type End on the Command line and press Enter.
Baseline Analyzer Report: Application Administrator Follow these steps to run the Baseline Analyzer Report from application administration. 1. On the Define Or Generate ChangeMan Batch Reports panel, type 3 in Option and press Enter. The Generate ChangeMan Baseline Analyzer Report panel is displayed: CMNBLA04 - GENERATE BASELINE ANALYZER REPORT FOR APPLICATION DEMO ------------COMMAND ===> Job Statement Information: ===> //USER239A JOB (X170,374),CAMPBELL,CLASS=A,MSGCLASS=H,TIME=1,___________ ===> // NOTIFY=USER239___________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.
2. Review the job card statement information, make any necessary changes. Once you have verified the information, press Enter. A message is displayed that indicates the job has been submitted. See “Baseline Analyzer Report” on page 199 for a description of the information on the Baseline Analyzer report.
Link Date Report: Application Administrator Follow these steps to run the Link Date report from application administration. 1. On the Define Or Generate ChangeMan Batch Reports panel, type 4 in Option and press Enter. The Generate ChangeMan Link Date Report panel is displayed: CMNLNKD1 ------------ GENERATE CHANGE MAN LINK DATE REPORT -------------------COMMAND ===> JOB STATEMENT INFORMATION: ===> //USER239Y JOB (X170,374),CAMPBELL,CLASS=A,MSGCLASS=H,TIME=1,___________ ===> // NOTIFY=USER239___________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.
2. Review the job card statement information, make any necessary changes. Once you have verified the information, press Enter. A message is displayed indicating that the job has been submitted. See “Link Date Report” on page 204 for a description of the information on the Link Date report.
198
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
DB2 Object Dependency Report The DB2 Object Dependency report is an batch report that analyzes components managed by the DB2 Option of ChangeMan ZMF. See the ChangeMan ZMF DB2 Option Getting Started Guide for information on this report.
BASELINE ANALYZER REPORT Baseline Analyzer is a utility that allows you to analyze the integrity of your source and load relationships. It identifies those components that have not yet been properly migrated by ChangeMan ZMF as well as discrepancies between source components and executable components.
//jobname JOB (account),'CHGMAN/BASLN', PROD99.APS300.LOAD Member Link Name Date Time SETSSI CMN6310I - No Change Man components to list within PROD99.APS300.LOAD . CMN5400I - Time of day at end of job: 17:09:09 - Condition Code on exit: 00 ******************************** BOTTOM OF DATA ***********************
Link Date Report Data The ChangeMan ZMF version is printed in the first line of the report. The rest of the information displayed on the report is self explanatory.
205
Chapter 9: Defining and Running ChangeMan ZMF Reports
206
HOUSEKEEPING TASKS
10
ChangeMan ZMF Housekeeping Tasks are tasks that are normally performed outside of the ChangeMan ZMF ISPF interface; they allow you to protect and store your data as well as keep ChangeMan ZMF running at optimal performance levels. The ChangeMan ZMF instance needs to be down if you are restoring, reorganizing or clearing the log file. You can backup when the ChangeMan ZMF instance is up, but remember that it may miss some updates that occur during that time period. For tasks requiring the ChangeMan ZMF instance to be down it is recommended that they be submitted periodically and at night (when the least number of users are affected). Sample JCL for housekeeping jobs is in the CMNZMF CNTL library delivered on the distribution CD or cartridge. Note
Housekeeping jobs are described in the Serena™ ChangeMan® ZMF Installation Guide. This chapter contains additional details about some of those jobs.
CLEANING UP BACKUP LIBRARIES Backup Libraries are associated with ChangeMan ZMF Production Libraries. When a package is installed, the current version of a component is copied from the Production Library to the Backup Library so it can be restored if package is backed out. You have three ways to handle the cleanup of Backup Libraries, and thereby manage the growth of components that accumulate in these data sets. By specifying the appropriate option as a PARM parameter on the JCL EXEC statement when running program CMNBATCH, you can do one of the following: •
Bypass cleanup of Backup Libraries (the default).
•
Perform "Package" processing.
•
Perform "Commit" processing.
Bypass Cleanup of Backup Libraries To bypass cleanup of Backup Libraries, you can specify the parameter 'BACKUPLIB=N' for program CMNBATCH. This is the default, so specifying the BACKUPLIB parameter is optional. When CMNBATCH runs, the CMN920 transactions delete the Staging Libraries but no attempt is made to delete components from the Backup Libraries: //CMNBATCH
EXEC PGM=CMNBATCH,
207
Chapter 10: Housekeeping Tasks
//
PARM='SUBSYS=?,BACKUPLIB=N'
Perform Package Processing for Backup Library Cleanup If cleanup processing is required for your site and you plan to process Backup Libraries by package association, use package processing for cleanup of Backup Libraries. You can do this by specifying 'BACKUPLIB=P' in program CMNBATCH when executing this program for housekeeping purposes, as in the following JCL: //CMNBATCH //
EXEC PGM=CMNBATCH, PARM='SUBSYS=?,BACKUPLIB=P'
During “Package” processing, CMNBATCH calls the program CMNCLNUP. The component being deleted in the Backup Library is first compared to its corresponding component in the Staging Library. If the directory entries for both components match, CMNCLNUP deletes the component from the Backup Library. Because this only happens to packages that have been ‘memo deleted’ or has ‘aged’, you have ensured that a component deleted from the Backup Library came only from a specific Staging Library in a specific package. The following discussion describes this type of clean up operation: 1. Assume that you created a package named PKG$000010 that contains the uniquenamed component 'XYZ0000'. When package PKG$000010 is installed, ChangeMan ZMF attempts to copy component “XYZ0000” from the production library associated with this package to the Backup Library in the CMN20 job. Because this component is unique and never resided in the production library, the IEBCOPY step that copies the component from the production library to the Backup Library ends with an RC=0004. At this time, the Backup Library has no component named “XYZ0000”. When CMN20 runs, the component “XYZ0000” is copied from the Staging Library to the production library. When CMN20 completes successfully and CMN30 executes, the baseline ripple happens.
208
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Backup
Production
Staging
Before Install XYZ0000
Staging library for PKG$0010 contains component XYZ0000.
Production library for application name PKG$ contains no component XYZ0000.
Backup library for application name PKG$ contains no component XYZ0000.
After Install
XYZ0000
Staging library for PKG$0010 contains component XYZ0000.
1
XYZ0000
Production library for application name PKG$ contains component XYZ0000 from package PKG$0010.
2
Backup library for application name PKG$ has no components named XYZ0000.
209
Chapter 10: Housekeeping Tasks
2. Assume that you created a package named PKG$000020 that contains component “XYZ0000” in the Staging Library. You make changes to the component, and schedule the package for installation. When the package is installed, the CMN20 job attempts to copy the component “XYZ0000” from the production library associated with this package to its corresponding Backup Library. Because a same-named component was previouslyplaced in the same production library by package PKG$000010, the IEBCOPY step backs up the component by performing a copy from the production library to the Backup Library. When IEBCOPY ends with an RC=0000, the Backup Library contains a component named “XYZ0000” from package PKG$000010. In the install step of CMN20, the next component “XYZ0000” from package PKG$000020 is copied from its Staging Library to the production library. As a result, the component “XYZ0000” from package PKG$000020 overlays the same-named component that was there previously from package PKG$000010. When CMN20 completes successfully and CMN30 executes, baseline ripple happens.
210
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Backup
Production
Staging
XYZ0000
XYZ0000 1
Staging library for PKG$0010 contains component XYZ0000.
Production library for application name PKG$ contains component name XYZ0000 from PKG$0020.
Backup library for application name PKG$ contains component name XYZ0000 from PKG$0010.
2
XYZ0000
Staging library for PKG$0020 contains component XYZ0000.
211
Chapter 10: Housekeeping Tasks
3. Assume that package PKG$000010 in BAS status has “aged”, so that the package is included in the CMN920 report, thereby creating the delete Staging Libraries transaction record for this package. This record becomes part of the SYSIN input for program CMNBATCH. PKG$000020 remains because it was installed at a later time and has not yet “aged”. During housekeeping, the CMN920 report generates a delete Staging Library transaction record for PKG$000010. When CMNBATCH reads the delete Staging Libraries transaction record, it builds a table from the package master listing all the components in package PKG$000010 that reside in a single Staging Library. Thereafter, the data set names for the Staging Library, the production library, and the Backup Library (associated with package PKG$000010 for one library type) are placed in another table. Then, CMNBATCH calls program CMNCLNUP to pass the component list and library list tables. Program CMNCLNUP then opens (1) the staging data set for package PKG$000010 under the DDname of SYSUT1, and (2) the Backup Library for package PKG$000010 under the DDname of SYSUT2. Next, program CMNCLNUP obtains the component name 'XYZ0000' from the component list and compare the directory entry for component 'XYZ0000' (from the Staging Library of package PKG$000010) to the directory entry of component 'XYZ0000' (in the Backup Library). If they match, you have ensured that component 'XYZ0000' in the Backup Library could only have arisen from package PKG$000010. Component 'XYZ0000' is deleted from the Backup Library. Alternatively, if the entries do not match, no deletion occurs. This ensures that any component being deleted from the Backup Library is directly associated only with the specific package.
212
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Backup
Production
Staging
XYZ0000
XYZ0000
Component XYZ0000 is from package PKG$0020.
Component XYZ0000 is from package PKG$0010.
XYZ0000
SY
SY SU T
2
PKG$0010
T1 SU
CMNCLNUP
Package Master CMNBATCH CMNDELAY
XYZ0000 Create CMN920 Report Package PKG$0020 Package PKG$0010 Ages
213
Chapter 10: Housekeeping Tasks
Once all components are processed, CMNCLNUP returns to the CMNBATCH program, which builds a component list for the next library type of package PKG$000010, and calls CMNCLNUP again until all library types have been processed. Thereafter, the Staging Libraries are deleted for the package, and the next transaction record is read, and housekeeping resumes. Because a component is tied directly to the package that is scheduled for deletion, this method of cleaning up the Backup Libraries is termed ‘package processing’. When a site has been running ChangeMan ZMF for an extended period of time and cleanup of Backup Libraries has not been performed, the Backup Libraries might have grown substantially and they are populated with many components from many packages. By running prior housekeeping jobs without ‘clean up,’ many packages and their corresponding Staging Libraries have probably been deleted, leaving many of their associated components in their respective Backup Libraries. This might result in retaining many orphan components (in the Backup Library) that are not deleted when you run a cleanup. This is because before cleanup processing became available as a new feature, prior housekeeping jobs may have deleted the package records and Staging Library for an old component in the Backup Library. As future packages are installed with the same named components as those in the Backup Library, the CMN20 job overlays old components in the Backup Library with the components being copied from the Production Library. Over time, the cleanup process matches components in the Backup Libraries from recently aged packages. This could take a long time, and if a component in a Backup Library never gets replaced it will always remain there.
Perform Commit Processing for Backup Library Cleanup If your site requires that the cleanup of Backup Libraries to be handled by ‘commit’ processing, specify the keyword 'BACKUPLIB=C' for program CMNBATCH when executing this program for housekeeping, as follows: //CMNBATCH //
EXEC PGM=CMNBATCH, PARM='SUBSYS=?,BACKUPLIB=C'
'Commit' processing differs from 'Package' processing in that the latter is a two-library “compare and delete” operation whereas former is a three-library operation. 'Commit' processing means that once a component has been installed in the production library and the package for that component has reached its aging criteria, you intend to commit that component to production and to remove any same-named components in the Backup Library regardless of the originating package. You are essentially committing the component in the production library. Provided the components for all aged packages in production are functionally stable, committing the components enables you to manage growth in the Backup Libraries for your ChangeMan ZMF system. During 'Commit' processing, a component in the Staging Library is compared to the samenamed component in the production library. If the directory entries for these components match, then the component is arbitrarily deleted from the Backup Library. During 'Package' cleanup, in contrast, the Staging Library and the Backup Library are compared to determine if the component is in the Backup Library.
214
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
The following steps describes the ‘Commit’ processing. 1. Assume that you create a package called PKG@000100 that contains component 'ABC00001' in the Staging Library. Next, you change the component and schedule the package for installation. When the package is installed, the CMN20 job attempts to copy a component named 'ABC00001' from the production library associated with this package to its corresponding Backup Library. If a same-named component was previously-placed in the same production library by a previously installed package, the IEBCOPY step backs up the component by copying it from the production library to the Backup Library. The Backup Library then has a component named 'ABC00001' from a previous package. When CMN20 runs, the samenamed component 'ABC00001' from package PKG@000100 is copied from its Staging Library to the production library. As a result, the component 'ABC00001' from package PKG@000100 overlays the same-named component that was there previously. When CMN20 completes successfully, the CMN30 job executes a baseline ripple for package PKG@000100, with the following result:
215
Chapter 10: Housekeeping Tasks
ABC00001
ABC00001
Staging library contains component named ABC00001 from any previously installed change package
Production library for application name PKG$ contains component name ABC00001 from PKG$000100.
ABC00001 1
2
ABC00001
Staging Library for PKG$0010 contains component ABC00001.
216
Backup
Production
Staging
Backup library for application name PKG$ contains component name ABC00001 from any previously installed change package.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
2. Assume that package PKG@000100 in BAS status has reached its aging criteria so that it is included in the CMN920 report that creates the delete Staging Libraries transaction record for this package. Next, program CMNBATCH is executed with the parm keyword of 'BACKUPLIB=C' in the EXEC statement. Then, the package that will be cleaned up is identified from the delete Staging Libraries transaction record. Next, program CMNBATCH extracts information from the package master to build a table listing all the components for package PKG@000100 that reside in a single Staging Library. The component name list only contains components that are known to ChangeMan ZMF for that package. In this example, the component list would only contain 'ABC00001' because it was the only component in package PKG@000100. Next, the data set names for the Staging Library, the production library, and the Backup Library associated with package PKG@000100 (for one library type) are placed in another table. Finally, CMNBATCH calls program CMNCLNUP and passes the component list and library names list. Once CMNCLNUP accesses the data set names table, it opens the following: — Staging data set for package PKG@000100 under the ddname of SYSUT1. — Production library for package PKG@000100 under the ddname of SYSC$DSN. — Backup library data set for package PKG@000100 under the ddname SYSUT2. Next, CMNCLNUP accesses the component names list table to obtain the component 'ABC00001’. Program CMNCLNUP compares the directory entry for component ‘ABC00001’ from the SYSUT1 Staging Library of package PKG@000100 to the directory entry of the same-named component in the SYSC$DSN production library. If the entries match, you have verified that the component 'ABC00001' in the production library must have come from package PKG@000100, and component ‘ABC00001' is deleted from the Backup Library represented by ddname SYSUT2 regardless of the source package.
217
Chapter 10: Housekeeping Tasks
ABC00001
T SU
SYS$DSN
SY 1
Staging Library contains component named ABC00001. This Staging Library is from any previously installed package, and this library may already be deleted from a prior execution of housekeeping.
Backup Library contains a component ABC00001 from any previously installed package.
2
Production Library contains same component ABC00001 from package PKG$000100.
CMNCLNUP
ABC00001
ABC00001
ABC00001
SY SU T
Staging Library contains component ABC00001from PKG$000100.
Backup
Production
Staging
Package Master
CMNBATCH CMNDELAY
Create CMN920 Report.
Package PKG$0010 Ages.
If the directory entries do not match, then deletion does not occur. This means that any component residing in the Backup Library with the same name as the component being compared in the Staging and Production Libraries is deleted if the components match.
218
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
Considerations for Cleaning up Backup Libraries Cleanup to the Backup Libraries whether by package processing or commit processing results in you being unable to perform a Backout. In deciding whether to use package processing or commit processing, consider the time packages are aged and the length of time that packages remain in development before they are eventually installed in production. Commit processing of the Backup Libraries is the most conservative implementation of a cleanup process because deletion occurs based on aging of the package currently in production. In setting the aging of the Staging Library by number of days, the installation can judge when the component in the Production Library has reached a point of functional stability such that the component in the Backup Library is no longer required and can be safely removed. This means stability in a component is based on its execution in production over a period of time with no problems after which you can release space occupied by the Staging Libraries and delete the backup component from the Backup Library. In commit processing whatever number of days you specify to age the Staging Libraries is the number of days that a backup component can be expected to remain in the Backup Library. With package processing deletion occurs based only on aging of the package. Package processing would be used less often than commit processing. Low activity packages with long aging criteria and short install intervals with infrequent housekeeping runs could use package processing to manage the Backup Libraries. With package processing there is the possibility that a package could start its 90 day aging on June 1 when it is installed. A second package containing the same component name could be created on June 1 and install on August 30 resulting in the old component from the first package being copied from the production library to the Backup Library. Housekeeping could run that night where the first package installed June 1 has now aged resulting in the backup component being deleted within a day of the second package being installed. This would impact your ability to backout from the second package. For high activity applications containing many packages in motion with varying install intervals and short aging criteria where you run housekeeping frequently, use commit processing to ensure that the backup for a component in production remains in the Backup Library for at least the number of days specified in Application Administration for the aging of the Staging Libraries. Cleanup performs all comparisons between the directory entry for each member in their respective library. Every field in the directory entry for a member is compared to its corresponding field in the directory entry for the same named member in the other library. Cleanup does not read the entire PDS directory for the Staging Library and compare for all members found. Cleanup gets its member list from the package master for the package that has aged and searches the Staging Library for the member name. If you allow the Staging Library to be used as a repository for members outside of ChangeMan ZMF, the cleanup process does not include them. Since only components known to ChangeMan ZMF are included, the comparison process between members based on only the directory entry is accurate.
219
Chapter 10: Housekeeping Tasks
Consider when a site has been running ChangeMan ZMF for an extended period of time and the cleanup of the Backup Libraries has not been implemented. The Backup Libraries may have experienced substantial growth over this time period, and the Backup Libraries are populated with many components from many packages. With the running of prior housekeeping jobs without cleanup of the Backup Libraries many packages and their corresponding Staging Libraries have probably been deleted leaving many of their associated components residing in their respective Backup Libraries. This results in the possibility of leaving many orphan components in the Backup Library which are not deleted when you start running a new cleanup process with your housekeeping task. This is because there is no package record or Staging Library available to perform a compare against what resides in the Backup Library for a package that prior housekeeping has deleted. As packages are installed in the future with the same named components as those that exist in the Backup Library, the result is old components are overlaid in the Backup Library with the components being copied from the production library as part of the CMN20 job. Over time the cleanup process catches up with delete processing as it encounters more hits in the Backup Libraries from recently aged packages. This catch up process could take an extended period of time, and if a component in a Backup Library never gets replaced it will always remain. The cleanup process follows the parameters specified at Application Administration, Option B, Baseline Configuration, Panel CMNBAS1 where the customer site sets the ‘Install in Prod’ indicators to ‘N’, ‘Y’, or ‘C’. During the cleanup process a read is performed to the package master for General Record 4 (library types) to identify all of the library types defined just to the package that has aged or is in memo delete status. Then a read is performed to Local Record 4 (baseline libraries) where the baseline install indicator is checked. If the library type is defined to the package but the ‘Install in Prod’ indicator is set to ‘N’, then cleanup excludes the library. The cleanup process picks up only the library types defined in General Record 4 that have a corresponding library type in Local Record 4 with the install indicator set to ‘Y’ or ‘C’. Next Local Record 5 (Production Libraries) is read to obtain the data set names of the production libraries. When cleaning up the Backup Libraries (for packages) with either 'package' or 'commit' processing, consider the following:
220
•
From the Baseline Configuration Panel (CMNCBAS1) during Application Administration, check the “Install in Prod” indicator setting. If the baseline library type is defined to the package but the indicator is set to N, then cleanup excludes the Backup Library for that same library type.
•
From the Production Libraries Panel (CMNCPRDL) during Application Administration, check whether the production libraries are defined. The cleanup process checks for the baseline install indicator and for the presence of production libraries defined in the package master to decide which Backup Libraries are subject to cleanup processing.
•
From the Application Parameters Panel (CMNGLP02), during Application Administration, check the aging criteria established for Installed Packages and Staging Data Sets.
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
•
Changing this number might generate two separate transactions on different dates, one to remove package records from the package master and one to delete the Staging Libraries. Cleanup processing reads the package records and requires the Staging Libraries for the comparison.
•
Therefore, the package records and the Staging Libraries must both exist during cleanup processing. So, for proper housekeeping, the Installed Packages value must be greater than or equal to the Staging Data Sets value.
•
Because the cleanup process deletes components from the Backup Library, you have no backout capability. Furthermore, you must maintain unique component names if you choose to perform “commit” processing and share the same Backup Library among different applications.
RUNNING REPORTS Reports can be run individually from inside ChangeMan ZMF using the R option on the Administration Global and Application menus, using Option 6 on the Primary Option menu, or you can submit them as a batch processing job. The JCL provided with ChangeMan ZMF runs all reports for all applications at your site. They can be run from the package master (VSAM file) or a backup (flat file). There are two JCL members provided in the CMNZMF CNTL library: •
REPORTS Uses the customizable SAS program which allows you to create your own reports.
•
REPORTS2 Uses a program which assumes you do not want to create your own reports.
Refer to the actual JCL member for details on the steps of both batch jobs, and be aware of the following: •
SAS control cards must be prepared. For an explanation, see “Defining and Running ChangeMan ZMF Reports” on page 183.
•
Report 920 identifies aged packages and Staging Libraries. Transactions are written to the tranfile DDNAME (if not dummied out) and actioned in program CMNBATCH (instead of the “batch” step).
•
Report 930 re-synchs the implementation calendars. Transactions are written to the tranfile DDNAME (if not dummied out) and actioned in program CMNBATCH (instead of the “batch” step).
•
If the report task is to be executed under a ChangeMan ZMF subsystem, be sure that the SUBSYS parameter, along with the actual SUBSYSTEMS ID, is coded within the EXEC card of the CMNBATCH step.
•
If the ChangeMan ZMF instance is DOWN when housekeeping is executed, the BATCH step receives an RC=6. This just acknowledges that the ChangeMan ZMF instance is down and that all transactions are written to the DELAY file. Execution begins when the task is brought up again.
221
Chapter 10: Housekeeping Tasks
LOG ACTIVITIES (CMNBAT30) CMNBAT30 is a report writer that processes and prints selected log inquiries. This batch program generates the Log Activity Report (CMN020) in batch mode.
222
INDEX Symbols #, field description 89
A access development libraries 32 grant user 33 personal libraries 32 purge batch job output 34 session utility data sets 33 submitting batch jobs 33 view batch job output 34 administration application setting up 97 general checklist 52 global 192 compiling procedures 80, 123 installation calendar 88 parameters 56 reason codes 81 languages, determining 79, 122 administrator application 16 general 16 global 15 security 16 aging installed packages field description 59, 109 aging staging datasets field description 59, 109 allocate baseline libraries 26 production libraries 27 promotion libraries 27 staging libraries 26 Allocate Dataset panel (CMNALCDS) 146 allow application update to file field description 64 allow checkout to personal lib 103 allow concurrent checkout field description 65, 103 allow temporary packages
field description 62, 102 appl field description 87, 99 application administrator 16 application administration affect of global settings 97 setting up 97 Application Baseline Configuration Part 2 of 2 panel (CMNCBAS2) 145 Application Compile Procedures panel (CMNCLPRC) 123 Application Component General Information panel (CMNCMPG1) 148 Application Component Information Options menu (CMNCMP00) 147 application description field description 101 Application Language Names panel (CMNCLLNG) 123 application packages, monitoring 163 application parameters setting 100 staging library allocation 39 Application Parameters Part 1 of 2 panel (CMNGLP01) 101 Application Selectable Options panel 155 applications deleting 154 field description 155 setting up remote sites for 176 approval described 22 approval lists 38 planned 40 setting up 124, 127 unplanned 40 approver description field description 125, 127 approver notification vehicle field description 63 audit
description 21 recompile 21 relink 21 audit level field description 65, 102
B backout management facilities 23 backup libraries, cleaning up 207 Backup Library Cleanup 214 baseline allocate libraries 26 keep by site 40 libraries 23 recommendations 32 using for production libraries 27 baseline analyzer accessing global administration 192 reports data set report 199 status condition messages 201 using 199 Baseline Configuration Part 1 of 2 panel (CMNCBAS1) 144 Baseline Driven Component List panel 148 baseline libraries configuring 144 batch job output purging 34 viewing 34 submitting access 33 block size field description 78, 118 business hours, normal 36
C calendar
223
Index
installation disable 36 setting up 88 planned installation 35 Change Man delay file field description 85, 178 Change Man environment field description 175 change package allow temporary 35 defined 19 change request track 35 check 29 checklist, implementation 50 checkout concurrent 37 description 20 enforcement 36 checkout component activity file field description 78, 118 checkout component description field description 78, 118 checkout enforcement rule field description 65, 103
Compile Procedure List panel (CMNPRCNM) 80 compiling procedures global administration 80, 123 component general information, defining 147 production installation, 23 security 152 storing 23 component activity file type field description 78, 118 Component Driven List panel 152 Component General Description panel (CMNCMPG3) 149 Component Level Security List panel (CMNCMPS1) 153 Component List panel (CMNCMPP2) 152 component name field description 150 Component User List panel (CMNCMPS2) 154 components secured 38
CMNCMPP2 152
concurrent checkout 37 configuring baseline libraries 144 production libraries 158 promotion environments 132 promotion libraries 132 remote sites 173
CMNDPUP1 95
configuring remote promotion 43
CMNDPUP2 95
Confirm Delete panel (CMNDPROJ) 154 customize descriptions 25 skeleton 25 customizing skeletons 175
Cleaning up Backup Libraries 219 CMNBAT10 186 CMNBATCH 208, 214 CMNCLNUP 208
CMNGBSOP 155 CMNGGP04 70 CMNQRYL1 164 CMNQRYL2 165 CMNSAS10 185 code column description 81 codes transaction 167 column descriptions code 81 description 81, 124 language 80, 124 procedure 81, 124 reason description 81 compile parms field description 151 compile procedure field description 150
224
D data set accessing session utility 33 data set name field descriptions 158 Dataset Information panel (CMNDSINF) 146 dataset type field description 78, 118 DB2 option description 94 DB2 pre-compile
field description 151 debugging, link date report 204 default unit name field description 57, 85, 110, 178 default volume serial field description 57, 85, 178 defer field description 75, 115 defining component general information 147 deleting, application 154 delta deck 23 department number track change request by 35 description field description 74, 87, 99, 114 descriptions column description 81, 124 dev model dsname field description 71 development libraries access 32 directory blocks field description 77, 117
E edit staging recovery mode on field description 111 emergency changes described 24 enforcement checkout 36 entity 29 defining names 28 name limiting access 29 securing libraries 30 entity check if 2 above field description 104 entity check if level 2 field description 103 exit implementing 25 extra user options field description 151
F field description field descriptions allow checkout to personal lib
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
103 promotion/demotion rule 105 field descriptions # 89 aging installed packages 59, 109 aging staging datasets 59, 109 allow application update to file 64 allow concurrent checkout 65, 103 allow temporary packages 62, 102 appl 87, 99 application 155 application description 101 approver description 125, 127 approver notification vehicle 63 audit level 65, 102 block size 78, 118 Change Man delay file 85, 178 Change Man environment 175 checkout component activity file 78, 118 checkout component description 78, 118 checkout enforcement rule 65, 103 compile parms 151 compile procedure 150 component activity file type 78, 118 component name 150 data set name 158 dataset type 78, 118 DB2 pre-compile 151 default unit name 57, 85, 110, 178 default volume serial 57, 85, 178 defer 75, 115 description 74, 87, 99, 114 dev model dsname 71 directory blocks 77, 117 edit staging recovery mode on 111 entity check if 2 above 104 entity check if level 2 103 extra user options 151 force option 151 forced demotion (Y/N) 135 generic unit name 77, 117 global notification file name 64 heirarchical approval process 110 highest # 99 highest package 155 install in PRD 145 installation job scheduler 58, 175 interfacing approver (Y/N) 125 internal reader class 135
job entry system 57 keep baseline by site 62, 102 language name 150 levels 144 lib type 74, 114 LIBRARIAN 61 library type 150 link edit parms 151 logical unit or subsystem name 175 logical unit or system name 57 logical unit/system name 85, 178 normal business hours 58, 102 optional model to copy 101 optional skeleton release ID 101 order no. 125, 128 overlay prior staged component 104 overlay prior staged module 66 PRD staging model dsname 85, 178 primary quantity 77, 117 promotion/demotion rule 67 record format 78, 118 record length 78, 118 release ID 155 remote site job card information 86, 178 require department number 62, 110 require work request number 62, 110 save to personal & staging libs 110 secondary quantity 77, 117 security entity 125, 127 security system 57 site node name 175 space units 77, 117 staging restriction level 103 starting date1 89 subsystem 56 target LOD type 75, 115 totals # 89 totals max 89 transmission vehicle 58, 86, 175, 178 type 144, 158 validate version during staging 105 volume serial 77, 117 force option field description 151 forced demotion (Y/N) field description 135 freeze described 22
G general administrator 16 generic unit name field description 77, 117 global administrator 15 global administration 192 compiling procedures 80, 123 installation calendar 88 languages, determining 79, 122 parameters 56 reason codes 81 remote sites, setting up 174 Global Administration Options menu (CMNGAMEN) 55, 187, 194 Global Language Names panel (CMNGGLNG) 79 Global Library Types Part 1 of 1 Table 74 Global Library Types Part 1 of 2 panel (CMNCGLT0) 73 Global Library Types Part 2 of 2 panel (CMNCGLT1 76 global notification file name field description 64 global parameters setting up 56 staging library allocation 39 Global Parameters panel, part 4 of 5 70 Global Parameters Part 1 of 5 panel (CMNGGP01) 56 Global Parameters Part 2 of 5 panel (CMNGGP02) 59 Global Parameters Part 3 of 5 panel (CMNGGP03) 64–65, 68, 106 Global Parameters Part 4 of 5 panel (CMNGGP04) 68, 70, 106, 109 Global Parameters Part 5 of 5 panel (CMNGGP05) 72 Global Selectable Options panel (CMNGBSOP) 94 grant user access 33
H heirarchical approval process field description 110 highest # field description 99 highest package
225
Index
field description 155 housekeeping tasks about 207
I impact analysis description 19 implementation checklist 50 INFO option description 94 install in PRD field description 145 installation guide 11 installation calendar disable 36 planned 35 setting up 88 installation job scheduler field description 58, 175 installation procedures network data mover 180 interfacing approver (Y/N) field description 125 internal reader class field description 135 internal scheduler monitoring 170 internally scheduled packages acting on 171 reviewing 171 internet support described 12
J job entry system field description 57
K keep baseline by site 40 field description 62, 102
L LAM see library access method language column description 80, 124 language name field description 150
226
languages, determining 79, 122 levels field description 144 lib type field description 74, 114 field description see also type LIBRARIAN field description 61 libraries allocate baseline 26 cleaning up 207 library accessing development 32 accessing personal 32 allocate production 27 allocate promotion 27 baseline recommendations 32 entity names 29 managing space 26 recommended formats 31 securing 30 library access method (LAM) 61 library type field description 150 library types reserved 74, 114 lifecycle single-site configuration 19 like load 75, 115 Limbo Package List panel 165 link date report 204 link edit parms field description 151 Lock/Unlock Applications panel (CMNGBULP) 87 Log Activity Report (CMN020) 222 logical unit or subsystem name field description 175 logical unit or system name field description 57 logical unit/system name field description 85, 178
M messages, baseline analyzer status condition 201 Monitor Option panel (CMNMONIT) 164 Monitor Packages in Limbo panel 164 Monitor Packages in Limbo panel (CMNQRYL1) 164
monitoring application packages 163 internal scheduler 170 site packages 163
N Network Data Mover (NDM) 180 normal business hours described 36 field description 58, 102
O option descriptions DB2 94 INFO 94 optional component descriptions, defining 147 optional model to copy field description 101 optional skeleton release ID field description 101 order no. field description 125, 128 overlay prior staged component 36 overlay prior staged component field description 104 overlay prior staged module field description 66
P package master 153 Package Master Driven Component List panel (CMNCMP01) 148 Package User Records 95 packages internally scheduled acting on 171 reviewing 171 monitoring application 163 site 163 panels CMNCMPP2 152 CMNGAMEN (Global Administration Options menu) 55, 187, 194 CMNGGP01 (Global Parameters Part 1 of 5 panel 56 CMNGGP01 (Global Parameters Part 1 of 5 panel) 56
Serena™ ChangeMan® ZMF 5.3 Administrator Guide
CMNGGP02 (Global Parameters Part 2 of 5 panel) 59 CMNGGP03 (Global Parameters Part 3 of 5 panel) 64 CMNGGP04 70 CMNGGP04 (Global Parameters Part 4 of 5 panel) 68, 70, 106, 109 CMNQRYL1 164 CMNQRYL2 165 Component Driven List 152 Global Parameters, part 4 of 5 70 Limbo Package List 165 Monitor Packages in Limbo 164 parameters application, setting 100 personal library access 32 planned installation calendar 35 planned approval list 40 setting up 124, 127 Planned Approvals Part 1 of 2 panel (CMNCAPLD) 124, 127 Planned Approvals Part 2 of 2 panel (CMNCAPL1) 126, 128 Planned Installation Calendar panel (CMNCLNDR) 88 PRD staging model dsname field description 85, 178 pre-implementation considerations 25 primary quantity field description 77, 117 procedure 147 column description 81, 124 procedures designated 38 producing reports about 183 product latest information 12 production allocate libraries 27 component installation 23 libraries setting up remote sites for 28 using baseline libraries for 27 library recommendations 32 production libraries configuring 158 Production Libraries panel (CMNCPRDL) 158
promotion allocate libraries 27 approvals during 47 described 22 remote overview 173 promotion environments configuring 132 promotion libraries configuring 132 promotion/demotion rule field description 67, 105
R Reason Code List panel (CMNRSNCD) 81 reason codes global administration 81 reason description column description 81 recompile described 21 record format field description 78, 118 record length field description 78, 118 recovery mode staging 39 release ID field description 155 relink described 21 remote promotion how administrators can configure 43 remote promotion about 173 how does it work 173 overview 173 remote site setting up for production libraries 28 remote site job card information field description 86, 178 remote sites configuring 173 maintaining 175 setting up for applications 176 setting up globally 174 sites remote 40 reports baseline analyzer report 199
link date 204 producing 183 running 221 require department number field description 62, 110 require work request number field description 62, 110 restriction level staging 37 reverse delta deck 23
S SAS reports 185 save to personal & staging libs field description 110 scheduler see internal scheduler secondary quantity field description 77, 117 secure libraries 30 security 147 administrator 16 component 152 setting up 28 security entity field description 125, 127 security system field description 57 SERENA mailing list subscribing 12 session utility data set accessing 33 single-site configuration lifecycle 19 site node name field description 175 site packages monitoring 163 skeleton customize 25 skeletons customizing 175 space managing library 26 space units field description 77, 117 stage overlay prior staged component 36 staging description 20
227
Index
recovery mode 39 restriction level 37 validate version during staging 37 staging libraries allocating 26 staging library allocation global parameters 39 staging library allocation application parameters 39 staging restriction level field description 103 starting date1 field description 89 submit batch jobs 33 subsystem field description 56 support internet 12
T target LOD type field description 75, 115 temporary allow change package 35 library recommendations 32 totals # field description 89 totals max field description 89 track change request 35 transaction codes 167 transmission vehicle field description 58, 86, 175, 178 type field description 144, 158
U unplanned approval list 40 user access granting 33 user options query 40
V validate version during staging field description 105 volume serial
228
field description 77, 117
W work request track change request by 35
