Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Dump information file reorganization

The first step in the viewing server JCL performs a reorganization of the dump information file. Although including this step is optional, we recommend you include it to help reduce the impact of the large scale fragmentation to which this file is often subjected. If the dump information file fragments to the point where new dump information cannot be added, the viewing server fails and the file must be manually reorganized.

The reorganization step first allocates a backup copy of the dump information file, then performs an IDCAMS REPRO of the dump information file to the backup copy, resets the dump information file, and then copies the data from the backup copy into the original file, again using IDCAMS REPRO.

Note

The original dump information file is not deleted and reallocated as part of the reorganization, so any extents being used by the file are not reclaimed.

If all steps are successful, the backup copy of the dump information file is deleted and viewing server initialization proceeds. If the REPRO to the backup copy fails, the backup copy of the dump information file is deleted and the step finishes with a return code of 8, but the viewing server still initializes. If the restore from the backup to the original file fails, the backup data set is cataloged, and the viewing server does not initialize.

In addition, the step obtains an enqueue on the dump information file until the reorganization is complete. This enqueue ensures that any requests for automatic region dump import wait until the reorganization is complete.

Review the DD statements in the step and modify them if required. The relevant statements are:

//STEPLIB  DD DISP=SHR,DSN=compware.kaz170.SKAZLOAD
//         DD DISP=SHR,DSN=compware.lcx170.SLCXLOAD
//MFDDINFO DD DISP=SHR,DSN=server.dumpinfo
//MFDDINFB DD DISP=SHR,DSN=server.dumpinfo.BACKUP
//SYSIN    DD DISP=SHR,DSN=compware.kaz170.SKAZSAMP(DINFREIN)

Note

  • Target sample library (hlq.SKAZSAMP) member DINFREIN contains the IDCAMS control statements required for the step.
  •  Review the SPACE parameter to ensure that the backup dump information file allocation is at least as large as the current size of your actual dump information file.
  •  Ensure that the UNIT reflects a valid DASD name. The value you specified for the non-SMS DASD unit in the installation dialog is the default.

Reorganizing the file adds a small amount of time to the viewing server initialization, but including the step will help minimize the risk of problems with the viewing server. Reorganizing the file is especially critical if you have a high volume of dump activity. If you determine that the additional time is prohibitive, you can comment out the reorganization step. Installation sample library hlq.CTL member DINFREOR contains a copy of the step if you ever need to refer to it.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*