Logging and replaying a diagnostic session

If desired, all screen inputs and outputs can be logged, i.e., saved to a file.

• The logging file can be edited for printing with the PRINT-LOGGING-FILE statement. The actual printing is also initiated with this command (see description of the statement on "PRINT-LOGGING-FILE Start list output").

• The diagnosis steps can, for example, be replayed and checked by a different person.

• The diagnosis steps performed up to now can be replayed by the same person if the diagnosis run was interrupted either on purpose or unexpectedly.

Logging a diagnostic session

Logging of a diagnostic session is activated at program level by using the LOG-SESSION statement and at system level by using the BS2000 command:
INFORM-PROGRAM MSG='*LOG-SESSION'

The name of the logging file is specified at program level with the statement LOG-SESSION LOGGING-FILE=filename or at system level with the BS2000 command:
ADD-FILE-LINK LINK-NAME=DAMPLOG,FILE-NAME=filename

After the logging file has been closed, the link name DAMPLOG is released.
If this is not done, the file name is generated automatically in the form
S.LOG.DAMP.<ver>.<date>.<time>.

Logging is terminated at program level with the STOP-LOGGING statement and at system level with the BS2000 command:
INFORM-PROGRAM MSG='*STOP-LOGGING'

If the problem is being passed on to another diagnostic technician for further analysis, the logging file should be included in file form.

Printing a diagnostic session

The diagnostic log is printed with the PRINT-LOGGING-FILE statement (see description of the statement on "PRINT-LOGGING-FILE Start list output").

Replaying a diagnostic session

Any logging file created with DAMP can be replayed with DAMP by the person who created it or by any other DAMP user.

Replay of a diagnostic session is started at program level using the statement REPEAT-SESSION <loggingfilename> and at system level using the command INFORM-PROGRAM MSG='*REPEAT-SESSION(<loggingfilename>)'.

All inputs and outputs of the logged DAMP dialog are displayed on the screen and each must be acknowledged by means of or .

Pressing the key causes a switch to system mode. If you are already in system mode, you can return to the replay function with the RESUME-PROGRAM command.

 can be used to terminate the replay function prematurely.

If the entire logging file is replayed, the system returns to the level at which the replay function was started.
If the replay function was started by means of REPEAT-SESSION <loggingfilename>, the DAMP screen mask will be displayed at the end of the replay.

If a replay is started from system mode with the command INFORM-PROGRAM MSG='*REPEAT-SESSION(<loggingfilename>)' you will be returned to system mode at the end of the replay. In this case, diagnosis with DAMP can be resumed with the RESUME-PROGRAM command.