Assigning and opening the diagnosis object

The object to be diagnosed (dump file or system) can be assigned in one of two ways:

• The statement OPEN-DIAGNOSIS-OBJECT dumpfilename assigns a SLED, SNAP, system, user or area dump for diagnosis. It is advisable to assign the link names #0,#1,...,#9 to these files before or during program execution, since this permits the assignment to be abbreviated as follows:

  OPEN-DIAGNOSIS-OBJECT #n (n = 0,...,9)

  Partially qualified file names and wildcards may be used in the file name. If a file is uniquely identified by the partial qualification or wildcard, DAMP opens this file.

  The KIND-OF-OBJECT parameter can be used to specify whether the dump object is to be opened as a BS2000 object, a SELF-LOADER or a PAM file. For more information, see also the OPEN-DIAGNOSIS-OBJECT statement on "OPEN-DIAGNOSIS-OBJECT Open diagnosis object for processing".

  The statement OPEN-DIAGNOSIS-OBJECT *SYSTEM is used to assign the active system as the object to be diagnosed. Note, however, that the calling user ID must have the read test privilege 8 for this purpose.

• The list mask can also be used to select, assign and open a dump file, even if no list is to be printed out. It is also possible to enter a partially qualified file name or a file name containing wildcards in a field provided for this purpose and then to select a file from the list of matching file names found by the system. For further details, see section “Generating and printing lists (special window: LIST)”.