The OPEN-DIAGNOSIS-OBJECT statement assigns a diagnosis object (BS2000 dump, SELF-LOADER dump, PAM file, active BS2000 system) for diagnosis.
DAMP requires the standard BS2000 symbols for the relevant version in order to open a BS2000 object.
Format
OPEN-DIAGNOSIS-OBJECT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
OBJECT = *SYSTEM(...) / *#0(...) / *#1(...) / ... / *#9(...) / <filename 1..54 without-gen-vers with-wild(80)>(...)
This specifies the type of the diagnosis object.
OBJECT = *SYSTEM(...)
*SYSTEM assigns the active system as the diagnosis object. The user must have test authorization in order to access the active system. The system administrator can grant this authorization using the MODIFY-USER-ATTRIBUTES command and activate it by issuing the command MODIFY-TEST-OPTIONS PRIVILEG=*PAR(READ=8,WRITE=1) before the program is started.
KIND-OF-SYSTEM = *BS2000
This operand permits diagnosis in the current BS2000 system.
OBJECT = *#0(...) / *#1(...) / ... / *#9(...) / <filename 1..54 without-gen-vers with-wild(80)>(...)
A file is assigned as a diagnosis object. The keywords *#0 through *#9 (or #0 through #9 for short) are interpreted as link names if the ADD-FILE-LINK command was issued beforehand with these link names.
In addition, all the wildcards permitted for SHOW-FILE-ATTRIBUTES may be specified. If a file can be uniquely identified using the wildcards specified or the partial qualification, it is opened. Otherwise, a message is issued stating that the specification must be qualified in more detail. If the file name contains the expression $TSN, it is replaced by the TSN of the task under which DAMP is currently executing.
KIND-OF-OBJECT = *STD / *BS2000 / *SELF-LOADER / *PAM
This passes the data structure of the diagnosis object to DAMP.
KIND-OF-OBJECT = *STD
For dump files with multiple objects (e.g. for a complete VM2000 SLED), the status window (W2) is initially displayed in the dialog in INF mode with the possible selection. The required diagnosis object can be selected by marking. Otherwise *STD has the same effect as *BS2000.
KIND-OF-OBJECT = *BS2000
DAMP searches in the dump file for a BS2000 object for diagnosis. If no BS2000 object is found, the dump file is opened as a self-loader.
KIND-OF-OBJECT = *SELF-LOADER
Any number of files with the structure of a dump file can be opened. DAMP does not provide any automatic functions for SELF-LOADER dumps. All addresses are interpreted as real addresses, so only real memory segments can be displayed in the normal formats (see also "Editing SLEDs without a BS2000 structure"). More detailed analyses can only be performed via PRODAMP procedures.
KIND-OF-OBJECT = *PAM
If a file does not have the same structure as a dump file, it can only be opened as a PAM file. The data in a PAM file can only be accessed using the methods described in the section "Processing files in PAM format".
SYMBOLS = *STD(...) / <filename 1..54 without-gen-vers>(...)
The SYMBOLS operand must not normally be assigned a value.
This means that the default settings (SYMBOLS=*STD(*BS2000(*STD))) then take effect, which means that DAMP loads the BS2000 symbols that match the open BS2000 object from the standard library. If KIND-OF-OBJECT=*SELF-LOADER or *PAM was used, no symbols are loaded. If the SYMBOLS operand is used with other values, DAMP always tries to load symbols (also for KIND-OF-OBJECT=*SELF-LOADER or *PAM).
The SYMBOLS operand assigns the symbols that are required by DAMP to open thediagnosis object symbolically. Additional symbols for subsequent processing can be assigned with the ADD-SYMBOLS statement.
SYMBOLS = *STD(...) / <filename>(...)
The standard symbol library is selected as the library if *STD is specified.
If some other symbols are to be used for a BS2000 object or if special symbols are needed for a non-BS2000 object, a symbol library containing the required symbol element can be defined.
ELEMENT = *BS2000(...)
The BS2000 element name is selected. In the standard symbol library, this element name contains the symbols for the analysis of the BS2000 system.
VERSION = *STD
The element version that matches the open diagnosis object is selected.
VERSION = <composed-name_1..24_with-under>
Selects the specified element version.
The symbols in the standard symbol library have the same version name as the product for which they are valid.
ELEMENT = <filename 1..54 without-cat-user-gen-vers>(...)
This specifies the name of the element containing the symbols. The symbol elements supplied as standard with DAMP have the same name as the product to which they belong.
VERSION = *STD
The element version that matches the open diagnosis object is selected.
VERSION = <composed-name_1..24_with-under>
Selects the specified element version.
The symbols in the standard symbol library have the same version name as the product for which they are valid.
Examples
OPEN-DIAGNOSIS-OBJECT OBJECT=*SYSTEM OPEN OBJECT=$SLED.SLED.1234,SYMBOLS=syssmb.damp.<ver>(BS2000(210))