home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / dec-faq / vms / part4 < prev    next >
Encoding:
Text File  |  2001-10-03  |  95.2 KB  |  2,476 lines

  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!nycmny1-snh1.gtei.net!paloalto-snf1.gtei.net!news.gtei.net!news.compaq.com!news.cpqcorp.net!not-for-mail
  2. Newsgroups: comp.os.vms,comp.sys.dec,vmsnet.alpha,vmsnet.misc,comp.answers,news.answers
  3. Distribution: world
  4. X-Newsreader: mxrn 6.18-32B
  5. References: <92irts$f4j$1@mailint03.im.hou.compaq.com> <qmqu7.958$YP.25685@news.cpqcorp.net> <8oqu7.959$YP.25678@news.cpqcorp.net>
  6. From: hoffman@xdelta.zko.dec.nospam (Hoff Hoffman)
  7. Reply-To: hoffman@xdelta.zko.dec.nospam
  8. Followup-To: poster
  9. Approved: news-answers-request@mit.edu
  10. Expires: 2 Dec 2001 00:00:00 GMT
  11. Subject: OpenVMS Frequently Asked Questions (FAQ), Part 4/5
  12. Summary: This posting contains answers to frequently asked questions about
  13.         the OpenVMS operating system from Compaq Computer Corporation, and
  14.         the computer systems on which it runs.
  15. Lines: 2454
  16. Message-ID: <uqqu7.960$YP.25635@news.cpqcorp.net>
  17. Date: Tue, 02 Oct 2001 21:35:22 GMT
  18. NNTP-Posting-Host: 16.32.80.251
  19. X-Complaints-To: abuse@Compaq.com
  20. X-Trace: news.cpqcorp.net 1002058522 16.32.80.251 (Tue, 02 Oct 2001 14:35:22 PDT)
  21. NNTP-Posting-Date: Tue, 02 Oct 2001 14:35:22 PDT
  22. Organization: Compaq Computer Corporation
  23. Xref: senator-bedfellow.mit.edu comp.os.vms:311564 comp.sys.dec:89399 vmsnet.alpha:11484 vmsnet.misc:6282 comp.answers:47273 news.answers:216436
  24.  
  25. Archive-name: dec-faq/vms/part4
  26. Posting-Frequency: quarterly
  27. Last-modified: 2 Oct 2001
  28. Version: VMS-FAQ-4.TXT(7)
  29.  
  30. This is the OpenVMS Frequently Asked Questions Part 4/5. 
  31. Please see Part 1/5 for administrivia, indexing, archiving, etc.
  32.  
  33.  
  34. ------------------------------------------------------------
  35. DECW1.  How do I let someone else display something on my workstation?
  36.  
  37. On a workstation, you go into "Customize" menu of the session manager utility
  38. and select "Security".  When the pop-up box appears, you can put
  39. node/user/tranport to allow who can launch an application to the display on
  40. that workstation.
  41.                                              [Mike Raspuzzi]
  42.  
  43. > Yah, but this doesn't seem to work with non-VMS systems.  What do I put in 
  44. > for the transport?  I tried "TCPIP" just for kicks, but it didn't work.
  45.  
  46.         You need a checklist of sorts:
  47.  
  48.       1) Make sure  that  you've  specified  the X-windows "display"
  49.          correctly  on  the remote side.  For DECNET it's  something
  50.          like NODE::0.0, for TCP/IP it's Node.Domain:0.0, etc.  On a
  51.          unix system, define the DISPLAY environment variable so:
  52.  
  53.             csh:
  54.           # setenv DISPLAY myvax.domain:0.0  
  55.             sh and ksh:
  56.               $ DISPLAY=myvax.domain:0.0 ; export DISPLAY
  57.  
  58.       2) If you've verified 1) and things still aren't working, make
  59.          sure the Security settings on  the  VMS side will allow the
  60.          connection:  Pull  down the "Options" menu in  the  Session
  61.          Manager, select "Security..."  near  the  bottom.   If  you
  62.          don't  find  your  host  (and  username) listed on the left
  63.          under "Authorized Users", go to the  right side of the menu
  64.          and   fill   in  the  three  fields,  "Node",   "Username",
  65.          "Transport".  Then click on the Add botton, then the  Apply
  66.          and  OK  buttons  to  add  the  new  host  to  the security
  67.          database.
  68.  
  69.           a) There are  various  transports: LOCAL, DECNET, LAT,
  70.              TCPIP,  etc.   Select  the one appropriate  to  the
  71.              client machine's connection to the VMS machine.
  72.  
  73.       b) If the connection is DECNET, do *NOT* add :: to the
  74.              node name!
  75.  
  76.           c) If the connection is TCPIP, "Username" _must_ be an
  77.              asterisk (*) because the  TCP/IP protocol used does
  78.              not provide the remote username.
  79.  
  80.           d) If the connection is TCPIP, it's best to use a full
  81.              domain name, e.g.,  Node.Subd.Domain.  However, you
  82.              _may_  have  to use the IP address  itself,  rather
  83.              than  the  domain  name  (EWS  requires  this).   I
  84.              generally  add two entries for each TPCIP host, the
  85.              first using the  domain  name,  the  second  the IP
  86.              address.
  87.  
  88.           e) There are a  various  3rd  party vendors who supply
  89.              TCP/IP  packages for VMS, including but not limited
  90.              to  TGV  (Multinet)  and  Wollongong  (Pathway  ?).
  91.              Multinet  (and  DEC's  own  UCX) call the transport
  92.              "TCPIP", Wollongong, at least in some incarnations,
  93.              uses "WINTCP".  You need to use the appropriate
  94.              vendor's package transport name  in the "Transport"
  95.              field.
  96.  
  97.       3) If things _still_  aren't  working, make sure the transport
  98.          you  want  has  been activated for DECwindows.  This  is  a
  99.          system manager job, but you can do the ground work yourself
  100.          before bothering the sysmgr.  Do the following:
  101.  
  102.         $ DIR SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM
  103.  
  104.          If that file exists, then do:
  105.  
  106.         $ SEARCH SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM -
  107.             $_    DECW$SERVER_TRANSPORTS
  108.  
  109.          You sould find something like:
  110.  
  111.         $ decw$server_transports == "DECNET,LOCAL,LAT,TCPIP"
  112.  
  113.          If the transport you want,  e.g., TCPIP, isn't listed, have
  114.          your  system  manager  make  the  appropriate  changes  and
  115.          restart DECwindows.  If the file doesn't exist, the  sysmgr
  116.          will  have  to  create  it  by  copying  the  corresponding
  117.          .TEMPLATE file  to  .COM  and  uncommenting  the  line that
  118.          defines decw$server_transports.
  119.  
  120.           a) If you're wanting  to  use  TCP/IP to connect, make
  121.              sure  TCP/IP is available on the VMS host.   TCP/IP
  122.              is _not_ native to VMS.  You  need  to  be  running
  123.              either Compaq's TCP/IP or a 3rd party vendor's TCP/IP
  124.              product.   If  you're  not,  none of the above will
  125.              help.
  126.                     [Fairfield@Slac.Stanford.Edu]
  127.  
  128. There is a log file created in SYS$MANAGER which tells you which transports
  129. are loaded, and also tell you what connect attempts were rejected, including
  130. showing what the presented credentials were.  This file is
  131. SYS$MANAGER:DECW$SERVER_0_ERROR.LOG, although the 0 could be another number if
  132. you have multiple servers on the workstation.  I have found this file to be
  133. very useful for tracking down what needs to be put in the Session Manager
  134. Security entries.
  135.                     [rabinowitz@bear.com]
  136.  
  137. ------------------------------------------------------------
  138. DECW2.  How do I create a display on another workstation?
  139.  
  140. $ SET DISPLAY /CREATE /TRANSPORT=net_transport /NODE=remote_node
  141.  
  142. for LAT the command might look like this:
  143.  
  144. $ SET DISPLAY /CREATE /TRANSPORT=LAT /NODE=REMOTE_NODE
  145.  
  146. for DECnet:
  147.  
  148. $ SET DISPLAY /CREATE /TRANSPORT=DECNET /NODE=NODE
  149.  
  150. for TCP/IP
  151.  
  152. $ SET DISPLAY /CREATE /TRANSPORT=TCPIP /NODE=128.12.4.122
  153.  
  154. Note that LAT is typically used for X terminals but can be used from
  155. OpenVMS to OpenVMS systems on OpenVMS Alpha V6.1 (if you have setup the X
  156. server to allow the LAT transport - check the docs).  LAT will be supported
  157. on OpenVMS VAX as a transport for DECwindows in a future OpenVMS VAX
  158. release.
  159.                     [Mike Raspuzzi]
  160.  
  161. There is a log file created in SYS$MANAGER which tells you which transports
  162. are loaded, and also tell you what connect attempts were rejected, including
  163. showing what the presented credentials were.  This file is
  164. SYS$MANAGER:DECW$SERVER_0_ERROR.LOG, although the 0 could be another number if
  165. you have multiple servers on the workstation.  I have found this file to be
  166. very useful for tracking down what needs to be put in the Session Manager
  167. Security entries.
  168.                                         [rabinowitz@bear.com]
  169.  
  170. ------------------------------------------------------------
  171. DECW3.  How can I get the information from SHOW DISPLAY into a symbol?
  172.  
  173. Use the undocumented SHOW DISPLAY/SYMBOL, and then reference the symbols
  174. DECW$DISPLAY_NODE,  DECW$DISPLAY_SCREEN, DECW$DISPLAY_SERVER and/or
  175. DECW$DISPLAY_TRANSPORT.
  176.                     [Fairfield@Slac.Stanford.Edu]
  177.  
  178. An example of calling the underlying (and also undocumented) sys$qio 
  179. programming interface for the WSDRIVER (WSAn:) is available at:
  180.  
  181.   http://www.openvms.compaq.com/freeware/srh_examples/DECUS_UNDOC_CLINIC/
  182.  
  183. ------------------------------------------------------------
  184. DECW4.  How do I get a log of a DECterm session?
  185.  
  186. If you are working from a Decterm, you can use the AutoPrint feature. Choose
  187. the "Printer..." menu item from the "Options" menu, set the printing
  188. destination to the name of the file you want, and set "Auto Print Mode".
  189. You are now free to continue.
  190.  
  191. It should be noted that ALL the characters and escape sequences are captured,
  192. but if you display the log file on a DECterm you will get EXACTLY what you had.
  193.                     [Yaacov Fenster]
  194.  
  195. ------------------------------------------------------------
  196. DECW5.  Problem - the DELETE key deletes forward instead of backward!
  197.  
  198. This has to do with Motif's virtual bindings.  When a Motif application starts
  199. up, it looks at the vendor string returned in the display connection
  200. information and attempts to match the string to a table of virtual bindings.
  201.  
  202. You can override the default bindings in your decw$xdefaults.dat file. Here is
  203. the entry you would make to get the default VMS bindings.
  204.     
  205. *defaultVirtualBindings:\
  206.  osfCancel    :        <Key>F11    \n\
  207.  osfLeft    :        <Key>Left    \n\
  208.  osfUp        :        <Key>Up        \n\
  209.  osfRight    :        <Key>Right    \n\
  210.  osfDown    :        <Key>Down    \n\
  211.  osfEndLine    :Alt        <Key>Right    \n\
  212.  osfBeginLine    :Alt        <Key>Left    \n\
  213.  osfPageUp    :        <Key>Prior    \n\
  214.  osfPageDown    :        <Key>Next    \n\
  215.  osfDelete    :Shift        <Key>Delete    \n\
  216.  osfUndo    :Alt        <Key>Delete    \n\
  217.  osfBackSpace    :        <Key>Delete    \n\
  218.  osfAddMode    :Shift        <Key>F8        \n\
  219.  osfHelp    :        <Key>Help    \n\
  220.  osfMenu    :        <Key>F4        \n\
  221.  osfMenuBar    :        <Key>F10    \n\
  222.  osfSelect    :        <Key>Select    \n\
  223.  osfActivate    :        <Key>KP_Enter    \n\
  224.  osfCopy    :Shift        <Key>DRemove    \n\
  225.  osfCut        :        <Key>DRemove    \n\
  226.  osfPaste    :        <Key>Insert
  227.  
  228. To merge:
  229.  
  230.     $ xrdb :== $decw$utils:xrdb.exe
  231.     $ xrdb -nocpp -merge decw$xdefaults.dat
  232.                     [Fred Kleinsorge]
  233.  
  234. ------------------------------------------------------------
  235. DECW6.  Why is DECwindows Motif not starting?
  236.  
  237. First check to see if there is a graphics device, usually a G* device.
  238. (eg: On a DEC 2000 model 300, use the command SHOW DEVICE GQ)  If you
  239. do not find a graphics device:
  240.  
  241. a) OpenVMS has failed to find the appropriate IRQ information for an
  242.    EISA graphics card (on the DEC 2000 series) such as the Compaq QVision,
  243.    and did not autoconfigure it.  Run the correct ECU (for Tru64 UNIX and 
  244.    OpenVMS) and reboot.  This is necessary only on EISA-based systems.
  245.  
  246. b) You have an EISA-based system (such as the DEC 2000 model 300) and do 
  247.    not have a Compaq QVision video card.  This EISA graphics card should 
  248.    have Compaq printed on it, and identifies itself as a CPQ3011 or a 
  249.    CPQ3111.  If it is not one of these two EISA devices, then OpenVMS 
  250.    does not support it.  (There are no other supported EISA graphics
  251.    controllers, and EISA graphics are normally used with DECwindows only 
  252.    on the DEC 2000 series systems.)
  253.  
  254. c) You have a PCI-based system and do not have a supported graphics
  255.    controller -- examples of supported controllers include the
  256.  
  257.      PowerStorm 3D30
  258.      PowerStorm 4D20
  259.      PowerStorm 300
  260.      PowerStorm 350
  261.      ELSA GLoria Synergy
  262.  
  263.    See MGMT24 for information on some of these graphics controllers.
  264.  
  265. d) You have booted the system minimally, or have otherwise disabled
  266.    the device autoconfiguration process.
  267.  
  268. If there is a G* graphics device present:
  269.  
  270. a) There may have been a severe error in the DECwindows startup. Type the
  271.    contents of SYS$MANAGER:DECW$SERVER_0_ERROR.LOG for any information on
  272.    errors starting the server.
  273.  
  274. b) The system parameter WINDOW_SYSTEM is not set to 1.  This is a common 
  275.    way for system managers to disable the DECwindows server startup.
  276.  
  277.    If you really do not want a workstation system to bootstrap as and
  278.    to represent itself as a workstation to DECwindows, add the following 
  279.    definition to SYLOGICALS.COM:
  280.  
  281.      $ DEFINE/SYSTEM/EXEC DECW$IGNORE_WORKSTATION TRUE
  282.  
  283. c) You may not have a valid Motif license.    To check for the Motif 
  284.    license, type the commands:
  285.  
  286.      $ LICENSE LIST DW-MOTIF/FULL 
  287.      $ LICENSE LIST NET-APP-SUP*/FULL
  288.  
  289.    and examine the information displayed.  Make sure that one of these
  290.    licenses is present, valid and active.
  291.  
  292. d) Check that the DECW$PRIVATE_SERVER_SETUP.COM is correct for the
  293.    graphics controller in use.  For instance:
  294.  
  295.      From the 9FX Vision 330 Owners Guide, EK-V330G-OG pg 2-9
  296.  
  297.      Place the following in DECW$PRIVATE_SERVER_SETUP.COM (copy from 
  298.      .TEMPLATE, if needed).  Have the file in SYS$SPECIFIC:[SYSMGR] or 
  299.      in SYS$COMMON:[SYSMGR] as apropriate.
  300.  
  301.        $ DECW$XSIZE_IN_PIXELS == <xvalue>
  302.        $ DECW$YSIZE_IN_PIXELS == <yvalue>
  303.        $ DEFINE/SYSTEM DECW$SERVER_REFRESH_RATE <rate in Hz>
  304.  
  305. Also see DECW14
  306.                     [Kleinsorge, Hoffman]
  307.  
  308. ------------------------------------------------------------
  309. DECW7 relocate to SUPP7
  310.  
  311. ------------------------------------------------------------
  312. DECW8 relocated to SUPP8
  313.  
  314. ------------------------------------------------------------
  315. DECW9.  How do I set the title on a DECterm window?
  316.  
  317. If you are creating a new DECterm window, check 
  318. HELP CREATE /TERMINAL /WINDOW_ATTRIBUTES.
  319.  
  320. If you want to change the title of an existing window, use the following
  321. control sequences, where <esc> is the ANSI escape code, value decimal 27, 
  322. and <text label> is what you want to display:
  323.  
  324. To set the DECterm title, send <esc>]21;<text label><esc>\
  325. To set the icon label, send    <esc>]2L;<text label><esc>\
  326.  
  327. To set both the DECterm title and icon to the full device name:
  328.  
  329. $  esc[0,7] = 27
  330. $  fulldevnam = F$Edit(F$GetDVI("TT","FULLDEVNAM"),"UPCASE,COLLAPSE")
  331. $  write sys$output esc+ "]21;" + fulldevnam + esc + "\"
  332. $  write sys$output esc+ "]2L;" + fulldevnam + esc + "\"
  333.  
  334. You can also change the title and the icon using the Options-Window...
  335. menu.
  336.  
  337. Also see MISC2, DCL12.
  338.  
  339. ------------------------------------------------------------
  340. DECW10. How do I customize DECwindows, including the login screen?
  341.  
  342. To customize various DECwindows Motif characteristics including the defaults
  343. used by the SET DISPLAY command, the DECwindows login screen background logo
  344. used (the default is the DIGITAL or Compaq logo), various keymaps, the 
  345. FileView defaults, session manager defaults, the DECwindows login processing,
  346. DECwindows log file processing, and various other DECwindows attributes, see
  347. the example file:
  348.  
  349.   SYS$STARTUP:DECW$PRIVATE_APPS_SETUP.TEMPLATE
  350.  
  351. This example template file is typically copied over to the filename
  352. SYS$COMMON:[SYS$STARTUP]DECW$PRIVATE_APPS_SETUP.COM and then modified to meet
  353. site-specific requirements.
  354.  
  355. Additionally, various X tools such as xsetroot, bitmap and xrdb -- some these
  356. can be useful in customizing the appearance of an application or of the
  357. DECwindows Motif display -- are provided in the DECW$UTILS: area.
  358.  
  359. When using DECwindows V1.2-4 and later on OpenVMS Alpha, the default desktop 
  360. is the Common Desktop Environment (CDE).  You can select your prefered 
  361. desktop (CDE or DECwindows Motif) when logging in, or you can change the 
  362. default to the DECwindows Motif desktop using the DCL symbol 
  363. decw$start_new_desktop in the DECwindows private application setup command 
  364. procedure.  See SYS$STARTUP:DECW$PRIVATE_APPS_SETUP.TEMPLATE for further 
  365. details, and how to create DECW$PRIVATE_APPS_SETUP.COM.
  366.  
  367. Note that with DECwindows CDE, the root window is no longer visible by 
  368. default.  The root window is hidden behind the "backdrop" window of the 
  369. current CDE workspace.  To make the root window visible, use the CDE 
  370. style manager selection "backdrop none", and use information such as 
  371. that in the OpenVMS FAQ to set the root window.
  372.  
  373. To add a new backdrop to the DECwindows CDE environment, the backdrop
  374. must first be in or be converted into X11 pixmap format.  (This conversion
  375. is often possible using tools such as xv.)  Then (if necessary) create
  376. the default backdrop directory SYS$COMMON:[CDE$DEFAULTS.USER.BACKDROPS].
  377. Place the X11 pixmap file containing the desired image into the backdrops
  378. directory, ensure that it has a filename extension of .PM.  (The xv
  379. default filename extension for the X11 pixmap file is .XPM, while CDE
  380. expects only to see files with .PM.)  Now invoke the CDE style manager
  381. and select a new backdrop.  You will find your image will be placed at
  382. the end of the list of backdrops available.
  383.  
  384.                     [Stephen Hoffman]
  385.  
  386. ------------------------------------------------------------
  387. DECW11. Why doesn't XtAppAddInput() work on OpenVMS?
  388.  
  389. XtAppAddInput() does work on OpenVMS.  The MIT definition of the X Windows
  390. call XtAppAddInput() includes platform-specific arguments.
  391.  
  392. On platforms where C is the typically the primary programming language for
  393. the platform, the file descriptor mask is one of the arguments to the
  394. XtAppAddInput() call.
  395.  
  396. On OpenVMS, the platform-specific arguments to this call include an event
  397. flag and an IOSB, as these are the traditional OpenVMS constructs used to
  398. synchronize the completion of asynchronous operations.  While it would be
  399. easier to port non-OpenVMS C code that calls XtAppAddInput() over to
  400. OpenVMS if the arguments included the C file descriptor, this would make
  401. the call unusable from other OpenVMS languages, and would make it extremely
  402. difficult to use OpenVMS features such as ASTs and sys$qio calls.
  403.  
  404. One restriction on the event flag: the event flag chosen must be from event
  405. flag cluster zero.  When using the traditional lib$get_ef and lib$free_ef
  406. calls to allocate and deallocate event flags, you must first explicitly
  407. call lib$free_ef to free up some event flags in event flag cluster zero.
  408. Please see the event flag documentation for specific details on these calls
  409. and for specific event flags that can be freed in event flag cluster zero.
  410.  
  411. Here is some example code that covers calling this routine on OpenVMS:
  412.  
  413.     m->InputID = XtAppAddInput(
  414.         m->AppCtx,
  415.         m->InputEF,
  416.         m->InputIosb,
  417.         the_callback, 1 );
  418.     if ( !((int) m->InputID ))
  419.         {
  420.         XtAppErrorMsg(
  421.             m->AppCtx,
  422.             "invalidDevice",
  423.             "XtAppAddInput",
  424.             "XtToolkitError",
  425.             "Can't Access Device",
  426.             (String *) NULL,
  427.             (Cardinal *) NULL );
  428.         ...
  429.                     [Stephen Hoffman]
  430.  
  431. ------------------------------------------------------------
  432. DECW12. Why do the keyboard arrow keys move the DECwindows cursor?
  433.  
  434. Congratulations, you have just stumbled into "dead rodent" mode.
  435. This DECwindows environment -- where the keyboard arrow keys
  436. move the mouse cursor and where the [SELECT], [PREV], and [NEXT]
  437. keys emulate the three mouse buttons -- allows rudimentary system 
  438. operations when the mouse is among the casualties.
  439.  
  440. To enter or exit the "dead rodent" mode. press: [CTRL][SHIFT][F3]
  441.  
  442. ------------------------------------------------------------
  443. DECW13. Why does half my DECwindows display blank?
  444.  
  445. This is likely a result of receiving an OPCOM or other console
  446. message on a system that shares the system console with the 
  447. DECwindows graphics workstation display.
  448.  
  449. You can toggle off the console display window using [CTRL/F2], 
  450. and you can enable a serial console per ALPHA7 or VAX10.
  451.  
  452. Also see the console message window application available with
  453. recent DECwindows versions -- recent DECwindows versions (V1.2-3
  454. and later) will enable this window by default.  For details on
  455. this console message window, see the DECW$CONSOLE_SELECTION 
  456. option in SYS$STARTUP:DECW$PRIVATE_APPS_SETUP.TEMPLATE.
  457.  
  458. On older releases, you can disable output using the following:
  459.  
  460.   SET TERMINAL/PERMANENT/NOBROADCAST OPA0:
  461.   DEFINE/USER SYS$COMMAND OPA0:
  462.   REPLY/DISABLE
  463.  
  464. Also see VAX9 and MGMT22, as well as DCL4.
  465.  
  466. ------------------------------------------------------------
  467. DECW14. %DECW-W-NODEVICE, No graphics device found on this system?
  468.  
  469. To resolve the following error:
  470.  
  471.  %DECW-W-NODEVICE, No graphics device found on this system
  472.    -DECW-I-NODECW, DECwindows graphics drivers will not be loaded
  473.  
  474.  
  475. 1) Ensure that the SYSGEN parameter WINDOW_SYSTEM is set to 1:
  476.  
  477.     $ MCR SYSGEN SHOW WINDOW_SYSTEM
  478.  
  479.    If it is not set to a value of 1, issue the commands:
  480.  
  481.     $ MCR SYSGEN
  482.     SYSGEN> USE CURRENT
  483.     SYSGEN> SET WINDOW_SYSTEM 1
  484.     SYSGEN> WRITE ACTIVE
  485.     SYSGEN> WRITE CURRENT
  486.     SYSGEN> EXIT
  487.     $ REBOOT
  488.  
  489. 2) Check the SYSMAN IO PREFIX LIST to ensure that the DECW$ prefix is
  490.    included in the existing list.  If it is not, you will need to add it:
  491.  
  492.     $ MCR SYSMAN
  493.     SYSMAN> IO SHOW PREFIX
  494.     SYSMAN> IO SET PREFIX=(DECW$,*)   * = list returned by the show command
  495.     SYSMAN> IO AUTO/LOG
  496.     SYSMAN> EXIT
  497. 3) Ensure that the image SYS$SHARE:DECW$ICBM.EXE is installed in memory.
  498.    If it is not installed, then install it:
  499.  
  500.     $ INSTALL LIST/FULL SYS$SHARE:DECW$ICBM
  501.  
  502.     $ INSTALL REPLACE SYS$SHARE:DECW$ICBM
  503.  
  504.     $ EDIT SYS$MANAGER:SYCONFIG.COM
  505.  
  506.       $! The following line was added to install
  507.       $! support for the Mach64 Graphics Card
  508.       $!
  509.       $ INSTALL REPLACE SYS$SHARE:DECW$ICBM
  510.       $ ^Z
  511.  
  512.     $ SHUTDOWN
  513.    REBOOT the system.
  514.  
  515. If the system still complains that NO GRAPHICS DEVICES COULD BE FOUND
  516. then:
  517.  
  518. 4)   o Boot the system as normal
  519.      o Login as "system"
  520.      o Create the file:
  521.          $ SYS$COMMON:[SYSMGR]DECW$USER_AUTOCONFIG.DAT (W:RE)
  522.      o Add the following string on the very first line:
  523.          CLEAR_PFLAG = ISA_4BYTE
  524.      o Save the file
  525.      o Set the file protections
  526.      o Reboot the system
  527.  
  528.      EXAMPLE:
  529.  
  530.      $ create SYS$COMMON:[SYSMGR]DECW$USER_AUTOCONFIG.DAT
  531.        CLEAR_PFLAG = ISA_4BYTE
  532.        ^Z
  533.  
  534.      $ SET FILE/PROTECTION=(W:RE) SYS$COMMON:[SYSMGR]DECW$USER_AUTOCONFIG.DAT
  535.      $ REBOOT
  536.  
  537. Also see DECW6
  538.                     [Kleinsorge, Hoffman]
  539.  
  540. ------------------------------------------------------------
  541. DECW15. How can I reset the warning bell volume?
  542.  
  543.   With DECwindows CDE drivers and ECOs starting with ECOs for the
  544.   DECwindows keyboard driver SYS$IKBDRIVER.EXE in OpenVMS Alpha V7.1-2 
  545.   and V7.2-1 and with the SYS$IKBDRIVER.EXE included in OpenVMS V7.2-1H1 
  546.   and later, the DECwindows CDE controls will now correctly manage the 
  547.   setting of the warning bell volume. 
  548.  
  549.   Unfortunately, the equivalent controls in the older DECwindows Motif 
  550.   interface are not compatible and can no longer manage the warning 
  551.   bell volume.
  552.  
  553.   If you need to manage the volume with DECwindows Motif, consider 
  554.   using the following approach:
  555.  
  556.     $ @decw$utils:decw$define_utils
  557.     $ xset b 1 100 100
  558.  
  559.   The numerics are the volume, pitch, and duration, respectively.
  560.  
  561.   Why?   When OpenVMS first started supporting the PC-style keyboards, 
  562.   the X Windows Server and the keyboard driver interface did not support 
  563.   the pitch and duration, and neither did DECwindows Motif.  The 
  564.   DECwindows keyboard driver was accordingly changed to use the volume 
  565.   from the keyclick setting (keyclick is not available in a PC-style 
  566.   keyboard) and the bell volume setting to control the pitch and duration.
  567.  
  568.   DECwindows CDE does provide sliders for setting pitch and duration,
  569.   so the keyboard driver and X Windows Server were modified to provide 
  570.   all of the information, and now the DECwindows CDE sliders work.  This 
  571.   change is unfortunately incompatible with the old scheme used on the
  572.   pre-CDE desktops, and the volume controls are now incompatible with 
  573.   the current keyboard drivers.  Hence the use of xset.
  574.  
  575. ------------------------------------------------------------
  576. DECW16. How can I alter the DECwindows CDE backdrop?
  577.  
  578. To select a separate backdrop to be displayed on each screen using 
  579. DECwindows CDE:
  580.  
  581. 1. Click on the Appliction Manager.
  582.    This is the drawer icon on the CDE toolbar.
  583. 2. Click on Desktop Tools
  584. 3. Click on Set Default Screen and select the required screen
  585. 4. Click on the Style Manager.
  586.    This is the one containing the mouse and ttt on the CDE toolbar
  587. 5. Now change the background.
  588.  
  589.                                              [Geoff Kingsmill]
  590.  
  591. ------------------------------------------------------------
  592. DECW17. How can I enable the DECwindows TCP/IP Transport
  593.  
  594.   To configure the TCP/IP transport for DECwindows, first ensure that
  595.   a TCP/IP package is installed and configured.  Then set the DCL symbol
  596.   DECW$SERVER_TRANSPORTS in SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM
  597.   to the appropriate local value, based on the comments in that file.
  598.  
  599.   If you do not have a copy of SYS$STARTUP:DECW$PRIVATE_SERVER_SETUP.COM,
  600.   the use the following COPY command to create this file based on the
  601.   provided template file:
  602.  
  603.     COPY SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.TEMPLATE -
  604.          SYS$COMMON:[SYSMGR]DECW$PRIVATE_SERVER_SETUP.COM
  605.  
  606.  
  607. ------------------------------------------------------------
  608. MISC1 relocated to WIRES1
  609.  
  610. ------------------------------------------------------------
  611. MISC2.    Where can I find information on escape and control sequences?
  612.  
  613. Information on escape and control sequences can be found in the OpenVMS
  614. I/O User's Reference Manual, in the section on the terminal driver.
  615. This section includes details on the general format and content of
  616. these sequences.
  617.  
  618. Specific details on the escape and control sequences supported by a
  619. particular serial device are typically found in the documentation
  620. provided with the specific device.  Information on the sequences 
  621. supported by DECwindows DECterm terminal emulator are included in the 
  622. DECwindows documentation.
  623.  
  624. Examples of common escape and control sequences -- those typically used
  625. by the OpenVMS screen management package -- can be found in the OpenVMS 
  626. system file SYS$SYSTEM:SMGTERMS.TXT.
  627.  
  628. The following refers to the function keys on the VTxxx series terminals,
  629. and compatibles.  In the following, {CSI} is decimal code 155 and can be 
  630. replaced by the sequence "{ESC}[" (without the quotes) particularly for 
  631. seven-bit operations, SS3 is decimal code 143 and can be replaced by 
  632. "{ESC}O" particularly for seven-bit operations.  Older VT1xx series
  633. terminals and any other terminals operating with seven-bit characters 
  634. should not be sent eight-bit operators such as {CSI} and {SS3}.
  635.  
  636. PF1={SS3}P PF2={SS3}Q PF3={SS3}R PF4={SS3}S
  637. KP0={SS3}p KP1={SS3}q KP2={SS3}r KP3={SS3}s KP4={SS3}t KP5={SS3}u
  638. KP6={SS3}v KP7={SS3}w KP8={SS3}x KP9={SS3}y KPCOMMA={SS3}l KPMINUS={SS3}m
  639. KPPERIOD={SS3}n ENTER={SS3}M DNARROW={CSI}B UPARROW={CSI}A LFARROW={CSI}D
  640. RTARROW={CSI}C FIND={CSI}1~ INSERT={CSI}2~ REMOVE={CSI}3~ SELECT={CSI}4~
  641. PREV={CSI}5~ NEXT={CSI}6~ F6={CSI}17~ F7={CSI}18~ F8={CSI}19~ F9={CSI}20~
  642. F10={CSI}21~ F11={CSI}23~ F12={CSI}24~ F13={CSI}25~ F14={CSI}26~
  643. HELP={CSI}28~ DO={CSI}29~ F17={CSI}31~ F18={CSI}32~ F19={CSI}33~ F20={CSI}34~
  644.  
  645. An example of working with escape sequences (in DCL) follows:
  646.  
  647. $ esc5m = "*[5m"
  648. $ esc5m[0,8] = 27
  649. $ esc0m = "*[0m"
  650. $ esc0m[0,8] = 27
  651. $ write sys$output esc5m + "blinking text" + esc0m
  652.  
  653. Documentation on an ANSI terminal relatively similar to the VT525 series
  654. is available at:
  655.  
  656.   ftp://ftp.boundless.com/pub/text/adds/docs/260_prog/
  657.   ftp://ftp.boundless.com/pub/text/adds/docs/260_user/
  658.  
  659. Also see the various documentation and manuals available at:
  660.  
  661.   http://www.vt100.net/
  662.  
  663. Information on the ReGIS graphics character set is available at:
  664.  
  665.   http://www.cs.utk.edu/~shuford/terminal/dec_regis_news.txt
  666.  
  667. Also:
  668.  
  669.   http://www.boundless.com/Text_Terminals/VT/
  670.  
  671. Also see DECW9, DCL12.
  672.  
  673. ------------------------------------------------------------
  674. MISC3 relocated to SUPP4
  675.  
  676. ------------------------------------------------------------
  677. MISC4 relocated to WIRES2
  678.  
  679. ------------------------------------------------------------
  680. MISC5 relocated to ALPHA5
  681.  
  682. ------------------------------------------------------------
  683. MISC6.    What does "failure on back translate address request" mean?
  684.  
  685. The error message:
  686.  
  687.   BCKTRNSFAIL, failure on the back translate address request
  688.  
  689. indicates that the destination node is running DECnet-Plus, and that its 
  690. naming service (DECnet-Plus DECdns, LOCAL node database, etc) cannot 
  691. locate a name to associate with the source node's address.  In other 
  692. words, the destination node cannot determine the node name for the node
  693. that is the source of the incoming connection.
  694.  
  695. Use the DECNET_REGISTER mechanism (on the destination node) to register
  696. or modify the name(s) and the address(es) of the source node.  Check
  697. the namespace on the source node, as well.
  698.  
  699. Typically, the nodes involved are using a LOCAL namespace, and the
  700. node name and address settings are not coherent across all nodes.
  701. Also check to make sure that the node is entered into its own LOCAL
  702. namespace.  This can be a problem elsewhere, however.  Very rarely,
  703. a cache corruption has been known to cause this error.  To flush the
  704. cache, use the command:
  705.  
  706. NCL> flush session control naming cache entry "*"
  707.  
  708. Also check to see that you are using the latest ECO for DECnet-Plus
  709. for the version you are running.
  710.  
  711. DECnet-Plus can use the following namespaces:
  712.   o DECdns: DECnet-Plus distributed name services.
  713.   o LocalFile: a local file containing names and addresses.
  714.   o DNS/Bind: the IP distributed name services.
  715.   o The UCX local host file.
  716.  
  717.                     [Stephen Hoffman]
  718.  
  719. ------------------------------------------------------------
  720. MISC7.    How to determine the network hardware address?
  721.  
  722.   Most Alpha and VAX systems have a console command that displays
  723.   the network hardware address.  Many systems will also have a sticker
  724.   identifying the address, either on the enclosure or on the network
  725.   controller itself.
  726.  
  727.   The system console power-up messages on a number of VAX and Alpha
  728.   systems will display the hardware address, particularly on those
  729.   systems with an integrated Ethernet network adapter present.
  730.  
  731.   If you cannot locate a sticker on the system, if the system powerup
  732.   message is unavailable or does not display the address, and if the
  733.   system is at the console prompt, start with the console command:
  734.  
  735.   >>> HELP
  736.  
  737.   A console command similar to one of the following is typically used
  738.   to display the hardware address:
  739.  
  740.   >>> SHOW DEVICE
  741.   >>> SHOW ETHER
  742.   >>> SHOW CONFIG
  743.  
  744.   On the oldest VAX Q-bus systems, the following console command can
  745.   be used to read the address directly off the (DELQA, DESQA, or the
  746.   not-supported-in-V5.5-and-later DEQNA) Ethernet controller:
  747.  
  748.   >>> E/P/W/N:5 20001920
  749.  
  750.   Look at the low byte of the six words displayed by the above command.
  751.   (The oldest VAX Q-bus systems -- such as the KA630 processor module
  752.   used on the MicroVAX II and VAXstation II series -- lack a console
  753.   HELP command, and these systems typically have the primary network
  754.   controller installed such that the hardware address value is located
  755.   at the system physical address 20001920.)
  756.  
  757.   If the system is a VAX system, and another VAX system on the network
  758.   is configured to answer Maintenance and Operations Protocol (MOP)
  759.   bootstrap requests (via DECnet Phase IV, DECnet-Plus, or LANCP), the
  760.   MOM$SYSTEM:READ_ADDR.EXE tool can be requested:
  761.  
  762.   >>> B/R5:100 ddcu
  763.   Bootfile: READ_ADDR
  764.  
  765.   Where ddcu is the name of the Ethernet controller in the above command.
  766.   The primarly local DELQA, DESQA, and DEQNA Q-bus controllers are usually
  767.   named XQA0.  An attempt to MOP download the READ_ADDR program will ensue,
  768.   and (if the download is successful) READ_ADDR will display the hardware
  769.   address.
  770.  
  771.   If the system is running, you can use DECnet or TCP/IP to display the
  772.   hardware address with one of the following commands.
  773.  
  774.     $ MCR NCP SHOW KNOWN LINE CHARACTERISTICS    ! DECnet Phase IV
  775.  
  776.     $ MCR NCL SHOW CSMA-CD STATION * ALL STATUS  ! DECnet-Plus
  777.  
  778.     $ UCX SHOW INTERFACE/FULL    ! TCP/IP versions prior to V5.0
  779.  
  780.     $ TCPIP SHOW INTERFACE/FULL  ! TCP/IP versions V5.0 and later
  781.  
  782.   A program can be created to display the hardware address, reading the
  783.   necessary information from the network device drivers.  An example C
  784.   program for reading the Ethernet hardware address (via sys$qio calls
  785.   to the network device driver(s)) is available at the following URL:
  786.  
  787.     http://www.openvms.compaq.com/wizard/swdev/ethernVMS.html
  788.  
  789.   To use the DECnet Phase IV configurator tool to watch for MOP SYSID
  790.   activity on the local area network:
  791.  
  792.   $ NCP SET MODULE CONFIGURATOR KNOWN CIRCUIT SURVEILLANCE ENABLED
  793.  
  794.   Let the DECnet configurator run for at least 20 minutes. Then issue
  795.   the following commands:
  796.  
  797.   $ NCP SHOW MODULE CONFIGURATOR KNOWN CIRCUIT STATUS TO filename.txt
  798.   $ NCP SET MODULE CONFIGURATOR KNOWN CIRCUIT SURVEILLANCE DISABLED
  799.  
  800.   The resulting file (named filename.txt) can now be searched for the
  801.   information of interest.  Most DECnet systems will generate MOP SYSID
  802.   messages identifying items such as the controller hardware address and
  803.   the controller type, and these messages are generated and multicast
  804.   roughly every ten minutes.
  805.  
  806.   Information on the DECnet MOP SYSID messages and other parts of the
  807.   maintenance protocols is included in the DECnet network architecture
  808.   specifications referenced in section DOC9.
  809.  
  810. ------------------------------------------------------------
  811. MISC8 combined into SUPP3
  812.  
  813. ------------------------------------------------------------
  814. MISC9.    Why can't I use PPP and RAS to connect to OpenVMS Alpha?
  815.  
  816.   OpenVMS Alpha PPP does not presently support authentication, and the 
  817.   Microsoft Windows NT option to disable authentication during a RAS 
  818.   connection apparently doesn't currently work -- RAS connections will 
  819.   require authentication -- and this will thus prevent RAS connections.
  820.                                                [Stephen Hoffman]
  821.  
  822. ------------------------------------------------------------
  823. MISC10 relocated to SUPP5
  824.  
  825. ------------------------------------------------------------
  826. MISC12.   Does DECprint (DCPS) work with the LRA0 parallel port?
  827.  
  828. The parallel printing port LRA0: found on many OpenVMS Alpha 
  829. systems is capable of some bidirectional communications, with
  830. enough for basic operations with most parallel printers.
  831.  
  832. DECprint (DCPS) requires more than just the simple handshaking 
  833. provided by the LRA0: port, therefore DCPS does not work with 
  834. the LRA0: port.
  835.                                      [Paul Anderson]
  836.  
  837. ------------------------------------------------------------
  838. MISC13.   How do I check for free space on a (BACKUP) tape?
  839.  
  840. You cannot know for certain, though you can certainly estimate
  841. the remaining capacity.
  842.  
  843. Tape media is different than disk media, as disks have a known 
  844. and pre-determined fixed capacity.  Modern disks also appear 
  845. logically perfect, based on bad block revectoring support and 
  846. the extra blocks hidden within the disk structure for these
  847. bad block replacements.
  848.  
  849. The capacity of tape media is not nearly as pre-determined, and 
  850. the capacity can vary across different tape media (slightly
  851. different media lengths or different foil markers or other
  852. variations, for instance) and even on the same media over time
  853. (as bad spots in the media arise).  Tapes can vary the amount of
  854. recording media required, depending on the remaining length of 
  855. the tape, the numbers of correctable and uncorrectable media 
  856. errors that might occur, the numbers and sizes of the inter-record 
  857. gaps and related tape structure overhead, the particular media
  858. error recovery chosen, the tape density, the efficiently of any 
  859. data compression in use, and the storage overhead required by 
  860. BACKUP, tar, and other similar commands.
  861.  
  862. BACKUP using with the default settings results in approximately
  863. 15% overhead, in terms of saveset size.  (eg: Assuming a 500 KB 
  864. input, the total size would be 575 KB.)
  865.  
  866.   Assuming no compression:
  867.    4 GB media / 575 KB saveset =  7294 savesets 
  868.  
  869.   Assuming 1:2 compression:
  870.    8 GB media / 575 KB saveset = 14588 savesets 
  871.  
  872. NB: There are no inter-record gaps on DAT tapes.  (When determining
  873. media capacity, you have to consider these with nine-track magtape
  874. media.  Not with DAT (DDS).  However, the block structure underneath 
  875. the variable length record recording is based on a block size of circa 
  876. 124 KB.  Further, writing doubles filemarks and such can cause a loss 
  877. of up to the underlying block size.  Thus even though there are no 
  878. inter-record gaps on DAT, larger savesets are still usually best.
  879.  
  880. The compression algorithms used on various devices are generally not 
  881. documented -- further, there is no way to calculate the effective data
  882. compression ratio, the tape mark overhead, and similar given just the 
  883. data to be stored on tape -- short of actually trying it, of course. 
  884.  
  885. A typical compression ratio found with "everyday" data is somewhere
  886. around 1:1.8 to 1:2.
  887.  
  888. NB: OpenVMS often uses the term COMPACTION for compression control, 
  889. as in the qualifier /MEDIA_FORMAT=COMPACTION.
  890.                                           [Hoffman, Froehlin, Williams]
  891.  
  892. ------------------------------------------------------------
  893. MISC14.   So what happened to sys$cmsuper?
  894.  
  895. There is no SYS$CMSUPR service.  
  896.  
  897. The typical wisdom for getting into supervisor access mode (from 
  898. user mode) is to execute a routine in executive mode (via a call 
  899. to SYS$CMEXEC and the appropriate privilege) and then issue a 
  900. SYS$DCLAST with the ASTADR parameter pointing to your routine 
  901. entry point and the ACMODE parameter specified as PSL$C_SUPER.
  902.  
  903. Alternatively, you can reset mode in the call stack return path 
  904. and unwind from executive or kernel out into supervisor mode.
  905.                                     [Brian Schenkenberger]
  906.  
  907. ------------------------------------------------------------
  908. MISC15.   How can I send radio pages from my OpenVMS system?
  909.  
  910. There are third-party products available to send messages to radio
  911. paging devices (pagers), communicating via various protocols such
  912. as TAP (Telocator Alphanumeric Protocol).
  913.  
  914. RamPage (Ergonomic Solutions) is one of the available packages that
  915. can generate and transmit messages to radio pagers.  Target Alert
  916. (Target Systems; formerly the DECalert product) is another.  
  917. Networking Dynamics Corp has a product called Pager Plus.  The 
  918. System Watchdog package can also send pages.  The Process Software
  919. package PMDF can route specific email addresses to a paging service, 
  920. as well.
  921.  
  922. Many commercial paging services provide email contact addresses 
  923. for their paging customers -- you can simply send email directly
  924. to the pager.
  925.  
  926. Some people implement the sending of pages to radio pagers by sending
  927. commands to a modem to take the "phone" off the "hook", and then the
  928. paging sequence, followed by a delay, and then the same number that
  929. a human would dial to send a numeric page.  (This is not entirely
  930. reliable, as the modem lacks "call progress detection", and the
  931. program could simply send the dial sequence when not really connected
  932. to the paging company's telephone-based dial-up receiver.)
  933.  
  934. See SOFT1 for information on the available catalog of products.
  935.  
  936. ------------------------------------------------------------
  937. MISC16 relocated to WIRES3
  938.  
  939. ------------------------------------------------------------
  940. MISC17.   How do I reset the LAN (DECnet-Plus NCL) counters?
  941.  
  942. On recent OpenVMS releases:
  943.  
  944.   LANCP> SET DEVICE/DEVICE_SPECIFIC=FUNCTION="CCOU" devname
  945.  
  946.  
  947. ------------------------------------------------------------
  948. MISC18.   What are the prefixes for the powers of ten?
  949.  
  950.         Power   Prefix  Abbreviation
  951.         10^-18  atto    a
  952.         10^-15  femto   f
  953.         10^-12  pico    p
  954.         10^-09  nano    n
  955.         10^-06  micro   â•¡
  956.         10^-03  milli   m
  957.         10^-02  centi   c
  958.         10^-01  deci    d
  959.         10^+01  deca    da
  960.         10^+02  hecto   h
  961.         10^+03  kilo    k
  962.         10^+06  mega    M
  963.         10^+09  giga    G
  964.         10^+12  tera    T
  965.         10^+15  peta    P
  966.         10^+18  exa     E
  967.  
  968.  
  969. ------------------------------------------------------------
  970. MISC19.   OpenVMS Cluster (SCS) over DECnet?  Over IP?
  971.  
  972. The OpenVMS Cluster environment operates over various network
  973. protocols, but the core of clustering uses the System 
  974. Communications Services (SCS) protocols, and SCS-specific 
  975. network datagrams.  Direct (full) connectivity is assumed.
  976.  
  977. An OpenVMS Cluster DOES NOT operate over DECnet, nor over IP.
  978.  
  979. No SCS protocol routers are available.
  980.  
  981. Many folks have suggested operating SCS over DECnet or IP over the
  982. years, but SCS is too far down in the layers, and any such project 
  983. would entail a major or complete rewrite of SCS and of the DECnet 
  984. or IP drivers.  Further, the current DECnet and IP implementations
  985. have large tracts of code that operate at the application level, 
  986. while SCS must operate in the rather more primitive contexts of the 
  987. system and particularly the bootstrap -- to get SCS to operate over 
  988. a DECnet or IP connection would require relocating major portions of 
  989. the DECnet or IP stack into the kernel.  (And it is not clear that
  990. the result would even meet the bandwidth and latency expectations.)
  991.  
  992. The usual approach for multi-site OpenVMS Cluster configurations
  993. involves FDDI, Memory Channel (MC2), or a point-to-point remote bridge,
  994. brouter, or switch.  The connection must be transparent, and it must
  995. operate at 10 megabits per second or better (Ethernet speed), with 
  996. latency characteristics similar to that of Ethernet or better.
  997. Various sites use FDDI, MC2, ATM, or point-to-point T3 link.
  998.  
  999.  
  1000. ------------------------------------------------------------
  1001. MISC20.   Correctly using license PAKs and LMF?
  1002.  
  1003.   If you have multiple LMF$LICENSE.LDB databases in your OpenVMS
  1004.   Cluster, then each and every PAK must be installed in each and
  1005.   every license database present in an OpenVMS Cluster.  Even if
  1006.   you use /EXCLUDE or /INCLUDE, you need to have a consistent set
  1007.   of PAKs registered across all licensing databases present in the 
  1008.   OpenVMS Cluster.
  1009.  
  1010.   If your software license permits it, you can use the following 
  1011.   two commands to transfer license PAKs:
  1012.  
  1013.     $ LICENSE COPY...
  1014.     $ LICENSE ISSUE/PROCEDURE/OUTPUT=file product,...
  1015.  
  1016.   To display the particular license(s) required (such as when you
  1017.   receive a NOLICENSE error), use the following DCL sequence:
  1018.  
  1019.     $ SET PROCESS/PRIVILEGE=ALL
  1020.     $ REPLY/ENABLE
  1021.     $ DEFINE/SYSTEM/EXECUTIVE LMF$DISPLAY_OPCOM_MESSAGE
  1022.  
  1023.   This logical name will cause all license failures to generate OPCOM 
  1024.   messages, and this will hopefully show which license(s) you need -- 
  1025.   there may well also be additional license failures displayed, as 
  1026.   various products can check for and can be enabled by multiple license 
  1027.   PAKs.  You will want to deassign this logical name when done.
  1028.  
  1029.   Some of the more common license PAKs:
  1030.  
  1031.   DECnet Phase IV:   DVNETRTG, DVNETEND, DVNETEXT, or NET-APP-SUP*
  1032.   DECnet-Plus:       DVNETRTG, DVNETEND, DVNETEXT, or NET-APP-SUP*
  1033.   TCP/IP Services:   UCX, or NET-APP-SUP*
  1034.   OpenVMS Alpha:     OPENVMS-ALPHA and OPENVMS-ALPHA-USER
  1035.   OpenVMS VAX:       VAX-VMS
  1036.   OpenVMS Galaxy:    OPENVMS-GALAXY
  1037.   Cluster (Alpha):   VMSCLUSTER, NET-APP-SUP*
  1038.   Cluster (VAX):     VAXCLUSTER, NET-APP-SUP*
  1039.  
  1040.   Various NET-APP-SUP (NAS) license packages are available, each with
  1041.   differing collections of products authorized.  See the various NAS
  1042.   Software Product Description (SPD) documents for specific details.
  1043.  
  1044.     http://www.compaq.com/info/spd/
  1045.  
  1046.   To determine which license PAK is failing (via a license check failure
  1047.   OPCOM message), use the command:
  1048.  
  1049.     $ DEFINE/SYSTEM/EXECUTIVE LMF$DISPLAY_OPCOM_MESSAGE TRUE
  1050.  
  1051.   Realize that defining this logical name will cause license checks
  1052.   that are otherwise hidden (unimplemented, latent, or part of a check
  1053.   for any of a series of licenses) to become visible.  In other words,
  1054.   expect to see some spurious license check calls when you define this.
  1055.  
  1056. ------------------------------------------------------------
  1057. MISC21.   Third-party disk/tape/controllers/SCSI/widgets on OpenVMS?
  1058.  
  1059.   A wide variety of third-party widgets -- SCSI and IDE disks and tapes, 
  1060.   graphics controllers, etc -- are available for various platforms.
  1061.  
  1062.   If you purchase third-party "generic" SCSI or IDE storage devices, 
  1063.   you and your device vendor will be responsible for the testing and 
  1064.   the support of the devices.  I would tend to expect that Compaq will 
  1065.   address non-standards-compliance problems within OpenVMS (changes 
  1066.   that will also not prevent operations with other supported devices, 
  1067.   of course), but you and/or the device vendor and/or the device 
  1068.   manufacturer are responsible for finding and fixing problems in the 
  1069.   particular third-party device and or controller involved.
  1070.  
  1071.   In particular, realize that neither SCSI nor IDE is a particularly
  1072.   standard interface, these interfaces tend to be a collection of 
  1073.   optionally-implemented and standardized interface features.  You 
  1074.   should not and can not simply assume that all SCSI nor IDE storage
  1075.   devices are interchangeable.  If you want to try to use a generic 
  1076.   SCSI device, use V6.2 or later, or (better) V7.1-2 or later.  If
  1077.   you wish to try to use IDE, use OpenVMS V7.1-2 or later. 
  1078.  
  1079.   On older OpenVMS releases, see the disk capacity limits (FILE5).
  1080.  
  1081.   With SCSI disks on releases prior to V6.2, ensure that you have the 
  1082.   ARRE and ARWE settings configured correctly (disabled).  (If not, 
  1083.   you will see DRVERR fatal drive errors and error log entries.)
  1084.  
  1085.   Some SCSI disks set the medium type byte as part of the SCSI size
  1086.   field -- this is a SET CAPACITY extension to SCSI specs.  This 
  1087.   problem also applies to VAX V7.1 and later.
  1088.  
  1089.   Disks with SCSI disk sizes past 8.58 GB and/or with the SET CAPACITY
  1090.   extension require ALPSCSI07 ECO or the OpenVMS Alpha V7.1-2 or 
  1091.   later release.  (See FILE5 for further details.)
  1092.  
  1093.   Based on the displays of the (undocumented) SYS$ETC:SCSI_INFO tool;
  1094.   this tool is present in OpenVMS V6.2 and later:
  1095.  
  1096.     Issuing 6-byte MODE SENSE QIOW to get current values for page 01h
  1097.            Page Code ................. 01h
  1098.            Page Name ................. Read-Write Error Recovery
  1099.            Saveable .................. Yes
  1100.            Size ...................... 10
  1101.            Hex Data .................. E6 08 50 00 00 00 08 00
  1102.                                        00 00
  1103.  
  1104.     The E6 indicates that the AWRE and ARRE bits are set, and this is
  1105.     not acceptable on OpenVMS versions prior to V6.2.  Further along 
  1106.     in the SCSI_INFO display, if you also see:
  1107.  
  1108.     Issuing 6-byte MODE SENSE QIOW to get changeable values for page 81h
  1109.            Page Code ................. 01h
  1110.            Page Name ................. Read-Write Error Recovery
  1111.            Saveable .................. Yes
  1112.            Size ...................... 10
  1113.            Hex Data .................. C0 08 50 00 00 00 08 00
  1114.                                        00 00
  1115.  
  1116.     The C0 value means that the AWRE and ARRE values can be changed
  1117.     on this particular SCSI device.  (This is not always the case.)
  1118.     Use RZDISK from the OpenVMS Freeware, and reset the E6 flag byte 
  1119.     to hexadecimal 26 (or whatever the remaining mask when you remove
  1120.     bits C0) on page one.
  1121.  
  1122.   Each SCSI and IDE host contains non-trivial SCSI and IDE driver 
  1123.   software, and each device contains equally non-trivial firmware -- 
  1124.   taken together with the mechanical and electronic components, this 
  1125.   software and firmware will determine whether or not a particular
  1126.   device will function as expected.
  1127.  
  1128.   Also note that various devices -- such as various SCSI CD-R devices
  1129.   -- can implement and can require vendor-specific protocol extensions, 
  1130.   and these extensions can require modifications to OpenVMS or the 
  1131.   addition of various utilities.  In various of these cases, these
  1132.   devices perform functions that will require them to use SCSI or IDE
  1133.   commands that are (hopefully) architecturally-compatible SCSI or IDE
  1134.   command extensions.  (Also see UTIL1 and FILE7.)
  1135.  
  1136.   In order for OpenVMS to officially support a particular device,
  1137.   integration and testing work is mandated.  There can be no certainty 
  1138.   that any particular device will operate as expected in any particular 
  1139.   configuration without first performing this (non-trivial) work. 
  1140.  
  1141.   It is quite possible to find two devices -- both entirely compliant 
  1142.   with applicable standards or interface documents -- that will not 
  1143.   interoperate.
  1144.  
  1145.   The same general statement holds for OpenVMS bootstrapping on an
  1146.   unsupported VAX or Alpha platform.  It might or might not work.
  1147.   In particular, please see the OpenVMS Software Product Description 
  1148.   (SPD) for the list of platforms supported by OpenVMS.  OpenVMS is 
  1149.   not supported on the Personal Workstation -a series, on the Digital 
  1150.   Server series platforms, on the AlphaServer 2100 series 5/375 CPU, 
  1151.   on the Multia, and on a variety of other platforms.  (You might or
  1152.   might not see success booting OpenVMS on any of these platforms.)
  1153.                     [Stephen Hoffman]
  1154.  
  1155. ------------------------------------------------------------
  1156. MISC22.   How do I convert?  Disk Blocks?  KB, MB, GB, TB?
  1157.  
  1158. The granularity of disk storage allocation is called a disk block.
  1159. Groups of disk blocks are organized together into the smallest unit
  1160. of storage that can be allocated, and this unit is called a disk
  1161. cluster.  The number of blocks in a cluster is the cluster factor,
  1162. and is established when the disk volume is initialized.
  1163.  
  1164. Each individual disk block is composed of five hundred twelve (512)
  1165. bytes, or one-half kilobyte.  Each byte is comprised of eight bits.
  1166. A bit represents the smallest unit of information, typically refered
  1167. to as a one or a zero.
  1168.  
  1169. OpenVMS tends to uses base two notation for disk storage, while disk
  1170. storage capacity specifications from most storage vendors (including
  1171. Compaq) will generally use base ten notation.
  1172.  
  1173. An OpenVMS disk block is 512 bytes in size; this is one-half kilobyte
  1174. in base two notation.
  1175.  
  1176. The following table describes the prefix, the abbreviation, and the
  1177. associated base ten (marketing) and base two (OpenVMS) values.
  1178.  
  1179.             Base Ten                        Base Two
  1180.             -----------------------------   ----------------------
  1181.   Kilobyte  (KB)  10**3              1000   2**10             1024
  1182.   Megabyte  (MB)  10**6           1000000   2**20          1048576
  1183.   Gigabyte  (GB)  10**9        1000000000   2**30       1073741824
  1184.   Terabyte  (TB)  10**12    1000000000000   2**40    1099511627776
  1185.   Petabyte  (PB)  10**15 1000000000000000   2**50 1125899906842624
  1186.  
  1187.  
  1188. The base ten representation of the 2**40 value is 1099511627776, which
  1189. is obviously rather ugly.  When viewed as a base eight or base sixteen
  1190. (octal or hexadecimal, respectively) value, the value is far nicer.
  1191. Specifically, the value is 10000000000 and 40000000 when represented
  1192. in octal and hexadecimal, respectively.
  1193.  
  1194. Notational note: Within the OpenVMS FAQ, a Kilobit is represented by the
  1195. appreviation Kb, while a Kilobyte is represented as KB.
  1196.  
  1197. To convert OpenVMS disk blocks to (base two) kilobytes (KB; 1024 bytes),
  1198. simply divide by two.  To convert blocks to (base two) megabytes, divide
  1199. by 2048.  Blocks to (base two) gigabytes (GB), divide by 2097152.  These
  1200. particular divisions can also be performed using bitshifts: to divide
  1201. a value by two, shift the binary value rightwards by one bit position.
  1202.  
  1203. To convert OpenVMS disk blocks to (base ten) kilobytes, divide by
  1204. approximately 1.953125.
  1205.  
  1206. And for those rummaging around deep in SYSGEN, a microfortnight is
  1207. approximately one second.
  1208.  
  1209. ------------------------------------------------------------
  1210. SOFT1.    Where can I find freeware/shareware/software for OpenVMS?
  1211.  
  1212. Details on many commercial OpenVMS products are available in the 
  1213. catalog located at:
  1214.  
  1215.   http://www.compaq.com/csa/directory/
  1216.  
  1217.   ----
  1218.  
  1219. An OpenVMS Freeware CD-ROM is distributed with OpenVMS, and is also
  1220. available separately (QA-6KZAA-H8).  The contents of the OpenVMS 
  1221. Freeware CD-ROM media are also available online at:
  1222.  
  1223.         http://www.openvms.compaq.com/freeware/
  1224.         ftp://ftp.montagar.com/
  1225.         ftp://mvb.saic.com/freewarev40/
  1226.  
  1227. and at various other sites.  The website also includes various updates
  1228. and new packages that become available after the CD-ROM distributions 
  1229. are created.
  1230.  
  1231. Submissions to the OpenVMS Freeware can be made via:
  1232.  
  1233.         http://www.openvms.compaq.com/openvms/freeware/
  1234.  
  1235. To acquire the OpenVMS Freeware CD-ROM distribution, you can order an
  1236. OpenVMS distribution from Compaq (the Freeware is included)(see the
  1237. OpenVMS SPD for part numbers), or you can specifically order a Freeware 
  1238. distribution from Compaq under part number:
  1239.  
  1240.   QA-6KZAA-H8
  1241.  
  1242. The Freeware CD-ROM set contains a large assortment of freeware, and
  1243. is a good starting point if looking for utilities.  Many of the packages
  1244. listed below are also on the Freeware CD.  Some of the most oft-requested
  1245. OpenVMS tools on the Freeware CD include ZIP and UNZIP and GZIP (please
  1246. see SOFT14), MMK (make), PINE, PERL, TAR, UUENCODE and UUDECODE.  Many 
  1247. other tools are available on the Freeware.
  1248.  
  1249. The UUENCODE and UUDECODE tools and various other tools are also available 
  1250. as part of TCP/IP Services package.  (Use the DCL command procedure
  1251. SYS$STARTUP:TCPIP$DEFINE_COMMANDS.COM available on V5.0 and later to set 
  1252. up the necessary DCL foreign command symbols used for these and for 
  1253. various other tools provided by TCP/IP Services.)
  1254.  
  1255.   ----
  1256.  
  1257. OpenVMS software (formerly at Western Kentucky University (WKU) is
  1258. now available via Madgoat and via Process Software archives:
  1259.  
  1260.   http://www.process.com/openvms/index.html
  1261.   http://www.madgoat.com/
  1262.                                            [Hunter Goatley]
  1263.  
  1264.   ----
  1265.  
  1266. The FILESERV packages are also available via anonymous FTP from:
  1267.  
  1268.   Via anonymous FTP from:
  1269.     ftp://ftp.process.com/vms-freeware/
  1270.     ftp.process.com, under [.WKU.VMS.FILESERV].
  1271.     ftp.vms.stacken.kth.se, under [.MIRRORS.WKU.VMS.FILESERV].
  1272.     ftp.ctrl-c.liu.se, under [.WKU.VMS.FILESERV].
  1273.     ftp.riken.go.jp
  1274.     ftp.vsm.com.au, under kits and kits/decwindows.
  1275.     ftp.vsm.com.au, via the WWW instead of FTP.
  1276.  
  1277. or via e-mail from FILESERV@PROCESS.COM. Send the commands HELP and
  1278.    DIR ALL in the body of a mail message for more information.
  1279.  
  1280.   ----
  1281.  
  1282. Another source of free software is the vmsnet.sources newsgroup (and the
  1283. corresponding vmsnet.sources.d discussion group).  See the monthly posting
  1284. "vmsnet.sources archives" for a list of sites which archive submissions
  1285. to vmsnet.sources.
  1286.  
  1287.   ----
  1288.  
  1289. Arne Vajh°j runs an OpenVMS WWW page, with software and other pointers, at:
  1290.   http://www.levitte.org/~ava/
  1291.  
  1292.   ----
  1293.  
  1294. Kermit is available at:
  1295.   http://www.columbia.edu/kermit/ or
  1296.   ftp://kermit.columbia.edu/
  1297.  
  1298.   ----
  1299.  
  1300. ZMODEM is available at:
  1301.   ftp://ftp.cs.pdx.edu/pub/zmodem
  1302. See the FILES file in that directory for further details.
  1303. Note that this freeware version of ZMODEM will interoperate only with 
  1304. ZMODEM software that is licensed from Omen Technology.
  1305. (Also on Freeware CD)
  1306.                 [Steve Lionel]
  1307.  
  1308.   ----
  1309.  
  1310. A good source of software for DEC boxes (and anything else pretty much)
  1311. is the DECUS library. online catalogs are available as well as some
  1312. software via ftp.decus.org; there's a gopher server 
  1313.   gopher://gopher.decus.org/
  1314. an FTP server:
  1315.   ftp://ftp.decus.org/
  1316. and a WWW server:
  1317.   http://www.decus.org/
  1318.  
  1319. Phone for DECUS orders is 508-841-3502. Lots of good stuff from lots of 
  1320. good folks, and copies on media (tapes, CDs) are cheap.
  1321.                 [Everhart@Arisia.gce.com]
  1322.  
  1323.   ----
  1324.  
  1325.    DECUS SIG Tape collections are available on Mark Berryman's system, 
  1326.      ftp://mvb.saic.com/
  1327.  
  1328.   ----
  1329.  
  1330.    David Jones's DECthreads-based HTTP_SERVER World-Wide Web server 
  1331.    for OpenVMS. 
  1332.      http://kcgl1.eng.ohio-state.edu/www/doc/serverinfo.html
  1333.                         [Hunter Goatly]
  1334.  
  1335.   ----
  1336.  
  1337.    Secure Shell (SSH) Server for OpenVMS:
  1338.      http://kcgl1.eng.ohio-state.edu/~JONESD/ssh/DOC/
  1339.  
  1340.    Secure Shell (SSH) Client for OpenVMS:
  1341.      http://www.free.lp.se/fish/
  1342.  
  1343.    Information on OpenSSL (SSLeay) for OpenVMS:
  1344.      http://www.free.lp.se/openssl/
  1345.                                             [Leo Demers]
  1346.  
  1347.    The SSH terminal client FISH:
  1348.      http://www.free.lp.se/fish/
  1349.  
  1350.    Information on OpenSSL (SSLeay) and OSU Web server interoperation:
  1351.      http://www.ourservers.net/openvms_ports/
  1352.  
  1353.   ----
  1354.  
  1355. DECwindows Motif V1.2-3 includes NCSA Mosaic 2.4 built for UCX.  V1.2-4
  1356. includes Spyglass Enhanced Mosaic, which supports many "Netscape" 
  1357. enhancements.    Netscape Navigator is also available for OpenVMS.
  1358.  
  1359.   ----
  1360.  
  1361. A port of Mosaic 2.7-4 which supports UCX, Multinet and SOCKETSHR/NETLIB 
  1362. is available from:
  1363.   ftp://wvnvms.wvnet.edu/mosaic/
  1364.  
  1365.   ----
  1366.  
  1367. Lynx (a character-cell World-Wide-Web reader) is available from
  1368.   ftp://ftp2.cc.ukans.edu/pub/lynx
  1369.                         [Steve Lionel]
  1370.  
  1371.   ----
  1372.  
  1373. Netscape Navigator and Mozilla web browsers are available at:
  1374.   http://www.openvms.compaq.com/ebusiness/Technology.html  
  1375.   http://www.mozilla.org/
  1376.  
  1377.   ----
  1378.  
  1379. PGP (Phil Zimmerman's "Pretty Good Privacy") is available from various
  1380. distribution sites, including those listed in the PGP FAQ.   Information
  1381. on an OpenVMS download of PGP is available at:
  1382.   http://www.pgpi.com/
  1383.   http://zone.pspt.fi/pgp/platforms/vms/
  1384.   http://www.yrl.co.uk/~phil/pds/pds.html
  1385.  
  1386.   ----
  1387.  
  1388. GNU Privacy Guard (GPG, GnuPG):
  1389.  
  1390. Search the comp.os.vms newsgroup archives for information regarding GnuPG; 
  1391. the source code, binaries for various platforms, and documentation are all
  1392. available at:
  1393.  
  1394.   http://www.gnupg.org/
  1395.  
  1396. The OpenVMS source code and OpenVMS Alpha images can be found at:
  1397.  
  1398.   http://seqaxp.bio.caltech.edu/pub/SOFTWARE/GNUPG1_0_4_VMS.ZIP
  1399.  
  1400. As of this time, the port only runs on OpenVMS Alpha, but an investigation
  1401. of an OpenVMS VAX port is reportedly under consideration. 
  1402.  
  1403.                                      [Aaron Sakovich]
  1404.  
  1405.   ----
  1406.  
  1407. An archive of the CENA DECwindows, X Windows, and VMS software 
  1408. packages can be found at the following sites:
  1409.  
  1410.   http://decwarch.free.fr/
  1411.   ftp://ftp2.cnam.fr/decwindows/
  1412.   ftp://ftp.ctrl-c.liu.se/decwindows/
  1413.   ftp://ftp.vms.stacken.kth.se/mirrors/decwindows/
  1414.   http://www.multimania.com/pmoreau/decw/
  1415.  
  1416. (See also Freeware CD)
  1417.                         [Patrick Moreau]
  1418.  
  1419.   ----
  1420.  
  1421. ImageMagick is an X11 package for display and interactive manipulation of
  1422. images.  The package includes tools for image conversion, annotation,
  1423. compositing, animation, and creating montages.  ImageMagick can read and 
  1424. write many of the more popular image formats (e.g. JPEG, TIFF, PNM, XPM, 
  1425. Photo CD, etc.). 
  1426.   http://www.imagemagick.org/
  1427. (Also on Freeware CD)
  1428.                         [cristy@dupont.com]
  1429.  
  1430.   ----
  1431.  
  1432. XV is available from:
  1433.   ftp://ftp.cis.upenn.edu/pub/xv
  1434.   http://www.sanface.com/
  1435.   ftp://www-pi.physics.uiowa.edu/~dyson/xv-3_10a-vms.zip
  1436.  
  1437.   ----
  1438.  
  1439. Many software packages are available for displaying various bitmap files 
  1440. (.JPG, .GIF, .BMP, etc) on OpenVMS.  Xloadimage, Xli, Xv, ImageMagick are 
  1441. the most common tools used under OpenVMS.  Various web browsers such as
  1442. Mozilla (qv) can also display various file formats on OpenVMS.  You can 
  1443. find some of these tools at the DECwindows Archive:
  1444.  
  1445.   http://www.multimania.com/pmoreau/decw/index.html
  1446.   http://www.multimania.com/pmoreau/decw/images.html
  1447.                                            [Patrick Moreau]
  1448.  
  1449.   ----
  1450.  
  1451. GHOSTSCRIPT (gs) and GHOSTVIEW (gv) are available from:
  1452.   http://www.openvms.compaq.com/freeware/freeware50/
  1453.   Also available on the Freeware V5 CD-ROM.
  1454.  
  1455.   Also see:
  1456.     http://www.cs.wisc.edu/~ghost/gnu/
  1457.  
  1458.   ----
  1459.  
  1460. XPDF, a viewer for PDF (Adobe Acrobat) files, is available from:
  1461.   http://www.openvms.compaq.com/freeware/freeware50/xpdf/
  1462.   http://www.foolabs.com/xpdf/
  1463.   Also available on the Freeware V5 CD-ROM.
  1464.  
  1465.                                             [Ki Suk Hahn, Hoffman]
  1466.  
  1467.   Beware: the XPDF tool included on OpenVMS Freeware V4.0 is dated, 
  1468.   and has been found to have various bugs.  Use the Freeware V5.0 
  1469.   version of the XPDF kit, or later.
  1470.  
  1471. A Java-based PDF viewer is available from Adobe, and is known to operate on 
  1472. recent OpenVMS Alpha releases:
  1473.   http://www.adobe.com/
  1474.  
  1475.   ----
  1476.  
  1477. Various OpenVMS-related tools -- both freeware and shareware -- such as 
  1478. txt2pdf -- are available from at:
  1479.   http://www.sanface.com/
  1480.  
  1481.   ----
  1482.  
  1483. The MPEG library version 1.1 is available for OpenVMS VAX and Alpha at
  1484.   ftp://ftp.x.org/contrib/vms/mpeglib-11-vms.readme
  1485.   ftp://ftp.x.org/contrib/vms/mpeglib-11-vms.zip
  1486.                         [Patrick Moreau]
  1487.  
  1488.   ----
  1489.  
  1490. List of FTP Mirror Sites for the DECWINDOWS archive:
  1491.  
  1492. AXP.PSL.KU.DK             (Multinet)  Mirror of CENA DECW archive
  1493. FTP2.CNAM.FR              (MadGoat)   Mirror of CENA DECW archive
  1494.  
  1495. ftp.x.org (in /contrib/vms)  not really a mirror, but I try to put all my
  1496. new ports at this site.
  1497.  
  1498.   ----
  1499.  
  1500. List of HTTP Mirror Sites for the DECWINDOWS archive:
  1501.  
  1502.   http://axp616.gsi.de:8080/wwwar/cena/decwindows/cena.html
  1503.  
  1504. Some X clients from the OpenVMS Freeware CDROM are located in
  1505. [.DECWINDOWS.CDFREEWARE] directory.
  1506.                         [Patrick Moreau]
  1507.  
  1508.   ----
  1509.  
  1510. I have written and installed on INFO.CS.PUB.RO an 'Archie' clone for VMS
  1511. software. Telnet to that machine, and login as VMSARCI.
  1512. It contains now listings for over 30 ftp servers with >14 GB of VMS software.
  1513. The most useful commands are LIST, which generates a list of scanned ftp
  1514. servers, and FIND <string>, whichs looks for a file containing "string"
  1515. in the name; the search modes are only "substring" [default] and "exact",
  1516. and regex search is not supported (so FIND EMACS will work, but FIND *EMACS*
  1517. or FIND *EMACS*.* will not). The search is case-insensitive.
  1518. Those of you that know other ftp servers with VMS software that I haven't
  1519. found, please let me know. (The program that build the databases can
  1520. recursively scan whole servers or just specific directories).
  1521.  
  1522. Sorry, this service is VERY SLOW [by Western standards], because it runs
  1523. on a quite-busy oldie-but-goodie VAXStation 3400 with 20Mb and a RF71, and
  1524. the Internet link is only 256 Kpbs (sometimes unavailable).
  1525.                         [stfp@roipb.cs.ipb.ro]
  1526.  
  1527.   ----
  1528.  
  1529.   The Levitte (extended :-) Family (and OpenVMS) website:
  1530.     http://www.levitte.org/
  1531.     http://www.levitte.org/~ava/
  1532.  
  1533.   ---
  1534.  
  1535.   Robert's OpenVMS Hobbyist Systems, including OpenVMS public domain 
  1536.   software and various ports:
  1537.  
  1538.     http://www.ourservers.net/
  1539.  
  1540.                                           [Robert Alan Byer]
  1541.   ----
  1542.  
  1543.   CalTech Software Archives:
  1544.     http://seqaxp.bio.caltech.edu/pub/SOFTWARE/AAA_CONTENTS.TXT
  1545.  
  1546.   ----
  1547.  
  1548.   DJE Systems Website (David J. Dachtera) 
  1549.     http://www.djesys.com/freeware/vms/
  1550.  
  1551.   ----
  1552.  
  1553.   Web Servers:
  1554.     Apache Web server (Compaq Secure Web Server (CSWS)):
  1555.       http://www.openvms.compaq.com/ebusiness/Technology.html
  1556.       http://www.er6.eng.ohio-state.edu/~jonesd/apache/1_3_9/
  1557.     OSU Web server
  1558.       http://www.er6.eng.ohio-state.edu/www/doc/serverinfo.html
  1559.       http://www.kjsl.com/archives/
  1560.       email list: VMS-WEB-daemon-Request@KJSL.COM
  1561.     WASD Web server
  1562.       http://wasd.vsm.com.au/wasd/
  1563.     Purveyor Web server:
  1564.       email list: listserv@cjis.ci.lincoln.ne.us 
  1565.          no subject, one line message: SUBSCRIBE PURVEYOR
  1566.  
  1567.   ----
  1568.  
  1569.   CD-R (CD-Recordable) media tools:
  1570.     please see FILE7
  1571.  
  1572.   ----
  1573.  
  1574.   Grace (WYSIWYG 2D plotting tool)
  1575.     http://plasma-gate.weizmann.ac.il/Grace/
  1576.  
  1577.   ----
  1578.  
  1579.   The POV-Ray ("Persistance of Vision" Raytracer) ray-tracing graphics 
  1580.   package is available on the OpenVMS Freeware.
  1581.  
  1582.   ----
  1583.  
  1584.   Majordomo mailing list handler:
  1585.     http://www.openvms.compaq.com/ebusiness/Technology.html
  1586.  
  1587.   ----
  1588.  
  1589.   PINE (OpenVMS tools for sending and receiving MIME mail):
  1590.     ftp://ftp2.kcl.ac.uk/pub/vms/pine-vms/
  1591.     http://www.agh.cc.kcl.ac.uk/files/vms/pine-vms/
  1592.  
  1593.   A MIME tool is available in OpenVMS V7.2 and later.
  1594.  
  1595.   Also see the mmencode base64 encode and decode available at:
  1596.     http://nucwww.chem.sunysb.edu/htbin/software_list.cgi
  1597.   
  1598.  
  1599.   ----
  1600.  
  1601. Menufinder (menu-driven system management environment):
  1602.    http://www.itre.com/mf/download.html
  1603.  
  1604.   ----
  1605.  
  1606. tcgmsg, pvm, mpi, linda:
  1607.   ftp://v36.chemie.uni-konstanz.de/tcgmsg_vms/tcgmsg_vms.zip
  1608.  
  1609.   ----
  1610.  
  1611. OpenVMS software that can control a Tripp-Lite Uninterruptable Power 
  1612. Supply (UPS) is available from:
  1613.  
  1614.     http://seqaxp.bio.caltech.edu/pub/SOFTWARE/TCONTROL.ZIP
  1615.                                             [David Mathog]
  1616.  
  1617. UPShot web-based software for controlling a UPS is available from:
  1618.     http://www.tmesis.com/apc/beta.htmlx
  1619.                                             [Brian Schenkenberger]
  1620.  
  1621.  
  1622.   ----
  1623.  
  1624. Examples of using the OpenVMS Foreign MAIL interface are available at:
  1625.   http://www.hhs.dk/anonymous/pub/vms/collection/foreignmail.zip
  1626.   http://www.hhs.dk/anonymous/pub/vms/nbl/nbl.zip
  1627.  
  1628.                                             [Arne Vajhoej]
  1629.  
  1630. For tools to manage or to search your OpenVMS MAIL file, see:
  1631.   http://vms.process.com/scripts/fileserv/fileserv.com?MLSEARCH
  1632.                                             [Phillip Helbig,
  1633.                                             Hunter Goatley]
  1634.  
  1635.   ----
  1636. AscToHTM attempts to convert any plain text file to HTML, while
  1637. AscToTab restricts itself to files that are plain text tables.
  1638. (Versions are also availabe on the OpenVMS Freeware).
  1639.     http://www.jafsoft.com/asctohtm/index.html
  1640.     http://www.jafsoft.com/asctotab/index.html
  1641.                                             [Jaf]
  1642.  
  1643.   ----
  1644.  
  1645. Information on the SAMBA package (PC disk and print services)
  1646. is available at:
  1647.   http://ifn03.ifn.ing.tu-bs.de/ifn/sonst/samba-vms.html
  1648.   http://www.samba.org/
  1649.  
  1650. To subscribe to the SAMBA-VMS mailing list e-mail listproc@samba.org 
  1651. with no subject line and the following single line of text:
  1652.  
  1653.  subscribe samba-vms Your Full Name
  1654.  
  1655. Also see:
  1656.   http://lists.samba.org/
  1657.  
  1658.   ----
  1659.  
  1660. Perl: See SOFT12
  1661.  
  1662.   ----
  1663.  
  1664. XML:
  1665.  
  1666.   Source code of an XML Parser is available from Oracle.
  1667.  
  1668.   Also see:
  1669.  
  1670.     http://www.python.org/sigs/xml-sig/
  1671.  
  1672.  
  1673.   An XML parser is available as part of OpenVMS V7.3 and later.
  1674.  
  1675.   ----
  1676.  
  1677. GTK+ (The GIMP GUI Tookit) for OpenVMS:
  1678.   http://www.openvms.compaq.com/ebusiness/Technology.html
  1679.  
  1680.   ----
  1681.  
  1682. OpenVMS Porting Library now available - for easier porting of C/C++ 
  1683. applications from UNIX to OpenVMS:
  1684.   http://www.openvms.compaq.com/ebusiness/Technology.html
  1685.  
  1686.   ----
  1687.  
  1688. Mlucas (specialized FFT):
  1689.  
  1690.   ftp://hogranch.com/pub/mayer/README.html
  1691.                                [Robert Deininger]
  1692.  
  1693.   ----
  1694.  
  1695. Tools to monitor the terminals and the activity of other OpenVMS users 
  1696. (in addition to existing auditing capabilities in OpenVMS) are available.
  1697. Peek and Spy (Networking Dynamics) and Contrl (Raxco) are two of the
  1698. commercial packages, while the freeware Supervisor package is available 
  1699. on OpenVMS VAX.
  1700.  
  1701.   http://www.networkingdynamics.com/
  1702.   http://www.raxco.com/
  1703.  
  1704.   ----
  1705.  
  1706. Python for OpenVMS:
  1707.  
  1708.   http://www.python.org/
  1709.   http://decus.decus.de/~zessin/python/
  1710.  
  1711. Various packages:
  1712.   http://richj.home.mindspring.com/richware/index.html
  1713.   http://www3.sympatico.ca/n.rieck/links/cool_vax_vms.html
  1714.  
  1715.   ----
  1716.  
  1717. TSM (Terminal Server Manager) is available via:
  1718.  
  1719.   http://www.compaq.com/support/digital_networks_archive/servers/tsm/index.html
  1720.   http://www.openvms.compaq.com/freeware/freeware50/
  1721.   (Beware: The TSM saveset on the Freeware V5.0 disk media is busted.)
  1722.  
  1723.   ----
  1724.  
  1725. Information on the Kermit tool ("file transfer, terminal emulation, script 
  1726. programming, and character-set conversion") is available via:
  1727.  
  1728.   http://www.columbia.edu/kermit/
  1729.  
  1730.   ----
  1731.  
  1732. TCL for OpenVMS:
  1733.  
  1734.   ftp://sapodilla.rsmas.miami.edu/pub/VMS-tcl/tcl8.0p2-tk8.0p2/
  1735.  
  1736.   ----
  1737.  
  1738. make, gmake, mmk and other build tools are available on the Freeware.
  1739.  
  1740.   ----
  1741.  
  1742. An OpenVMS port of the ht://Dig web search engine is available at:
  1743.  
  1744.   ftp://ftp.pdv-systeme.de/vms/
  1745.  
  1746. ------------------------------------------------------------
  1747. SOFT2.    Where can I find the UNIX <whatever> tool for OpenVMS?
  1748.  
  1749. POSIX:
  1750.   POSIX-compliant, Compaq-supported versions of POSIX routines and
  1751.   utilities:
  1752.  
  1753.     lex, yacc, grep, tar, uuencode, uudecode, rcs, man, cpio, make,
  1754.     awk, ar, mail, etc., the POSIX shell, the POSIX C programming
  1755.     interface, etc.
  1756.  
  1757.     POSIX utilities can be used from within the POSIX shell, and
  1758.     via the DCL `POSIX/RUN POSIX$BIN:tool.' command.
  1759.  
  1760.     POSIX is a separately-installed package, and is licensed with
  1761.     OpenVMS V5.5 later.  The POSIX installation kit is included
  1762.     on the consolidated distribution CD-ROM kit, and installation
  1763.     kits are also available separately.
  1764.  
  1765.     The POSIX package is no longer supported on OpenVMS, components 
  1766.     of the POSIX standard such as parts of the POSIX API are being 
  1767.     added into OpenVMS.  Versions of POSIX generally do not operate
  1768.     on V7.x OpenVMS VAX and OpenVMS Alpha releases.
  1769.  
  1770. C: 
  1771.   Common C system and library routines are present in the DEC C run-time
  1772.   library, which is available for V5.5 and later, and is shipped in V6.1
  1773.   and later.  DEC C is the upgrade for VAX C, DEC C and VAX C can coexist
  1774.   on the same system OpenVMS VAX system, and both compilers can be enabled
  1775.   via the "C" license PAK.
  1776.  
  1777.     Also see SYS$EXAMPLES:, and (if either is installed) the DECW$EXAMPLES:
  1778.     and UCX$EXAMPLES: areas.
  1779.  
  1780. X Windows:
  1781.   Various Compaq X Windows utilities:
  1782.  
  1783.     xwd, xev, mosaic WWW browser, xrdb, bmtoa and atobm, xpr, ico, etc.
  1784.  
  1785.     In DECW$UTILS: in DECwindows Motif V1.2-3 and later.  Also see
  1786.     DECW$EXAMPLES: for example X and C programs.
  1787.  
  1788. Miscellaneous tools and examples:
  1789.   Various unsupported OpenVMS tools and code examples:
  1790.  
  1791.     DWAUTH (X Windows SYSUAF authorize-like tool), various versions    
  1792.     of grep, fgrep, yacc, vmstar, uuencode, gawk, etc.  html tools,
  1793.     the mx SMTP mail exchange package, X windows flight simulator,
  1794.     the mxrn X windows news reader, the OSU HTTPD WWW server, a WWW
  1795.     gopher browser, etc. are all on the FreeWare V2.0 CD-ROM.
  1796.  
  1797. IP tools:
  1798.   DEC TCP/IP (UCX) contains tools such as ping, uuencode, smtp, snmp,
  1799.   rcp, nfs, tnfs, etc.  OpenVMS V6.2 and UCX V3.3 and later can be used
  1800.   together in support of the /FTP, /RCP, /RLOGIN, /TELNET, and /TN3270
  1801.   qualifiers on various DCL commands.
  1802.  
  1803.     Also see the various C examples in UCX$EXAMPLES:
  1804.  
  1805.                     [Stephen Hoffman]
  1806.  
  1807. vi clones
  1808.  
  1809.   vile, vim and elvis (vi clones) run on OpenVMS.
  1810.  
  1811.   The current version of vile is 7.1
  1812.   It's available at
  1813.     http://www.clark.net/pub/dickey/vile/vile.html
  1814.     Versions of VILE are also on the OpenVMS Freeware
  1815.  
  1816.  
  1817.   vim: vi improved
  1818.     http://www.polarfox.com/vim/
  1819.                                         [Zoltan Arpadffy]
  1820.  
  1821. GNU tools:
  1822.  
  1823.   Information on the GNU on VMS (GNV) Project, which aims to port 
  1824.   GNU software (BASH, etc) to OpenVMS, is available at:
  1825.  
  1826.     http://gnv.sourceforge.net/
  1827.  
  1828.   Software info:
  1829.  
  1830.     http://vms.gnu.ai.mit.edu/software/
  1831.  
  1832.   Software archive:
  1833.  
  1834.     ftp://vms.gnu.ai.mit.edu/gnu-vms/software/
  1835.  
  1836.  
  1837. GCC:
  1838.  
  1839.   A mirror for work performed at the Progis company in Germany in porting
  1840.   GCC (GNU C) to OpenVMS Alpha and OpenVMS VAX is available at:
  1841.  
  1842.     ftp://vms.gnu.org/progis_mirror/gcc
  1843.     http://www.levitte.org/~ava/vms_gnu.htmlx
  1844.  
  1845.   The latest (known to me) GCC version for VAX/VMS (binaries only) is 2.7.1
  1846.   from Pat Rankin's site. 
  1847.  
  1848.     ftp://ftp.caltech.edu/pub/rankin/ 
  1849.  
  1850.                                     [Jason Armistead, Richard Levitte, 
  1851.                                     Arne Vajhoej, John E. Malmberg]
  1852.  
  1853. There are also updated header files for GCC on OpenVMS VAX that allow it 
  1854. to work with TCP/IP Sockets and the Compaq C C RTL at:
  1855.  
  1856.   ftp://ftp.qsl.net/pub/wb8tyw/gcc281_u/
  1857.  
  1858.                                         [John E. Malmberg]
  1859.  
  1860.  
  1861. Some of the available console management options for OpenVMS:
  1862.  
  1863.   http://www.robomon.com/  (Heroix)
  1864.   http://www.ki.com/products/clim/  (KI Products)
  1865.   http://www.globalmt.com/ (Global Maintech)
  1866.   http://www.tditx.com/ (TECsys)
  1867.   http://www.cai.com/products/commandit.htm (CA)
  1868.                                        [Kerry Main]
  1869.  
  1870. If you need to change the file modification date and are looking 
  1871. for a utility such as the UNIX touch tool, look at DFU on the 
  1872. OpenVMS Freeware (DFU SET or simular), or use an existing DCL 
  1873. commands such as:
  1874.  
  1875.   SET FILE/PROTECT=(current_protection_mask) [...]*.*
  1876.  
  1877.  
  1878. A table listing translations between UNIX shell and OpenVMS DCL 
  1879. commands was posted to comp.os.vms by Christopher Smith:
  1880.  
  1881.   http://deja.com/getdoc.xp?
  1882.     AN=581596523.1&CONTEXT=953337549.952369155
  1883.  
  1884.   --
  1885.  
  1886. The UNIX touch tool is available via various means:
  1887.  
  1888.   $ RENAME filename.ext;version *
  1889.   http://nucwww.chem.sunysb.edu/helplib/@hvmsapps/TOUCH
  1890.   MadGoat FILE tool (see the MadGoat archives)
  1891.     use /REVISION_DATE or /CREATION_DATE
  1892.   The DFU tool (see the OpenVMS Freeware)
  1893.   The pair:
  1894.     $ set file 'p1' /acl=(ident=[system],access=none)
  1895.     $ set file 'p1' /acl=(ident=[system],access=none) /delete
  1896.   SET FILE/VERSION=0
  1897.   The following hack:
  1898.     $!   Command procedure SETDATE.COM
  1899.     $!
  1900.     $!   Changes the DATES for an input file to a
  1901.     $!   file named OUTFILE.
  1902.     $!
  1903.     $assign/nolog 'p1' outfile
  1904.     $convert/fdl=sys$input 'p1' outfile:
  1905.     date
  1906.     creation   01-apr-2010
  1907.     expiration 01-Apr-2012
  1908.     revision   01-Apr-2011
  1909.     backup
  1910.     ...
  1911.   The following RMS system service sequence:
  1912.     $open (with xabrdt)
  1913.     set the desired values in the xabrdt
  1914.     $close
  1915.  
  1916. ------------------------------------------------------------
  1917. SOFT3.    Where can I get the Netscape Navigator Mozilla.org Web Browser?
  1918.  
  1919. Mozilla.org is the open source organization providing Netscape and 
  1920. other interested parties with a browser.  Netscape is expected to 
  1921. commercialize this mozilla.org browser, add additional proprietary 
  1922. features, and release it as Netscape Communicator (version number TBD).
  1923. This Netscape Communicator will contain the features that the Internet 
  1924. community expected to see in Netscape Communicator V5.
  1925.  
  1926. OpenVMS Engineering is currently porting Mozilla.org's web browser
  1927. to OpenVMS -- OpenVMS baselevels of the browser are currently available 
  1928. for download.  
  1929.  
  1930. The Mozilla.org web browser schedule is available at:
  1931.  
  1932.   http://www.mozilla.org/
  1933.  
  1934. The latest information and current downloads are available at:
  1935.  
  1936.   http://www.openvms.compaq.com/ebusiness/Technology.html
  1937.  
  1938. See section SOFT9 for information on various certificates for V3.003 
  1939. Netscape Navigator; certificates that have presently expired.
  1940.                     [Sue Denham]
  1941.                     [Stephen Hoffman]
  1942.  
  1943. ------------------------------------------------------------
  1944. SOFT4.    Where can I get Java for OpenVMS?
  1945.  
  1946.   Java is available on and is included with OpenVMS Alpha, starting 
  1947.   with the OpenVMS Alpha V7.2 and later releases.  Java download kits 
  1948.   are available for OpenVMS Alpha V7.1 and later releases.
  1949.  
  1950.   Java is not available on OpenVMS VAX.  As for why: the Java language 
  1951.   definition requires a floating point format (IEEE) that is not native 
  1952.   to VAX, and this would require the emulation of all floating point 
  1953.   operations within Java applications.  Further, the C source code used 
  1954.   to implement for Java itself is heavily dependent on passing IEEE 
  1955.   floating point values around among the many internal subroutines, and 
  1956.   adding support for VAX would entail changes to the Compaq C compiler 
  1957.   for OpenVMS VAX -- and specifically to the VAX VCG code generator that 
  1958.   is used by Compaq C on OpenVMS VAX systems -- in order to add support 
  1959.   for passing IEEE-format floating point doubles around.  Alternatively, 
  1960.   extensive changes to the Java source code to remove the assumption that 
  1961.   the double is an IEEE floating point value.
  1962.  
  1963.   There are currently no plans to make a version of Java available for
  1964.   OpenVMS VAX.  (A prototype version of Java was created for OpenVMS VAX,
  1965.   and performance was found to be inadequate at best.)
  1966.  
  1967.   If Java2 or other environment lifts the requirements for IEEE floating
  1968.   point as part of the language definition, this decision may be revisited.
  1969.  
  1970.   If you are having problems with Display Postscript, you need to upgrade
  1971.   your Java kit -- 1.2.2-3 and later remove the requirement for Display
  1972.   Postcript extensions, and Java 1.2.2-3 is required with DECwindows 
  1973.   V1.2-6 and later.
  1974.  
  1975.   For additional information on Java for Alpha systems, please see the
  1976.   OpenVMS documentation (V7.2 and later), and the following site:
  1977.  
  1978.     http://www.compaq.com/java/alpha/index.html
  1979.  
  1980.   Compaq Secure Web Server (CSWS) includes CSWS_JAVA, which provides the
  1981.   following Apache Tomcat technologies: JavaServer Pages 1.1, Java Servlet 
  1982.   2.2, and MOD_JK.  (CSWS is based on the Apache web server.  See SOFT1.)
  1983.  
  1984.  
  1985. ------------------------------------------------------------
  1986. SOFT5.    VAX C and DEC C, and other OpenVMS C Programming Considerations?
  1987.  
  1988.   VAX C V3.2 was released for OpenVMS VAX systems in 1991.  DEC C V4.0
  1989.   replaced VAX C V3.2 in 1993 as the Compaq C compiler for OpenVMS VAX
  1990.   systems.  Compaq C is the ANSI C compiler for OpenVMS Alpha systems.
  1991.   VAX C predates the ANSI C standards, and has various areas that are
  1992.   not compliant with ANSI C requirements.  Compaq C is an ANSI C compiler,
  1993.   and can also compile most VAX C code when /STANDARD=VAXC is specified.
  1994.   Versions of this compiler between V3.2 and V6.0 (exclusive) were known 
  1995.   as either DEC C or DIGITAL C.
  1996.  
  1997.   Both compilers can be installed at the same time on the same OpenVMS
  1998.   VAX system, allowing a migration from VAX C to DEC C, and allowing
  1999.   the same DEC C code to be used on OpenVMS VAX and OpenVMS Alpha.  In
  2000.   1999, the C compiler version is Compaq C V6.0.
  2001.  
  2002.   The system manager can choose the system default C compiler when
  2003.   Compaq C is installed on a system with VAX C, and a C programmer can
  2004.   explicitly select the required compiler for a any particular compilation.
  2005.  
  2006.   A current "C" license PAK allows access to both VAX C and Compaq C on the
  2007.   same OpenVMS VAX system.
  2008.  
  2009.   Various Compaq C versions can be installed on OpenVMS VAX V5.5-2 and later.
  2010.   OpenVMS VAX releases such as V5.5-2 and V6.0 will require the installation
  2011.   of a Compaq C RTL kit, a kit that is included with the Compaq C compiler.
  2012.   OpenVMS VAX versions V6.1 and later do not require a seperate RTL kit, 
  2013.   but Compaq C RTL ECO kits are available to resolve problems found with 
  2014.   the C RTL on various OpenVMS releases.
  2015.  
  2016.   Wwith Compaq C, for automatic resolution of the standard C library 
  2017.   routines by the LINKER utility, use the /PREFIX qualifier, such as
  2018.   /PREFIX=ALL_ENTRIES.  If a particular application program replaces an
  2019.   existing C library routine, use /PREFIX=(ALL_ENTRIES,EXCEPT=(...)).
  2020.   (VAX C required explicit specification of an RTL shareable image or
  2021.   C object library during the link.)
  2022.  
  2023.   When the /PREFIX is requested, the compiler generates a "decc$" prefix
  2024.   on the specified symbols.  This prefix allows the LINKER to resolve the
  2025.   external symbols against the symbols present in the DECC$SHR library.
  2026.   The DECC$SHR library is included in the IMAGELIB.OLB shareable image
  2027.   library, and IMAGELIB is searched by default when any program (written
  2028.   in any language) is LINKed.  Because the standard C library routine
  2029.   names are very likely to match application routines written in other
  2030.   languages, a prefix "decc$" is added to the C symbol names to assure
  2031.   their uniqueness; to prevent symbol naming conflicts.  C programs,
  2032.   however, can sometimes have private libraries for various purposes,
  2033.   and the external routines share the same names as the library routines.
  2034.   (This is not recommended, but there are applications around that use
  2035.   this technique.)  Thus the need to explicity specify whether or not
  2036.   the "decc$" prefix should be prepended to the external symbol names
  2037.   by the compiler.
  2038.  
  2039.   The qualifiers, and most (all?) with associated pragmas, that may be
  2040.   of interest when migrating VAX C code to Compaq C include:
  2041.  
  2042.     /PREFIX=ALL_ENTRIES
  2043.       As mentioned above.  Failure to specificy this qualifier can
  2044.       cause the compiler to not add the prefixes for the names of
  2045.       the C library routines into the references placed in the object
  2046.       module, which can in turn cause problems resolving the external
  2047.       symbols in the library when the object code is linked.
  2048.  
  2049.     /ASSUME=WRITABLE_STRING_LITERALS
  2050.       Some VAX C programs erroneously write to the string literals.
  2051.       By default, Compaq C does not allow the constants to change.
  2052.  
  2053.     /SHARE_GLOBALS
  2054.       Enables sharing ("shr") of globals and of extern variables.
  2055.       Compaq C sets externs as non-shareable ("noshr"), VAX C as "shr".
  2056.  
  2057.     /EXTERN_MODE=COMMON_BLOCK
  2058.       VAX C assumes common block model for external linkages.
  2059.  
  2060.     /[NO]MEMBER_ALIGNMENT
  2061.       Refers to the padding placed between member elements within
  2062.       a struct.  Disabling member alignment packs the data more
  2063.       tightly into memory, but this packaging has performance
  2064.       implications, both on OpenVMS VAX and particularly on
  2065.       OpenVMS Alpha systems.
  2066.  
  2067.   Permit structure members to be naturally aligned whenever possible,
  2068.   and avoid using /NOMEMBER_ALIGNMENT.  If you need to disable member
  2069.   alignment, use the equivilent #pragma to designate the specific
  2070.   structures.  The alignment of structure members normally only comes
  2071.   into play with specific unaligned data structures -- such as the
  2072.   sys$creprc quota itemlist -- and with data structures that are using
  2073.   data that was organized by a system using byte or other non-member
  2074.   alignment.
  2075.  
  2076.   Versions of Compaq C such as V6.0 include the capability to extract the
  2077.   contents of the standard header libraries into directories such as
  2078.   SYS$SYSROOT:[DECC$LIB...], and provide various logical names that can
  2079.   be defined to control library searches.  With Compaq C versions such 
  2080.   as V6.0, the default operations of the compiler match the expectations
  2081.   of most OpenVMS programmers, without requiring any definitions of
  2082.   site-specific library-related logical names.  (And logical names left
  2083.   from older DEC C versions can sometimes cause the compiler troubles
  2084.   locating header files.)
  2085.  
  2086.   Compaq C V5.6 and later include a backport library, a mechanism by
  2087.   which Compaq C running on older OpenVMS releases can gain access to 
  2088.   newer RTL routines added to the RTL in later OpenVMS releases -- the 
  2089.   language RTLs ship with OpenVMS itself, and not with the compilers.
  2090.  
  2091.   Example C code is available in SYS$EXAMPLES:, in DECW$EXAMPLES (when
  2092.   the DECwindows examples are installed), in UCX$EXAMPLES (when Compaq
  2093.   TCP/IP Services is installed), on the Freeware CD-ROMs, and at web 
  2094.   sites such as
  2095.  
  2096.     http://www.openvms.compaq.com/wizard/
  2097.  
  2098.   Other common C issues:
  2099.  
  2100.     The localtime() function and various other functions maintain the 
  2101.     number of years since 1900 in the "struct tm" structure member 
  2102.     tm_year.  This field will contain a value of 100 in the year 2000, 
  2103.     101 for 2001, etc., and the yearly incrementation of this field is
  2104.     expected to continue.
  2105.  
  2106.     The C epoch typically uses a longword (known as time_t) to contain 
  2107.     the number of seconds since midnight on 1-Jan-1970.  At the current 
  2108.     rate of consumption of seconds, this longword is expected to overflow 
  2109.     (when interpreted as a signed longword) circa 03:14:07 on 19-Jan-2038 
  2110.     (GMT), as this time is circa 0x7FFFFFFF seconds since the C base date.
  2111.     (The most common solution is to ensure that time_t is an unsigned.)
  2112.  
  2113.     If C does not correctly handle the display of the local system time,
  2114.     then check the UTC configuration on OpenVMS -- the most common symptom
  2115.     of this is a skew of one hour (or whatever the local daylight savings
  2116.     time change might be).  This skew can be caused by incorrect handling 
  2117.     of the "is_dst" setting in the application program, or by an incorrect
  2118.     OpenVMS UTC configuration on the local system.  (See section TIME4.)
  2119.  
  2120.     When sharing variables with other languages, here is some example 
  2121.     Compaq C code...
  2122.  
  2123.       ...
  2124.       #pragma extern_model save
  2125.       #pragma extern_model strict_refdef
  2126.       extern int   VMS$GL_FLAVOR;
  2127.       #pragma extern_model restore
  2128.       ...
  2129.  
  2130.     and here is some associated example Bliss code...
  2131.  
  2132.       ...
  2133.       EXTERNAL
  2134.          VMS$GL_FLAVOR,
  2135.       ....
  2136.  
  2137.  
  2138.   Other common C++ issues:
  2139.  
  2140.     Compaq C++ (a separate compiler from Compaq C) provides both symbol
  2141.     mangling and symbol decoration.  Some of the details of working with
  2142.     longer symbol names and the resulting symbol name mangling in mixed
  2143.     language environments are listed in the shareable image cookbook,
  2144.     and in the C++ documentation.  Symbol name decoration permits the
  2145.     overloading of functions (by adding characters to the external symbol 
  2146.     for the function to indicate the function return type and the argument
  2147.     data types involved), and mixed-language external references can and 
  2148.     often do need to disable this decoration via the extern "C" declaration 
  2149.     mechanism:
  2150.  
  2151.       extern "C"
  2152.         {
  2153.         extern int ExternSymbol(void *);
  2154.         extern int OtherExternSymbol(void *);
  2155.         }
  2156.  
  2157.   Also see ALPHA16 for information on /ARCHITECTURE and /OPTIMIZE=TUNE.
  2158.  
  2159.   See PROG17 for information on the C system and the lib$spawn call in
  2160.   CAPTIVE environments.
  2161.  
  2162.   Constructs such as the order of incrementation or decrementation and
  2163.   the order of argument processing within an argument list are all
  2164.   implementation-defined.  This means that C coding constructs such as:
  2165.  
  2166.     i = i++;
  2167.     a[i] = i++;
  2168.     foo( i, i++, --i);
  2169.  
  2170.   are undefined and can have (adverse) implications when porting the C
  2171.   code to another C compiler or to another platform.  In general, any
  2172.   combination of ++, --, =, +=, -=, *=, etc operators that will cause
  2173.   the same value to be modified multiple times (between what the
  2174.   ANSI/ISO C standard calls "sequence points") produce undefined and
  2175.   implementation-specific results.
  2176.  
  2177.   Within C, the following are the "sequence points": the ";" at the end
  2178.   of a C statment, the ||, &&, ?:, and comma operators, and a call to
  2179.   a function.  Note specifically that = is NOT a sequence point, and
  2180.   that the individual arguments contained within a function argument
  2181.   list can be processed from right to left, from left to right, or at
  2182.   any random whim.
  2183.  
  2184.   Compaq C for OpenVMS VAX (formerly DEC C) and VAX C do differ in the
  2185.   related processing.
  2186.  
  2187.   So you are looking for OpenVMS-specific definitions (include files)?
  2188.  
  2189.   UCBDEF.H, PCBDEF.H and other OpenVMS-specific definitions -- these are 
  2190.   considered part of OpenVMS and not part of the C compiler kit -- are 
  2191.   available on all recent OpenVMS Alpha releases.
  2192.  
  2193.   To reference the version-dependent symbol library sys$share:sys$lib_c.tlb,
  2194.   use a command similar to the following for compilation:
  2195.  
  2196.     CC sourcea+SYS$LIBRARY:SYS$LIB_C/LIB
  2197.  
  2198.   You can also define DECC$TEXT_LIBRARY to reference the library.
  2199.  
  2200.   You will want to review the Programming Concepts manual, and specifically
  2201.   take a quick look at Chapter 21.
  2202.  
  2203.   And some general background: the STARLET definitions (and thus the
  2204.   sys$starlet_c.tlb library) contain the symbols and the definitions that 
  2205.   are independent of the OpenVMS version.  The LIB definitions (and thus
  2206.   sys$lib_c) contain symbols and definitions that can be dependent on the 
  2207.   OpenVMS version.  You won't need to rebuild your code after an OpenVMS 
  2208.   upgrade if you have included definitions from STARLET.  The same cannot 
  2209.   be said for some of the definitions in LIB -- you might need to rebuild 
  2210.   your code.  (The UCB structure can and has changed from release to 
  2211.   release, for instance.)
  2212.  
  2213.   Recent versions of C automatically search sys$starlet_c.tlb.  Explicit
  2214.   specification of sys$lib_c.tlb is required.
  2215.  
  2216.   Also see the Ask The Wizard website (www.openvms.compaq.com/wizard/)
  2217.   topics (2486), (3803), and (1661).
  2218.   
  2219. ------------------------------------------------------------
  2220. SOFT6.    Obtaining user input in DCL CGI script?
  2221.  
  2222. If you choose to use the GET method, then the form data is available 
  2223. in the DCL symbol QUERY_STRING, in URL-encoded format.
  2224.  
  2225. If you use the POST method, then you need to read the form data from 
  2226. stdin. For a DCL CGI script running under the Netscape FastTrack web 
  2227. server, you can read the data using the following READ command:
  2228.  
  2229.   $ READ SYS$COMMAND postdata
  2230.  
  2231. to read the information in.
  2232.                                                 [Colin Blake]
  2233.  
  2234. The following describes the use of DCL command procedures as CGI
  2235. scripts with the OSU web server:
  2236.  
  2237. http://www.levitte.org/~ava/cgiscripts_other.htmlx
  2238.                                                 [Leif Jansson]
  2239.  
  2240. ------------------------------------------------------------
  2241. SOFT7.    How do I get my own batch entry number?
  2242.  
  2243. To have a batch procedure retrieve its own batch entry number,
  2244. use the following:
  2245.  
  2246.   $ Entry = F$GETQUI("DISPLAY_ENTRY", -
  2247.       "entry_number","display_entry","this_job")
  2248.  
  2249. Remember that the entry numbers issued by the OpenVMS Job Controller 
  2250. are opaque longword values.  Don't assume you know the format of the 
  2251. number, nor the range of numbers you might see...
  2252.                                                 [Peter Weaver]
  2253.  
  2254. ------------------------------------------------------------
  2255. SOFT8.    How do I convert to new CMS libraries?
  2256.  
  2257. A change was made to the format of the CMS database for CMS libraries
  2258. starting with V3.5-03 -- to ensure that earlier versions of CMS are
  2259. unable to access the database once the "conversion" to V3.5-05 and
  2260. later is made, you must issue the following two commands when upgrading
  2261. from V3.5-03 and prior.  (The only differences between CMS version
  2262. V3.5-03 and CMS version V3.5-05 involve changes to ensure that np
  2263. earlier version of CMS can access the "converted" database.)
  2264.  
  2265. To perform the "conversion", issue the following commands for each
  2266. CMS library present:
  2267.  
  2268.     $ RENAME disk:[directory]00CMS.* 01CMS.*
  2269.     $ COPY NLA0: disk:[directory]00CMS.CMS
  2270.  
  2271. The new file 00CMS.CMS must have the same security settings as the
  2272. 01CMS.CMS file, and is created solely to ensure continued compatibility
  2273. with tools that expect to find a 00CMS.CMS file (eg: various versions
  2274. of the Language-Sensitive text editor LSEDIT).
  2275.  
  2276. ------------------------------------------------------------
  2277. SOFT9.    Where can I get new certificates for Netscape Navigator?
  2278.  
  2279. The URLs that I found for adding/updating root certificates are:
  2280.  
  2281. http://www.entrust.net/customer/generalinfo/import.htm        entrust
  2282. http://www.thawte.com/                                        thwate
  2283. https://www.verisign.com/server/prg/browser/root.html         verisign
  2284.                                           [Ken Chaney]
  2285.  
  2286. To update certificates in Netscape Navigator V3.03 on OpenVMS,
  2287. use the following:
  2288.  
  2289. Here's how to update your Root certificates in Netscape:
  2290.  
  2291. Thawte Server certificate which expired in 1998:
  2292.  
  2293. 1) Under the Options Menu choose "Security Preferences..."
  2294. 2) Select the "Site Certificates" tab
  2295. 3) Select "Thawte Server CA" in the list of certificates
  2296. 4) Select "Delete Certificate" and then "OK"
  2297. 5) Go to http://www.thawte.com/serverbasic.crt
  2298. 6) Follow the instructions on the popup dialog box to accept the certificate
  2299.    This mostly involves hitting the "Next" button and clicking an accept
  2300.    button and then naming the resulting certificate.  I named it the same
  2301.    name as the original.
  2302.  
  2303. VeriSign/RSA Server certificate which expired Dec 31, 1999:
  2304.  
  2305. 1) Under the Options Menu choose "Security Preferences..."
  2306. 2) Select the "Site Certificates" tab
  2307. 3) Select "Verisign/RSA Secure Server CA" in the list of certificates
  2308. 4) Select "Delete Certificate" and then "OK"
  2309. 5) Go to https://www.verisign.com/server/prg/browser/root.html
  2310. 6) Follow the instructions on the popup dialog box to accept the certificate
  2311.    This mostly involves hitting the "Next" button and clicking an accept
  2312.    button and then naming the resulting certificate.  Verisign suggests
  2313.    using the name "VeriSign CA".
  2314.  
  2315.                                           [Vance Haemmerle]
  2316.  
  2317. ------------------------------------------------------------
  2318. SOFT10.   Why doesn't DCL symbol substitution work?
  2319.  
  2320. The DCL symbol substitution processing occurs only at the DCL prompt, 
  2321. not within data and not within files.  If you wish to perform symbol 
  2322. substitution in this environment, you typically write a small file 
  2323. containing the command(s) and data to be invoked -- potentially only 
  2324. the data -- and you then invoke the created procedure or reference 
  2325. the specified data.
  2326.  
  2327. In this case, use of a file containing nolinemode commands or other
  2328. techniques might be useful -- you will want to ensure that the text
  2329. editor you use does not attempt to use screen mode or similar, as this
  2330. is not generally considered adventageous within a command procedure.
  2331.  
  2332. Tools such as FTP have alternatives: COPY/FTP.
  2333.  
  2334. DCL symbol substitution occurs in two passes, using the ampersand and
  2335. the apostrophe.  In most cases, only the apostrophe is necessary.  In
  2336. a few cases -- such as the DCL PIPE command -- you will may need to use
  2337. the ampersand to get the substitution to work.  The following example
  2338. uses ampersand substitution to transfer the contents of the header
  2339. into a logical name:
  2340.  
  2341.   $ PIPE CC/VERSION | (READ SYS$PIPE hdr ; DEFINE/JOB/NOLOG hdr &hdr )
  2342.  
  2343. A logical name (in the job logical name table; shared by all processes 
  2344. in the current job) was used as DCL symbols cannot be returned back out
  2345. from a DCL PIPE or other spawned subprocess.
  2346.  
  2347.  
  2348. ------------------------------------------------------------
  2349. SOFT11.   Duplicates MGMT40.
  2350.  
  2351. ------------------------------------------------------------
  2352. SOFT12.   Where can I get Perl for OpenVMS?
  2353.  
  2354. OpenVMS support is included in the standard distribution of Perl, the 
  2355. popular scripting language created by Larry Wall.  In addition to nearly 
  2356. all of the functionality available under Unix, OpenVMS-specific Perl 
  2357. modules provide interfaces to many native features, as well as access
  2358. to Oracle, Ingres, and Sybase databases via the Perl DBI available on 
  2359. OpenVMS.
  2360.  
  2361. A website useful for getting started with Perl on OpenVMS -- where you 
  2362. will find such things as download links, instructions, auxiliary tools, 
  2363. and sample scripts -- is available at:
  2364.  
  2365.      http://www.sidhe.org/vmsperl
  2366.  
  2367. If you have a C compiler, the best way to obtain Perl is to download 
  2368. and build it yourself.  The latest production quality source kit is 
  2369. available from:
  2370.  
  2371.      http://www.perl.com/CPAN/src/stable.tar.gz
  2372.  
  2373. You will need GUNZIP and VMSTAR (both available from the OpenVMS Freeware
  2374. CD, or from other sites) to unpack the archive; once you've done that, 
  2375. read the instructions in the README.vms file.
  2376.  
  2377. Binary distributions for most Alpha and VAX environments are available 
  2378. on the OpenVMS Freeware CD-ROM and from various websites, including the 
  2379. following:
  2380.  
  2381.      http://www.sidhe.org/vmsperl/prebuilt.html
  2382.      http://www.openvms.compaq.com/freeware/perl5/
  2383.  
  2384. During active Perl development cycles, test kits are sometimes found at:
  2385. from:
  2386.  
  2387.      ftp://ftp.sidhe.org/
  2388.  
  2389. Watch the mailing list (see below) for details on experimental releases.
  2390.  
  2391. Charles Lane maintains pages on how to write CGI scripts in Perl for the 
  2392. OSU HTTP server, as well as more general tips, tricks, and patches for 
  2393. building and running Perl on OpenVMS:
  2394.  
  2395.      http://www.crinoid.com/crinoid.htmlx
  2396.  
  2397. There are OpenVMS-specific Perl modules that implement interfaces to a 
  2398. subset of the VMS System Services. With these modules, you can get (and 
  2399. often set) device, job, queue, user, system, and performance information. 
  2400. The lock manager, RMS indexed files, screen management utilities, and 
  2401. Intracluster Communication Services are also accessible via Perl.  The 
  2402. relevant modules are all available from:
  2403.  
  2404.      http://www.perl.com/CPAN/modules/by-module/VMS
  2405.  
  2406. To subscribe to the OpenVMS Perl mailing list (a discussion forum for 
  2407. both user support and new development), send an email message to:
  2408.  
  2409.     vmsperl-subscribe@perl.org
  2410.  
  2411. The mailing list archives may be searched at:
  2412.  
  2413.     http://www.xray.mpe.mpg.de/mailing-lists/vmsperl
  2414.                                               [Craig Berry]
  2415.  
  2416. ------------------------------------------------------------
  2417. SOFT13.   Where can I get DECmigrate (VEST and TIE)?
  2418.  
  2419.   The DECmigrate image translation tool, a tool that translates 
  2420.   OpenVMS VAX images for use on OpenVMS Alpha is available at:
  2421.  
  2422.      http://www.support.compaq.com/amt/decmigrate/index.html
  2423.  
  2424.   This tool is not currently supported.
  2425.  
  2426.   See UTIL4.
  2427.  
  2428. ------------------------------------------------------------
  2429. SOFT14.   Where can I get Zip, Unzip, self-extracting zip, etc?
  2430.  
  2431.   Many packages are provided in ZIP, GZIP, or BZIP format, which 
  2432.   requires you to acquire the associated unzip tool to unpack it.
  2433.   You can get ZIP and UNZIP from the following areas:
  2434.  
  2435.   http://www.openvms.compaq.com/freeware/freeware50/000tools/
  2436.   http://www.openvms.compaq.com/freeware/freeware50/bzip2/
  2437.   http://www.openvms.compaq.com/freeware/freeware50/info-zip/
  2438.   http://www.openvms.compaq.com/freeware/freeware40/000tools/
  2439.   ftp://ftp.process.com/vms-freeware/unzip.alpha_exe
  2440.   ftp://ftp.process.com/vms-freeware/unzip.vax_exe
  2441.   http://www.decus.de:8080/www/vms/sw/zip.htmlx
  2442.   http://www.djesys.com/zip.html
  2443.   http://www.djesys.com/unzip.html
  2444.  
  2445.   or you can request the FILESERV_TOOLS package from the e-mail server.
  2446.  
  2447.   [Beware: The [000TOOLS...] pre-built versions of ZIP on the OpenVMS 
  2448.   Freeware V4 (http://www.openvms.compaq.com/freeware/freeware40/)
  2449.   CD-ROM will erroneously return BILF errors on OpenVMS V7.2 and later.
  2450.   Use of the source on the Freeware V4 to rebuild the ZIP image(s), or 
  2451.   acquiring a pre-built ZIP image from one of the above areas can avoid 
  2452.   this.  The pre-built version of ZIP on the Freeware V4 kit is older 
  2453.   than the included ZIP sources, and it contains a latent bug.]
  2454.  
  2455.   Directions for using sfx (self-extracting zip) are available in the 
  2456.   unzip kit available at:
  2457.  
  2458.     http://www.openvms.compaq.com/freeware/freeware50/unzip542/
  2459.  
  2460.   Specifically:
  2461.  
  2462.     http://www.openvms.compaq.com/freeware/freeware50/UNZIP542/UNZIPSFX.TXT
  2463.  
  2464.   If you want to build the zip images for yourself (eg: for an older
  2465.   OpenVMS version), pull over the entire contents of:
  2466.  
  2467.     http://www.openvms.compaq.com/freeware/freeware50/unzip542/vms-binaries/
  2468.  
  2469.   and invoke LINK.COM.
  2470.  
  2471. [End of Part 4/5]
  2472.  
  2473.  --------------------------- pure personal opinion ---------------------------
  2474.    Hoff (Stephen) Hoffman   OpenVMS Engineering   hoffman#xdelta.zko.dec.com
  2475.  
  2476.