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 softwarechanges, or applications, from a development environment to any testenvironment and to the production environment.

Features of Changeman: -

1. Changeman provides security for the code2. Changeman insures a backup of the current source code and can create backups of multiple generations3.Unique package concept guarantees the coordination of your change5. Controls version discrepancy and out-of-synch component relationships6. Maintains listings on-line for immediate access7. Provides notifications8. Manage your libraries (Librarian, Panvalet, or PDS, PDS/e)9. Full suite of on-line and batch query and reporting capabilities10. 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 code2.Permit a developer to edit the code3.Provide a developer with different environments in which code can be tested4.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 apackage, you provide the information that Change Man needs to track andcontrol the package.

2. Checkout components from baseline. The checkout process allows youcopy components from your baseline libraries to a Change Man staginglibrary 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 theappropriate translation procedures to create associated load modules.Components such as documentation or copy members are copied into thestaging libraries, if they are not there already.

5. Audit process: - The audit process ensures that no unexpected problemswill occur.

6. Freeze process: - The freeze process locks the package and makes thepackage available for the promotion and approval processes.

7. Promotion process (optional): - Promotion allows a package to be movedthrough various levels of testing. For example, promote from systemtesting 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 wasselected when the package was created, the package will be installedimmediately after the final approver has approved the package. If theChange Man’s internal scheduler method was selected, Change Man willautomatically install the package on the date and time specified atpackage creation. If an external scheduler is used, Change Man willconvey the install information to that scheduler so that it can install thepackage.

9. Baseline ripple: - Baseline ripple is the process that Change Manexecutes 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 Menu Option

1. Build - Create, update and review package data 2. Freeze - Freeze or unfreeze a package3. Promote - Promote or demote a package4. Approve - Approve or reject a package5. List - Display (to process) package listB. Backout - Back out a package in productionD Delete - Delete or undelete a package L Log - Browse the activity logN Notify - Browse the Global Notification FileO OFMlist - Online Forms package listQ Query - Query packages, components and relationships

R Revert - Revert a package to DEV status X Exit - Exit Change Man

Press ENTER to process; enter END command to exit.

Change Man 4.1.OP Primary Option - Menu Option

Option ==> 11. Build - Create, update and review package data 2. Freeze - Freeze or unfreeze a package3. Promote - Promote or demote a package4. Approve - Approve or reject a package5. List - Display (to process) package listB. Backout - Back out a package in productionD Delete - Delete or undelete a package L Log - Browse the activity logN Notify - Browse the Global Notification FileO OFMlist - Online Forms package listQ Query - Query packages, components and relationshipsR Revert - 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 calendar1. Create Create a new package2. Update Update package information3. OFM Create, update, approve or review online forms 4. Utility Rename and Scratch information5. Checkout Check out components form baseline or promotion 6. Stage Stage, edit browse and delete components 7. Audit Audit a package8. Recompile Recompile source code from baseline or promotion 9. Relink Relink or delete load modulesB Browse Browse print copy baseline or promotionC Compare Compare staging to baseline or promotionL Listing Browse compressed listingsS Scan Scan baseline for character stringsZ Compress Compress change package Staging Libraries

Press ENTER to process; Enter END command to exit

Create a New Package

Option ==> L

L Long method - Prompt for package description and special instructions

Package Title

==> Test new application PCRSApplication => XXXX Blank or pattern for listRequester’s Name => Mr.RajuRequester’s Phone => 1234567Spurf/Incident/Problem => xxxxxxxxx (XXXXXXXX, XXXXXXX,

Must use the correct project number XXXXXXXX, XXXXXXS=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 ==> 11. Build - Create, update and review package data 2. Freeze - Freeze or unfreeze a package3. Promote - Promote or demote a package4. Approve - Approve or reject a package5. List - Display (to process) package listB. Backout - Back out a package in productionD Delete - Delete or undelete a package L Log - Browse the activity logN Notify - Browse the Global Notification FileO OFMlist - Online Forms package listQ Query - Query packages, components and relationshipsR Revert - 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 calendar1. Create Create a new package2. Update Update package information3. OFM Create, update, approve or review online forms 4. Utility Rename and Scratch information5. Checkout Check out components form baseline or promotion 6. Stage Stage, edit browse and delete components 7. Audit Audit a package8. Recompile Recompile source code from baseline or promotion 9. Relink Relink or delete load modulesB Browse Browse print copy baseline or promotionC Compare Compare staging to baseline or promotionL Listing Browse compressed listings

Select 5 Checkout optionCheckout Options

Option ===> 1

Package ID ===> ABCD1231. 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 - Create, update and review package data 2. Freeze - Freeze or unfreeze a package3. Promote - Promote or demote a package4. Approve - Approve or reject a package5. List - Display (to process) package listB. Backout - Back out a package in productionD Delete - Delete or undelete a package L Log - Browse the activity logN Notify - Browse the Global Notification FileO OFMlist - Online Forms package listQ Query - Query packages, components and relationshipsR Revert - Revert a package to DEV status X Exit - Exit Change Man

Press ENTER to process; enter END command to exit.

Build Options

Option ==> 60. Dates Display the installation calendar1. Create Create a new package2. Update Update package information3. OFM Create, update, approve or review online

forms 4. Utility Rename and Scratch information5. Checkout Check out components form baseline or

promotion 6. Stage Stage, edit browse and delete components 7. Audit Audit a package8. Recompile Recompile source code from baseline or

promotion 9. Relink Relink or delete load modulesB Browse Browse print copy baseline or promotionC Compare Compare staging to baseline or promotionL Listing Browse compressed listingsS Scan Scan baseline for character stringsZ Compress Compress change package Staging

LibrariesPress ENTER to process; Enter END command to exit

Stage Options

Option ===> 2

Package ID ===> ABCD11. Dev - 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 ==> PCRS0000011. 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 , B-

Batch)Press ENTER to process; Enter END Command to exit

Promoting a Package: -

Change Man 4.1.OP Primary Option - Menu Option

Option ==> 31. Build - Create, update and review package data 2. Freeze - Freeze or unfreeze a package3. Promote - Promote or demote a package4. Approve - Approve or reject a package5. List - Display (to process) package listB. Backout - Back out a package in productionD Delete - Delete or undelete a package L Log - Browse the activity logN Notify - Browse the Global Notification FileO OFMlist - Online Forms package list

Q Query - Query packages, components and relationshipsR Revert - Revert a package to DEV status X Exit - Exit Change Man

Press ENTER 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 ===> CSRPKG ID : PCRS000001 Creator: Ven017 STAT: FRZ Install Date : 9804300Current promotion level : STAGING - 0Maximum promotion level : QTESTING-10Action 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 ===>FF - Full promotion of the entire package to another

promotion levelS - Selective promotion of components to another

promotion levelPKG ID : ABCD000001 Creator : SSS001 STAT: FRZ Install

DTE : 980430Current Promotion Level : STAGING -0 Maximum promotion level : QTESTING -10

Next Promotion Level ===>1Job 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 ===> PP Package - Query package informationC Component - Query component informationI Impact - Impact analysis of component relationshipsPress 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)CREATOR’S TSO-ID ===> WSER85WORK REQUEST ID ===> 416NAVIGDEPARTMENT ===> DPREMOTE SITE AFFECTED ===> REMPRM1PACKAGE 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 ===> PAGEPACKAGE 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 ===> MATPACKAGE ID ===> NAVI000005PROCEDURE NAME ===>TSOID ===> WSER85DISPLAY MODE ===> SHORT (S-Short, L-Long)CHECKOUT/STAGINGFROM DATE ===> (YYYYMMDD)TO DATE ===> (YYYYMMDD)Press ENTER to process; Enter END command to exit.

Result:-

CMNQCMP2 ------------------- QUERY: COMPONENT LIST ---------- ROW 1 TO 17 224COMMAND ===> SCROLL ===> PAGEBROWSE 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