Calling NDMDAMP from DAMP

When NDMDAMP is called from DAMP, the standard analyses or the special analyses can be selected.

Standard analyses

The standard analyses consist of the analyses described for the INFORMATION operand of the START-NDM-DIAGNOSIS command (see "START-NDM-DIAGNOSIS Analyze NDM data"), except for INFORMATION=*PARAMETERS(...).

Prerequisites:

• The dump file (or the active system as the dump object) must be open.

• The system symbol library ($TSOS.SYSSMB.DAMP) must be available and must include the elements NDM, NDMNUC and DRV a for the system version to be analyzed. Otherwise, they are assigned as follows:

  ADD-SYMBOLS LIBRARY = *STD / <file> (ELEMENT = NDM / NDMNUC / DRV (VERSION = <version>))

• The system PRODAMP library ($TSOS.SYSDMP.DAMP) must contain the NDMDAMP PRODAMP objects.

  The system PRODAMP library is not predefined in DAMP by default. Consequently, it must usually be assigned as follows:

  ASSIGN-PRODAMP-LIBRARIES OBJECT-LIBRARY = *PRODAMP-SYSTEM-LIBRARY

  or in abbreviated format with:

  A-P-L O=*P.

  Instead of the keyword *PRODAMP-SYSTEM-LIBRARY, it is also possible to specify the path name of the library containing the NDMDAMP PRODAMP objects.

• The logical system file SYSLST can, if desired, be assigned to a file.

The procedures can be started by entering:

START-PRODAMP-PROGRAM NAME = NDM / NDMTRACE / NDMALL / NDMSTD / DRV / DRVALL

on the DAMP command line.

The PRODAMP procedures correspond to the analytical scope that can be selected with the INFORMATION operand of the /START-NDM-DIAGNOSIS command. The scope of the analysis for NDM is equivalent to that of NDMSTD, except for the fact that a restart is possible for NDM, but not for NDMSTD.

With the exception of NDMSTD, the analysis can be restarted in the event of errors with:

START-PRODAMP-PROGRAM NAME = NDM-RESTART

Note, however, that EDT must be available for the restart, since all the data relevant for the restart is contained in work file 9. This file must not be modified or deleted before theRestart call.

Special analyses

The special analyses are the analyses that can be individually set with INFORMATION=*PAR in the START-NDM-DIAGNOSIS command:

Prerequisites:

• The dump file (or the active system as the dump object) must be open.

• The system symbol library must be available and must include the elements NDM, NDMNUC and DRV for the system version to be analyzed. Otherwise, an appropriate library must be specified when modifying the source NDM see below).

• The system PRODAMP library ($TSOS.SYSDMP.DAMP) must contain the NDMDAMP PRODAMP objects as well as the source NDM. Otherwise, they are assigned as follows:

  ASSIGN-PRODAMP-LIBRARIES SOURCE-LIBRARY = <prodamp-library>,
ASSIGN-PRODAMP-LIBRARIES OBJECT-LIBRARY = <prodamp-library>

• The logical system file SYSLST can, if desired, be assigned to a file.

The settings for the options must be explicitly entered in the PRODAMP procedure NDM as described below:

• Loading PRODAMP dynamically:

  START-PRODAMP-EDITOR [abbr. PROC] <window-no> (between 4 and 9 or 21 and 99)

• Reading the source NDM:

  • Overwrite “(procedure/index-identifier)” with “NDM”

  • Set MODE (field after “W<window-no>”) from “Dsp” to “Rea”

  • Send the screen with DUE (SEND)

• Modifying the source NDM:

  The source NDM essentially consists of the call to the PRODAMP procedure NDM_MAIN with appropriate parameters for the symbol library and the individual elements.
  The desired values from the specified value range are entered in the PRODAMP window. Note that the lengths of the individual parameters, which are predefined by the positions of the single quotes, must not be modified in the process.
  The significance of the individual parameters and the possible values are explained in the source on the following pages. The “+” and “-” keys can be used to scroll within the PRODAMP window.

• Compiling and executing the source NDM:

  • Set MODE=Go

  • Send the screen with DUE (SEND)

  The source with the entered parameters is compiled and executed.