Skip to content

Reverting a Release

Revert release clears all release install approvals, unblocks the release, and changes the status of the release from APR, REJ, DIS, or BAK to DEV status.

The status of release areas are not changed, and packages attached to the release are not automatically reverted.

If your release was distributed to one or more ChangeMan ZMF production instances, you can initiate revert release at the development instance and revert release at some or all production sites.

If you revert a release that is waiting to install, scheduling information for packages attached to the release is removed from the scheduler, so even if you do not revert the packages, they will not install. However, you must revert a package to change any package contents. See Reverting a Release Package.

Follow these steps to revert a release:

Note

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

  1. Follow these steps to access the release that you want to revert.

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

    2. Type release selection criteria in fields on the Release List Specifications Parameters panel, or leave the fields blank, and press Enter.

      The Release List panel (CMNRMRLF) is displayed.

      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 REJ 20160328 WR 9030        FINANCE     USER015 00003
      ******************************* Bottom of data *******************************
      

      The Release List panel shows releases that satisfy the selection criteria you typed on the Release List Parameters panel.

      Notice the Sta column, which displays the overall status of the release at the development instance.

  2. On the Release List panel, type RV in the line command for the release you want to revert. Press Enter, and the Revert: Site Information panel is displayed.

    CMNRMRRS        Revert Site Information         Row 1 to 3 of 3
    Command ===>                                    Scroll ===> CSR
    
        Release: FIN6430    Creator: USER239    Status: APR
    
        Site Install        Contact             Phone           Status
    _ SERT#  20160318 0001  AGUSTO YEARWOOD     808-555-1212    N/S
    _ SERT4  20160318 0001  AGUSTO YEARWOOD     808-555-1212    REJ
    _ SERT5  20160318 0001  AGUSTO YEARWOOD     808-555-1212    N/S
    ******************************* Bottom of data *******************************
    

    This panel displays all of the sites where packages attached to this release are scheduled for install.

    Note

    The Revert: Site Information panel shows production instances where release packages were distributed. This panel also shows the development site. Revert release is a simple process of changing the release status at production sites and at the development site. There is no network of jobs that automatically reverts the development site when all production sites have been reverted.

    Notice the Status column at the right of the panel, which is the status of the release at that site.

  3. On the Revert: Site Information panel, select the installation site or sites where you want to revert your release, and press Enter. The site - Revert Reasons panel is displayed for the first selected site.

    CMNRMRRV                SERT4 - Revert Reasons
    Command ===>
    
        Release: FIN6430    Status: REJ     Install: 20101218
    

    Type your reasons for reverting the release on the The site - Revert Reasons panel.

    CMNRMRRV            SERT4 - Revert Reasons
    Command ===>
    
    
        Release: FIN6430    Status: REJ     Install: 20101218
    
    Release reverted to move non-critical projects from December release to January release
    
  4. When you are satisfied with the text you typed on the site - Revert Reasons panel, press Enter. If the site you selected for revert is a P instance, the Submit Remote Revert Request panel is displayed.

    CMNRMRJC                Submit Remote Revert Request
    Command ===>
    
    Site: SERT@     Release: FIN6430    Creator: USER239    Status: DIS
    
    Job Statement Information:
    ===> //USER01 JOB (XXXX,ZZZZ),'USER01 REVERT'_________________
    ===> //        CLASS=A,MSGCLASS=X,NOTIFY=USER01,______________
    ===> //        MSGLEVEL=(1,1)_________________________________
    ===> //*______________________________________________________
    

    Type job card information on the Submit Remove Revert Request panel, and press Enter to submit a service request job that connects to the production site through TCP/IP and initiates release 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 Remove Revert Request step until service request jobs have been submitted for all of sites that you selected.

  5. When the last installation site has been processed, you are returned to the Revert: Site Information panel.

    CMNRMRRS        Revert Site Information             Job Submitted
    Command ===>                                        Scroll ===> CSR
    
    Release: FIN6430    Creator: USER239    Status: APR
    
      Site  Install     Contact                 Phone           Status
    _ SERT# 20101218    0001 AGUSTO YEARWOOD    808-555-1212    DIS
    _ SERT4 20101218    0001 AGUSTO YEARWOOD    808-555-1212    DIS
    _ SERT5 20101218    0001 AGUSTO YEARWOOD    808-555-1212    DIS
    ******************************* Bottom of data *******************************
    
  6. Press PF3 to return to the Release List panel. When all service request jobs are finished running to revert your release at all selected remote sites, you can type Refresh in the Command line of the Release List, and the release you reverted shows an updated status of DEV.

    CMNRMRLF                Release List            Release Reverted
    Command ===>                                    Scroll ===> CSR
    
        Release Sta Install  Work request   Dept Aud    Creator Pkgs
        FIN6410 BAS 20160328 WR 9010        FINANCE     USER015 00001
        FIN6430 DEV 20160328 WR 9030        FINANCE     USER015 00003
    ******************************* Bottom of data *******************************
    
  7. Revert release is complete.

    You must revert attached packages in a reverted release to change components in those packages. See Reverting a Release Package.