Skip to content
Changeman ZMF Documentation
Overview
Initializing search
Guides
Readme
User Guide
Quick Ref
Admin Guide
Installation
Migration
Customization
Messages
HLLX
DB2 Option
REST Services
OFM Option
Table of Contents
Guides
Readme
User Guide
User Guide
Introduction
Introduction
Features of ChangeMan ZMF
What is a Change Package?
Package Lifecycle
Inside ChangeMan ZMF Development
ChangeMan ZMF Library Environment
Baseline Libraries and Delta Decks
Backout Management Facilities
Emergency Changes
Storage Name Considerations
Build Processing Controls
Using the ISPF Interface
Using the ISPF Interface
Start a Session
ChangeMan ZMF Primary Option Menu and Build Options Menu
Navigating Panels
Online Help and Online Tutorial
Working with ChangeMan ZMF ISPF Panels
Working with Lists
Working with Long Fields
Component Names that Contain a Path
Case Sensitive Fields
Batch Job Statement Information
Online and Batch Execution Modes
Editing Components in ChangeMan ZMF
Exiting ChangeMan ZMF
Creating a Change Package
Creating a Change Package
About Creating a Change Package
Rules for Creating Packages
Accessing Create Package Panels
Package Description Methods
Dynamic Panels in Create Package
Defining Package Control Information
Providing a Package Description
Providing Installation Instructions
Setting Job Scheduling Dependencies
Adding Affected Applications
Defining Complex/Super Package Information
Entering Package User Information
Defining Install Date and Site Information
Updating Change Package Information
Updating Change Package Information
Rules for Update Package Information Functions
Accessing Package Information Update Functions
Updating a ChangeMan ZMF Package
Checking Out a Component
Checking Out a Component
Rules for Checking Out a Component
Access Checkout Component Functions
Checking Out from Baseline or Promotion Libraries
Checking Out Package Components
Checking Out from a Package
Checkout Warnings and Messages
Confirming Version Regression Override
Using Staging Versions
Using Staging Versions
About Staging Versions
How Staging Versions Work
Rules, Restrictions, and Options
Creating Staging Versions
Managing Staging Versions
Recompiling Components
Recompiling Components
About Recompiling Components
Rules for Recompiling Source
Accessing Recompile Source Panels
Recompiling Source Components Online
Mass Recompile Source Components in Batch
Staging a Component
Staging a Component
About Staging Components
Rules for Staging Components
Accessing Stage Component Functions
Staging from Package
Filtering with Component List Parameters
Staging from Development
Staging Like-Other Components
Staging LOD Components
Batch Stage Job Card
Adding New Components
Locking and Unlocking Package Components
Rebinding Components
Rebinding Components
About Rebinding Components
Rules for Rebinding Load
Accessing Rebind Load Panels
Rebinding Load Components
Utility Requests
Utility Requests
About Utility Requests
Accessing Utility Request Functions
Creating Utility Requests from Baseline
Reviewing and Deleting Utility Requests from Packages
Scratch/Rename Updates to Impact Analysis
Auditing a Package
Auditing a Package
About Package Audit
Administrative Parameters that Affect an Audit
User Exits that Affect an Audit
Auditing a Package Attached to a Release
Requesting an Audit
Audit Report Contents
Audit Report Field Descriptions
Audit Return Codes
Out of Sync Conditions
Accessing the Audit Report
Single Line Audit Summary Report
Performing a Cross-Application Audit
Use Case Scenario: Fixing Out-of-Sync Conditions
Using Audit Auto Resolve
Resolving Same-Named Members in Multiple (user-guide/PDS) Libraries
Audit Diagnostic Tracing
Freezing a Package
Freezing a Package
About Freezing a Package
Rules for Freezing a Package
Accessing Freeze Package Functions
Freezing a Package Online
Freezing a Package in a Batch
Unfreezing and Refreezing Components
Resetting the Freeze-In-Progress Indicator
Resubmitting Installation JCL Build Request
Reverting a Package
Reverting a Package
About Reverting a Package
Authorization for Revert Package Functions
Rules for Reverting a Package
Accessing Revert Package Panels
Reverting a Change Package
Promoting and Demoting a Package
Promoting and Demoting a Package
About Promotion
Promotion Restrictions, Rules, and Options
Promotion Paths
Promotion Libraries In SYSLIB Concatenations
Accessing Promotion Functions
Promoting Packages And Components
Demoting Packages and Components
Displaying Promotion/Demotion History for a Site
Approving or Rejecting a Package
Approving or Rejecting a Package
About Approving or Rejecting a Package
Rules for Approving and Rejecting Packages
Accessing Approve Package Functions
Selecting Packages for Approve Functions
Approve or Reject a Package
Displaying Reject Reasons
Resetting the Approval-In-Progress Indicator
Resubmitting Install JCL Build Request
Using zMobile
Installing and Baselining a Package
Installing and Baselining a Package
About Installation and Baseline Ripple
Overview of File Tailoring for Installation JCL
Distribution and Installation of the Change Package
Jobs to Distribute and Install the Change Package
Backing Out a Change Package
Backing Out a Change Package
About Backing Out a Change Package
Rules for Backing Out Packages
Accessing Backout Package Panels
Backing Out an Installed Change Package
Backing Out Scratch and Rename Utility Requests
Backout and Reinstall at P Instance
Memo Deleting and Undeleting Packages
Memo Deleting and Undeleting Packages
About Memo Deleting and Undeleting Packages
Memo Delete and Undelete Package Rules
Accessing Memo-Delete and Undelete Functions
Memo Deleting a Change Package
Undelete a Memo-Deleted Change Package
Querying Packages and Components
Querying Packages and Components
About Query
Accessing the Query Options Menu
Querying Change Packages
Querying Components
Querying Approved Packages Not in the Scheduler
Querying Impact Analysis
Querying Impact Analysis
About Impact Analysis
Impact Analysis of Subordinate Components
Getting a Component Bill of Materials
Use Case Scenarios
Browsing Compressed Listings:
Browsing Compressed Listings:
Browsing Compressed Listings
Using Baseline Browse Functions:
Using Baseline Browse Functions:
Cross-Application Scan:
Cross-Application Scan:
Cross-Application Scan
Comparing Package Components to Promotion or Baseline
Using Git with Packages
Using Git with Packages
Setting up to Use Git
Restricting Package Components
Examples of Git-ZMF Interaction
About Git File Extensions and Git GUIs
Running Reports
Miscellaneous Functions
Managing Packages with the Package List:
Managing Packages with the Package List:
Selecting Packages for the Package List
Invoking Package Functions from the Package List
Package List Options
Appendix A
Glossary
Legal Notice
Quick Ref
Quick Ref
Creating a Change Package
Checking Out a Component
Staging a Component
Auditing a Package
Promoting/Demoting a Package
Freezing a Package
Approving/Rejecting a Package
Package List
Out-of-Sync Conditions
Serena ChangeMan ZMF Lifecycle
Legal Notice
Admin Guide
Admin Guide
Introduction
Introduction
Global Administrator
Application Administrator
Security Administrator
ChangeMan ZMF Monitor
General Administrator
What is ChangeMan ZMF?
What is ChangeMan ZMF?
Change Package
Impact Analysis
Checkout
Staging
Audit
Recompile and Relink
Freeze
Promotion
Approval
Production Installation
Baseline Libraries and Delta Decks
Backout Management Facilities
Emergency Changes
ChangeMan ZMF Life Cycle
Pre-Implementation Decisions
Pre-Implementation Decisions
Customizing ChangeMan ZMF for Your Site
Managing Library Space
Using Baseline Libraries for Production Libraries
Setting Up Remote Sites for Production Libraries
Setting Up User Restrictions
Other Considerations
Package Approvals
Promotion And Demotion
Staging Versions
Implementation Checklist
ChangeMan ZMF Administrator Duties
Scheduler Specification Flexibility
Setting Up Global Administration
Setting Up Global Administration
Accessing the Global Administration Options
Setting up Global Parameters
Defining Library Types And Staging Library Attributes
Defining Language Names
Defining Compile Procedures
Defining Reason Codes
Defining Sites
Locking or Unlocking Application Definitions
High Level Language Exits
Setting the Planned Installation Calendar
REST API Server
Online Housekeeping
Generating and Updating Impact Analysis Data
Configuring the Global Notification File
Accessing the Global Selectable Options
Using Package User Information
Setting Up Application Administration
Setting Up Application Administration
Accessing Application Administration
Creating a New Application
Updating Existing Applications
Locks on Application Administration
How Global Settings Affect Application Settings
Setting Application Parameters
Defining Library Types And Staging Library Attributes
Defining Language Names
Defining Compile Procedures
Setting Up Planned Approvals
Setting Up Unplanned Approvals
Defining Application Sites
Configuring Promotion Sites, Levels, and Libraries
Configuring Baseline Libraries
Specifying Component Description, Procedures, and Security
Deleting an Application
Accessing the Application Selectable Options Panel
Updating the Global Notification File
Configuring Production Libraries
Custom Modifications
Custom Modifications
Customizing ChangeMan ZMF
User Exits In ChangeMan ZMF
ISPF Skeletons In ChangeMan ZMF
ChangeMan ZMF Utilities
Monitoring Site and Application Packages
Monitoring Site and Application Packages
Introduction
Accessing the Monitor Option Panel
Querying Package Information
Packages in Limbo
Installation Jobs
Monitoring the ChangeMan ZMF Installation Scheduler
Monitoring the ChangeMan ZMF Promotion Scheduler
Defining and Running ChangeMan ZMF Reports
Defining and Running ChangeMan ZMF Reports
Introduction
Accessing Reports in ZMF Administration
Defining General Batch Reports
Generating ChangeMan ZMF Batch Reports
Running the Baseline Analyzer Report
Running the Link Date Report
Package Audit Report CSV Extract
Running the Db2 Object Dependency Report
Batch Housekeeping Tasks
Batch Housekeeping Tasks
Build and Install Housekeeping Jobs
Package Master Housekeeping
Component Master Housekeeping
Long Name Component Master Housekeeping
Impact Analysis Housekeeping (LDS)
Impact Analysis Housekeeping(Db2)
Recovery File Housekeeping
Activity Log Housekeeping
Staging Versions Housekeeping
Run the ChangeMan ZMF Reports
Clean Up Production Backup Libraries
Sample JCL/Housekeeping Task Cross Reference
Configuring Remote Sites
Configuring Remote Sites
Overview of Remote Sites
How does it Work?
Setting Up Remote Sites Globally
Maintaining Remote Sites
Setting up Remote Sites for Applications
Establishing a Remote Site - Global Administrator
Selecting a Remote Site - Application Administrator
Updating an Existing Site - Application Administrator
Enabling the Network Data Mover
Legal Notice
Installation
Installation
Introduction
Installation Requirements
Installation Considerations
Unloading the Software
Installing Changeman ZMF Components
Configuring Security
Starting, Connecting, and Stopping
Modifying Skeletons
Installing Other Facilities
Setting Up Housekeeping
Installing a ChangeMan ZMF P Instance
Manual File Transfer and Expand
JCL and CLIST Examples
Applying Maintenance Releases
Sernet Keyword Options
Modify Commands
Technical Notes
Using Db2 to replace the impact analysis LDS
Migration
Migration
Migration Strategy, Plans, and Issues
Migration Strategy, Plans, and Issues
Assumptions
Migration Strategy
Model Migration Plan
Sample Conversion Day Script
Converting ZMF 7.1.x to v.8.2 Patch 6
Converting ZMF 7.1.x to v.8.2 Patch 6
Conversion Task Dependencies
Step 1 Apply ChangeMan ZMF License
Step 2 Build JCL INCLUDEs for JOBLIBs and STEPLIBs
Step 3 Update Started Procedures and Log-on CLIST
Step 4 Define Keylists for ISPF Expand
Step 5 Back Up Version 7.1.x Files
Step 6 Convert Package Master, Component Master, and SSV Data Sets
Step 7 Reload XMLSPACE VSAM LDS
Step 8 Update Sernet Keyword Options
Step 9 Implement Changes for the Db2 Option
Step 10 Upgrade ERO
Step 11 Customize SERLCSEC
Step 12 Customize Other Version 8.2 Patch 6 Components
Step 13 Replace somnode with Variables
Step 14 Update RACF PassTicket Support in Sernet
Step 15 Synchronize Impact Analysis Data
Step 16 Customize User Exit SEREX006
Step 17 Perform Post-Migration Checks
Step 18 Submit Job CMNRPKSN if You License ERO
Step 19 Configure Support for IBM Health Checker
Step 20 Configure Activity Log Reporting Procedure
Converting ZMF 8.1.x and 8.2 to v.8.2 Patch 6
Converting ZMF 8.1.x and 8.2 to v.8.2 Patch 6
Conversion Task Dependencies
Step 1 Apply ChangeMan ZMF License
Step 2 Build JCL INCLUDEs for JOBLIBs and STEPLIBs
Step 3 Update Started Procedures and Log-on CLIST
Step 4 Define Keylists for ISPF Expand
Step 5 Back Up Version 8.1.x or 8.2 Files
Step 6 Convert Package Master, Component Master, and SSV Data Sets
Step 7 Reload XMLSPACE VSAM LDS
Step 8 Update Sernet Keyword Options
Step 9 Implement Changes for the Db2 Option
Step 10 Upgrade ERO
Step 11 Customize SERLCSEC
Step 12 Customize Other Version 8.2 Patch 6 Components
Step 13 Replace somnode with Variables
Step 14 Update RACF PassTicket Support in Sernet
Step 15 Synchronize Impact Analysis Data
Step 16 Customize User Exit SEREX006
Step 17 Perform Post-Migration Checks
Step 18 Submit Job CMNRPKSN if You License ERO
Step 19 Configure Support for IBM Health Checker
Step 20 Configure Activity Log Reporting Procedure
Migrating ZMF Db2 Options
Migrating ZMF Db2 Options
No ZMF Db2 Option License but Using Db2 to Host the Baseline I/A Table
Full Function ZMF Db2 Option, without ERO, Not Using Db2 to Host the Baseline I/A
Full Function ZMF Db2 Option, without ERO, Using Db2 to Host the Baseline I/A Table
Core ZMF Db2 Option, without ERO, Not Using Db2 to Host the Baseline I/A Table
Core ZMF Db2 Option, without ERO, Using Db2 to Host the Baseline I/A Table
Full Function ZMF Db2 Option, with ERO, Not Using Db2 to Host the Baseline I/A Table
Full Function ZMF Db2 Option, with ERO, Using Db2 to Host the Baseline I/A Table
Core ZMF Db2 Option, with ERO, Not Using Db2 to Host the Baseline I/A Table
Core ZMF Db2 Option, with ERO, Using Db2 to Host the Baseline I/A Table
ChangeMan M+R Option Quick Start
ChangeMan M+R Option Quick Start
What is the ChangeMan ZMF M+R Option
Installing the M+R Option
Using the M+R Option to Reapply Customization
Legal Notice
Customization
Customization
Introduction
ISPF Skeletons
ISPF Skeletons
Skeleton File Tailoring in ChangeMan ZMF
Skeleton File Tailoring in ChangeMan ZMF
Skeleton Naming Conventions
Skeleton Variables
Skeleton Imbedding
Skeleton Maintenance Facility
Developing Skeletons with File Tailoring Assistance
Editing Skeletons in File Tailoring Assistance
Syntax Checking in File Tailoring Assistance
Debugging Skeletons in Started Task Procedures
ISPF Table CMNTBN
Error Codes
CMN$$AUD - Audit for ALL applications
CMN$$JBL - JOBLIB / STEPLIB
Setting Build Parameters
Transmit Selected Remote Promote Components
JES Node Names and Transmission Site Names
Exposing Mainframe Resources
Exposing Mainframe Resources
ZMF Support for z/OS Connect
ZMF Support for CICS Web Services
ZMF Support for CICS Bundles
User Exits
User Exits
Customizing Exits
Calling XML Services
Exit Descriptions
User Data
User Data
Package User Information
Staging User Options
Release ID Variables
Custom V01-V10 Variables
Utilities
Utilities
CMNBAHST - Initial History Record
CMNBAQ00 - Prepare Input for the IBM BAQLS2JS
CMNBAT90 - Register Build Output Modules
CMNBILOD - Verify that an ILOD record does not already exist
CMNBKRST - VSAM MASTER UNLOAD, RECOVER, LOAD
CMNCICS1 - CICS NEWCOPY
CMNCICS1 - CICS BUNDLE
CMNCICS1 - CICS PIPELINE
CMNCICS1 - CICS WEBSERVICES
CMNCICS6 - CICS CSD Extract
CMNFIXMN - Generate SETSSI Data
CMNIALD0 - Impact Analysis Db2 Load from LDS/dataspace
CMNPMLOD - Master File XML Extractor
CMNSRCPP - Assembler Macro Discovery
CMNSSIDN - LINK EDIT Control Preparation
CMNUPDAT - Stacked Reverse Delta Management
CMNWRITE - Copy And Include Management
SERCOPY - Copy Utility
SERPRINT - SYSOUT Compression Facility
Reports
Reports
Overview of Online Report Generation
Submitting a Batch Job to Generate a Report
Analysis of a Sample REXX Reporting Program
XML Services Called in Reporting Programs
Appendix A. Installation Jobs and Transaction Codes
Appendix A. Installation Jobs and Transaction Codes
X Node Data Sets
Installation Jobs
Other CMNBATCH Transaction Codes
Appendix B. Analyzing ZMF ISPF Skeletons
Appendix B. Analyzing ZMF ISPF Skeletons
Analyzing Skeleton Imbeds
Legal Notice
Messages
Messages
ISPF Client Messages
Message Number Format
ZMF Message Descriptions
Merge and Reconcile (M&R) Messages and Codes
Sernet Messages
Sernet Messages
Message Descriptions
SER3100 SERPANEL
SER4000-4500
SER5000-5950
SER6000-6700
SER7000-7900
SER8000-8850
SER9000-9700
ChangeMan ZMF Staging Versions
ChangeMan ZMF Staging Versions
ChangeMan SSM Message Format
HPS000-HPS0999
HPS1000-HPS1499
HPS1500-HPS1999
HPS2100-HPS2999
HPS3000-HPS4100
HLLX
HLLX
Guide to ChangeMan ZMF Documentation
Guide to ChangeMan ZMF Documentation
Introduction
Introduction
Getting Started
High Level Language Exit Details
High Level Language Exit Details
HLL Exit Processing Address Space
Initialization, Termination, Modify Commands
Exit Administration
Caller to Exit Cross Reference
Samples
ZMF/HLL Exit Interface
ZMF/HLL Exit Interface
Build
Package Create
Package Update
File Tailoring
Checkout
Promote/Demote
Audit
Freeze, Unfreeze, and Refreeze
Package Approve and Reject
Revert/Backout
Specific Exits
Specific Exits
The Package Syslib Functional Area
Query Component (QCMP0100)
Package Search
Scratch/Rename
Miscellaneous
Modify
Legal Notice
DB2 Option
DB2 Option
Introduction
Introduction
ChangeMan ZMF Db2 Option
Db2 Option Concepts
Db2 Option and Component Management
Configuring the Db2 Option
Configuring the Db2 Option
Apply a Db2 Option License
Bind Db2 Plan and Package and Grant access
Update Global Administration
Update Application Administration
Configure Db2 Option Global Administration
Configure Db2 Option Application Administration
Customize Skeletons for Db2
Installation in Other Db2 Subsystems
DB2 Component Processing
DB2 Component Processing
Library Types and Sub Types
CREATE versus ALTER
Component Processing Summary
Native SQL SP Lifecycle
Native SQL SP Lifecycle
Checkin/Stage
Promote
Demote
Install
Backout
Skeleton changes (db2-gsg/overview)
Templating Examples
Templating Examples
Templated BIND Command Parameters
Templated DDL/SQL
Templating Examples
BIND PLAN Example
BIND PACKAGE Example
General Token Templates
CMNDB2PL - BIND Utility
CMNDB2PL - BIND Utility
Introduction
CMNDB2PL DD Statements
CMNDB2PL Operation
Keyword Control Statements
How CMNDB2PL Relates to ChangeMan ZMF
CMNDB2PL Return Codes and Messages
Sample CMNDB2PL Report
Secondary Binding
Stored Procedure Utilities
Stored Procedure Utilities
Introduction
CMNDB2AV
CMNDB2DQ
CMNDB2DD
CMNDB2SL
CMNDB2TR
CMNDB2DR
Stored Procedure Walkthrough
Bind Service Support
Bind Service Support
Installation and Configuration
Process Overview
Db2 Option User Exits
Db2 Option User Exits
CMNEX101 Bind Control Statement Processor
CMNEX103 Bind Control Statement Triage
CMNDB2DD - HLL exit
ISPF Tables and Variables
ISPF Tables and Variables
ISPF Tables
Single Entry Control Variables
Transaction Codes
Transaction Codes
Detailed Job List
Miscellaneous Transactions - at Either Site
Examples
Examples
Native SQL SP Versions and Bind Deploy
Support Use of zFS File Type for SP Components
Glossary
Legal Notice
REST Services
REST Services
Installation and Configuration
Using ZMF REST Services
Using ZMF REST Services
Implementing http event notifications and REST APIs into ZMF
Implementing http event notifications and REST APIs into ZMF
Implementing http event notifications and REST api's into ZMF {: .hidden-for-print }
Exposing ChangeMan ZMF function through REST Services
Development Workflow
Design Overview
Event Variables
Event Source
Event Clients
REST Services
Event Subscribers
Jenkins Attributes
Miscellaneous Attributes
Subscriber Flow Definition - Sample Screen Prints
Using application filtering with the REST server
REST Services
REST Services Extensions
REST interface
REST Services Table
ZMF supplied skeleton changes
Sending Email Notifications for ChangeMan Lifecycle Events
Batch Job Processing Options
Sample REXX HLL exit code
Support for custom processes
External 3rd Party Dependencies
Appendix A
Appendix A
CMNURIBA
Processing overview
Checking the availability of the event server
CMNURIRX
Legal Notice
OFM Option
OFM Option
Introduction
Preparing to Use the OFM
Creating and Maintaining Online Forms
Using Online Forms
Predefined Variables
Messages and Codes
Record Descriptions
Legal Notice
Cross-Application Scan
This chapter describes the library scan facility.