www.grootersnet.nl

WASD WATCH utility


The WATCH utility allows to to see how the server follows the rules you specified - IN REAL TIME (Well, almost). You need to have administrator access - that is: you must be able to use the web-based administration tool.

If you can, you find the WATCH utility on the screen:

Click that and you'll get a choice on what you want to examine:

In case you get messages like "Page not found" you probably would take a look at "mapping". If you run CGI-scripts, you may run into an error that the header is not CGI-compliant (you can switch that off, by the way, but CGI-scripts should comply to the rules :)), you will probably look at CGI and DCL - because a DCL error may trigger the error. If your pages do something on the network, you may want to look at network Data as well.

Just check the criteria you want. In my case, I had some trouble with mapping rules and authorization, so I selected Mapping and Authorization:

A "normal' session would look like this (just getting the home page of www.grootersnet.nl) :  

16-NOV-2006 21:19:35  WATCH REPORT  diana.intra.grootersnet.nl:80
-----------------------------------------------------------------
HTTPd-WASD/9.1.4 OpenVMS/AXP (10-JUL-2006 23:09:27.60)
HP TCPIP$IPC_SHR V5.5-ECO1 (27-JUL-2005 19:03:25.26)
$ CC (V8.2/70190015) /DECC /STAND=RELAXED_ANSI /PREFIX=ALL /OPTIMIZE /NODEBUG ...
Digital Personal WorkStation  with 1 CPU and 256MB running VMS V8.2 (ODS-5 enabled, VMS NAML, ...
$ HTTPD /PRIORITY=4 /SYSUAF=RELAXED
AST:1994/2000 BIO:1997/2000 BYT:4906688/4999296 DIO:1000/1000 ENQ:457/500 FIL:289/300 ...
DCL Scripting: detached, as HTTP$NOBODY, PERSONA disabled
Process: HTTPd:80 OTHER HT_ROOT:[STARTUP]STARTUP_SERVER.COM;3 ....
Instances: DIANA::HTTPd:80
Watching: connect, request, response, mapping, authorize, error (915)
Client: "*" Service: "*" Path: "*"
|Time_______|Module__|Line|Item|Category__|Event...|
|21:19:39.18 NET      1504 0001 CONNECT    MULTIHOME no match for 192.168.0.200,80 ....
|21:19:39.18 NET      1509 0001 CONNECT    ACCEPTED 192.168.0.33,1488 on http:....
|21:19:39.18 SERVICE  1553 0001 CONNECT    VIRTUAL www.grootersnet.nl:80|
|21:19:39.18 REQUEST  3702 0001 REQUEST    GET /|
|21:19:39.18 MAPURL   1074 0001 MAPPING    PATH /|
001 [IncludeFile] HT_ROOT:[LOCAL]webmail.conf
002 [[webmail.grootersnet.nl:80]]
011 [[www.grootersnet.nl:80]]
012 [IncludeFile] HT_ROOT:[LOCAL]basic.conf
013 /  ..  SET       /ht_root/*    stmLF
014 /  ..  SET       /web/*    stmLF
015 /  ..  SET       /ht_root/doc/*    map=ELLIPSIS
016 /  ..  SET       /ht_root/src/*    NOcache map=ELLIPSIS
...
034 [IncludeFile] HT_ROOT:[LOCAL]help.conf
035 /  ..  SCRIPT+   /conan*  /cgi-bin/conan*
036 /  ..  SCRIPT+   /help*  /cgi-bin/conan*
037 /  ..  SCRIPT+   /HyperReader*  /cgi-bin/HyperReader*
038 /  ..  SCRIPT+   /HyperShelf*  /cgi-bin/HyperShelf*
...
051 /  Y-  PASS      /*  /web_disk2/public/*
|21:19:39.19 MAPURL   1099 0001 MAPPING    RESULT|
     Mapped: /web_disk2/public/
 Translated: web_disk2:[public] (ODS-5)
     Script: 
Script-File: 
   Run-Time: 
|21:19:39.19 AUTH     1128 0001 AUTHORIZE  PATH /|
001 [[www.grootersnet.nl:*]]
003     /ht_root/doc/*  G:R  W:-
005     /*  G:R  W:R
|21:19:39.19 AUTH     1314 0001 AUTHORIZE  [NONE;-;-] - R ; - R|
|21:19:39.19 CACHE    0569 0001 RESPONSE   CACHE search path 0700F00EA63A4C393133E862998601EF|
|21:19:39.19 CACHE    0569 0001 RESPONSE   CACHE search file 0700F00EA63A4C393133E862998601EF|
|21:19:39.19 CACHE    0726 0001 RESPONSE   CACHE revalidate WEB_DISK2:[public]INDEX.HTML;|
|21:19:39.19 CACHE    0882 0001 RESPONSE   CACHE hit volatile WEB_DISK2:[public]INDEX.HTML;|
|21:19:39.19 FILE     1997 0001 RESPONSE   NOT modified|
|21:19:39.19 REQUEST  0767 0001 REQUEST    STATUS 304 rx:403 tx:183 bytes 0.009765 seconds|
|21:19:39.19 REQUEST  0992 0001 CONNECT    PERSISTENT 1 192.168.0.33,1488|
|21:19:39.20 SERVICE  1553 0001 CONNECT    VIRTUAL www.grootersnet.nl:80|
|21:19:39.20 REQUEST  3702 0001 REQUEST    GET /Public.css|
|21:19:39.20 MAPURL   1074 0001 MAPPING    PATH /Public.css|
001 [IncludeFile] HT_ROOT:[LOCAL]webmail.conf
002 [[webmail.grootersnet.nl:80]]
011 [[www.grootersnet.nl:80]]
012 [IncludeFile] HT_ROOT:[LOCAL]basic.conf
013 /Public.css  ..  SET       /ht_root/*    stmLF
014 /Public.css  ..  SET       /web/*    stmLF
015 /Public.css  ..  SET       /ht_root/doc/*    map=ELLIPSIS
016 /Public.css  ..  SET       /ht_root/src/*    NOcache map=ELLIPSIS
017 /Public.css  ..  MAP       /httpd-internal-icons/*  /httpd/-/*
...
034 [IncludeFile] HT_ROOT:[LOCAL]help.conf
035 /Public.css  ..  SCRIPT+   /conan*  /cgi-bin/conan*
036 /Public.css  ..  SCRIPT+   /help*  /cgi-bin/conan*
037 /Public.css  ..  SCRIPT+   /HyperReader*  /cgi-bin/HyperReader*
038 /Public.css  ..  SCRIPT+   /HyperShelf*  /cgi-bin/HyperShelf*
...
051 /Public.css  Y-  PASS      /*  /web_disk2/public/*
|21:19:39.20 MAPURL   1099 0001 MAPPING    RESULT|
     Mapped: /web_disk2/public/Public.css
 Translated: web_disk2:[public]Public.css (ODS-5)
     Script: 
Script-File: 
   Run-Time: 
|21:19:39.20 AUTH     1128 0001 AUTHORIZE  PATH /Public.css|
001 [[www.grootersnet.nl:*]]
003     /ht_root/doc/*  G:R  W:-
005     /*  G:R  W:R
|21:19:39.20 AUTH     1314 0001 AUTHORIZE  [NONE;-;-] - R ; - R|
|21:19:39.20 CACHE    0569 0001 RESPONSE   CACHE search path 35BDB66AB430E0427A98511DDA85A495|
|21:19:39.20 CACHE    0569 0001 RESPONSE   CACHE search file 35BDB66AB430E0427A98511DDA85A495|
|21:19:39.20 CACHE    0726 0001 RESPONSE   CACHE revalidate WEB_DISK2:[public]Public.css;|
|21:19:39.20 CACHE    0882 0001 RESPONSE   CACHE hit volatile WEB_DISK2:[public]Public.css;|
|21:19:39.20 FILE     1997 0001 RESPONSE   NOT modified|
|21:19:39.20 REQUEST  0767 0001 REQUEST    STATUS 304 rx:450 tx:183 bytes 0.005859 seconds|
|21:19:39.20 REQUEST  0992 0001 CONNECT    PERSISTENT 2 192.168.0.33,1488|
|21:19:39.21 SERVICE  1553 0001 CONNECT    VIRTUAL www.grootersnet.nl:80|
|21:19:39.21 REQUEST  3702 0001 REQUEST    GET /cgi-bin/count.exe?display=counter&df=home....
|21:19:39.21 MAPURL   1074 0001 MAPPING    PATH /cgi-bin/count.exe|
001 [IncludeFile] HT_ROOT:[LOCAL]webmail.conf
002 [[webmail.grootersnet.nl:80]]
011 [[www.grootersnet.nl:80]]
012 [IncludeFile] HT_ROOT:[LOCAL]basic.conf
013 /cgi-bin/count.exe  ..  SET       /ht_root/*    stmLF
014 /cgi-bin/count.exe  ..  SET       /web/*    stmLF
...
023 /cgi-bin/count.exe  Y-  EXEC      /cgi-bin/*  /cgi-bin/*
|21:19:39.21 MAPURL   1099 0001 MAPPING    RESULT|
     Mapped: 
 Translated: 
     Script: /cgi-bin/count.exe
Script-File: CGI-BIN:[000000]COUNT.EXE
   Run-Time: 
|21:19:39.21 AUTH     1128 0001 AUTHORIZE  PATH /cgi-bin/count.exe|
001 [[www.grootersnet.nl:*]]
003     /ht_root/doc/*  G:R  W:-
005     /*  G:R  W:R
|21:19:39.21 AUTH     1314 0001 AUTHORIZE  [NONE;-;-] - R ; - R|
|21:19:39.21 AUTH     1128 0001 AUTHORIZE  PATH (none)|
001 [[www.grootersnet.nl:*]]
003     /ht_root/doc/*  G:R  W:-
005     /*  G:R  W:R
006     /cgi-bin/*  G:R  W:R
007 [[homedesk.grootersnet.nl:*]]
010 [[webmail.grootersnet.nl:*]]
013 [[genealogy.grootersnet.nl:*]]
016 [[192.168.0.200:82]]
|21:19:39.22 AUTH     1269 0001 AUTHORIZE  NONE applies|
|21:19:39.22 DCL      1296 0001 RESPONSE   SCRIPT as HTTP$NOBODY
                 CGI /cgi-bin/count.exe CGI-BIN:[000000]COUNT.EXE ()|
|21:19:39.27 REQUEST  0767 0001 REQUEST    STATUS 200 rx:396 tx:2578 bytes 0.063473 seconds|
|21:19:39.27 REQUEST  0992 0001 CONNECT    PERSISTENT 3 192.168.0.33,1488|

But if you have a problem, it will show up directly:

|21:32:41.45 MAPURL 1079 0001 MAPPING VMS WEB_DISK2:[public]watte|
001 [IncludeFile] HT_ROOT:[LOCAL]webmail.conf
002 [[webmail.grootersnet.nl:80]]
011 [[www.grootersnet.nl:80]]
012 [IncludeFile] HT_ROOT:[LOCAL]basic.conf
013 /web_disk2/public/watte .. SET /ht_root/* stmLF
014 /web_disk2/public/watte .. SET /web/* stmLF
...
034 [IncludeFile] HT_ROOT:[LOCAL]help.conf
...
051 /web_disk2/public/watte Y- PASS /* /web_disk2/public/*
|21:32:41.45 MAPURL 1090 0001 MAPPING RESULT /watte|
|21:32:41.45 ERROR 1473 0001 RESPONSE REQUEST:4900 (basic-only)
   404(000) %X00018292 "Document not found" "/watte" "(no information)"|
|21:32:41.45 REQUEST 0767 0001 REQUEST STATUS 404 rx:503 tx:864 bytes 0.013671 seconds|
|21:32:41.45 REQUEST 0992 0001 CONNECT PERSISTENT 1 192.168.0.33,1515|

Obvious since I specified a page that doesn't exist. (http://www.grootersnet.nl/watte)

Same applies for authentication: If you have an error there, use WATCH to track it down.

Don't be alarmed by the amount of output. Once you get the feeling of it, you won't want to miss it!

WASD General


Back to HowTo

Back to OpenVMS

Back home


(c) 2003- 2006 W. Grooters    Last updated 16-11-2006