home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / osu_wasd / freeware_demo.txt next >
Text File  |  1998-09-03  |  4KB  |  116 lines
  1. WASD Scripts
  2. ------------
  3.  
  4.   *  CONAN is used to access VMS Help and text libraries.
  5.  
  6.   *  HYPERSHELF is used to navigate BNU or Bookreader shelves.
  7.  
  8.   *  HYPERREADER is the book reader (BNU and Bookreader format).
  9.  
  10.   *  HYPERSPI is a system performance monitor (of sorts!)
  11.  
  12.  
  13. INSTALLATION
  14. ------------
  15.  
  16. Unbundled from the WASD VMS Hypertext Services package for use by the OSU
  17. (DECthreads) server.  Ported using OSU v3.3a  Installation steps:
  18.  
  19.   *  link executables ... @BUILD LINK
  20.  
  21.   *  copy executables and support procedures ... @INSTALL
  22.  
  23.   *  add general and per-script mapping rules as described below
  24.  
  25.   *  HyperSPI has additional requirements,
  26.      see HYPERSPIREADME.TXT in this same directory.
  27.  
  28. Runtime files (documentation, images, etc.) are located in the [.RUNTIME]
  29. subdirectory.  The following general mapping rule should be added to
  30. HTTP_PATHS.CONF  Of course they may be relocated if desired provided the rule
  31. reflects the new location.
  32.  
  33.   pass /wasd/runtime/* /www_root/script_code/wasd/runtime/*
  34.  
  35. The CGISYM.EXE utility is used to create the required CGI DCL symbol
  36. environment (similar to CGI_SYMBOLS.EXE and SET_DCL_ENV.EXE without the
  37. non-required CGILIB.C and SCRIPTLIB.C functionality).
  38.  
  39. The HyperReader, HyperShelf and Conan scripts can all respond with a "HTTP/1.0
  40. 304 Not Modified" against requests with "If-Modified-Since:" header lines.  The
  41. SYS$TIMEZONE_DIFFERENTIAL logical is used to generate the GMT times used in the
  42. calculations.  If this logical is not correctly maintained (as in many VMS v6.n
  43. systems) an invalid time error may be reported by the script.  In the relevant
  44. script support procedure simply uncomment the indicated line to define the
  45. HTTPD$GMT logical which provides a work-around.
  46.  
  47.  
  48. CONAN
  49. -----
  50.  
  51. Add the following rule before mapping the scripts:
  52.  
  53.   map /conan* /htbin/conan*
  54.  
  55. To make the server's default help script conan comment out the "helpgate" rule
  56. and add (leave the above rule in place):
  57.  
  58.   #map /help* /htbin/helpgate/help* 
  59.   map /help* /htbin/conan*
  60.  
  61. In addition map all paths required for help or text library access (if not
  62. already provided for other requirements), for example:
  63.  
  64.   pass /sys$common/syshlp/* /sys$common/syshlp/*
  65.   pass /sys$common/syslib/* /sys$common/syslib/*
  66.  
  67.  
  68. HYPERREADER
  69. -----------
  70.  
  71. Add the following rules before mapping the scripts:
  72.  
  73.   map /hypershelf* /htbin/hypershelf*
  74.   map /hyperreader* /htbin/hyperreader*
  75.  
  76. Mapping entries will be required for ALL paths to books, shelves, etc.
  77. The following two rules are useful for BNU-style ODL CDs (V7.n):
  78.  
  79.   pass /disk$axpdoc* /disk$axpdoc*
  80.   pass /disk$vaxdoc* /disk$vaxdoc*
  81.  
  82. To access the default DECW$BOOKSHELF library:
  83.  
  84.   http://host/hypershelf
  85.  
  86. To access a BNU library specify it's location:
  87.  
  88.   http://host/hypershelf/sys$common/decw$book/library.decw$bookshelf
  89.   http://host/hypershelf/sys$common/decw$defaults/user/library.odl
  90.   http://host/hypershelf/where-ever/library.odl
  91.  
  92. To directly access a book:
  93.  
  94.   http://host/hypershelf/sys$common/decw$book/bookreader.decw$book
  95.   http://host/hypershelf/where-ever/book.bkb
  96.  
  97.  
  98. HYPERSPI
  99. --------
  100.  
  101. See the HYPERSPIREADME.TXT in this same directory.
  102.  
  103. The [.RUNTIME]HYPERSPIEXAMPLE.GIF image gives some idea of what the
  104. script-processed data looks like via a browser (before you go to all the
  105. trouble of setting it up ;^)
  106.  
  107.  
  108. MARK DANIEL
  109. -----------
  110. 3rd September 1998
  111. mailto:Mark.Daniel@dsto.defence.gov.au
  112.  
  113. ftp://www.vsm.com.au/wasd/index.html
  114. http://www.vsm.com.au:8000/wasd/index.html
  115. http://www.vsm.com.au:8000/
  116.