Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

Table 7-6 shows BACKUP command formats for copy operations, including some of the qualifiers you can use with a copy operation.

Table 7-6 Copy Operation Quick Reference
Command Action | Command Format and Example
--- | ---
Copies a directory tree to another directory tree | BACKUP [directory...] [directory...] $ BACKUP [DAKOTA...] [SUNDANCE...]
Copies a file to another file | BACKUP file-spec file-spec $ BACKUP LOGIN.COM [.SAVE]OLDLOGIN.COM
Copies a disk volume to another disk volume | BACKUP/IMAGE ddcu: ddcu: $ BACKUP/IMAGE DBA1: DBA2:
Copies a disk volume to another disk volume using the /PHYSICAL qualifier | BACKUP/PHYSICAL ddcu: ddcu: $ BACKUP/PHYSICAL DYA1: DYA2:
Copies two disk volume sets using the /IMAGE qualifier | BACKUP/IMAGE volume-set-name ddcu:,ddcu: $ BACKUP/IMAGE USER$: DBA1:,DBA2:

Table 7-7 shows BACKUP command formats for compare operations, including some of the qualifiers you can use with a compare operation.

Table 7-7 Compare Operation Quick Reference
Command Action | Command Format and Example
--- | ---
Compares two Files--11 files | BACKUP/COMPARE file-spec file-spec $ BACKUP/COMPARE UPLIFT.EXE;3 UPLIFT.EXE;2
Compares a selected file from a save set and a Files--11 file | BACKUP/COMPARE save-set-specifier/select=file-spec file-spec $ BACKUP/COMPARE MTA0:FEB2.BCK/SELECT=[POUDRE]UPLIFT.PAS - _$ UPLIFT.PAS
Compares an image save set and Files--11 files | BACKUP/COMPARE/IMAGE save-set-specifier ddcu: $ BACKUP/COMPARE/IMAGE MTA0:12OCT.BCK DRA3:

Table 7-8 shows BACKUP command formats for a list operation, including some of the qualifiers you can use with a list operation.

Table 7-8 List Operation Quick Reference
Command Action | Command Format and Example
--- | ---
Lists the files in a save set at the terminal | BACKUP/LIST save-set-specifier $ BACKUP/LIST MTA0:1618FEB2.BCK
Lists the files in a save set, writes to a file | BACKUP/LIST=file-spec save-set-specifier $ BACKUP/LIST=NEWLIST.LIS MTA0:1618FEB2.BCK
Lists the files in a save set in full format | BACKUP/LIST/FULL save-set-specifier $ BACKUP/LIST/FULL MTA0:1618FEB2.BCK
Lists selected files in a journal file | BACKUP/LIST/JOURNAL=journal-name/selection-qualifiers $ BACKUP/LIST/JOURNAL=SYS$MANAGER:INCBACKUP - _$ /SELECT=[LYKINS.WORK...]/SINCE=1-JAN-2000

## Chapter 8
Crash Log Utility Extractor (CLUE) (VAX Only)

## 8.1 CLUE Description (VAX Only)

On VAX systems, you can use the Crash Log Utility Extractor (CLUE) to display the contents of a crash history file. The crash history file, which is created and updated by CLUE, contains key parameters from crash dump files. Unlike crash dumps, which are overwritten with each system failure (crash) and are therefore typically available only for the most recent failure, the crash history file is a permanent record of system failures. By examining the contents of the crash history file with the CLUE/DISPLAY command, you can understand and resolve the issues responsible for some crashes and you can also obtain other useful data.

On Alpha systems, CLUE features are provided through System Dump Analyzer (SDA) utility commands. Refer to the OpenVMS Alpha System Dump Analyzer Utility Manual for more information.

## 8.2 CLUE Usage Summary (VAX Only)

When a system fails, physical memory is copied to the crash dump file, and CLUE automatically appends the relevant parameters to a file named CLUE$OUTPUT:CLUE$HISTORY.DATA. You can use CLUE to display and examine the data in this file.

### Format

> CLUE /DISPLAY

### Parameters

> None.

### Description

> Before you run CLUE, define the CLUE command (either interactively or in a procedure such as a login command procedure), as follows:

>     $ CLUE :== $CLUE

> To invoke CLUE, enter the CLUE/DISPLAY command. To terminate CLUE, enter the EXIT command at the CLUE_DISPLAY> prompt or press Ctrl/Z.

> Note that you can also issue CLUE/DISPLAY commands directly from DCL, as in the following example:

>     $ CLUE/DISPLAY = DIR/TYPE=INVEXCEPTN/SINCE=21-NOV-2000/OUT=CLUE.LIS

## 8.3 CLUE Commands (VAX Only)

This section describes and provides examples of the CLUE /DISPLAY commands. You can abbreviate any command, keyword, or qualifier as long as the abbreviation is not ambiguous. The asterisk and the percent sign can be used as wildcard characters in the specification of user names, node names, and UICs.

The following table lists the commands described in this section.

Command | Description
--- | ---
DELETE | Deletes an entry from the crash history file
DIRECTORY | Displays a list of entries from the crash history file
EXIT | Exits from CLUE
EXTRACT | Extracts data from an entry in the crash history file to a file
HELP | Provides online help for CLUE/DISPLAY commands
SHOW | Displays specific information for an entry in the crash history file

## DELETE (VAX Only)

> Deletes an entry from the list and writes the remaining entries to a binary file.

### Format

> DELETE n

### Parameter

> #### n

> The number of the entry that you want to delete from the crash history file. The number of the entry corresponds to the entry number shown by the DIRECTORY command.

### Description

> Entries in the CLUE.BIN file can be permanently removed using the DELETE command. This command deletes the specified entry and writes the remaining entries to an output file. When an entry is deleted from the crash history file, a new history file (with a higher version number) is created.

### Example

    CLUE_DISPLAY> DELETE 4

> Deletes the fourth entry in the list.

## DIRECTORY (VAX Only)

> Displays a brief summary of each entry in the crash history file.

### Format

> DIRECTORY

### Qualifiers

> #### /MODULE=

> Lists all failures that correspond to the specified module (that is, failures that start with the specified string).

> #### /OFFSET=

> Lists all failures that correspond to the specified offset (that is, failures that start with the specified string).

> #### /SINCE=

> Lists all failures that have occurred since the specified date. If the /SINCE qualifier is used and no date is specified, all failures that have occurred on the current day are listed.

> #### /TYPE=

> Lists all failures that correspond to the specified type (that is, failures that start with the specified string).

### Description

> The DIRECTORY command lists the record entries in the crash history file, beginning with the most recent entry. Six headings are displayed for each entry:
> - Entry number
> - Date and time of crash
> - Type
> - Process
> - Module
> - Offset

> You can use one or more qualifiers for the DIRECTORY command to limit the crash entries that are displayed. You can also use more than one qualifier in the same command line. For example, the command DIRECTORY/SINCE=18-APR-2000/MODULE=NETACP lists only those crash entries that have taken place since April 18, 2000, and for which the module is NETACP.

###

#### Examples

#1

    CLUE_DISPLAY> DIRECTORY

    #  Time                      Type         Process name   Module   Offset
       ====                      ==========   ============   ======   ======
    1  11-JUL-2000 09:07:45.78  INVEXCEPTN   batman         NETACP   14B9
    2  01-JAN-2000 11:32:55.23  SSRVEXCEPT   startrek       SYSLOA   10A8
    3  15-MAY-2000 07:26:12.34  BADFID       evolushun      NONE     NONE
    4  22-APR-2000 10:45:20.60  INVEXCEPTN   aprocess       IOBUF    015D

> This example lists all entries in the crash history file.

#2

    CLUE_DISPLAY> DIRECTORY /MODULE=SYSLOA

    #  Time                      Type         Process name   Module   Offset
       ====                      ==========   ============   ======   ======
    2  01-JAN-2000 11:32:55.23  SSRVEXCEPT   startrek       SYSLOA   10A8

> This example lists only those entries for which the module is SYSLOA.

## EXIT (VAX Only)

> Exits from CLUE.

### Format

> EXIT

### Description

> This command exits from CLUE and returns you to the DCL level.

### Example

    CLUE_DISPLAY> EXIT
    $

> This example exits from CLUE.

## EXTRACT (VAX Only)

> Extracts all of the data from an entry in the crash history file to either an ASCII or a binary file.

### Format

> EXTRACT n

### Parameter

> #### n

> The number of the entry that you want to extract to a file. The number of the entry corresponds to the entry number shown by the DIRECTORY command.

### Qualifiers

> #### /BINARY=filename.bin

> The /BINARY qualifier writes the output to a binary file.

> #### /OUTPUT=filename.txt

> The /OUTPUT qualifier writes the output to an ASCII file. The /OUTPUT qualifier is the default.

### Description

> Use the EXTRACT command to save record entries from the crash history file to an ASCII or a binary file. If no qualifier is used, entry is written to a text file with the name CLUE$HISTORY.TXT.

### Example

    CLUE_DISPLAY> EXTRACT 3 /OUTPUT=15MAYCRASH.TXT

> This command writes the data from entry number 3 in the crash history file to an ASCII file named 15MAYCRASH.TXT.

## HELP (VAX Only)

> Provides online help for CLUE commands.

### Format

> HELP [command]

### Parameter

> #### command

> The command for which you want help.

### Example

    CLUE_DISPLAY> HELP DIRECTORY

> This command provides online help for the DIRECTORY command in CLUE.

## SHOW (VAX Only)

> Displays specific information for an entry in the crash history file.

### Format

> SHOW info_type n

### Parameters

> #### info_type

> You must choose one of the following information types:
> - CRASH---displays information similar to the SHOW CRASH command in the System Dump Analyzer (SDA) utility.
> - STACK---displays information similar to the SHOW STACK command in SDA.
> - EXEC---displays information similar to the SHOW EXEC and SHOW DEVICE commands in SDA.
> - ISTREAM---displays the instruction stream around the failing PC.
> - SUMMARY---displays the active processes on the system, similar to the SHOW SUMMARY/IMAGE command in SDA.
> - ALL---displays all the information from the preceding types.

> For more information about SDA commands, refer to the OpenVMS VAX System Dump Analyzer Utility Manual.

> #### n

> The number of the entry for which you want to display information. The number of the entry corresponds to the entry number shown by the DIRECTORY command.

### Description

> This command lets you see all the data associated with a particular failure. This information is split into several sections; you can choose to see either individual sections or all of the information.

> If the crash number is not specified, information for the most recent entry in the crash history file is displayed. You must, however, specify one of the keywords for info_type.

> If you request a specific entry from the crash history list (using the SHOW n command), the display will include some parameters that are useful only to Compaq service representatives.

###

#### Examples

#1

    CLUE_DISPLAY> SHOW ISTREAM 4

    Instructions around the failing PC:

        80A9F841 RSB
        80A9F842 BUG_CHECK #019C
        80A9F846 BUG_CHECK #019C
        80A9F84A PUSHL   R4
        80A9F84C MOVL    R5,R4
        80A9F84F BEQL    00002C88

        80A9F851 JSB     @#-7FFFCC48
        80A9F857 MOVL    (SP)+,R4
        80A9F85A RSB
        80A9F85B BUG_CHECK #019C
    PC->80A9F85F BUG_CHECK #019C  => CLUSTRLOA + 09B6F
        80A9F863 MOVL    #00,R1
        80A9F866 MOVB    #01,R0
        80A9F869 RSB
        80A9F86A INCL    00002301
        80A9F86E TSTW    000022FF
        80A9F872 BLSS    00002CA5

> This example displays instruction stream information around the failing PC from the crash history file for entry number 4.

#2

    CLUE_DISPLAY> SHOW CRASH 4

    Time of system crash:              21-MAR-2000 15:21:33.72
    Version of system:                 VAX/VMS VERSION V7.3
    System Version Major ID/Minor ID:  1/0
    VAXcluster node:                   HERMES, a VAX 6000-420
    Crash CPU ID/Primary CPU ID:       03/01
    Bitmask of CPUs active/available:  0000000A/0000000A
    CPU bugcheck codes:                CPU 03     INCONSTATE
                                      1 other    CPUEXIT
    Current Process name:              OPCOM
    Current IPL:                       8
    CPU database address:              801AA000

    General registers:

     R0  = 80A9F85B   R1  = 00000002   R2  = 80A15B08   R3  = 00010008
     R4  = 80A15AD0   R5  = 00000000   R6  = 00000001   R7  = 00000042
     R8  = 00022520   R9  = 00020F18   R10 = 00021000   R11 = 00020EC0
       .
       .
       .

> This example displays information about the state of the system at the time of the failure. The actual output from this command may contain significantly more information than is shown in this example.

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_022.HTML