Installation
The following table shows all product files which are supplied with DAMP (Release Unit DAMP) and which are required when working with DAMP.
For each release item, the logical ID (for IMON), the release name, and the function are listed. The release items are contained in the installation file SYSSII.DAMP.<ver>.
Logical ID | Release name | Function |
SYSSII | SYSSII.DAMP.<ver> | Installation for DAMP |
SYSSDF | SYSSDF.DAMP.<ver> | SDF syntax file with the commands START-DAMP and START-DAMP-SYMBOL-GENERATOR |
SYSLNK | SYSLNK.DAMP.<ver> | Dynamically loadable library of DAMP |
SYSPRG | SYSPRG.DAMP.<ver> | Load program of DAMP |
SYSPRG.SYMBOLS | SYSPRG.DAMP.<ver>.SYMBOLS.GEN | Symbol generator for generating private symbols |
SYSMSH.D | SYSMSH.DAMP.<ver>.D | Online help German |
SYSMSH.E | SYSMSH.DAMP.<ver>.E | Online help English |
SYSMES | SYSMES.DAMP.<ver> | Message file |
SYSSDF.USER | SYSSDF.DAMP.<ver>.USER | User SDF syntax file with the DAMP statements. The syntax file is activated by DAMP. |
SYSSMB | SYSSMB.DAMP.<ver> | Supplied library with DAMP/BS2000 symbols. Only for delivery purposes and not to be directly used. |
SYSDMP | SYSDMP.DAMP.<ver> | Supplied library with DAMP-PRODAMP programs. This library contains, among other things, the PRODAMP programs for prediagnosis. The file is only needed for delivery purposes and is not to be directly used. |
Furthermore the following two files are essential for working with DAMP (see Note 3 below).
File name | Function |
$TSOS.SYSSMB.DAMP | Symbol system library |
$TSOS.SYSDMP.DAMP | PRODAMP system library |
Notes
The SYSPRG.DAMP.<ver> file is also contained as C type element and SYSPRG.DAMP.<ver>.SYMBOLS.GEN is also contained as L type element SYMGEN in the SYSLNK library, from which they are started using the START command. They are also supplied in file format for compatibility reasons.
DAMP uses the access method ANITA to access dump files and the active system. This access method must be installed correctly.
Note on the symbol system library and PRODAMP system library:
Under the default setting (SYSSMB=*STD in the OPTS window), DAMP expects to find the symbols needed in order to open the diagnosis object in the file with the fixed name $TSOS.SYSSMB.DAMP (without version suffix!). On installing/updating a BS2000 system with IMON, not only the symbols required by DAMP, but also the symbols of other official products are merged into this file.This also applies to the PRODAMP system library in a standard installation (SYSLNK/SYSDMP=*STD in the OPTS window); the PRODAMP system library has the fixed name $TSOS.SYSDMP.DAMP.
DAMP is not coupled with any BS2000 version
See section "Performance capabilities".
DAMP is independent of versions
See section "Performance capabilities".
DAMP can process dump files originating from other BS2000 versions and from other BS2000 servers.
In order to evaluate dump files from BS2000 V21.0, the library SYSLNK.ANITA must be accessible on the system and must contain the access method ANITA V21.0A.
In order to evaluate the active system BS2000 V21.0 the subsystem ANITA V21.0 must be installed. In case of need it will be automatically started by DAMP.
Calling DAMP from other user IDs
The program system DAMP with the files listed above can be installed under one or more freely selectable user IDs.
In the case of private installations, it must be noted that the files are cataloged as shareable (USER-ACCESS=*ALL-USERS) and the installation user IDs (if not TSOS) are set via START-OPTION-DIALOG (see section "Modification by the user (special window:OPTIONS)").
Other characteristics
You can use LOAD-MODULE to dynamically load your own analysis routines from any module libraries and start them with START-MODULE (see the LOAD-MODULE statement on "LOAD-MODULE Load module from library").
Users may set their own default values which are suitable for their applications (see "Setting user options" (Modification by the user (special window: OPTIONS))).
Prerequisites for access to the active system
Test privileges are required in order to access information in the active system.
They must be defined by the system administrator via the following command:
ADD-USER USER-IDENTIFICATION=userid,..., TEST-OPTIONS=*PARAMETERS(READ-PRIVILEGE=8, WRITE-PRIVILEGE=1[,MODIFICATION=*CONTROLLED])
Before DAMP is called, the test privileges must be activated using the following command:
MODIFY-TEST-OPTIONS PRIVILEGE=*PARAMETERS(READ=8,WRITE=1)
Supported terminals
The 9750 emulations of PCs are supported.
You are not allowed to use KPAC=4 under OMNIS if DAMP is running on one of the partners, since DAMP uses the K4 sequence for its own purposes.