Changeman UserGuide

CHANGE MAN® USER GUIDE VERSION 4.1.6

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. 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. 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. Copyright © 1999 SERENA Software Inc. All rights reserved.

TRADEMARKS Change Man, Comparex, and StarTool are registered trademarks of SERENA Software, Inc. CDF (Concurrent Development Facility), Detect+Resolve, FULL.CYCLE, Merge+Reconcile, SERNET, SERPOWER, StarWarp, and X:Change are trademarks of SERENA Software, Inc. Change Transfer is a trademark of SERENA Software, Inc. and High Power Software, Inc. Detect+Resolve Mainframe is jointly owned and developed by SERENA Software, Inc. and High Power Software, Inc. SyncTrac is a registered trademark of SERENA Software, Inc. and High Power Software, Inc. CA-ACF2, CA-Librarian, CA-Panvalet, CA-Top Secret, and CA-Endevor are registered trademarks of Computer Associates International, Inc. DB2, DR/RACF, IMS, and ISPF are trademarks and registered trademarks of the International Business Machines Corporation (IBM). Microsoft Windows NT and Microsoft SNA Server are registered trademarks of Microsoft Corporation. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners. Publication Date: September 28, 1999 Order Number: CMNDU416

CONTENTS 1

Introduction Change Man Server 4.1.6 Enhancements Year 2000 Compliance Mass Recompile Change Man/IMS 1.1.0 Formatted Component Description Data Enhanced Info/Man Interface SERENA Network 3.1.1 Additional Remote Procedure Calls Machine Readable Documentation Substantial Quality Improvement

2

1-1 1-1 1-2 1-2 1-2 1-2 1-3 1-3 1-3 1-3

What is Change Man? Features of Change Man Change Packages The Change Man Life Cycle Inside Change Man Development Create The Checkout Process The Staging Process Auditing Freezing Packages Promoting Packages and Components Approving Packages Installation Backing Up Backing Out Packages or Components Temporary Change Cycle Distribution to Remote Sites Distributing and Installing Components at Remote Sites Change Man Library Environment

2-1 2-1 2-2 2-3 2-3 2-3 2-4 2-5 2-6 2-6 2-7 2-9 2-9 2-11 2-11 2-11 2-12 2-12

i

Contents

Checkout Impact Analysis Staging Audit Recompile and Relink Freeze Promotion Approve Production Installation Baseline Libraries and Delta Decks Backout Management Facilities Emergency Changes Storage Name Considerations

3

2-12 2-13 2-13 2-14 2-15 2-16 2-16 2-16 2-17 2-17 2-17 2-18 2-18

Accessing Change Man and Navigating Panels Accessing the Primary Option Menu Accessing the Build Options Menu Navigating Through Change Man Panels Panel By Panel Navigation Using Direct Access Navigation Using Package List Option Working with Lists of Libraries, Packages and Components Using Commands Using Patterns Using Lists Using a Selection List Scrolling Through Lists Using Basic Edit Line Commands Inserting a Line Repeating a Line Deleting a Line Read-Only Versus Data Entry Fields Accessing the Online Tutorial Exiting Change Man Canceling Changes on a Panel Change Man Online Error Messages Providing Job Card Information

ii

3-1 3-3 3-3 3-3 3-4 3-4 3-4 3-4 3-5 3-5 3-7 3-8 3-8 3-8 3-8 3-9 3-9 3-9 3-9 3-10 3-10 3-10

Change Man Version 4.1.6

Contents

4

Creating a Change Package Creating a New Package Using Short and Long Methods Providing a Package Description Specify Package Installation Instructions Package Scheduling Dependencies Scheduling Installation Date and Time An All Site Environment A Remote Site Environment Package Levels Complex or Super Packages Participating Packages

5

Updating Change Package Information Updating a Change Man Package Control Information Updating Package Description Package Installation Instructions Package Scheduling Dependencies Affected Applications Complex or Super Package Information Package Installation and Site Information Remote Site Single Site Updating Package Status for Super and Complex Packages

6

5-1 5-2 5-4 5-5 5-6 5-7 5-8 5-8 5-9 5-10 5-12

Checking Out a Component Checkout Restrictions, Rules, and Options Checking Out Components Selecting Components from Baseline or Promotion Libraries Using the Package List to Select Componentst

7

4-1 4-2 4-5 4-6 4-8 4-9 4-9 4-11 4-12 4-13 4-14

6-1 6-3 6-3 6-7

Staging a Component Administration Parameters Which Affect Staging Accessing the Stage Options Panel Staging from Development Stage Development Component List

Change Man User Guide

7-1 7-2 7-3 7-7

iii

Contents

Stage Compile and Link Edit Panel User Options Mass Compile and Link Edit Components Staging Other Type Components Panel Staging from Packages Source to Load Relationship Panel User ID Work List Panel Staging Using Package Parameters Component List Parameters

8

7-8 7-11 7-12 7-13 7-13 7-15 7-16 7-16 7-17

Auditing Packages How Audit Works Audit Options The Audit Change Package Panel Two Audit Methods Pre-Audit (Staging Library Audit only) Full Audit Running an Audit Success or Failure Additional Features Audit Auto-Resolve Diagnostic Information Filtering the Number of Reported Out-of-Synch Conditions Specifying a Participating Package as a Primary Package Processing Participating Packages by Install Date The Audit Report Audit Report Format Locating Information in the Audit Report Header Audit Report Header The Report Body Report Sections Section Layout Areas Example 1: The Three Layout Areas: An Introduction to Audit Reports Baseline and Staging Areas Component History Area Example 2: Fields in the Three Layout Areas: Copy Report Section Baseline and Staging Area Fields: Copy Component History Area Fields: Copy

iv

8-1 8-2 8-2 8-7 8-7 8-8 8-9 8-9 8-9 8-9 8-9 8-10 8-10 8-10 8-11 8-12 8-12 8-12 8-14 8-14 8-14 8-15 8-15 8-16 8-17 8-17 8-18

Change Man Version 4.1.6

Contents

Example 3: Fields in the Three Layout Areas: Source Report Section 8-19 Baseline and Staging Area Fields: Source 8-19 Component History Area Fields: Source 8-20 Example 4: Fields in the Three Layout Areas: Load Report Section 8-20 Baseline and Staging Area Fields: Load 8-20 Component History Area Fields: Load 8-22 Example 5: Flags 8-22 Example 6: Staging Library Audit: Link-Edited Statically Called Subroutines 8-23 Audit Report Output Similarities 8-24 Legend and Summary Report 8-24 Recommendation Summary Report 8-26 Evaluating Audit Reports 8-26 Out-of-Synch Conditions 8-26 Return Codes 8-33 Differentiating Install Dates 8-33 Complex or Super Packages 8-33 Participating Packages 8-33 Examples for Handling Install Dates 8-34 Summary of Exampes of Audit Situations 8-35 8-36 Example A: Auditing a Participating Package as a Simple Package 8-37 Overview of Auditing Participating Package 5 as a Simple Package 8-38 Example B: Auditing a Complex Package 8-38 Overview of Auditing Complex Package 1 8-39 Example C: Auditing a Participating Package as a Primary Package with Process by Install Date Set to No 8-39 Overview of Auditing Participating Package 5 as a Primary Package with Process by Install Date Set to NO 8-40 Example D: Auditing a Participating Package as a Primary Package with Process by Install Date Set to Yes 8-40 Overview of Auditing Participating Package 5 as a Primary Package with Process by Install Date Set to YES 8-41 Example: Auditing a Participating Package as a Primary Package with Process by Install Date Set to No 8-41 Summary of Auditing Participating Package 5 with Process by Install Date Set to NO 8-42 Example F: Auditing a Participating Package as a Primary Package with Process by Install Date Set to Yes 8-42 Summary of Auditing Participating Package 5 with Process by Install Date Set to YES 8-43

Change Man User Guide

v

Contents

Summary of Auditing Participating Package 5 by Department Number with Process by Install Date Set to NO 8-45 Summary of Auditing Participating Package 5 by Department Number with Process by Install Date Set to YES 8-46 Resolution Scenarios 8-46 Case 1: SYNCH4! (within the same change package) 8-46 Case 2: SYNCH5! (within the application) 8-47 Case 3: DUPLIC! (within a change package) 8-47 List of Upgraded Components 8-48 Source 8-48 Copybook 8-48 Panels 8-49 Skeletons 8-49

9

Freezing a Package Accessing the Freeze Options Panel Freeze a Package Online Freeze A Package in Batch Unfreeze and Refreeze Components Reset the Freeze in Progress Indicator

10

Promoting to a Local System Using The Promotion Facility for Intermediate Testing Third Party Testing Unit Testing of Online Systems Promoting and Demoting Changes Promoting a Change Package Promoting Online Promoting in Batch Demoting a Change Package Demoting A Package Online Demoting in Batch Promoting and Demoting Components Promoting Components Selectively Promote Components Repromote Select Components. Demoting Components from a Package Checking for Common Components

vi

9-3 9-4 9-5 9-6 9-9

10-2 10-2 10-2 10-2 10-4 10-4 10-5 10-6 10-7 10-7 10-8 10-8 10-8 10-8 10-10 10-11

Change Man Version 4.1.6

Contents

11

Promoting to a Remote System How Administrators Can Configure Remote Promotion Promoting Change Packages or Components to a Remote Site Selective Promotion of Components Demoting Change Packages or Components from a Remote Site Checking for Common Components at a Remote Site

12

Recompiling and Relinking Components Recompile Overview Recompiling into Staging Libraries Providing Recompile Job Information Browsing Recompile Source List Relinking Load Components Example Stage User Options Panel Link Edit Control Cards List

13

13-2 13-5 13-5 13-6 13-6 13-7 13-7 13-7 13-9 13-9 13-9

Reverting a Package Reverting a change package.

15

12-1 12-1 12-4 12-5 12-5 12-6 12-8 12-9

Approving or Rejecting a Package Approving or Rejecting Packages Approving or Rejecting a Package Approving a Package Rejecting a Package Resubmitting the Batch Approve and Batch Build X Node Data Set JCL Using the Component User ID Work Record Using the Component User ID Work Record during Approval Viewing the Component User ID Work List Deleting the Component User ID Work Record Distribution and Installation of the Change Package Distribution to Remote Sites

14

11-1 11-2 11-9 11-11 11-16

14-2

Backing a Package Out of Production Accessing the Backout Change Package Option Panel Backing Out a Package from a Remote Site

Change Man User Guide

15-1 15-3

vii

Contents

16

Using Package List for Change Man Functions Accessing the Package List Parameters Panel Browsing the Change Package List Acting on Packages

17

16-1 16-5 16-5

Utility Requests Compress Staging Libraries Accessing the Compress Staging Libraries Panel Renaming or Deleting Components Accessing the Rename or Scratch Options Panel Creating Utility Requests from Baseline Activating or Deleting Utility Requests from Packages Deleting and Undeleting Packages Deletion Considerations Setting up a Memo Delete Canceling a Deleted Change Package Request

18

17-1 17-1 17-2 17-2 17-3 17-4 17-5 17-5 17-6 17-6

Comparing Staging Libraries Comparing Staging Libraries to Baseline or Promotion Printing, Deleting or Keeping Comparison Information

19

18-1 18-4

Browsing and Printing Package Information Using the Activity Log Providing Browse Activity Log Filtering Information Reviewing the Activity Log Produce a Log Activity Report Using the Baseline Browse/Print Facility Browsing Baseline and Promotion Library Components Editing Components in Browse Mode Use ISPF Edit Commands Copy Components to Target Data Sets Printing Copies of Components Print Copies of Components with Expanded Copybooks Browsing a Compressed Listing Browsing Compressed Listings Printing, Deleting or Keeping Compressed Listings Delete, Keep and/or Print the Report

viii

19-1 19-1 19-3 19-4 19-6 19-9 19-11 19-11 19-11 19-13 19-13 19-13 19-14 19-15 19-15

Change Man Version 4.1.6

Contents

Browsing the Global Notification Facility Using the Scan Library Utility Scanning Online Allowing a Library Scan Restricting a Library Scan Search for Dependencies Batch Scan Search for Character String Search for Dependencies Running the Batch Scan

20

Querying Packages and Components Accessing the Query Options Panel Querying Change Packages Specifying Filter Criteria Using the Extended Search Criteria Panel Browsing the Query Package List Querying Components Querying Impact Analysis Data Specify Search Criteria for the Component List Query the Component Selection List

A

19-16 19-18 19-18 19-21 19-21 19-22 19-23 19-23 19-25 19-26

20-1 20-2 20-2 20-5 20-5 20-9 20-11 20-12 20-15 20-16

Package Category Panels General Information Non-Source Source Source and Load Relationship Renames and Scratches Approval List Site Activities Date and Time Site and Install Date Information Custom Forms Participating Package Status Start Date and Time Revert Reasons Backout Reason Promotion History

Change Man User Guide

A-1 A-2 A-3 A-5 A-5 A-5 A-6 A-6 A-7 A-8 A-8 A-8 A-9 A-9

ix

Contents

Remote Promotion History Promotion Libraries Remote Promotion Libraries Query Development Staging Libraries Query Production Staging Libraries Production Libraries Baseline Libraries

Glossary Index

x

A-10 A-11 A-12 A-14 A-15 A-15 A-16 G-1 I-1

Change Man Version 4.1.6

INTRODUCTION

1

The Change Man User Guide is designed for persons wanting to use Change Man functions in order to migrate software, or applications, from a development environment to a production environment. After reading this publication, you should be able to perform any of the functions of Change Man and access any package information, reports or analysis information for packages.

CHANGE MAN SERVER 4.1.6 ENHANCEMENTS Change Man Server 4.1.6 is designed to be Year 2000 compliant. The 4.1.6 release contains a minimum number of new features, so as to make the conversion effort for the existing customer base as painless as possible. SERENA recognizes that a number of Change Man customers will convert to 4.1.6 in the immediate future to satisfy their specific Year 2000 compliance issues. As it stands, the conversion to Change Man Server 4.1.6 from earlier versions of Change Man depends upon the customization at a client’s site. A majority of the panels and skeletons are modified in 4.1.6; these modifications are required to support four digit years in all date input and output fields. A number of panels are also redesigned; this is necessitated when year expansion results in a line that cannot be accommodated in an 80-character field. Following are the enhancements for Change Man Server Version 4.1.6.

Year 2000 Compliance Change Man Server 4.1.6 is fully Year 2000 compliant. In implementing Year 2000 compliance, SERENA realizes that a number of customers read the package master directly. To avoid modifying the format of the package master at this time, Change Man adopted the industry-sanctioned fixed window technique, using 1960 as the base year. When using this technique, years

1-1

1 Introduction

below the base year are assumed to be in the 20th century, and years base and above are assumed to be in the 21st century. Customers who adopt this same technique can modify any programs that access the package master to be Year 2000 compliant. The key length of the log data set did change in this release; the date is a part of the key and the key length changed from eleven to fourteen.

Mass Recompile Change Man Server 4.1.6 includes the ability to specify batch mass recompiles, through the MASS and MASSALL primary commands. The MASS command will recompile all selected members; MASSALL will recompile all members displayed. Included is the ability to suppress the history while processing compile parameters and to specify a set of compile parameters for the components in a mass recompile. In a mass recompile, the CMNRCOMP will submit a single CMNRPC2 job, which will then invoke the high level recompile RPC and submit a compile job for each component selected/ processed.

Change Man/IMS 1.1.0 Change Man Server 4.1.6 is the first release of Change Man to support the CMN/IMS interface option. This option supports compiles for PSBs, DBDs and MFSs. Also supported is the promotion and installation of these component types, along with the generation of ACBs for PSBs and DBDs. Overrides can also be specified for PSBs and DBDs. Exit CMNEX041 is available to help the administrator control who can update the IMS information within a package. This is similar to CMNEX001 for package information updates.

Formatted Component Description Data Change Man Server 4.1.6 includes a feature known as Formatted Component Description Data. The Component Description Data string that Change Man previously supported was free form text. Exit CMNEX042 now lets you format this free form area and validate the information there.

Enhanced Info/Man Interface Exit CMNEX100 information is now passed along to the Change Man Info/ Man interface to let you set up additional information for Info/Man. This information is passed 4096 bytes behind the standard information and does not show in CMNINFAP. Program samples that access this area are available from Technical Services.

1-2

Change Man Version 4.1.6

Change Man Server 4.1.6 Enhancements

SERENA Network 3.1.1 SERENA Network 3.1.1 offers Change Man Server users substantial performance enhancements, as well as a bridge to the future SERNET versions.

Additional Remote Procedure Calls Change Man Server 4.1.6 includes 31 new RPCs. This follows SERENA’s stated direction in moving all Change Man functions to RPCs.

Machine Readable Documentation All of the Change Man Server 4.1.6 manuals are available in Adobe Acrobat Portable Document Format (PDF). These machine-readable manuals are not distributed on the Change Man tape, but are available on SERENA’s FTP server. Contact Technical Services for more information on obtaining an FTP userid and password, or for additional information on viewing the PDF files.

Substantial Quality Improvement Change Man Server 4.1.6 includes substantial product fixes. All fix packages are included, and a substantial number of errors from previous releases have been corrected. The quality of Change Man Server is important to SERENA.

Change Man Administrator Guide

1-3

1 Introduction

1-4

Change Man Version 4.1.6

WHAT IS CHANGE MAN?

2

Change Man is a comprehensive system designed to provide reliable and streamlined implementation of software changes on the MVS system. It is a system that manages and automates the process of migrating software changes, or applications, from a development environment to any test environment and to the production environment. A comprehensive TSO/ISPF interface guides you through various change management processes.

FEATURES OF CHANGE MAN •

Unique package concept guarantees the coordination of your change

•

Concurrent development are managed

•

Controls version discrepancy and out-of-synch component relationships

•

Maintains listings on-line for immediate access

•

Provides notifications

•

Manage your libraries (Librarian, Panvalet, or PDS, PDS/e)

•

Full suite of on-line and batch query and reporting capabilities

•

Maintain historical information in a single repository.

CHANGE PACKAGES Within Change Man, a Change Package is the vehicle in which all changes are moved from a development environment to a production environment. A change package may contain one or more components (source, copybook, load, JCL, control cards, compiling procedures, documentation, and other components) which are required to implement a software change.

2-1

2 What is Change Man?

THE CHANGE MAN LIFE CYCLE This section provides an overview of the Change Man life cycle. It provides a step-by-step description of migrating a change from development to production within Change Man. Figure 1:

2-2

1

Create a Change package. A Change package contains the elements to be edited and installed into production, and is identified by an unique package identification generated by Change Man. When you create a package, you provide the information that Change Man needs to track and control the package.

2

Checkout components from baseline. The checkout process allows you copy components from your baseline libraries to a Change Man staging library or to a personal development library where you can make changes.

3

Editing changes. You may edit changes in the Change Man staging or in the development libraries.

4

Staging components. For source components, staging will run the appropriate translation procedures to create associated load modules. Components such as documentation or copy members are copied into the staging libraries, if they are not there already.

5

Audit process. The audit process ensures that no unexpected problems will occur.

6

Freeze process. The freeze process locks the package and makes the package available for the promotion and approval processes.

7

Promotion process (optional). Promotion allows a package to be moved through various levels of testing. For example, promote from system testing to acceptance testing.

8

Installation. After all of the approvals have been gathered by Change Man, the package is ready to be installed. If the manual installation method was selected when the package was created, the package will be installed immediately after the final approver has approved the package. If the Change Man’s internal scheduler method was selected, Change Man will automatically install the package on the date and time specified at package creation. If an external scheduler is used, Change Man will convey the install information to that scheduler so that it can install the package.

Change Man Version 4.1.6

Inside Change Man Development

9

Baseline ripple. After installing the package, Change Man will baseline ripple the package. Baseline ripple is the process that Change Man executes to version all package components.

INSIDE CHANGE MAN DEVELOPMENT Behind the displayed Change Man panels, there are jobs being performed that ensure the smooth flow of enhancements to each application maintained by development analysts.

Create Create is a first step of the Change Man life cycle. After you Create a change package, Change Man allocates Staging Libraries as needed. The dataset names of the Staging Libraries reflect the application mnemonic chosen for your application, the package number assigned by Change Man for this change, and the type of components placed in the library; for example, DEMO . CMNSTAGE .#000023. SRC . The Global Administrator decides on the format of the data set name. The package information is recorded on the Package Master along with the TSOID of the creator. A record of this event (Package Creation) is placed on the Log.

The Checkout Process Checkout is the process of copying components from the Baseline Library (any level back or from Promotion Libraries) to a development area for modification in a change package. You can Checkout online in the foreground or in background as a batch job. If you Checkout in background mode, Change Man asks you to verify (initially type or update) the jobcard statements needed to perform the batch job. When you Checkout a component, the standard PDF statistics are carried forward and the version number (the vv portion of vv.mm) is incremented. Change Man adds the Checkout information to the statistics that make up a component’s history. A record of this event (Checkout component) is placed on the Activity Log. Anyone can browse this log for information not only on Checkout actions, but also other Change Man activities.

Change Man User Guide

2-3

2 What is Change Man?

If you associate the Checkout to a valid change package ID, the component name is added to the package’s Staging List. This means that when you select the Stage option from the Build Options Menu and select to Stage from the Package Driven option, the component is already listed with a Checkout status. This means that it is ready for copying into the appropriate Staging Library; to do this you simply type an S next to the item and press Enter. In some applications, package association may be required by the administrator; in all cases, package association can simplify (reduce the number of required keystrokes in) the Staging process.

The Staging Process Staging introduces components into Change Man by copying them from development or personal libraries into Change Man Staging Libraries. All Staging Library components must be associated with pre-defined change packages. Depending on how your administrator configures Staging parameters for your site, you can either Stage any newly created application component into any change package, or only components previously associated with change packages. For instance, your administrator may want to restrict new development on an application and designate that only existing components be maintained. The administrator can restrict the Staging process so that only components previously associated with change packages can be Staged back into the change cycle. Before staging, verify that your administrator has: •

Designated compile procedures for each language type you intend to Stage.

•

Assigned appropriate compilers during installation of Change Man

Staging Libraries contain components of the same type. The following table lists component types that Change Man recognizes and considers when staging.

2-4

Type

Description

SRC

Source modules

LOD

Load modules

Change Man Version 4.1.6

Inside Change Man Development

Type

Description

JCL

JCL

DOC

Documentation

CPY

Copybooks

LCT

Linkage Control Cards

LIKE SRC

Assign this type to SRC, LOD, or CPY components when you want to Stage components of same type into separate Staging Libraries.

LIKE LOD LIKE CPY OTHER

Assign this type to components when you want to customize processing of a component.

PRC

Compiling Procedures

You can Stage components either online or Mass Stage them in batch.

Staging Type

Enables User to do the Following:

Online

Use confirmation panels to review relevant parameters and compile procedures prior to Staging a component. Use language assumption, a feature that automatically assigns language types, and designated compile procedures when Staging source components.

Batch

Stage multiple components simultaneously. Stage complete libraries of components. By-pass confirmation panels to Stage components faster. Use the language assumption feature.

Auditing When you audit a package’s Staging Libraries, Change Man analyzes and reports on every module contained in both the Baseline Library and your change package. The Audit function also validates all copies and program calls, producing a report listing all duplicates and out-of-synch conditions.

Change Man User Guide

2-5

2 What is Change Man?

Freezing Packages When you are ready to Freeze the package for Promotion and/or Approval (Approval is required), Change Man checks two things: •

Are all components in an Active status?

During the Stage process if the component is successfully copied into the appropriate Staging Library and if source components’ have compiled, link/ edited, and their bind has completed then Change Man will change the status of the component to Active. •

Did the package pass the audit?

The audit level selected by the application's administrator must not be exceeded. When the package is successfully Frozen, the package's status changes from DEV to FRZ, which locks out anyone from Staging into the package's libraries. A record of this event (Freeze package) is placed in the Activity Log.

Promoting Packages and Components The Promotion facility allows you to set up intermediate environments or Promotion levels where you can perform quality assurance, unit and system tests on packages and components. Promoting involves migrating change packages or components through these intermediate environments. Demoting is the deleting of components logically or physically from these environments. Before using the Promotion facility, your application administrator must first set up: •

Promotion levels:

You can have one or more levels of Promotion, each level having one or more libraries associated with it.

•

Promotion process:

You can Promote packages and components either online or in batch.

•

Promotion authorization:

Each Promotion level can be secured. Your administrator can build rules within Change Man and your security system that will designate which users can Promote a package to a specific level.

Generally, you Promote packages from Staging Libraries to specified Promotion levels.

2-6

Change Man Version 4.1.6

Inside Change Man Development

The following functional characteristics of the Promotion facility may affect decisions you make about when and how to Promote and Demote packages and components: •

After components are copied from package Staging Libraries, they will continue to reside in the Staging Libraries. This implies that you should only include executable libraries in your Promotion environment. Source modules do not have to be promoted because they will be retained in the package libraries.

•

Promotion from level to level may be a logical copy or a logical move; that is, the components may remain in the previous environment or they may be deleted from the previous environment upon Promotion.

•

Each time you Promote (or Demote), Change Man updates the statistics constituting the component's history. A record of this event (Promote package) is placed in the Activity Log.

•

Staging skeletons for source components may reference Promotion copybook libraries as part of the copybook concatenation. Therefore, if copybooks are Promoted, they may be made available to source compilation of other packages.

•

Change Man does not enforce the use of Promotion, even if it has been set up by an administrator. Moreover, upon completion of the Approval process, the package is Distributed (and Installed) regardless of the level of Promotion reached. This gives you the flexibility to alter the path of migration of each package. However, if you do want to require a Promotion path, you can administratively link your Promotion security to your Approval security. This technique allows a promoter to offer his/her Approval of a package once it has been successfully Promoted and tested.

Approving Packages When a person accesses the Change Man panels, that person’s TSOID is passed along and used to determine which functions are available. Approval may be performed only by those TSOIDs associated to the Entity names that the application's administrator has specified as approvers. •

The approval process consists of browsing the package information and Staging Libraries for quality control and standards and selecting to Approve (or Reject) the package.

•

A record of this event (Package Approval) is placed in the Activity Log. The package status is changed from FRZ to APR.

Change Man User Guide

2-7

2 What is Change Man?

2-8

•

All Approvals for a package must be gathered before Change Man will Install a package. In fact, the final Approval of a package will actually initiate or schedule the package Installation.

•

A change package must be in Frozen (FRZ) status to be Approved or Rejected.

•

In general, a package’s components cannot be modified while in Frozen status. This implies that a package’s components cannot be modified while approvals are being gathered. However, components can be selectively unfrozen, modified, and refrozen while the package is still in Frozen status.

•

There can be multiple levels of Approvals. Change Man requires at least one approval but allows administrators to set up more than one level.

•

Multiple levels of Approval may be set up in a hierarchy. This implies that Change Man will enforce an order of Approvals. Change Man will not allow Approvals to be gathered out of order.

•

More than one User ID may be authorized to satisfy a given Approval level. This is set up in your security system.

•

Your application administrator may have set up Approval notifications. Each approval level can be configured with multiple User ID notifications. The User IDs that are notified may or may not coincide with the User IDs that can actually satisfy the Approval.

•

Different packages may have different Approvals. Change Man allows administrators to set up separate Approval Lists by application and by time of day. Change Man will attach an abbreviated Approval List to unplanned packages Created outside of normal business hours. Change Man will attach a complete Approval List to all other packages. Furthermore, your administrator may have tailored a user exit to customize Approvals Lists further.

•

Change Man provides special processing for packages with an abbreviated Approval List attached. These Approvals must, of course, be gathered before the package can be Installed. However, once Installed, the package continues to be available for Approval or Rejection by approvers on the complete Approval List. This allows for a post-Installation Approval strategy.

•

Packages may be Promoted and Demoted while Approvals are being gathered. This implies that the final Approval of a package will Install it, regardless of the Promotion status. Therefore, the final approver of package should be sensitive to the Promotion activities of packages.

Change Man Version 4.1.6

Inside Change Man Development

•

If a package is Rejected, it must be Reverted if it is to be updated to conform to the Reject reasons. Package Revert will reset the Rejection and place it in Development status. The package must then be Frozen again to reinitiate Approvals.

•

If a package was Promoted before it was Rejected, then it must be Demoted before it can be Reverted.

•

Package Revert will reset any gathered Approvals. This is true regardless of whether the package is first Rejected.

Installation Installation depends on whether or not an internal scheduler is set up by the global administrator or if the Install job JCL has been specially modified. There are three variations on Installation: •

If no scheduling system is specified, the package goes through the Installation process immediately.

•

If the Install job JCL is set up with a TYPRUN=HOLD, the user releases the job when they are ready to Install.

•

If a scheduling system other than Change Man's internal scheduler is specified, then Change Man performs a batch interface to add the Install job to the scheduler's list. The operator, however, must still demand the job for the package to be Installed.

•

If Change Man is the scheduler, it checks the package master every few minutes for any packages which are ready and Installs those that meet the criteria.

Backing Up Backup is the first job to be performed when Installation time arrives. This job copies the production libraries (only those components which are about to be overlaid with updates) to a backup set, in case they are needed to back out the incoming enhancement. Next, the contents of the change package Staging Libraries are copied into production libraries. A record of this event (Package Installation) is placed on the Activity Log. This occurs each time the package is Installed at one of the Remote Sites. Once the package is verified as Installed in all requested sites, the following steps are performed: 1

The package status is changed from DIS to INS (or from APR to INS if there are no Remote Sites).

Change Man User Guide

2-9

2 What is Change Man?

2

A job is sent to the development center to clear out the last level of Promotion reached and ripple the Baseline Libraries for that application.

3

The package status is changed from INS to BAS.

4

A record of this event (Baseline Ripple) is placed on the Log.

NOTES Only the various versions of changed software components are updated; Change Man ripples the changes through the versions of an application’s Baseline Libraries. Assume that the following is true:

2-10

•

An application maintains up to three versions of its Baseline Library software: current (0), -1, and -2.

•

You want to update the Baseline Libraries with a change package in which component A is changed, component B is scratched and component C is added.

•

There already is a -1 and -2 version of component A. Thus, the baseline library is updated as follows: •

The -1 version of component A is copied to overlay the -2 version of component A.

•

The 0 version of component A is copied to overlay the -1 version of component A.

•

The newly Installed version of component A is copied from the production Staging Libraries to overlay the Baseline Library 0 version of A.

•

Component B is scratched.

•

The newly installed version of component C is copied from Staging Libraries and added to the Baseline 0 Libraries.

Change Man Version 4.1.6

Inside Change Man Development

Backing Out Packages or Components If there is a problem with the change package (backout is allowed only for permanent packages) after it has been Installed, the change package is backed out by deleting the updated component in production and then retrieving the previous version of application software from the Backup Library. This option is selected by an authorized user in the production environment, usually an operator or production analyst. Change Man will back out the entire package by copying the components from the Backup Libraries to overlay production. The package status is changed from BAS to BAK. A record of this event (Package Backout) is placed in the Activity Log. A job is submitted in the development area to reverse ripple the Baseline Library. A record of this event (Baseline Reverse Ripple) is placed in the Activity Log.

Temporary Change Cycle When a temporary change package is Created, the user must type the number of days the change is to remain in the temporary (override) environment (if your global administrator has setup this option). The Installation process is different from other package types because the contents of the temporary change package Staging Libraries are copied into Temporary Libraries, which are concatenated ahead of production libraries. Since the production library components are not touched, Change Man does not perform the Hot Backup. The components are never rippled into the Baseline Library. After the package is Installed, Change Man begins the aging process at each site selected to receive the temporary change. The package is deleted from the Temporary Library when the number of elapsed days is met and the administrative housekeeping tasks which delete them are executed. After the package has been deleted from all sites, its status is changed from INS to TCC, and a record of this event (Temporary Change Cycle Completed) is placed on the Activity Log.

Distribution to Remote Sites The next step after approval depends on the environment type configured for the site. •

If there are Remote Sites, then the package Staging Libraries, the Installation JCL, and a copy of the package master record pertaining to this change are: — Distributed (copied) to all the sites specified in the Creation/Update package process.

Change Man User Guide

2-11

2 What is Change Man?

— Installed there. A record of this event (Package Distribution) is placed in the Activity Log and a Distribution acknowledgment is sent back to the development center. The package status is changed from APR to DIS. •

If Remote Sites exist, the package is ready for Installation. For further information, see ”Installation“ on page 2-9.

Distributing and Installing Components at Remote Sites Remote Sites are additional CPUs where Change Man Installs components. An additional CPU can be: •

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 on a different CPU. Remote Sites act only as a receiver of production level components. The only time developers interact with Remote Sites is when they select which Remote Site to Distribute and Install production level components.

CHANGE MAN LIBRARY ENVIRONMENT 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 that exists (-1, -2, -3, etc.). Depending on the way your administrator has configured Change Man, you can check out components:

2-12

•

To personal libraries

•

To staging libraries

•

Only if they are associated with change packages

Change Man Version 4.1.6

Change Man Library Environment

•

In batch

•

Online

•

Concurrently with other components

If your site has applications that require parallel development, you can configure Change Man to allow concurrent checkout of components. Change Man has an automated process for managing this concurrent development. As part of this process, Change Man 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, Change Man 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.

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 ensure that they are current. Change Man 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.

Staging Staging is the process of introducing newly developed or previously developed components into the Change Man change cycle for modification or enhancement, and packaging with related change package components. When you stage a component, Change Man 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, the vehicle Change Man uses 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 Change Man, 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.

Change Man User Guide

2-13

2 What is Change Man?

Change Man staging libraries, however, are more than pre-production holding libraries. Components can be modified and tested within protected Change Man 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. In addition, Change Man maintains up-to-date records of all staging activities for packages and components. For example, when you stage a source component, Change Man records the time that the component was staged, 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 Change Man’s master file, the package master. You can view this component and package information any time by using the query function within staging. Change Man 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 Change Man 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, Change Man 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 (in the DEV/FRZ status) 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 a LOD component that does not match its SRC component. Recognizing these situations, called out-ofsynch components, are part of Change Man’s ability to help you detect code that is inconsistent with your development procedure and other code problems. Examples of out-of-synch situations that the Change Man audit addresses include:

2-14

•

Copybooks that have been changed after a source program has been compiled

•

Source programs that need to be recompiled due to a copybook change

Change Man Version 4.1.6

Change Man Library Environment

•

Called subroutines that have been changed after a referencing source program has been compiled and linked

With Change Man 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 You can use audit to analyze the staging library contents of an evolving change package, with respect to baseline contents, for the purpose of finding any out-of-synch situations. The recompile function is used to resolve certain types of out-of-synch conditions found during the audit. The allowable audit return code is determined during global and application parameter generation, and you are not allowed to freeze the change package without passing the audit return value entered for the application. Using the relink option you can: •

Relink load components without associating them with source code

•

Delete previously relinked components

The relink process is similar to compile since you select a component from a baseline list. A new load component is produced and copied into the package's staging library. Use the delete function to remove recompiled or relinked components that do not have associated source in the package. You can also delete the resulting LST file and any other non-load components that have been associated with it through the CMNBAT90 service. (See your administrator for details on this service.) A component’s history is picked up from the history record for that component in the package master. For example, the relink picks up the user options on CMNUSR01 that were there when the program was last compiled. When relinking you can include LCT cards that contain the link control cards from staging or baseline libraries, or you can dynamically generate them if there is no component available. You do this if you: •

Do not have source code for a component, but make a change to a subroutine

•

Need to perform a composite link where the resulting load component name does not have accompanying source

Change Man User Guide

2-15

2 What is Change Man?

Freeze Another unique Change Man feature is the ability to freeze change packages. When the change package is ready for the next phase of the change implementation life cycle, 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. With Change Man, however, the started task 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 Change Man 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 Change Man controls all updates. Change Man 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, Change Man (optionally) removes the components from the promotion environments. All production installation occurs from the change package staging environment. With Change Man, you define your testing methodology and the number of testing levels that are required.

Approve Approvals for change package installation are performed online, eliminating the requirement for manual approval processes. During the Change Man 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. Change Man relies on your security system. Change Man does not use internal personnel tables. Approval lists of specific USERIDs or approving entities are defined to your security system so that electronic signatures can be collected.

2-16

Change Man Version 4.1.6

Baseline Libraries and Delta Decks

For each application, a variety 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 Change Man, you have the flexibility to make these choices.

Production Installation Change Man is actively involved in the management and control of actual production component installation. Component installation can be automated through Change Man’s internal scheduling system or through Change Man’s direct interface with a job scheduling system. In addition to component movement, Change Man performs other production installation activities such as DB2 Plan binding. Change Man also has a unique change quantity threshold facility that allows you to control the number of changes that occur within 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 Change Man recognizes that your software components are vitally important business asset. Change Man gives you the ability to store your production source components in a structure that works for your organization. Components can be stored in PDSs, CA-LIBRARIAN files or CA-PANVALET files. Components can be segregated by application or by categories, such as batch versus online. Equally, applications can share libraries. Change Man automatically stores prior versions of components. These versions can be stored as full copies (inherent for load components), or as delta decks. Change Man 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.

Change Man User Guide

2-17

2 What is Change Man?

Change Man 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, Change Man automatically restores these executable components to production. Change Man also performs all necessary DB2 Plan rebinding automatically. Because Change Man 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 Change Man 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. Change Man provides notification to any developer affected by the change so that the emergency fix can be incorporated globally into all change packages. Change Man does not impede the emergency change process by requiring that the component be released, reassigned, or renamed by the original owner.

STORAGE NAME CONSIDERATIONS Panvalet has a ten-character allowance which Change Man does not recognize, because it looks for eight character names. References in this manual assume PDS naming is the convention.

2-18

Change Man Version 4.1.6

ACCESSING CHANGE MAN AND NAVIGATING PANELS

3

Change Man runs as a started task in the MVS subsystem and utilizes crossmemory services for accessing ISPF. The started task architecture provides a single point of control and secure access to your production and development libraries. Interfacing to your security system for access, Change Man provides the optimum amount of control without sacrificing performance. The Primary Options Menu is the first panel the user sees when they sign onto the system. From this panel the user can select whichever function they require. The Primary Option Menu contains some of the Change Package Life Cycle processes like Freeze, Promote and Approve. The remainder of the Life Cycle processes can be found in the Build Options panel. The Build Options panel is accessed from the Primary Option Menu.

ACCESSING THE PRIMARY OPTION MENU Accessing Change Man is accomplished by selecting Change Man from your initial ISPF menu or executing the designated CLIST that initiates the started task. During the sign-on initiation a temporary Change Man title panel appears. Once the sign-on initiation is complete, the Primary Option Menu appears.

3-1

3 Accessing Change Man and Navigating Panels

CMN@PRIM -------- CHANGE MAN 4.1.68 PRIMARY OPTION MENU -----------INIT Complete OPTION ===> 1 2 3 4 5 A C D L N O Q R T X

Build Freeze Promote Approve List Admin CDF Delete Log Notify OFMlist Query Revert Tutorial Exit

-

Create, update and review package data Freeze or unfreeze a package Promote or demote a package Approve or reject a package Display (to process) package list Perform administrative functions Concurrent Development Facility Delete or undelete a package Browse the activity log Browse the Global Notification File Online Forms package list Query packages, components and relationships Revert a package to DEV status Display information about Change Man Exit Change Man

Press ENTER to process; enter END command to exit.

The Primary Option Menu displays options built upon the authorization of your User ID and your site configuration. After verifying with your host security system which Change Man functions that you can access, Change Man builds the menu. If you are licensed for Online Forms Manager (OFM) or Concurrent Development Facility (CDF), those options will appear on the Primary Option menu. The security administrator as well as the global and application administrators can provide information about user and site security configurations. From the Primary Option Menu, you can access Change Man services and functions by using the panel-by-panel access method, the direct access method, or package list method. The Primary Option Menu and the Build Options menu are the main navigational panels in the Change Man system. Their primary function enables the user to access all the Change Man functions.

3-2

Change Man Version 4.1.6

Accessing the Build Options Menu

ACCESSING THE BUILD OPTIONS MENU The Build Options panel allows the user to navigate throughout many of the Change Package Life Cycle processes and many other additional functions. The Build Options panel can also be displayed at the completion of the package create process. It will be displayed with the Change Package ID in the upper right-hand corner after a successful creation of a Change Package.

CMNBUILD ----------------------- BUILD OPTIONS ------------------------------OPTION ===> 0 1 2 3 4 5 6 7 8 9 B C L S Z

Dates Create Update Custom Utility Checkout Stage Audit Recompile Relink Browse Compare Listing Scan Compress

-

Display the installation calendar Create a new package Update package information Create, update, approve or review custom forms Rename and Scratch information Check out components from baseline or promotion Stage, edit, browse and delete components Audit a package Recompile source code from baseline or promotion Relink load modules Browse\print\copy baseline or promotion Compare staging to baseline or promotion Browse compressed listings Scan baseline for character strings Compress change package Staging Libraries

Press ENTER to process; Enter END command to exit.

NAVIGATING THROUGH CHANGE MAN PANELS Panel By Panel Navigation In the Option field of a menu, type the number or letter that designates a specific function and press Enter. For example, from the Primary Option Menu, you type 1 and press Enter to display the Build Options menu. To return to a previous menu or panel, type End in the Option or Command field on any panel or press the appropriate PF key command, usually PF3.

Change Man User Guide

3-3

3 Accessing Change Man and Navigating Panels

Use panel by panel navigation as you learn Change Man. When you become more familiar with the product, you can use the direct access method for navigation.

Using Direct Access Navigation In the Option or Command field, type a sequence of numbers or letters with a plus sign or an equal sign preceding the string and place a period between each command. For example, in the Option or Command field, you type: +1.2

or =1.2

where 1 and 2 are single character options on successive panels. Change Man displays the panel of the last character in the direct access stacked commands. To return to a previous menu or panel, type END in the Option or Command field on any panel or press the appropriate PF key command.

Using Package List Option Almost all functions within Change Man are available to every package through the List Option (option 5 in the Primary Option Menu). Once the users become more familiar with the product, will usually switch to the Package List option. This method of panel navigation is very fast as the user can do all their work from the Package List panel.

WORKING WITH LISTS OF LIBRARIES, PACKAGES AND COMPONENTS There are lists in Change Man that let you view contents of libraries, packages and components.

Using Commands Following are a set of standard commands used to work with these types of lists. To use them, type the command letter and a component or package name in the panel. Press ENTER to execute the command. Type the following commands in the cursor field next to the component:

3-4

Change Man Version 4.1.6

Working with Lists of Libraries, Packages and Components

•

B to browse

•

S to select an item for action.

•

H to display history for an item.

Type the following commands on the Command line: •

REFRESH to Update the list.

•

CANCEL to Cancel the request.

•

SORT to Sort the list. (Only valid for member and procedure/language displays)

•

L to locate an item in the list. For example, L xxxxxxxxx where xxxxxxxx is the component name.

After executing one of these commands, a message normally appears in the status column to indicate your action (such as BROWSE for a browsed list item). Not all commands are available from all lists. If you type an incorrect command or character in a panel, Change Man displays the correct available commands from that panel.

Using Patterns The system often encourages you to input a pattern to get a range of values in a list from Change Man. Pattern rules are: * A ‘*’ at the end of a character string is a wildcard for any number of characters. It must be used at the end of a string. * A ‘?’ can replace any single character in a string.

Using Lists When using lists within Change Man, there are many options for masking the list you display so that you can work with only a portion of the total list. The following table contains some examples of the masking options and their results.

Change Man User Guide

3-5

3 Accessing Change Man and Navigating Panels

Masking (or Pattern)

Description

* or * *

all packages for all applications

A*

all packages for all applications that start with A

A*B

all packages for all applications that start with A and end with B

*A

all packages for all applications ending with A

* 1

all packages in all applications that begin with 1

ABCD1*

all packages whose number starts with 1 in application ABCD (e.g., ABCD100000 to ABCD199999)

ABCD*1

all packages ending in 1 in application ABCD

ABCD10*

all packages whose number starts with 10 in application ABCD (e.g., ABCD100000 to ABCD109999)

ABCD*10

all packages ending with 10 in application ABCD

When masking, the package name must be at least four characters. For example, if the package name is DAM, and you typed D*M, to display all DAM packages for application that begin with D and end with M, you will receive a message indicating a package error. If there is an “*” in the number part of the package ID, there are no zeroes filled in before the number; e.g., A*10* is resolved to Aaaa10nnnn, not 00010n. However, if an “*” is not found in the number area, there is zero fill; e.g., A*10 is resolved to Aaaa000010). Also, remember that if the application is only three characters, there will be a blank before the package number. Often when using Change Man, you are asked to complete a list or table of items. There are standard ways to insert, repeat, and delete lines of information from these lists. Each of the following tasks assumes that you have already accessed the required panel to build a list. Refer to the individual panels for information about saving your changes to the list or for functions that are unique to that list.

3-6

Change Man Version 4.1.6

Working with Lists of Libraries, Packages and Components

Using a Selection List Change Man has many types of panels, one of which is a selection list. A selection list is a panel that has a list from which you can select one or more items. You often access a selection list from a main panel field to help you identify available items, such as a list of all possible library types. There are several options you have for displaying a selection list.

CMNSTG08 ---------------- LIBRARY TYPE SELECTION LIST -----ROW 1 TO 14 OF 14 COMMAND ===> SCROLL ===> PAGE LIB DESCRIPTION _ CLI CLIST -User Customized CLISTs _ CPY Copybooks _ CP1 Like-CPY (1) _ CTC Control Cards s JCL Job Control Language _ LCI LOADCICS-CICS Load Library _ LCT Linkedit Control Cards _ LDG LOADDLG -ISPF Dialog Load Library _ LD1 Like-LOD (1) _ LOD Load Modules _ OTH OTHER library type _ SKL ISPF Skeletons _ SRC Source Code _ VLD Load Modules ***************************** Bottom of data ******************************

To select or deselect items from a list, take the following steps: 1

Move the cursor to the line command (LCMD) column of a desired row in the list, type S, and press Enter to select the desired row. If there is a status column *SELECT appears to indicate the selection.

2

You can type D and press Enter to deselect a desired row. If there is a STATUS column, *DESEL displays to indicate the deselection.

3

Type End and press Enter (or PF3) when you are finished.

The original panel from which you accessed the selection list displays. The selections or deselections in the list are shown in the panel field from which you accessed the selection list.

Change Man User Guide

3-7

3 Accessing Change Man and Navigating Panels

Scrolling Through Lists Often, lists that you build or access through Change Man are too long to view on the screen. Use the UP and DOWN keys (normally PF7 and PF8 keys, respectively) on your keyboard to scroll up and down through the lists. To move forward or backward a specific number of lines, type a number and use the PF7 key to go forward that number of lines, or the PF8 key to go backward that number of lines. Using the combination of a command character and a PF key, you can also immediately move the maximum number of lines to the top or bottom of a panel or dataset/member. By typing M on the command line and using the PF7 key, you move backward (toward the top of the data). Alternatively, you can use M + PF8 to move forward (toward the bottom of the data).

USING BASIC EDIT LINE COMMANDS Inserting a Line 1

Move the cursor to the first column or the LCMD column of the last row in the list.

2

Type I and press Enter to Insert a new row. Change Man inserts a new row.

3

Provide the information required for each column of that row.

Repeating a Line 1

Move the cursor to the first column, the LCMD column, of the row that you want to repeat in the list.

2

Type R and press Enter to Repeat a new row.

Change Man copies the row and inserts it at the end of the list. 3

Move the cursor to the newly repeated row.

4

Provide the information required for each column of that row.

See the individual sections of this manual for each panel for a table that describes each column of the list (since these lists differ depending on what information they are to contain).

3-8

Change Man Version 4.1.6

Read-Only Versus Data Entry Fields

Deleting a Line 1

Move the cursor to the first column, the LCMD column, of the row that you want to delete in the list.

2

Type D and press Enter to delete the row. The row is deleted.

READ-ONLY VERSUS DATA ENTRY FIELDS Change Man distinguishes between read-only fields and fields that require you to type data with color/hue and with visual symbols. If you have a color monitor, the fields display in different colors. If you have a monochrome screen, the intensity of the read-only fields differ from the intensity of the data entry fields. There are also visual symbols that follow the field label. If it is a read-only field the label is followed by a colon. For example, PACKAGE STATUS: DEV is a read only field. If the field is followed by "==>" the screen expects you to provide data in that field. For example: LIB TYPE ==>__ indicates a data entry field. If the fields are normally data entry fields, but you are currently prohibited from updating them, the arrow symbol still displays. However, the color/hue of the field is the read-only color, and BROWSE ONLY displays in the upper right hand corner of your screen.

ACCESSING THE ONLINE TUTORIAL An online tutorial is available to help you understand available options. To view the tutorial, press PF1; you can also type option T from the Primary Options menu.

EXITING CHANGE MAN You can exit Change Man in several ways. Type X to exit, and End from the Change Man Primary Option menu, or press PF3 from any other panel.

Change Man User Guide

3-9

3 Accessing Change Man and Navigating Panels

CANCELING CHANGES ON A PANEL You can abandon your changes two ways. •

Some panels require you to press End without pressing Enter to abandon.

•

Other panels require you to type CANCEL at the command line and press Enter. In general, the panel you are viewing always tells you how to abandon your changes.

CHANGE MAN ONLINE ERROR MESSAGES Change Man and ISPF handle online error messages similarly. The short (Change Man’s term), or primary (ISPF’s term), error message displays by default in the upper right-hand corner of your screen. To display the long (or secondary) error message, press PF1. The message appears on the third line of the screen, left justified. Ordinarily, the long message is more helpful because it provides more information. Remember, the long message does not display by default, and must be requested by pressing PF1.

PROVIDING JOB CARD INFORMATION Change Man often requests that you provide job card information for batch jobs such as install, checkout, stage, and freeze. Each time there are several lines of default information that you input the first time you run a batch job. After you edit the job card information the first time and actually run the batch job, this new information becomes the default. The following figure shows an example of the Checkout Job Card Information panel. CMNCKOT2 --------------- CHECKOUT JOB CARD INFORMATION -----------------------COMMAND ===> JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

3-10

Change Man Version 4.1.6

Providing Job Card Information

Unless the job card panel has separate, unique fields that require information from you, the job card information panel is simply referenced.

Change Man User Guide

3-11

3 Accessing Change Man and Navigating Panels

3-12

Change Man Version 4.1.6

CREATING A CHANGE PACKAGE

4

When you create a change package, you are defining the outer structure of the change package. Creating a change package involves providing information about the change package to Change Man through a series of panels. The panels you encounter during the create process may vary, depending on the options you select.

CREATING A NEW PACKAGE To create a new change package, take the following steps: 1

From the Primary Option Menu, select option 1 and press Enter. The Build Options Menu appears.

CMNBUILD ----------------------- BUILD OPTIONS -----------------------------OPTION ===> 0 1 2 3 4 5 6 7 8 9 B C L S Z

Dates Create Update Custom Utility Checkout Stage Audit Recompile Relink Browse Compare Listing Scan Compress

-

Display the installation calendar Create a new package Update package information Create, update, approve or review custom forms Rename and Scratch information Check out components from baseline or promotion Stage, edit, browse and delete components Audit a package Recompile source code from baseline or promotion Relink load modules Browse\print\copy baseline or promotion Compare staging to baseline or promotion Browse compressed listings Scan baseline for character strings Compress change package Staging Libraries

Press ENTER to process; Enter END command to exit.

2

From the Build Options menu, select option 1 and press Enter. The Create A New Package panel (CMNCRT01) displays:

4-1

4 Creating a Change Package

.

CMNCRT01 ---------------- CREATE: CREATE A NEW PACKAGE ---------------------OPTION ===> L S

Long method - Prompt for package description and special instructions Short method - Use default package description and instructions

PACKAGE TITLE ===> Displaying example for documentation APPLICATION REQUESTER’S NAME REQUESTER’S PHONE WORK REQUEST ID DEPARTMENT PACKAGE LEVEL

===> ===> ===> ===> ===> ===>

PACKAGE TYPE PACKAGE TIME SPAN PACKAGE TO COPY FORWARD UNPLANNED REASON CODE TEMPORARY CHANGE DURATION

===> PLANNED ===> PERM ===> ===> ===>

(Blank or pattern for list)

(1-Simple, 2-Complex, 3-Super, 4-Participating) (Planned or Unplanned) (Permanent or Temporary) (Optional package name) (* for list) (In days)

Press ENTER to process; Enter END command to exit.

Using Short and Long Methods You can use a short or long method to create a change package. •

The short method is generally used for quick-creating a package. It requires less information than the long method and is a easy process.

•

The long method has more fields and screens, for entering information.

The advantage of the long method is that more historical information is saved for your package. Both are viable methods and each shop may have its own guidelines for which method is preferable and under what circumstances. You can use the long method, but skip the fields that are not required and then simply update them later. This will save time, like the short method, but also retain the benefit of the historical data, from the long method. At the end of the creation process you are required to provide the scheduled installation date for the change package. When you do this Change Man updates the Planned Installation Calendar, which limits the number of change packages that can be installed on a daily basis for the upcoming year.

4-2

Change Man Version 4.1.6

Creating a New Package

The following table describes the fields of the Create A New Package panel (CMNCRT01) and the valid information that you can enter in the fields.

In this field . . .

Type . . .

PACKAGE TITLE

Title of the change package that you are creating.

APPLICATION

An application mnemonic (three or four bytes).

REQUESTER’S NAME

The name (up to 25 characters) of the person creating the package.

REQUESTER’S PHONE

The phone number (up to 15 characters) of the person creating the package.

WORK REQUEST ID

Up to 11 characters that identifies the work request of the package. (This may be required by the administrator. Depending on the INFO Management rule in effect, this field may be linked to an INFO Change record number.)

DEPARTMENT

The department of the person creating the package. (This field entry may be required by the administrator.).

PACKAGE LEVEL

1 (Simple). The change package contains a change that is unrelated to any other change package. 2 (Complex). The parent for two or more change packages that have interdependent change to software or operational procedures. Complex change packages are comprised of control, general, and complex and super change package information.) 3 (Super). The parent for change packages that contain major changes to several applications. Super change packages are comprised of control, general, and complex and super change package information.) 4 (Participating). The change package is related to one or more other packages.

PACKAGE TYPE

Planned (Indicates that the packages are scheduled changes that follow the established application rules.) Unplanned (Indicates that the packages are unscheduled changes, possibly an emergency fix. Emergency packages bypass some of the application rules and have a separate approval list.

Change Man User Guide

4-3

4 Creating a Change Package

In this field . . .

Type . . .

PACKAGE TIME SPAN

Permanent (Indicates that the packages are Scheduled changes that update baseline or production libraries. Permanent changes are either planned or unplanned. This is the normal way to install changes. Temporary Changes that run for a predetermined length of time. Once that time has expired, Change Man automatically deletes the change. Temporary changes do not update baseline or production libraries. These changes are installed into a static override library. Temporary changes are either planned or unplanned.

4-4

PACKAGE TO COPY FORWARD

The name of the package that contains the information that you wish to copy into the package that you are creating. (If you are creating a package that is similar to an existing package within the application, you can copy the information from that existing package into the package that you are creating.)

UNPLANNED REASON CODE

The code indicating the reason for the package being unplanned., or * to display a list of reason codes.

TEMPORARY CHANGE DURATION

The number of days that the change is to remain in effect.

Change Man Version 4.1.6

Providing a Package Description

3

After you have completed typing information in the fields of the Create a New Package panel (CMNCRT01), press ENTER to save the information that you entered on the panel. When you press ENTER, the Create Package Description panel (CMNCRT02) appears.

CMNCRT02 ---------------- CREATE: PACKAGE DESCRIPTION ------ Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Press ENTER or END to continue or type CANCEL to exit. (minimum one line, maximum 46 lines) ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ‘’’’ ________________________________________________________________________ ******************************* Bottom of data ********************************

PROVIDING A PACKAGE DESCRIPTION The Create Package Description panel (CMNCRRT02) allows you to provide a general description of the package that you are creating.

Change Man User Guide

4-5

4 Creating a Change Package

To provide a general description of your package, in the general description area (free form text field) of the Create Package Description panel (CMNCRT02), type a description of the change package that you are creating, and press ENTER to save the information and display the Create Installation Instructions panel (CMNCRT03). CMNCRT03 ------------- CREATE: INSTALLATION INSTRUCTIONS --- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Press ENTER or END to continue or type CANCEL to exit. CONTINGENCY ===> 1

SCHEDULER

‘’’’ ‘’’’ ‘’’’ ‘’’’

===> CMN

1-Hold production and contact analyst 2-Backout change, continue production 3-Other ===> (CMN, Manual or Other)

(minimum one line, maximum 46 lines) ________________________________________________________________________ ________________________________________________________________________ ________________________________________________________________________ ________________________________________________________________________

SPECIFY PACKAGE INSTALLATION INSTRUCTIONS The Create Installation Instructions panel (CMNCRT03) allows you to provide instructions for the installation of the change package as well as to indicate an option for problem contingency instructions in case a production problem arises after the package has been Installed. The valid information that you can enter into the fields.

4-6

Change Man Version 4.1.6

Specify Package Installation Instructions

In this field. . .

Type. . .

CONTINGENCY

The code that represents the action that you want the operations staff to take if a problem is encountered when installing the change package 1 (Hold production and contact analyst). Discontinue running the production jobs for your application until a supporting analyst can be reached for instructions. 2 (Backout change, continue production). Back out of the change package and continue running your application’s production jobs as normally scheduled. 3 (Other). Code Describe in this field some other action to be taken if there are problems in installing this change package. This field has a maximum length of 44 characters.

SCHEDULER

CMN Change Man holds the installation until the date and time you specify on one of the Site Configuration panels. Manual Change Man installs the change package as soon as the final approval is given. Other Specify scheduling instructions for change packages that use a job scheduler other than CMN and Manual. In order to use this option, the administrator must have set the Installation Job Scheduler field, on the Global Parameters Parameter 1 of 5 panel, to Other, and customized CMN017. If you select this option, the Create Scheduling Dependencies panel (CMNCRT04) appears.

INSTALLATION INSTRUCTIONS

Contains detailed instructions on how your change package should be installed. These can include, but are not limited to, production job dependencies and change package Installation dependencies. Each line has a maximum length of 72 characters and up to 46 lines are saved.

After you have completed typing information in the fields of the Create Installation Instructions panel (CMNCRT03), press ENTER to save the information that you entered on the panel. When you press ENTER, to save your information, the Create On Site Information panel (CMNCRT06) or Create Remote Site Information panel (CMNCRT07) appears, on which you can provide the date and time to schedule your package for production.

Change Man User Guide

4-7

4 Creating a Change Package

Package Scheduling Dependencies You may wish to specify the successor (run after) and the predecessor (run before) jobs that your scheduling system must be aware of in order to schedule installation of this change package’s components. If you typed OTHER in the scheduler field of the Create Installation Instructions panel (CMNCRT03), the Create Scheduling Dependencies panel (CMNCRT04) appears. CMNCRT04 -------------- CREATE: SCHEDULING DEPENDENCIES COMMAND ===>

SCROLL ===> PAGE

Press ENTER to continue or type CANCEL to exit. SUCCESSOR PREDECESSOR ‘’’ JOB3____ JOB1____ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ‘’’’ ________ ________ ******************************* Bottom of data ******************************

The Create Scheduling Dependencies panel (CMNCRT04) allows you to specify scheduling instructions for the package. It may not even be required by the job scheduler at your site and is optional. You may leave the panel blank and use the update option on the Build Options menu to modify it at later time. The following table describes the fields of the Create Scheduling Dependencies panel (CMNCRT04), and the valid information that you can enter into the fields. You can enter any of the line commands (I, R, or D) in the first column.

4-8

In this field. . .

Type. . .

SUCCESSOR

Successor job name regarding how your change package should be installed. These can include, but are not limited to, production job dependencies and change package installation dependencies (maximum character length = 8).

Change Man Version 4.1.6

Scheduling Installation Date and Time

In this field. . .

Type. . .

PREDECESSOR

Predecessor job name (maximum character length = 8).

SCHEDULING INSTALLATION DATE AND TIME You can provide the date and time when you want your change package to go into production. You provide this information on the Create On Site Information panel (CMNCRT06) or the Create Remote Site Information panel (CMNCRT07). Which panel that you use depends on the option that the global administrator set: •

All (you have no remote sites)

•

Development (change packages are distributed to remote sites, you cannot install them into production libraries)

•

Production (this is a remote site, no development is performed on this machine)

•

Development/Production (you can distribute change packages to remote sites and install them into production libraries)

An All Site Environment If your Change Man environment is an All site, the Create On Site Information panel (CMNCRT06) appears when you press ENTER from Create Installation Instructions panel (CMNCRT03). The Create On Site Information panel allows you to schedule the installation date and time of the change package, as well as enter the name and phone number of the people responsible for the change for locations that have only one site.

CMNCRT06 ---------------- CREATE: ON SITE INFORMATION ------------------------COMMAND ===> Press ENTER to create the package or type CANCEL to exit. INSTALL YYYYMMDD 19990628

DATE/TIME FROM TO 0600 0700

Change Man User Guide

PRIMARY/BACKUP CONTACTS Chaka Yebo_______________ D. Read Locks____________

PHONE NUMBERS 323-696-1233___ 323-696-1233___

4-9

4 Creating a Change Package

The following table describes the fields of the Create On Site Information panel (CMNCRT06), and the valid information that you can enter in the fields. In this field. . .

Type. . .

INSTALL DATE

Type the date that the package is scheduled to be Installed into production, year first, month, day yyyymmdd.

INSTALL TIME FROM

Type the time of day in hhmm format in which your change package Installation to begin, military format example 1600=4:00 p.m.

INSTALL TIME TO

Type the required time of day in hhmm format in which you want your change package installation to be completed.

1RWH7KLVILHOGPD\QRWEHDSSOLFDEOHGHSHQGLQJRQ\RXUVFKHGXOLQJ LQWHUYDO PRIMARY/ BACKUP CONTACTS

Type the names of the primary and back-up personnel, responsible for supporting the installation of this change package at each remote site (maximum character length = 25).

PHONE NUMBERS

Type the phone numbers of the primary and back-up personnel, responsible for supporting the installation of this change package at each site. (maximum character length = 15).

After you have completed typing information in the fields of the Create On Site Information panel (CMNCRT06), press ENTER. Change Man creates your package, displays the Create A New Package panel (CMNCRT01) and your package identification number appears in the upper right corner of the panel.

4-10

Change Man Version 4.1.6

Scheduling Installation Date and Time

A Remote Site Environment If your Change Man environment is a remote site, the Create Remote Site Information panel (CMNCRT07), similar to the following figure, appears when you press ENTER to save information that you entered on the Create Installation Instructions panel (CMNCRT03). CMNCRT07 -------------- CREATE: REMOTE SITE INFORMATION ------ Row 1 to 2 of 2 COMMAND ===> SCROLL ===> PAGE Press ENTER or END to create the package or type CANCEL to exit. Enter * in line command field for remote site selection list. REMOTE SITE ‘’’’ TEST____

INSTALL DATE/TIME YYYYMMDD FROM TO 19990628 0600 0700

PRIMARY/BACKUP CONTACTS PHONE NUMBERS Dave Barnhill____________ 323-742-6222___ Oscar Charleston_________ 323-742-6223___ ‘’’’ TEST2___ 19990628 0600 0700 Dave Barnhill____________ 323-742-6222___ Oscar Charleston_________ 323-742-6223___ ******************************* Bottomofdata********************************

If this application has been configured by the administrator to keep the baseline library by site, you must create a separate change package for each remote site. The Create Remote Site Information panel (CMNCRT07) might look similar to the following figure, which shows the remote sites where you change package will be installed. If it is necessary for you to change the remote site, you can enter the following information in the fields. In the field . . .

Type . . .

REMOTE SITE

Remote site at which to install the change package.

INSTALL DATE

The date (YYMMDD) the package will be installed on the remote site.

INSTALL TIME FROM

The time of day (HHMM) the change package installation will begin.

INSTALL TIME TO

The time of day (HHMM) in which you want your change package installation to be completed.

1RWH7KLVILHOGPD\QRWEHDSSOLFDEOHGHSHQGLQJRQ\RXUVFKHGXOLQJLQWHUYDO

Change Man User Guide

4-11

4 Creating a Change Package

In the field . . .

Type . . .

PRIMARY/ BACKUP CONTACTS

The names of the primary and back-up personnel, responsible for supporting the installation of this change package at each remote site (maximum character length = 25).

PHONE NUMBERS

The phone numbers of the primary and back-up personnel, responsible for supporting the installation of this change package at each remote site (maximum character length = 15).

After you have completed typing information in the fields of the Create Remote Site Information panel (CMNCRT07), press ENTER. Change Man creates your package and displays the Build Option menu (CMNBUILD) with your package identification number appearing in the upper right corner.

PACKAGE LEVELS When creating a new package from the Create A New Package panel (CMNCRT01), you can specify the package level of the package that you are creating. You select the package level in the Package Level field. The package levels are the following. Option

Package Level

Description

1

Simple

A simple change package is a component of a complex or a super change package. This level of change package does not affect any other application, or it does not require them to make any changes to their software or operational procedures.

4-12

Change Man Version 4.1.6

Package Levels

Option

Package Level

Description

2

Complex

You are creating the “parent” change package for two or more change package applications that have related or interdependent changes, or have major changes to application processing which result in a major impact on the data processing environment. Complex change packages contain only control, general information, and a list of the participating packages. There are no staging libraries associated with super/ complex change packages. Remote site and the installation dates for each site are tracked in the participating change packages. Once created, complex packages are automatically marked for limbo causing them to immediately display within the Monitor Packages in Limbo option. It is from this monitor function that their status is changed to closed

3

Super

A super change package is functionally equivalent to a complex package. Use super to draw attention to, or segregate, packages

4

Participating

A participating package is a variation of a simple package that allows an association to one or more additional participating packages.

Complex or Super Packages The Create Complex/Super Information panel allows you to enter the IDs for participating packages that comprise your complex or super change package.

Change Man User Guide

4-13

4 Creating a Change Package

1

Type 2 (Complex) or 3 (Super) in the Package Level field of the Create A New Package panel (CMNCRT01) and press ENTER. The Create Complex/Super Information panel (CMNCRT08) appears with the new package ID and the status of the package. For example, in the following figure, the new package ID is NAVI000013.

CMNCRT08 ------------- CREATE: COMPLEX/SUPER INFORMATION --- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE PACKAGE ID: NAVI000013

STATUS: OPN

Press ENTER to continue or type CANCEL to exit. PACKAGE ID ‘’’’ __________ ‘’’’ __________ ‘’’’ __________ ****************************** Bottom of data ********************************

2

In the Package ID column field, type the package ID of the participating packages that will be part of the complex or super package and press ENTER, or if you don’t have participating packages, press ENTER. When press ENTER, the information on the Create Complex/Super Information panel (CMNCRT08) is saved and the Build Options menu (CMNBUILD) appears and indicates that your new package has been created.

Participating Packages A participating package is a package that is related to one or more packages. Creating a participating package using the long method is very similar to creating a simple package using the same method. The difference is that you can assign affected applications to participating packages. If you select To create a participating package, take the following steps.

4-14

1

From the Change Man Primary Option Menu, select option 1 (Build). The Build Options panel (CMNBUILD) appears.

2

From the Build Options panel (CMNBUILD), select option 1. The Create a New Package (CMNCRT01) panel appears.

3

From the Select the method (short or long) that you wish to use for creating your new package.

4

Finish the Create General Information panel.

Change Man Version 4.1.6

Package Levels

5

Finish the Create Installation Instructions panel. The following panel displays.

CMNCRT05 --------------- CREATE: AFFECTED APPLICATIONS ----- Row 1 to 12 of 12 COMMAND ===> SCROLL ===> PAGE Press ENTER to continue or type CANCEL to exit. COMPLEX/SUPER PACKAGE ID ===> __________

‘’’’ ‘’’’ ‘’’’ ‘’’’

APPL ____ ____ ____ ____

1

In the COMPLEX/SUPER PACKAGE ID field, type the package ID of the complex or super package associated with this participating package.

2

In the APPL column field, type the applications affected by this package. If you enter a value in this field, Change Man adds to the approval list of the package in your current application any approver that differs (interfacing approver) from the planned approval list of the application you enter in this field. You specify interfacing approver when you set up your planned approval list in the Planned Approval panel (CMNCAPLD) during application parameter setup.

3

Press ENTER to save the information entered on the panel. When you press ENTER, to save your information, the Create On Site Information panel (CMNCRT06) or Create Remote Site Information panel (CMNCRT07) appears.

Change Man User Guide

4-15

4 Creating a Change Package

4-16

Change Man Version 4.1.6

UPDATING CHANGE PACKAGE INFORMATION

5

After creating a change package, you may wish to update some of the information associated with it. You can update most of the information entered during the creation process as long as the package you update has a Development (DEV) or Open (OPN) status and you have access to the project. You can browse the information if the package is in Frozen (FRZ) status.

UPDATING A CHANGE MAN PACKAGE To update a Change Man package, take the following steps: 1

From the Primary Option Menu, select option 1 (Build). The Build Options panel (CMNBUILD) appears.

2

From the Build Options panel (CMNBUILD), select option 2 (Update). The Update Package Information panel (CMNPGNL0) appears.

CMNPGNL0 ---------------- UPDATE: PACKAGE INFORMATION ------ INFORMATION SAVED OPTION ===> PACKAGE ID ===> NAVI000006 1 2 3 4 5 6 7 8 9

Control General Instruction Dependencies Affected Apps Complex/Super Install Dates Complex/Super Complex/Super

-

Update Update Update Update Update Update Update Change Change

package control information general description installation instructions job scheduling dependencies affected applications cmpx/supr package information install date and site information complex/super package to CLO status complex/super package to OPN status

Press ENTER to process; Enter END command to exit.

5-1

5 Updating Change Package Information

If you are using exit CMNEX 001, the installation date of a package in FRZ status can be updated through Option 2 (UPDATE) from the Build Options Menu; otherwise, you can only update the installation date of a package in DEV status. For Option 7, depending on how Change Man was generated, either the O option (onsite) or R option (remote site) is displayed. The scheduling record for a package is created at approve time. This means when a package in FRZ status is being implemented with the Change Man internal scheduler, updates to the install date of a package are captured. Provided you are using this scheduler at Approve time, the scheduling record is built with the latest install date originally entered or updated by the user.

CONTROL INFORMATION Use the Update Control Information panel to review the control information for a change package. Once packages are frozen or super/complex packages are closed, the panel displays in browse mode. To access the Update Control Information panel, select option 1 on the Update Package Information panel. CMNPGNL1 ---------------- UPDATE: CONTROL INFORMATION ------------------------COMMAND ===> PACKAGE ID: NAVI000006 COMPLEX/SUPER ID: NAVI000002

STATUS: DEV STATUS: OPN

INSTALL DATE: 19971230

PACKAGE TITLE ===> Package to install jcl for test REQUESTER’S NAME REQUESTER’S PHONE WORK REQUEST ID DEPARTMENT PACKAGE LEVEL

===> ===> ===> ===> ===>

PACKAGE TYPE PACKAGE TIME SPAN UNPLANNED REASON CODE TEMPORARY CHANGE DURATION

===> ===> ===> ===>

I.Programmer 555-1212 416NAVIG DP 4 (1-Simple, 2-Complex, 3-Super, 4-Participating) PLANNED PERM (* for list) (In days)

Press ENTER to process; enter END command to exit.

5-2

Change Man Version 4.1.6

Control Information

The following table describes the fields on the Update Control Information panel. Type in entries in each of the required fields. The only information that you are allowed to change is: the change package title; the requester’s name; the requester’s phone; the work request number; and the department Field

Description

PACKAGE TITLE

Type the title for the new change package that you are creating. Choose a title which is easily recognizable since it displays on package lists.

APPLICATION

Type the 3 or 4 byte application mnemonic for the change package you are creating.

REQUESTER’S NAME

Type the requester’s name.

REQUESTER’S PHONE

Type the requester’s phone number.

WORK REQUEST ID

Type the work request number.

DEPARTMENT

Type the department to which the requester belongs.

PACKAGE LEVEL

Simple The change package contains a change that is unrelated to any other change package. Complex and Super A complex or super package is the parent of two or more participating change packages. After you have created all participating change packages, someone is designated to create the complex or super package. It contains a list of the participating packages with the general and control information. It does not contain any of the components to be installed. Participating The change package is related to one or more other packages. All of these packages are considered to be participating with each other.

PACKAGE TYPE

Planned Scheduled changes that are required to follow all established application rules. This is the normal way to install changes. Unplanned Unscheduled changes, possible an emergency fix. Emergency packages bypass some of the application rules and have a separate approval list.

Change Man User Guide

5-3

5 Updating Change Package Information

Field

Description

PACKAGE TIME SPAN

Permanent Scheduled changes that update baseline and production libraries. Permanent changes are either planned or unplanned. This is the normal way to install changes. Temporary Changes that run for a predetermined length of time. Once that time has expired, Change Man automatically deletes the change. Temporary changes do not update baseline/production libraries. These changes are installed into a static override library. Temporary changes are either planned or unplanned.

UPDATING PACKAGE DESCRIPTION The Package Description panel (CMNPGNL2) allows you to review and update the description of the change package, the request number, name, phone number and department number of the person requesting or responsible for the change. 1

From the Update Package Information (CMNPGNL0), type the package ID of the package and select option 2. The Update Package Description (CMNGNL2) appears.

CMNPGNL2 ---------------- UPDATE: PACKAGE DESCRIPTION ------- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000012

STATUS: DEV

INSTALL DATE: 19990305

(minimum one line, maximum 46 lines) ‘’’’ this is a test changeman package: lifecycle_____________________________ ******************************* Bottom of data ********************************

2

5-4

From this panel, update the description. You can describe your change package using freeform narrative in the General Description area of the panel. Change Man limits you to 46 lines. Use the same commands as you do to edit lists, specifically: •

I to insert new (blank) rows.

•

R to repeat existing rows.

•

D to delete existing rows.

Change Man Version 4.1.6

Package Installation Instructions

3

Press Enter to save your changes and return to the Update Package Information panel.

PACKAGE INSTALLATION INSTRUCTIONS The Update Installation Instructions panel allows you to review and update the installation instructions and the problem contingency instructions for a change package. To accees the Update Installation Instructions panel, from the Build Option panel, type the package ID and select option. CMNPGNL3 ------------- UPDATE: INSTALLATION INSTRUCTIONS ---- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000005 CONTINGENCY ===> 1

SCHEDULER

STATUS: DEV

INSTALL DATE: 19971230

1-Hold production and contact analyst 2-Backout change, continue production 3-Other ===>

===> OTHER

(CMN, Manual or Other)

(minimum one line, maximum 46 lines) ‘’’’ Install using procedure #1._____________________________________________ ******************************* Bottom of data *****************************

Change Man User Guide

5-5

5 Updating Change Package Information

The following table describes the fields on the Update Installation Instructions panel. Field

Description

CONTINGENCY

Code that represents the action you want the operations staff to take if a problem is encountered while installing your change package:

1 - Hold production and contact analyst. Discontinue running the production jobs for your application until a supporting analyst can be reached for instructions.

2 - Back out (reject) change and continue production. Back out of the change package and continue running your application’s production jobs as normally scheduled.

3 - Other - Use if 1 and 2 above do not apply. Describe some other action to be taken if you encounter problems when installing this change package. This field has a maximum length of 44 characters. SCHEDULER

‡ &01 &KDQJH0DQKROGVWKHLQVWDOODWLRQXQWLOWKHGDWHDQG WLPH\RXVSHFLI\RQWKH5HPRWH6LWH6HOHFWLRQSDQHO ‡ 0DQXDO &KDQJH0DQLQVWDOOVWKHFKDQJHSDFNDJHDVVRRQDVLW SDVVHVILQDODSSURYDO ‡ 2WKHU 6SHFLI\VFKHGXOLQJLQVWUXFWLRQVIRUFKDQJHSDFNDJHV WKDWXVHDMREVFKHGXOHURWKHUWKHQ&01DQG0DQXDO

INSTALLATION INSTRUCTIONS

Freeform instructions on how your change package should be installed. These can include, but are not limited to, production job dependencies and change package installation dependencies. Each line has a maximum length of 72 characters and up to 46 lines are saved.

PACKAGE SCHEDULING DEPENDENCIES To accees the Update Scheduling Dependencies panel (CMNPGNL4), from the Build Option panel, type the package ID and select option 4 on the Update Package Information panel.

5-6

Change Man Version 4.1.6

Affected Applications

CMNPGNL4 -------------- UPDATE: SCHEDULING DEPENDENCIES ----- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000005

STATUS: DEV

INSTALL DATE: 19971230

SUCCESSOR PREDECESSOR ‘’’’ JOB3____ JOB1____ ******************************* Bottom of data *****************************

AFFECTED APPLICATIONS When you install a participating package, you need to know the other participating packages (affected packages) under the super and complex umbrella. To display these packages, perform the following: 1

Select Option 2 on the Build Options menu.

2

Type a participating change package ID and select Option 5 on the Update Package Information panel.

3

Press PF3 or type End after the Update Package Description panel has been displayed.

4

Press PF3 or type End after the Update Installation Instructions panel has been displayed.

5

Press PF3 or type End after the Update Scheduling Dependencies panel has been displayed. The Update Affected Applications panel appears.

Change Man User Guide

5-7

5 Updating Change Package Information

CMNPGNL5 --------------- UPDATE: AFFECTED APPLICATIONS ------ ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000006 COMPLEX/SUPER ID: NAVI000002

STATUS: DEV STATUS: OPN

INSTALL DATE: 19971230

APPL ‘’’’ BRP_ ******************************* Bottom of data *****************************

COMPLEX OR SUPER PACKAGE INFORMATION Complete the Complex/Super Information panel. 1

Select Option 2 on the Build Options menu.

2

Select Option 6 on the Update Package Information panel. The following panel displays.

CMNPGNL6 ------------- UPDATE: COMPLEX/SUPER INFORMATION -COMMAND ===>

ROW 1 TO 14 OF 14 SCROLL ===> PAGE

Press ENTER to process; enter END command to cancel. PACKAGE ID: NAVI000002

‘’’’ ‘’’’ ‘’’’ ‘’’’

STATUS: OPN

PACKAGE ID NAVI000001 NAVI000006 navi000005 __________

PACKAGE INSTALLATION AND SITE INFORMATION Depending on your site configuration there are two panels which you may encounter when providing site installation information: •

5-8

Remote Site Installation Information for locations which have remote sites

Change Man Version 4.1.6

Package Installation and Site Information

•

On Site Installation Information for locations which have only one site

Remote Site You use the Update Remote Site Information panel to choose the remote sites where your change package is to be installed, schedule the installation date and time of the change package and enter the name and phone number of the people responsible for the change. If this application has been configured by the administrator to keep the baseline library by site, a separate change package must be created for each remote site. Complete the Update Remote Site Information panel. 1

Select Option 2 on the Build Options menu.

2

Select Option 7 on the Update Package Information panel. The following panel displays.

CMNPRSTI -------------COMMAND ===>

REMOTE SITE INFORMATION ----------------------------SCROLL ===> PAGE

Press ENTER to process; enter END command to exit. Enter * in line command field for remote site selection list. PACKAGE ID: NAVI000005

CREATOR: WSER85

STATUS: DEV

REMOTE INSTALL DATE/TIME SITE YYYYMMDD FROM TO PRIMARY/BACKUP CONTACTS PHONE NUMBERS ‘’’’ remote1__ 19971230 0900 1800 Boss_____________________ x275___________ 0900 1600 Asst Boss________________ x276___________ ******************************* BOTTOM OF DATA ********************************

The following table describes the fields on the Remote Site Information panel.

Column

Description

LCMD (first column)

I to insert new (blank) rows R to repeat existing rows D to delete existing rows * to access remote site selection list

Change Man User Guide

5-9

5 Updating Change Package Information

Column

Description

REMOTE SITE

Type the remote site at which to install the change package.

INSTALL DATE

Type the date (in yyyymmdd format) the package will be installed on.

INSTALL TIME FROM

Type the time of day (in hhmm format) the change package installation will begin.

INSTALL TIME TO

Type the required time of day in hhmm format in which you want your change package installation to be completed. This field is not supported in the current release using the CMN scheduler.

PRIMARY/ BACKUP CONTACTS

Type the names of the primary and back-up personnel, respectively, who are responsible for supporting the installation of this change package for each remote site (maximum character length = 25).

PHONE NUMBERS

Type the phone numbers of the primary and back-up personnel, respectively, who are responsible for supporting the installation of this change package for each remote site (maximum character length = 15).

1

Update the rows of the list.

2

Type a * in the LCMD column of a desired row and press Enter to access the Remote Site Selection List. Select a remote site to add to this information panel. Once it is selected it is displayed in the Remote Site column.

3

Press Enter.

Single Site You use the Update Site Information panel to schedule the installation date and time of the change package and enter the name and phone number of the person(s) responsible for the change. Complete the Update Site Information panel. 1

5-10

Select Option 2 on the Build Options Menu.

Change Man Version 4.1.6

Package Installation and Site Information

2

Select option 7 on the Update Package Information panel. The following panel displays.

CMNONSTE ------------------ UPDATE: SITE INFORMATION ----------------------COMMAND ===> Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000006

CREATOR: WSER85

INSTALL

DATE AND TIME:

YYYYMMDD 19971230

FROM 0700

TO 1600

STATUS: DEV

PRIMARY/BACKUP CONTACTS Boss_____________________ Asst Boss________________

PHONE NUMBERS xt277__________ xt259__________

The following table describes the field of the Update Site Information panel. In this field . . .

Type . . .

LCMD (first column)

I, D, or R (See”Using Basic Edit Line Commands“ on page 3-8)

INSTALL DATE

The date (in yyyymm format) when the package is scheduled to be Installed.

INSTALL TIME FROM

The time of day (in hhmm format) when the change package installation will begin.

INSTALL TIME TO

The required time of day (in hhmm format) when you want your change package installation to complete. Note: This field may not be applicable, depending on your scheduling interval.

PRIMARY/ BACKUP CONTACTS

The names of the primary and back-up personnel, respectively, who are responsible for supporting the installation of this change package for each remote site (maximum character length = 25).

PHONE NUMBERS

The phone numbers of the primary and back-up personnel, respectively, who are responsible for supporting the installation of this change package for each remote site (maximum character length = 15).

Change Man User Guide

5-11

5 Updating Change Package Information

UPDATING PACKAGE STATUS FOR SUPER AND COMPLEX PACKAGES The Update Package Information panel provides two options for changing the status of a super or complex package from OPN to CLO, or from CLO to OPN. Select Option 8 to close a super/complex package. A message displays, informing you that the package status has been changed from OPN to CLO. Select Option 9 to reopen a super/complex package. A message displays, informing you that the package status has been changed from CLO to OPN.

5-12

Change Man Version 4.1.6

CHECKING OUT A COMPONENT

6

After creating a package, you must build the inner structure of the package. Checkout is the first step in building the inner structure. It is the process of copying components from secured libraries to your PDS (or sequential file) for either modification in a future change or for checking out to staging where it can be edited. If you associate the checkout to a valid change package ID, the component name is added to the package’s component list. If more than one user checks out the same component (associating to different packages), Change Man notifies all parties concerned. When you check out a component, the standard PDF statistics are carried forward and the version number (the vv portion of vv.mm) is incremented. Change Man adds the checkout information to the statistics that make up the component’s history.

CHECKOUT RESTRICTIONS, RULES, AND OPTIONS The flexibility of Change Man enables your global and application administrators to configure the checkout function with various restrictions, rules, and options, depending on the needs of your site. Check with your administrator for the settings at your site. The administrator may have implemented the following restrictions, rules, and options: •

Checkout can be restricted or denied for components that are already contained in a change package, disallowing checkout of a component that is part of a package in motion unless it is an unplanned change.

•

Change package contents are restricted to components that have been checked out. Change Man does not let the new components be staged. This means that those that do not already exist in Bbaseline cannot be staged.

•

Checkout is restricted to those components associated with a change package. Thus an existing package number must be entered during the checkout process to ensure that all components checked out are accounted for. (During the stage process, they are checked in.)

6-1

6 Checking Out a Component

If association to a change package is requested or required, Change Man checks for existence of the package and verifies that it is in DEV status and that its install date has not passed. •

Checkout can include third party vendor load modules, if they have been staged as a unique three character component type, and designated as 'LIKE P'.

•

Checkout can include components that reside in packages that are in promotion (if any exist for a given application).

•

Checkout can be performed in the foreground (online) or background (batch job).

•

DSORG of an external target data set can be SEQ or PDS. If it is SEQ, you can only choose one component.

•

If checkout to a Panvalet or Librarian library has been allowed, it must be done in background mode (a batch job).

•

You can request Change Man to show you where a component exists [i.e., at what baseline level(s)].

•

You can check out components by selecting them from a list of baseline libraries or promotion package components.

•

If checkout is associated with a change package, then each component may be checked out to that package one time only; that is, until the component is either staged or deleted from the package component list.

•

Checkout can be restricted to select user IDs or single entity names, letting only authorized users check out secured components.

•

For online and batch mode, when you choose to checkout to a target data set, or personal library, Change Man will check that the user requesting the service has update level security access to the library and that the data set is in the catalog.

•

Activity files are always checked out to staging libraries regardless of the data sets you specify as targets for components you checkout.

•

For batch mode only, when the target data set field for checkout is left blank, Change Man can automatically construct one in the following form: zprefix.zuser.component_name.component_type

6-2

Change Man Version 4.1.6

Checking Out Components

CHECKING OUT COMPONENTS To checkout components, take the following steps: 1

From the Build Options menu, select option 5 (Check Out). The Checkout Options panel (CMNMCKOT) appears..

CMNMCKOT ---------------------- CHECKOUT OPTIONS ---------------------------OPTION ===> 1 PACKAGE ID ===> NAVI000005 1 2

Base/Prom - Checkout from baseline or promotion libraries Package - Checkout package components

Press ENTER to process; Enter END command to exit.

2

From the Checkout Options panel (CMNMCKOT), you may select components residing in baseline or promotion libraries (option 1), or you may display and check out components that are already defined to your package (option 2).

Selecting Components from Baseline or Promotion Libraries To check out components from baseline or promotion libraries, from the Checkout Options panel (CMNMCKOT), select option 1. The Checkout panel (CMNCKOT1), similar to the following, appears.

Change Man User Guide

6-3

6 Checking Out a Component

CMNCKOT1 -------------------------- CHECKOUT ------------------------------OPTION ===> L - List libraries where component is located PACKAGE ID

===> NAVI000005 (Package name)

COMPONENT NAME LIBRARY TYPE LANGUAGE SOURCE LIBRARY

===> ===> JCL ===> ===> 0000

(Blank or pattern for list; * for all members) (Blank for list) (Applies to source code; * for list) (Baseline 0 to -n; Promotion +1 to +n)

CHECK OUT TO ===> S PERSONAL LIBRARY ===> LIBRARY DSORG ===>

(Personal library: PDS, PDSE, SEQ, PAN, LIB)

CONFIRM REQUEST CHECKOUT MODE LOCK COMPONENT

(Y/N) (1-Online, 2-Batch) (Y/N)

===> YES ===> 1 ===> YES

(S-Staging library, P-Personal library)

Press ENTER to process; Enter END command to exit.

You can copy components from baseline or promotion libraries to a sequential file or PDS. The copy may be performed online or as a batch job. All components will be checked out to either a staging or personal library. If any component already exists in the target PDS, the Checkout Warning panel is displayed for confirmation. Component historical information may be viewed using two different methods: type YES in the confirm request field or, at the component list, type the appropriate line commands on that panel. If the component is in motion, a warning panel (CMNCMPSW) shows and displays the other packages working on that component.

6-4

Change Man Version 4.1.6

Checking Out Components

If you wish to display a list of libraries where the specified component may be found, type the component name in the Component Name field and L at the command line. you typed a component in the Component Name field and the library type in the Library Type field. In this field. . .

Type. . .

PACKAGE ID

The change package ID with which the component will be associated. The package must be in DEV status. If your application does not require association with a change package, you may leave this field blank. If you associate the checkout to a change package, and baseline is kept by site for this application, the Remote Site Selection List is displayed. Change Man will use the remote site selected for the associated change package for the baseline library selection if you opt to checkout from a baseline level back. If you do not associate to a change package, the Remote Site Selection List will be displayed (if “baseline is kept by site”) regardless of your intended source library..

COMPONENT NAME

The name of the component that you wish to check out. You can use wildcards to mask the selection, for example, CMN* or CMN?0000 . To checkout all components from a specific library: type the library level in the source library field and type * in the component name field; indicate the location in checkout to field.

LIBRARY TYPE

The library type of the component to checkout. To display and select from a list of library types, leave this field blank.

LANGUAGE

The name of the language in which the source is written. This field is required for source (SRC) or like-source components. To select from a list of available languages names for a new component, leave this field blanks.

Change Man User Guide

6-5

6 Checking Out a Component

In this field. . .

Type. . .

SOURCE LIBRARY

The level of the library that you want to checkout from.

CHECK OUT TO

•

To select from baseline enter a level number from 0 to -999, depending on how many levels of baseline have been configured for your application. If baseline is kept by site for this application and you have not specified package association, the Remote Site Selection List will be displayed before selection of the baseline level back.

•

To select from promotion, enter a level number from +1 to +99, depending on how many levels of promotion have been configured for your application. The Promotion Library Selection List will be displayed for selection of the specific promotion library within the level specified.

•

To select from a list of libraries wherein a specific component can be found; leave location blank and enter the component name in the component name field. The Component Library List displays.

S (Checkout the component to a Change Man staging library.) P (Checkout the component to a personal development library.).

PERSONAL LIBRARY

6-6

The personal dataset name, if you typed P in the Check Out field. •

If you leave this field blank, Change Man builds a sequential data set as the default. If you are checking out only one component, you are not required to enter a file name. Change Man creates a sequential data set for you in the form specified in exit CMNEXINS .

•

If you specify a non-existing data set name in batch mode, you receive a message indicating that it was not cataloged. However, Change Man lets you continue, imbeds skeleton CMN $$ CKA , and allocates the data set using the library type attributes you specified when you set up the application. This only occurs during batch checkout; online checkout will issue an error message.

LIBRARY DSORG

The library’s dataset organization, if you typed P in the checkout to field. You may indicate a specific data set name (SEQ, PDS, PDSE) for a single component checkout. If the target data set is SEQ (and already exists), Change Man displays the Checkout Warning panel that it will overlay the previous SEQ data set.

CONFIRM REQUEST

Whether you want to be notified if the checked out components are going to overlay existing copies of the same components in the target library and whether you want to be notified of any concurrent development prior to checking out the component.

Change Man Version 4.1.6

Checking Out Components

In this field. . .

Type. . .

CHECKOUT MODE

1 - Online Checkout the component online.

2 - Batch Checkout the component in batch mode. LOCK COMPONENT

YES (Places an immediate lock on the component, thereby requiring an unlock before checkout or staging the component.)

NO ( Bypasses component locking._ UC (Unlocks a component, enabling checkout or staging of the component by another user.) You can also prevent any other user from checking out this component by ‘locking’ it with the Lock Component function on this panel. Alternatively, you can use unlock to unlock a component which is already locked. The lock component function is specific to one package. It does not cross packages. Batch checkout does not update the member’s ISPF statistics, but it does bypass the OVERLAY PRIOR STAGED MODULE administrative rule established at application set up. If a component is locked by another user, you must go to the Stage Package Driven List (See “Stage: Package Driven List” on page 7-22) to unlock the component prior to checkout.

Using the Package List to Select Componentst If components are already defined to your Change Package, you can select them by taking the following steps: 1

From the Build Options menu, select option 5. The Checkout Options panel (CMNMCKOT) appears.

2

From the Checkout Option panel (CMNMCKOT), select option 2. A Checkout panel (CMNCKOTS) similar to the following appears.

CMNCKOTS ---------------- CHECKOUT: NAVI000015 COMPONENTS ---- Row 1 to 2 of 2 COMMAND ===> SCROLL ===> PAGE NAME TYPE STATUS CHANGED LANGUAGE PROCNAME ID REQUEST __ CPXLOAD JCL CHECKOUT 19990707 123114 WSER83 __ IEBCOPY JCL ACTIVE 19990706 215107 WSER83 ******************************* Bottom of data ********************************

Change Man User Guide

6-7

6 Checking Out a Component

3

From the Checkout panel (CMNCKOTS), type S (select) in the command line of the component that you wish to forward from another package and press Enter. A Confirm Checkout Request panel, similar to the following, appears.

CMNCMPSW ------------------------- IEBCOPY.JCL --------------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE Press ENTER or END to process or enter CANCEL command to exit. This component is included in the following packages: PACKAGE ID STA PROMOTION VV.MM LAST ACTION SIZE PROCNAME ID NAVI000015 DEV 02.01 1999/07/06 21:51 31 WSER83 NAVI000005 DEV 02.02 1997/08/18 15:58 24 WSER85 NAVI000001 DEV 02.00 1997/08/13 13:45 24 WSER85 ******************************* Bottom of data********************************

The Confirm Checkout Request panel displays other active packages that contain the component and gives you a chance to cancel your requiest to checkout a component.

6-8

Change Man Version 4.1.6

STAGING A COMPONENT

7

After checking out components, you must use the stage function to edit components, compile and link edit a program, or to submit another transformation type of process. You use the staging function to copy components from development or personal libraries into Change Man staging libraries, or to re-stage components already in staging libraries. If the component type is source (SRC), like source (LIKE SRC), or other (OTHER), there is a subsidiary staging step so that you can define parameters for compile and link/edit procedures before generating the associated load component.

ADMINISTRATION PARAMETERS WHICH AFFECT STAGING Staging is the process of introducing components into change packages. Depending on how your administrator configures your global and application environments you can either copy newly developed components into change packages or be restricted to staging only components that were previously associated with a package. There are other parameters set by your administrator which affect staging. For instance, your administrator can set the following rules (that control how components can be staged and who can stage them. Staging Rule

Explanation

1

All users can stage new components. This means they can stage components that are not yet associated with a package (development driven staging) as well as stage component that are associated with a package (package driven staging).

2

Lets only users who have been defined (by the local administrator) to a special entity by their TSO ID stage new components. Otherwise, they can only checkout and stage components that are associated with a change package.

7-1

7 Staging a Component

Staging Rule

Explanation

3

Does not let you checkout and stage new components, only ones that already exist in your baseline library. This effectively disables development driven staging.

Generally, you checkout components from an application’s baseline libraries (with package association) to staging, stage them using the package driven staging option, and make modifications in staging. However, there may come a time when new components are developed for the application (not yet maintained in baseline); or if the application’s users are not required to checkout to an existing package, you checked out a component without package association and decide to include the modification in an existing change package. In these two cases, you would stage using the development driven staging option as described below. Your administrator can restrict editing of components to be within staging libraries only. This assists with version control of components.

ACCESSING THE STAGE OPTIONS PANEL To stage components, from the Build Option menu, select option 6 and press Enter. The Stage Options panel (CMSSTG00) appears. CMNSTG00 ----------------------- STAGE OPTIONS -------------------------------OPTION ===> PACKAGE ID ===> NAVI000015 1 2 3

Dev Package Parms

- Stage components from development libraries - Process package components - Specify component list selection criteria

Press ENTER to process; Enter END command to exit.

This panel is seen only if all the following apply:

7-2

•

The application parameters are generated with the stage restriction Level of 1 or 2

•

You have appropriate security access

•

You are allowed to stage new components (development driven)

Change Man Version 4.1.6

Staging from Development

STAGING FROM DEVELOPMENT The Stage from Development panel (CMNSTG02) allows you to copy components into a change package, that in most cases do not exist in the baseline libraries. This panel allows to specify the components that you wish to stage from a development library. To access Stage from Development panel, select option 1 from the Stage Option panel and press Enter. CMNSTG02 ------------------ STAGE: FROM DEVELOPMENT --------------------------COMMAND ===> PACKAGE ID: NAVI000015 ISPF LIBRARY: PROJECT ===> WSER85 GROUP ===> STUFF TYPE ===> JCL MEMBER ===>

STATUS: DEV

INSTALL DATE: 19990711

(Blank or pattern for list; * for all members)

OTHER PARTITIONED OR SEQUENTIAL DATASET: DATASET NAME ===> ORGANIZATION ===> (PDS, SEQ, PAN, LIB, OTH) LIBRARY TYPE LANGUAGE STAGE NAME CONFIRM REQUEST STAGE MODE SUPPRESS MESSAGES

===> ===> ===> ===> YES ===> 2 ===> YES

(Blank for list) (Blank for list; applies to source code) (Optional if organization not SEQ) (Y/N) (1-Foreground, 2-Batch) (Y/N; applies to batch stage)

Press ENTER to process; Enter END command to exit.

The following table describes the fields of the Stage from Development panel. Type information in the required fields and press Enter to process to the next panel, or leave some of the fields blank and select from the resultant lists. In this field . . .

Type . . .

MEMBER

Name of the member to stage, component name pattern (the Stage Development Component List panel appears), or * (to stage all the components in the development library). If you leave this field blank, a list of all members within the dataset appears.

Change Man User Guide

7-3

7 Staging a Component

In this field . . .

Type . . .

DATASET NAME

Name of the dataset that contains the components to be staged. Enclose the dataset name in quotes (’dataset name’). •

If the development library is a PDS, Panvalet library, Librarian master or any other type of library organization, and if you are copying all the components, append * to the data set name.

•

If you are copying just one component, enclose the component name in parentheses and append it to the data set name.

•

If you don't append anything to the data set name, Change Man displays a component list for you to select from.

ORGANIZATION

The type of library organization (PDS, SEQ, PAN, LIB, or OTHer) from which you are staging.

LIBRARY TYPE

The component that you wish to stage. •

If your development library organization is SEQ, leave the Member field blank.

•

If your development library organization is PDS, PAN, LIB, or any other type, you must specify library type

Leave blank to display the Library Type Selection List panel (CMNSTG08), which allows you to select the library type. LANGUAGE

Source code language, if the component is SRC or like-SRC, or leave blank to display a language selection list..

STAGE NAME

The name of a components to be staged from a sequential dataset. If you are copying components of a PDS, PAN, LIB or any other type of library organization, Change Man assigns the same names to the copied components in its Staging Library. If you want the component name in the Change Man Staging Library to be different from the name it has in your development library, type the name.

CONFIRM REQUEST

Yes (To display a list of packages that contain the component that you are requesting to be staged. Also, to activate confirmation panels for component checkout, stage, and delete.) No (To bypass the above functions.)

STAGE MODE

1 (To stage online.) 2 (To stage in batch mode).

SUPPRESS MESSAGES

Yes (To suppress message sent to your screen from the batch stage.) No (To receive messages from the batch stage.).

After entering the appropriate information on the Stage from Development panel (CMNSTG02), press Enter.

7-4

Change Man Version 4.1.6

Staging from Development

•

If you left the Library Type field blank, then the Library Type Selection List (CMNSTG08) appears. Place an S beside the library type you want to select.

CMNSTG08 ---------------- LIBRARY TYPE SELECTION LIST ------ Row 1 to 20 of 27 COMMAND ===> SCROLL ===> PAGE

_ _ _ S _ _

LIB CLS CPY CP1 CTC DOC GDG

DESCRIPTION COMPAREX 8.2.0 CLIST LIBRARY Copybooks Like-CPY (1) Control Cards Documentation GENDLG -Genned ISPF Dialog panels

•

If you left the Member field blank or did not include a member name in the Dataset Name field, then all members within the dataset name appears on the Stage Development Component List panel (CMNSTG03). Place an S beside the component that you want to stage or copy into the package.

CMNSTG03 M - WSER83.TEST.JCL ------------------------------- Row 1 to 21 of 66 COMMAND ===> SCROLL ===> PAGE NAME FUNCTION VV.MM CREATED CHANGED SIZE INIT ID _ #VARLIST 01.00 1997/07/08 1997/07/08 13:37 1511 1511 WSER85 _ @CMN100 01.00 1994/08/24 1995/04/26 16:22 503 503 C41037 _ ALLOC 01.01 1996/08/07 1996/08/07 18:00 70 32 WSER23 _ API 01.14 1995/10/02 1996/07/30 15:49 54 58 WSER56

Change Man User Guide

7-5

7 Staging a Component

•

If you select a SRC type library, then the Stage Compile and Link Edit panel (CMNSTG04) appears.

CMNSTG04 ---------------- STAGE: COMPILE AND LINK EDIT -----------------------COMMAND ===> PACKAGE ID: NAVI000011

STATUS: DEV

STAGED NAME: LIBRARY TYPE: LANGUAGE: DATASET NAME:

CPXLOAD SRC - Source Code ASM WSER83.TEST.JCL

COMPILE PROCEDURE COMPILE PARMS LINK EDIT PARMS DB2 PRE-COMPILE OTHER OPTIONS

===> CMNASM ===> ===> ===> NO ===>

INSTALL DATE: 19990711

(Blank for list; ? for designated procedure)

(Y/N) (Y/N to display other options)

JOB STATEMENT INFORMATION: ===> //WSER83W JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=WSER83,TIME=1 /*JOBPARM S=ESA5 //PROCLIB JCLLIB ORDER=(WSER99.CMN416Q.QACUST.SKELS)____________________

7-6

Change Man Version 4.1.6

Staging from Development

•

If you typed * in the Member field or appended * to the dataset name, and SRC is the library, then the Stage Mass Compile and Link Edit panel (CMNSTG05) appears.

CMNSTG05 ------------- STAGE: MASS COMPILE AND LINK EDIT ---------------------COMMAND ===> PACKAGE ID: NAVI000011

STATUS: DEV

LIBRARY TYPE: LANGUAGE: DATASET NAME:

SRC - Source Code ASM WSER83.TEST.JCL

COMPILE PROCEDURE COMPILE PARMS LINK EDIT PARMS DB2 PRE-COMPILE OTHER OPTIONS SUPPRESS HISTORY

===> ===> ===> ===> ===> ===>

INSTALL DATE: 19990711

CMNASM

(Blank for list)

NO YES NO

(Y/N) (Y/N to display other options) (Y/N to use above criteria for all selected components in place of any history data)

JOB STATEMENT INFORMATION: ===> //WSER83W JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=WSER83,TIME=1 /*JOBPARM S=ESA5 //PROCLIB JCLLIB ORDER=(WSER99.CMN416Q.QACUST.SKELS)____________________

Stage Development Component List From the Stage From Development panel (CMNSTG02), if you left the Member field blank, and pressed Enter. The Stage Development Component List panel (CMNSTG03) appears. CMNSTG03 M - WSER85.TEST.JCL -------------------------------- ROW 1 TO 4 OF 4 COMMAND ===> SCROLL ===> PAGE NAME FUNCTION VV.MM CREATED LAST MODIFIED SIZE INIT ID _ CPXLOAD 01.01 1996/08/27 1996/08/28 10:35 16 16 WSER23 _ HOUSKEEP 01.00 1997/06/25 1997/06/25 15:11 460 460 WSER85 _ IEBCOPY 01.11 1996/08/13 1996/08/30 12:29 24 15 WSER23 _ REPORTS 01.00 1995/04/26 1995/04/26 16:22 122 122 C41037 ******************************* Bottom of data ******************************

Change Man User Guide

7-7

7 Staging a Component

From the Stage Development Component List panel, you can use any of the following line commands: Line Command (type in any row of the list)

Description

S

To stage to the staging library.

M

To put selected members into a member list, which is then passed to mass stage processing. mass stage gets the appropriate language and compile procedure from the component history record.

E

Does not let you checkout and stage new components, only ones that already exist in your baseline library. This effectively disables development driven staging.

B

To edit a component in the development library

H

To review the history of the component. If the component has ever been checked out or staged within Change Man, the history panel appears.

The following primary commands can be issued on the Stage Development Component List panel: Stage All - All the components of the list will be staged. The Stage Mass Compile and Link Edit panel displays. (See ”Stage Compile and Link Edit Panel“ on page 7-8). Stage - Only components flagged with an S will be staged. NOTES If the M and S commands are intermixed, all members selected by M or S will be mass staged.

Stage Compile and Link Edit Panel This Stage Compile and Link Edit panel (CMNSTG04) allows you to indicate how a source code module is to be compiled and link edited. Change Man uses its staging, promotion and application baseline libraries for COPYLIB components and MACROs needed during the compilation or assembly of your component. Make sure that you have already staged any new or changed COPYLIB components and/or MACROs that you want included when your component is compiled or assembled.

7-8

Change Man Version 4.1.6

Staging from Development

Change Man does not require that you link edit a component to stage it into the staging libraries. But, if any of the source code components in your change package has not been both compiled and link edited, you cannot freeze the change package. CMNSTG04 ---------------- STAGE: COMPILE AND LINK EDIT -----------------------COMMAND ===> PACKAGE ID: NAVI000011

STATUS: DEV

STAGED NAME: LIBRARY TYPE: LANGUAGE: DATASET NAME:

CPXLOAD SRC - Source Code ASM WSER83.TEST.JCL

COMPILE PROCEDURE COMPILE PARMS LINK EDIT PARMS DB2 PRE-COMPILE OTHER OPTIONS

===> CMNASM ===> ===> ===> NO ===>

INSTALL DATE: 19990711

(Blank for list; ? for designated procedure)

(Y/N) (Y/N to display other options)

JOB STATEMENT INFORMATION: ===> //WSER83W JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=WSER83,TIME=1 /*JOBPARM S=ESA5 //PROCLIB JCLLIB ORDER=(WSER99.CMN416Q.QACUST.SKELS)____________________

Type in values in each of the required fields. The table below may help you complete the fields on the panel. Field

Description

STAGED NAME

Component’s name in the Change Man staging library.

DATASET NAME

Displays the name of the data set that contains the component you are staging.

COMPILE PROCEDURE

Type the Change Man compile procedure to use to compile/link the program. If only one procedure is available for the language, this field is in “browse only” mode. To use the compile procedure and options designated by your application administrator enter a? . The appropriate procedure and options are displayed in the related fields.

COMPILE PARMS

The various compile parameters that you want in addition to the ones specified in the compile procedure (for non-designated component procedures).

Change Man User Guide

7-9

7 Staging a Component

Field

Description

LINK EDIT PARMS

The various linkage edit parameters that you want in addition to the ones specified in the compile and link edit procedure (for nondesignated component procedures).

DB2 PRECOMPILE

YES If you want to process your program source using the DB2 precompiler. (The Stage: DB2 Physical Subsystems panel is then displayed.)

NO Do not use the DB2 precompiler. OTHER OPTIONS

Yes or No if additional user options are needed. If you type Yes , Change Man displays the Stage User Options panel (CMNUSR 01 ).

Press Enter. If batch stage has been selected, then a job will be submitted (the API job) which will in turn submit a compile and link edit if this is a source component. Should multiple source components be batch staged, then multiple compile and link edit jobs will be submitted with the job name incrementing to the next letter for each job submitted (A then B then C etc.). If you selected another component to be staged, the Stage: Compile and Link Edit panel is displayed again for the next component you selected. Otherwise, Change Man returns you to either Stage from Development panel or Stage Options panel.

7-10

Change Man Version 4.1.6

Staging from Development

User Options If you typed Yes, in the Other Options field of the Stage Compile and Link Edit panel (CMNSTG04), the following panel appears when you have finished entering information in the panel and pressed Enter. CMNUSR01 -------------------- STAGE: USER OPTIONS ----------------------------COMMAND ===> NAME: ALLIO COMPILE ONLY CICS PRE-COMPILE EASYTRIEVE NO NAME USER OPTION 07 USER OPTION 09 USER OPTION 11 USER OPTION 13 USER OPTION 15 USER OPTION 17 USER OPTION 19

TYPE: SRC ===> ===> ===> y ===> n ===> n ===> ===> ===> ===> ===>

LANGUAGE: ASM ENTRY TO DLITCBL DROP INCLUDE STMTS USER OPTION 06 USER OPTION 08 USER OPTION 10 USER OPTION 12 USER OPTION 14 USER OPTION 16 USER OPTION 18 USER OPTION 20

===> ===> ===> y ===> y ===> n ===> ===> ===> ===> ===>

Use Y or N to select or deselect additional processing options; Press ENTER to continue; Enter END command to exit.

The Stage User Options panel (CMNUSR01) allows you to incorporate up to 20 additional user options within a Change Man compiling procedure. The variables are passed when the skeleton is file tailored.. Request to expand a user option within the skeleton by typing either a Y or N next to any row of the list.

Change Man User Guide

7-11

7 Staging a Component

MASS COMPILE AND LINK EDIT COMPONENTS If you type an * , in the Member field of the Stage From Development panel (CMNSTG02), finished entering the appropriate information in the other fields of the panel and pressed Enter, the Stage Mass Compile and Link Edit panel (CMNSTG05) appears. CMNSTG05 ------------- STAGE: MASS COMPILE AND LINK EDIT ---------------------COMMAND ===> PACKAGE ID: NAVI000011

STATUS: DEV

LIBRARY TYPE: LANGUAGE: DATASET NAME:

SRC - Source Code ASM WSER83.TEST.JCL

COMPILE PROCEDURE COMPILE PARMS LINK EDIT PARMS DB2 PRE-COMPILE OTHER OPTIONS SUPPRESS HISTORY

===> ===> ===> ===> ===> ===>

INSTALL DATE: 19990711

CMNASM

(Blank for list)

NO YES NO

(Y/N) (Y/N to display other options) (Y/N to use above criteria for all selected components in place of any history data)

JOB STATEMENT INFORMATION: ===> //WSER83W JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=WSER83,TIME=1 /*JOBPARM S=ESA5 //PROCLIB JCLLIB ORDER=(WSER99.CMN416Q.QACUST.SKELS)____________________

7-12

Change Man Version 4.1.6

Staging from Packages

Staging Other Type Components Panel This panel is used to enter the job statement information for staging other library types. Other library types refer to the library types within the global and application library type lists that have no value entered under the like field. CMNSTG09 ----------------- STAGE: OTH COMPONENTS -----------------------------COMMAND ===> PACKAGE ID: NAVI000005

STATUS: DEV

INSTALL DATE: 19971230

DATASET NAME: WSER85.TEST.JCL LIBRARY TYPE: OTH JOB STATEMENT INFORMATION: ===> //WSER85I JOB (X170,374),’CHANGE MAN’, ===> // MSGCLASS=9,NOTIFY=WSER85,TIME=1 ===> /*JOBPARM S=ESA5 ===> // JCLLIB ORDER=(WSER85.CHGMAN.PROCLIB)

PAGE Press END command to exit. PACKAGE ID: NAVI000005

STATUS: DEV

INSTALL DATE: 19971230

SOURCE NAME: ALLIO LIB TYPE: SRC SETSSI: 84561254 RELATED LOAD MODULES: NAME ALLIO

TYPE STATUS LOD ACTIVE

Change Man User Guide

PROMOTION 1

CHANGED 19970701

ID SETSSI WSER85 84562236

7-15

7 Staging a Component

This is an information panel for viewing. Once you have browsed the information, press PF3 or type End . You are returned to the Stage Package Components panel.

User ID Work List Panel This panel displays when you enter UL as a line command for a component on the Stage Package Components panel. It displays all the user IDs that have acted on the selected component.

Staging Using Package Parameters With staging option 3, you can use the following entities to narrow the package driven list:

7-16

•

Component name

•

Component type

•

Component status

•

Changed from and to dates

•

Language name for SRC or LIKE SRC components

•

Procedure name

•

TSO ID

•

List display mode

Change Man Version 4.1.6

Staging from Packages

Component List Parameters With option 3 you can filter those components that will be displayed (based on the criteria given on the panel) when the package driven list (option 2 package) is selected from the Stage Options panel. CMNSTG12 ----------------- COMPONENT LIST PARAMETERS ----------------------OPTION ===> PACKAGE ID: NAVI000005

STATUS: DEV

SPECIFY SELECTION CRITERIA: COMPONENT NAME ===> IEBCOPY COMPONENT TYPE ===> JCL LANGUAGE ===> COMPONENT STATUS ===> 1 CHANGED FROM DATE TO DATE COMPILE PROCEDURE TSOID SHORT OR LONG DISPLAY CONFIRM REQUEST SUPPRESS MESSAGES COMPARISON REPORT

===> ===> ===> ===> ===> ===> ===> ===>

WSER85 L YES YES NO

INSTALL DATE: 19971230

(1-Active, 2-Incomplete, 3-Checkout, 4-Inactive) (YYYYMMDD) (YYYYMMDD)

(S-Short, L-Long) (Y/N) (Y/N; applies to batch stage) (Y/N; applies to edit in stage)

Press ENTER to process; Enter END command to exit.

Type in entries in each of the required fields. The table below may help you complete the fields on the panel. Field

Description

COMPONENT STATUS

Type the status of the components to display.

CHANGED FROM/ TO DATE

Type the range of dates in yyyymmdd to view a list of components that have been changed with in the specified period.

COMPILE PROCEDURE

Type the compiling procedure for the components to be displayed.

TSOID

Type the user ID to display all components that belong to the specific user ID.

Change Man User Guide

7-17

7 Staging a Component

Field

Description

SHORT OR LONG DISPLAY

Short Type S to display the basic information: name, library type, status, change date and time, language, procedure name, ID, and request. Long Type L to display data set organization, data set name, and target loadlib, in addition to the information displayed by entering S .

CONFIRM REQUEST

YES Before you stage a component, a panel displays information about the pending stage so that you can confirm your actions. The panel display also includes historical information about the component you are staging, lists of other packages that contain the component you are Staging, confirmation panels for all component deletions, and also controls the display of confirmation messages for staging functions.

NO Bypasses confirmation panels for all staging activities, but might improve processing time for component staging.

1RWH$VRIYHUVLRQWKLVILHOGQRORQJHUFRQWUROVWKHGLVSOD\RIWKHFRPSDULVRQUHSRUW SUPPRESS MESSAGES

Indicate whether you want to receive messages during batch staging.

COMPARISON REPORT

Indicate whether you want to display the comparison report. The display will be immediately followed by a screen offering print options.

7-18

Change Man Version 4.1.6

AUDITING PACKAGES

8

HOW AUDIT WORKS After staging a change package, you can inspect the contents of the package staging library. The Change Man Audit function performs this inspection and generates a report of the results. You can inspect the contents of your staging library for specific information about the: •

Staging library only

•

6WDJLQJOLEUDU\DQGWKHFRQWHQWVRIWKHEDVHOLQHOLEUDULHVDVVRFLDWHG ZLWKWKHFKDQJHSDFNDJH

Audit searches for problems such as: •

$SDFNDJHWKDWVKRZVQRFKDQJHIURPWKHEDVHOLQHOLEUDU\

•

A package containing a load component that does not match its source component

After the audit is complete, you use the Audit report to identify and repair out-of-synch problems. Identifying out-of-synch conditions lets you detect code that is inconsistent with your development procedures, as well as other code problems. Your Change Man administrator sets the highest audit return code to accept when setting your site and application level parameters. Before a package can be frozen, it must pass an audit with an acceptable level of out-of-synch conditions. Under emergency conditions when your package must pass an audit so that it can be frozen, your administrator can implement a user exit that enables you to pass the audit with return codes that are normally prohibitive. See your administrator for further information on this feature.

8-1

8 Auditing Packages

AUDIT OPTIONS You can audit: •

A simple package

•

A group of participating packages as a subset of a complex or super package based on install date

•

A complete complex or super package including all participating packages defined in it

You can set options for an audit of any complex or super package to: •

Include all participating packages defined to a complex or super package in the audit

•

Exclude specific participating packages based on install date

•

Report out-of-synch conditions for only one participating package out of several participating packages being audited

•

Report out-of-synch conditions for all (or a selected subset) of the participating packages in a complex or super package

•

Audit a participating package as a simple package

Audit: •

Associates all components with their corresponding package

•

Auto-resolves selected out-of-synch conditions for all participating packages in the complex or super package configuration at your request

THE AUDIT CHANGE PACKAGE PANEL The Audit Change Package panel (CMNAUDIT) lets you submit an audit for your change package. To access this panel, from the Build Options menu, select option 7.

8-2

Change Man Version 4.1.6

The Audit Change Package Panel

CMNAUDIT---------------------- AUDIT CHANGE PACKAGE ---------------------------PACKAGE ID AUDIT STAGING LIBRARIES ONLY AUTO RESOLVE OF OUT-OF-SYNCHS INCLUDE HISTORY RECORDS FORMAT REPORT FOR PRINTING AUDIT PARTICIPATING PACKAGE AS A SIMPLE PACKAGE AS A PRIMARY PACKAGE BY DEPARTMENT NUMBER CROSS APPLICATION AUDIT

===> ===> ===> ===> ===>

NAVI000011 NO NO NO NO

(Y/N) (Y/N) (Y/N) (Y/N)

===> ===> ===> ===>

NO NO NO NO

(Y/N) (Y/N) (Y/N) (Y/N) - (Simple package only)

JOB STATEMENT INFORMATION: ===> //WSER83G JOB (X170,374),’CHANGE MAN’, ===> // MSGCLASS=9,NOTIFY=WSER83,TIME=1 ===> /*JOBPARM S=ESA5 ===> // JCLLIB ORDER=(WSER83,CHGMAN.PROLIB)

Description of member from directory entry in library - (CPY) * ************************************************************************************************************************************ *--------------------- B a s e l i n e ---------------------* *---------------------- S t a g i n g ----------------------* ************************************************************* *************************************************************

The following table describes the contents of the baseline and staging areas of an Audit report.

Baseline (left side)

Staging (right side)

Contains a subset of components residing in baseline Level 0 (copy for example 1), listed alphabetically.

Contains all components residing in the package’s staging library (copy for example 1) listed side by side with their corresponding entries in the baseline section.

If a component is listed only in the baseline section, the component has not been included in the change package.

If a component is listed only in the staging section, the component is new (has never been processed by Change Man).

Packages that are not in the package master have a status of D/A (deleted or archived).

Component History Area The following portion of an audit report contains the “Component History” area. Change Man (4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 ************************************************************************************** *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> History of changes for audited components * ************************************************************************************** *------------------ C o m p o n e n t H i s t o r y - CPY -----------------* *******************************************************************************

8-16

Page 2

Change Man Version 4.1.6

Example 2: Fields in the Three Layout Areas: Copy Report Section

EXAMPLE 2: FIELDS IN THE THREE LAYOUT AREAS: COPY REPORT SECTION Baseline and Staging Area Fields: Copy The columns in the following report are the ISPF statistics in the PDS directory. They are very similar to ISPF browse or edit headings.

******************************************************************************** * WSER46$1(JOB08235) - AUDITRPT ********************************************************************************

Change Man

(4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 Page 1 ************************************************************************************************ *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> Description of member from directory entry in library - (CPY) * ************************************************************************************************************************************ *--------------------- B a s e l i n e ---------------------* *---------------------- S t a g i n g ----------------------* ************************************************************* ************************************************************* Name VV.MM Created Changed Size Init Tso-id Name VV.MM Package Changed Size Dept Tso-id ________ _____ __________ ________________ ____ ____ ________ ________ _____ __________ ________________ ____ ____ ________ CMN#PXPL 01.00 1996/10/24 1998/08/19 18:37 0211 0190 C41720 CMN#PXPL 02.01 C417000030 1998/11/08 15:15 0221 00 WSER46 CMN@CCOP 01.00 1996/10/24 1998/07/17 14:34 0359 0306 C41715 CMN@CCOP 02.01 C417000030 1998/11/06 13:33 0455 00 WSER03 CMN@DINF 01.00 1996/10/24 1998/07/17 15:37 0307 0304 C41715 CMN@DINF 02.01 C417000030 1998/11/06 13:39 0337 00 WSER03 CMN@PALU 01.00 1998/06/22 1998/07/21 12:41 0355 0350 C41715 CMN@PALU 02.01 C417000030 1998/11/06 18:12 0359 00 WSER124 CMN@PGDC 01.00 1996/10/24 1998/07/17 15:40 0181 0173 C41715 CMN@PGDC 02.01 C417000030 1998/11/13 16:44 0185 00 WSER03 CMNBLAY5 01.00 1996/01/26 1998/10/27 15:07 0167 9440 C41725 CMNBLAY5 02.02 C417000030 1998/11/11 16:16 0177 00 WSER42 CMNBTSRT 01.00 1996/01/26 1996/10/28 14:42 0064 0064 C41601 CMNBTSRT 02.01 C417000030 1998/11/11 13:52 0064 00 WSER124 CMNRLPCA 01.00 1996/05/01 1998/10/30 13:24 3637 1315 C41725 SYNCH10! CMNRLPCA 02.01 C417000030 1998/11/06 13:40 3641 00 WSER03 CMNRVARC 01.00 1998/07/17 1998/11/02 13:00 0330 0327 C41725 CMNRVARC 02.01 C417000030 1998/11/08 15:17 0337 00 WSER46

Descriptions for each column in the copy Audit Report section are in the following table.

Column

Description

NAME

The name of the component.

VV.MM

The version and modification number for the component following the IBM standards (mm starts at 01, increments to 99 and stays there; vv starts at 01, increments to 99 and then recycles to 01). The first time the component is processed by Change Man the vv.mm is 01.01. Each successive stage request (within the same change package) increments the mm portion (01.02, 01.03 and so on.). The next package using the component causes the vv portion to be incremented (02.01). If an existing library is added to Change Man the vv.mm is not reset.

CREATED

The date in yyyy/mm/dd format that the component was first included in the Change Man system.

Change Man User Guide

8-17

8 Auditing Packages

Column

Description

CHANGED

The date in yyyy/mm/dd format of the most recent change to the component residing in current production (on the staging side of the report this would be the most recent staged date).

SIZE

The number of lines of text data.

INIT

The size of the component when first created (version 01.01).

TSO-ID

The TSO identification of the person responsible for this component’s version and modification (vv.mm). Note For CA-PANVALET library components, this field displays the USER and LANG TYPE because CA-PANVALET does not have a true directory for CMNIFACE to read for the TSO-ID.

PACKAGE

The name of the participating package where the component resides.

DEPT

The department number field, which is filled in when a new package is created from the Package Create panel.

The description for an additional field located in the center of the copy Audit Report section follows.

Column

Description

FLAG!

The FLAG! indicator area between the baseline and staging areas of an Audit report shows any audit problems. The last page of the report describes each flag and shows the total number of times each flag type was encountered. ‡

,QWKHVDPSOHDERYHWKHFRPSRQHQW&3 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> Description of member from directory entry in library - (SRC) * ************************************************************************************************************************************ *--------------------- B a s e l i n e ---------------------* *---------------------- S t a g i n g ----------------------* ************************************************************* ************************************************************* Name VV.MM Created Changed Size Init Tso-id Name VV.MM Package Changed Size Dept Tso-id ________ _____ __________ ________________ ____ ____ ________ ________ _____ __________ ________________ ____ ____ ________ CMNADMSO 01.00 1996/01/26 1998/10/27 09:04 5115 5525 C41721 CMNADMSO 02.02 C417000030 1998/11/13 13:26 5120 00 WSER42 CMNAPPRV 01.00 1996/05/09 1998/10/16 11:15 5284 5433 C41725 CMNAPPRV 02.01 C417000030 1998/11/13 16:02 5287 00 WSER03 CMNAPS20 01.00 1996/01/26 1998/10/28 14:06 1170 1139 C41725 CMNAPS20 02.01 C417000030 1998/11/10 10:02 1186 00 WSER42 CMNAUD20 01.00 1996/10/25 1998/10/29 10:35 3297 6103 C41725 CMNAUD20 02.01 C417000030 1998/11/10 18:28 3299 00 WSER117 CMNBAT10 02.01 1996/05/09 1997/10/24 14:40 7050 7030 WSER42 CMNBAT10 03.01 C417000030 1998/11/11 13:53 7016 00 WSER124 CMNBAT40 01.00 1996/01/26 1997/09/16 17:01 0848 0821 C41610 CMNBAT40 02.01 C417000030 1998/11/11 17:29 0868 00 WSER03 CMNBRWLG 01.00 1996/05/09 1998/10/26 14:29 1655 1612 C41725 CMNBRWLG 02.01 C417000030 1998/11/12 10:17 1655 00 WSER42 CMNCICS1 01.01 1996/01/26 1998/05/27 21:50 1061 0936 SERSTAR CMNCICS1 02.01 C417000030 1998/11/13 09:55 1095 00 WSER42 CMNCKOUT 01.00 1996/01/26 1998/11/03 17:13 7655 5229 C41725 SYNCH10! CMNCKOUT 02.07 C417000030 1998/11/16 15:09 7709 00 WSER31 CMNCMPNT 01.00 1996/01/26 1998/11/04 15:19 1323 1017 C41725 CMNCMPNT 02.01 C417000030 1998/11/06 18:17 1333 00 WSER42

Change Man User Guide

8-19

8 Auditing Packages

The fields in the baseline and staging areas of the source section of an Audit Report are the same as the fields in the copy section of an Audit Report.

Component History Area Fields: Source The component history area for the source section of an Audit Report follows: Change Man (4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 ************************************************************************************** *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> History of changes for audited components * **************************************************************************************** *---------------------- C o m p o n e n t H i s t o r y - SRC ----------------------* **************************************************************************************** Name VV.MM Procedure Changed Size Tso-id Package Status Setssi ________ _____ _________ ________________ ____ ________ __________ ______ ________ CMNADMSO 02.12 CMNASM 1996/03/07 16:30 5585 WSER15 C415000004 BAS 440F0658 CMNADMSO 02.03 CMNASM 1996/05/16 19:03 5587 WSER20 C415000005 BAS 446B7355 CMNADMSO 03.08 CMNASM 1996/06/13 11:54 5590 WSER15 C415000007 BAS 448FF8AC CMNADMSO 04.03 CMNASM 1996/08/26 18:42 5597 WSER42 C415000008 BAS 44F1E757 CMNADMSO 02.19 CMNASM 1996/10/30 10:49 0402 WSER03 C416000001 BAS 454729AC CMNADMSO 02.03 CMNASM 1996/11/25 12:01 0405 WSER42 C416000002 BAS 456981FF CMNADMSO 02.04 CMNASM 1996/12/09 14:53 5106 WSER42 C416000003 BAS 457C1F56 CMNADMSO 02.03 CMNHASM 1997/06/09 17:25 5600 WSER33 C415000030 BAS 466C33BD CMNADMSO 02.01 CMNASM 1997/04/23 19:25 5112 WSER117 C416000004 BAS 462E597D CMNADMSO 02.02 CMNHASM 1997/10/06 10:19 5114 WSER52 C416000010 BAS 4708B24F CMNADMSO 02.01 CMNHASM 1997/05/22 19:22 5111 WSER117 C416000005 BAS 46549445 CMNADMSO 02.02 CMNHASM 1998/02/11 17:16 5114 WSER42 C416000030 BAS 47B1D430 CMNADMSO 01.00 *RECOMP* 1998/05/28 12:02 0000 WSER124 C417000010 BAS 483D1F8D CMNADMSO 01.00 CMNASM 1998/08/12 06:51 0000 WSER73 C417000015 BAS 48A071ED CMNADMSO 01.00 1998/09/17 09:01 0000 WSER74 C417000020 BAS 48D0C651

Page 26

The unique columns in the component history area of the source Audit Report section (differing from the columns in the previous examples) follow.

Column

Description

PROCEDURE

The procedure used to stage (copy, compile and/or link-edit) the component.

SETSSI

The 4-byte binary stamp placed on the component by Change Man (or taken from a prior placement).

EXAMPLE 4: FIELDS IN THE THREE LAYOUT AREAS: LOAD REPORT SECTION Baseline and Staging Area Fields: Load In the load Audit Report section following, the baseline and staging areas differ from the examples of copy and source sections. The column headers to the right of “Name” and “Size” are different.

8-20

Change Man Version 4.1.6

Example 4: Fields in the Three Layout Areas: Load Report Section

Change Man

(4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 Page 7 ************************************************************************************************ *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> Description of member from directory entry in library - (LOD) * ************************************************************************************************************************************ *-------------------- B a s e l i n e --------------------* *----------------------- S t a g i n g -----------------------* *********************************************************** *************************************************************** Name Size Linkdate Alias-of AC Attr Setssi Name Package Dept Size Linkdate Alias-of Setssi ________ ________ __________ ________ __ ____ ________ ________ __________ ____ ________ __________ ________ ________ CMNADMSO 0000E838 1998/11/05 00 C2E2 4911F138 CMNADMSO C417000030 00 0000E848 1998/11/13 491C2B27 CMNAPPRV 000058B0 1998/10/16 00 C2E2 48F72257 CMNAPPRV C417000030 00 000058B0 1998/11/13 491C4F88 CMNAPS20 0000AAC8 1998/10/28 00 C2E2 49071C67 CMNAPS20 C417000030 00 0000AB10 1998/11/10 491806C7 CMNAUD20 0000BC40 1998/10/29 00 C2E2 49083C77 CMNAUD20 C417000030 00 0000BC40 1998/11/10 49187D39 CMNBATCH 0000E1B0 1998/10/27 00 C2E2 4905D959 CMNBATCH C417000030 00 0000E1C0 1998/11/11 4919B2A6 CMNBAT10 00009CA0 1998/09/17 00 C2E2 48D0CC9F CMNBAT10 C417000030 00 00009C28 1998/11/11 49198E58 CMNBAT40 000012F8 1998/09/17 00 C2E2 48D0CE21 CMNBAT40 C417000030 00 00001308 1998/11/11 4919C0E9 CMNBRWLG 00002DE8 1998/10/26 00 C2E2 49047ED3 CMNBRWLG C417000030 00 00002DE8 1998/11/12 491AAD46 CMNCICS1 00001368 1998/09/17 01 C2E2 48D0D911 CMNCICS1 C417000030 00 000013D0 1998/11/13 491BF9AF CMNCKOUT 00010410 1998/11/03 00 C2E2 490F3150 CMNCKOUT C417000030 00 000104A8 1998/11/16 492037B1 CMNCMPNT 00001FE8 1998/11/04 00 C2E2 491067EE CMNCMPNT C417000030 00 00002008 1998/11/06 491334B1

Descriptions for each column in the load Audit report section follow.

Column

Description

NAME

The name of the component.

SIZE

Four hex bytes indicating load component size in bytes.

LINKDATE

The date in yyyy/mm/dd format shows the most recent re-compile and re-link of the component residing in current production. (On the staging side of the report, this would be the most recent staged date).

ALIAS-OF

If this entry is an alias, the item of which this is an alias.

AC

The authorization code, usually 00.

ATTR

The attributes (in hex) such as reentrant, reusable, etc.

SETSSI

The 4-byte binary stamp placed on the component by Change Man (or taken from a prior placement).

In this Audit Report section, the library type being audited is load as shown in the right of the report header.

Change Man User Guide

8-21

8 Auditing Packages

Component History Area Fields: Load Change Man (4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 ************************************************************************************** *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> History of changes for audited components * ************************************************************************************** *------------------ C o m p o n e n t H i s t o r y - LOD -----------------* ******************************************************************************* Name VV.MM Changed Tso-id Package Status ________ _____ ___________________ ________ __________ ______ CMNADMSO 01.00 1996/05/01 19:11:32 WSER20 C415000004 BAS CMNADMSO 01.00 1996/05/17 14:22:55 WSER20 C415000005 BAS CMNADMSO 01.00 1996/07/29 13:27:59 WSER20 C415000007 BAS CMNADMSO 01.00 1996/09/18 20:09:13 WSER41 C415000008 BAS CMNADMSO 01.00 1996/10/30 10:49:28 WSER03 C416000001 BAS CMNADMSO 01.00 1996/11/25 12:01:48 WSER42 C416000002 BAS CMNADMSO 01.00 1997/04/03 09:51:28 WSER52 C416000003 BAS CMNADMSO 01.00 1997/07/25 17:56:14 WSER52 C415000030 BAS CMNADMSO 01.00 1997/04/29 12:33:28 WSER52 C416000004 BAS CMNADMSO 01.00 1997/10/06 10:19:18 WSER52 C416000010 BAS CMNADMSO 01.00 1997/07/09 14:03:30 WSER52 C416000005 BAS CMNADMSO 01.00 1998/02/13 10:07:20 WSER129 C416000030 BAS

Page 8

In an Audit Report, the component history area fields in the load section are the same as those fields in the copy section (one field less). Whether or not you get a load component history area depends on how you set up your source. There are many ways you can get a load component history area. Two of these are: •

,I\RXGHILQHDVHSDUDWH&6(&7VHFWLRQLQDVRXUFH\RXZLOOJHWD OLNHORDGW\SHHQWU\GHSHQGLQJRQZKDWWKHWDUJHWLVIRU\RXUVRXUFH

•

,I\RXDUHVLPSO\JRLQJWRUHOLQNDORDGPRGXOH\RXZLOODOVRJHWD ORDGFRPSRQHQWKLVWRU\DUHD

EXAMPLE 5: FLAGS In the following sample: The source component is shown first in the FLAG! indicator area in the center of the report sample between the baseline and staging areas, and is CMNBAT20. The COPYBOOK components are listed in the baseline or staging areas or both. The report section has the same column headers as copy and source report sections in the baseline and staging area.

8-22

Change Man Version 4.1.6

Example 6: Staging Library Audit: Link-Edited Statically Called

The flag SYNCH5! is generated in the following sample. For SYNCH5! (CPY problem in baseline), the Recommendation Summary Report suggests you recompile the source component from baseline to include copylibs in the staging libraries.. Change Man

(4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 Page 37 ************************************************************************************** *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> Copybook (CPY) members within source (SRC) code * ************************************************************************************************************************************ *--------------------- B a s e l i n e ---------------------* *---------------------- S t a g i n g ----------------------* ************************************************************* ************************************************************* Copybook Source Copybook Name VV.MM Created Changed Size Init Tso-id Name Name VV.MM Package Changed Size Dept Tso-id ________ _____ __________ ________________ ____ ____ ________ ________ ________ _____ __________ ________________ ____ ____ ________ SERCSACM 02.06 1997/12/12 1998/09/16 08:36 0169 0168 WSER02 SERCSASL 22.14 1996/01/10 1998/09/16 08:36 0341 0243 WSER02

... SER$GLBL 22.06 1996/01/10 1998/09/16 08:36 0017 0010 WSER02

CMN$GLBL CMN$SETC CMNBTSRT CMNPATCH

01.00 01.00 01.00 01.00 01.00

1996/01/26 1996/01/26 1996/01/26 1996/01/26 1996/01/26

1997/10/02 1996/10/28 1998/05/27 1996/10/28 1996/10/28

14:11 14:35 17:41 14:42 16:26

1154 0008 0014 0064 0019

1121 0008 0013 0064 0019

C41610 C41601 C41710 C41601 C41601

CMNBAT20

01.00 1996/01/26 1997/09/16 17:01 0848 0821 C41610

CMNBAT40

SYNCH5!

CMNBTSRT 02.01 C417000030 1998/11/11 13:52 0064 00

02.01 C417000030 1998/11/11 17:29 0868 00

WSER124

WSER03

EXAMPLE 6: STAGING LIBRARY AUDIT: LINK-EDITED STATICALLY CALLED SUBROUTINES The calling load component is shown first in the FLAG! area between the baseline and staging areas in the center of the report. To find the first calling load component locate CMNADMSO. The called subroutines are listed in the baseline or staging area, or both. The report has the same column headers as the load report sections in the baseline and staging areas.

Change Man User Guide

8-23

8 Auditing Packages

The flag SYNCH0! is generated in the following sample. For SYNCH0! (Unknown to Change Man), the Recommendation Summary Report suggests you cycle the component through Change Man. . Change Man (4.1.7 - 1998/273) Audit MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19 ************************************************************************************** *Participating Package ===> C417000030 Created 1998/11/05 at 10:02:13 by WSER73 * *Package Installation Date ===> 1999/01/01 Package Status: DEV Dept No.: 00 * *Component Analysis Type ===> Statically Link-Edited Called Subroutine (LOD) * ****************************************************************************************************** *--------- B a s e l i n e ---------* *------------------ S t a g i n g ------------------* ************************************* ***************************************************** Called Module Calling Called Module Module Size Linkdate Setssi Module Module Package Dept Size Linkdate Setssi ________ ________ __________ ________ ________ ________ __________ ____ ________ __________ ________ 0000E838 1998/11/05 4911F138 CMNADMSO C417000030 00 0000E848 1998/11/13 491C2B27 CMNPATCH -- Unknown to Change Man -SYNCH0! 000058B0 1998/10/16 48F72257 CMNPATCH -- Unknown to Change Man --

CMNAPPRV SYNCH0!

C417000030 00

Page 102

000058B0 1998/11/13 491C4F88

Audit Report Output Similarities

Type of Audit

Baseline Area of Report’s Output

Staging Area of Report’s Output

6WDJLQJ/LEUDU\

1R  R X WSX W E ODQ N  X Q G HU  ED VH OLQ H 

6D PH  DV ) X OO $ X GL W 5H S RU W R X WS X W

$XGLW

K H DGL Q J V

)XOO$XGLW

7 K LV R X WS X W LV X Q LT X H W R WK H  ) X OO $ X GL W

6D PH  DV 6W DJ LQ J / L EU DU \  5 HS RU W 

5H SR U W

R X WSX W

Audit Reports produced by a Staging Library Audit or a Full Audit contain exactly the same information in the staging area of the reports, while the baseline area of a Staging Library Audit is blank under each of its headings.

Legend and Summary Report The Legend and Summary Report section of the Audit Report shows: •

The level of audit return code your administrator set for your application

•

The level of audit return code acceptable to the global administrator

•

Describes and summarizes the count of out-of-synch conditions generated during the audit of the package

The Legend and Summary report program:

8-24

•

Produces a Legend and Summary Report

•

Maintains the return code of each participating package

Change Man Version 4.1.6

Example 6: Staging Library Audit: Link-Edited Statically Called

•

Updates the return code in the package master for each participating package in the audit review.

•

Updates the return code for the complex package with the highest return code from all participating packages

•

Updates the log file with audit activity for all participating packages and the associated complex package

•

Does not update the return code for packages where the install date has passed or the package is baselined

See the following figure for a sample Legend and Summary Report. Change Man

(4.1.7 - 1998/273)

Audit

MONDAY NOVEMBER 16, 1998 (1998/320) 17:27:19

Page 105

Legend and Summary Report The local level of audit chosen at this point; 0 0 - Audit is recommended but entirely optional Out-of-synch messages (hint - search for "!" marks) DUPLIC! (Staging duplicates baseline) ===> 0 SYNCH0! (Unknown to Change Man) ===> 46 SYNCH1! (ISPF statistics not available) ===> 0 SYNCH2! (Compile/designated proc differ) ===> 0 SYNCH3! (Unparsable load module) ===> 0 SYNCH4! (CPY problem in staging) ===> 0 SYNCH5! (CPY high-date problem in baseline)===> 111 SYNCH6! (Activity file not checked out) ===> 0 SYNCH7! (Called subroutine in staging) ===> 0 SYNCH8! (Called subroutine in baseline) ===> 0 SYNCH9! (Source and load discrepancy) ===> 0 SYNCH10! (Version regression problem) ===> 3 SYNCH11! (Component hash discrepancy) ===> 0 SYNCH12! (Orphan module in staging) ===> 0 SYNCH13! (Baseline/staging discrepancy) ===> 0 SYNCH14! (Components not in active status) ===> 0 SYNCH15! (Source to relationship problem) ===> 0 SYNCH16! (CPY low-date problem in baseline)===> 0 SYNCH17! (CPY deleted problem in staging) ===> 0 SYNCH18! (LOD deleted problem in staging) ===> 0 Highest return code encountered ===> 12 CMN2666I - PARTICIPATING PACKAGE C417000030 PASSED THE AUDIT WITH A RETURN CODE OF 12.

Recommendation Summary Report The Recommendation Summary Report section of the audit report gives you recommendations for resolving out-of-synch conditions you currently have in your packages.t Recommendation Summary Report Listed below are some solutions to resolving out of synch situations that can be flagged within this audit report. SYNCH0! (Unknown to Change Man) Cycle component through Change Man. Check if component resides in another participating package excluded from audit due to install date. SYNCH5! (CPY high-date problem in baseline) Recompile source component from baseline to include copylibs residing in the staging libraries. SYNCH10! (Version regression problem) Copy staging member to development library. Checkout member again from the baseline library. Resolve version regression. Stage member. CMN7540I - End of job; RC = 12

Change Man User Guide

8-25

8 Auditing Packages

Each type of indicator flag that occurred for your audit and the corresponding recommendation display in a Recommendation Summary Report.

EVALUATING AUDIT REPORTS The following two sections describe out-of-synch conditions, with related audit return codes and suggested resolutions to some of the out-of-synch conditions.

Out-of-Synch Conditions The following table lists and explains each out-of-synch condition message you can receive during your audit. It also gives the corresponding return code for each message. NOTES A return code of zero indicates that the out-of-synch condition is informational. SW

Out-OfSynch Message

Explanation

Return Code

Suggested Resolution

DUPLIC! -

Components that, after a line by line compare, show no difference between staging and baseline libraries cause this condition. At baseline ripple, this causes older versions of that component to drop off prematurely.

4

Delete the duplicate component from the change package.

Shows that there is a copy within a copy (an embedded copylink). This is an informational code indicating that a relationship exists.

0

No action required.

(STAGING DUPLICATES BASELINE)

!COPY! (EMBEDDED COPYLINKS)

8-26

Change Man Version 4.1.6

Evaluating Audit Reports

Out-OfSynch Message

Explanation

Return Code

Suggested Resolution

SYNCH0! -

If Change Man has no record of this component in the package master, and a component is calling another module and one (or more) of the following situations exist, then SYNCH0! results.

0

Make the component known to Change Man by putting the called module into the change package, or if it exists in baseline, by rerunning conversion assistance to pick up the new relationship.

(COMPONENT UNKNOWN TO CHANGE MAN)

It may not exist in baseline, or the relationship is not found in the impact analysis table (as read by audit), but the called or calling module does not exist in the baseline library. Example 1 If a source component calls a copybook, but the copybook does not exist in baseline and the source-to-copy relationship is not displayed in query impact (+Q.I), the copybook is flagged. Example 2 Similarly, a load module is flagged if it statically links (calls) another load module (subroutine) when the called load module does not exist in baseline, or the load-to-load relationship does exist in query impact but the called or calling module does not exist in baseline. Note If a called component (copybook or load module) is copied directly into the baseline library without going through the change package life cycle, and conversion assistance has not been invoked, then the called component is also flagged. SYNCH1! - (ISPF STATISTICS NOT AVAILABLE)

Components that have no ISPF statistics cause a SYNCH1! message.

0

No action required.

SYNCH2! -

Source or like-source components in which the final compile was done without using the designated compile procedure (including designated compile options, link options, or user options) cause a SYNCH2! message. The final compile must be performed prior to freeze, exactly as designated.

12

Recompile the component using the designated procedure.

Load components with IDRDATA records that Change Man cannot parse causes a SYNCH3! message.

0

No action required.

(COMPILE/ DESIGNATED PROC DIFFER)

SYNCH3! (UNPARSABLE LOAD COMPONENT)

Change Man User Guide

8-27

8 Auditing Packages

Out-OfSynch Message

Explanation

Return Code

Suggested Resolution

SYNCH4! - (CPY PROBLEM IN STAGING)

Copy or like-copy components in the staging library that have a more current stage date than the calling source component in the staging library cause a SYNCH4! message.

12

Recompile the staging version of the source.

SYNCH5! - (CPY PROBLEM IN BASELINE)

Copy or like-copy components in staging library that have a more current activation date than the calling source component in the baseline library cause a SYNCH5! message.

8

Recompile the baseline version of the source.

SYNCH6! -

Components that do not have an associated corresponding component activity file (CAF) cause a SYNCH6! message.

12

Checkout the component again before the staging version of the calling load modules.

Called load and like-load components in the staging library that have a more current SETSSI than the calling load component in the staging library cause a SYNCH7! message.

12

Relink the staging version of the calling load.

Called load and like-load components in the staging library that have a more current SETSSI than the calling load component in the baseline library cause a SYNCH8! message.

8

Relink the baseline version of the calling load.

Load and like-load components that do not have a matching source component in the staging library cause a SYNCH9! message.

12

Stage the source component again.

12

Checkout the component again and retrofit the changes.

(ACTIVITY FILE NOT CHECKED OUT)

SYNCH7! (CALLED SUBROUTINE IN STAGING)

SYNCH8! (CALLED SUBROUTINE IN BASELINE)

SYNCH9! (SOURCE AND LOAD DISCREPANCY)

SYNCH10! (VERSION REGRESSION PROBLEM)

8-28

For example, if the staging library is changed outside of Change Man by linking a new load component into the staging library, the existing source component does not match the new load component and SYNCH9! results. Components that have a corresponding member in the baseline library changed or updated since it was checked out, cause a SYNCH10! message. To avoid this condition during an audit, a parameter can be set at the global or application level to check for this condition during staging.

Change Man Version 4.1.6

Evaluating Audit Reports

Out-OfSynch Message

Explanation

Return Code

Suggested Resolution

SYNCH11! -

Components that have been changed outside of Change Man cause a SYNCH11! message because the hash token that is created and stored within the package master during a stage won’t match the hash token that Audit calculates.

12

Verify the changes to the component and stage again.

If an unknown component is found in the staging library, usually when a component has been copied into the staging library outside of Change Man or when a compile abends, a SYNCH12! results. If this condition is not resolved, the component can be rippled into the baseline library.

12

Delete the component from the staging library.

(COMPONENT HASH DISCREPANCY)

SYNCH12! (ORPHAN MODULE IN STAGING)

SYNCH13! (BASELINE/ STAGING DISCREPANCY)

‡

/RDGFRPSRQHQWVWKDWKDYHEHHQVWDJHGLQWRD SDFNDJHDVWKHUHVXOWRIUHFRPSLOLQJDVRXUFH

‡

12

‡

,IDORDGPRGXOH LQVWDJLQJZDV

FRPSRQHQWIURPDEDVHOLQHOLEUDU\FDXVHD

FUHDWHGIURPD

6 //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

2

In the Package ID field, type the package ID.

Change Man User Guide

9-5

9 Freezing a Package

3

In the Job Statement Information, type the job card information, and press Enter to process.

When the batch freeze process builds JCL for two jobs: to create the batch job, and to freeze the batch. The freeze is executed when this job is selected. If the freeze is successful with a return code 0, the next control card for promotion is acted upon. This runs promotion and the JCL is built to run promotion as a batch job. (If the application parameters specify that promotion should be run in the foreground, a background job is also submitted.). NOTES When you freeze a package in batch mode, the statistics in the X-node dataset seem to disappear. This is an ISPF limitation. When a package is frozen, the TSO ID of the person or the jobname is used for all the install jobs in the X-node dataset. If the TSO ID or the jobname is 8 characters long, ISPF will not display the statistics, but they do exist. You can get the statistics if you dump the directory using IEBGENER or a similar copy utility. A workaround for this ISPF limitation is to keep the jobname 7 characters or less.

UNFREEZE AND REFREEZE COMPONENTS This feature allows you to selectively unfreeze and refreeze components (not the package) in the event that you want to update particular components without affecting the entire frozen package. If you want to unfreeze an entire package you have to revert it. To access the Unfreeze/Refreeze Component panel (CMNUNFRZ), take the following steps:

9-6

Change Man Version 4.1.6

Unfreeze and Refreeze Components

1

From the Freeze Options panel, select option 3. The following panel displays.

CMNUNFRZ ----------------- UNFREEZE/REFREEZE NAVI000009 ----- ROW 1 TO 6 OF 6 COMMAND ===> SCROLL ===> PAGE LINE CMDS:

F-Freeze all, U-Unfreeze all, S-Selective refreeze/unfreeze

PACKAGE CATEGORY STATUS FUNCTION _ General FROZEN _ Non-Source FROZEN _ Source and Load FROZEN _ Utilities FROZEN u Onsite FROZEN _ Custom Forms FROZEN ******************************* Bottom of data ******************************

2

Complete the fields on the Unfreeze/Refreeze Component panel. Type any of the following line commands: Command Description F

Freeze components that were previously unfrozen.,

For each component in which an F was entered, the message, FREEZE, appears at the STATUS column. The status of the change package is still Frozen (FRZ) and the package is now available for approve/reject processing. S

Selectively refreeze and unfreeze components. By entering an

S next to a package component, a panel appears which allows you to selectively unfreeze and refreeze components. U

Unfreeze components so that they can be restaged (overlaid) by application analysts after modification.

For each component in which a U was entered, the message, UNFREEZE, appears in the STATUS column. The status of the change package is still Frozen (FRZ), but the unfrozen component can be modified. The change package cannot be approved or rejected until all components have been refrozen. You can only unfreeze components of change packages that are in frozen (FRZ) status. If the change package is in Rejected (REJ) status, the change package must be reverted to Development (DEV) status before any component can be modified.

Change Man User Guide

9-7

9 Freezing a Package

NOTES For non-source, source and load, and utilities components, you can sort by any field in ascending order, using the Sort command with the keywords NAME or MEMBER. Then, you can issue a Locate command to find a component name. 3

9-8

Press Enter to process. •

If you type a line command next to General, Change Man acts upon your line command, changing the contents of your change package accordingly. If you type a U at the line command, you unfreeze the general information and permit updates (option 2 from the Build Options menu) to that information.

•

If you type a line command next to non-source, Change Man will present you with the Unfreeze/Refreeze Components panel.

•

If you type a line command next to source and load, Change Man will present you with the Unfreeze/Refreeze Components panel. You can enter SL as a line command on the Unfreeze/Refreeze Components panel to display the source and load relationships of a source component.

•

If you type a line command next to utilities, Change Man will present you with the UnFreeze Utility Information panel. You can unfreeze utility requests so they can be restaged (overlaid) after modification.

•

If you type a line command next to remote Sites, or onsite, Change Man acts upon your line command, changing the contents of your change package accordingly. This includes install date information; however, if you have used OTHER as your schedulers and the CMN17 job has already been generated, the change may not be passed to the job unless the skeleton is regenerated.

•

If you type a U at the line command, you unfreeze the remote site or onsite information and permit updates (option 2 from the Build Options menu) to that information.

•

If you type a line command next to custom forms, Change Man will present you with the Freeze/Unfreeze Custom Component panel.

Change Man Version 4.1.6

Reset the Freeze in Progress Indicator

RESET THE FREEZE IN PROGRESS INDICATOR When a batch freeze is submitted, a freeze in progress indicator is turned on. This will prevent you from submitting another freeze (on-line or batch) or selective unfreeze on the package. If the job never completes (i.e. job is canceled, system crash, etc.), this option lets you reset this indicator and submit another freeze on the package. To reset the In Progress indicator, select Option 4 . The message INDICATOR RESET will display in the upper right hand corner of the screen. Then pressing PF1 will display the long message (CMN3036I), indicating that the Freeze in Progress indicator has been reset.

Change Man User Guide

9-9

9 Freezing a Package

9-10

Change Man Version 4.1.6

PROMOTING TO A LOCAL SYSTEM

10

This chapter describes how to establish promotion levels for a local system. Promotion is a facility for setting up intermediate environments or promotion levels that can be used for model office, quality assurance, unit and system testing. Promoting is the process of promoting change packages or components from staging libraries into specific promotion levels. Demoting is the process of deleting components logically or physically from these levels. Change Man lets you configure the promotion facility in numerous ways, depending on different change management strategies. Based upon how your administrator has set up the promotion facility: •

Promoting from one level to another may be a logical copy or a logical move; that is, the components may remain in the previous environment or they may be deleted from the previous environment upon promotion.

•

Demoting a package from a particular promotion level may or may not be a physical demotion; that is, the components may or may not be physically deleted from that promotion level.

•

Promoting and demoting of both packages and components can be performed in one of three ways: — Only online — Only batch — Online or batch, at the user’s discretion

NOTES Some components, notably DB2 components requiring a BIND, must be promoted using the batch method.

10-1

10 Promoting to a Local System

USING THE PROMOTION FACILITY FOR INTERMEDIATE TESTING By setting up different promotion levels for specific phases of testing, promotion can be linked to the Change Man approval process to ensure that all components are promoted for intermediate testing before packages are approved.

Third Party Testing Third party testing includes quality assurance testing and systems testing.

Unit Testing of Online Systems Often developers perform unit testing of package components from staging libraries. However, staging libraries, which are dynamic and built by package, are not an appropriate place to test online systems such as CICS, DB2 or IMS regions. Instead, it is preferable to test online systems from a static library. Therefore, you can choose to set up a level of promotion that is available for unit testing of online systems. If your administrator has chosen promotion rule 0, then you can promote a package prior to freeze. This is particularly useful when using promotion for unit testing of online systems.

PROMOTING AND DEMOTING CHANGES You initiate all promotion and demotion activity from the Promote Change Package panel. Take the following steps to access and complete the Promote Change Package panel. 1

From the Primary Options menu, select option 3 and press Enter. The Local or Remote Promotion panel (CMNSLRPM) displays.

CMNSLRPM ----------------- LOCAL OR REMOTE PROMOTION -------------------OPTION ===> 1 1 2

Local Remote

- Local promotion (standard promotion) - Remote promotion (remote site promotion)

Press ENTER to process; Enter END command to exit.

10-2

Change Man Version 4.1.6

Promoting and Demoting Changes

2

On the Local and Remote Promotion panel, type 1 and press Enter. The Promote Change Package panel (CMNRPM00) displays .

CMNPRM00 ------------------- PROMOTE CHANGE PACKAGE --------------------------COMMAND ===> PACKAGE ID ===> NAVI000011 Press ENTER to process; Enter END command to exit.

3

From the Promote Change Package panel, type the package ID and press Enter. The Promote Change Package panel appears.

CMNPRM01 ------------------- PROMOTE CHANGE PACKAGE ------------------------COMMAND ===> SCROLL ===> CSR PACKAGE ID: NAVI000005

CREATOR: WSER85

CURRENT PROMOTION LEVEL: MAXIMUM PROMOTION LEVEL: ACTION REQUESTED ONLINE OR BATCH LEVEL TO CHECK

===> P ===> O ===>

STATUS: DEV

INSTALL DATE: 19971230

- 0 - 2 (P-Promote, D-Demote, C-Check for overlay) (O-Online, B-Batch) (Required for Action C)

PROMOTE/DEMOTE HISTORY LVL NICKNAME DATE TIME ID **************************** Bottom of data *****************************

The following table describes the fields of the Promote Change Package panel (CMNPRM01)

Field

Description

CURRENT PROMOTION LEVEL

The package’s current promotion level

MAXIMUM PROMOTION LEVEL

The maximum number of levels you can promote the package (set at package creation).

Change Man User Guide

10-3

10 Promoting to a Local System

Field

Description

ACTION REQUESTED

Type one of the following options:

P - Promote the change package. D - Demote the change package. C - Check for overlay between staging and the specified promotion level.

ONLINE OR BATCH

Type one of the following options:

O - Online promotion. B - Batch promotion.

LEVEL TO CHECK

If you typed C in the action requested field, indicate the level to check for overlay.

From this panel, you can: •

Promote (P - promote) or demote (D - demote) packages or components in batch (B - batch or online (O - online).

•

Check (C -check) a promotion level for components in common with the change package.

NOTES A check is always performed during a promotion. •

Review promotion/demotion history of the change package, listed in reverse chronological order.

Promoting a Change Package If you want to immediately promote a package and avoid filling out batch job card information, you can promote packages online. If you want to run the promotion job in the background and avoid locking your screen up during the promotion process, you can promote packages in batch mode.

Promoting Online To promote a change package online:

10-4

Change Man Version 4.1.6

Promoting and Demoting Changes

1

Type P in the action requested field on the Promote Change Package panel (CMNPRM01).

2

Type O in the online or batch field. This displays the Promote Options panel (CMNPRM09) shown below. From this panel you have the option of either promoting a package, or selectively promoting components from a package which has previously been fully promoted.

CMNPRM09 ---------------------- PROMOTE OPTIONS ----------------------------OPTION ===> f F - Full promotion of the entire package to another promotion level S - Selective promotion of components to another promotion level PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: DEV INSTALL DATE: 19971230 CURRENT PROMOTION LEVEL: MAXIMUM PROMOTION LEVEL:

0 2 -

NEXT PROMOTION LEVEL ===> 1 Press ENTER to process; Enter END command to exit.

To Promote the change package, type F in the option field. If your administrator has set a promotion rule of 0, you can override the level displayed in the next promotion level field. NOTES Change Man will check for common components before promoting. The Confirm Promotion panel will be displayed if common components are discovered. (See ”Checking for Common Components“ on page 10-11.)

Promoting in Batch To promote a change package in batch, do the following on the Promote Change Package panel (CMNPRMO1): 1

Fill in the required fields and type P in the action requested field

2

Type B in the online or batch field. This displays the Promote Options panel (CMNPRM02) shown below. From this panel you have the option of either promoting a package, or selectively promoting components from a package.

Change Man User Guide

10-5

10 Promoting to a Local System

CMNPRM02 ---------------------- PROMOTE OPTIONS -----------------------------OPTION ===> f F - Full promotion of the entire package to another promotion level S - Selective promotion of components to another promotion level PACKAGE ID: NAVI000005 CURRENT PROMOTION LEVEL: MAXIMUM PROMOTION LEVEL:

CREATOR: WSER85 -

STATUS: DEV

INSTALL DATE: 19971230

0 2

NEXT PROMOTION LEVEL ===> 1 JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

Complete the job card information to submit the promotion job in batch. Promote the change package by typing F in the option field. NOTES If your administrator has set a promotion rule of 0, you can override the level displayed in the next promotion level field.

Demoting a Change Package Demotion is the inverse of promotion. Demoting a change package removes the change package components from promotions specified by the person requesting the demotion. •

If you want to immediately demote a package and avoid filling out batch job card information, you can demote packages online.

•

If you want to run the demotion job in the background and avoid locking your screen up during the demotion process, you can demote packages in batch mode.

NOTES Components that have an incomplete (incomp) status, on the Stage panel (CMNSTG01), cannot be demoted.

10-6

Change Man Version 4.1.6

Promoting and Demoting Changes

Demoting A Package Online To demote a change package: 1

Type D in the action requested field on the Promote Change Package panel (CMNPRM01).

2

Type O in the online or batch field. This displays the Demote Options panel (CMNPRM10) shown below. From this panel you have the option of either demoting a package, or selectively demoting components from the package.

CMNPRM10 ----------------------- DEMOTE OPTIONS ----------------------------OPTION ===> f F - Full demotion of the entire package to level 0 (Staging) S - Selective demotion of components to level 0 (Staging) PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: ACTIVE INSTALL DATE: 19971230 CURRENT PROMOTION LEVEL: MAXIMUM PROMOTION LEVEL: DEMOTE FROM LEVEL

-

3 5

===> 3

Press ENTER to process; Enter END command to exit.

Demote the change package by typing F in the option field to perform a full demotion of a change package.

Demoting in Batch Demote a change package in batch. 1

Type D in the action requested field on the Promote Change Package panel (CMNPRM01).

2

Type B in the online or batch field. This displays the Demote Options panel (CMNPRM04) shown below. From this panel, you have the option of either demoting a package, or selectively demoting components from the package.

Change Man User Guide

10-7

10 Promoting to a Local System

CMNPRM04 ----------------------- DEMOTE OPTIONS ----------------------------OPTION ===> F - Full demotion of the entire package to level 0 (Staging) S - Selective demotion of components to level 0 (Staging) PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: DEV INSTALL DATE: 19971230 CURRENT PROMOTION LEVEL: 0 MAXIMUM PROMOTION LEVEL: 2 DEMOTE FROM LEVEL

===> 1

JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

Complete the job card information to submit the demotion job in batch. Demote the Change package by typing F in the option field.

PROMOTING AND DEMOTING COMPONENTS Promoting Components Selectively Promote Components To promote components online or in batch, see the section ”Promoting a Change Package“ on page 10-4. To selectively demote components from the package, see the section ”Demoting Components from a Package“ on page 10-10.

Repromote Select Components. You selectively repromote components online from the Promote Options panel (CMNPRM09), or in batch from the Promote Options panel (CMNPRM02).

10-8

Change Man Version 4.1.6

Promoting and Demoting Components

In either case: 1

Type S in the option field.

2

Press Enter to process the request.

This displays a list of components from which to select the components to promote. The following conditions might apply depending on how your administrator has set up your Change Man subsystem, and whether you are Promoting online or in batch. •

If your administrator has set Promotion Rule 0 , you can override the entry in the next promotion level field.

•

If you are promoting in batch, you must provide valid job card information.

•

If common components are discovered, the Confirm Promotion panel will be displayed.

3

Type the line command S next to the component you want to promote.

4

Type D to deselect components that were selected in error.

CMNPRM05 --------------- : NAVI000005 COMPONENTS ---------------------------COMMAND ===> SCROLL ===> CSR Enter END command to process or CANCEL to exit. CURRENT PACKAGE PROMOTION LEVEL: NEXT COMPONENT PROMOTION LEVEL:

_

NAME TYPE ALIAS-OF ALLIO SRC

Change Man User Guide

PROMOTION

- 0 - 1 DATE TIME 1997/08/10 09:10

ID STATUS WSER85 ACTIVE

10-9

10 Promoting to a Local System

Demoting Components from a Package When configuring your promotion environment, the administrator will have chosen a rule that controls the ability to demote packages and components. You may or may not be able to demote components of a package. Once a package or components have been demoted, you may or may not have to repromote though previous levels. If your administrator has selected rules 0, 1, or 2, then you can selectively demote components from a package. To demote components from a package, do the following: 1

Select Option 3 on the Primary Option menu.

2

Type a change package number on the Promote Change Package panel.

3

Type D for Demotion in Promote Change Package panel. The following panel displays.

CMNPRM04 ----------------------- DEMOTE OPTIONS ----------------------------OPTION ===> F - Full demotion of the entire package to level 0 (Staging) S - Selective demotion of components to level 0 (Staging) PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: DEV INSTALL DATE: 19971230 CURRENT PROMOTION LEVEL: 0 MAXIMUM PROMOTION LEVEL: 2 DEMOTE FROM LEVEL

===> 1

JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

Demote Option Panel (CMNPRM04) 4

Demote the change package. •

10-10

Type S to perform a selective demotion of components from a change package.

Change Man Version 4.1.6

Checking for Common Components

•

5

If the administrators have determined that promotion shall be done in batch mode, complete the job card information.

Press Enter. Change Man displays a Component List for selecting the components to be demoted.

CHECKING FOR COMMON COMPONENTS Whenever you promote a package, Change Man invokes a common module check routine. If it detects common modules in your package and in the target promotion data set, it displays a panel that does the following: •

Warns you of a possible overlay

•

Lists the names and library types of the common modules

•

Lists all change packages that contain a module common to the one you are promoting

The history record, which resides in a package at the promotion level being checked, displays a list of all packages that could contain a module common to the one you are promoting. At that time, you have the option of either continuing the promotion by typing End and pressing Enter, or canceling it, by typing CANCEL and then pressing Enter. To display the components in common between the change package and the next level of promotion: Type C in the Promote Change Package panel. The Common Components panel (CMNPRM08) appears. CMNPRM08 --------------------- COMMON COMPONENTS ---------------------------COMMAND ===> SCROLL ===> CSR Press ENTER to process or enter END to exit. PACKAGE ID: NAVI000005

CREATOR: WSER85

CURRENT PROMOTION LEVEL: MAXIMUM PROMOTION LEVEL: NAME TYPE PACKAGE ID STA _ ALLIO SRC NAVI000001

Change Man User Guide

STATUS: DEV

INSTALL DATE: 19971230

- 0 - 2 PROMOTION

DATE TIME STATUS 1997/06/01 09:00 ACTIVE

10-11

10 Promoting to a Local System

10-12

Change Man Version 4.1.6

PROMOTING TO A REMOTE SYSTEM

11

Promotion is a facility for setting up intermediate environments or promotion levels that you can use for model office, quality assurance, unit, and system testing. With this facility, you promote change packages or components from staging libraries into specific promotion levels. The facility for deleting components logically or physically from these levels is called demotion. This chapter describes remote promotion, a feature of Change Man that enables you to establish promotion levels for a remote system. For information on promoting to a local system, see “Chapter 15. Promoting to a Local System”. With remote promotion, you can promote to local levels and simultaneously promote to multiple remote sites. Similarly, remote demotion enables you to demote a change package or selective components of a change package to promotion level 0 from a remote site.

HOW ADMINISTRATORS CAN CONFIGURE REMOTE PROMOTION How your administrators have configured the (remote) promotion facility determines which of the following restrictions apply at your site. •

Remote promotion from one level to another might be a logical copy or a logical move. This means that the components might remain in the previous environment, or be deleted from the previous environment upon promotion.

•

If your administrator has chosen Promotion Rule 0, then you can remotely-promote a package prior to freeze. This might be particularly useful when you use promotion for unit testing of on-line systems.

•

Remote demotion of a package from one level might not be a physical demotion; that is, the components might not be physically deleted from that promotion level.

•

You might not be able to demote components of a package.

11-1

11 Promoting to a Remote System

•

Once a package (or components of a package) has been remotely-demoted, you might not be required to remotely-repromote through previous levels.

•

If your administrator selected Promotion Rules 0, 1, or 2, you can selectively perform remote promotion or demotion of components in a package.

The following is a list of tasks involving remote promotion, with references to the appropriate pages in this chapter: •

”Promoting Change Packages or Components to a Remote Site“ on page 11-2.

•

”Demoting Change Packages or Components from a Remote Site“ on page 11-11.

•

”Checking for Common Components at a Remote Site“ on page 11-16.

•

”Checking for Common Components at a Remote Site“ on page 11-16.

PROMOTING CHANGE PACKAGES OR COMPONENTS TO A REMOTE SITE Promote a change package or selective components of a package to a remote site. 1

From the Primary Option menu, select option 3 and press Enter. The Local or Remote Promotion (CMNSLRPM) panel displays.

CMNSLRPM ----------------- LOCAL OR REMOTE PROMOTION -------------------------OPTION ===> 1 2

Local Remote

- Local promotion (standard promotion) - Remote promotion (remote site promotion)

Press ENTER to process; Enter END command to exit.

2

11-2

On the Local or Remote Promotion panel, select option 2 (Remote Promotion) and press Enter. The Remote Promote Change Package panel (CMNRPM01) appears.

Change Man Version 4.1.6

Promoting Change Packages or Components to a Remote Site

CMNRPM00 --------------- REMOTE PROMOTE CHANGE PACKAGE --------------------COMMAND ===> PACKAGE ID ===> NAVI000005 Press ENTER to process; Enter END command to exit.

3

Type the change package ID and press Enter. The Remote Promotion Site List panel (CMNRPM01) appears with lists the available remote sites, the administration-defined force demotion flags, and the prior promotion history of the package at those remote sites.

CMNRPM01 ----------------- REMOTE PROMOTION SITE LIST ----------------------COMMAND ===> SCROLL ===> CSR Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005 CREATOR: WSER85

STATUS: DEV INSTALL DATE: 19971230

FORCED DEMOTION FROM REMOTE PRIOR PROMOTION SITES PRIOR PROMOTION SITE NAME REMOTE LOCAL REMOTE LOCAL _ remote1 x x ***************************** BOTTOM OF DATA*****************************

The following table describes the fields on the Remote Promotion Site List panel. Field

Description

PACKAGE ID

Displays the package ID

CREATOR

Displays the creator of the package.

STATUS

Displays the status of the package.

INSTALL DATE

Displays the installation date (yyyymmdd format) of the package.

REMOTE SITE NAME

Displays the remote site of the planned promotion.

Change Man User Guide

11-3

11 Promoting to a Remote System

Field

Description

FORCED DEMOTION FROM PRIOR PROMOTION SITES (REMOTE, LOCAL)

Displays the administratively-defined force demotion flags that apply during remote promotion. The flags are forced (YES ) and not forced (NO ).

PRIOR PROMOTION (REMOTE, LOCAL)

•

If force demotion (remote) is YES , then a package from a previously promoted site must be demoted prior to promotion at the selected remote site. Conversely, if a package is promoted to a remote site and the force flag is YES for the promoted site or the selected remote site, then promotion is disallowed. If the force flag is NO for both the promoted site and the selected remote site, then promotion is allowed.

•

If force demotion (local) is YES , then a package from a local site must be demoted prior to promotion at the selected remote site. Conversely, if a package is promoted locally and the force flag is YES for the selected remote site, then promotion is disallowed. If the force flag is NO for the selected remote site, then promotion is allowed.

Displays prior promotion.

With this information available prior to doing a promotion, you might avoid receiving an error message. 4

11-4

On the Remote Promotion Site List panel, type an S next to the remote site name where you want to promote the package or components and press Enter. The Promote/Demote A Change Package (CMNRPM02) panel displays.

Change Man Version 4.1.6

Promoting Change Packages or Components to a Remote Site

CMNRPM02 -------------- PROMOTE/DEMOTE A CHANGE PACKAGE ---COMMAND ===>

ROW 1 TO 8 OF 8 SCROLL ===> CSR

Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005

CREATOR: WSER85

STATUS: DEV

INSTALL DATE: 19971230

REMOTE PROMOTION SITE : remprm1 CURRENT PROMOTION LEVEL: STAGING + 0 MAXIMUM PROMOTION LEVEL: TESTINGA + 2 ACTION REQUESTED LEVEL TO CHECK

===> p ===>

(P-Promote, D-Demote, C-Check for overlay) (Required for Action C)

REMOTE HISTORY MOD/CNT PROMOTION DATE TIME ID REMOTE Full Promotion 4 2 TESTINGA 1997/06/19 09:44 WSER85 COMPLETED Full Promotion 4 2 TESTINGA 1997/06/19 09:39 WSER85 FAILED Full Promotion 4 2 TESTINGA 1997/06/18 18:33 WSER85 SUBMITTED Full Promotion 7 1 TESTINGA 1997/06/18 14:58 WSER85 COMPLETED Selective Promotion 3 2 TESTINGA 1997/06/18 14:04 WSER85 COMPLETED First Promotion at 0 2 1 TESTINGA 1997/06/18 14:02 WSER85 SUBMITTED Full Demotion 1 2 TESTINGA 1997/06/18 13:58 WSER85 COMPLETED Full Promotion 7 1 TESTINGA 1997/06/18 13:55 WSER85 SUBMITTED

The Promote/Demote A Change Package panel enables you to promote, demote, or perform common module checking.

Field

Description

REMOTE PROMOTION SITE

Displays the site where you want to promote the package.

CURRENT PROMOTION LEVEL

Displays the package’s current promotion level.

MAXIMUM PROMOTION LEVEL

Displays the highest level you can promote the package to at the selected remote site.

ACTION REQUESTED

Type one of the following options:

P —Promote the change package D —Demote the change package C —Check for overlay between the staging and the specified promotion level LEVEL TO CHECK

Change Man User Guide

If you chose C in the action requested field, type the level to check for overlay.

11-5

11 Promoting to a Remote System

Field

Description

REMOTE HISTORY

Displays a previous action (promotion or demotion) performed on this package. The four different actions are: •

Full promotion, which means that the package was fully promoted and all components in the package (components currently eligible for promotion) were promoted

•

Full demotion, which means that the package was fully demoted and all components in the package (components currently eligible for demotion) were demoted to staging level 0.

•

Selective promotion, which means that a component or components in the package were selected and promoted.

•

Selective demotion, which means that a component or components in the package (components currently eligible for demotion) were selected and demoted.

First promotion at 0, which means that a component or components in the package were selected and promoted and the package was at level 0. This is the same as selective promotion, except the package was at level 0 and the package level is now at the level selected for the selective promotion.

1RWH7KLVLVWKHRQO\VHOHFWLYHSURPRWLRQDOORZHGEH\RQGWKHSDFNDJHOHYHO MOD/CNT

Displays the number of components that were last promoted or demoted.

PROMOTION

Displays the administration-defined promotion level and the eight-character nickname for that promotion level (at the remote site) of the last promotion or demotion.

1RWH7KHPD[LPXPSURPRWLRQOHYHOYDOXHLVWKHXSSHUOLPLWIRUWKLVILHOG DATE

Displays the date (yyyymmdd format) of the last remote promotion or demotion.

TIME

Displays the time of the last promotion or demotion.

ID

Displays the TSOID of the person who performed the last promotion or demotion.

REMOTE

Displays the status of the last remote promotion or demotion. The valid values are: •

SUBMITTED, which means that the remote promotion or demotion job has been submitted for job execution.

•

COMPLETED, which means that processing of the remote promotion or demotion job has completed successfully.

•

FAILED, which means that processing of the remote promotion or demotion job has completed, but it was unsuccessful.

1RWH-REFRPSOHWLRQDQGIDLOXUHLVGHWHUPLQHGE\DILQDOQRWLILFDWLRQWKDWDOOSURFHVVLQJKDV EHHQFRPSOHWHGE\WKHUHPRWHSURFHVVRU

11-6

Change Man Version 4.1.6

Promoting Change Packages or Components to a Remote Site

The Promote/Demote a Change Package panel enables you to promote, demote or perform common module checking (i.e., “Check for Overlay”) prior to promotion. The following table describes the fields on the Promote/ Demote a Change Package panel. NOTES The status of a staged or deleted component is reflected in the query function and the selective Promotion or Demotion list: •

A restaged component is displayed on both selective promotion or demotion lists and is eligible for both.

•

Until a deleted component is at level 0, it is displayed on the selective Demotion list and is eligible for demotion.

5

On the Promote/Demote A Change Package panel, type P in the action requested field and press Enter. The Promote Options panel displays.

CMNRPM03 ---------------------- PROMOTE OPTIONS ----------------------------OPTION ===> S F - Full promotion of the entire package to another promotion level S - Selective promotion of components to another promotion level PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: DEV INSTALL DATE: 19971230 REMOTE PROMOTION SITE : remprm2 CURRENT PROMOTION LEVEL: STAGING + 0 MAXIMUM PROMOTION LEVEL: TESTINGA + 2 NEXT PROMOTION LEVEL

===> 2

(blank, * or 0 for a list)

JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

This panel displays many of the fields that show on the previous panel and the current promotion level (0 or staging). Additionally, it lets you specify full or selective promotion, the level to promote to, and the job statement information.

Change Man User Guide

11-7

11 Promoting to a Remote System

6

On the Promote Options panel, choose either option F to promote the whole package to another level, or option S to selectively promote components in the package.

7

Specify the next promotion level. In this scenario, we will specify level 2 .

If you are unsure about the promotion levels that are defined for your application, you can display a list of levels by leaving the next promotion level field blank or entering a 0 or * . The Remote Promotion Level List panel displays listing the available promotion levels (at the remote site) and the nicknames assigned to those levels.

CMNRPM07 ----------COMMAND ===> f

REMOTE PROMOTION LEVEL LIST -----------------SCROLL ===> CSR

Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: DEV INSTALL DATE: 19971230 CURRENT PROMOTION LEVEL:

_ _ _ _

NICKNAME remprm1 remote2 test101 testinga

+

1

LEVEL 00 01 02 03

From the Remote Promotion Level List panel, you can do either of the following: •

Advance to the next panel in the sequence, by entering an S next to the nickname for the level you want to promote.

•

Return to the Promote Options panel and cancel your selection on this panel, by entering the End command. By default, a 0 is displayed in the next promotion level field on the Primary Options panel.

Because the promotion level has not yet been selected, the current promotion level field retains the value (0 ) from the previous panel. NOTES Provided your administrator has set a Promotion Rule of 0 , you can use the exit CMNEX027 to override the level displayed in the next promotion level field.

11-8

Change Man Version 4.1.6

Promoting Change Packages or Components to a Remote Site

8

From the Promote Options panel, complete the Job Statement Information to submit the promotion job and press Enter.

Selective Promotion of Components From the Promote Options panel, if you typed S in the command line, the Component List panel (CMNRPM05) appears. CMNRPM05------------PROMOTE: COMMAND ===>

DEMO000045 COMPONENTS -------

ROW 1 TO 10 OF 10 SCROLL ===> CSR

Enter END command to process or CANCEL to exit. PACKAGE ID: NAVI000005

CREATOR: WSER85

STATUS: DEV

INSTALL DATE: 19971230

REMOTE PROMOTION SITE : TEST CURRENT PACKAGE PROMOTION LEVEL: STAGING + 0 NEXT COMPONENT PROMOTION LEVEL: TEST101 + 1 NAME TYPE ALIAS-OF PROMOTION DATE _ AUDIT CPY 0 STAGING 1997/07/18 S CMN$$BND CPY 0 STAGING 1997/07/17 _ CMNEX009 LOD 0 STAGING 1997/07/18 S CMNEX009 SRC 0 STAGING 1997/07/17 S CMNEX026 LOD 0 STAGING 1997/07/17 S CMNEX026 CPY 0 STAGING 1997/07/18 _ CMNEX027 LOD 0 STAGING 1997/07/17 S CMNEX027 SRC 0 STAGING 1997/07/18 S CMNEX035 LOD 0 STAGING 1997/07/17 _ CMNEX035 SRC 0 STAGING 1997/07/18 ******************************* BOTTOM OF DATA

TIME ID REQUEST STATUS 18:33 WSER85 RESTAGED 22:13 WSER85 13:55 WSER85 OVERLAID 22:13 WSER85 OVERLAID 22:13 WSER85 18:33 WSER85 22:13 WSER85 RESTAGED 13:55 WSER85 RESTAGED 22:13 WSER85 13:55 WSER85 *******************************

The following table describes the fields on the Components List panel. Field

Description

REQUEST

Displays the action requested on this component. The actions are: Blank, which means that no action has been requested for this component.

Change Man User Guide

•

SELECTED, which means that the component has been selected for action.

•

DE-SELECTED, which means that the component has been de-selected for action.

11-9

11 Promoting to a Remote System

Field

Description

STATUS

Displays the status of the component since the last promotion. The status’s are: •

Blank, which means that no change has occurred

•

RESTAGED, which means that the component was restaged

•

OVERLAID, which means that the component was overlaid by another package

The order of precedence is: OVERLAID, RESTAGED, blank. For implications of this order, see the Notes immediately following this table.

NOTES •

Only if the component has been restaged or overlaid, can you repromote it back to the same level.

•

For any status value, you can repromote the component to another level. Only promotion rule 0 , however, allows the new level to be less than the current level. With all other promotion rules, the new level must be greater than the current level.

•

It indicates the selected remote site, the current package promotion level, and the level you want to promote the component to (level 2, as specified on the previous step). It also displays the components (of the package) that you can selectively promote and the component’s status since the last promotion.

•

Based on the promotion rule, level input might be disallowed. If you have chosen to selectively promote components and the promotion rule is not 0 , the level to promote to (i.e. next component promotion level) is automatically reset based on the current level of the component.

On the Components List panel, type an S next to the components you want to Promote, then type the End command to process. For this scenario, let’s select six components from the list.

11-10

Change Man Version 4.1.6

Demoting Change Packages or Components from a Remote Site

When processing begins, the In Progress panel displays, providing information as to what Change Man is doing. CMNRPMWT------------IN PROGRESS-----------------------------------------------

Your screen is locked - please wait Date: 07/25/1997

Time: 12:00

=========================================================================== The Remote Promote function is performing the following task: Gathering package components and component information. Checking if there has been any components selected. Checking if all selected components are at the same level. Updating other packages overlaid components. Building prior promotion level cleanup table. Updating package remote promotion history. Updating package component remote promotion history. Constructing remote promotion/demotion JCL. ******************************* BOTTOM OF DATA ********************************

Change Man checks for common components before promoting. If common components are discovered, the Common Components panel displays for confirmation of promotion overlay. (See the section ”Checking for Common Components at a Remote Site“ on page 11-16).

DEMOTING CHANGE PACKAGES OR COMPONENTS FROM A REMOTE SITE Demote a change package or selective components of a package (to level 0) from a remote site. Components that have an incomplete (INCOMP) status, on the Stage panel (CMNSTG01), cannot be demoted.

Change Man User Guide

11-11

11 Promoting to a Remote System

1

Select Option 3 on the Primary Option menu and press Enter. The Local or Remote Promotion (CMNSLRPM) panel displays.

CMNSLRPM ----------------- LOCAL OR REMOTE PROMOTION -------------------------OPTION ===> 1 2

Local Remote

- Local promotion (standard promotion) - Remote promotion (remote site promotion)

Press ENTER to process; Enter END command to exit.

2

On the Local or Remote Promotion panel, type 2 for Remote Promotion and press Enter. The Remote Promote Change Package (CMNRPM00) panel appears.

3

On the Remote Promote Change Package panel, type the change package ID and press Enter. The Remote Promotion Site List (CMNRPM01) panel displays. It lists the available remote sites, the administration-defined force demotion flags, and the prior promotion history of the package at those remote sites. By using such information prior to doing a promotion, you might avoid receiving an error message.

4

11-12

On the Remote Promotion Site List panel, type an S next to the remote site name where you want to demote the package or components. (For this scenario let’s select the remote site TEST.) Press Enter. The Promote/ Demote A Change Package (CMNRPM02) panel displays.

Change Man Version 4.1.6

Demoting Change Packages or Components from a Remote Site

CMNRPM02 -------------- PROMOTE/DEMOTE A CHANGE PACKAGE ---COMMAND ===>

ROW 1 TO 8 OF 8 SCROLL ===> CSR

Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005

CREATOR: WSER85

STATUS: DEV

INSTALL DATE: 19971230

REMOTE PROMOTION SITE : remprm1 CURRENT PROMOTION LEVEL: STAGING + 0 MAXIMUM PROMOTION LEVEL: TESTINGA + 2 ACTION REQUESTED LEVEL TO CHECK

===> p ===>

(P-Promote, D-Demote, C-Check for overlay) (Required for Action C)

REMOTE HISTORY MOD/CNT PROMOTION DATE TIME ID REMOTE Full Promotion 4 2 TESTINGA 1997/06/19 09:44 WSER85 COMPLETED Full Promotion 4 2 TESTINGA 1997/06/19 09:39 WSER85 FAILED Full Promotion 4 2 TESTINGA 1997/06/18 18:33 WSER85 SUBMITTED Full Promotion 7 1 TESTINGA 1997/06/18 14:58 WSER85 COMPLETED Selective Promotion 3 2 TESTINGA 1997/06/18 14:04 WSER85 COMPLETED First Promotion at 0 2 1 TESTINGA 1997/06/18 14:02 WSER85 SUBMITTED Full Demotion 1 2 TESTINGA 1997/06/18 13:58 WSER85 COMPLETED Full Promotion 7 1 TESTINGA 1997/06/18 13:55 WSER85 SUBMITTED

This panel displays the remote site (TEST) and the current package promotion level (2 ). The panel also displays the maximum promotion level (2 ) available at TEST for this package and the promotion history for the package at TEST. 5

On the Promote/Demote A Change Package panel, type D in the action requested field and press Enter. The Demote Options panel appears.

Change Man User Guide

11-13

11 Promoting to a Remote System

CMNRPM04 ----------------------- DEMOTE OPTIONS ----------------------------OPTION ===> f F - Full demotion of the entire package to level 0 (Staging) S - Selective demotion of components to level 0 (Staging) PACKAGE ID: NAVI000005 CREATOR: WSER85

STATUS: DEV INSTALL DATE: 19971230

REMOTE PROMOTION SITE : remprm1 CURRENT PROMOTION LEVEL: + MAXIMUM PROMOTION LEVEL: + DEMOTE FROM LEVEL

===> 2

(blank, * or 0 for a list)

JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

11-14

6

On the Demote Options panel, choose either Option F to demote the whole package to level 0 , or Option S to selectively demote components of the package to level 0 .

7

Specify the Demote From level. If you are unsure about the demotion levels that are defined for your application, you can display a list of levels by leaving the demote from level field blank or by type a 0 or * . The Remote Promotion Level List panel displays listing the available promotion levels to demote from (at the remote site) and the nicknames assigned to those levels. (Because the demotion from level has yet to be selected, the current promotion level field (on the list panel) retains the value (0) from the previous panel.) From the list panel, you can do either of the following:

•

Advance to the next panel in the sequence, by entering an S next to the nickname for the level you want to demote from. (For this scenario, let’s select the nickname TEST101.) Press Enter. (Go to Step 7.)

•

Return to the Demote Options panel and cancel your selection on this panel, by typing the End command + Enter or pressing PF3. By default, a 0 is displayed in the demote from level field.

Change Man Version 4.1.6

Demoting Change Packages or Components from a Remote Site

NOTES If you chose Option F and no components are available for demotion, only the package master is updated. Consequently, the package level will reflect the correct level. 8

Complete the job statement information to submit the demotion job. Press Enter. If you chose option S , the Component List (CMNRPM05) panel appears.

CMNRPM05------------PROMOTE: COMMAND ===>

DEMO000045 COMPONENTS -------

ROW 1 TO 10 OF 10 SCROLL ===> CSR

Enter END command to process or CANCEL to exit. PACKAGE ID: NAVI000005

CREATOR: WSER85

STATUS: DEV

INSTALL DATE: 19971230

REMOTE PROMOTION SITE : TEST CURRENT PACKAGE PROMOTION LEVEL: STAGING + 0 NEXT COMPONENT PROMOTION LEVEL: TEST101 + 1 NAME TYPE ALIAS-OF PROMOTION DATE _ AUDIT CPY 0 STAGING 1997/07/18 S CMN$$BND CPY 0 STAGING 1997/07/17 _ CMNEX009 LOD 0 STAGING 1997/07/18 S CMNEX009 SRC 0 STAGING 1997/07/17 S CMNEX026 LOD 0 STAGING 1997/07/17 S CMNEX026 CPY 0 STAGING 1997/07/18 _ CMNEX027 LOD 0 STAGING 1997/07/17 S CMNEX027 SRC 0 STAGING 1997/07/18 S CMNEX035 LOD 0 STAGING 1997/07/17 _ CMNEX035 SRC 0 STAGING 1997/07/18 ******************************* BOTTOM OF DATA

TIME ID REQUEST STATUS 18:33 WSER85 RESTAGED 22:13 WSER85 13:55 WSER85 OVERLAID 22:13 WSER85 OVERLAID 22:13 WSER85 18:33 WSER85 22:13 WSER85 RESTAGED 13:55 WSER85 RESTAGED 22:13 WSER85 13:55 WSER85 *******************************

The Component List panel (CMNRPM05) indicates the selected remote site, current package promotion level, and the level you want to demote the component to. It also displays the a list of components (of the package) that you can selectively demote, and the component’s status since the last promotion. For remote demotion, you should interpret the Next Component Promotion level field as “the level to Demote from.” Consequently, this field inherits the value from the demote from level field on the Demote Options panel. If the value for the next component promotion level field exceeds the promotion level of the component you chose to demote, the next component promotion level is reset to the lower value.

Change Man User Guide

11-15

11 Promoting to a Remote System

The Status field of the Component List panel displays the following status of the component since the last promotion: •

If the component has been overlaid, only the package master is updated to reflect the correct promotion level (OVERLAID).

•

If the component has been deleted and is demoted to level 0, it will not appear on the component list (DELETED).

•

If the components has been restaged (RESTAGED).

9

Type an S next to the components you want to demote, then enter the END command to process. In this scenario, we will selectively demote three components.

When processing begins, the In Progress panel displays and provides information as to what Change Man is doing.

CHECKING FOR COMMON COMPONENTS AT A REMOTE SITE Whenever you promote a change package at a remote site, Change Man invokes a common module check routine. This routine detects common modules in your package, the target promotion data set, and the history record (which resides in the package at the promotion level being checked). You also invoke this routine, when you ‘Check for overlay’ prior to conducting a promotion. Whether you choose to ‘promote’ or ‘check for overlay’, a package list is displayed, listing all the packages that could contain a module common to the one that you are promoting. View the components in common between the change package and the next level of promotion (i.e., ‘check for overlay’).

11-16

1

Select Option 3 on the Primary Option menu and press Enter. The Local or Remote Promotion (CMNSLRPM) panel displays.

2

On the Local or Remote Promotion panel, type 2 for remote promotion and press Enter. The Remote Promote Change Package (CMNRPM00) panel displays.

3

On the Remote Promote Change Package panel, type the change package ID and press Enter. The Remote Promotion Site List (CMNRPM01) panel displays. It lists the available remote sites, the administration-defined force demotion flags, and the prior promotion history of the packages at those remote sites. By using such information prior to doing a promotion, you might avoid receiving an error message.

Change Man Version 4.1.6

Checking for Common Components at a Remote Site

4

On the Remote Promotion Site List panel, type an S next to the remote site name where you want to promote the package or components. (In this scenario, let’s select the remote site TEST.) Press Enter. The Promote/ Demote A Change Package (CMNRPM02) panel displays, indicating the selected remote site (TEST) and the current package promotion level (0 ). (The current level is 0 because you have yet to repromote.) The panel also indicates the maximum available promotion level (2 ) and the promotion history for this package at

5

On the Promote/Demote A Change Package panel, enter a C in the action requested field and press Enter. The Common Components (CMNRPM06) panel displays.

CMNRPM06 --------------------- COMMON COMPONENTS ---------------------------COMMAND ===> f SCROLL ===> CSR Press ENTER to process or enter END to exit. PACKAGE ID: NAVI000005 CREATOR: WSER85 STATUS: DEV INSTALL DATE: 19971230 REMOTE PROMOTION SITE : remprm1 CURRENT PROMOTION LEVEL: STAGING + 0 MAXIMUM PROMOTION LEVEL: TESTINGA + 2 NAME TYPE CMNEX009 SRC CMNEX026 LOD CMNEX026 CPY CMNEX027 SRC CMNEX035 LOD

PACKAGE ID DEMO000047 NAVI000074 DEMO000047 *UNKNOWN NAVI000074

STA FRZ DEV FRZ DEV

PROMOTION 2 TESTINGA 1 REMPRM1 2 TESTINGA 2 TESTINGA 1 REMPRM1

DATE 1997/07/23 1997/07/23 1997/07/23 1997/05/26 1997/07/21

TIME 13:50 13:44 13:50 14:31 16:57

ID WSER85 WSER85 WSER85 WSER85

STATUS COMMON HISTORY COMMON NOHIST HISTORY

The Common Components panel list the packages that might contain a module common to the one that you are promoting. Specifically, it displays the names and library types of the common modules, the package the component belongs to, the status of that package, the promotion level (and nickname) of the component, the date and time of the promotion, the user ID of the promoter, and the status of the component. If you type a P on the Promote Change Package panel, the Common Components panel displays, with an OVERLAY WARNING message in the upper right hand corner. After viewing the Common Components panel, you can choose to promote by pressing Enter. Alternatively, you can cancel the promotion by typing Cancel or End followed by pressing Enter or PF3.

Change Man User Guide

11-17

11 Promoting to a Remote System

11-18

Change Man Version 4.1.6

RECOMPILING AND RELINKING COMPONENTS

12

RECOMPILE OVERVIEW Recompiling is primarily used to compile a source component that uses a copybook that has changed. Recompiling from baseline or promotion is similar to staging, meaning you can select from a component list and produce a load component after selecting a compile step procedure. The difference is that, when recompiling the source component is not copied into the package’s staging library, only the load component is included. The reason the source should not be included in the package is that when the package is installed, the components are rippled into baseline and prior versions of the source would be prematurely rolled off (whereas the copy component, having been modified, should be rippled in baseline), Also, recompiling can be used to resolve some of the out-of-sync conditions that can occur from the audit process. The preceding example describes a circumstance in which you need to include the resulting load component with an updated copy component. Problem: Within the application, a programmer checks out a copy, modifies and stages it. Meanwhile, six other source programs within baseline use that copybook (and are not included in the change package). If an audit were to be performed, there would be an out-of-synch condition in the baseline libraries, and any audit level above 3 would restrict you from freezing the package. Solution: Recompile, from baseline, those components that were deemed to be out-of-synch.

RECOMPILING INTO STAGING LIBRARIES Take the following steps to recompile from baseline or promotion into staging libraries:

12-1

12 Recompiling and Relinking Components

1

From the Build Option menu, select option 8. The Recompile Source panel (CMNRCMP0) appears.

CMNRCMP0 ---------------------- RECOMPILE SOURCE ---------------------OPTION ===> L - List libraries where component is found blank - Display member selection list

PACKAGE ID COMPONENT NAME SOURCE LIBRARY TYPE LANGUAGE LIBRARY LEVEL RECOMPILE MODE

===> ===> ===> ===> ===> ===>

RICH000197 (Blank or pattern for list) SRC (Blank for list) COBOL (Blank for list) 0 (Baseline 0, Promotion 1 to nn) 2 (1-Online, 2-Batch)

Press ENTER to process; Enter END command to exit.

NOTES If you are recompiling a component and someone else has previously staged it, the user who previously staged the component receives a message informing them that you are recompiling it. The following table describes that valid entries that you can make on the Recompile Source panel (CMNRCMP0).

In this field. . .

Type. . .

Panel Options

L( list libraries where components are found) or leave blank to display a member selection list.

PACKAGE ID

Type the package ID of the members to recompile.

COMPONENT NAME

Type the name of the component to recompile. Leave this field blank or indicate a pattern with an * to display a Component Name list; unless you entered L for the panel options.

SOURCE LIBRARY TYPE

Type the library type of the component to recompile. Leave this field blank to display a Source Library Type list. Only libraries

of type SRC (source type) and those libraries designated as “Like-Source” can be used. LANGUAGE

12-2

Type the language name of the component to recompile. Leave this field blank to display a Language Name list.

Change Man Version 4.1.6

Recompiling into Staging Libraries

In this field. . .

Type. . .

LIBRARY LEVEL

Type the level of the library to be compiled from. To select from baseline, type 0. To select from promotion, type a level number from 1 to 99, depending on how many levels of promotion have been configured for your application. To select from a list of libraries where a specific component can be found: enter option L , leave this field blank, and type the component name. The Library List panel is displayed. Select the level you wish to perform the recompile.

2

After entering information on the Recompile Source panel, press Enter. If the component has a history it is displayed before the recompile job is preferred. If you have completed all of the required information, the compile (and link edit) is submitted. All of the components you selected are compiled to the staging load library associated with the package and Online Recompile Job Information panel (CMNRCMP1) similar to the following appears.

CMNRCMP1 ------------- ONLINE RECOMPILE JOB INFORMATION ----------------------COMMAND ===> PACKAGE ID: NAVI000005

STATUS: DEV

COMPONENT: LIBRARY TYPE: LANGUAGE: DATASET NAME:

ALLIO SRC - Source Code ASM WSER85.TEST.JCL

COMPILE PROCEDURE COMPILE PARMS LINK EDIT PARMS DB2 PRE-COMPILE OTHER OPTIONS SUPPRESS HISTORY

===> ===> ===> ===> NO ===> ===> NO

INSTALL DATE: 19971230

(Blank for list; ? for designated procedure)

(Y/N) (Y/N to display other options) (Y/N to use above criteria for all selected components in place of any history data)

JOB STATEMENT INFORMATION: ===> //WSER85C JOB (X170,374),’CHANGE MAN’, ===> // MSGCLASS=9,NOTIFY=WSER85,TIME=1 ===> /*JOBPARM S=ESA5 ===> // JCLLIB ORDER=(WSER85.CHGMAN.PROCLIB)

NAVI000005 ===> S (S-Staging or B-Baseline) ===> (Y - Yes or N - No; member list will be created with input library type) INPUT LIBRARY TYPE ===> LD1 (Blank for list) TARGET LIBRARY TYPE ===> LD1 (Blank for list) MEMBER NAME ===> allio (Blank for list; required for option R) COMPILE PROCEDURE ===> asm (Blank for list) LINK EDIT PARMS ===> DB2 PRE-COMPILE ===> no (Y/N) OTHER OPTIONS ===> no (Y/N for additional user options) JOB STATEMENT INFORMATION: ===> //WSER85E JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=WSER85,TIME=1 /*JOBPARM S=ESA5 // JCLLIB ORDER=(WSER85.CHGMAN.PROCLIB) NAME: ALLIO COMPILE ONLY CICS PRE-COMPILE EASYTRIEVE NO NAME USER OPTION 07 USER OPTION 09 USER OPTION 11 USER OPTION 13 USER OPTION 15 USER OPTION 17 USER OPTION 19

TYPE: SRC ===> ===> ===> y ===> n ===> n ===> ===> ===> ===> ===>

LANGUAGE: ASM ENTRY TO DLITCBL DROP INCLUDE STMTS USER OPTION 06 USER OPTION 08 USER OPTION 10 USER OPTION 12 USER OPTION 14 USER OPTION 16 USER OPTION 18 USER OPTION 20

===> ===> ===> y ===> y ===> n ===> ===> ===> ===> ===>

Use Y or N to select or deselect additional processing options; Press ENTER to continue; Enter END command to exit.

12-8

Change Man Version 4.1.6

Link Edit Control Cards List

LINK EDIT CONTROL CARDS LIST If you typed Yes in the LCT Member List field of the Relink Load Modules pane and did not select option, the following panel appears. CMNRMLST -------------------------------------------------------------------COMMAND ===> SCROLL ===> PAGE NAME FUNCTION VV.MM CREATED LAST MODIFIED SIZE INIT MOD ID _ IEBCOPY 01.04 1997/07/01 1997/08/10 09:07 15 15 4 WSER85

To process a relink, type an S (select) or R (relink) in the line command of the member that you wish to process.

Change Man User Guide

12-9

12 Recompiling and Relinking Components

12-10

Change Man Version 4.1.6

APPROVING OR REJECTING A PACKAGE

13

Frozen change packages can be approved or rejected by the individuals responsible for reviewing and approving change packages. These people are determined by the Change Man administrator during application level generation. (Refer to CMNEX028 for a list of approvers who also work with packages.) During the build process, a change package is created, scheduled, and built to contain the instructions and components that make up a change package. When the building of the change package is complete, the package is frozen — the package cannot be modified — indicating it is ready to be reviewed and approved. After a change package has been frozen, it may be promoted and the individuals who are responsible for approving the change package can approve or reject the change package online. (Promotion is optional.) If there are remote sites, an approved change package proceeds to distribution. Otherwise, it proceeds to installation. If a package has been promoted, it may still continue being approved. Care must be taken, however, because when the last person required to approve the package signs on and selects to approve it, the package will immediately be distributed (and/or installed, depending on how the global/application parameters were set up), regardless of the promotion level reached. A rejected change package has to be reverted to development. It can then be modified or deleted. If modified and refrozen, the change package must then go through all subsequent steps as if it had never been processed before. If a package is rejected by an approver, and it has been promoted prior to the rejection, it must be demoted before it can be reverted back to development status for modification. A promoted package may be selectively demoted, such that only the offending component need be affected. Then, of course, the component must be repromoted and the entire package reapproved. If a change package has made it past the build process but requires corrections, and if it has not been rejected, selective components can be unfrozen. The unfrozen components can be modified and refrozen, and the approval process can then proceed.

13-1

13 Approving or Rejecting a Package

Each application will configure two lists of approvers. The Complete Approval List will be the most commonly used for all planned change packages and all unplanned packages created during normal business hours. If you create an unplanned permanent or unplanned temporary change package outside of normal business hours, Change Man will attach the entities associated with this application’s Abbreviated Approval List. Unplanned packages (emergencies) must be reapproved by the complete approval list after installation. (The package will remain on the list of packages to be approved, and on the Change Man batch report, Packages Needing Post Approval - CMN120.) Certain approvers configured in the application’s Complete Approval List will be designated as interfacing approvers. This means that any other application that creates a change package which affects your application must be also approved by your application’s interfacing approver. Change Man’s approval facility lets authorized users approve or reject packages before they are installed into production. Change Man can capture an electronic signature of the approval or rejection of a package.

APPROVING OR REJECTING PACKAGES In order to approve or reject packages, you must access the Approve Package Parameters panel (CMNAPPRV). To access this panel, take the following steps:

13-2

Change Man Version 4.1.6

Approving or Rejecting Packages

1

From the Primary Option Menu, select Option 4. The Approve Package Parameters panel (CMNAPPRV) appears.

CMNAPPRV ----------------- APPROVE PACKAGE PARAMETERS ------------------------COMMAND ===> SPECIFY SELECTION CRITERIA: PACKAGE ID ===> NAVI000011 APPROVAL ENTITY NAME ===> NOTIFIED USER ID ===> WORK REQUEST ID ===> DEPARTMENT ===> REMOTE SITE AFFECTED ===> PACKAGE LEVEL ===> PACKAGE TYPE PACKAGE TIME SPAN FROM INSTALL DATE TO INSTALL DATE FROM CREATION DATE TO CREATION DATE OTHER PARAMETERS

===> ===> ===> ===> ===> ===> ===>

(Full name or pattern; blank for list) (Approvals for this security entity) (Packages for which user was notified)

(1-Simple, 2-Complex, 3-Super, 4-Participating) (Planned or Unplanned) (Permanent or Temporary) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (Y/N)

Press ENTER to process; Enter END command to exit.

The following table describes the information that you enter in the fields of the Approve Package Parameters panel. In this field . . .

Type . . .

PACKAGE ID

The package ID or a pattern to display the list of packages pending approval. If a change package ID was entered, only that change package is displayed for approval or rejection. The Approve/Reject Options panel displays. If a change package ID was not entered, the Approval List displays

APPROVAL ENTITY NAME

A security entity name to mask your search and list only those packages pending approval for that entity.

NOTIFIED USER ID

The user ID to mask the search criteria and display only those packages, for the specified ID, for which notification has been sent.

WORK REQUEST ID

The work request ID.

DEPARTMENT

The department.

Change Man User Guide

13-3

13 Approving or Rejecting a Package

In this field . . .

Type . . .

REMOTE SITE AFFECTED

The remote site to display only the packages with approval pending that are to be installed at that site.

PACKAGE LEVEL

‡ 6LPSOH 7RYLHZVLPSOHFKDQJHSDFNDJHVRQO\ &KDQJHSDFNDJHVWKDWFRQWDLQFKDQJHVQRWDIIHFWLQJ RWKHUSDFNDJHVRUDSSOLFDWLRQV  ‡ &RPSOH[ 7RYLHZFRPSOH[FKDQJHSDFNDJHVRQO\ 7KHSDUHQWRIWZRRUPRUHSDUWLFLSDWLQJFKDQJH SDFNDJHVWKDWKDYHLQWHUGHSHQGHQWFKDQJHVWR VRIWZDUHRURSHUDWLRQDOSURFHGXUHVZLWKLQWKHVDPH DSSOLFDWLRQ ‡ 6XSHU 7RYLHZVXSHUSDFNDJHVRQO\7KHSDUHQWRI WZRRUPRUHSDUWLFLSDWLQJFKDQJHSDFNDJHVWKDWKDYH LQWHUGHSHQGHQWFKDQJHVWRVRIWZDUHRURSHUDWLRQDO SURFHGXUHVZLWKLQWKHVDPHDSSOLFDWLRQ ‡ 3DUWLFLSDWLQJ 7RYLHZSDUWLFLSDWLQJSDFNDJHVRQO\ $FKDQJHSDFNDJHWKDWUHODWHVWRRQHRUPRUHRWKHU SDUWLFLSDWLQJSDFNDJHVDQGLVDFRPSRQHQWSDFNDJHRI DFRPSOH[RUVXSHUSDFNDJH

PACKAGE TYPE

‡ 3ODQQHG7RYLHZSDFNDJHVZLWKVFKHGXOHGFKDQJHV WKDWDUHUHTXLUHGWRIROORZDOOHVWDEOLVKHGDSSOLFDWLRQ UXOHV ‡ 8QSODQQHG7RYLHZSDFNDJHVZLWKXQVFKHGXOHG FKDQJHVLHSRVVLEO\DQHPHUJHQF\IL[

PACKAGE TIME SPAN

‡ 3HUPDQHQW7RYLHZSDFNDJHVZLWKVFKHGXOHG FKDQJHVWKDWXSGDWHEDVHOLQHSURGXFWLRQOLEUDULHV 3HUPDQHQWFKDQJHVDUHHLWKHUSODQQHGRUXQSODQQHG ‡ 7HPSRUDU\7RYLHZSDFNDJHVZLWKFKDQJHVWKDWUXQ IRUDSUHGHWHUPLQHGOHQJWKRIWLPH2QFHWKDWWLPHKDV H[SLUHG&KDQJH0DQDXWRPDWLFDOO\GHOHWHVWKH FKDQJH7HPSRUDU\FKDQJHVGRQRWXSGDWHEDVHOLQH SURGXFWLRQOLEUDULHV7KHVHFKDQJHVDUH,QVWDOOHGLQWRD VWDWLFRYHUULGHOLEUDU\7HPSRUDU\FKDQJHVDUHHLWKHU SODQQHGRUXQSODQQHG

13-4

FROM/TO INSTALL DATE

Type the installation start and end date (yyyymmdd format) to view packages within this time span.

FROM/TO CREATION DATE

Type the creation start and end date (yyyymmdd format) to view packages within this time span.

OTHER PARAMETERS

Indicate whether to further limit the display of packages based on the types of components contained in the packages.

Change Man Version 4.1.6

Approving or Rejecting a Package

After entering the appropriate information on the Approve Package Parameters panel (CMNAPPRV), press Enter. The Approve/Reject Options panel (CMNAPPOP) appears. CMNAPPOP ------------------- APPROVE/REJECT OPTIONS -------------------------OPTION ===> PACKAGE ID: NAVI000011 1 2 3 4

Approve Reasons Query Reset

-

STATUS: DEV

INSTALL DATE: 19990728

Approve or reject a change package Display reasons a package was rejected Query change package Reset approval in progress indicator

Press ENTER to process; Enter END command to exit.

APPROVING OR REJECTING A PACKAGE To approve or reject a package from the Approve/Reject Options panel (CMNAPPOP), select option 1 (Approve) and press Enter. The Approval List panel (CMNAPPLS) appears. CMNAPPLS ----------------------- APPROVAL LIST --------------- Row 1 to 3 of 3 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000018 APPROVER DESCRIPTION

STATUS: FRZ

INSTALL DATE: 19990722 ID DATE

TIME SEQ STATUS

_ Mgmt. 000 _ Tech. 000 _ QA 000 ******************************* Bottom of data ********************************

Approving a Package In the appropriate line command (approver description list), type A to approve the package and press Enter.

Change Man User Guide

13-5

13 Approving or Rejecting a Package

Rejecting a Package In the appropriate line command (approver description list), type R to reject the package and press Enter. The Reject Reasons panel (CMNREJR1) appears. CMNREJR1 ----------------------- REJECT REASONS -----------------------------COMMAND ===> PACKAGE ID: NAVI000018

STATUS: FRZ

INSTALL DATE: 19990722

APPROVER: Tech. TSO ID: ===> ===> ===> ===> ===> Press ENTER to process; Enter END command to exit.

On the Reject Reasons panel (CMNREJR1), type your reason for rejecting the package and press Enter to save you entry.

RESUBMITTING THE BATCH APPROVE AND BATCH BUILD X NODE DATA SET JCL If CMNEX028 is enabled with: •

OPT$SPFA set to Y (delay building of X node data set until after final approval)

•

OPT$BAPR set to Y (submit batch job for final approval) To failure in the final approval batch job caused by jobcard or skeleton error can cause problems in working with the package. To resolve the above problem, first fix any problem with the skeletons.

To resolve the jobcard issue, resubmit the JCL following the procedure described below:

13-6

1

Reset the approval in progress indicator to access the package.

2

Access the Approve panel for the package.

Change Man Version 4.1.6

Using the Component User ID Work Record

3

Press ENTER to display the jobcard panel (do not enter A for approve)

4

Correct any jobcard errors and submit the JCL to build the X node data set.

You can always resubmit the JCL for any problems that arise after the package is approved.

USING THE COMPONENT USER ID WORK RECORD If your administrator has turned on Component User ID Work Record function with Exit CMNEX028, Change Man records all checkout, stage, edit in stage, recompile, relink, and delete actions performed against a package component, for any user ID performing those actions. Change Man records the component name, component type, user ID, last action taken, and last date and time of the action, and then increments the action count by 1. Although only the last action performed against each component name and type appears in the record for each user ID, the number of times that a user ID acted on that component name and type is recorded. Both batch and online actions are recorded.

USING THE COMPONENT USER ID WORK RECORD DURING APPROVAL The Component User ID Work Record function can be used during the approval process. If the approver’s user ID matches any of the user IDs in the Component User ID Work Records, that approver is not allowed to approve the package. Any Component User ID Work Record that is flagged as deleted is bypassed during this process.

VIEWING THE COMPONENT USER ID WORK LIST You can view the Component User ID Work Record online through Stage Package Driven, Checkout Package Driven, and Query Package.

Change Man User Guide

13-7

13 Approving or Rejecting a Package

NOTES This function is implemented by the Change Man administrator with the extended administration options exit, CMNEX028. In both Stage Package Driven and Checkout Package Driven, line command UL (User ID List) lets you view all user IDs that have acted on the component. Although there are two ways to view the information in Query Package, both displays have Sort and Locate commands for all fields: •

One view displays a complete list of “actioned” components within a package. When you select the category Component User ID Work List from Package Information Categories, all component user ID work records display, including those flagged as deleted. See , “” on page -8. The complete view displays a table containing the component name, type and status, user ID, last date and time, last action, and number of times that user ID acted on the component.

•

The other view displays information for selected components. To obtain this view, select Non-Source or Source from Package Information Categories and type the UL line command next to the desired component (the same as from a package driven list).

The UL line command displays the component name and type, along with a table of user IDs that acted on the component. The table contains the user ID, last date and time, last action taken, and number of times that the user ID acted on the component. CMNUCWK1-------------------COMPONENT USERID WORK LIST--------ROW 1 TO 7 OF 7 COMMAND ===> SCROLL ===> CSR Press END command to exit. PACKAGE ID:

NAVI000005 STATUS:

COMPONENT NAME TYPE $$$BRWBL CPY $$$BRWBL CPY $$$BRWBL CPY $$$PRINT CPY $$$PRINT CPY ABC CPY ABC CPY

13-8

STATUS

DELETED DELETED

DEV USER ID WSER48 WSER42 WSER99 WSER48 WSER99 WSER42 WSER99

INSTALL DATE: 19971230 LAST DATE 19970801 19970801 19970823 19970801 19970823 19970801 19970625

LAST TIME 131126 123914 161827 131129 161443 123955 141842

ACTION REQUEST STAGED EDITSTAGED STAGED STAGED STAGED DELETED CHECKOUT

ACTIONED COUNT 0001 0001 0002 0001 0001 0001 0011

Change Man Version 4.1.6

Distribution and Installation of the Change Package

CMNUCWK0--------------------USERID WORK LIST-------------ROW 1 TO 5 OF 5 COMMAND ===> SCROLL ===> CSR Press END command to exit. PACKAGE ID:

NAVI000005

STATUS:

DEV

INSTALL DATE: 19971230

COMPONENT NAME: ALLIO COMPONENT TYPE: CPY USER ID WSER48 WSER42 WSER98 WSER97 WSER99

LAST DATE 19970701 19970701 19970726 19970726 19970726

LAST TIME 131134 123946 180142 175147 174747

ACTION REQUEST STAGED STAGED CHECKOUT CHECKOUT CHECKOUT

ACTIONED COUNT 0003 0001 0006 0001 0002

**********************************BOTTOM OF DATA***************************

’

Deleting the Component User ID Work Record When a component is deleted, the Component User ID Work Record is flagged as deleted, but is not deleted. If that component is once again introduced into the package, the delete flag for the Component User ID Work Record is removed, and the prior record is reinstated. Once a user ID is added to the Component User ID Work Record, it cannot be removed.

DISTRIBUTION AND INSTALLATION OF THE CHANGE PACKAGE After the change package has been approved, it is either installed, or, first distributed and then installed. The specific distribution and installation process depends on the following: •

The type of scheduler set up by the global administrator

•

Whether or not the Install job has been modified

•

The site type (ALL, DP, etc.)

Distribution to Remote Sites If the site is D or D, and therefore has remote sites (“P”), the following occurs:

Change Man User Guide

13-9

13 Approving or Rejecting a Package

•

Specific staging libraries, the installation JCL, and a copy of the package master record pertaining to this change are distributed (copied) to all the remote sites specified in the package control information (it is specified in the creation/update package process).

•

A record of this event (package distribution) is placed in the activity log.

•

A distribution acknowledgment is sent back to the development center.

•

Package status is changed from APR to DIS.

•

The change packages are installed at those sites.

If the site is “ALL” (no remote sites exist), the change package is ready to install. See the following discussion. If the site is “DP” or “D”, the install job CMN20 job runs at the corresponding remote sites), according to the scheduler. Once the change packages are installed to the remote sites, the CMN30 job runs at the “DP” or “D” site. If the site is “ALL”, Change Man executes install jobs CMN20, CMN30, CMN50, and CMN55 directly. The status of the change package changes from APR to BAS.

13-10

Change Man Version 4.1.6

REVERTING A PACKAGE

14

Although a package has been rejected, frozen, or backed out, you can return it to development (DEV) status. You are required to complete a text field describing the reasons for reverting the change package. These revert reasons, like reject backout reasons, will be carried along with the package information and are made available for review using the Change Man query function. To revert a package, you must have access to the application and the revert entity. If a package has been frozen and you want to update an individual component, you can selectively unfreeze and refreeze that component instead of executing a revert. A revert takes the entire change package out of the frozen status. Essentially anyone can revert until the package is approved by the first approver. In more detail, however, the rules for reverting packages are: When your package is in an All (no remote production sites) or revelopment (changes not allowed to be installed production libraries) site; the following is true: •

If the package is rejected, it may be reverted by a user with revert authority.

•

If the package is frozen but the approval process has not started, it may be reverted by any of the application's users.

•

If the package is frozen and the approval process has begun, the package must be rejected (with completed reject reasons) before it can be reverted.

•

If the package has been approved (but not yet installed), the person with authority to revert may do so.

•

If the package has been backed out (by a user with backout authority), it may be reverted by a user with revert authority.

When the package is in the production (remote site) site:

14-1

14 Reverting a Package

•

If the package is in DIS (distributed) status, it can be reverted by a user with revert authority.

•

If the package has been installed, it must be backed out (with completed backout reasons) by a user with backout authority before it can be reverted by a user with revert authority.

When backing out a change package after it has been distributed to a remote site and installed into production, you must initiate the package backout from the remote site and also revert it at the remote site. Additionally, after a change package has been reverted, the approval process must start over again.

REVERTING A CHANGE PACKAGE. 1

From the Primary Option Menu, select option R. The Revert Change Package appears.

CMNREV00 ------------------- REVERT CHANGE PACKAGE ------------------------COMMAND ===> PACKAGE ID ===> NAVI000005 Press ENTER to process; Enter END command to exit.

14-2

Change Man Version 4.1.6

Reverting a change package.

2

Type the change package ID of the package you wish to revert and press Enter. The Revert Reasons panel (CMNREVRS) appears.

CMNREVRS ------------------COMMAND ===> PACKAGE ID: NAVI000005

REVERT REASONS ------------------------------

STATUS: FRZ

INSTALL DATE: 19971230

===> This package had errors. ===> ===> ===> ===> ===> ===> ===> ===> Press ENTER to process; enter END command to exit.

3

Type your reason (freeform) for reverting the change package. Each line has a maximum length of 72 characters. You must type at least 1 character for the revert to succeed. When complete, Change Man returns you to the Revert Change Package panel displaying the Package Reverted message.

Change Man User Guide

14-3

14 Reverting a Package

14-4

Change Man Version 4.1.6

BACKING A PACKAGE OUT OF PRODUCTION

15

After you have installed packages into your production library, you can retrieve the previous version of the application software from the backup library. You can retrieve (backout) a package only if you have backout authority). When you backout a package, Change Man replaces your production library with the contents in your backup library and changes the package status from INS (installed) to BAK (backed out). Once you have backed out all of your production libraries, Change Man backs out its baseline library (also referred to as reverse baseline ripple) and changes the package status from BAS (baseline) to BAK (backed out). Before modifying the package, you must revert it from BAK to DEV (development). •

There are some restrictions to backing a package from production:

•

If the staging libraries for a package have been deleted or aged, the backout jobs will have vanished. The backout and reverse ripple jobs are built at the same time as the install jobs and stored in other staging library (.X or .X.Remote file).

•

When your package is installed, a backup is generated. If another package has overriden the backup copy of one of the components, you will not be allowed to backout your package.

•

Change Man does not support partial backout. All components are backed out.

ACCESSING THE BACKOUT CHANGE PACKAGE OPTION PANEL To back out a planned permanent or unplanned permanent change package which has been installed in production, you use the Backout Change Package Option panel. To access the Backout Change Package Option panel, take the following steps:

15-1

15 Backing a Package Out of Production

1

From the Primary Option Menu, select Option B and press Enter. The Backout Change Package panel (CMNBKOUT) appears.

CMNBKOUT ------------------- BACKOUT CHANGE PACKAGE -----------------------COMMAND ===> PACKAGE ID ===> NAVI000005 Press ENTER to process; Enter END command to exit.

2

In the Package ID field, type the change package ID and press Enter. The Backout Reasons panel (CMNBKRSN) displays.

CMNBKRSN ---------------------- BACKOUT REASONS ----------------------------COMMAND ===> PACKAGE ID: NAVI000005 CREATOR: WSER85

STATUS: BAS INSTALL DATE: 19971230

BACKOUT REASONS: ===> This package was incomplete. ===> ===> ===> ===> ===> ===> ===> ===> Press ENTER to process; Enter END or CANCEL command to exit.

This panel is used to record the reason for the package backout. This information is stored in the package master and may be queried at any time using the query functions. 3

Provide a brief description explaining the reason(s) for this backout action and press Enter to save your description.

4

Press PF3 or type End +Enter, to close the panel and invoke the following events: •

15-2

A job is sent to the development environment to initiate the reverse ripple of baseline but only after all remote sites have backed out the package.

Change Man Version 4.1.6

Backing Out a Package from a Remote Site

•

The components in production are overlaid with the backup library copies made prior to the package installation.

If the jobs run successfully, the following occurs: •

The status of the change package is changed to backout (BAK).

•

A record is created in production environment with a time and date stamp and it is sent to the package master.

BACKING OUT A PACKAGE FROM A REMOTE SITE When backing out a change package after it has been distributed to a remote site and installed into production, you must also initiate the package backout from the remote site. However, if you plan on restaging the package components and want to salvage the package itself, then you must revert it at all sites where it was distributed. You can have more than one remote site. When backing out or reverting remote site packages, make sure you backout and/or revert from each remote site.

Change Man User Guide

15-3

15 Backing a Package Out of Production

15-4

Change Man Version 4.1.6

USING PACKAGE LIST FOR CHANGE MAN FUNCTIONS

16

Package List (option 5 on the Build Option men) provides you with an alternative method to perform the Change Man functions presented in the previous chapters.

ACCESSING THE PACKAGE LIST PARAMETERS PANEL You access the Package List Parameters panel (CMNLIST0) to enter the appropriate information for filtering the Package List Parameters panel. This panel lets you display a list of packages. Specify filter criteria in the Package List Parameters panel. 1

Select Option 5 on the Primary Option menu. The following panel displays.

CMNLIST0 ------------------ PACKAGE LIST PARAMETERS --------------------------COMMAND ===> SPECIFY SELECTION CRITERIA: PACKAGE ID ===> NAVI000005 PACKAGE STATUS

===> APR

CREATOR’S TSO-ID WORK REQUEST ID DEPARTMENT PACKAGE LEVEL

===> ===> ===> ===>

PACKAGE TYPE PACKAGE TIME SPAN FROM INSTALL DATE TO INSTALL DATE FROM CREATION DATE TO CREATION DATE OTHER PARAMETERS

===> P ===> P ===> ===> ===> ===> ===> Y

WSER85 416NAVIG DP 4

(Full name or pattern; blank for list, or ‘*’ for all packages) (DEV, FRZ, APR, REJ, DIS, INS, BAS, BAK, OPN, CLO, TCC or DEL)

(1-Simple, 2-Complex, 3-Super, 4-Participating) (Planned or Unplanned) (Permanent or Temporary) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (Y/N)

Press ENTER to process; Enter END command to exit.

16-1

16 Using Package List for Change Man Functions

The following describes the fields of the Package List Parameters. Field

Description

PACKAGE ID

Type the package ID or a pattern to display the list of packages pending Approval.

PACKAGE STATUS

DEV

(development) A change package is in the process of being developed.

(frozen) A change package has been build, and awaiting approval. FRZ

APR (approve) A change package has been approved, and awaiting distribution (if applicable).

(reject) A change package has been rejected

REJ

DIS (distribution) The package has been distributed to the remote sites where it is to be installed. INS (install) The package has been installed in the remote sites specified in the change package.

(baseline) - indicates that the package has had its modules rippled through the application’s baseline libraries.

BAS

(backed out) - indicates that all components of the package have been removed from production.

BAK

OPN (open)

A complex or super change package has been created as an umbrella or reporting tool for inter-related changes. These complex or super packages will remain open until the user updates the status to close it. CLO (close)

A complex or super package will no longer be reported upon, and can not have any participating change packages added under its umbrella. TCC (temporary change cycle) A change package had been installed and now has been deleted from the temporary production data set.

(delete) The change package has been memo deleted.

DEL

16-2

CREATOR’S TSOID

Type the User ID to mask the search criteria and display only those packages, for the specified id.

WORK REQUEST ID

Type the work request ID.

Change Man Version 4.1.6

Accessing the Package List Parameters Panel

Field

Description

DEPARTMENT

Type the department.

REMOTE SITE AFFECTED

Type the remote site to display only the packages with approval pending that are to be installed at that site.

PACKAGE LEVEL

Simple View a change package that contains a change that is unrelated to any other change package. Complex/Super View a complex or super package that is the parent of two or more participating change packages. After you have created all participating change packages, someone is designated to create the complex or super package. It contains a list of the participating packages with the general and control information. It does not contain any of the components to be Installed. Participating View change packages that are related to one or more other packages. All of these packages are considered to be participating with each other.

PACKAGE TYPE

Planned View packages with scheduled changes that are required to follow all established application rules. Unplanned View packages with unscheduled changes. (i.e., possibly an emergency fix)

PACKAGE TIME SPAN

Permanent View packages with scheduled changes that update baseline/ production libraries. Permanent changes are either planned or unplanned. Temporary View packages with changes that run for a predetermined length of time. Once that time has expired, Change Man automatically deletes the change. Temporary changes do not update baseline/ production libraries. These changes are installed into a static override library. Temporary changes are either planned or unplanned.

FROM/TO INSTALL DATE

Type the installation start and end date (yyyymmdd format) to view packages within this time span.

FROM/TO CREATION DATE

Type the creation start and end date (yyyymmdd format) to view packages within this time span.

OTHER PARAMETERS

Indicate whether to further limit the display of packages based on the types of components contained in the packages.

Change Man User Guide

16-3

16 Using Package List for Change Man Functions

2

Fill in information in each of the filter criteria fields. This information is used to limit the range of information which is to be displayed in the Change Package List. You can fill in any combination of these fields to limit your search. To limit the range of packages displayed by specific application(s), leave the package name field blank (or specify a pattern). The Application List displays. Select any or all of the listed applications. All of these fields except the package name field are optional. If you leave any of them blank all information related to the field is displayed.

3

Type YES in the other parameters field to further limit the display of change packages by the kinds of components the change package contains.

4

Press Enter. Change Man creates and displays the Change Package List using your filter criteria, if you specified NO in the other parameters field. If you typed YES for Step 3, then the Extended Search Criteria panel appears before the Change Package List.

CMNQRY01 ------------------ EXTENDED SEARCH CRITERIA ----------------------COMMAND ===> NON-SOURCE SOURCE AND LOAD RENAME/SCRATCH INFO CUSTOM COMPONENT

===> y ===> ===> y ===>

(Y/N) (Y/N) (Y/N) (Y/N)

Press ENTER to process; Enter END command to exit.

16-4

5

Complete the Extended Search Criteria.

6

Type YES next to each row of the types of change package components to limit the display of change packages by the kinds of components the change package contains.

7

If you do not want to limit the display of change packages by components contained, type NO (or blank ) next to any of the component types.

8

Press Enter. The Change Package List appears.

Change Man Version 4.1.6

Browsing the Change Package List

BROWSING THE CHANGE PACKAGE LIST When Change Man is done processing your filter criteria, it displays the Change Package List. (For further information about filtering, or masking, displays see “Inserting a Line” on page -8.)

CMNLIST3 -------------------- CHANGE PACKAGE LIST ---------- ROW 1 TO 4 OF 4 COMMAND ===> SCROLL ===> CSR PACKAGE ID STA INSTALL LVL TYPE DEPT PROMOTION AUD CREATOR __ NAVI000005 BAS 19971230 PART PLN/PRM DP 00 STAGING WSER85 __ NAVI000007 DEV 19971230 SMPL PLN/PRM DP 4 WSER85 __ NAVI000009 CLO 19970901 CMPX PLN/PRM DP WSER85 __ NAVI000011 DEV 19971031 PART PLN/PRM DP 00 STAGING WSER85 ******************************* Bottom of data *******************************

When this view is first shown it is a shortened list which does not display all of the change package information. You can review and act on the shortened list, or you can access the rest of the package details before you act on the package. Access and browse the complete details of the Change Package List (the long list). Choose from the following commands: •

To include titles in the Package List, type LONG. The Change Package List is displayed.

•

To list all the valid line commands, type OPTIONS. The Package List Options panel is displayed.

•

To list all valid primary commands, type COMMANDS . The Valid Package List Commands is displayed.

ACTING ON PACKAGES You can use a variety of functions on the listed packages. Change Man provides you with online lists of command line options as well as line commands you can use on the packages.

Change Man User Guide

16-5

16 Using Package List for Change Man Functions

1

16-6

Type OPTIONS at the command line to access a list of command line options. This displays the Package List Options panel that contains the following options: Option

Description

U1

Update control information

U2

Update general information

U3

Update implementation information

U4

Update scheduling information

U5

Update affected application information

U6

Update participating package information

U7

Update site (remote) information (new description)

U8

Change complex/super package to CLO status

U9

Change complex/super package to OPN status

UI

Update package IMS system information (replaced UR)

OF

Work with online forms

UA

Rename and scratch components (from package)

UB

Rename and scratch components (baseline)

C1

Checkout components (baseline/promotion)

C2

Checkout components (from package)

S1

Stage components (from development)

S2

Stage components (from package)

S3

Stage components (component driven parameters)

AP

Audit package

RC

Recompile source from baseline/promotion

RL

Relink load modules

Change Man Version 4.1.6

Acting on Packages

Option

Description

BB

Browse/Print baseline/promotion

BL

Browse compressed listing

CC

Compare staging against baseline/promotion

ZP

Compress package staging libraries

F1

Freeze a package online

F2

Submit batch job to freeze package

F3

Selectively freeze/unfreeze components

F4

Reset freeze in progress indicator

PD

Promote/demote a package

PR

Remotely-promote/demote a package

A1

Approve/reject a package

A2

Display package rejection reasons

A4

Reset approval in progress indicator

D1

Memo delete a package

D2

Undelete a mMemo deleted package

RV

Revert a package

QP

Query package information

B1

Backout a package

SC

Scan baseline for character strings

NOTES The PR option is not available (i.e., is not a valid option) if allow remote promotion is set to No during application administration. 2

Type COMMANDS to get a list of all the valid line commands. The following panel displays.

Change Man User Guide

16-7

16 Using Package List for Change Man Functions

CMNLIST6 ---------------- VALID PACKAGE LIST COMMANDS ----------------------COMMAND ===> options SCROLL ===> CSR COMMAND DESCRIPTION ----------------------------------------------------------------------------DATES Display installation calendar OPTIONS Display valid package list options REFRESH Refresh current list - enter after performing a function SORT Sort PACKAGE, STA, INSTALL, LVL, TYPE, WORK, DEPT, PROMO, AUD or CREATOR SHORT Display list in short mode CANCEL Cancel processing and exit from list CREATE Create a new package LOCATE Locate on sorted fields LONG Display list in long mode COMMANDS Display valid commands panel ----------------------------------------------------------------------------Enter END command to exit.

16-8

Change Man Version 4.1.6

UTILITY REQUESTS

17

COMPRESS STAGING LIBRARIES When you create a change package, the associated staging libraries are empty. As the package goes through its life cycle, you populate the libraries with updated components. As testing proceeds with the package, you often restage many of the components, eventually causing the staging libraries to become full. You can use the compress function to compress the partitioned datasets (staging libraries) associated with change packages. Because partitioned datasets do not reuse space when you make deletions and updates, you can compress the staging libraries to reclaim the “dead space”.

ACCESSING THE COMPRESS STAGING LIBRARIES PANEL 1

To access the Compress Staging Libraries panel, from the Build Options menu, select option Z. The Compress Staging Libraries panel (CMNCPRSS) displays.

CMNCPRSS ----------------- COMPRESS STAGING LIBRARIES ----------------------COMMAND ===> PACKAGE ID ===> navi000005 JOB STATEMENT INFORMATION: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

2

In the Package ID field, type the ID of the package that you wish to compress for the staging libraries.

17-1

17 Utility Requests

3

Type the job card information. &KDQJH0DQRYHUOD\VWKHMREQDPHVSHFLILHG ZLWKWKHMREQDPHLWVXEPLWVIRUWKHEDWFKMRE

RENAMING OR DELETING COMPONENTS The utility request facility is designed to rename or delete components in production or baseline libraries. These requests can be the only items in a change package or can be part of a change package with staged components. These utility requests are processed by Change Man during package production installation and baseline ripple. Change Man processes these requests after installing and rippling staged component versions. You use the utility: Rename/Scratch Options panel to access these capabilities.

ACCESSING THE RENAME OR SCRATCH OPTIONS PANEL Use this panel to choose whether component selection lists are derived from the contents of your baseline library or from the contents of your change package. From the Build Options menu, select option 4 (Utility) from the Build Options menu. The Utility Remane or Scratch Options panel (CMNUTL00) appears. CMNUTL00 -------------- UTILITY: RENAME/SCRATCH OPTIONS ----------------------OPTION ===> 1 PACKAGE ID ===> NAVI000005 1 2

Baseline Package

- Select baseline components to scratch or rename - Process scratch or rename requests in package

Press ENTER to process; Enter END command to exit.

With Option 1 , you can attach new scratch/rename requests to a package based upon the contents of a baseline library. Change Man presents a list of components derived from the baseline library associated with the requested library type and optional member name pattern. With Option 2 , you can review and update an existing list of scratch/rename requests associated with a change package. Requests in this list can be generated in one of two ways.

17-2

Change Man Version 4.1.6

Creating Utility Requests from Baseline

•

They were completed from the baseline request option above. The status of these requests is active. They can be reviewed or deleted.

•

They were carried forward from another package if this package was created with the copy forward option. The status of these requests is inactive. These requests must be changed to active or deleted from this list before this package can be “frozen.”

Once the components have been selected for renaming or scratching, Change Man keeps track of the information. (It can be modified as long the package is in DEV status.) When the package is frozen, Change Man creates a job to run the requests, but that job is not run until the change package is actually installed.

CREATING UTILITY REQUESTS FROM BASELINE Complete the following steps to create utility requests from baseline. 1

Select Option 1 on the Utility Rename or Scratch panel (CMNUTL00). The Utility Baseline Selections panel (CMNUTL01) displays.

CMNUTL01 ---------------- UTILITY: BASELINE SELECTIONS -----------------------OPTION ===> r R - Rename a component S - Scratch a component blank - Display component selection list LIBRARY TYPE ===> COMPONENT ===> iebcopy NEW NAME ===> copy1

(Blank for list) (Blank or pattern for list) (Required for option R)

* The following options are available from a component selection list: L - Locate component R - Rename component S - Scratch component B - Browse component H - Component History I - Short History Press ENTER to process; Enter END command to exit.

Change Man User Guide

17-3

17 Utility Requests

Column

Description

Panel Options

R - Set up a rename request for a component in your baseline or production library.

S - Set up a scratch (delete) request for a component in your baseline or production library.

Blank - Bring up the Utility Baseline Component List panel. From the panel you can locate, browse, rename, access a long/short history, or scratch it. LIBRARY TYPE

Indicate the library type of the component you are renaming or scratching.

COMPONENT

Type the name of the component you are renaming or scratching. You can enter a pattern to access the Utility: Baseline Component List from which you can set up scratch and rename requests for more than one component. From this list you can use the standard special list commands, or type R or S in the first column of the component rows. If the request is a rename, you type the new name in the RENAME column of the row.

NEW NAME

2

If you are renaming a component, type the new name for the component.

When you are done, Change Man processes your input and inserts the request into your change package. Change Man returns you to the Utility: Rename/Scratch Options panel.

If baseline is kept by site for this application, then the remote site affected by the change package displays in the panel header.

ACTIVATING OR DELETING UTILITY REQUESTS FROM PACKAGES Access and complete the Utility: Change Package Driven List to activate or delete utility requests from a package list. 1

17-4

Select option 2 from the Utility Rename or Scratch Options panel. A panel (CMNUTL03) similar to the following appears.

Change Man Version 4.1.6

Deleting and Undeleting Packages

CMNUTL03 ------------------- UTILITY: NAVI000005 LIST ------- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE REQ NAME RENAME TYPE CHANGED ID STATUS FUNCTION s SCR ALLIO CPY 1997/09/03 12:40 WSER85 ACTIVE ******************************* Bottom of data ******************************

2

Aside from the special list commands, in the line command of the desired row, type A (to activate an inactive request) or D (to delete a request).

3

Press Enter to reflect the change in the package.

DELETING AND UNDELETING PACKAGES The delete function is used to delete packages from a Change Man environment. Information about the package is deleted from the package master control file and all related staging libraries are deleted.

Deletion Considerations •

A package can only be deleted with this facility if it is in development (DEV) status. Global and application administrators can delete installed packages using the aging facility. See the Administrator Guide for further information.

•

A request to delete a package from these panels is queued for later processing. When your system's housekeeping tasks are run (ordinarily nightly), the package is actually deleted. Before the housekeeping tasks are run, the deletion can be rescinded with undelete.

•

Simple, participating, super, and complex packages can be memo deleted and undeleted with this facility. The following considerations apply when you delete super or complex packages:

•

Be sure that super and complex packages have participating packages that are only in DEL (Delete) or DEV status.

•

When deleting a super or complex package, remove all associations in both the participating packages and the super or complex package.

Change Man User Guide

17-5

17 Utility Requests

SETTING UP A MEMO DELETE To delete a change package. 1

Select Option D on the Primary Option menu. The following panel displays.

CMNDELT0 ----------------------- DELETE OPTIONS ---------------------------OPTION ===> 1 1 2

Delete - Memo delete a change package Undelete - Restore memo deleted change packages

Press ENTER to process; Enter END command to exit.

2

Select Option 1 on the Delete Options panel.

3

The following panel displays.

CMNDELT1 ----------------- MEMO DELETE CHANGE PACKAGE ---------------------COMMAND ===> PACKAGE ID CONFIRM REQUEST

===> NAVI000005 ===> YES

(Y/N)

Press ENTER to process; Enter END command to exit.

4

Type the change package ID.

5

Type YES in the confirm request field if you want to confirm the request to delete before Change Man sets up the delete memo.

6

Press Enter. Confirm the request if you requested confirmation. Otherwise the delete memo is set up without requesting a confirmation.

CANCELING A DELETED CHANGE PACKAGE REQUEST You can cancel a memo deleted change package (the process is termed undeleting a change package) only prior to completing the housekeeping tasks.

17-6

Change Man Version 4.1.6

Canceling a Deleted Change Package Request

To Undelete a change package, do the following. 1

Select Option 2 on the Delete Options panel. The following panel displays.

CMNDELT3 --------------- RESTORE MEMO DELETED PACKAGES --------------------COMMAND ===> PACKAGE ID ===> NAVI000005

(Blank for list)

Press ENTER to process; Enter END command to exit.

2

Type the change package ID. To select from a list of memo deleted change package requests, leave this field blank and press Enter. Change Man displays the Memo Deleted Package List after gathering the information from the package master.

Change Man User Guide

17-7

17 Utility Requests

17-8

Change Man Version 4.1.6

COMPARING STAGING LIBRARIES

18

The compare function is used to produce a difference report describing the modifications to components within a change package using the application’s baseline or promotion libraries as a reference. For example, if a change package was created in March and installation was delayed for six months, the user may want to review the changes made before resuming the installation process. Compares can be run in either online or batch mode.

COMPARING STAGING LIBRARIES TO BASELINE OR PROMOTION You can compare components of a change package’s staging libraries to the application’s baseline or promotion libraries. Access and provide filter criteria in the Compare panel. Select option C on the Build Options menu. The following panel displays.

18-1

18 Comparing Staging Libraries

CMNCOMP1 -------------------------- COMPARE --------------------------------COMMAND ===> C - Compare of one component blank - Display member selection list COMPARE MODE PACKAGE NAME COMPONENT NAME LIBRARY TYPE SOURCE LIBRARY

===> ===> ===> ===> ===>

O (O-Online; B-Batch) NAVI000005 ALLIO (* for all members; blank for list) SRC (Blank for list) 0000 (Baseline 0 to -n; Promotion +1 to +n)

PROMPT FOR REPORT DISPOSITION ===> YES

(Y/N)

JOB STATEMENT INFORMATION FOR BATCH COMPARE: ===> //WSER85C JOB (X170,374),’CHANGE MAN’, ===> // MSGCLASS=9,NOTIFY=WSER85,TIME=1 ===> /*JOBPARM S=ESA5 ===> // JCLLIB ORDER=(WSER85.CHGMAN.PROCLIB)

PAGE ONLINE BROWSE ===> YES FROM DATE ===> TO DATE ===>

(YES-online; NO-batch) (YYYYMMDD, optional) (YYYYMMDD, optional)

IND LOG DESCRIPTION ********************************* TOP OF DATA ****************************** _ 01 Backout a Package _ 02 Install a Package _ 03 Temporary Change Cycle _ 04 Distribute a Package _ 05 Unauthorized Member Access _ 08 Delete a Package _ 09 Generate Application Information _ 10 Revert a Package _ 11 Generate Global Information _ 12 Activate a Component _ 13 Package Memo Delete _ 14 Undelete a Package _ 15 Baseline Ripple

When using the from/to date fields, you should be aware of how often the log is cleared by the system administrator. If the log containing specific dates was cleared, the backed up log can be viewed to obtain this information. In this case, the log inquiry will must be executed in batch mode. When this panel is displayed, you see all the log selection criteria descriptions available.

Field

Description

ONLINE BROWSE

Indicate whether you want to view the log online (YES ) or submit a batch job (NO ) to create a log report. If you choose NO , Change Man asks you to provide the batch job information.

FROM/TO DATE

Type the beginning and ending date (yyyymmdd format) to display specific period information.

To make a selection from the list, type S next to any of the list of selection criteria you desire and press Enter.

19-2

Change Man Version 4.1.6

Reviewing the Activity Log

REVIEWING THE ACTIVITY LOG The following panel is an example of the activity log after you provide the log filtering criteria in the section above. CMNLOGDS -------------------- ACTIVITY LOG ENTRIES ---------------------------COMMAND ===> SCROLL ===> PAGE BROWSE NEXT PAGE OF LOG ENTRIES ===> YES (Y/N)

PAGE 0001

DATE TIME JOB/ID PACKAGE ID DESCRIPTION ********************************* TOP OF DATA ********************************* 19990723 144335 WSER1323 RICH000265 Activate CMNCOBS1.SRC 19990723 144339 WSER1323 RICH000265 Activate CMNCOBS1.LOD 19990723 155707 WSER46Z DAM2000764 Activate CALLER01.SRC 19990723 155708 WSER46Z DAM2000764 Activate CALLER01.LOD 19990723 160215 WSER22RE SAF 000055 Activate FREMONT.SRC

When this panel is displayed, you see all the log entries that fit the selection criteria you indicated in the Browse Activity Log panel. If there are many entries displayed on your screen, use any of the following methods to review the information: •

Type YES in the browse next page of log entries field and press Enter. Change Man displays the next page of log entries.

•

Type P and any page number on the command line and press Enter. Change Man displays that page number. (Example: P4 displays page four of the log entries that match the selection criteria.).

You can type SELECT ALL at the command line to view the entire log (with no selection criteria) “Bottom of Data” shown after repeated page down commands is not an accurate indicator of the list’s end. Use the next page command until the “End Of Log” message is displayed in the upper right hand corner.

Change Man User Guide

19-3

19 Browsing and Printing Package Information

PRODUCE A LOG ACTIVITY REPORT The following panel displays if you type NO in the online browse field on the Browse Activity Log panel (described in the previous section). It lets you provide batch job information for filtering the activity log using a background job. You may need to get the name of the log backup copy data set from the Change Man administrator. CMNLOGE2 -------------------- BROWSE ACTIVITY LOG --------------------------COMMAND ===> BACKUP LOG DATASET NAME: ===> backup.dataset.log JOB STATEMENT INFORMATION: ===> //WSER85C JOB (X170,374),’CHANGE MAN’, ===> // MSGCLASS=9,NOTIFY=WSER85,TIME=1 ===> /*JOBPARM S=ESA5 ===> // JCLLIB ORDER=(WSER85.CHGMAN.PROCLIB)

===>

NAVI JCL 0 IEBCOPY

MEMBER LIST SCAN RECORDS TO SELECT CASE SENSITIVE FROM COLUMN TO COLUMN

===> ===> 0 ===> N ===> ===>

DATA STRING

===>

X - Print expanded

(Blank for list) (Blank for list) (Baseline 0 to -n; Promotion +1 to +n) (Blank or pattern for list) (Y/N to build member list from scan results) (0 = all) (Y/N) (0 = all) (Max = 80)

Press ENTER to process; Enter END command to exit.

2

Identify the component for which you want to run browse/print options.

3

Fill in the component description fields.

Change Man User Guide

19-7

19 Browsing and Printing Package Information

Field

Description

Panel Options

L List all baseline or promotion libraries that contain a component you specify. B Browse the full contents of any version of any baseline or promotion library component. C Copy component contents to other files or data set members, including Panvalet and Librarian. E Use any of the ISPF edit commands. X Print baseline or promotion library components with expanded copybooks. P Print baseline or promotion library components. H Display information about previous component activity, including all packages where a component previously resided. S View the stack of individual changes for each previous version of a component, including associated package and user ID information of stacked reverse deltas.

APPLICATION

The name of the application that contains the component. Leaving this field blank will display an application name selection list.

LIBRARY TYPE

The library type associated with the component to be processed. This entry determines which baseline library to process against.

LIBRARY LEVEL

The component’s version to be processed (0 to -n for baseline; +1 to +n for promotion). For baseline components, A 0 level indicates the most current baseline version which is stored in a fully expanded form. The number of valid -N versions is determined by the application administrator.

COMPONENT NAME

Type a fully qualified member name against which an option will be processed or apply a masked entry to display a member selection list that matches the masking criteria. Leave this field blank for an entire list of components within the baseline library.

MEMBER LIST SCAN

19-8

Type Y to indicate that a member (component) list will be generated based on a scan for a character string. Type N to bypass scan processing altogether.

Change Man Version 4.1.6

Browsing Baseline and Promotion Library Components

Field

Description

RECORDS TO SELECT

Indicates whether to limit the scan to a specific number of matching entries. The scan will terminate when the records selected is equal to the number of matches.

CASE SENSITIVE

Determines whether the scan is to exclude a string based on upper or lower case letters. Type Y if an exact match is required based on the data string entered. Type N if an exact match is not required.

FROM/TO COLUMN

Type the start and end columns to initiate and terminate the scan for a record.

DATA STRING

Specify the data string which is to be searched.

BROWSING BASELINE AND PROMOTION LIBRARY COMPONENTS Browse baseline is the only function that displays only those applications you are authorized to access. For those applications, you can do the following: •

Browse the contents of baseline and promotion library components

•

View all previous changes to baseline components

•

Browse the history of activity for any component

•

List libraries that contain a component

To display a list of all the promotion and baseline libraries, including library levels, that contain the component, use option L (list) on the (CMNBRBWO) panel. The figure below shows a list of all the libraries that contain a component named $$$PRINT.CPY. CMNBRWB6 ---------------- IEBCOPY.JCL LIBRARY LIST ---------- ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> PAGE LVL DATASET NAME PROMOTION NAME _ 0000 WSER85.TEST.JCL_____________________________ BASELINE _ -001 WSER85.STUFF.JCL____________________________ BASDELTA ******************************* Bottom of data ******************************

Change Man User Guide

19-9

19 Browsing and Printing Package Information

For all component types, except LOD, you can enter any of the Browse/Print Facility options as line commands. You can also issue SORT and LOCATE commands from the command line. To browse the full contents of baseline and promotion library components, use option B from panel CMNBRWB0. Copybooks are NOT expanded in browse mode. You can view them in expanded mode by printing the component using the option print expanded. You can also view all previous changes to baseline components with the Baseline Browse facility. When you do this you see: •

The stack of changes for up to 999 prior versions components stored in Stacked Reverse Delta (SRD) libraries.

•

Characteristics for each version such as date, time stamp, as well as associated package and user ID.

The figure below shows the stack of changes, and version characteristics for component SRCDBRM, on panel CMNBROWS.

CMNBROWS WSER85.WSER85.CMN97230.T1504035.CPXLOAD --- LINE 00000000 COL 001 080 COMMAND ===> SCROLL ===> PAGE ********************************* Top of Data ******************************** //WSER85CX JOB (X170,374),’I.PROGRAMMER’,REGION=6M, // CLASS=A,TIME=(,30), // MSGCLASS=9, // NOTIFY=WSER85 //* //COMPARE EXEC PGM=COMPAREX //STEPLIB DD DISP=SHR,DSN=WSER99.COMPAREX.LINKLIB //SYSPRINT DD SYSOUT=* //SYSUT1 DD DSN=WSER85.PDS.CMNADMIN(CMNALLIO), // DISP=SHR //SYSUT2 DD DSN=WSER85.APF.LINKLIB(CMNALLIO), // DISP=SHR //SYSIN DD * MAXDIFF=5 CONTINUE /* ******************************** Bottom of Data ******************************

To browse the history of activity for a component, use option H (History) from CMNBRWB0. This displays information about previous component activity, including all packages where a component previously resided.

19-10

Change Man Version 4.1.6

Editing Components in Browse Mode

The next figure shows the history of activity for a component SRCDBRM.SRC on panel CMNCMPHI. CMNCMPHI --------------------- IEBCOPY.JCL HISTORY ---------- ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> PAGE Press ENTER to continue. PACKAGE ID STA PROMOTION VV.MM LAST ACTION SIZE PROCNAME ID NAVI000005 DEV 02.02 1997/08/18 15:58 24 WSER85 NAVI000001 DEV 02.00 1997/08/13 13:45 24 WSER85 ******************************* Bottom of data ******************************

EDITING COMPONENTS IN BROWSE MODE Use ISPF Edit Commands You can use option E (Browse-in-Edit-Mode) from CMNBRWB0 or you can call the ISPF edit commands to edit baseline or promotion components. Because your edits are not saved when you exit the function, you do not have to worry about corrupting component contents during an edit session.

Copy Components to Target Data Sets Using option C (Copy) you can copy component contents to other files or data set members, including Panvalet and Librarian files. This provides you more flexibility in renaming components for modeling of new programs within Change Man, enabling you to bypass the sometimes cumbersome task of checking out to a package and using the staged name field to create a copy of a component under a new member name. The figure below shows the panel Change Man displays after you select this option.

Change Man User Guide

19-11

19 Browsing and Printing Package Information

CMNBRWB9 ---------- COPY TO DATASET/MEMBER NAME INFORMATION -------------COMMAND ===> FROM DATASET: MEMBER NAME: LIBRARY TYPE: BASELINE LEVEL:

WSER85.TEST.JCL IEBCOPY JCL 0000

TO DATASET ===> WSER85.TEST.JCL LIBRARY ORG ===> pds (PDS, PDSE, SEQ, PAN or LIB) AS MEMBER NAME ===> COPY2 Press ENTER to process; Enter END command to exit.

From this panel, you control the destination library and member name the fields described in the table below:

Field

Description

TO DATASET

Indicate the dataset to which the component(s) is to be copied. For each component to be copied a separate target data set can be entered.

LIBRARY ORG

Indicate the data set organization of the file targeted by the copy option.

AS MEMBER NAME

Type a new member name here if the component is to be renamed as a result of the copy operation. Leave this field blank if the component is not to be renamed.

Change Man checks to see if you have update access to the target data set you specify. If you do, Change Man displays the Print/Copy Job Card Information panel. CMNBRWB2 -------------- PRINT/COPY JOB CARD INFORMATION ----------------------COMMAND ===> JOB STATEMENT INFORMATION: ===> //WSER85C JOB (X170,374),’CHANGE MAN’, ===> // MSGCLASS=9,NOTIFY=WSER85,TIME=1 ===> /*JOBPARM S=ESA5 ===> // JCLLIB ORDER=(WSER85.CHGMAN.PROCLIB)

iebcopy ===> LST ===> ===>

PROMPT FOR LISTING DISPOSITION ===> NO

(Required if PACKAGE ID not supplied; Non-blank: staging/baseline listings; Blank: staging listings only) (Blank or pattern for list) (Blank for list) (YYYYMMDD) (YYYYMMDD) (Y/N)

Press ENTER to process; Enter END command to exit.

Once you have correctly provided the above information and pressed Enter, a Compressed Listing panel (an example of this panel is shown in the following figure) displays.

19-14

Change Man Version 4.1.6

Printing, Deleting or Keeping Compressed Listings

ISRBROBF SER05.SER05.CMN91121.T185722.OUTLIST ----- LINE 00000000 COL 001 080 COMMAND ===> SCROLL ===> PAGE ********************************** TOP OF DATA ******************************* ****************************************************************************** * DDNAME: ASM.SYSPRINT * ****************************************************************************** ALLOC SYMBOL

EXTERNAL SYMBOL DICTIONARY

TYPE PC CMNALLOC SD ALLOC LOC

ID 0001 0002

OBJECT CODE

ADDR 000000 000000

ADDR1

LENGTH 000000 0002FA

ADDR1

LD

1 2 3 4 5 6 7 8

ID

STMT

FLAGS 00 06

SOURCE STATEMENT

**************************************** * CCCCC M M N N AAAA L * C C MM MM NN N A A L * C M M M M N N N A A L * C M M M N N N AAAAAA L * C M M N N N A A L * C C M M N NN A A L * CCCCC M M N N A A LLL

PRINTING, DELETING OR KEEPING COMPRESSED LISTINGS Managing your compressed listing involves deleting, keeping and printing the listings after you have browsed them. You manage your compressed listing through the Specify Listing Disposition panel.

Delete, Keep and/or Print the Report Type YES in the prompt for listing disposition field on the Browse Compressed Listing panel.The Specify Listing Disposition panel (CMNBLST2) appears.

Change Man User Guide

19-15

19 Browsing and Printing Package Information

CMNBLST2 ---------------- SPECIFY LISTING DISPOSITION ------------------------OPTION ===> LISTING DATASET NAME: data.set.name.log LISTING DISPOSITION ===> PD

D K PD PK

-

Delete Keep Print and Delete Print and Keep

JOB STATEMENT INFORMATION IF DISPOSITION IS PD OR PK: ===> //WSER85A JOB ,ACCOUNT INFORMATION______________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ ===> //*_____________________________________________________________________ Press ENTER to process; Enter END command to exit.

1

Indicate (D, K, PD, or PK) how Change Man is to handle disposition of the listing after you browse it.

2

Complete the job card information to process the request.

BROWSING THE GLOBAL NOTIFICATION FACILITY Global and application administrators use the Global Notification Facility (GNF) to notify the user of: •

Hints and tips on how to use various functions

•

Changes to the system configuration

•

Work-around solutions for problems

•

Any other informational messages

During global administration, the administrator activates or deactivates the GNF. This enables the users to browse the GNF to review informational messages.

19-16

Change Man Version 4.1.6

Browsing the Global Notification Facility

Activation of the GNF causes Change Man to display option (N ) on the Primary Option menu. If the global or application administrator updates the GNF, Change Man prompts the administrator with the message Notification Updated when the Primary Option menu is re-accessed. Once the message is displayed initially, Change Man does not redisplay the message unless the administrator updates the GNF with another message. The information the administrator enters in the GNF is immediately available for browsing by the user because the GNF is either a sequential dataset or a member of a partitioned dataset. Consequently, notification of a change or addition to the file appears at the user’s next logon to Change Man. The user’s last logon time is compared to the ISPF time stamp (similar to PDF statistics) from the last save of the GNF, and if it is less or earlier (i.e., if the GNF was saved after the user logged on last time), then a notification is sent. Browse the global notification file. 1

Type N on the Primary Option menu. The Global Notification panel appears.

CMNNOT00 ----------- GLOBAL NOTIFICATION REPORT DISPOSITION ------------------OPTION ===> OUTLIST DATASET

: WSER83.CMN99214.T1931237.OUTLIST

REPORT DISPOSITION ===> D

D K PD PK

-

Delete Keep Print and Delete Print and Keep

JOB STATEMENT INFORMATION IF DISPOSITION IS PD OR PK ===> //WSER83Z JOB (X170,374),’CHANGE MAN’, // MSGCLASS=9,NOTIFY=WSER83,TIME=1 /*JOBPARM S=ESA5 //PROCLIB JCLLIB ORDER=(WSER99.CMN416Q.QACUST.SKELS) Press ENTER or END to process Enter CANCEL command to exit without saving changes.

2

The Global Notification panel displays with the information the administrator has provided. Type End or press PF3 on the command line to save file disposition information. Change Man displays the following panel.

Change Man User Guide

19-17

19 Browsing and Printing Package Information

1

In the outlist dataset field, type the temporary dataset name that contains the listing.

2

Indicate (D, K, PD, or PK) how Change Man is to handle disposition of the report after you browse it.

3

Complete the job card information to process the request.

USING THE SCAN LIBRARY UTILITY The library scan facility lets you perform a quick impact analysis without using the impact analysis utility. With this scan utility, you can search the baseline level 0 libraries for any of the following: •

A character string or a dependency on-line or in batch.

•

For a character string search, you can specify two (2) data strings. The second data string can be either AND or OR with the first data string.

•

For a dependency search, you can scan for copybooks, dates names, calls, programs executed, procedures and various other types of dependencies that are associated with the scanned members.

When you request a scan, Change Man displays a table showing the records found and where they appear. Be aware that you cannot perform any actions on the items in the list. This function does not impact the baseline browse scan.

Scanning Online Select option S on the Build Options menu to display the Library Scan Utility panel. On this panel, specify scan mode=0 (online).

19-18

Change Man Version 4.1.6

Using the Scan Library Utility

CMNSCN01 -------------------- LIBRARY SCAN UTILITY ------------------------COMMAND ===> APPLICATION LIBRARY TYPE SCAN MODE LIST MEMBERS ONLY DEPENDENCIES

===> ===> ===> ===> ===>

NAVI JCL O NO NO

(Blank for list) (Blank for list) (O-Online, B-Batch) (Y/N, Y-Members only, N-Members and Data) (Y/N, Scan for copybook, DSN, PGM etc.)

RECORDS TO SELECT CASE SENSITIVE? DISPLACEMENT: FROM TO COMPONENTS TO SCAN: BEGIN END DATA STRING 1 AND/OR DATA STRING 2

===> ===> ===> ===>

0 N 2 72

(0 = all) (Y/N) (0 = all) (Max = 80) (Blank for all components, * for pattern)

===> ===> ===> ===> ===>

CMN* XXXX* CMN AND ‘CHANGE MAN’

Press ENTER to process; Enter END command to exit.

The following table describes the fields on the Library Scan Utility panel. Field

Description

APPLICATION

Fill in the application. Leave this field blank to access a list of applications.

LIBRARY TYPE

Fill in the library type. Leave this field blank to access a list of library types.

SCAN MODE

Indicate whether the scan is online or batch.

LIST MEMBERS ONLY

Indicate whether to display the member names (and associated data) that meet the criteria, or just the member name.

DEPENDENCIES

Indicate whether to scan members for copybooks, datasets, procs or types of dependencies (Yes), or to scan only for data strings (No).

1RWH(PEHGGHGFRS\ERRNVDUHQRWLQFOXGHGLQWKHVFDQ RECORDS TO SELECT

Change Man User Guide

Type the number of records to display. You may limit your search to a specific number of found records by entering a number. Enter 0 to retrieve all matching records.

19-19

19 Browsing and Printing Package Information

Field

Description

CASE SENSITIVE?

Indicate whether the scan is case sensitive:

YES - To search for a string exactly as you typed it. NO - To find all occurrences of a string, whether in upper, lower or mixed case. DISPLACEMENT

Type the starting and ending displacements to search within each record can be specified. Type 7 for column 7, 36 for column 36, etc. Type 0 in the from field to search all displacements within the record.

COMPONENTS TO SCAN

Type the from and to component range to scan for. To search for all members, leave the begin field blank.

‡ 7RVFDQIRUVLQJOHPHPEHUVW\SHLWVQDPHLQWKH EHJLQILHOG ‡ 7ROLPLWWKHVHDUFKVFRSH&KDQJH0DQGLVUHJDUGV WKHHQGILHOG HQWHUDSDWWHUQVXFKDVABC* LQWKH EHJLQILHOG 1RWH SCROLL ===> CSR _ BASELINE DATASET: WSER85.NAVI.BASE0.SRC DB2SQ TITLE ‘CHANGE MAN (&OS$DOS.-&CMNVRM - &RELDATE) * 000018 CMNCSADS DSECT * COMMON SYSTEM AREA 000021 CMNTCADS DSECT * TASK CONTROL AREA 000023 DB2$PLAN DS CL8 PLAN; ‘CMN’ SUBSYS ‘START’ 000041 DC C’ (&OS$DOS.-&CMNVRM)’ * 000091 USING CMNTCADS,RTCA,RTCA2 TASK CONTROL AREA 000111 USING CMNCSADS,RCSA COMMON SYSTEM AREA ADDRESSABILITY 000115 TM CSA$IND3,CMNIDB2 DB2 LICENSED 000120 ICM R15,B’1111’,CSAEPHLI CMNIMPFL ALREADY LOADED 000124 * LOAD EP=CMNIMPFL MODULE ‘CMNIMPFL’ NAME 000126 DB2$0080 BASR R14,R15 CALL CMNIMPFL 000129 TM CSA$IND3,CMNIDB2P DB2 IN TROUBLE 000133 MVC 0(3,R1),=CL3’CMN’ ALWAYS STARTS WITH ‘CMN’ 000187 TITLE ‘CHANGE MAN (&OS$DOS.-&CMNVRM - &RELDATE) * 000481 MVC DB2STRNG+2(L’IMP#DRO1),IMP#DRO1 ‘DROP TABLE CMN’ 000487 IMP#DRO1 DC C’DROP TABLE CMN’ 000501 MVC DB2STRNG+2(L’IMP#CRE1),IMP#CRE1 ‘CREATE TABLE CMN’ 000508 IMP#CRE1 DC C’CREATE TABLE CMN’ 000524 * QUERY CMNXBASE * 000547

Restricting a Library Scan You restrict the scan by specifying list members only=Y on the Library Scan Utility panel. Provided the scanned member contains dependencies, you see a panel that lists the members that match the search criteria (No lines displayed). The bottom of the display shows statistics, such as the number of members scanned, the members that match the selection criteria, the ‘total’ record that matches the criteria, and the elapsed time for the scan.

Change Man User Guide

19-21

19 Browsing and Printing Package Information

Panel CMNSCN01 for scan with member names only ----------------------------------- SCAN RESULTS ---------- ROW 1 TO 21 OF 102 COMMAND ===> SCROLL ===> CSR BASELINE DATASET: WSER85.NAVI.BASE0.SRC *** Member list only *** AAADB2SQ ABC10000 ADTCALD ADTCALL BETTEST1 BETTEST2 BETTEST3 BETTEST4 BLUECROS BLUEX24 BLUEX3 CCCDB2SQ CMN$ACPM CMNADMIN CMNBATCH CMNBOW10 CMNCDISP CMNCOBEB

Searching for Character Strings On the Library Scan Utility panel, you can request a search for a character string. As displayed, the panel requests a scan for two character strings (DATA STRING 1=CMN and DATA STRING 2=‘CHANGE MAN’).

Search for Dependencies When you scan for dependencies rather than character strings, by setting dependencies=Y and list members only=N on the Library Scan Utility panel, the panel SERPANEL displays. The bottom of the display shows statistics, such as the number of members scanned, the members that match the selection criteria, the ‘total’ record that matches the criteria, and the elapsed time for the scan. Although the DATA STRING 1 field is ignored, you can help the scan utility determine what to scan for by specifying an optional language type, like JCL, COBOL, or PL1. For example, by specifying COBOL, you see only members with COBOL dependencies.

19-22

Change Man Version 4.1.6

Batch Scan

Panel CMNSCN01 for dependencies scan ----------------------------------- SCAN RESULTS ---------- ROW 1 TO 21 OF 523 COMMAND ===> SCROLL ===> CSR BASELINE DATASET: WSER85.NAVI.BASE0.SRC COPY CPY$GLBL 000016 COPY CPY$SETC 000017 COPY CPYCSADS 000022 COPY CPYTCADS 000024 COPY CPYDB2SQ 000026 COPY CPYIMPSQ 000028 COPY CMNCOBC3

000013

COPY CMNCOBC3

000014

COPY CMNCOBC1 COPY CMNCOBC2 COPY CMNCOBC3

000039 000040 000041



BATCH SCAN To perform a batch scan, select option S on the Build Options menu and on the Library Scan Utility panel. scan mode=B (batch). The results of a batch scan are the same as what you see on line. The only difference is that, with a batch scan, you can choose where to route the output. To do the batch scan, you must connect to the started task.

Search for Character String Through the Library Scan Utility panel, you can conduct a batch scan for a character string. The Scan utility will scan for two character strings (DATA STRING 1=CMN and DATA STRING 2=‘CHANGE MAN’).

Change Man User Guide

19-23

19 Browsing and Printing Package Information

When you press Enter, a batch job is submitted. When you review the job output outside of Change Man, you will see the following Batch Sysprint Output.

CMNBSCAN 4.1.6 - 99/08/12 08:52:52 Session established with Change Man Started task. Criteria for this Scan: Application :DAVE Library Type :SRC Records Selected :ALL Starting displacement :1 Ending displacement :80 Starting member :First Member Ending member :Last Member Scan Data 1 :CMN Or Scan Data 2 :ORG Dataset Organization :PDS Dataset Name to Scan :WSER99.CMNQ.BASE0.SRC DB2SQ TITLE ’CHANGE MAN (&OS$DOS.-&CMNVRM - &RELDATE) CMNCSADS DSECT * COMMON SYSTEM AREA CMNTCADS DSECT * TASK CONTROL AREA ORG TCA$ALIO REDEFINE ALLIO AREA ORG TCA$ALIO REDEFINE ALLIO AREA ORG TCA$ALIO+4096+24 MAXIMUM USED ALLIO AREA PROGRAM-ID. CMNCOBS2. COPY CMNCOBC3.

*

000018 000021 000023 000025 000027 000033

000002 000013

.....more data....... ..................... ..................... ..................... *** 148 members scanned *** *** 95 member hits *** *** 4439 record hits *** *** 12.46 seconds elapsed time *** Session terminated with Change Man Started task.

In the output, you can see the library component(s) and line(s) that match the search criteria. The bottom of the display shows statistics, such as the number of members scanned, the members that match the selection criteria, the ‘total’ record that matches the criteria, and the elapsed time for the scan.

19-24

Change Man Version 4.1.6

Batch Scan

Search for Dependencies By setting dependencies=Y on the Library Scan Utility panel, you can scan for dependencies rather than character strings. When you press Enter, a batch job is submitted. When you review the job output outside of Change Man, you will see the following Batch Sysprint Output. In the output, you can see the library components and lines that match the search criteria. The bottom of the display shows statistics, such as the number of members scanned, the members that match the selection criteria, the ‘total’ record that matches the criteria, and the elapsed time for the scan.

CMNBSCAN 4.1.6 - 99/08/12 08:52:52 Session established with Change Man Started task. Criteria for this Scan: Scan for Dependencies Records Selected :ALL Starting displacement :1 Ending displacement :80 Starting member :First Member Ending member :Last Member Dataset Organization :PDS Dataset Name to Scan :WSER42.MISC.CNTL PGM IEBGENER DSN WSER42.SUPERC.LIST

000011 000014

DSN WSER99.CMN410U.LINKLIB DSN WSER99.CMN410.LINKLIB DSN WSER99.SERNET.LINKLIB PGM IDCAMS DSN WSER42.CMN.CMNLOG.BKUP PGM CMNVINIT DSN WSER42.TEST.CMNLOG

000005 000006 000007 000008 000010 000015 000016

COPY CPY$GLBL COPY CPY$SETC

000175 000176

PRC SUPERZAP DSN WSER99.CMN410U.LINKLIB

000003 000004

....more data................... ................................ *** 382 members scanned *** *** 237 member hits *** *** 1923 record hits *** *** 14.19 seconds elapsed time *** Session terminated with Change Man Started task.

Change Man User Guide

19-25

19 Browsing and Printing Package Information

RUNNING THE BATCH SCAN You perform a batch scan by specifying one of more of the following keywords for the SYSIN parameter on the module CMNBSCAN. Change Man constructs the job and submits it using the skeleton CMN$$BSN.

19-26

Keyword

Description

SCN

Start a new scan (no/yes ); no is the default

APL

Application (required if no DSN)

LIB

Library type (required if DSN is not specified)

DSN

Data set name (required if APL and LIB are not specified)

ORG

Library org (PDS/PAN/LIB/SEQ ); PDS is the default

MB1

Start member name or pattern; first member is the default

MB2

Ending member name or pattern; last member is the default

LST

Member list only (yes/no ); no is the default

DPN

Dependencies (yes/no ); no is the default

REC

Maximum number of hits; all is the default

CAS

Case sensitive (yes/no ); no is the default

DPS

Displacement from; beginning of line is the default

DPE

Displacement to; end of line is the default

ST1

Scan string 1

AOR

And/Or string 1 with string 2; or is the default

ST2

Scan string 2

Change Man Version 4.1.6

Running the Batch Scan

The keyword SCN=YES lets you “stack in” multiple scans on batch run (i.e., lets you run scans against multiple libraries). In other words, SCN=YES tells Change Man to start a scan using the SYSIN prior to SCN=YES. If this keyword is not found, the input keywords are read until no more exist, and only one scan is performed. The SYSIN for each scan must contain either APL= and LIB=, or just DSN=. When scans are ‘stacked in’, all parameters from the prior scan are retained except for APL=, LIB= and DSN=. To change one or more of the scan parameters, do either of the following after the keyword: specify new input, or leave the input blank to reset it to the default.

Change Man User Guide

19-27

19 Browsing and Printing Package Information

19-28

Change Man Version 4.1.6

QUERYING PACKAGES AND COMPONENTS

20

Change Man provides you with ability to query packages and their components so that you can access general and detailed information. You can use this information in conjunction with the activity log (if you have log security access) to display information on all of the activities of Change Man at your site. Managers, application leaders, operations personnel, and any concerned parties may wish to sign on to Change Man to query packages and components. Approvers may often use this function to review the package prior to approving or rejecting it. Operations personnel monitor package distribution, installation, and rippling of baseline, and depending on the scheduling system used at your site, operators may need to sign on to Change Man to review predecessor/successor job names as well as other information associated to a change package. Information for the query function is being gathered from the package master and is a record of all the packages where the component resides. You use the Query Options panel to access the querying functionality.

ACCESSING THE QUERY OPTIONS PANEL To access the Query Options menu, select Q from the Primary Option Menu.

CMNQMENU ----------------------- QUERY OPTIONS ----------------------------OPTION ===> i P C I

Package - Query package information Component - Query component information Impact - Impact analysis of component relationships

Press ENTER to process; Enter END command to exit.

20-1

20 Querying Packages and Components

QUERYING CHANGE PACKAGES When you query change packages you complete the following tasks: •

Specify the filter criteria used to filter package information through the Query Package Parameters panel.

•

Browse the filtered Change Package List panel for packages you want to query.

•

Request different types of query information for individual packages using the Package Information List.

Specifying Filter Criteria Since you may want to query multiple packages for your site, and you may have many change packages, you access the Query Package Parameters panel to specify filter criteria so that Change Man can create a filtered change package list for you to query. 1

20-2

Select option P on the Query Options panel. The Query Package Parameters panel appears.

Change Man Version 4.1.6

Querying Change Packages

CMNQRY00 ------------------ QUERY PACKAGE PARAMETERS -------------------------COMMAND ===> SPECIFY SELECTION CRITERIA: PACKAGE ID ===> NAVI000005 PACKAGE STATUS

===> APR

CREATOR’S TSO-ID WORK REQUEST ID DEPARTMENT REMOTE SITE AFFECTED PACKAGE LEVEL

===> ===> ===> ===> ===>

PACKAGE TYPE PACKAGE TIME SPAN FROM INSTALL DATE TO INSTALL DATE FROM CREATION DATE TO CREATION DATE OTHER PARAMETERS

===> P ===> P ===> ===> ===> ===> ===> Y

WSER85 416NAVIG DP REMPRM1 4

(Full name or ‘*’ to (DEV, FRZ, BAS, BAK,

or pattern; blank for list, select all packages) APR, REJ, DIS, INS, OPN, CLO, TCC or DEL)

(1-Simple, 2-Complex, 3-Super, 4-Participating) (Planned or Unplanned) (Permanent or Temporary) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (YYYYMMDD) (Y/N)

Press ENTER to process; Enter END command to exit.

2

Complete information in the filter criteria fields. This information is used to limit the range of information which is to be displayed in the Query Package List. You can fill in any combination of these fields to limit your search. To limit the range of packages displayed by specific application(s), leave the package ID field blank (or specify a pattern). The following tables describes the fields of the Query Package Parameters panel. All of these fields are optional. If you leave any of them blank all of the change packages in the system are presented. Field

Description

PACKAGE ID

Type the package ID or a pattern to display the list of packages pending approval.

PACKAGE STATUS

The status of the change package.

CREATOR’S TSOID

Type the user ID to mask the search criteria and display only those packages, for the specified id.

WORK REQUEST ID

Type the work request ID.

Change Man User Guide

20-3

20 Querying Packages and Components

Field

Description

DEPARTMENT

Type the department.

REMOTE SITE AFFECTED

Type the remote site to display only the packages with approval pending that are to be installed at that site.

PACKAGE LEVEL

‡ 6LPSOH 9LHZDFKDQJHSDFNDJHWKDWFRQWDLQVDFKDQJHWKDWLV XQUHODWHGWRDQ\RWKHUFKDQJHSDFNDJH ‡ &RPSOH[6XSHU 9LHZDFRPSOH[RUVXSHUSDFNDJHWKDWLVWKHSDUHQWRI WZRRUPRUHSDUWLFLSDWLQJFKDQJHSDFNDJHV$IWHU\RX KDYHFUHDWHGDOOSDUWLFLSDWLQJFKDQJHSDFNDJHV VRPHRQHLVGHVLJQDWHGWRFUHDWHWKHFRPSOH[RUVXSHU SDFNDJH,WFRQWDLQVDOLVWRIWKHSDUWLFLSDWLQJ SDFNDJHVZLWKWKHJHQHUDODQGFRQWUROLQIRUPDWLRQ,W GRHVQRWFRQWDLQDQ\RIWKHFRPSRQHQWVWREH,QVWDOOHG ‡ 3DUWLFLSDWLQJ 9LHZFKDQJHSDFNDJHVWKDWDUHUHODWHGWRRQHRUPRUH RWKHUSDFNDJHV$OORIWKHVHSDFNDJHVDUHFRQVLGHUHGWR EHSDUWLFLSDWLQJZLWKHDFKRWKHU

PACKAGE TYPE

‡ 3ODQQHG 9LHZSDFNDJHVZLWKVFKHGXOHGFKDQJHVWKDWDUH UHTXLUHGWRIROORZDOOHVWDEOLVKHGDSSOLFDWLRQUXOHV ‡ 8QSODQQHG 9LHZSDFNDJHVZLWKXQVFKHGXOHGFKDQJHVLH SRVVLEO\DQHPHUJHQF\IL[ 

PACKAGE TIME SPAN

‡ 3HUPDQHQW 9LHZSDFNDJHVZLWKVFKHGXOHGFKDQJHVWKDWXSGDWH EDVHOLQHSURGXFWLRQOLEUDULHV3HUPDQHQWFKDQJHVDUH HLWKHUSODQQHGRUXQSODQQHG ‡ 7HPSRUDU\ 9LHZSDFNDJHVZLWKFKDQJHVWKDWUXQIRUD SUHGHWHUPLQHGOHQJWKRIWLPH2QFHWKDWWLPHKDV H[SLUHG&KDQJH0DQDXWRPDWLFDOO\GHOHWHVWKH FKDQJH7HPSRUDU\FKDQJHVGRQRWXSGDWHEDVHOLQH SURGXFWLRQOLEUDULHV7KHVHFKDQJHVDUHLQVWDOOHGLQWR DVWDWLFRYHUULGHOLEUDU\7HPSRUDU\FKDQJHVDUH HLWKHUSODQQHGRUXQSODQQHG

20-4

FROM/TO INSTALL DATE

Type the installation start and end date (yyyymmdd format) to view packages within this time span.

FROM/TO CREATION DATE

Type the creation start and end date (yyyymmdd format) to view packages within this time span.

Change Man Version 4.1.6

Querying Change Packages

Field

Description

OTHER PARAMETERS

Type Y(es) or N(o) to indicate whether to further limit the display of packages based on the types of components contained in the packages. If you type Y, and press Enter, the Extended Search Criteria panel displays. If you type N, and press Enter, the Query Package List panel displays.

Using the Extended Search Criteria Panel The Extended Search Criteria panel displays when you type YES in the other parameters field of the Query Package Parameters panel. It lets you further limit the display of change packages by the kinds of components the change package contains. CMNQRY01 ------------------ EXTENDED SEARCH CRITERIA ----------------------COMMAND ===> NON-SOURCE SOURCE AND LOAD RENAME/SCRATCH INFO CUSTOM COMPONENT

===> y ===> ===> y ===>

(Y/N) (Y/N) (Y/N) (Y/N)

Press ENTER to process; Enter END command to exit.

1

Type YES next to each row of the types of change package components to limit the display of change packages by the kinds of components the change package contains. For example, to display only those change packages that have custom components, type YES next to custom component.

2

If you do not want to limit the display of change packages by components contained, type NO (or blank) next to any of the component types.

3

Press Enter. The Query Package List appears. (See ”Browsing the Query Package List“ on page 20-5).

Browsing the Query Package List When Change Man is done processing your filter criteria, it displays the Query Package List.

Change Man User Guide

20-5

20 Querying Packages and Components

CMNQRY02 --------------------- QUERY PACKAGE LIST ----------------------------COMMAND ===> SCROLL ===> PAGE PACKAGE ID STA INSTALL LVL TYPE WORK REQUEST DEPT PROMOTION AUD CREATOR _ NAVI000005 FRZ 19971230 PART PLN/PRM 416NAVIG DP 04 WSER85 ******************************* BOTTOM OF DATA *******************************

When the Query Package List panel appears, the panel displays a shortened list change package information. You can: •

Review and request queries on the shortened list, or you can switch the viewing mode to long to see the package title as well.

•

Sort on any column heading, and you can use the LOCATE command on those sorted fields.

To switch between the short and long viewing modes in the Query Package List: •

Type LONG at the command line if you want to expand the shortened list. The long listing shows all listings regardless of status.

•

Type SHORT if you want to condense the long list. The shortened listing shows packages in motion.

To display detailed information about one or more change packages, type S next to the packages you want to display and press Enter. The Package Information Categories panel displays.

20-6

Change Man Version 4.1.6

Querying Change Packages

CMNQRY03 --------------- PACKAGE INFORMATION CATEGORIES ---------------------COMMAND ===> SCROLL ===> PAGE PACKAGE ID: NAVI000005 CREATOR: WSER85

STATUS: APR AUDIT RC: 04

INSTALL DATE: 19971230

_ General s Non-Source _ Source _ Source and Load Relationship _ Renames and Scratches _ Approval List _ Site/Install Date Information _ Site Activities Date and Time _ Custom Forms _ Participating Package(s) _ Status Start Date and Time _ Revert Reasons _ Backout Reasons _ Promotion History _ Promotion Libraries _ Development Staging Libraries _ Production Staging Libraries _ Production Libraries _ Baseline Libraries ******************************* Bottom of data ******************************

The following tables describes the fields of the Package Information Categories panel (CMNQRY03). a

Field

Description

PACKAGE ID

The ID of the package.

STATUS

The current status of the package.

INSTALL DATE

The proposed installation date (yyyymmdd format) of the package.

CREATOR

The TSOID of the package creator.

AUDIT RC

The audit return code of the last audit job run, if any.

Change Man User Guide

20-7

20 Querying Packages and Components

Field

Description

Package Category

Selecting any of the following categories displays information specific to your package. (See “Appendix A. Package Category Panels”.) General - Display general package information, such as description; install date and time; requestor name, phone number, and department. Non-Source - Display non-source components in the package: COPYLIB members, cataloged JCL procedures, linkage editor control statements, control cards, and documentation. Source - Display source component staging information. Source and Load Relationship - Display component and their related components. Renames and Scratches - Display package utility requests. Approval List - Display package approval list. Site/Install Date Information - Display remote site information. Site Activities Date and Time - Display starting date and time stamp of activities that were performed at the remote site. Custom Forms - Display custom forms information. Participating Package(s) - Display individual application packages (participating packages) that make up this complex/ super package. Status Start Date and Time - Display all possible statuses for the package, as well as the date and time that the package was assigned the status. Revert Reasons - Display the reasons the package was reverted. Backout Reasons - Display the reason the package was backed out Promotion History - Display promotion/demotion history of the package, listed in reverse chronological order. Remote Promotion History - Displays remote promotion or demotion history of the package and component-level remote promotion information, listed in reverse chronological order. Promotion Libraries - Displays the level and data set names of the promotion libraries for the application. Remote Promotion Libraries - Displays the remote site, levels and dataset names of the promotion libraries for the application. Development Staging Libraries - Display the data set name of the development environment staging libraries for the package. Production Staging Libraries - Display the data set name of the production environment staging libraries for the package. Production Libraries - Display the data set name of the production libraries affected by the package. Baseline Libraries - Display the data set name of the baseline libraries affected by the package.

20-8

Change Man Version 4.1.6

Querying Components

To select a package category, place an S beside the category and press Enter.

QUERYING COMPONENTS To search and display component information, take the following steps: 1

From the Primary Option menu, select Option Q . The Query Options panel appears.

2

From the Query Options panel, select Option C. The Query Component Parameters panel (CMNQCMP1) appears

CMNQCMP1 ----------------- QUERY COMPONENT PARAMETERS ---------------------COMMAND ===> SPECIFY SELECTION CRITERIA: COMPONENT NAME ===> IEBCOPY (Full name or pattern) COMPONENT TYPE ===> JCL (Full library type or pattern) APPLICATION ===> NAVI PACKAGE ID ===> NAVI000005 PROCEDURE NAME ===> TSOID ===> WSER85 DISPLAY MODE ===> SHORT (S-Short, L-Long) CHECKOUT/STAGING FROM DATE ===> (YYYYMMDD) TO DATE ===> (YYYYMMDD) Press ENTER to process; Enter END command to exit.

3

Complete the selection criteria to query components and press Enter. Change Man displays the Query Component List.

Change Man User Guide

20-9

20 Querying Packages and Components

CMNQCMP2 ------------------- QUERY: COMPONENT LIST ---------- ROW 1 TO 17 224 COMMAND ===> SCROLL ===> PAGE BROWSE NEXT PAGE OF COMPONENT HISTORY ===> Y

_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

LIB SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC SRC

(Y/N)

NAME CMN$ACPM CMN$STUB CMN$UTIL CMN$XMEM CMNADMIN CMNADMJM CMNADMSO CMNALLIO CMNALLOC CMNAPI CMNAPIS CMNAPIXM CMNAPI2 CMNAPI3 CMNAPPRV CMNAPS10 CMNAPS20

Review the component list. •

If there are many components displayed on your screen, use any of the following methods:

•

Type P and any page number on the command line and press Enter. Change Man will display that page number. (Example: P 4 will display page four of the component entries that match the selection criteria.)

•

Use the PF7 and PF8 keys to page up and page down through the list of components.

•

Type N P to display the next block of components that match the selection criteria.

“Bottom of Data” shown after repeated Page Down commands is not an accurate indication of the end of the component list. Use the Next Page command until “End Of Component List” message is displayed in upper right-hand corner. 4

20-10

To display detailed information about one or more components, type S in the first column next to each component you want displayed, and press Enter. The Component History panel appears.

Change Man Version 4.1.6

Querying Impact Analysis Data

CMNCMPHI --------------------- IEBCOPY.JCL HISTORY ---------- ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> PAGE Press ENTER to continue. PACKAGE ID STA PROMOTION VV.MM LAST ACTION SIZE PROCNAME ID NAVI000005 DEV 02.02 1997/08/18 15:58 24 WSER85 NAVI000001 DEV 02.00 1997/08/13 13:45 24 WSER85 ******************************* Bottom of data ******************************

NOTES Components that are not in the package master have a status of D/A (deleted or archived).

QUERYING IMPACT ANALYSIS DATA Impact analysis is a Change Man facility used to determine relationships and dependencies between the following baseline library components: •

SRC - CPY (source and copylib)

•

LOD - LOD (load and load)

•

PRC/ JCL - DSN

•

PRC/ JCL - PGM

•

PRC/ JCL - PRC

There are two versions of the impact analysis facility: •

Flat - Sequential file which is not automatically updated by Change Man when relationships change in production. As determined by your administrator, based on your environment and workload, the file can be refreshed periodically by the batch job, CMNASIST, which can be scheduled using an automatic scheduler.

•

DB2 Table - DB2 table containing relationship data which are automatically updated during the baseline ripple function when relationships change in production.

Change Man User Guide

20-11

20 Querying Packages and Components

Check with your administrator to determine which version of the impact analysis facility is used at your site and how it is implemented. By querying impact analysis data for select components you can do the following: •

Assess the effort involved in completing an intended change.

•

Estimate staffing schedules.

•

Avoid product failures caused when a change is Installed but related components have been omitted.

Specify Search Criteria for the Component List This panel lets you query the impact of a selected component. Specify search criteria for components to be analyzed. 1

Select Option Q on the Primary Option menu.

2

Select Option I on the Query Options panel. The following panel displays.

CMNIMPMP --------------- IMPACT ANALYSIS OF COMPONENTS --------------------COMMAND ===> SPECIFY SEARCH CRITERIA: COMPONENT NAME ===> COMPONENT TYPE ===> APPLICATION ===> RELATIONSHIP ===> RELATIONSHIP TO ===>

ALLIO JCL NAVI ALLIOCPY

Press ENTER to process; Enter END command to exit.

20-12

Field

Description

COMPONENT NAME

Type a component name, a full data set name, or a component pattern ending in the wild card character *. For example: CMNIMPL and CMN* .

Change Man Version 4.1.6

Querying Impact Analysis Data

Field

Description

COMPONENT TYPE

Indicate a library type. The list of library types is dependent on your Global Generation for library types. The sacred list consists of SRC, CPY, LOD, JCL, PRC, DOC, LCT, DBR, and DBB, but there may be many more. The library types in your list should reflect the contents of the libraries. To display a list of library types, leave this field blank and press Enter. The Type Selection List displays .

APPLICATION

Type an application name to limit your search to a specified application. To obtain a list of applications leave this field blank and Change Man displays the Component Selection List..

RELATIONSHIP

Type a relationship to further clarify the request. To obtain a list of relationships, leave this field blank and press Enter. You must specify a relationship by specifying a library type first. The list of relationships can look for the following: CPY a component COPY s, INCLUDE s, or EXEC another component.

SQL s

LOD a load component contains a statically linkage edited called subroutine; external references are captured. PGM a JCL or PRC component invokes a program via EXEC PGM= . DSN a JCL or PRC component references a dataset name temporary dataset names (those starting with ampersand ’&’) are not taken component names and GDG (take up to the open parenthesis) references are stripped off first. RELATIONSHIP TO

3

If you type a component name in this field it shows the backward relationship to the component name. If you leave it blank, it shows the forward relationship.

After typing the specific information, press Enter. The Application Selection List panel displays.

Change Man User Guide

20-13

20 Querying Packages and Components

CMNIMPP3 ----------------- APPLICATION SELECTION LIST ------------ ROW 1 OF 5 COMMAND ===> SCROLL ===> PAGE COMPONENT NAME: ALLIO COMPONENT TYPE: SRC RELATIONSHIP: RELATIONSHIP TO: APPL s NAVI _ C410 _ SERA _ BRP _ CKL1 ****************************** Bottom of data *****************************

4

From the Application Selection List panel, select the desired application and press Enter. The Type Selection List panel appears.

CMNIMPP2 -------------------- TYPE SELECTION LIST -------------- ROW 16 OF 47 COMMAND ===> SCROLL ===> PAGE COMPONENT NAME: ALLIO APPLICATION: NAVI RELATIONSHIP: RELATIONSHIP TO:

_ _ _ _

TYPE MSG LSO LST DBB

DESCRIPTION

5

20-14

Type S to select the type SRC, and press Enter. The Component Relationship panel displays.

Change Man Version 4.1.6

Querying Impact Analysis Data

CMNIMPP4 ------------------ COMPONENT RELATIONSHIPS ------------- ROW 1 OF 24 COMMAND ===> SCROLL ===> PAGE Enter END command to exit. COMPONENT NAME: ALLIO COMPONENT TYPE: SRC APPLICATION: NAVI RELATIONSHIP: RELATIONSHIP TO: REL CPY CPY CPY CPY

TO OR FROM ENTITY CMN$GLBL CMN$LOG CMN$SETC CMNCOMRT

Query the Component Selection List On the Impact Analysis of Components panel, if you left the application field blank, the Component Selection List panel appears. CMNIMPP1 ------------------ COMPONENT SELECTION LIST -------------------------COMMAND ===> SCROLL ===> PAGE COMPONENT NAME: ALLIO COMPONENT TYPE: SRC APPLICATION: NAVI RELATIONSHIP: RELATIONSHIP TO: COMPONENT NAME _ CMNBOW10 _ CMNCDCPR s CMNCDCPY

Type an S next to the desired component name and press Enter. The Component Relationships panel appears.

Change Man User Guide

20-15

20 Querying Packages and Components

CMNIMPP4 ------------------ COMPONENT RELATIONSHIPS ------------- ROW 1 OF 24 COMMAND ===> SCROLL ===> PAGE Enter END command to exit. COMPONENT NAME: ALLIO COMPONENT TYPE: SRC APPLICATION: NAVI RELATIONSHIP: RELATIONSHIP TO: REL CPY CPY CPY CPY CPY CPY CPY CPY CPY CPY CPY CPY

TO OR FROM ENTITY CMN$GLBL CMN$LOG CMN$SETC CMNCOMRT CMNDYNAL CMNFMAIN CMNGMAIN CMNIMPSQ CMNLDCA CMNMBRLS CMNPATCH CMNPDSDR

The Component Relationships panel displays all upstream and downstream relationships for a requested component. A component which calls the requested component has an upstream relationship with the requested component. On the other hand, the component which is called by the requested component has a downstream relationship with the requested component.

20-16

Change Man Version 4.1.6

PACKAGE CATEGORY PANELS

A

This appendix displays the panels that appear when you make a selection on the Package Information Categories panel (CMNQRY03). See Chapter 20 Querying Packages and Components.

GENERAL INFORMATION Following are the general information panels. CMNQRY10 ----------------- QUERY: CONTROL INFORMATION -------------------COMMAND ===> PACKAGE ID: NAVI000005 COMPLEX/SUPER ID: NAVI000003

STATUS: APR STATUS: OPN

INSTALL DATE: 19971230

PACKAGE TITLE ===> This is to install test jcl. APPLICATION REQUESTER’S NAME REQUESTER’S PHONE WORK REQUEST ID DEPARTMENT PACKAGE LEVEL

===> ===> ===> ===> ===> ===>

NAVI I.PROGRAMMER 555-1212 416NAVIG DP 4 (1-Simple, 2-Complex, 3-Super, 4-Participating) PACKAGE TYPE ===> P (Planned or Unplanned) PACKAGE TIME SPAN ===> P (Permanent or Temporary) UNPLANNED REASON CODE ===> TEMPORARY CHANGE DURATION ===> (In days) Enter END command to continue.

A-1

A Package Category Panels

CMNPGNL2 ---------------COMMAND ===>

PACKAGE ID: NAVI000005

PACKAGE DESCRIPTION -------------- ROW 1 TO 1 OF 1 SCROLL ===> PAGE

STATUS: DEV

INSTALL DATE: 19971230

(minimum one line, maximum 46 lines) ‘’’’ _This is to install test JCL. __________________________________________ ******************************* BOTTOM OF DATA ********************************

CMNPGNL3 ------------- UPDATE: INSTALLATION INSTRUCTIONS ---- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000005 CONTINGENCY ===> 1

SCHEDULER

STATUS: DEV

INSTALL DATE: 19971230

1-Hold production and contact analyst 2-Backout change, continue production 3-Other ===>

===> OTHER

(CMN, Manual or Other)

(minimum one line, maximum 46 lines) ‘’’’ Install using procedure #1._____________________________________________ ******************************* Bottom of data *****************************

NON-SOURCE CMNSTG01 ---------------- STAGE: NAVI000005 COMPONENTS ------ ROW 1 TO 4 OF 4 COMMAND ===> SCROLL ===> PAGE NAME TYPE STATUS CHANGED PROCNAME ID REQUEST s_ CPXLOAD JCL CHECKOUT 19970818 145338 WSER85 s_ HOUSKEEP JCL CHECKOUT 19970818 145338 WSER85 s_ IEBCOPY JCL CHECKOUT 19970818 145338 WSER85 __ REPORTS JCL CHECKOUT 19970818 145338 WSER85 ******************************* Bottom of data ******************************

Type B to display the full contents of the component (the CMNBROWS panel displays) or type H to display component history (the History panel displays.

A-2

Change Man Version 4.1.6

Source

You can sort by any field in ascending order, using the Sort command with the keywords NAME or MEMBER. Then, you can issue a Locate command to find a component name.

SOURCE CMNSTG01 ---------------- QUERY: NAVI000009 COMPONENTS ---- ROW 1 TO 11 OF 11 COMMAND ===> SCROLL ===> CSR NAME TYPE STATUS CHANGED LANGUAGE PROCNAME ID REQUEST __ CMNASIST SRC ACTIVE 19970707 162320 ASM CMNASM WSER03 __ CMNBAT40 SRC ACTIVE 19970630 134444 ASM CMNASM WSER42 __ CMNCDCPR SRC ACTIVE 19970708 130440 ASM CMNASM WSER41 __ CMNCOMPR SRC ACTIVE 19970708 165356 ASM CMNASM WSER41 __ CMNIMSG SRC ACTIVE 19970706 110922 ASM CMNASM WSER42 __ CMNMSGCD SRC ACTIVE 19970705 102536 ASM CMNASM WSER03 __ CMNPARSE SRC ACTIVE 19970630 095819 ASM CMNASM WSER03 __ CMNPOPLP SRC ACTIVE 19970705 115544 ASM CMNASM WSER41 __ CMNPROMO SRC ACTIVE 19970701 152743 ASM CMNASM WSER42 __ CMNQUERY SRC ACTIVE 19970629 161428 ASM CMNASM WSER03 __ CMNSTGER SRC ACTIVE 19970701 151422 ASM CMNASM WSER42 ******************************* BOTTOM OF DATA *******************************

1

Type B to display the full contents of the component (the CMNBROWS panel displays) or type H to display component history.

2

Type S to display the compile and link edit options.

3

Type SL to display the Source to Load Relationship panel.

Change Man User Guide

A-3

A Package Category Panels

You can sort by any field in ascending order, using the Sort command with the keywords NAME or MEMBER. Then, you can issue a Locate command to find a component name. CMNQRY22 ------------ QUERY: COMPILE AND LINK EDIT OPTIONS ----------------COMMAND ===> PACKAGE ID: NAVI000005

STATUS: APR

INSTALL DATE: 19971230

DATASET NAME: somnode.navi000005.src LIBRARY ORG: pds STAGER’S TSO-ID: wser85 COMPONENT STATUS: STAGED NAME: allio SOURCE NAME: allio LIBRARY TYPE: src LANGUAGE: asm COMPILE PROC: asm COMPILE PARMS: LINK EDIT PARMS: DB2 PRE-COMPILE: NO OTHER OPTIONS ===> y (Y/N for additional user options) Press ENTER to continue; Enter END command to exit.

A-4

Change Man Version 4.1.6

Source and Load Relationship

SOURCE AND LOAD RELATIONSHIP CMNQRY21 ---------------- SOURCE TO LOAD RELATIONSHIP -----------------------COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005 SOURCE NAME TYPE ALLIO SRC

STATUS: APR

LOAD NAME TYPE STATUS ALLIO LOD ACTIVE

INSTALL DATE: 19971230

PROMOTION CHANGED ID 1 PROMO1 19970701 162320 WSER85

SETSSI 84553124

RENAMES AND SCRATCHES CMNQRY12 ----------------- QUERY: RENAME/SCRATCH LIST -----------------------COMMAND ===> SCROLL ===> PAGE PACKAGE ID: NAVI000005 REQ SCR

NAME RENAME IEBCOPY

TYPE JCL

STATUS: APR

INSTALL DATE: 19971230

CHANGED ID STATUS 19970707 090520 WSER85 ACTIVE

APPROVAL LIST

CMNAPPLS ----------------------- APPROVAL LIST -----------------------------COMMAND ===> SCROLL ===> CSR Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000005

STATUS: DEV

INSTALL DATE: 19971230

APPROVER DESCRIPTION ID DATE TIME SEQ STATUS _ DEVELOPMENT GROUP 001 _ DOCUMENTATION GROUP 002 _ QA GROUP 003 _ MANAGEMENT GROUP 004 ******************************* BOTTOM OF DATA *******************************

Change Man User Guide

A-5

A Package Category Panels

SITE ACTIVITIES DATE AND TIME CMNQRY14 ------------ QUERY: SITE ACTIVITIES DATE AND TIME - ----------------COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005

STATUS: APR

INSTALL DATE: 19971230

REMOTE SITE REMPRM1 REMPRM1

TYPE OF ACTIVITY DATE TIME Distribution Dis-Acknowledgment Installation Temp Change Cycled Full Back-Out Revert Back to DEV ******************************* BOTTOMOF DATA *******************************

SITE AND INSTALL DATE INFORMATION If your administrator has set up your Change Man environment as an “All” site, Change Man displays the Update Site Information panel. CMNONSTE ------------------ UPDATE: SITE INFORMATION ----------------------COMMAND ===> Press ENTER to process; enter END command to exit. PACKAGE ID: NAVI000006

CREATOR: WSER85

INSTALL

DATE AND TIME:

YYYYMMDD 19971230

FROM 0700

TO 1600

STATUS: DEV

PRIMARY/BACKUP CONTACTS Boss_____________________ Asst Boss________________

PHONE NUMBERS xt277__________ xt259__________

Otherwise, Change Man displays the Query Remote Site Information panel.

A-6

Change Man Version 4.1.6

Custom Forms

CMNPRSTI -------------COMMAND ===>

REMOTE SITE INFORMATION ----------------------------SCROLL ===> PAGE

Press ENTER to process; enter END command to exit. Enter * in line command field for remote site selection list. PACKAGE ID: NAVI000005

CREATOR: WSER85

STATUS: DEV

REMOTE INSTALL DATE/TIME SITE YYYYMMDD FROM TO PRIMARY/BACKUP CONTACTS PHONE NUMBERS ‘’’’ remote1__ 19971230 0900 1800 Boss_____________________ x275___________ 0900 1600 Asst Boss________________ x276___________ ******************************* BOTTOM OF DATA ********************************

CUSTOM FORMS

CMNCUSTM --------------- UPDATE: CUSTOM COMPONENT LIST ---COMMAND ===> PACKAGE ID: NAVI000005

STATUS: DEV

ROW 1 TO 10 OF 10 SCROLL ===> PAGE

INSTALL DATE: 19971230

Press ENTER to process; Enter END command to exit. LINE COMMANDS: S - Select, D - De-Select, X - Submit for Approval A - Approve, R - Reject, B - Browse Reject Reasons LEAD DAYS COMPONENT DESCRIPTION TIME LEFT STATUS FUNCTION s’’’ Build Generation Data Group Request 0 133 ACTIVE *Select ‘’’’ Dasd Request - Data Set Space 0 133 ‘’’’ Problem Summary 0 133 ‘’’’ Report Distribution Information 0 133 ‘’’’ UDPO Standards and Guidelines Revision 0 133 ‘’’’ Tape Retention Register 0 133 ‘’’’ UDPO Standards Exemption Request 0 133 ‘’’’ Security Information 0 133 ‘’’’ CA7 Jcl Update 0 133 ‘’’’ CA7 Operations Schedule Update 0 133 ******************************* Bottom of data *******************************

Change Man User Guide

A-7

A Package Category Panels

PARTICIPATING PACKAGE CMNQRY11 --------------- QUERY: PARTICIPATING PACKAGES ----------------------COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005 PACKAGE ID NAVI000006 NAVI000003 NAVI000008

STATUS DEV DEV INS

STATUS: APR

INSTALL DATE 19971230 19971230 19970730

STATUS START DATE AND TIME CMNQRY04 ------------- QUERY: STATUS START DATE AND TIME ------------------COMMAND ===> Press END command to exit. PACKAGE ID: NAVI000005 STATUS DEV REV-DEV FRZ APR REJ

STATUS: APR DATE 19970701

TIME 0830

19970811 19970819

1530 1645

INSTALL DATE: 19971230

REVERT REASONS CMNREVRS ------------------COMMAND ===> PACKAGE ID: NAVI000005

REVERT REASONS ------------------------------

STATUS: FRZ

INSTALL DATE: 19971230

===> This package had errors. ===> ===> ===>

A-8

Change Man Version 4.1.6

Backout Reason

BACKOUT REASON

CMNQRY13 ---------------- QUERY: BACKOUT REASONS LIST -----------------------COMMAND ===> SCROLL ===> PAGE PACKAGE ID: NAVI000005

STATUS: BAK

INSTALL DATE: 19971230

REMOTE SITE DATE TIME _ REMPRM1 19970823 111500

PROMOTION HISTORY

CMNQRY23 ----------------- PACKAGE PROMOTION HISTORY ------- ROW 1 TO 15 OF 65 COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005 PROMOTE/DEMOTE HISTORY LVL Selective Promotion 1 Selective Demotion 1 Selective Promotion 1

Change Man User Guide

STATUS: ACTIVE

INSTALL DATE: 19971230

NICKNAME DATE TIME LEVEL1 1997/03/01 16:47 LEVEL1 1997/03/01 16:46 LEVEL1 1997/03/01 14:25

ID WSER85 WSER85 WSER85

A-9

A Package Category Panels

REMOTE PROMOTION HISTORY CMNQRY26 ------------ REMOTE PROMOTION SELECTION LIST -----------------------COMMAND ===> SCROLL ===> PAGE Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005 REMOTE SITE NAME _ REMPRM1

CREATOR: WSER85

STATUS: DEV

INSTALL DATE: 19971230

FORCE DEMOTION (Y/N) REMOTE LOCAL NO NO

Type S next to a remote site to view the (Promotion and Demotion) package list, and press Enter. A panel similar to the following appears. CMNQRY27 - PACKAGE REMOTE PROMOTION HISTORY FOR NAVI000009 - ROW 49 TO 64 OF 133 COMMAND ===> SCROLL ===> PAGE Press ENTER for component list; Enter END command to exit. PACKAGE ID: NAVI000009

CREATOR: WSER85

REMOTE HISTORY MOD/CNT PROMOTION Selective Promotion 3 2 TEST102 Selective Demotion 2 2 TEST102 First Promotion at 0 6 2 TEST102 Full Demotion 1 0 STAGING Selective Promotion 2 1 TEST101 Selective Demotion 2 1 TEST101 Full Promotion 7 1 TEST101

STATUS: DEV DATE 1997/07/16 1997/07/16 1997/07/16 1997/07/16 1997/07/15 1997/07/15 1997/07/15

INSTALL DATE: 19971230 TIME 16:14 16:33 16:49 15:47 16:34 16:33 16:32

ID WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85

REMOTE Completed Completed Completed Completed Completed Completed Completed

Press Enter to view the remote promotion status at the component level. The following panel displays.

A-10

Change Man Version 4.1.6

Promotion Libraries

CMNQRY28 -COMPONENT REMOTE PROMOTION STATUS FOR NAVI000005-- ROW 1 TO 15 OF 15 COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005 NAME TYPE $$$BRWBL CPY AL CPY AUDIT CPY CMN$$BND CPY CMNEX009 LOD CMNEX009 SRC CMNEX026 LOD CMNEX026 CPY CMNEX027 LOD CMNEX027 SRC CMNEX028 LOD CMNEX028 SRC CMNEX035 LOD CMNEX035 SRC CMNMOD CPY

CREATOR: WSER85

PROMOTION 0 STAGING 0 STAGING 2 TEST102 2 TEST102 2 TEST102 2 TEST102 2 TEST102 2 TEST102 2 TEST102 1 TEST102 0 STAGING 0 STAGING 1 TEST101 0 STAGING 0 STAGING

DATE 1995/07/21 1995/06/22 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1997/07/26 1995/07/16

STATUS: APR TIME 17:54 15:20 20:01 20:01 20:01 20:01 20:01 20:01 20:01 20:01 20:01 20:01 20:01 20:01 18:36

ID WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85 WSER85

INSTALL DATE: 19971230 STATUS DELETED

OVERLAID

RESTAGED DELETED DELETED DELETED

PROMOTION LIBRARIES

CMNQRY24 --------COMMAND ===>

- PROMOTION LIBRARIES PART 1 OF 2 -----------------------SCROLL ===> PAGE

Press END command to exit. PACKAGE ID: NAVI000006

STATUS: DEV

INSTALL DATE: 19971230

NICKNAME ENTITY LEVEL PROCEDURE _ UNIT UNITDEMO 1 _ ACCEPT ACCPDEMO 2 _ QCQC QCQCDEMO 3 ******************************* BOTTOM OF DATA *******************************

Change Man User Guide

A-11

A Package Category Panels

CMNQRY25 ------------ PROMOTION LIBRARIES PART 2 OF 2 ------- ROW 1 TO 5 OF 8 COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000006

STATUS: APR

LIB CPN

DATASET NAMES FOR NICKNAME , LEVEL 1 USERID.CMN410U.PANELS

DBB

USERID.CMN410U.CNTL

DBR

USERID.CMN410U.CNTL

HPN

USERID.CMN410U.PANELS

LOD

USERID.CMN410U.LINKLIB

INSTALL DATE: 19971230

REMOTE PROMOTION LIBRARIES

CMNQRY29 -----COMMAND ===>

- REMOTE PROMOTION LIST PART 1 OF 3 -------- ROW 1 TO 9 OF 9 SCROLL ===> PAGE

Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005 CREATOR: WSER85

_ _ _ _ _ _ _ _ _

A-12

REMOTE SITE NAME TEST TEST10 TEST2 TEST3 TEST4 TEST5 TEST6 TEST7 TEST8

FORCE DEMOTION (Y/N) REMOTE LOCAL Y Y N Y N Y N Y Y N N Y Y N N Y Y N

STATUS: APR INSTALL DATE: 19971230 INTERNAL READER CLASS REMOTE LOCAL A A J B A A L D M E N F O G P H Q I

Change Man Version 4.1.6

Remote Promotion Libraries

Type S next to a remote site to view package library information, then press Enter. The following panel displays. CMNQRY30 ----- / - REMOTE PROMOTION PART 2 OF 3 ------------- ROW 1 TO 2 OF 2 COMMAND ===> SCROLL ===> PAGE Press ENTER to process; Enter END command to exit. PACKAGE ID: NAVI000005 CREATOR: WSER85

STATUS: DEV INSTALL DATE: 19971230

NICKNAME ENTITY LEVEL PROCEDURE _ TEST101 DAVE 1 CMN$$RPM _ TEST102 DAVE 2 CMN$$RPM ****************************** BOTTOM OF DATA ********************************

Type S next to the promotion levels that you want to view, then press Enter. CMNQRY31 - REMOTE PROMOTION LIBRARIES PART 3 OF 3 ---------------------------COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005 CREATOR: WSER85 LIB JCL JCL JCL JCL

STATUS: APR INSTALL DATE: 19971230

DATASET NAMES FOR NICKNAME , LEVEL SOMNODE.DATA.SET.NAVI000005.SHADOW_______________ Shadow Library SOMNODE.DATA.SET.NAVI000005.PRM1_________________ Promotion Library 1 SOMNODE.DATA.SET.NAVI000005.PRM2_________________ Promotion Library 2 SOMNODE.DATA.SET.NAVI000005.PRM3_________________ Promotion Library 3

Change Man User Guide

A-13

A Package Category Panels

QUERY DEVELOPMENT STAGING LIBRARIES CMNQRY05 ---------- QUERY: DEVELOPMENT STAGING LIBRARIES -- ROW 1 TO 10 OF 10 COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005

STATUS: APR

INSTALL DATE: 19971230

LIB DEVELOPMENT STAGING LIBRARY CLS WSER99.CMN.DEMO.#000025.CLS CPY WSER99.CMN.DEMO.#000025.CPY FIX WSER99.CMN.DEMO.#000025.FIX HPN WSER99.CMN.DEMO.#000025.HPN JCL WSER99.CMN.DEMO.#000025.JCL LOD WSER99.CMN.DEMO.#000025.LOD LST WSER99.CMN.DEMO.#000025.LST MPN WSER99.CMN.DEMO.#000025.MPN SKL WSER99.CMN.DEMO.#000025.SKL SRC WSER99.CMN.DEMO.#000025.SRC ******************************* BOTTOM OF DATA *****************************

A-14

Change Man Version 4.1.6

Query Production Staging Libraries

QUERY PRODUCTION STAGING LIBRARIES CMNQRY06 ---------- QUERY: PRODUCTION STAGING LIBRARIES ---- ROW 1 TO 10 OF 10 COMMAND ===> SCROLL ===> PAGE Press END command to exit. PACKAGE ID: NAVI000005

STATUS: DEV

INSTALL DATE: 19971230

LIB PRODUCTION STAGING LIBRARY CLS WSER99.CMN.DEMO.#000025.CLS CPY WSER99.CMN.DEMO.#000025.CPY FIX WSER99.CMN.DEMO.#000025.FIX HPN WSER99.CMN.DEMO.#000025.HPN JCL WSER99.CMN.DEMO.#000025.JCL LOD WSER99.CMN.DEMO.#000025.LOD LST WSER99.CMN.DEMO.#000025.LST MPN WSER99.CMN.DEMO.#000025.MPN SKL WSER99.CMN.DEMO.#000025.SKL SRC WSER99.CMN.DEMO.#000025.SRC ******************************* BOTTOM OF DATA ****************************

PRODUCTION LIBRARIES If your administrator has set up your Change Man environment as an “All” site, Change Man displays the Query Production Libraries panel (CMNQRY07). CMNQRY07 ------------ QUERY: COMMAND ===>

PRODUCTION LIBRARIES --------

ROW 1 TO 1 OF 1 SCROLL ===> PAGE

Press END command to exit. PACKAGE ID: NAVI000005

STATUS: DEV

INSTALL DATE: 19971230

TYPE

PRODUCTION DATASET NAME TEMPORARY DATASET NAME BACKUP DATASET NAME LOD WSER99.CMN410.PROD.LINKLIB NULLFILE WSER99.CMN410.PROD.LINKLIB ******************************* BOTTOM OF DATA ****************************

Change Man User Guide

A-15

A Package Category Panels

Otherwise, Change Man first displays the Remote Site Selection List in order for you to choose a remote site, and then displays the Query Production Libraries panel.

BASELINE LIBRARIES CMNQRY08 ------------- QUERY: COMMAND ===>

BASELINE LIBRARIES ---------

ROW 1 TO 15 OF 46 SCROLL ===> PAGE

Press END command to exit. PACKAGE ID: NAVI000006 LIB SRC SRO LOD CPY MPN HPN CPN SKL MSG LST JCL DBB DBR CCC HHH

A-16

STATUS: DEV

INSTALL DATE: 19971230

BASELINE LIBRARY NAME WSER99.CMN410.ASSEMBLE WSER99.CMN410.ASSEMBLE WSER99.CMN410.LINKLIB WSER99.CMN410.COPYLIB WSER99.CMN410.FMAINPAN WSER99.CMN410.FHELPPAN WSER99.CMN410.FCUSTPAN WSER99.CMN410.SKELS WSER99.CMN410.MSGS WSER99.CMN410.LST WSER99.CMN410.CNTL WSER99.CMN410.DBB WSER99.CMN410.CNTL WSER99.CMN410.ASSEMBLE WSER99.CMN410.HHH

Change Man Version 4.1.6

GLOSSARY Change Man Application An application refers to the project or domain of user software being implemented. It is named and defined by the application administrator, and may be a mnemonic. When the application administrator defines an application domain, they set user restrictions for it. See the administrator for these details. When you encounter an application field you can type in the exact name of the application, or you can usually select from a list of applications by typing a pattern, or masking. Possible References: APPL, PROJECT, LOCAL

Change Package A package refers to a group of changes to user software. There are three levels of change packages: simple, super/complex, and participating. These will be explained later in this section. Packages can be created by any TSO user authorized to use Change Man. They are made up of members of partitioned datasets such as JCL, source code, copybooks, etc., which are called components.

Package ID or Name Each change package that is built with Change Man is assigned a unique ID which is a combination of the application name and a unique number. You should take note of assigned IDs as they are needed to update or review the change package. When typing the package IDs you need to always key in the application mnemonic, but you can truncate the number to only the relevant part. For example: •

CGM 000012 — may be rendered as CGM 12 , or CGM 012 , or CGM 00012 , or as shown.

•

XYZV130056 — type it, as shown.

•

UHRD004061 — may be rendered UHRD4061 , or UHRD04061 , or as shown.

•

@13 045300 — may be rendered @13 45300 , or as shown.

G-1

Glossary

•

$B29000246 — may be rendered $B29246 , or $B290246, or $B2900246 , or as shown.

Sometimes this field is editable and you need to key in the change package name or access a list of change packages. At other times it is provided for your reference. Possible References: PKG NAME, PACKAGE NAME, PKG ID, PACKAGE ID

Package Level The concept of change package levels in Change Man indicates the complexity, and is designated when you create the package. Different levels have different behavior and creation requirements. •

Simple

A simple change package is a component of a complex or a super change package. This level of change package does not affect any other application, or it does not require them to make any changes to their software or operational procedures. •

Super and Complex

You are creating the “parent” change package for two or more change package applications that have related or interdependent changes, or have major changes to application processing which result in a major impact on the data processing environment. Super and complex change packages contain only control, general information, and a list of the participating packages. There are no staging libraries associated with super/complex change packages. Remote site and the installation dates for each site are tracked in the participating change packages. Once created, super or complex packages are automatically marked for limbo causing them to immediately display within the Monitor Packages in Limbo option. It is from this monitor function that their status is changed to closed. A super change package is functionally equivalent to a complex package. Use super to draw attention to, or segregate, packages.

•

G-2

Participating

Change Man Version 4.1.6

Glossary

A participating package is a variation of a simple package that allows an association to one or more additional participating packages. By using participating packages you can: — Account for other packages' copybooks or load module staging libraries during compile or link processing. — Combine the approvers of different applications (Not applicable to participating packages within the same application). Participating change packages must be created prior to their being listed as participating in the “parent” change package. Your package’s copybook and load module staging libraries are always concatenated before other participating packages in the SYSLIB DDNAME of compile/link steps. The order of the other packages is based upon the order of the packages listed in the complex packages.

Permanent or Temporary A permanent change package is a package that is enduring and is only deleted if requested by a user. It can be rippled into the baseline library. A temporary package is a package that is not permanent and is never rippled into the baseline library. It is automatically deleted from production after a specified number of days.

Planned or Unplanned A planned change package is created during normal business hours (defined in global parameters) in a non-emergency situation. Its implementation is subject to the complete Approval List. Its scheduling for installation is governed by the Planned Installation Calendar.

Change Man User Guide

G-3

Glossary

An unplanned change package is created for an emergency situation, often outside of normal business hours. Its implementation is subject to the complete Approval List if it is actually created during normal business hours. If it is created outside of normal business hours, its approval is based on the abbreviated Approval List.Its installation date is not dependent on the Planned Installation Calendar.

Use this type of change package . . .

In this situation . . .

Planned permanent

Schedule and install permanent updates to production software

Planned temporary

Set up and run special one-time or short-term processing (i.e., conversion, parallel processing, special reports or extractions)

Unplanned permanent

Make emergency fixes to production software which will need to be executed for multiple cycles of processing.

Unplanned temporary

Make short term or one-time-only emergency fixes to production software

Installation Job Scheduler The scheduling system for a package controls the submission of the package’s installation batch jobs. This field may already contain a default value if the administrator set the value when setting up Change Man for your site. NOTES The global administrator sets this parameter in part 1 of the Global Parameters Panels (CMNGGP01). You can change this field by typing in the scheduler of your choice. The options are: •

CMN - Change Man internal scheduling.

When packages use the CMN scheduler, CMN monitors either “hold” or install. See the Administrator Guide for details on these capabilities. •

G-4

MANUAL - Manually control the submission of installation jobs.

Change Man Version 4.1.6

Glossary

This causes the installation process to begin as soon as all approvals have been obtained. Package installation can be inhibited by holding the last approval or installed immediately by approving the package before the scheduled installation date and time. If the default scheduler is MANUAL, you cannot change this field. •

OTHER - An external scheduler such as CA7, ADC2, CA-Scheduler, Control-M, etc.

If the default scheduler is OTHER you can change this field to either CMN, or MANUAL. If CMN is the default, you can change this field value to MANUAL. When you specify OTHER when creating packages, the Scheduling Information panel displays after it. Depending on your scheduler, you may need to provide this optional information. When you specify OTHER when updating packages you must remember to access the Scheduling Information panel (Option 4 ) from the Update Change Package Information panel to change this information.

Install Date The date in which you want to install your change package.

Component Concepts A component is a single member of a change package (a change package is a combination of components which make up a unit of change). Usually, it is a member of a library that has been brought into Change Man for the purpose of being modified. The following concepts relate to components.

Component Name The name of the component can be selected from a list of components (although you may need to provide some qualifying information for the list, such as a library type or application name), or by typing a pattern (signified by * , following the relevant portion of the application name) or a blank in the component name field. Possible References: COMPONENT, MEMBER, MODULE

Change Man User Guide

G-5

Glossary

Component Version (VV.MM) Change Man keeps track of the component’s version and modification number by following IBM standards (mm starts at 01, increments to 99 and stays there; vv starts at 01, increments to 99 and then recycles to 01). The first time the component is processed by Change Man, the vv.mm will be 01.01. Each successive stage request (within the same change package) will increment the mm portion (01.02, 01.03 etc.). The next package using the component will cause the vv portion to be incremented (02.01).

Component Library Type You can select a library type from a list by leaving the field blank, and pressing Enter. The list of available library types is set by your application administrator, and may a be a combination of reserved, like or custom library types. •

Reserved are component types which are internally defined to Change Man.

•

Like are components which act similar to Change Man's reserved components.

•

Custom are components which have been designed at your site for its unique needs.

Your components which require special processing such as those of type source (SRC) may have compile procedures (described below) designated for them. These procedures are usually associated with the language name associated with the component type. Possible References: COMPONENT TYPE, LIBRARY TYPE, TYPE.

Language Name (Language Assumption) The language name is the programming language associated with a component which requires special processing such as the source (SRC) component. The language name of a component is important because associated with each language are customized predefined compile procedures. This information is particularly important when performing checkout or stage of components. When you checkout new components Change Man lets you either choose a language (from a list of available ones) or use the one that the administrator has designated for it. To use the component defined procedures designated by the application administrator, type the language in the Checkout panel.

G-6

Change Man Version 4.1.6

Glossary

If the component is not new and has a checkout history, history records on the component’s characteristics were saved. Change Man performs the following steps to determine the language name of a component: 1

Designation - initiates Designated Procedures force option level 2

2

Specified - checks if a specified language name is used for the components

3

History - if history exists for the components

4

Designation - the application administrator has designated a language for the component type

5

Last Used Language

For either a single component or multiple components, you are prompted for input. Change Man cannot determine the language for the first component in the list; if multiple components are being checked out or staged, Change Man uses the language of the first item in the list for all subsequent components in the list. If the procedure has been designated 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. Change Man 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 at all times. When designating a procedure for the component, the application administrator may have used extra compile and/or link options. NOTES See the Change Man Administrator Guide, Version 4.1.6 for Designated Procedures and Component Level Security.

Compile Procedure The compile procedure is used for processing special components like source (SRC). Compile procedures are related to the language name of a component. Usually you can choose from a list of available procedures for a component by leaving the compile procedure field blank. (If there is only one compile procedure defined for a certain language, this field cannot be modified.)

Change Man User Guide

G-7

Glossary

You can use compile procedures and options designated by your application administrator by typing a ?. The appropriate procedure and options are displayed in the other fields. Possible References: PROCEDURE, COMPILE PROC, PROCEDURE NAME

Mode Many Change Man functions allow you to process a function on-line or in batch mode. When you choose batch mode you are prompted for batch job card information in an additional panel, but only need to fill it in the first time unless there is a change necessary. Possible References: ONLINE BROWSE.

Confirmation Requests Confirmation requests let you tell Change Man whether or not major operations shall prompt you before running the function. YES indicates that a confirmation is required when doing such things as overlaying a target file when running checkout. A NO in this field indicates to Change Man that the function should be run without a user confirmation. Most of the time this parameter is an all-or-none parameter. You cannot require confirmation for some packages and components and not for others.

Data Set Organization (DSORG) This indicates a library’s type of organization. Following are the usual options: •

PDS - partitioned data set (Basic Partitioned Access Method {BPAM})

•

SEQ - sequential file (Queued Sequential Access Method {QSAM})

•

PAN - Panvalet library

•

LIB - Librarian master

•

OTHER - any other type of library organization

This is not a required field; if left blank, Change Man can determine the DSORG. Possible References: ORGANIZATION, DSORG

G-8

Change Man Version 4.1.6

Glossary

Remote Site Often when using Change Man you need to indicate what remote sites are affected by a function. If you do not have remote sites you can ignore this field, or more likely, it does not appear. You may be prompted to provide remote site information when you are creating change packages and indicating where the package is to be installed.

ID or TSO ID TSO USERID that performed a function. Possible References: TSOID

Change Man User Guide

G-9

Glossary

G-10

Change Man Version 4.1.6

INDEX

A AC 8-21 accessing online error messages, short and long 3-10 action requested, field description 10-4, 11-5 activity file not checked out (SYNCH6!) 8-28 activity log about 19-1 audit return codes 8-33 producing a report 19-4 reviewing 19-3 Activity Log Entries panel (CMNLOGDS) 19-3 administration, global audit options 8-29 process by install date options 8-33, 8-42 affected applications, about 5-7 alias-of, column description 8-21 and/or, field description 19-20 API jobs, submitting 8-3 application about G-1 local, about G-1 application, field description 4-3, 5-3, 19-8, 19-19, 20-13 approval entity name, field description 13-3 Approval List panel (CMNAPPLS) 13-5, A-5 Approve Package Parameters panel (CMNAPPRV) 13-2 Approve/Reject Options panel (CMNAPPOP) 13-5 approving frozen packages 2-7 approving or rejecting packages 13-2 archived, see status as member name, field description 19-12 ASA carriage control 8-4 ATTR, column description 8-21 audit

about 2-5, 8-1 by install date 8-10, 8-34 cross application 8-7 full 8-8, 8-24 methods 8-7 pre- 8-7 running 8-9 success or failure 8-9 under emergency conditions 8-1 upgraded components 8-48 audit auto-resolve 8-2, 8-3, 8-9 Audit Change Package panel (CMNAUDIT) 8-2 audit change package panel fields audit as a complex package 8-36 audit as a primary package 8-6, 8-36 audit as a simple package 8-5, 8-36 audit participating package by dept number 8-7 audit staging libraries only 8-3, 8-8 auto resolve out-of-synchs 8-3, 8-9 cross application audit 8-7 format report for printing 8-4 include history records 8-3 job statement information field descriptions 8-7 audit lite 8-3 audit log file activity updates 8-25, 8-34 audit pass field 8-9 audit RC, field description 20-7 Audit Report about 8-11 body 8-14 column descriptions, see CPY, LOD, and SRC evaluating 8-26 format changes 8-12 header 8-12 header, copy section 8-13 similarities in output 8-24 view online 8-4, 8-8 Audit Report columns

I-1

Index

dept 8-13 package 8-13 see also CPY, LOD, and SRC Audit Report sections baseline 8-15, 8-24 component history area 8-16, 8-18 COPYLIB components in 8-22 load (LOD) 8-20 staging 8-15, 8-24 audit return code updates 8-25 audit return codes 8-24, 8-26, 8-33, 8-39, 8-43 audit staging libraries 8-7, 8-24 auto-resolve, audit 8-2, 8-3, 8-9

B backing up 2-9 backout about 2-11 from remote site 15-3 package out of production 15-1 Backout Change Package panel (CMNBKOUT) 15-2 Backout Reasons panel (CMNBKRSN) 15-2 baseline by site 6-5 component history Audit Report section 8-18 kept for sites at a DP/P shop 6-5 library 8-27, 8-29 ripple 8-27, 8-29, 8-32 Baseline Audit Report section 8-15 baseline browse/print facility 19-6 Baseline Browse/Print Facility panel (CMNBRWB0) 19-6 baseline/staging discrepancy (SYNCH13!) 8-29 baselined 8-32, 8-34, 8-37, 8-43 batch checkout, unlock components 6-7 mode G-8 stage 7-10 Browse Activity Log panel (CMNLOGE2) 19-4 Browse Activity Log panel (CMNLOGEX) 19-2 Browse Compressed Listing panel (CMNBLST0) 19-14 browsing activity log 19-1 compressed listings 19-1, 19-13 editing components 19-11 global notification facility 19-16

I-2

C CAF (component activity file) 8-28 called subroutine in baseline (SYNCH8!) 8-28 called subroutine in staging (SYNCH7!) 8-28 called subroutines 8-23 calling load component, first 8-23 case sensitive, field description 19-9 case sensitive?, field description 19-20 Change Man about 2-1 online error messages, short and long 3-10 change package installation instructions 4-6 Change Package List panel (CMNLIST3) 16-5 change packages, A-E about G-1 approving 13-1 backing out of production 15-1 deleting 17-5 emergency G-3 change packages, creating about 4-1 change packages, demoting from a local system 10-1 from a remote system 11-1 change packages, F-Q freezing 9-1 job scheduler G-4 level G-2 permanent G-3 planned G-3 querying 20-1 change packages, promoting to a local system 10-1 to a remote system 11-1 change packages, R-Z rejecting 13-1 remote promotion 11-2 remote site 4-11 reverting 14-1 scheduling dependencies 4-8 single site 4-9 status G-4 temporary G-3 undeleting 17-5 unplanned G-3 change packages, updating about 5-1 affected applications 5-7 complex 5-8 control information 5-2

Change Man Version 4.1.6

Index

description 5-4 installation information 5-8 installation instructions 5-5 remote site 5-9 scheduling dependencies 5-6 single site 5-10 site information 5-8 super 5-8 super/complex package status 5-12 changed from/to date, field description 7-17 changed, column description 8-18 check out to, field description 6-6 checkout about 2-3 baseline by site remote selection list displayed 6-5 options 6-1 restrictions 6-1 rules 6-1 checkout components about 6-1 from baseline 6-3 from promotion 6-3 checkout library dsorg, field description 6-6 checkout library type, field description 6-5 checkout mode, field description 6-7 Checkout Options panel (CMNMCKOT) 6-3 checkout package driven list 6-7 ID list 6-7 ID, field description 6-5 checkout panel field descriptions check out to 6-6 checkout mode 6-7 component name 6-5 confirm request 6-6 language 6-5 library dsorg 6-6 library type 6-5 lock component 6-7 package ID 6-5 personal library 6-6 source library 6-6 CMN30 9-3 CMN37 9-3 CMN55 9-3 CMN57 9-3 CMNASIST 20-11 see also impact analysis CMNPMXJB CMN30 skeleton job 9-3

Change Man User Guide

CMN37 skeleton job 9-3 CMN55 skeleton job 9-3 CMN57 skeleton job 9-3 CMNPMXJB module 9-2 CMNPRM05 10-9 column descriptions install date 4-10, 4-11, 5-10, 5-11 time from 4-10, 4-11, 5-10, 5-11 time to 4-10, 4-11, 5-10, 5-11 LCMD 5-9, 5-11 phone numbers 4-12, 5-10, 5-11 predecessor 4-9 primary/backup contacts 4-10, 4-12, 5-10, 5-11 remote site 4-11, 5-10 status 8-19 successor 4-8 Common Compoents panel (CMNRPM06) 11-17 common components checking for at a remote site 11-16 Common Components panel (CMNPRM08) 10-11 Common Components panel (CMNRPM06) 11-17 compare mode, field description 18-2 Compare panel (CMNCOMP1) 18-2 comparison report, field description 7-18 compile procedure, about G-7 compile parms, field description 7-9, 12-4 compile procedure, field description 7-9, 7-17, 12-4, 12-8 compile/designated proc differ (SYNCH2!) 8-28 complex package about 5-8 creating 4-13 creating using the long method 4-13 complex/super packages about G-2 audit log file activity updates 8-25 Audit Report detail lines 8-13 header format 8-12 audit return code update 8-25 type of package to audit 8-2, 8-33 component activity file (CAF) 8-28

I-3

Index

component hash discrepancy (SYNCH11!) 8-29 component history Audit Report section 8-16 record, mass stage 7-8 Component List panel (CMNRPM05) 11-9 component name G-5 component name, field description 6-5, 12-2, 18-3, 19-8, 20-12 component not in active status (SYNCH14!) 8-30 Component Remote Promotion Status for Component panel (CMNQRY28) A-11 component status, field description 7-17 component type, field description 20-13 component types about G-6 mixed 8-14 component unknown to Change Man (SYNCH0!) 8-27 components about G-5 checking out 6-1 common, checking for at a remote site 11-16 compile procedure G-7 concepts G-5 language name G-6 library type G-6 locking 6-7 modification number (MM) G-6 querying 20-1 remote promotion 11-2 upgraded 8-48 version (VV) G-6 Components List panel (CMNPRM05) 10-9 Components List Parameters panel (CMNSTG12) 7-17 components to scan, field description 19-20 compress staging libraries 17-1 Compress Staging Libraries (CMNCPRSS) 17-1 Compress Staging Libraries panel 17-1 Compress Staging Libraries panel (CMNCPRSS) 17-1 compressed listings, browsing 19-1, 19-13 configuring remote promotion 11-1 confirm request, field description 6-6, 7-4, 7-18 confirmation requests G-8 contingency, field description 4-7, 5-6 conversion assistance 8-27 Copy to Dataset/Member Name Information panel 19-12

I-4

Copy To Dataset/Member Name Information panel (CMNBRWB9) 19-12 Copy to Dataset/Member Name Information panel (CMNBRWB9) 19-12 copybook deleted problem (SYNCH17!) 8-31 COPYLIB components in Audit Report 8-22 count of out-of-synch conditions 8-24 filtering 8-10, 8-24 CPY (copy) Audit Report section column descriptions changed 8-18 created 8-17 dept 8-18 FLAG! 8-18 init 8-18 name 8-17 package 8-18 size 8-18 status 8-19 TSO-ID 8-18 VV.MM 8-17 CPY problem in baseline (SYNCH5!) 8-28 CPY problem in staging (SYNCH4!) 8-28, 8-46 Create Installation Instructions panel (CMNCRT03) 4-6 Create On Site Information (CMNCRT06) 4-9 Create Package Description (CMNCRT02) 4-5 Create Package Description panel (CMNCRT02) 4-5 created, column description 8-17 creator, field description 11-3, 20-7 creator’s TSO-ID, field description 16-2, 20-3 cross application audit 8-7 current promotion level, field description 10-3, 11-5 customized post processor programs 8-14

D D/A (deleted or archived) status 8-16 data set organization G-8 data string, field description 19-9, 19-20 dataset name, field description 7-4, 7-9 date, field description 11-6 DB2 pre-compile, field description 7-10, 12-4, 12-8 Delete Options (CMNDELT0) 17-6

Change Man Version 4.1.6

Index

Delete Options panel (CMNDELT0) 17-6 deleted or archived (D/A) status 8-16 deleting packages about 17-5 canceling requests 17-6 considerations 17-5 setting up memo delete 17-6 Demote Options panel (CMNPRM04) 10-8 Demote Options panel (CMNRPM04) 11-14 Demote Options panels (CMNPRM10) 10-7 demoting components from packages 10-10 from a remote site functional hierarchies 11-11 packages batch 10-7 online 10-7 department number 8-12, 8-13, 8-18 department, field description 4-3, 5-3, 13-3, 16-3, 20-4 dependencies, field description 19-19 dept, column description 8-18 designated compile procedure G-7 diagnostic information 8-9 directory, PDS 8-17 displacement, field description 19-20 distribution to remote sites 2-11 DSORG G-8 DUPLIC! 8-27, 8-30, 8-47

E editing components in browse mode emergency conditions, audit 8-1 evaluating Audit Reports 8-26 Extended Search Criteria panel (CMNQRY01) 16-4, 20-5

19-11

F field descriptions package type 13-4 field descriptions, A-B action requested 10-4, 11-5 and/or 19-20 application 4-3, 5-3, 19-8, 19-19, 20-13 approval entity name 13-3 as member name 19-12

Change Man User Guide

audit as a primary package 8-6 audit as a simple package 8-5 audit participating package by department number 8-7 audit RC 20-7 audit staging libraries only 8-3 auto-resolve out-of-synchs 8-3 field descriptions, C-D case sensitive 19-9 case sensitive? 19-20 changed from/to date 7-17 check out to 6-6 checkout mode 6-7 compare mode 18-2 comparison report 7-18 compile parms 7-9, 12-4 compile procedure 7-9, 7-17, 12-4, 12-8 component name 6-5, 12-2, 18-3, 19-8, 20-12 component status 7-17 component type 20-13 components to scan 19-20 confirm request 6-6, 7-4, 7-18 contingency 4-7, 5-6 creator 11-3, 20-7 creator’s TSO-ID 16-2, 20-3 cross application audit 8-7 current promotion level 10-3, 11-5 data string 19-9, 19-20 dataset name 7-4, 7-9 date 11-6 DB2 pre-compile 7-10, 12-4, 12-8 department 4-3, 5-3, 13-3, 16-3, 20-4 dependencies 19-19 displacement 19-20 field descriptions, E-J forced demotion from prior promotion sites (remote, local) 11-4 format report for printing 8-4 from/to column 19-9 from/to creation date 13-4, 16-3, 20-4 from/to date 19-2 from/to install date 13-4, 16-3, 20-4 ID 11-6 include history records 8-3 input library type 12-7 install date 11-3, 20-7 installation instructions 4-7, 5-6 job statement information 8-7, 12-4 job statement information for batch compare 18-3 job statement information if disposition is PD or PK 18-5 field descriptions, L-M language 6-5, 7-4, 12-2

I-5

Index

LCT member list 12-7 level to check 10-4, 11-5 library dsorg 6-6 library level 12-3, 19-8 library org 19-12 library type 6-5, 7-4, 18-3, 19-8, 19-19 link edit parms 7-10, 12-4 linkage edit parms 12-8 list members only 19-19 lock component 6-7 maximum promotion level 10-3, 11-5 member 7-3 member list scan 19-8 member name 12-7 MOD/CNT 11-6 field descriptions, N-O notified user ID 13-3 online browse 19-2 online or batch 10-4 other options 7-10, 12-4, 12-8 other parameters 13-4, 16-3, 20-5 field descriptions, P-Q package ID 6-5, 12-2, 13-3, 16-2, 20-3, 20-7 package level 4-3, 5-3, 16-3, 20-4 package name 18-2 package status 16-2, 20-3 package time span 4-4, 5-4, 13-4, 16-3, 20-4 package title 4-3, 5-3 package type 4-3, 5-3, 16-3, 20-4 panel options 12-2, 18-2, 19-8 personal library 6-6 process by install date 8-10 promotion 11-6 prompt for report disposition 18-3 field descriptions, R-S records to select 19-9, 19-19 relationship 20-13 relationship to 20-13 relink from 12-7 remote 11-6 remote history 11-6 remote promotion site 11-5 remote site affected 13-4, 16-3, 20-4 remote site name 11-3 report dataset name 18-4 report disposition 18-4 request 11-9 requester’s name 4-3, 5-3 requester’s phone 4-3, 5-3 scan mode 19-19 scheduler 4-7, 5-6 short or long display 7-18 source library 6-6, 18-3 source library type 12-2

I-6

stage mode 7-4 stage name 7-4 staged name 7-9 status 11-3, 11-10, 20-7 suppress history 12-4 suppress messages 7-4, 7-18 field descriptions, T-Z target library type 12-7 time 11-6 to dataset 19-12 TSOID 7-17 work request ID 4-3, 5-3, 13-3, 16-2, 20-3 fields audit as a primary package 8-10 audit pass 8-9 process by install date 8-10, 8-33 filtering count of out-of-synch conditions 8-10 first calling load component 8-23 FLAG! Audit Report column description 8-18 in a sample 8-22, 8-23 forced demotion from prior promotion sites (remote, local), field description 11-4 format changes, Audit Report 8-12 freeze promote without 8-9 time CMN30 skeleton job 9-3 CMN37 skeleton job 9-3 CMN55 skeleton job 9-3 CMN57 skeleton job 9-3 CMNPMXJB 9-2 freeze in progress indicator 9-9 Freeze Options panel (CMNFRZ01) 9-4 freezing packages about 2-6, 9-1 batch 9-5 online 9-4 reset indicator 9-9 from/to column, field description 19-9 creation date, field description 13-4, 16-3, 20-4 date, field description 19-2 install date, field description 13-4, 16-3, 20-4 frozen packages, approving 2-7 full audit 8-8, 8-24 functional hierarchies, remote demotion 11-11

Change Man Version 4.1.6

Index

G global administration options audit 8-29 process by install date

8-33, 8-42

global administrator 8-10, 8-24 global notification facility, browsing 19-16 Global Notification Report Disposition panel (CMNOT00) 19-17 group 8-11, 8-12

H handling install dates examples see install dates hash tokens 8-29, 8-30 header keywords 8-14 history records 8-3

I ID, field description 11-6 IDRDATA records 8-28 impact analysis 2-13, 19-18 see also CMNASIST impact analysis data, querying 20-11 Impact Analysis of Components panel (CMNIMPMP) 20-12 impact analysis table 8-27 informational code 8-27 init, column description 8-18 input library type, field description 12-7 install date column description 4-10, 4-11, 5-10, 5-11 field description 11-3, 20-7 dates 8-2, 8-10, 8-12, 8-25, 8-30 differentiating 8-33 examples for handling 8-34 time from, column description 4-10, 4-11, 5-10, 5-11 to, column description 4-10, 4-11, 5-10, 5-11 installation about 2-9 instructions about 4-6, 5-5

Change Man User Guide

field description 4-7, 5-6 specific post processor 8-14 ISPF statistics 8-11, 8-17, 8-18, 8-27 statistics not available (SYNCH1!)

8-27

J job statement information field description 12-4 for batch compare, field description 18-3 if disposition is PD or PK, field description 18-5

K keywords, header

8-14

L LAN printer 8-4 language field description 6-5, 7-4, 12-2 name G-6 LCMD, column description 5-9, 5-11 LCT member list, field description 12-7 legend and summary report 8-11, 8-24 level to check, field description 10-4, 11-5 library data set organization 6-6 level, field description 12-3, 19-8 org, field description 19-12 personal 6-6 type about G-6 component type G-6 type, field description 7-4, 18-3, 19-8, 19-19 link edit parms, field description 7-10, 12-4 linkage edit parms, field description 12-8 linkdate, column description 8-21 list (LST) audit report section 8-14 members only, field description 19-19 of components, package driven 6-7 load audit report section column descriptions 8-21 sample 8-21 see also LOD

I-7

Index

component, first calling 8-23 deleted problem in staging (SYNCH18!) Local or Remote Promotion panel (CMNSLRPM) 10-2, 11-12 locating header information 8-12 lock component, field description 6-7 LOD (load) audit report section column descriptions AC 8-21 alias-of 8-21 ATTR 8-21 linkdate 8-21 name 8-21 SETSSI 8-21 size 8-21 log file activity updates 8-25, 8-34 LST (list) audit report section 8-14

M masking package list about 3-5 packages 3-5 mass stage 7-8 component history record 7-8 maximum promotion level, field description 10-3, 11-5 member component G-5 field description 7-3 list scan, field description 19-8 name, field description 12-7 memo delete about 17-6 Memo Delete Change Package (CMNDELT1) 17-6 menus Query Option (CMNQMENU) 20-1 MOD/CNT, field description 11-6 mode, batch, online G-8 module, member, component G-5

N name column description 8-17, 8-21 notified user ID, field description 13-3 number of out-of-synch conditions 8-24

I-8

8-32

O online browse, field description 19-2 error messages, short and long, accessing 3-10 mode G-8 or batch, field description 10-4 organization, data set, DSORG G-8 orphan module in staging (SYNCH12!) 8-29 other options, field description 7-10, 12-4, 12-8 parameters, field description 13-4, 16-3, 20-5 out-of-synch about 8-1, 8-26 condition flags in examples 8-36 in resolution scenarios 8-46 condition message flags DUPLIC! 8-27, 8-30 see also SYNCH condition messages activity file not checked out 8-28 baseline/staging discrepancy 8-29 called subroutine in baseline 8-28 called subroutine in staging 8-28 compile/designated proc differ 8-28 component hash discrepancy 8-29 component not in active status 8-30 component unknown to Change Man 8-27 copybook deleted problem 8-31 CPY problem in baseline 8-28 CPY problem in staging 8-28, 8-46 ISPF statistics not available 8-27 load deleted problem in staging 8-32 orphan module in staging 8-29 source and load discrepancy 8-29 source to copy relationship problem (SYNCH15!) 8-30 source to copy relationship problem (SYNCH16!) 8-30 staging duplicates baseline 8-27 unparsable load component 8-28 version regression problem 8-29 conditions about 8-1, 8-26 count of 8-24 filtering count of 8-6, 8-10, 8-24

Change Man Version 4.1.6

Index

in resolution scenarios informational code 8-27

8-46

P package column description 8-18 ID G-1 field description 12-2, 13-3, 16-2, 20-3, 20-7 in motion 8-30 information categories promotion libraries option 20-8 remote promotion history option 20-8 remote promotion libraries option 20-8 level about G-1 field description 4-3, 5-3, 16-3, 20-4 list about 16-1 checkout 6-7 options 16-5 master 8-16, 8-25, 8-27, 8-33 name about G-1 field description 18-2 search 3-5 status 8-12, G-4 field description 16-2, 20-3 time span, field description 4-4, 5-4, 13-4, 16-3, 20-4 title, field description 4-3, 5-3 type G-3 field description 4-3, 5-3, 13-4, 16-3, 20-4 relationships G-4 Package Description panel (CMNPGNL2) A-2 package ID, field description 6-5 Package in Batch panel (CMNFRZ02) 9-5 Package Information Categories panel (CMNQRY03) 20-7 Package List Parameters panel (CMNLIST0) 16-1 Package Promotion History panel (CMNQRY23) A-9 packages change G-1 freezing 2-6 frozen, approving 2-7 querying 20-1 panel 17-1

Change Man User Guide

options, field description 12-2, 18-2, 19-8 Utility Baseline Selections (CMNUTL01) 17-3 panels Activity Log Entries (CMNLOGDS) 19-3 Approval List (CMNAPPLS) 13-5 Approval List panel (CMNAPPLS) A-5 Approve Package Parameters (CMNAPPRV) 13-2 Approve/Reject Options (CMNAPPOP) 13-5 Audit Change Package (CMNAUDIT) 8-2 Backout Change Package (CMNBKOUT) 15-2 Backout Reasons (CMNBKRSN) 15-2 Baseline Browse/Print Facility (CMNBRWB0) 19-6 Browse Activity Log (CMNLOGE2) 19-4 Browse Activity Log (CMNLOGEX) 19-2 Browse Compressed Listing (CMNBLST0) 19-14 Change Package List (CMNLIST3) 16-5 Checkout Options (CMNMCKOT) 6-3 Commnon Components (CMNPRM08) 10-11 Common Components (CMNRPM06) 11-17 Compare (CMNCOMP1) 18-2 Compare panel (CMNCOMP1) 18-2 Component List panel (CMNRPM05) 11-9 Component Remote Promotion Status for Component (CMNQRY28) A-11 Components List (CMNPRM05) 10-9 Components List Parameters (CMNSTG12) 7-17 Compress Staging Libraries (CMNCPRSS) 17-1 Copy To Dataset/Member Name Information (CMNBRWB9) 19-12 Copy to Dataset/Member Name Information (CMNBRWB9) 19-12 Create Installation Instructions panel (CMNCRT03) 4-6 Create On Site Information (CMNCRT06) 4-9 Create Package Description (CMNCRT02) 4-5 Delete Options (CMNDELT0) 17-6 Demote Options (CMNPRM04) 10-8 Demote Options (CMNPRM10) 10-7 Demote Options (CMNRPM04) 11-14 Extended Search Criteria (CMNQRY01) 16-4, 20-5 Freeze Options ( CMNFRZ01) 9-4 Global Notification Report Disposition (CMNOT00) 19-17 Impact Analysis of Components (CMNIMPMP) 20-12 Local or Remote Promotion (CMNSLRPM) 10-2, 11-12

I-9

Index

Memo Delete Change Package (CMNDELT1) 17-6 Package Description (CMNPGNL2) A-2 Package in Batch (CMNFRZ02) 9-5 Package Information Categories (CMNQRY03) 20-7 Package List Parameters (CMNLIST0) 16-1 Package Promotion History (CMNQRY23) A-9 Print/Copy Job Card Information (CMNBRWB2) 19-12 Promote Change Package (CMNPRM00) 10-3 Promote Change Package panel (CMNPRM01) 10-3 Promote Options (CMNPRM02) 10-6 Promote Options (CMNPRM09) 10-5 Promote Options (CMNRPM03) 11-7 Query Backout Reasons List (CMNQRY13) A-9 Query Baseline Libraries (CMNQRY08) 20-9, A-16 Query Component List (CMNQCMP2) 20-10 Query Component Parameters (CMNQCCMP1) 20-9 Query Control Information (CMNQRY10) A-1 Query Development Staging Libraries (CMNQRY05) A-14 Query Options (CMNQMENU) 20-1 Query Package List (CMNQRY02) 20-6 Query Packages Parameters (CMNQRY00) 20-3 Query Participating Packages (CMNQRY11) A-8 Query Production Libraries (CMNQRY07) A-15 Query Production Staging Libraries (CMNQRY06) A-15 Query Rename/Scratch List (CMNQRY12) A-5 Query Site Activities Date and Time (CMNQRY14) A-6 Query Status Start Date and Time (CMNQRY04) A-8 Recompile Source (CMNRCMP0) 12-2 Remote Promotion Level List 11-8 Remote Promotion List Part 1 or 3 (CMNQRY29) A-12 Remote Promotion Part 2 or 3 (CMNQRY30) A-13 Remote Promotion Selection List (CMNQRY26) A-10 Remote Site Information (CMNPRSTI) 5-9, A-6 Restore Memo Deleted Package (CMNDELT3) 17-7

I-10

Restore Memo Deleted Packages (CMNDELT3) 17-7 Revert Change Package (CMNREV00) 14-2 Revert Reasons (CMNREVRS) 14-3, A-9 Revert Reasons panel (CMNREVRS) A-8 Source to Load Relationship (CMNQRY21) A-5 Source to Load Relationship (CMNSR2LD) 7-15 Specify Listing Disposition (CMNBLST2) 19-15 Specify Report Disposition (CMNCDISP) 18-4 Stage Components (CMNSTG01) 7-15, A-2 Stage from Development (CMNSTG02) 7-3 Stage Mass Compile and Link Edit (CMNSTG05) 7-12 Stage Options (CMNSTG00) 7-2 Stage Other Components (CMNSTG09) 7-13 Unfreeze/Refreeze Component (CMNUNFRZ) 9-7 Update Complex/Super Information (CMNPGNL6) 5-8 Update Custom Component List (CMNCUSTM) A-7 Update Custom Component List panel (CMNCUSTM) A-7 Update Installation Instructions (CMNPGNL3) 5-5 Update Package Description (CMNPGNL2) 5-4 Update Scheduling Dependencies (CMNPGNL4) 5-6 Update Site Information (CMNONSTE) 5-11, A-6 Updqate Affected Applications (CMNPGNL5) 5-7 Utility Baseline Selection (CMNTL01) 17-3 Utility Change Package Driven List (CMNUTL03) 17-5 Utility Rename/Scratch Options (CMNUTL00) 17-2 Valid Package List Commands (CMNLIST6) 16-8 participating packages G-2 Audit Report detail lines 8-13 header format 8-12 creating 4-14 creating using the long method 4-14 process by install date 8-2, 8-10, 8-25, 8-30 specify as primary package 8-6, 8-10, 8-36 simple package 8-2, 8-5, 8-36, 8-37 type of package to audit 8-12

Change Man Version 4.1.6

Index

PDS directory 8-17 personal library, field description 6-6 phone numbers, column description 4-12, 5-10, 5-11 post processor, installation specific 8-14 pre-audit 8-7 predecessor column description 4-9 primary package audit report header format 8-12 specify participating package as 8-10 type of package to audit 8-10 primary/backup contacts, column description 4-10, 4-12, 5-10, 5-11 Print/Copy Job Card Information panel (CMNBRWB2) 19-12 printer spacing, ASA carriage control 8-4 procedure column description 8-20 compile G-7 name G-7 process as a primary package 8-6, 8-10 by install date 8-2, 8-10, 8-25, 8-30 mode G-8 project, application, about G-1 Promote Change Package panel (CMNPRM00) 10-3 Promote Change Package panel (CMNPRM01) 10-3 Promote Options panel (CMNPRM02) 10-6 Promote Options panel (CMNPRM09) 10-5 Promote Options panel (CMNRPM03) 11-7 promoting change packages to a remote site 11-2 components 2-6 components to a remote site 11-2 packages about 2-6 batch 10-5 checking for common components 10-11 online 10-4 to a local system 10-1 to a remote site 11-2 to a remote system 11-1 to a remote system 11-1 without freeze 8-9 promotion field description 11-6 libraries

Change Man User Guide

package information categories

20-8

prompt for report disposition, field description 18-3

Q Query Backout Reasons List panel (CMNQRY13) A-9 Query Baseline Libraries panel (CMNQRY08) 20-9, A-16 Query Component List panel (CMNQCMP2) 20-10 Query Component Parameters panel (CMNQCMP1) 20-9 Query Control Information panel (CMNQRY10) A-1 Query Development Staging Libraries panel (CMNQRY05) A-14 Query Options panel (CMNQMENU) 20-1 Query Package List panel (CMNQRY02) 20-6 Query Packages Parameters panel (CMNQRY00) 20-3 Query Participating Packages panel (CMNQRY11) A-8 Query Production Libraries panel (CMNQRY07) A-15 Query Production Staging Libraries panel (CMNQRY06) A-15 Query Rename/Scratch List panel (CMNQRY12) A-5 Query Site Activities Date and Time panel (CMNQRY14) A-6 Query Status Start Date and Time panel (CMNQRY04) A-8 querying components 20-1 packages 20-1

R recommendation summary report 8-11, 8-26 recommendations, resolving out-of-synch conditions 8-27 Recompile Source panel (CMNRCMP0) 12-2 records history 8-3 to select, field description 19-9, 19-19 refreezing components 9-7 relationship to, field description 20-13 relationship, field description 20-13

I-11

Index

relink from, field description 12-7 relinking load components 12-5 remote demotion change packages 11-11 components of a package 11-11 functional hierarchies 11-11 field description 11-6 history, field description 11-6 promotion change packages 11-2 components of a package 11-2 history, package information categories 20-8 how administrators can configure 11-1 libraries, package information categories 20-8 packages, checking for common components 11-16 site, field description 11-5 selection list displayed at checkout 6-5 site affected, field description 13-4, 16-3, 20-4 column description 4-11, 5-10 common component checking 11-16 name, field description 11-3 promoting change packages to 11-2 promoting components to 11-2 sites backing out packages 15-3 distribution 2-11 installing packages 4-11, 5-9 new package 4-11 update package 5-9 Remote Promotion Level List panel (CMNRPM07) 11-8 Remote Promotion List Part 1 or 3 panel (CMNQRY29) A-12 Remote Promotion Part 2 or 3 panel (CMNQRY30) A-13 Remote Promotion Selection List panel (CMNQRY26) A-10 Remote Site Information panel (CMNPRSTI) 5-9, A-6 renaming packages 17-2 report dataset name, field description 18-4

I-12

disposition, field description 18-4 reports audit, see audit report legend and summary 8-11, 8-24 recommendation summary 8-11, 8-26 request, field description 11-9 requester’s name, field description 4-3, 5-3 phone, field description 4-3, 5-3 resolution scenarios 8-46 Restore Memo Deleted Package (CMNDELT3) 17-7 Restore Memo Deleted Packages (CMNDELT3) 17-7 return codes 8-1, 8-9, 8-26, 8-33 audit 8-24, 8-26, 8-33, 8-39, 8-43 Revert Change Package panel (CMNREV00) 14-2 Revert Reasons panel (CMNREVRS) 14-3, A-8, A-9

S sample of audit report baseline area 8-16 load section 8-21 resolution scenarios 8-46 SRC section 8-19 staging area 8-16 scan mode, field description 19-19 scanning a library 19-18 scheduler, field description 4-7, 5-6 scheduling dependencies 4-8, 5-6 scratching packages 17-2 searching for packages 3-5 SERPANEL 19-21 SETSSI 8-28 column description 8-20, 8-21 in SYNCH8! 8-28 short or long display, field description 7-18 similarities in Audit Report outputs 8-24 simple packages about G-2 audit 8-2, 8-5, 8-12, 8-36, 8-37 single site, installing packages 4-9, 5-10 size, column description 8-18, 8-21 source (SRC) audit report section, see SRC and load discrepancy (SYNCH9!) 8-29

Change Man Version 4.1.6

Index

library field description 18-3 type, field description 12-2 to copy relationship problem SYNCH15! 8-30 SYNCH16! 8-30 source library, field description 6-6 Source to Load Relationship panel (CMNQRY21) A-5 Source to Load Relationship panel (CMNSR2LD) 7-15 Specify Listing Dispositon panel (CMNBLST2) 19-15 Specify Report Disposition panel (CMNCDISP) 18-4 split screen 8-8 SRC (source) audit report section column descriptions procedure 8-20 SETSSI 8-20 sample 8-14 stage mass stage 7-8 mode, field description 7-4 name, field description 7-4 Stage Components panel (CMNSTG01) 7-15, A-2 Stage from Development panel (CMNSTG02) 7-3 Stage Mass Compile and Link Edit panel (CMNSTG05) 7-12 Stage Options panel (CMNSTG00) 7-2 Stage Other Components panel (CMNSTG09) 7-13 staged name, field description 7-9 staging about 2-4 administration parameters 7-1 Audit Report section 8-15 compile and link-edit 7-8 component list 7-7 components 7-1 duplicates baseline (DUPLIC!) 8-27, 8-47 from development 7-3 from packages 7-13 LCT member 8-30 libraries audit 8-7, 8-24 compress 17-1

Change Man User Guide

inspection 8-1 libraries, compress 17-1 other type components 7-13 user options 7-11 using package parameters 7-16 staging duplicates baseline (DUPLIC!) statistics, ISPF 8-11, 8-17, 8-18, 8-27 status archived 8-16 change packages G-4 column description 8-19 deleted 8-16 field description 11-3, 11-10, 20-7 submitting API jobs 8-3 subroutines, called 8-23 successor, column description 4-8 summary reports legend 8-11, 8-24 recommendation 8-11, 8-26

8-30

super packages about 5-8 creating using the long method 4-13 super/complex packages G-2 suppress history, field description 12-4 messages, field description 7-4, 7-18 SYNCH0! 8-27 SYNCH1! 8-27 SYNCH10! 8-29 SYNCH11! 8-29 SYNCH12! 8-29 SYNCH13! 8-29 SYNCH14! 8-30 SYNCH15! 8-30 SYNCH16! 8-30 SYNCH17! 8-31 SYNCH18! 8-32 SYNCH2! 8-28 SYNCH3! 8-28 SYNCH4! 8-28, 8-46 SYNCH5! 8-28 SYNCH6! 8-28 SYNCH7! 8-28 SYNCH8! 8-28 SYNCH9! 8-29 SYSIN data set 8-9

I-13

Index

deleting from packages

SYSLIB concatenation 8-11, 8-31, 8-32 search order 8-30

T target library type, field description temporary change cycle (TCC) about 2-11 time, field description 11-6 to dataset, field description 19-12 trace 8-10 TSO-ID, column description 8-18 TSOID, field description 7-17 type component library G-6 of package to audit 8-11, 8-33

12-7

17-4

Utility Baseline Selection panel (CMNTL01) 17-3 Utility Baseline Selections panel (CMNUTL01) 17-3 Utility Change Package Driven List panel (CMNUTL03) 17-5 Utility Rename/Scratch Options panel (CMNUTL00) 17-2

V Valid Package List Commands panel (CMNLIST6) 16-8 version regression problem (SYNCH10!) VV.MM, column description 8-17

8-29

W U undeleting packages 17-5 Unfreeze/Refreeze Component panel (CMNUNFRZ) 9-7 unfreezing components 9-7 unlocking components 6-7 unparsable load component (SYNCH3!) 8-28 Update Complex/Super Information panel (CMNPGNL6) 5-8 Update Custom Component List (CMNCUSTM) A-7 Update Custom Component List panel (CMNCUSTM) A-7 Update Installation Instructions panel (CMNPGNL3) 5-5 Update Package Description panel (CMNPGNL2) 5-4 Update Scheduling Dependencies panel (CMNPGNL4) 5-6 Update Site Information panel (CMNONSTE) 5-11, A-6 updating change package information 5-1 Updqate Affected Applications panel (CMNPGNL5) 5-7 upgraded components 8-48 user exit 8-1, 8-33 utility requests about 17-2 activating from packages 17-4 creating from baseline 17-3

I-14

work request ID, field description 16-2, 20-3

4-3, 5-3, 13-3,

Change Man Version 4.1.6