Skip to content

About Compressed Listings

One of the last steps in a ChangeMan ZMF build job collects sysout data sets, combines them into a single file, and stores the file in compressed format as a member in a staging library for library type LST. When you want to view the saved build job sysout, utility program SERCOPY decompresses the file into its original readable format and copies the listing to a temporary data set.

The build job establishes a source-to-load relationship between the source member and the compressed listing member. When the source member is staged again, the compressed listing is deleted to make way for a new listing. If the source member is deleted from the package, the compressed listing is also deleted.

Compressed listings are stored in baseline libraries like other application components. Prior baseline versions are baseline rippled so that old listings are available. Prior versions of baselined compressed listings are stored as full PDS members, so there are often fewer versions of build listings than there are versions of the source, which are usually stored in Stacked Reverse Delta format.

Compressed listing members can be installed in production libraries to make the listings available at remote production sites where they can be used to diagnose program problems.

Accessing Browse Listing Panels

Use one of these methods to display the Browse Compressed Listing panel:

  • Using the Menu Hierarchy:

    a On the Primary Option Menu, select 1 Build.

    b On the Build Option panel, select L Listing.

  • Using Direct Panel Access:

You can also access the Browse Compressed Listings (CMNBLST0) panel by entering =1.L on the Command line of any ChangeMan ZMF panel. Shortcuts to navigating panels is described in Chapter 2, Navigating Panels.

  • Using the Change Package List:

    On the Change Package List (CMNLIST3) panel, type BL in the line command field for a change package and press Enter.

Browsing Compressed Listings

Follow these steps to browse a compressed listing stored in a staging or baseline library. To complete this process you will access two separate Browse Compressed Listings panels (CMNRBLS0 and CMNRBLS1).

  1. Access the first Browse Compressed Listings panel (CMNRBLS0) by selecting L Listing from the Build Option (CMNBUILD) panel or entering =1.L from any ChangeMan ZMF panel. On this panel you will establish the criteria used to display a filtered list of compressed listings.

    CMNRBLS0         Browse Compressed Listings
Command ===> ___________________________________________
Specify selection criteria:
Package . . . . . . . . GENL000006
Application . . . . . . GENL    (Required if package not supplied)
Component name . . . .  _________________________________________ +
Library type . . . . . LST      (Blank for list)
From date . . . . . . .         (yyyymmdd)
To date . . . . . . . .         (yyyymmdd)

Enter "/" to select option
__ Area listings
__ Prompt for listing disposition

    This table describes the fields on the first Browse Compressed Listings (CMNRBLS0) panel.

    Specify selection criteria: You will be able to enter a combination of Package ID and/or Application to determine whether listings are obtained from package staging libraries,baseline libraries, or both. If only the Application field is selected, the listings from Baseline will be displayed. If only the Package ID field is selected the listings from Staging are displayed. If both are selected, Baseline and Staging listings are displayed.

    Field Description
    Package Enter the package ID for the listings you’ve selected to browse.
    Application Enter the application for the listings you’ve selected to browse.
    Component name Enter the component name you wish to browse or view for the listings you’ve selected.
    Name: Select compressed listings for the named component.
    Note: To select a filtered list of compressed listings you will also be able to enter a component name by specifying a pattern See Building Lists Using Patterns for information about using wild card characters to specify a pattern. Leave blank to display a list of all compressed listings.
    Library type Enter the library type for compressed listings selected. Leave this field blank to display the Library Type Selection List (CMNBLST3) panel to choose a specific library type.
    From date Enter the creation start date range for the compressed listing you have specified. The date in YYYYMMDD format is inclusive. Leaving the date blank is the same as typing 00000000. Note: The from date Created heading will be shown on the second Browse Compressed Listing Panel.
    To date Enter the creation end date range for the compressed listing you have specified. The date in YYYYMMDD format is inclusive. Leaving the date blank is the same as typing 99999999. Note: The to Changed date heading will be shown on the second Browse Compressed Listing Panel.
    Area listings Select if you would like to include the listings that are in release area libraries for the package. The package must be supplied if this option is selected. Omit if you do not want to include the area listings. Note: When you view the saved build job sysout, utility program SERCOPY will decompress the file into its original readable format and copy the listing to a temporary dataset.
    Prompt for listing disposition Select this option to display the Specify Listing Disposition (CMNBLST2) panel after displaying the uncompressed listing and disposition of the temporary file. Omit to delete the temporary file after it has been browsed.

  2. On the first Browse Compressed Listings panel, enter selection criteria and press Enter. If there are listings that satisfy your selection criteria, the second Browse Compressed Listings panel (CMNRBLS1) is displayed.

    ...

    CMNRBLS1    Browse Compressed Listings          Row 1 to 18 of 27
Command ===>___________________________________ Scroll ===> CSR

Package: GENL000006     Status: DEV     Install date: 20150228

   Name    +Level   vv.mm Created    Changed         Size Init User
__ GNLSRC1A BASE-00 01.00 2015/01/05 2015/01/05 01:22 630 630  SERT
__ GNLSRC1A STAGING 01.00 2015/01/06 2015/01/06 19:54 630 630  SERT
__ GNLSRC50 BASE-00 01.00 2015/01/05 2015/01/05 01:00 452 452  SERT
__ GNLSRC50 BASE-01 01.00 2015/01/04 2015/01/04 19:59 449 449  SERT
__ GNLSRC50 STAGING 01.00 2015/01/06 2015/01/06 21:16 453 453  SERT
__ GNLSRC99 BASE-00 01.00 2015/01/05 2015/01/05 00:55 549 549  SERT
__ GNLSRS00 BASE-00 01.00 2015/01/05 2015/01/05 00:56 490 490  SERT
__ GNLSRS00 BASE-01 01.00 2015/01/04 2015/01/04 19:35 495 495  SERT
__ GNLSRS00 BASE-02 01.00 2014/12/23 2014/12/23 18:39 492 492  SERT
__ GNLSRS00 STAGING 01.00 2015/01/06 2015/01/06 19:48 499 499  SERT
__ GNLSRS01 BASE-00 01.00 2014/12/23 2014/12/23 18:09 493 493  SERT
__ GNLSRS1B BASE-00 01.00 2015/01/05 2015/01/05 00:56 524 524  SERT
__ GNLSRS1B BASE-01 01.00 2015/01/04 2015/01/04 19:48 529 529  SERT
__ GNLSRS1B BASE-02 01.00 2014/12/23 2014/12/23 18:01 526 526  SERT
__ GNLSRS1B STAGING 01.00 2015/01/06 2015/01/06 19:21 526 526  SERT
__ GNLSRS1C BASE-00 01.00 2015/01/05 2015/01/05 00:56 506 506  SERT
__ GNLSRS1C BASE-01 01.00 2014/12/23 2014/12/23 18:09 509 509  SERT
__ GNLSRS1C STAGING 01.00 2015/01/06 2015/01/06 19:21 509 509  SERT

    This table describes the fields on the second Browse Compressed Listings panel (CMNRBLS1):

    Field Description**
    Command Enter one of the following commands, or leave the command line blank and type a line command B (Browse) or V (View) next to a component name.
    REFRESH: Display updated information on this panel. Abbreviation: R
    SORT heading: Sort listed components by information under the specified column heading.
    LOCATE member: Locate a specified entry, based on the current sort. For example, enter 'LOCATEmember' to scroll to the first occurrence of componentmember*.
    Note: You are able to sort a specific column heading (package, status or install dates) on the second Browse Compressed Listing panel to locate a member from the last sorted column or by Name if the components were not sorted. Abbreviation: L
    LONG: Display long component name on the first line, and display other component information on a second line.
    SHORT: Suppress the long component name displayed with the LONG command.
    CANCEL: Cancel the function and return to the previous panel. Abbreviation: C
    Package Status Install date The Package, Status and Install date column heading fields are displayed on the second Browse Compressed Listing (CMNRBLS1) panel if you specified a Package ID in your selection criteria.
    Line Command
    B: Display the uncompressed listing in browse mode.
    V: Display the uncompressed listing in view (edit in stage) mode.
    Name Displays the name of the component.
    Level vv.mm Created Changed Size Init User These fields display the ISPF statistics for the listed members. The LEVEL field reflects where the listing currently resides. A listing residing within a package's staging library will display the LEVEL as STAGING a listing residing within an application's baseline library will display the level as BASE - # (where # represents the baseline level). A listing residing within an ERO release area library will display the area name as the level. All release area levels that contain the listing for the selected package will be displayed. The User field displays the userid of the SERNET started task where ChangeMan ZMF runs because the member was created by the build job submitted from the started task.

  3. On the second Browse Compressed Listings (CMNRBLS1) panel, enter B (Browse) or V (View) in the command line field for a component, and press Enter. The compressed listing member is then expanded into a ChangeMan ZMF utility data set and displayed.

    ...

    Menu Utilities Compilers Help
sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss
BROWSE CMNTP.A009D.#CE61754.#4BFB561.OUTLIST     Line 00000000 Col 001 132
Command ===>                                            Scroll ===> PAGE
*********************************************************** Top of Data ************************************************************

********************************************************************************
* DDNAME: SERCOPY.SYSPRINT                                               *
********************************************************************************

SER9403I SERCOPY options: BSAM EXPAND
SER9405I Input dsname: CMNTP.S6.V810.BASE.GENL.SRS
SER9406I Output dsname: SYS15005.T005627.RA000.USER015D.SOURCE.H09
SER9407I Begin copy: INFILE=SYS15005SYS00001 OUTFILE=SYSUT2
SER9425I Copy completed successfully

********************************************************************************
* DDNAME: WRITE.SYSPRINT                                                 *
********************************************************************************

ChangeMan(R) ZMF    CMNWRITE - 8.1.0 MONDAY JANUARY 5, 2015   00:56:34
    PARM='SUBSYS=6,USER=USER015,'
    PARM interpretation: ChangeMan ZMF subsystem "6"
      Expansion of uncovered COPY/Include variations

SYSIN: TYP=CPY/CMNTP.S6.GENL.STG6.#000005.CPY
SYSIN: TYP=ZCP/CMNTP.S6.V810.BASE.GENL.ZCP
SYSIN: TYP=CPY/CMNTP.S6.V810.BASE.GENL.CPY
SYSIN: CMP=GNLSRS5A.SRS
SYSIN: LNG=COBOL2
SYSIN: PKG=GENL000005
CMN7500I - Attempting to initiate dialog with started task.
CMN1400I - Session established with ChangeMan ZMF started task.
Library search order: PDS/CMNTP.S6.GENL.STG6.#000005.CPY            (CPY)
PDS/CMNTP.S6.V810.BASE.GENL.ZCP                                     (ZCP)
PDS/CMNTP.S6.V810.BASE.GENL.CPY                                     (CPY)
LV -MEMBER--- VV.MM --CREATE-- --LAST CHANGED-- SIZE INIT -USERID- -- L I B R A R Y  N A M E ---------------- ---FINGERPRINT---
                                                      --- C O M P O N E N T  D E S C R I P T I O N ---(IF ANY)-------------
00 GNLSRS5A   --.-- *** NO ISPF/PAN/LIB STATISTICS *** SYS15005.T005627.RA000.USER015D.SOURCE.H09                 FC04ECCA-0000030C
01 GNLCPY00   03.01   2002/05/07 2015/01/01 21:43 5   1   USER015     CMNTP.S6.GENL.STG6.#000005.CPY            D345511F-000000C7
01 GNLCPY5A   01.02   2002/05/07 2014/12/23 17:56 5   1   USER015     CMNTP.S6.V810.BASE.GENL.CPY               F953A35C-000000BE
02 GNLCPY1X   01.02   2002/05/07 2014/12/23 17:56 4   1   USER015     CMNTP.S6.V810.BASE.GENL.CPY               23E79EA6-000000A3
01 GNLCPY5B   01.02   2002/05/07 2014/12/23 17:57 4   1   USER015     CMNTP.S6.V810.BASE.GENL.CPY               23F7CCA0-000000A3
CMN1410I - Session terminated with ChangeMan ZMF started task.
CMN5400I - Time of day at end of job: 00:56:35 - Condition Code on exit: 0
Record count in ====> 00029
Record count out ===> 00071

********************************************************************************
* DDNAME: COBOL2.SYSPRINT                                                      *
********************************************************************************
PP 5648-A25 IBM COBOL for OS/390 & VM 2.1.2         Date 01/05/2015 Time 00:56:37   Page 1
Invocation parameters:
OBJECT,LIB,
Options in effect:
NOADATA
  ADV
NOANALYZE
  QUOTE
NOAWO
  BUFSIZE(4096)
NOCMPR2
NOCOMPILE(S)
NOCURRENCY
  DATA(31)
NODATEPROC
NODBCS
NODECK
NODLL
NODUMP
NODYNAM

    Each sysout data set kept for the job is headed by a flower box that is labeled with DDNAME: stepname.dsname where stepname is the job step name and dsname is the sysout data set name where the sysout data set was written. See compressed listing member above for example DDNAME: SERCOPY.SYSPRINT.

    If you want to page through the sysout data sets in a listing, type the following in the command line:

    find ddname:

    then press PF5 until you find the sysout data set that you want. (Remember to type the colon after ddname.)

  4. Press PF3 to exit the browse session.

  5. The Specify Listing Disposition panel (CMNBLST2) is displayed if you select the Prompt For Listing Disposition field on the first Browse Compressed Listings (CMNRBLS0) panel.

    CMNBLST2            Specify Listing Disposition
Command ===> _________________________________________________
Listing dataset name:       CMNTP.A009D.#CE6171C.#1468839.OUTLIST

Listing disposition . . . 3         1. Print dataset and delete
                                    2. Print dataset and keep
                                    3. Delete dataset without printing
                                    4. Keep dataset without printing

Job statement information if printing:
//USER016 JOB (0000),'CHANGE MAN',
//      CLASS=A,NOTIFY=USER016,MSGCLASS=X
//*
//*

    This panel shows you the name of the utility dataset that contains the uncompressed listing, and the panel gives you various choices to delete or keep the dataset and to print or not print the listing.

  6. Press PF3 repeatedly to exit the browse compressed listing function.