Preparing for Installation › CADDSPL Linear Data Set (LDS) File Considerations › MAXDS Considerations

MAXDS Considerations

Important! The MAXDS parameter cannot be dynamically changed after the LDS files have been allocated and configured. Therefore, use extreme care when calculating this value. Changing this value requires the unloading of your LDS files, reinitializing the Root LDS and appended LDS files with the new MAXDS value, and reloading the data into the LDS files.

To determine the maximum number of reports and MSGCLASS entries that can be held on the LDS files at any one time, consider the following:

• All captured reports retained in Online Viewing (OLV). Each generation of a report must be counted.
• All captured MSGCLASS retained in Online Viewing (OLV). One entry represents all of the combined MSGCLASS JES and SYSOUT data sets for a given job. Each generation of MSGCLASS retained must be counted.
• An estimate of the maximum number of reports that may have been captured by CADDSPL, but not yet processed by CA Dispatch subtasks. This includes all reports and MSGCLASS that need to be processed by RPI, MSG or the Archive subtasks, as well as all reports within open bundles not yet released for printing by the RPO subtask(s). If any of these tasks remain inactive for long periods of time, this count may fluctuate significantly.
• How frequently the DSEXVIEW or DSEXPSVW Online Viewing maintenance jobs are executed to delete expired reports from Online Viewing.

  Be aware that if these jobs are executed infrequently, more report generations will remain in the LDS files.

• An expansion factor for future growth. This factor should take into account the addition of reports and MSGCLASS from anticipated new applications.
• The allocation of the Root LDS file is limited to a maximum size of 2 GB and a MAXDS value of 8,368,176. Be aware that processing a file of this size carries significant performance and storage overhead. Therefore, the setting of the maximum size as your site's default should be avoided unless absolutely necessary after careful consideration.

The total number from all these factors will be your MAXDS value.

If you are upgrading from a prior release of CA Dispatch, you can execute job DSEXCULP, specifying member DSCULP19, to produce "Report 19 ONLINE VIEWING REPORT (MSGCLASS & REPORTS)" which lists the current number of reports that are in your existing Online Viewing files.

Review the RUN TIME MESSAGES section of the DSEXCULP execution. Within that section is an area that will look similar to the following:

RECORD NAME           NUMBER READ
OV-BASE                       172
OV-VIEW                       509

The NUMBER READ value on the line for RECORD NAME OV-VIEW indicates the number of reports and MSGCLASS that are in the current Online Viewing files. In this example, the value is 509.

Note: You must still estimate and consider the other factors above and add them to this value to calculate your MAXDS.