Skip to content

Reverting a Release Package

When you revert a release, the status of release packages is not changed. If packages attached to a reverted release are in APR status, you can block the release and start the release approval process again without reverting release packages.

If your release was distributed to ChangeMan ZMF production instances, you can revert the release packages at the development site, and the packages will be automatically reverted at each chosen production site.

Follow these steps to revert packages that are attached to a release that you have already reverted.

Note

This procedure describes reverting a release package that is installed at production sites. If you are working in an ALL environment, you will not see the panels for site selection, but the release package backout process is essentially the same.

  1. Type =7 on the Command or Option line of any panel in ChangeMan ZMF, then press Enter.

  2. On the Release List Specification Parameters, type appropriate selection criteria and press Enter.

  3. On the Release List panel, type PK in the line command of the release you want and press Enter.

  4. The release - Release Package List panel is displayed. The status of the packages attached to the release is APR, DIS, or BAK.

    CMNRMPLF        FIN6430 - Release Package List          Row 1 to 1 of 1
    Command ===>                                            Scroll ===> CSR
    
        Package    Sta Area    Install DT/TM Last Promotion     Aud Chkd In
        ACTP000032 APR ACCTPAY 20160429 2359 SERT6    S6P1IT 00         N
        ACTP000038 DIS ACCTPAY 20160429 2359 SERT6    S6P1IT 00         N
    ******************************* Bottom of data *******************************
    
  5. Type RV in the line command for the package(s) that you want to revert, then press Enter. The Revert: Site Information panel is displayed.

    CMNRVSTI        REVERT: Site Information            Row 1 to 3 of 3
    Command ===>                                        Scroll ===> CSR
    
        Package: ACTP000038     Creator: USER239    Status: BAK
    
            Install date/time                                              Site
       site yyyymmdd from to    Primary/backup contacts     Phone numbers  status
    _ SERT# 20160418 0800 2359  KIKA HALEMANU               808-555-1213    BAK
                                IAN THOMPSON                808-555-1215
    _ SERT4 20160418 0800 2359  SALEH AL-FULAN              808-555-1217    BAK
                                HANS SCHARFF                808-555-1216
    _ SERT5 20160418 0800 2359  HUNG NGUYEN                 808-555-1214    BAK
                                WENWEI HAN                  808-555-1212
    ******************************* Bottom of data *******************************
    

    Notice the Site Status column at the right of the panel, which is the status of the release at the production instance.

  6. On the Revert: Site Selection panel, select the site or sites where you want your package reverted, and Press Enter. The site - Revert Reasons panel is displayed.

    CMNREVRS                SERT# - Revert Reasons
    COMMAND ===>
        Package: ACTP000038     Status: BAK     Install date: 20160418
    
  7. Type your reasons for reverting the site - Revert Reasons panel and press enter. If the site you selected is a P instance, the Submit Remote Revert Request panel is displayed.

    CMNRMBJC                Submit Remote Revert Request
    Command ===>
    
        Site ID: SERT#  Release: FIN6430    Creator: USER239    Status: BAK
    
    Job Statement Information:
        //USER239A JOB  (ACCOUNT),'SERT5 JOB’,  <=== CHANGE ACCORDINGLY
        //              CLASS=A,                <=== CHANGE ACCORDINGLY
        //              NOTIFY=USER239,         <=== CHANGE ACCORDINGLY
        //              MSGCLASS=Y              <=== CHANGE ACCORDINGLY
    

    Modify the job card as required and press Enter to submit a service request job that connects to the production site through TCP/IP and initiates package revert at that site.

    If you selected more than one site to revert, the site - Revert Reasons panel is displayed for the next selected site. This panel displays the revert reasons that you typed for the previous site.

    Repeat the site - Revert Reasons step and the Submit Remote Revert Request step until service request jobs have been submitted for all of sites that you selected.

  8. When you have submitted service request jobs for all of the sites that you selected, the Revert: Site Selection panel is displayed again.

    CMNRVSTI            REVERT: Site Information            Row 1 to 3 of 3
    Command ===>                                            Scroll ===> CSR
        Package: GENL000005     Creator: USER240    Status: BAK
                Install date/time                                          Site
        Site    yyyymmdd from   to  Primary/backup contacts  Phone numbers status
    _ SERT#     20160418 0800 2359  KIKA HALEMANU            808-555-1213   BAK
                                    IAN THOMPSON             808-555-1215
    _ SERT4 20160418 0800 2359      SALEH AL-FULAN           808-555-1217   DEV
                                    HANS SCHARFF             808-555-1216
    _ SERT5 20160418 0800 2359      HUNG NGUYEN              808-555-1214   BAK
                                    WENWEI HAN               808-555-1212
    ******************************* Bottom of data *******************************
    

    If you wait until all package revert jobs for a site have run, then Refresh the Revert: Site Selection panel, you can see the status of the package at a site change to DEV.

  9. Press PF3 and you are returned to the release - Release Package List panel. If all revert package jobs have run, the status of the package is changed to DEV.

    CMNRMPLF        FIN6430A - Release Package List         Row 1 to 4 of 4
    Command ===>                                            Scroll ===> CSR
    
            Package    Release                  Package
        Name    Status Area     Attach Date     Creator    Date Aud Checked In
    __ ACTP000038 DEV ACCTPAY   20101201        USER240 20100722 00     Y
    __ ACTP000039 BAK ACCTPAY   20101201        USER240 20100722 00     Y
    __ COMM000008 BAK ACCTPAY   20101201        USER240 20100812 00     Y
    __ GENL000005 BAK GENLEDGR  20101201        USER240 20100812 00     Y
    ******************************* Bottom of data *******************************
    
  10. Press PF3 and you are returned to the Release List panel.

    CMNRMRLF            Release List               Row 1 to 2 of 2
    Command ===>                                    Scroll ===> CSR
    
    Release Sta Install  Work request   Dept Aud    Creator Pkgs
    FIN6410 BAS 20160328 WR 9010        FINANCE     USER015 00001
    FIN6430 BAK 20160328 WR 9030        FINANCE     USER015 00003
    ******************************* Bottom of data *******************************
    

    Release package revert is complete.

    When a release and its attached packages are backed out, you must revert the release and all of the attached packages to DEV status to make changes and start the release install process again.