Changeman

What is Changeman?
Changeman is a comprehensive system designed by Serena software,
which is used to develop and install various types of source code, and
source code changes into 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.
Features of Changeman: 1. Changeman provides security for the code
2.
Changeman insures a backup of the current source code and can
create backups of multiple generations
3.Unique package concept guarantees the coordination of your change
5. Controls version discrepancy and out-of-synch component
relationships
6. Maintains listings on-line for immediate access
7. Provides notifications
8. Manage your libraries (Librarian, Panvalet, or PDS, PDS/e)
9. Full suite of on-line and batch query and reporting capabilities
10. Maintain historical information in a single repository.

How will changeman help us in our work?

1.Allow a developer to capture a copy of the current production code
2.
Permit a developer to edit the code
3.
Provide a developer with different environments in which code can be
tested
4.

Allow a developer via the approval process to install the edited code
into production

Changeman Package: - A changeman package can be called as a

vehicle which carries all the changes made by the programmer from
the development environment to production environment for installing
it in the system.
It can also be used to carry the changes from development library to
testing environment for testing the code developed before promoting it
to the production environment.
Change man provides 99 testing environments.

Changeman Life Cycle: 1. Create a Change package. A Change package contains the
components or programs to be edited and installed into production. A
changeman package is identified by a unique package identification
name. 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 components: - After checking out the components from
the baseline you can edit changes in the Change Man package.
4. Staging components: - Staging is a process to edit and compile
the components in the changeman packages. 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 Mans 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.
9. Baseline ripple: - Baseline ripple is the process that Change Man
executes automatically to version all package components. This is
done to provide an option to retrieve the component when needed at
some later point of time in the exact manner it was there during that
installation.
The Changeman will do
baseline ripple after the package has been installed.

Changeman Screens: Changeman Primary Menu Screen

Change Man 4.1.OP Primary Option
1. Build
2. Freeze
3. Promote
4. Approve
5. List
B. Backout
D Delete
L Log

Menu Option

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
Back out a package in production
Delete or undelete a package
Browse the activity log

N Notify
O OFMlist
Q Query
relationships
R Revert
X Exit
Press ENTER

Browse the Global Notification File

Online Forms package list
Query packages, components and
Revert a package to DEV status
Exit Change Man
to process; enter END command to exit.

Change Man 4.1.OP Primary Option - Menu Option

Option ==> 1
1. Build
2. Freeze
3. Promote
4. Approve
5. List
B. Backout
D Delete
L Log
N Notify
O OFMlist
Q Query
relationships
R Revert

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
Back out a package in production
Delete or undelete a package
Browse the activity log
Browse the Global Notification File
Online Forms package list
Query packages, components and

- Revert a package to DEV status

X Exit
- Exit Change Man
Press ENTER to process; enter END command to exit.

Build Options
0. Dates
Display the installation calendar
1. Create
Create a new package
2. Update
Update package information
3. OFM
Create, update, approve or review online
forms
4. Utility
Rename and Scratch information
5. Checkout
Check out components form baseline or
promotion
6. Stage
Stage, edit browse and delete components
7. Audit
Audit a package
8. Recompile
Recompile source code from baseline or
promotion
9. Relink
Relink or delete load modules
B Browse
Browse print copy baseline or promotion
C Compare
Compare staging to baseline or promotion
L Listing
Browse compressed listings
S Scan
Scan baseline for character strings
Z Compress
Compress change package Staging Libraries
Press ENTER to process; Enter END command to exit

Create a New Package

Option ==>

L Long method -

Prompt for package description and special instructions

Package Title
==> Test new application PCRS
Application
=> XXXX Blank or pattern for list
Requesters Name => Mr.Raju
Requesters Phone => 1234567
Spurf/Incident/Problem => xxxxxxxxx
(XXXXXXXX, XXXXXXX,
Must use the correct project number
XXXXXXXX, XXXXXX
S=1,2,3,A)
Package Level
=> 1
(1-Simple, 2-Complex, 3-Super ,
4-Participating)

Package Type
=>
Planned
(Planned or Unplanned)
Package Time Span =>
Perm (Permanent or Temp)
Package To Copy Forward =>
(Optional package Nme)
Unplanned Reason Code
=>
(*for list)
Temp Change Duration
=> (In days)
Press ENTER to process; Enter END command for exit.

Checkout Process
Change Man 4.1.OP Primary Option - Menu Option
Option ==> 1
1. Build
2. Freeze
3. Promote
4. Approve
5. List
B. Backout
D Delete
L Log
N Notify
O OFMlist
Q Query
relationships
R Revert
X Exit
Press ENTER

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
Back out a package in production
Delete or undelete a package
Browse the activity log
Browse the Global Notification File
Online Forms package list
Query packages, components and
Revert a package to DEV status
Exit Change Man
to process; enter END command to exit.

Build Options
0. Dates
1. Create
2. Update
3. OFM
forms
4. Utility
5. Checkout
promotion
6. Stage
7. Audit
8. Recompile
promotion
9. Relink
B Browse
C Compare

Display the installation calendar

Create a new package
Update package information
Create, update, approve or review online
Rename and Scratch information
Check out components form baseline or
Stage, edit browse and delete components
Audit a package
Recompile source code from baseline or
Relink or delete load modules
Browse print copy baseline or promotion
Compare staging to baseline or promotion

Listing

Browse compressed listings

Select 5 Checkout option

Checkout Options
Option ===> 1
Package ID
===> ABCD123
1. Base/Prom
Checkout from baseline or
promotion libraries
2. Package
Checkout package components

Press ENTER to process Enter END command to exit

Checkout

SUMPROG checked out

Option ==>
L- list libraries where component is located
Package ID
=> ABCD000001 (Package or Application
name)
Component Name
=> SUMPROG (blank or pattern for
list ;* for all
member)
Library type
=>
(Blank for list )
Source Library
=> 0 (Baseline 0 to -n Promotion +1 to
+n)
Confirm Request
=> YES
(Y/ N)
Checkout Mode
=> 2
(1- Online, 2-Batch)
Press ENTER to process; Enter END command to exit.

Staging Process Screens: Change Man 4.1.OP Primary Option - Menu Option
Option ==> 1
1. Build
2. Freeze
3. Promote
4. Approve
5. List
B. Backout
D Delete
L Log
N Notify
O OFMlist
Q Query
relationships
R Revert
X Exit
Press ENTER

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
Back out a package in production
Delete or undelete a package
Browse the activity log
Browse the Global Notification File
Online Forms package list
Query packages, components and
Revert a package to DEV status
Exit Change Man
to process; enter END command to exit.

Build Options
Option ==> 6
0. Dates Display the installation calendar
1. Create Create a new package
2. Update Update package information
3. OFM
Create, update, approve or review online
forms
4. Utility
Rename and Scratch information
5. Checkout
Check out components form baseline or
promotion
6. Stage Stage, edit browse and delete components
7. Audit Audit a package

8. Recompile
Recompile source code from baseline or
promotion
9. Relink
Relink or delete load modules
B Browse Browse print copy baseline or promotion
C Compare
Compare staging to baseline or promotion
L Listing
Browse compressed listings
S Scan
Scan baseline for character strings
Z Compress
Compress change package Staging
Libraries
Press ENTER to process; Enter END command to exit

Stage Options
Option ===> 2
Package ID
1. Dev

===> ABCD1
- Stage components from development
libraries
2. Package
- Process package components
3. Parms
- Specify component list selection
Criteria
Press ENTER to process Enter END command to exit.
Freeze Options
Option ==> 2
Package ID ==> PCRS000001
1. Online
- Freeze package Online
2. Batch
- Freeze package in batch
3.
- Function is not available
4. Reset
- Reset indicator after unsuccessful
batch freeze
Automatic promotion after freeze ===> No (Y/N)
Online or batch promotion
===> B (O-Online , BBatch)
Press ENTER to process; Enter END Command to exit

Promoting a Package: Change Man 4.1.OP Primary Option - Menu Option

Option ==> 3
1. Build
2. Freeze
3. Promote
4. Approve
5. List
B. Backout
D Delete
L Log
N Notify
O OFMlist
Q Query
relationships
R Revert
X Exit
Press ENTER

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
Back out a package in production
Delete or undelete a package
Browse the activity log
Browse the Global Notification File
Online Forms package list
Query packages, components and
Revert a package to DEV status
Exit Change Man
to process; enter END command to exit.

Promote Change Package

Command ===>

Package ID ===>

ABCD000001

Press ENTER to Process; Enter END Command to exit

Promote Change Package

Command ==> P
Scroll ===> CSR
PKG ID : PCRS000001 Creator: Ven017 STAT: FRZ Install
Date : 9804300
Current promotion level : STAGING - 0
Maximum promotion level : QTESTING-10
Action Requested
=>
P (P - Promote, D-Demote, C-Check
for overlay)
Online or Batch
=>
B (O - Online, B- Batch )
Level to check
=> 1 (Required for Action C)

PROMOTE/DEMOTE HISTORY LVL NICKNAME, DATE

TIME ID

Promote Options
Option ===>F
F - Full promotion of the entire package to another
promotion level
S - Selective promotion of components to another
promotion level
PKG ID : ABCD000001 Creator : SSS001 STAT: FRZ Install
DTE : 980430
Current Promotion Level : STAGING -0
Maximum promotion level : QTESTING -10
Next Promotion Level ===>1
Job Statement information :
//ABCD JOB (XXXX, CHGMAN), CHANGEMAN,_
//CLASS =W, MSGCLASS=X, NOTIFY=&SYSUID_
(User will need to create jobcard the first time you
use Changeman )
Press ENTER to process; Enter END Command to exit.

Querying a Package: Change Man provides you with ability to query packages and their
components so that you can access general and detailed information

CMNQMENU ----------------------- QUERY OPTIONS

----------------------------OPTION ===> P
P Package - Query package information
C Component - Query component information
I Impact - Impact analysis of component relationships
Press ENTER to process; Enter END command to exit.
CMNQRY00 ------------------ QUERY PACKAGE PARAMETERS
-------------------------COMMAND ===>
SPECIFY SELECTION CRITERIA:
PACKAGE ID ===> NAVI000005 (Full name or pattern; blank for
list,

or * to select all packages)

PACKAGE STATUS ===> APR (DEV, FRZ, APR, REJ, DIS, INS,
BAS, BAK, OPN, CLO, TCC or DEL)
CREATORS TSO-ID ===> WSER85
WORK REQUEST ID ===> 416NAVIG
DEPARTMENT ===> DP
REMOTE SITE AFFECTED ===> REMPRM1
PACKAGE LEVEL ===> 4 (1-Simple, 2-Complex,
3-Super, 4-Participating)
PACKAGE TYPE ===> P (Planned or Unplanned)
PACKAGE TIME SPAN ===> P (Permanent or Temporary)
FROM INSTALL DATE ===> (YYYYMMDD)
TO INSTALL DATE ===> (YYYYMMDD)
FROM CREATION DATE ===> (YYYYMMDD)
TO CREATION DATE ===> (YYYYMMDD)
OTHER PARAMETERS ===> Y (Y/N)
Press ENTER to process; Enter END command to exit.

Result: 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
*******************************

Querying a component: CMNQCMP1 ----------------- QUERY COMPONENT PARAMETERS

---------------------COMMAND ===>
SPECIFY SELECTION CRITERIA:
COMPONENT NAME ===> IEBCOPY (Full name or pattern)
COMPONENT TYPE ===> JCL (Full library type or pattern)
APPLICATION ===> MAT
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.
Result:CMNQCMP2 ------------------- QUERY: COMPONENT LIST
---------- ROW 1 TO 17 224
COMMAND ===> SCROLL ===> PAGE
BROWSE NEXT PAGE OF COMPONENT HISTORY ===> Y (Y/N)
LIB NAME
_ SRC CMN$ACPM
_ SRC CMN$STUB
_ SRC CMN$UTIL
_ SRC CMN$XMEM
_ SRC CMNADMIN
_ SRC CMNADMJM
_ SRC CMNADMSO
_ SRC CMNALLIO
_ SRC CMNALLOC
_ SRC CMNAPI
_ SRC CMNAPIS
_ SRC CMNAPIXM
_ SRC CMNAPI2
_ SRC CMNAPI3
_ SRC CMNAPPRV
_ SRC CMNAPS10
_ SRC CMNAPS20