Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

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-1998


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-1998/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:

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-1998/MODULE=NETACP lists only those crash entries that have taken place since April 18, 1998, and for which the module is NETACP.


Examples

#1

CLUE_DISPLAY> DIRECTORY
 
 


 
  
 
  
#  Time                      Type         Process name   Module   Offset 
   ====                      ==========   ============   ======   ====== 
1  11-JUL-1998 09:07:45.78  INVEXCEPTN   batman         NETACP   14B9 
2  01-JAN-1998 11:32:55.23  SSRVEXCEPT   startrek       SYSLOA   10A8 
3  15-MAY-1998 07:26:12.34  BADFID       evolushun      NONE     NONE 
4  22-APR-1998 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-1998 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:

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-1998 15:21:33.72 
Version of system:                 VAX/VMS VERSION V7.0    
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

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6048PRO_022.HTML