Skip to content

Online Housekeeping

You can initiate the following two housekeeping functions online:

  • Delete aged packages, staging data sets, and component history.
  • Synchronize the implementation calendar.

Select option H, Housekeeping, on the Update Global Administration Options menu (CMNGAMN1). The Housekeeping Tasks (CMNHOUS0) panel is displayed.

CMNHOUS0                         Housekeeping Tasks 
Option ===> ________________________________________________________________

1 Delete         Delete packages/staging datasets/component history 
2 Synchronize     Synch implementation calendar

The options you can select are:

Option Description
1 Option 1 deletes:
● Packages in memo-delete status.
● Component history for installed packages whose aging criteria are met.
● Installed packages whose aging criteria are met.
● Staging datasets whose aging criteria are met.
A package must be in BAS, INS, or TCC status for the latter two options to be included in the delete process.

You specify global aging criteria on the Global Parameters Part 1 of 7 (CMNGGP01) panel. You specify application aging criteria on the application Parameters - Part 4 of 4 (CMNGLP04) panel.
The function submits a job created by file-tailoring the CMN$$HKP skeleton that deletes the packages, staging data sets, and component history that meet the deletion criteria. The job writes report CMN920 in step BAT10 that details the actions. A return code of 4 will be produced if there are no components or packages to be aged
2 Option 2 resynchronizes the implementation calendar by comparing planned installs for a given date against actual installs performed. The function submits a job created by file-tailoring the CMN$$HKP skeleton that resynchronizes the implementation calendar, and produces report CMN930 in step BAT10.

The reports for either of these functions are written to DDname CMNRPORT. You can use a display facility such as the Spool Display and Search Facility (SDSF) to view the report.

You can capture the JCL that is generated by either of these jobs to build a batch job of your own that you or your job scheduler can submit. See Delete Aged Packages, Staging Libraries, And Component History and Synchronize Installation Calendar for details.

Follow these steps to perform these functions:

  1. Select the desired option from the Housekeeping Tasks (CMNHOUS0) panel. The Generate Change Man Housekeeping Job (CMNHOUS1) panel is displayed.

    CMNHOUS1                  Generate Housekeeping Job 
    Command ===> ____________________________________________________
    
    Application . . . ____ (Full name, pattern or blank for list) 
    
    Job statement information: 
    //USER015R JOB (SM-1IKF-SM),'CHANGEMAN',
    //        CLASS=A, 
    //        NOTIFY=USER015, 
    //        MSGCLASS=X
    
  2. Fill in the panel as follows and press Enter to submit the job:

    Field Description
    Application Specify the application(s) that you want included in the housekeeping function that you selected. Valid values:
    aaaa - Three- or four-character application mnemonic executes the housekeeping function for one application.
    pattern - Pattern ending in *.
    Examples:
      AB* executes the housekeeping function for applications with mnemonics starting in AB.
      * executes the housekeeping function for all applications.
    blank - Displays the Application Selection List panel (CMNREPT9) for you to select one application.
    JOB Statement Information Specify an appropriate JOB statement.
  3. If you leave the Application field blank on the Generate Change Man Housekeeping Job panel (CMNHOUS1), the Application Selection List panel (CMNREPT9) is displayed.

    CMNREPT9             Application Selection List            Row 1 to 5 of 5 
    Command ===> ____________________________________________ Scroll ===> CSR
    
        Appl     Description                             High # 
      _ ACTP     ACTP Accounts Payable (Base ZMF)        000004
      _ ACTR     ACTR Accounts Receivable                000000
      _ COMM     COMM Common Components (Base ZMF)       000000
      _ GENL     GENL General Ledger (Db2 Option)        000000
      _ JZFS     JZFS zfs only application               000000
    **************************** Bottom of data *******************************
    

    Type the letter S in the selection field to the left of one application mnemonic and press Enter to submit the job.

    Note

    You can select only one application from the Application Selection List panel. If you select more than one, only the first is processed.