

ChangeMan ZMF
Quick Reference
© Copyright 2001 - 2018 Micro Focus or one of its affiliates.
This document, as well as the software described in it, is
furnished under license and may be used or copied only in
accordance with the terms of such license. Except as permitted by
such license, no part of this publication may be reproduced,
photocopied, 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. Any
reproduction of such software product user documentation,
regardless of whether the documentation is reproduced in whole
or in part, must be accompanied by this copyright statement in its
entirety, without modification.
The only warranties for products and services of Micro Focus and
its affiliates and licensors ("Micro Focus") are set forth in the
express warranty statements accompanying such products and
services. Nothing herein should be construed as constituting an
additional warranty. Micro Focus shall not be liable for technical or
editorial errors or omissions contained herein. The information
contained herein is subject to change without notice.
Contains Confidential Information. Except as specifically indicated
otherwise, a valid license is required for possession, use or
copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and
Technical Data for Commercial Items are licensed to the U.S.
Government under vendor's standard commercial license.
Third party programs included with the ChangeMan ZMF product
are subject to a restricted use license and can only be used in
conjunction with ChangeMan ZMF.

Publication date: September 2018 (rebranded only)

 General Information

General Information
 Actions can be initiated by either choosing from menu and
option panels, or by typing line commands on the Package List
(see page 12).
 To process panel information, press [Enter].
 To cancel without processing panel information, type
“CANCEL” on the Command line or in the Option field, and
press [Enter].
 To access online Help, press the [PF1] key.
 To jump between panels, use the equal “=” sign. Example: To
jump to the Create A New Package panel, type “=1.1” in
Command or Option, and press [Enter].
 To see long panel fields (marked by "+"), scroll right and left
with [PF11] and [PF10]. Press [PF4] for a pop-up window.
 Sort is now available on many lists. Press [PF1] for more
information where there is a list.

Creating a Change Package

1 From the Primary Option Menu, choose 1 (Build) and press
[Enter].
2 From the Build Options menu, choose 1 (Create) and press
[Enter].
3 On the Create A New Package panel:
• Type “L” (Long method), “S” (Short method), “D” (No
Description) or “I” (No Implementation instructions) in the
Option field.
• Type the package title, the application, and the requestor’s
name and telephone number.
• Optionally type the work request ID and the department
(these field names may be changed).
• Type the package level:
1 - Simple
2 - Complex
3 - Super

Quick Reference 3
Checking Out a Component

4 - Participating
• Type the package type (Planned or Unplanned).
• Type the package time span (Permanent or Temporary).
• Optionally type a package to copy forward.
• For unplanned packages, type a reason code.
• For temporary packages, type a change duration.
• Press [Enter].
Steps 4-5 are skipped if the Short Method was chosen in Step 3.
4 On the Package Description panel, type a free-form
description of the package and press [Enter].
5 On the Installation Instructions panel:
• Type the problem contingency action (for documentation
only).
• Type the installation method:
CMN - ChangeMan ZMF scheduler
MAN - Manual installation
OTHER - External scheduler
• Type free-form implementation instructions. Press [Enter].
6 Optionally type on the User Panel, as required. Press [Enter].
7 On the Site Information panel, type the install date and time,
the primary and backup contact names and phone numbers,
and then Press [Enter].
For more details, see the “Creating a Change Package” chapter in
the ChangeMan ZMF User Guide.

Checking Out a Component

1 From the Primary Option Menu, choose 1 (Build) and press
[Enter].
2 From the Build Options menu, choose 5 (Checkout) and press
[Enter].
3 On the Checkout Options panel, type the package ID, type “1”
(Baseline/Promotion) in the Option field, and press [Enter].

4 ChangeMan® ZMF
 Staging a Component

4 On the Checkout panel:

• Leave the Option field blank to perform checkout, or type
“L” in the Option field to display a list of the libraries that
contain the component.
• Type the component name to check out, or leave blank for
a list.
• Type the component library type, or leave blank for a list.
• Type the source library (-n to 0 for a prior or current
baseline, or level number +n for a promotion level).
• Type the checkout target library option:
S - Staging
P - Personal (if enabled by administrator)
• For a personal target library, type both the library name
and the library data set organization.
• Select ‘Confirm overlay’ or omit to bypass.
• Type the checkout mode:
1 - Online
2 - Batch job
• Select ‘Lock component’ to place an immediate lock, or
omit to bypass.
• Select Display component user options if desired.
• Press [Enter].
For more details, see the “Checking Out a Component” chapter in
the ChangeMan ZMF User Guide.

Staging a Component
1 From the Primary Option Menu, choose 1 (Build) and press
[Enter].
2 From the Build Options menu, choose 6 (Stage) and press
[Enter].
3 On the Stage Options panel:
• Type the package ID.
• Type a stage action in the Option field:

Quick Reference 5
Staging a Component

1 - Dev (Copy a component to the staging library from a

development library, then stage the component.)
2 - Package (Stage a component already in the package.)
3 - Parms (Specify component list selection criteria.)
• Press [Enter].

Stage From Development (Dev Option)

If you chose option 1 Dev on the Stage Options panel:
1 On the Stage From Development panel:
• Type the dataset name.
• Type a dataset organization if it is not PDS or SEQ.
• Type the library type, or leave blank for a list.
• Type a stage name if a new component name is needed.
• Select a stage mode (1=Online 2=Batch).
• Select ‘Expand HFS subdirectories’ to return the contents
of all subdirectories or omit to list only the specified
directory.
• Select other options desired.
• Press [Enter].
2 For like-source components, continue with "Stage Build" on
page 8.

Stage Package Components (Package Option)

If you chose option 2 Package on the Stage Options panel:
1 On the Stage Package Components panel:
• Component status values:

Status Description
ACTIVE Component has been successfully staged
CHECKOUT Component has been checked out but not
yet staged
FROZEN Component cannot not be updated

6 ChangeMan® ZMF
 Staging a Component

Status Description
INACTIVE Name of the component was copied
forward from another package, but the
component has not been checked out to
the staging library
INCOMP Build job has not completed or has failed
UNFROZEN Previously frozen component is available
for update

• Type a line command next to one or more component

names:

Cmd Description
B Browse component
BA Browse component activity file (if enabled by
administrator)
BD Browse component general description
BL Browse component listing
D Delete component from staging library
E Edit and stage component
EA Edit activity file
ED Edit component general description
H Show history
LC Lock component from checkout/stage in this
package by another user
R Recompile component from staging library
SB Stage component in batch mode
SL Display source-load relationship (like-source
components only)
ST Stage component (S will also work)
UC Unlock component (if locked) to allow checkout/
stage

Quick Reference 7
Staging a Component

Cmd Description
UL Display User ID Work List (if enabled by
administrator)
UV Update Component User Variables
V View component
VC Display Version Control (if enabled by
administrator)
VL View component listing

• Press [Enter].
2 For like-source components, continue with "Stage Build" on
page 8.

Stage Build
Continue staging a like-source component.
1 On the Stage Build panel:
• Type the language and compile procedure name, or leave
blank for selection lists.
• Type additional compile and link edit (binder) parameters.
• Select ‘DB2 preprocessing’, and select ‘Other DB2 options’
if desired.
• Select ‘Other options’ if desired for user panels.
• Select ‘Suppress messages’ to prevent the ‘Activated’
messages from the stage job.
• Type the JCL job statements to be used for the build job.
• Press [Enter].
2 If you selected Other DB2 options or ‘User Options’, type
values desired on those panels and press [Enter].
For more details, see the “Staging a Component” chapter in the
ChangeMan ZMF User Guide.

8 ChangeMan® ZMF
 Auditing a Package

Auditing a Package
1 From the Primary Option Menu, choose 1 (Build) and press
[Enter].
2 From the Build Options menu, choose 7 (Audit) and press
[Enter].
3 On the Audit Change Package panel:
• Type the package ID.
• For Audit Part. Package, input:
- 1 - the participating package as a simple package.
- 2 - the participating package as a primary package.
- 3 - the participating package by department number.
• Autoresolve parms - Optionally type a dataset name for
additional automatic resolve processing parameters.
• Select desired options:
- Audit staging libraries only
- Include history records
- Format report for printing
- Specify the application scope
- Suppress Passed/Failed message from audit job
- Include Cross Appl Headings
- Print top line only of Cross Appl Headings
- Lock the package while audit is running
- Reset the audit lock if the audit job did not finish
- Automatically resolve out-of-synch conditions
- Update only this package rc
• Type the JCL job statement to be used for the audit job.
• Press [Enter].
4 Review the audit report in the audit job. See "Out-of-Synch
Conditions" on page 15.
For more details, see the “Auditing a Package” chapter in the
ChangeMan ZMF User Guide.

Quick Reference 9
Promoting/Demoting a Package

Promoting/Demoting a Package
1 From the Primary Option Menu, choose 3 (Promote) and press
[Enter].
2 On the Promote/Demote A Change Package panel:
• Type the package ID.
• Type “P” (Promote) or “D” (Demote) in the Option field.
• Press [Enter].
3 On the Promote or Demote Site List panel, select a site, and
press [Enter].
4 On the Promote or Demote Options panel:
• Type an action in the Option field.
• Type a next promotion level or type a demote from level, if
the field is available for input.
• For promote only, type a date and time to schedule the
promote for later, or leave blank for immediate execution.
• For promote only, select ‘Short selection list’ for selective
promotion to only display the components not currently
promoted to the next target level.
• For promote only, select ‘Bypass overlay check’ to prevent
warnings of overlays.
• Select ‘Suppress batch messages’ to suppress success/
failure messages from the promote or demote job.
• Type the JCL job statement to be used for the promote or
demote job.
• Press [Enter].
5 If you chose Selective for the promote or demote option, then
on the Promote To or the Demote From panel:
• Type “S” to select or “D” to deselect components.
• Press [Enter].
• Press [PF3] to process.
For more details, see the “Promoting and Demoting a Package”
chapter in the ChangeMan ZMF User Guide.

10 ChangeMan® ZMF
 Freezing a Package

Freezing a Package
1 From the Primary Option Menu, choose 2 (Freeze) and press
[Enter].
2 On the Freeze Options panel:
• Type the package ID.
• Type the freeze mode in the Option field:
1 - Online Freeze package online
2 - Batch Freeze package in batch
3 - Selective Selectively unfreeze/refreeze package
components
4 - Reset Reset indicator after unsuccessful batch
freeze
5 - Re-Build Re-submit install JCL build request
• Press [Enter].
3 If a freeze processing error occurs, type “4” (Reset) in the
Option field and press [Enter] to resume freeze processing at
Step 2.
For more details, see the “Freezing a Package” chapter in the
ChangeMan ZMF User Guide.

Quick Reference 11
Approving/Rejecting a Package

Approving/Rejecting a Package
1 From the Primary Option Menu, choose 4 (Approve) and press
[Enter].
2 On the Approve Package Parameters panel, type the package
ID of a frozen package, or type package selection parameters.
Press [Enter].
3 If more than one package satisfies the package selection
criteria, select a package on the Approve Package List panel
and press [Enter].
4 On the Approve/Reject Options panel, type “1” (Approve) in
the Option field and press [Enter].
5 On the Approval List panel, type “A” on a line command to
approve the package, or type “R” to reject the package, and
press [Enter].
For more details, see the “Approving or Rejecting a Package”
chapter in the ChangeMan ZMF User Guide.

Package List
1 From the Primary Option Menu, choose 5 (List) and press
[Enter].
2 Type selection criteria on the Package List Parameters panel,
and press [Enter].
3 On the Change Package List panel:
• Type “CREATE” on the Command line and press [Enter] to
create a package.
• Type a two-character option on the line command for a
package and press [Enter] to take action on the package.

Option Description
AP Audit change package
A1 Approve/Reject change package
A2 Display approver’s reject reasons
A4 Reset Approval-In-Progress indicator

12 ChangeMan® ZMF
 Package List

Option Description
A5 Re-submit installation JCL build request for package
in APR status
BB Browse/Print baseline/promotion libraries
BL Browse compressed listing
B1 Back out change package
CC Compare components in staging library against
baseline/promotion library
C1 Check out components from baseline/promotion
C2 Check out components using package component
list
C3 Check out components from release (ERO only)
DM Demote change package
D1 Memo delete change package
D2 Undelete a memo deleted change package
F1 Freeze change package online
F2 Freeze change package in batch
F3 Selectively unfreeze or refreeze change package
components
F4 Reset Freeze-In-Progress indicator
F5 Re-submit installation JCL build request for package
in FRZ status
OF Work with Online Forms
PR Promote change package
QP Query change package information
RC Recompile source code from baseline/promotion
libraries
RL Re-link (using the binder) load module
RP Generate application/package reports
RV Revert change package back to development status

Quick Reference 13
Package List

Option Description
SC Scan baseline for character strings
S1 Stage components into change package from an
external dataset
S2 Edit and stage components in change package
S3 Specify parameters to select a subset of change
package components
UA Manage Rename or Scratch request in change
package
UB Create Rename or Scratch request for baseline
component
UD Update change package DB2 information (DB2
Option only)
UI Update change package IMS information (IMS
Option only)
UR Update change package release information (ERO
only)
U1 Update change package control information
U2 Update change package description
U3 Update change package installation instructions
U4 Update package install scheduling dependencies for
external scheduler
U5 Update participating package affected applications
U6 Update complex/super package information
U7 Update change package install site and date
information
U8 Change complex/super package to CLO status
U9 Change complex/super package to OPN status
UE Update change package user information
ZP Compress change package staging libraries

14 ChangeMan® ZMF
 Out-of-Synch Conditions

Out-of-Synch Conditions
Synch Description
DUPLIC! Components in staging and baseline libraries are
identical.
SYNCH0! Package Master contains no record of this
component.
SYNCH1! Non-load component has no ISPF statistics.
SYNCH2! Like-source component was compiled without
using the designated compile procedure and
options.
SYNCH3! IDRDATA in a load component cannot be read.
SYNCH4! Like-copy component in a staging library was
changed more recently than the calling like-
source component in a staging library in the
same package.
SYNCH5! Like-copy component in a staging library was
altered more recently than the calling like-source
component in the baseline library.
SYNCH6! Component in a staging library has no
corresponding Component Activity File member in
the package.
SYNCH7! Statically linked called load in a staging library
was changed more recently than the calling load
component in a staging library in the same
package.
SYNCH8! Statically linked called load in a staging library
was changed more recently than the calling load
component in the baseline library.
SYNCH9! Load component in a staging library does not
match the corresponding like-source component
in the package.
SYNCH10! Component in the baseline library has changed
since the component was checked out to a
package staging library.

Quick Reference 15
Out-of-Synch Conditions

Synch Description
SYNCH11! Component in a staging library was changed
without using ChangeMan ZMF.
SYNCH12! Component was copied into a staging library
without using ChangeMan ZMF, or it is left over
from a stage job that abended.
SYNCH13! Component in the baseline library was changed
more recently than the component in a staging
library.
SYNCH14! Package component is not in Active status.
SYNCH15! More recent version of like-copy or LCT
component resides in a staging, promotion, or
baseline library than was used to stage a like-
source component in a package.
SYNCH16! Like-copy component in the package, which
doesn’t contain the calling like-source, was
changed after the baseline version of the like-
copy but before the calling like-source in
baseline.
SYNCH17! Like-copy component in a staging library was
deleted after it was used to stage or recompile a
like-source in the package.
SYNCH18! Called load in a staging library was deleted after it
was statically linked into a composite load in the
package.
SYNCH19! A package master record points to a package
component that is not in the staging library.
SYNCH20! Statically linked called load in staging library has
timestamp (SETSSI) that does not match the
timestamp expected by audit.
SYNCH21! Remove either the scratch/rename request or the
component it refers to from the relevant package.

16 ChangeMan® ZMF
 Out-of-Synch Conditions

Synch Description
SYNCH22! The sub-component to be scratched is in use by
the indicated top-level component. Remove the
reference to the sub-component or remove the
scratch request.
SYNCH23! The sub-component to be renamed is in use by
the indicated top-level component. It may not be
possible to resolve this until after the rename has
been processed in baseline. Change the reference
to the sub-component or remove the rename
request.

Quick Reference 17
Serena® ChangeMan® ZMF Lifecycle

Serena® ChangeMan® ZMF Lifecycle

18 ChangeMan® ZMF