From: SMTP%"RELAY-INFO-VAX@CRVAX.SRI.COM" 22-JUL-1993 13:37:51.74
To: EVERHART
CC:
Subj: SETWATCH Help File
Date: Thu, 22 Jul 1993 10:21:22 +0000 (U)
From: BrandT <brandt@RFERL.ORG>
Subject: SETWATCH Help File
To: Info-Vax <info-vax@KL.SRI.COM>
Message-id: <01H0U8M0SK4Y8WX1S3@MUVAXA.RFERL.ORG>
Content-type: TEXT/PLAIN; CHARSET=US-ASCII
Content-transfer-encoding: 7BIT
To those who might be interested, here's a help file on WATCH.
WATCH.HLP
1 WATCH
SET WATCH FILE allows you to collect a variety of information about
what is happening on a system. The command requires CMKRNL privilege.
It is invoked with the following syntax:
$ SET WATCH FILE/CLASS=<classname>
Valid classes of information which can be observed are:
ALL ! Turns on all the functions
NONE ! Turns off all the functions
ATTRIBUTES ! File Attributes
ATTACHED !
CONTROL FUNCTION !
DUMP ! File Information Blocks (FIB):
DIRECTORY FUNCTION !
MAJOR_FUNCTION ! Major XOP functions
QUOTA_OPERATIONS ! Disk Quota functions
Classnames can be entered as with other DCL commands. For example:
$ SET WATCH FILE/CLASS=(ALL,NODUMP) !multiple parameters
$ SET WATCH FILE/CLASS=DIRECTORY !abbreviated parameters
Using this command you can, for instance, see all the files that are
touched during the execution of a DCL command. Some examples follow
which illustrate a few of the more useful functions. For the sake of
brevity, screen output immediately following the SET WATCH commands
has been omitted.
2 QUOTA_OPERATIONS
To observe disk quota functions:
$ SET WATCH FILE/CLASS=QUOTA
$ DEL no_oil.mar;*
%XOP-I-FUNCTION, Quota file operation:Credit/Debit quota [55,40],
Charge: -13, Usage: 19985, Perm: 30000, Over: 500
2 MAJOR_FUNCTION
To observe major XOP functions:
$ SET WATCH FILA/CLASS=MAJOR_FUNCTION
$ DIR a.dat
%XOP I FUNCTION, Access USER.DIR;1 (2996,1,0) Status: 00000001
%XOP-I-FUNCTION, Deaccess (2996,1,0) Reads: 1, Writes: 0, Status: 00000001
%XOP-I-FUNCTION, Lookup A.DAT;1532 (37923,2,0) Status: 00000001
Directory DISK7:[USER]
A.DAT;1532 1 18-JUL-1989 17:44:41.86
Total of 1 file, 1 block.
2 ATTRIBUTES
To observe checking of file attributes:
$ SET WATCH FILE/CLASS=ATTRIBUTES
4 DIR a.dat
%XOP-I-FUNCTION, Read attibutes: Record attributes USER.DIR;1 (2996,1,0)
%XOP-I-FUNCTION, Read attibutes: User file characteristics USER.DIR;1
(2996,1,0)
%XOP-I-FUNCTION, Read attributes: File header USER.DIR;1 (2996,1,0)
%XOP-I-FUNCTION, Read attributes: Record attributes A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Creation date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Revision date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Expiration date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: backup date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Statistics block A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Owner UIC A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: File protection A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: User file characteristics A.DAT;1532
(37923,2,0)
%XOP-I-FUNCTION, Read attributes: ASCII dates A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Journal flags A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTIOA, Read attributes: find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: ACL length A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: RU active A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
Directory DISK7:[USER]
A.DAT;1532 1 18-JUL-1989 17:44:41.86
Total of 1 file, 1 block.
2 DUMP
To observe contents of File Information Blocks (FIB):
$ SET WATCH FILE/CLASS=DUMP
$ DIR a.dat
%XOP-I-FUNCTION, FIB contents:
00000000 00010BB4 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00030000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00010BB4 00000000 00000000 00000000 00000000 00000000 00000000
00000000 A0000000 00000000 00030000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00010BB4 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000001 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00202853 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00202853 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000001 00000000 00000000
Directory DISK7:[USER]
%XOP-I-FUNCTION, FIB contents:
00000000 00029423 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
%XOP-I-OANCTION, FIB contents:
00000000 00029423 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000001 00000000 00000000
A.DAT;1523 1 18-JUL-1989 17:44:41.86
Total of 2 files, 2 blocks.
2 ALL
Give me everything you got!:
$ SET WATCH FILE/CLASS=ALL
$ DIR a.dat
%XOP-I-FUNCTION, FIB contents:
00000000 00010BB4 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00030000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00010BB4 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00030000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, Read attributes: record attributes USER.DIR;1 (2996,1,0)
%XOP-I-FUNCTION, Read attributes: User file characteristics USER.DIR;1
(2996,1,0)
%XOP-I-FUNCTION, Read attributes; File header USER.DIR;1 (2996,1,0)
%XOP-I-FUNCTION, Access USER.Dir;1 (2996,1,0) Status: 00000001
%XOP-I-FUNCTION, FIB contents:
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00010BB4 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000001 00000000 00000000
%XOP-I-FUNCTION, Deaccess (2996,1,0) Reads: 1, Writes: 0, Status: 00000001
%XOP-I-FUNCTION, FIB contents:
00000000 00202853 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00202853 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000001 00000000 00000000
%XOP-I-FUNCTION, Read attributes: Record attributes A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Creation date A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Revision date A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Expiration date A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Backup date A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Statistics block A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Owner UIC A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: File protection A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: User file characteristics A.DAT;1533
(10323,32,0)
%XOP-I-FUNCTION, Read attributes: ASCII dates A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Journal flags A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, R %XOP-I-FUNCTIONm Read attributes: RU active A.DAT;1533
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1533 (10323,32,0)
%XOP-I-FUNCTION, Lookup A.DAT;1533 (10323,32,0) Status: 000000010323,32,0)
Directory DISK7:[USER]
%XOP-I-FUNCTION, FIB contents:
00000000 00029423 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
%XOP-I-FUNCTION, FIB contents:
00000000 00029423 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000001 00000000 00000000
%XOP-I-FUNCTION, Read attributes: Record attributes A.DAT;1532 (37923,2,0)
%XOP-I-FUNTCION, Read attributes: Creation date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Revision date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Expiration date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Backup date A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attritubes: Statistics block A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Owner UIC A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: File protection A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: User file characteristics A.DAT;1532
%XOP-I-FUNCTION, Read attributes: ASCII dates A.DAT:1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Journal flags A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: ACL length A.DAT:1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: RU active A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Read attributes: Find ACE by type A.DAT;1532 (37923,2,0)
%XOP-I-FUNCTION, Lookup A.DAT;1532 (37923,2,0) Status: 00000001
A.DAT;1532 1 18-JUL-1989 17:44:41.86
Total of 2 files, 2 blocks.
2 NONE
To turn it off:
$ SET WATCH FILE/CLASS=NONE