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 Subject: SETWATCH Help File To: Info-Vax 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= 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