home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / dec-faq / vms < prev   
Encoding:
Text File  |  1995-07-25  |  60.1 KB  |  1,368 lines

  1. Subject: OpenVMS Frequently Asked Questions (FAQ)
  2. Newsgroups: comp.os.vms,comp.sys.dec,vmsnet.alpha,vmsnet.misc,comp.answers,news.answers
  3. From: lionel@quark.enet.dec.com (Steve Lionel)
  4. Date: 10 Nov 1994 21:50:09 GMT
  5.  
  6.  
  7. Archive-name: dec-faq/vms
  8. Posting-Frequency: monthly
  9. Last-modified: November 10, 1994
  10.  
  11. This is the Frequently Asked Questions (FAQ) posting for the comp.os.vms
  12. and vmsnet.misc newsgroups.  (comp.os.vms is bidirectionally-gatewayed to
  13. the INFO-VAX mailing list - see below for further details.)  It contains
  14. answers to frequently asked questions about Digital's OpenVMS operating
  15. system and the computer systems on which it runs.
  16.  
  17. This FAQ is archived in the following locations:
  18.     comp.answers and news.answers newsgroups
  19.     ftp://ftp.digital.com/pub/DEC/dec-faq
  20.     ftp://rtfm.mit.edu/
  21.     http://www.cis.ohio-state.edu/hypertext/faq/usenet/
  22.  
  23. The archive name for this FAQ is dec-faq/vms
  24.  
  25. To make suggestions for changes or additions to this Frequently Asked
  26. Questions list, send mail to the editor at lionel@quark.enet.dec.com.  
  27. Answers are especially appreciated.
  28.  
  29. Some general notes:
  30.  
  31. The term "VMS" is synonymous with "OpenVMS".  "Alpha" or "AXP" generally
  32. refers to any system based on Digital's Alpha AXP processor architecture.
  33. OpenVMS manual names mentioned are those as of V6.1 - names may be different
  34. in earlier editions of the documentation set.
  35.  
  36. World-Wide Web Universal Resource Locator (URL) notation is used for FTP
  37. addresses.
  38.  
  39. Many people have contributed to this list, directly or indirectly.  In
  40. some cases, an answer has been adapted from one or more postings on the
  41. comp.os.vms newsgroup.  Our thanks to all of those who post answers.
  42. The name (or names) at the end of an entry indicate that the information
  43. was taken from postings by those individuals; the text may have been
  44. edited for this FAQ.  These citations are only given to acknowledge the
  45. contribution.
  46.  
  47. Although the editor of this FAQ is an employee of Digital Equipment
  48. Corporation, this posting is not an official statement from Digital 
  49. Equipment Corporation.  
  50.  
  51. Alpha AXP, AXP, DEC, OpenVMS, VAX and VMS are trademarks of Digital
  52. Equipment Corporation.  Other names are properties of their respective owners.
  53.  
  54. Changes since last edition
  55. ========================================
  56. AXP2 page size corrected, text expanded.
  57. DECW1 comment about DECNET node names added.
  58. DECW9 added.
  59. FILE3 text on fsync expanded.
  60. INTRO5 expanded.
  61. PROG2 description of how to tell if you were invoked by a CLI expanded.
  62. PROG9 added.
  63. SOFT1 expanded
  64. UTIL1 added.
  65.  
  66.  
  67. Introduction
  68. ========================================
  69. INTRO1.  What is the scope of comp.os.vms?
  70. INTRO2.  What other newsgroups carry VMS-related information?
  71. INTRO3.  What is INFO-VAX?
  72. INTRO4.  How do I subscribe to or unsubscribe from INFO-VAX?
  73. INTRO5.  How do I submit a question or a response?
  74. INTRO6.  What is DECUS?
  75.  
  76. General questions about OpenVMS
  77. ========================================
  78. VMS1.   What is OpenVMS?  What is its history?
  79. VMS2.   What is the difference between VMS and OpenVMS?
  80. VMS3.   How do I port from VMS to OpenVMS?
  81. VMS4.   Which is better - OpenVMS or UNIX?
  82.  
  83. Alpha AXP
  84. ========================================
  85. AXP1.   What do the letters AXP stand for?
  86. AXP2.   What are the OpenVMS differences between VAX and AXP?
  87. AXP3.   Are there Alpha AXP systems on the net I can try out?
  88. AXP4.   How do I join Digital's Independent Software Vendor program?
  89.  
  90. Documentation and other resources
  91. ========================================
  92. DOC1.   Where can I find online copies of OpenVMS manuals?
  93. DOC2.   What online information is available from Digital?
  94. DOC3.   What books and publications are available?
  95.  
  96. System Management
  97. ========================================
  98. MGMT1.  What is an installed image?
  99. MGMT2.  Are there any known viruses for OpenVMS?
  100. MGMT3.  How do I mount an ISO-9660 CD on OpenVMS?
  101.  
  102. MAIL
  103. ========================================
  104. MAIL1.  How do I send Internet mail?
  105. MAIL2.  How do I get IN% or MX% added automatically to Internet addresses?
  106. MAIL3.  How do I automatically append a signature file to my mail messages?
  107. MAIL4.  Do I have to use VMS MAIL?  I like my Unix mailer better.
  108. MAIL5.  How can I forward my mail?  Can I forward it to an Internet address?
  109. MAIL6.  How can I forward my mail to a list of addresses?
  110. MAIL7.  MAIL keeps saying I have new messages, but I don't.  What do I do?
  111.  
  112. Other Utilities
  113. ========================================
  114. UTIL1.  How do I play an audio CD on my workstation?
  115.  
  116. DCL and command usage
  117. ========================================
  118. DCL1.   How do I run a program with arguments?
  119. DCL2.   How can I redefine control keys in DCL?
  120. DCL3.   How can I clear the screen in DCL?
  121.  
  122. File System and RMS
  123. ========================================
  124. FILE1.  How can I undelete a file?
  125. FILE2.  Why does SHOW QUOTA give a different answer than DIR/SIZE?
  126. FILE3.  How do I make sure that my data is safely written to disk?
  127.  
  128. Programming
  129. ========================================
  130. PROG1.  How do I call <routine_name> from <language_name>?
  131. PROG2.  How do I get the arguments from the command line?
  132. PROG3.  How do I get a formatted error message in a variable?
  133. PROG4.  How do I link against SYS$SYSTEM:SYS.STB on an AXP system?
  134. PROG5.  How do I do a SET DEFAULT from inside a program?
  135. PROG6.  How do I create a shareable image transfer vector on an AXP system?
  136. PROG7.  How do I turn my Fortran COMMON into a shareable image on AXP?
  137. PROG8.  How do I convert between IEEE and VAX floating data?
  138. PROG9.  How do I get the argument count in a Fortran routine?
  139.  
  140. DECwindows
  141. ========================================
  142.  
  143. DECW1.  How do I let someone else display something on my workstation?
  144. DECW2.  How do I create a display on another workstation?
  145. DECW3.  How can I get the information from SHOW DISPLAY into a symbol?
  146. DECW4.  How do I get a log of a DECterm session?
  147. DECW5.  Problem - the DELETE key deletes forward instead of backward!
  148. DECW6.  Problem - On a DEC2000-300, Motif doesn't start
  149. DECW7.  Problem - My LK401 keyboard unexpectedly autorepeats
  150. DECW8.  Problem - My LK411 sends the wrong keycodes or some keys are dead
  151. DECW9.  How do I set the title on a DECterm window?
  152.  
  153. Software
  154. ========================================
  155. SOFT1.  Where can I find lots of free software for OpenVMS?
  156.  
  157.  
  158.  
  159. ------------------------------------------------------------
  160. INTRO1.  What is the scope of comp.os.vms?
  161.  
  162. The comp.os.vms newsgroup is the primary newsgroup for discussion of 
  163. Digital's OpenVMS operating system and the computer systems on which it
  164. runs.  Questions about layered products which run on OpenVMS are also
  165. welcome, though many of them (in particular, language compilers and
  166. database systems) have more specific newsgroups.  If a question has
  167. some relationship to OpenVMS, it belongs here.
  168.  
  169. ------------------------------------------------------------
  170. INTRO2.  What other newsgroups carry VMS-related information?
  171.  
  172. The vmsnet.* hierarchy, run by DECUS, contains several newsgroups of
  173. interest, including vmsnet.misc and vmsnet.alpha, the latter being mostly
  174. devoted to Alpha AXP topics.  There's also vmsnet.sources (and 
  175. vmsnet.sources.d) to which sources for or pointers to freeware are posted.
  176. See the separate "What is VMSNET" monthly posting for further details.
  177.  
  178. The comp.sys.dec newsgroup carries discussions about all Digital systems
  179. as well as about Digital itself.
  180.  
  181. ------------------------------------------------------------
  182. INTRO3.  What is INFO-VAX?
  183.  
  184. INFO-VAX is a mailing list which is bidirectionally gatewayed to the
  185. comp.os.vms newsgroup.  This means that postings to comp.os.vms get
  186. automatically sent to INFO-VAX subscribers and messages sent to the INFO-VAX
  187. list are automatically posted to comp.os.vms.  INFO-VAX can be a useful way
  188. to participate in the newsgroup if you can't access the group directly
  189. through a news reader.
  190.  
  191. An important point to keep in mind is that propagation delays vary, both
  192. within the newsgroup and with INFO-VAX mailings.  It's possible that
  193. postings may not be delivered for several days and some may appear out of
  194. order.
  195.  
  196. ------------------------------------------------------------
  197. INTRO4.  How do I subscribe to or unsubscribe from INFO-VAX?
  198.  
  199. The address for subscription requests, as well as notes intended for the
  200. moderator, is Info-VAX-Request@Mvb.Saic.Com.  Subscription requests are handled
  201. automatically by a mail server.  This mail server ignores the subject line and
  202. processes each line of the message as a command.  The syntax for subscribing
  203. and unsubscribing to this mailing list is as follows:
  204.  
  205. SUBSCRIBE INFO-VAX      (ADD is a valid synonym)
  206. UNSUBSCRIBE INFO-VAX    (REMOVE, SIGNOFF, and SIGN-OFF are valid synonyms)
  207.  
  208. Case is irrelevant and attempts to fetch a copy of the mailing list will be
  209. rejected (I consider the information to be confidential).  Any message not
  210. understood by the mailserver will be forwarded to a human (allegedly) for
  211. manual processing.
  212.                 [Mark.Berryman@Mvb.Saic.Com]
  213.  
  214. If you are on Bitnet, send a mail message containing the text 
  215. "SUBSCRIBE INFO-VAX" to LISTSERV@(nearest listserv system).  To unsubscribe,
  216. send a message containing the text "SIGNOFF INFO-VAX" to the *SAME* listserv
  217. address. 
  218.  
  219. If you are on the Internet in the UK, send a message containing the
  220. word SUBSCRIBE (or UNSUBSCRIBE) to info-vax-request@ncdlab.ulcc.ac.uk.
  221.  
  222. ------------------------------------------------------------
  223. INTRO5.  How do I submit a question or a response?
  224.  
  225. If you are using a news reader, post your question to comp.os.vms.  If you
  226. want to submit through INFO-VAX, send the message to Info-VAX@mvb.saic.com.
  227.  
  228. Before posting, please use available local resources, such as the manuals,
  229. HELP and this FAQ first.  Also make a point of reading the release notes for
  230. the product you're using, generally placed in SYS$HELP.  Often you'll find
  231. the answer and will save time and effort for all concerned.
  232.  
  233. When posting, please consider the following suggestions:
  234.  
  235.     1.  Include a valid e-mail address in the text of your posting or
  236.         in a "signature" appended to the end.  Reply-to addresses in
  237.     headers often get garbled.
  238.  
  239.     2.  If you are submitting a question, please be as specific as you
  240.         can.  Include relevant information such as processor type, product
  241.     versions (VMS and layered products that apply) and a short,
  242.     reproducible example of problems.  Say what you've tried so far,
  243.     so that effort isn't duplicated.  Keep in mind that there's not yet 
  244.     a telepathy protocol for the Internet - the more detailed your
  245.     description, the better people can help you.
  246.  
  247.     3.  If responding to a posting, include in your reply only as much of
  248.         the original posting as is necessary to establish context.  As
  249.     a guideline, consider that if you've included more text than you've 
  250.     added, you've possibly included too much.  Never include signatures 
  251.     and other irrelevant material.
  252.  
  253.     4.  Be polite.  If the question isn't worded the way you think is
  254.         correct or doesn't include the information you want, try to
  255.     imagine what the problem might be if viewed from the poster's
  256.     perspective.  Requests for additional information are often
  257.     better sent through mail rather than posted to the newsgroup.
  258.  
  259.     5.  If you have a problem with Digital (or any vendor's) product,
  260.         use the appropriate support channel.  Don't assume that
  261.     newsgroup postings will get read or responded to by the appropriate
  262.     developers. 
  263.  
  264. ------------------------------------------------------------
  265. INTRO6.  What is DECUS?
  266.  
  267. DECUS, the Digital Equipment Computer Users Society, is a World Wide
  268. organization of Information Technology professionals interested in the
  269. products, services, and technologies of Digital Equipment Corporation and
  270. related vendors.
  271.    
  272. Membership in the Chapter is free and provides participants with the means
  273. to enhance their professional development, forums for technical training,
  274. mechanisms for obtaining up-to-date information, advocacy programs, and
  275. opportunities for informal disclosure and interaction with professional
  276. colleagues of like interest.
  277.  
  278. For further information, see the separate monthly "What is DECUS" posting, or
  279. refer to the DECUS WWW server at http://www.decus.org .
  280.  
  281. ------------------------------------------------------------
  282. VMS1.   What is OpenVMS?  What is its history?
  283.  
  284. OpenVMS, originally called VMS (Virtual Memory System), was first conceived in
  285. 1976 as a new operating system for Digital's new, 32-bit, virtual memory line
  286. of computers, eventually named VAX (Virtual Address eXtension).  The first VAX
  287. model, the 11/780, was code-named "Star", hence the code name for the VMS
  288. operating system, "Starlet", a name that remains to this day the name for the
  289. system library files (STARLET.OLB, etc.).  VMS version X0.5 was the first
  290. released to customers, in support of the hardware beta test of the VAX-11/780,
  291. in 1977.  VAX/VMS Version V1.0 shipped in 1978, along with the first
  292. revenue-ship 11/780s.
  293.  
  294. OpenVMS was designed entirely within Digital Equipment Corporation.  The
  295. principal designers were Dave Cutler and Dick Hustvedt.  OpenVMS was conceived
  296. as a 32-bit, virtual memory successor to Digital's RSX-11M operating system
  297. for the PDP-11.  Many of the original designers and programmers of OpenVMS
  298. had worked previously on RSX-11M, and many concepts from RSX-11M were carried
  299. over to OpenVMS.
  300.  
  301. OpenVMS is a 32-bit, multitasking, multiprocessing virtual memory operating
  302. system. Current implementations run on Digital's VAX and Alpha AXP computer
  303. systems.
  304.                 [winalski@gemgrp.enet.dec.com]
  305.  
  306. For more details on OpenVMS and its features, read the OpenVMS Software
  307. Product Descriptions at:
  308.   ftp://ftp.digital.com/pub/Digital/info/SPD/25-01-39.txt   (OpenVMS VAX)
  309.   ftp://ftp.digital.com/pub/Digital/info/SPD/41-87-02.txt   (OpenVMS AXP)
  310.  
  311. ------------------------------------------------------------
  312. VMS2.   What is the difference between VMS and OpenVMS?
  313.  
  314. VMS and OpenVMS are two names for the same operating system.  Originally,
  315. the operating system was called VAX-11/VMS; it changed to VAX/VMS at
  316. around VAX/VMS V2.0.  When the VMS operating system was ported to the
  317. Alpha AXP platform, it was renamed OpenVMS, for both VAX and AXP, in part
  318. to signify the high degree of support for industry standards such as
  319. POSIX, which provides many features of UNIX systems.  An OpenVMS license
  320. allows you to install and run POSIX for OpenVMS at no additional charge;
  321. all you need is the media and documentation which can be found on the
  322. Consolidated Distribution and On-Line Documentation CD-ROMs.  For more
  323. information on POSIX for VMS see:
  324.   ftp://ftp.digital.com/pub/Digital/info/pr-news/92060311FS.txt
  325.  
  326. What became confusing is that the OpenVMS name was introduced first
  327. for OpenVMS AXP V1.0 causing the widespread misimpression that OpenVMS
  328. was for AXP only, while "regular VMS" was for VAX.  In fact, Digital
  329. officially changed the name of the VAX operating system as of V5.5,
  330. though the name did not start to be actually used in the product until
  331. V6.0.
  332.  
  333. The proper names for OpenVMS on the two platforms are "OpenVMS VAX"
  334. and "OpenVMS AXP".
  335.  
  336. ------------------------------------------------------------
  337. VMS3.   How do I port from VMS to OpenVMS?
  338.  
  339. You already did.  Wasn't that easy?  (See question VMS2.)
  340.  
  341. ------------------------------------------------------------
  342. VMS4.   Which is better - OpenVMS or UNIX?
  343.  
  344. This question comes up periodically, usually asked by new subscribers who are
  345. long-time UNIX users. Sometimes, it is ignored totally; other times, it leads
  346. to a long series of repetitive messages that convince no one and usually carry
  347. little if any new information.  Please do everyone a favor and avoid
  348. re-starting this perpetual, fruitless debate.
  349.                     [leichter@lrw.com]
  350.  
  351. Seriously, OpenVMS and the better implementations of UNIX are all fine
  352. operating systems, each with its strengths and weaknesses.  If you're
  353. in a position where you need to choose, select the one that best fits
  354. your own requirements, considering, for example, whether or not the
  355. layered products or specific OS features you want are available.
  356.  
  357. See also question VMS2 for information on POSIX for OpenVMS which provides
  358. significant UNIX functionality on OpenVMS.
  359.                     [lionel@quark.enet.dec.com]
  360.  
  361. ------------------------------------------------------------
  362. AXP1.   What do the letters AXP stand for?
  363.  
  364. While there are many fanciful "definitions" which have circulated widely,
  365. the truth is that AXP is not an abbreviation nor an acronym; the letters
  366. do not mean anything.  They are just three letters chosen to form a
  367. trademark.
  368.  
  369. When it came time to chose a "marketing name" for the Alpha AXP line,
  370. Digital was in a quandary.  The internal "code name" for the project,
  371. Alpha, was widely known and would seem the ideal choice, but it was already
  372. in common use by a number of other companies and could not be trademarked.
  373. A well-known "name search" firm was hired and was asked to come up with
  374. two lists of possible names.  The first list was intended to evoke the
  375. feeling of "extension to VAX", while the second list was to suggest
  376. "not a VAX".  Unfortunately, none of the choices offered were any good;
  377. for example, "VAX 2000" was found on the first list while the second list
  378. contained "MONDO" (later to be used for a kids' soft drink).
  379.  
  380. Shortly before announcement, a decision was made to name the new line ARA,
  381. for Advanced RISC Architecture.  However, a Digital employee in Israel
  382. quickly pointed out that this name, if pronounced in the "obvious" manner,
  383. sounded very much like an Arabic word with decidely unfortunate connotations.
  384. Eventually, AXP was selected; the architecture would be referred to as
  385. "Alpha AXP" whereas products themselves would use just "AXP".
  386.  
  387. Despite all this, everyone went on calling the new line "Alpha".  Digital
  388. has recognized this by coining a new "AlphaGeneration" trademark to apply
  389. to all products (hardware, software and services) related to the Alpha AXP
  390. line.
  391.  
  392. ------------------------------------------------------------
  393. AXP2.   What are the OpenVMS differences between VAX and AXP?
  394.  
  395. Very few.  As of OpenVMS V6.1, the VAX and AXP platforms are very close
  396. to "feature parity".  Most applications can just be recompiled and
  397. run.  Some differences to be aware of:
  398.  
  399.     - The default double-precision floating type on OpenVMS AXP
  400.       is VAX G_float, whereas on VAX it is usually D_float.  D_float
  401.       is available on AXP, but D_float values are converted to
  402.       G_float for computations and then converted back to D_float
  403.       when stored.  Because the G_float type has three fewer fraction
  404.       bits than D_float, some applications may get different results.
  405.       IEEE float types are also available on OpenVMS AXP.
  406.  
  407.     - Data alignment is extremely important for best performance on
  408.       AXP.  This means that data items should be allocated at
  409.       addresses which are exact multiples of their sizes.  Quadword
  410.       alignment will offer the best performance, especially for
  411.       character values and those smaller than 32 bits.  Compilers
  412.       will naturally align variables where they can and will issue
  413.       warnings if they detect unaligned data items.
  414.  
  415.     - DEC C is the only C compiler Digital offers on OpenVMS AXP.
  416.       It is compatible with DEC C on OpenVMS VAX, but is somewhat
  417.       different from the older VAX C compiler most people are familiar with.
  418.       Read up on the /EXTERN_MODEL and /STANDARD qualifiers to avoid
  419.       the most common problems.
  420.  
  421.     - The page size on AXP systems is variable, but is at least 8K bytes.
  422.       This can have some effect on applications which use the $CRMPSC
  423.       system service as well as on the display of available memory
  424.       pages.  The page size is available from $GETSYI(SYI$_PAGE_SIZE).
  425.  
  426. There are also a number of manuals which discuss migration to AXP.
  427.  
  428.     - "A Comparison of System Management on OpenVMS AXP and OpenVMS VAX"
  429.     - "Migrating to an OpenVMS AXP System: Planning for Migration"
  430.     - "Migrating to an OpenVMS AXP System: Porting VAX MACRO Code"
  431.     - "Migrating to an OpenVMS AXP System: Recompiling and Relinking"
  432.  
  433. These are part of the "AXP Migration Kit" (which is part of the "Programming
  434. Kit" - which in turn is part of the "Standard Set" if ordering documentation.)
  435. Check out the "Overview of OpenVMS Documentation" book on the Bookreader-based
  436. doc set included on the OpenVMS AXP V6.1 distribution CD for part numbers of
  437. both assorted "kits" and/or individual manuals.
  438.  
  439. ------------------------------------------------------------
  440. AXP3.   Are there Alpha AXP systems on the net I can try out?
  441.  
  442. Yes.  Two OpenVMS AXP and two DEC OSF/1 AXP systems are available.  Each
  443. has a wide variety of layered products installed and they can be used to
  444. test or port applications or just to "try it out".  The systems are:
  445.  
  446.     OpenVMS:
  447.         axpvms.pa.dec.com
  448.         axpvms.cc.utexas.edu
  449.  
  450.     OSF/1:
  451.         axposf.pa.dec.com
  452.         axposf.stanford.edu
  453.  
  454. To apply for a free account, telnet to the system of your choice and
  455. log in as axpguest; no password is required. 
  456.  
  457. ------------------------------------------------------------
  458. AXP4.   How do I join Digital's Independent Software Vendor program?
  459.  
  460. Digital Equipment Corporation is evaluating a new service  for members of our
  461. Independent Software Vendor Program.
  462.              
  463. This potential new service will provide technical assistance  to Independent
  464. Software Vendors who are porting their  applications to the Alpha AXP platform.
  465.              
  466. For more information, send mail to AXP-developer@digital.com
  467.  
  468. ------------------------------------------------------------
  469. DOC1.   Where can I find online copies of OpenVMS manuals?
  470.  
  471. Digital's OpenVMS documentation is copyrighted and is not freely
  472. available on the net.  Documentation is offered in CD-ROM form
  473. through a subscription to the Consolidated On-Line Documentation (ConOLD)
  474. product.  ConOLD manuals are readable with Bookreader, a viewer that is
  475. supplied with DECwindows Motif.  VTBOOK, a viewer for Bookreader documents
  476. which is usable from character-cell terminals (eg. VTxxx) is available
  477. from the WKU VMS Freeware file server - see question SOFT1 for details.
  478.  
  479. ------------------------------------------------------------
  480. DOC2.   What online information is available from Digital?
  481.  
  482. On your OpenVMS system, the HELP command can provide a wealth of information,
  483. not only on DCL commands but on system services (HELP System_Services) and
  484. Run-Time Library routines (HELP RTL_Routines).  The introduction displayed
  485. when you type the HELP command with no additional keywords provides further
  486. pointers.
  487.  
  488. In SYS$COMMON:[SYSHLP.VMSDOC] (OpenVMS V6.0 or later) you'll find the 
  489. following three files:
  490.  
  491.     VMSDOC_GLOSSARY.TXT - Glossary of OpenVMS terminology
  492.     VMSDOC_OVERVIEW.TXT - Overview of OpenVMS documentation
  493.     VMSDOC_MASTER_INDEX.TXT - Master index of OpenVMS documentation
  494.  
  495. These files are optionally installed; some system managers may have selected
  496. not to install them or to put them in another location.  If you cannot
  497. locate them, ask your system manager.
  498.  
  499. Product information for just about everything Digital sells is available
  500. from Digital's Internet servers.  If you're using a World-Wide-Web (WWW)
  501. browser, use http://www.digital.com/info.html  For anonymous FTP access,
  502. log in to ftp.digital.com.  Software Product Descriptions, performance
  503. data, product infosheets, release notes and much more are available.
  504.  
  505. Digital's Multivendor Customer Services organization also hosts an
  506. Internet server.  If you have a software support contract you can obtain
  507. patches from here - even without a contract you can browse through the
  508. "readme" files for correction kits.  The WWW URL is 
  509.   http://www.service.digital.com/ 
  510. For ftp access use 
  511.   ftp://ftp.service.digital.com/
  512.  
  513. A WWW version of the DECdirect catalog is also available at
  514.   http://www.service.digital.com/ddi/html/ddhome.html
  515.  
  516. Digital's Electronic Connection, also called "E-store", provides product
  517. information, prices and even lets you order online.  For free access,
  518. TELNET to order.sales.digital.com or connect via modem at 800-234-1998.
  519. If you're on TYMNET, connect to ECONN.  If you need to get pricing for
  520. Digital software licenses for your configuration, this is the place to get
  521. them.
  522.  
  523. Information on Digital and on Digital hardware, software, products
  524. and services is available through various telephone numbers:
  525.  
  526.     1-800-DIGITAL    : voice : DECdirect products, books and services
  527.     1-800-PCBYDEC       : voice : Digital PC hardware and software
  528.     1-800-DECINFO    : voice : General Corporate Information
  529.     1-603-884-0924    : voice : (alternate number for above)
  530.     1-800-234-1998    : modem : The Digital Electronic Connection
  531.     1-800-DEC-2717    : voice : The DECchip Hotline
  532.     1-508-568-6868    : voice : (alternate number for above)
  533.  
  534. ------------------------------------------------------------
  535. DOC3.   What books and publications are available?
  536.  
  537. DEC Professional is alive and well. It's a monthly magazine 
  538. that help you manage your Digital systems in a multivendor environment. 
  539. Subscriptions are free to qualified Digital sites.
  540.  
  541. Digital Systems Journal is a bimonthly magazine that contains more 
  542. in-depth, hands-on, how-to information. Subscriptions are paid.
  543.  
  544. If you're interested in acquiring a subscription to DEC Professional or 
  545. Digital Systems Journal, contact Omeda Communications:
  546.  
  547. 800-306-6332
  548. 708-564-1385
  549.  
  550. They'll send you everything you need.
  551.                     [morrison@elvis.cardinal.com]
  552.  
  553. ------------------------------------------------------------
  554. MGMT1.  What is an installed image?
  555.  
  556. The term "install" has two distinct meanings in OpenVMS.  The first relates to
  557. "installing a product", which is done with either the SYS$UPDATE:VMSINSTAL.COM
  558. command procedure or the POLYCENTER Software Installation (PCSI) utility 
  559. (PRODUCT command).  The second meaning relates to the use of the INSTALL
  560. utility, which is what concerns us here.
  561.  
  562. The INSTALL utility is used to identify to OpenVMS a specific copy of an
  563. image, either executable or shareable, which is to be given some set of
  564. enhanced properties.  For example, when you issue the SET PASSWORD command,
  565. the image SYS$SYSTEM:SETP0.EXE is run.  That image needs to have elevated
  566. privileges to perform its function.
  567.  
  568. The other important attribute is /SHARED.  This means that shareable parts
  569. of the image (typically read-only code and data) are loaded into memory
  570. only once and are shared among all users on a system.  Executable images
  571. can be installed /SHARED as well as shareable library images.  (The term
  572. "shareable" has dual meanings here, too.  See the OpenVMS Programming
  573. Concepts Manual for further details.)
  574.  
  575. It's important to note that there is no such thing as "installing a shareable
  576. image with privileges".  The INSTALL utility will let you do it, but the
  577. privileges you specify will be ignored.  To have a callable routine run with
  578. enhanced privileges that are not available to its caller, you must construct
  579. your routines as "user-written system services" and install the shareable
  580. image with the /PROTECT qualifier.  See the OpenVMS Programming Concepts
  581. Manual for more information on user-written system services.  Note also
  582. that in many cases the need to grant privileges to an image can be replaced
  583. with the use of the "Protected Subsystems" feature that grants a rights
  584. identifier to an image.  See the OpenVMS Guide to System Security for
  585. information on Protected Subsystems.
  586.  
  587. ------------------------------------------------------------
  588. MGMT2.  Are there any known viruses for OpenVMS?
  589.  
  590. Viruses are very common on PCs because the PC operating systems such as MS-DOS
  591. and MacOS do not implement any sort of scheme to protect the operating system
  592. or the file system against hostile action by programs.  On these operating
  593. systems, any running program can subvert the operating system and take over
  594. the hardware, at which point it can do anything it wishes, including hiding
  595. copies of itself in other programs or in the file system.
  596.  
  597. This is not possible on VMS, Unix, MVS, and Windows NT, for two reasons.
  598. First, the operating system runs in a privileged mode in memory that is
  599. protected against modification by normal user programs.  Any old program
  600. cannot take over the hardware as it can on PC operating systems.  Secondly,
  601. VMS, Unix, MVS, and NT have file systems that can be set up so that
  602. non-privileged programs cannot modify system programs and files on disk.  Both
  603. of these protection schemes mean that traditional PC virus schemes don't work
  604. on these OSes.
  605.  
  606. It is possible for VMS, etc., to be infected by viruses, but to do so, the
  607. program containing the virus must be run from a user account that has
  608. amplified privileges.  As long as the system administrator is careful that
  609. only trusted applications are run from such accounts (and this is generally
  610. the case), there is no danger from viruses.
  611.                     [winalski@gemgrp.enet.dec.com]
  612.  
  613. To protect against viruses and other attempts at system interference or
  614. misuse, follow the recommendations in the "OpenVMS Guide to System  Security". 
  615. You may also want to consider optional software products which can monitor
  616. your system for intrusion or infection attempts.  Digital offers the 
  617. following products in this area:
  618.  
  619.   DECinspect Intrusion Detector
  620.   POLYCENTER Security Reporting Facility
  621.   POLYCENTER Security Compliance Manager
  622.  
  623. [Contributions to this list welcomed]
  624.  
  625. ------------------------------------------------------------
  626. MGMT3.  How do I mount an ISO-9660 CD on OpenVMS?
  627.  
  628. ISO-9660 support was added in the following releases:
  629.  
  630.     OpenVMS VAX V6.0
  631.     OpenVMS AXP V1.5
  632.     OpenVMS VAX V5.5, use F11CD kit from InfoServer CD, or
  633.                       Consolidated Distribution CD under InfoServer, or
  634.               Digital Customer Support - CSCPAT #1071012
  635.  
  636. Here's how to do it:
  637.  
  638.     $ MOUNT/MEDIA_FORMAT=CDROM  device-name[:] [volume-label]
  639.  
  640. Please refer to the OpenVMS MOUNT Utility Manual, especially the section
  641. regarding the MOUNT qualifier /UNDEFINED_FAT. 
  642.  
  643. From the OpenVMS release notes:
  644.  
  645.   Because ISO-9660 media can be mastered from platforms that do not support
  646.   semantics of files containing predefined record formats, you may encounter
  647.   ISO-9660 CD-ROMs with files that contain records for which no record format
  648.   was specified.
  649.  
  650. An example which works for most CD-ROMs is:
  651.  
  652.     $ MOUNT/MEDIA_FORMAT=CDROM/UNDEFINED_FAT=STREAM:2048 DUA0: FREEWARE
  653.  
  654. This /UNDEFINED_FAT qualifier states, "For any file whose file attributes are
  655. 'undefined', return file attributes of 'stream', maximum record length 2048".
  656.                     [dunham@star.enet.dec.com]
  657.  
  658. ------------------------------------------------------------
  659. MAIL1.  How do I send Internet mail?
  660.  
  661. There is no one answer to this question.  Internet mail is built upon the
  662. TCP/IP protocols, which are not directly supported by VMS.  A number of
  663. implementations of TCP/IP for VMS are available, from Digital, from a number
  664. of other vendors, and even in a free "support it yourself" form.  The MAIL
  665. program that comes with VMS does not directly support the mail format used on
  666. the Internet, but various programs have been written that use MAIL's "foreign
  667. protocol" facility to provide such support.  To send mail through a foreign
  668. protocol by using an address syntax like IN%"fred@fred-host.flint.com".  You
  669. *must* include the quotation marks  Between them is the address in the format
  670. used by mail programs that support the Internet directly.  The IN% - short for
  671. INternet - names the foreign protocol.  On some systems, you use MX% or SMTP%
  672. instead. (MX is a widely used, free, mail handler; see question  SOFT1. SMTP%
  673. is used by Digital's UCX TCP/IP product)  Other systems may use some other
  674. name.  If none of these prefixes work, ask your system manager for assistance.
  675.                     [leichter@lrw.com]
  676.  
  677. ------------------------------------------------------------
  678. MAIL2.  How do I get IN% or MX% added automatically to Internet addresses?
  679.  
  680. Get the MAILSHR_PATCH package (there's one each for VAX and AXP) from the 
  681. WKU FILESERV server (see question SOFT1.)
  682.  
  683. ------------------------------------------------------------
  684. MAIL3.  How do I automatically append a signature file to my mail messages?
  685.  
  686. The basic MAIL utility which is shipped with VMS does not have an intrinsic
  687. mechanism for adding signature files.  If you're using an enhanced mail
  688. handling package (e.g PMDF), however, it may have provisions for adding
  689. signature files to all messages it handles - check the documentation for
  690. details.  In addition, it's common practice to use an editor to handle
  691. addition of `quotation marks' (e.g. >) and signature files to mail messages
  692. and news postings.  There are several implementations of this for different
  693. editors available on the net; for one example, see the MAIL_EDIT package
  694. available at 
  695.   ftp://narnia.memst.edu/mail_edit_v1-4.zip
  696.                     [bailey@genetics.upenn.edu]
  697.  
  698. Define the logical MAIL$EDIT to a COM-file, which looks something like
  699. the following:
  700.  
  701. $ IF P1 .NES. ""
  702. $ THEN
  703. $    COPY 'P1',<signaturefile> 'P2'
  704. $ ELSE
  705. $    COPY <signaturefile> 'P2'
  706. $ ENDIF
  707. $ DEFINE/NOLOG SYS$INPUT SYS$COMMAND
  708. $ <editorname> 'P2'
  709. $ EXIT
  710.  
  711. Where <signaturefile> is the name of the signature-file (including directory
  712. and disk) and <editorname> is EDIT/EDT or EDIT/TPU (or your favorite editor).
  713.                     [ARNE@ko.hhs.dk]
  714.  
  715. ------------------------------------------------------------
  716. MAIL4.  Do I have to use VMS MAIL?  I like my Unix mailer better.
  717.  
  718. Several Unix mailers have been ported to VMS, some by the vendors of specific
  719. TCP/IP packages, some by users who have made them freely available.  See the
  720. documentation for your TCP/IP package, and refer to question SOFT1 for
  721. information about the availability of the free ports.
  722.                     [leichter@lrw.com]
  723.  
  724. ------------------------------------------------------------
  725. MAIL5.  How can I forward my mail?  Can I forward it to an Internet address?
  726.  
  727. You can use the SET FORWARD command within MAIL to specify where you want all
  728. your mail forwarded to.  Use SHOW FORWARD to see your current forwarding.  To
  729. cancel all forwarding, type SET NOFORWARD.
  730.  
  731. You can forward your mail to an Internet address, but you have to be careful
  732. because of the way MAIL handles special characters, such as quotation marks.
  733. First, determine the address you would use to send mail to the place you want
  734. to forward to - say, IN%"fred@fred-host.flint.com".  Take that string and
  735. *double all the quotation marks*, producing IN%""fred@fred-host.flint.com"".
  736. Finally, wrap quotation marks around the outside and use the the result with
  737. SET FORWARD:
  738.  
  739.     MAIL>SET FORWARD "IN%""fred@fred-host.flint.com"""
  740.  
  741. If you do SHOW FORWARD, you should now see:
  742.  
  743.     Your mail is being forwarded to IN%"fred@fred-host.flint.com".
  744.                     [leichter@lrw.com]
  745.  
  746. ------------------------------------------------------------
  747. MAIL6.  How can I forward my mail to a list of addresses?
  748.  
  749. VMS MAIL does not support forwarding a message to more than one address.
  750. (Older versions of MAIL allowed you to specify such forwarding, but it never
  751. worked correctly.)
  752.  
  753. Many of the TCP/IP mail packages support forwarding to mailing lists, as does
  754. the free MX mail handling system and the DELIVER mail "extender".  See the
  755. documentation of your TCP/IP package and question SOFT1.
  756.                     [leichter@lrw.com]
  757.  
  758. ------------------------------------------------------------
  759. MAIL7.  MAIL keeps saying I have new messages, but I don't.  What do I do?
  760.  
  761. The count of new mail messages is kept separately from your mail folder
  762. in SYS$SYSTEM:VMSMAIL_PROFILE.DATA.  It sometimes happens that this count
  763. differs from what's in your mail folder.  If this happens, go into MAIL
  764. and repeat the READ/NEW command until you see no new mail messages.  Then
  765. enter the command one more time.  This will resynchronize the counters.
  766.  
  767. ------------------------------------------------------------
  768. UTIL1.  How do I play an audio CD on my workstation?
  769.  
  770. If you've installed the DECwindows examples, you'll find
  771. DECW$CDPLAYER.C, .DAT, .EXE, .UIL, and .UID.  Copy the .UID and .DAT
  772. files to DECW$USER_DEFAULTS: (typically SYS$LOGIN:), define the logical name
  773. DECW$CD_PLAYER to be the device name of your CD-ROM drive (eg. DKA400:),
  774. give yourself PHY_IO and DIAGNOSE privileges, and run the .EXE.  You can
  775. also install the image with these privileges.  See the source for
  776. additional details - note that the comments regarding the need for
  777. SYSGEN CONNECT are no longer applicable (at least as of VMS V5.5-2).
  778.  
  779. There's also SYS$EXAMPLES:CDROM_AUDIO.C and .EXE, a non-Motif program.
  780. ------------------------------------------------------------
  781. DCL1.   How do I run a program with arguments?
  782.  
  783. The RUN command does not accept arguments.  To pass arguments to a program,
  784. you must use what is called a "foreign command".  For example:
  785.  
  786.     $ uudecode :== $disk:[dir]uudecode.exe
  787.     $ uudecode filespec
  788.  
  789. The leading $ in the symbol definition is what makes it a foreign command.
  790. If the device and directory is omitted, SYS$SYSTEM: is assumed.  For more
  791. information on foreign commands, see the OpenVMS User's Manual.
  792.  
  793. See also question PROG2.
  794.  
  795. ------------------------------------------------------------
  796. DCL2.   How can I redefine control keys in DCL?
  797.  
  798. The DCL DEFINE/KEY command allows you to define function and keypad
  799. keys, but not control keys.  Also, keys you define with DEFINE/KEY are
  800. not recognized inside applications.  Many applications which use the
  801. SMG$ routines for input have a similar DEFINE/KEY feature.
  802.  
  803. The terminal driver line-editing control keys, including the use of DEL
  804. for delete, are not modifiable.
  805.  
  806. ------------------------------------------------------------
  807. DCL3.   How can I clear the screen in DCL?
  808.  
  809. The simplest way is TYPE/PAGE NL:
  810.  
  811. ------------------------------------------------------------
  812. FILE1.  How can I undelete a file?
  813.  
  814. OpenVMS doesn't have an "undelete" function.  However, if you are quick
  815. to write-protect the disk (or if you can guarantee that no new files get
  816. created or existing files extended), your data is still on the disk
  817. and it may be possible to retrieve it.  The FLORIAN tool available from
  818. the WKU Fileserver claims to be able to do this (see question SOFT1.)
  819.  
  820. ------------------------------------------------------------
  821. FILE2.  Why does SHOW QUOTA give a different answer than DIR/SIZE?
  822.  
  823. DIR/SIZE doesn't take into account the size of file headers which are
  824. charged to your quota.  Also, unless you use DIR/SIZE:ALL, you'll see only
  825. the "used" size of the file, not the allocated size which is what gets
  826. charged against your quota.  Also, you may have files in other directories.
  827.                     [lionel@quark.enet.dec.com]
  828.  
  829. $ DIR/SIZ=ALL/GRAND [username...]
  830.  
  831. Grand total of D1 directories, F1 files, B1/B2 blocks.
  832.  
  833. $ DIR/SIZ=ALL/GRAND [-]username.DIR
  834.  
  835. Grand total of 1 directory, 1 file, B3/B4 blocks.
  836.  
  837. $ SHOW QUOTA
  838.   User [username] has B5 blocks used, B6 available,
  839.   of B7 authorized and permitted overdraft of B8 blocks on disk
  840.  
  841. If the user has no files in other directories and all file-headers are
  842. only 1 block, then the following should apply:
  843.  
  844.   B5=B2+B4+F1+1
  845.  
  846. If the diskquota is out of synch, then the system-manager can make a rebuild.
  847.                     [ARNE@ko.hhs.dk]
  848. ------------------------------------------------------------
  849. FILE3.  How do I make sure that my data is safely written to disk?
  850.  
  851. If your application must absolutely guarantee that data is available,
  852. no matter what, there's really no substitute for RMS Journalling.  However,
  853. you can achieve a good degree of data integrity by issuing a SYS$FLUSH RMS
  854. call at appropriate times (if you're using RMS, that is.)  If you're
  855. using a high-level language's I/O system, check that language's documentation
  856. to see if you can access the RMS control blocks for the open file.  In
  857. C you can use fflush followed by fsync.  Note that fsync, which was
  858. undocumented for VAX C but is documented for DEC C, takes a file descriptor
  859. as an argument, not a *FILE.
  860.  
  861. ------------------------------------------------------------
  862. PROG1.  How do I call <routine_name> from <language_name>?
  863.  
  864. Most OpenVMS system services and RTL routines pass string arguments by
  865. descriptor.  Languages which support native string data types create
  866. descriptors automatically; those which do not (eg., C) require that you set
  867. them up explicitly.
  868.                     [eric@tardis.HQ.ileaf.com]
  869.  
  870. There is a lot of information available on how to call system services
  871. and Run-Time Library routines, including examples in numerous languages.
  872. The best references are:
  873.  
  874.     Your language's User Manual
  875.     OpenVMS Programming Environment Manual
  876.     OpenVMS Programming Concepts Manual
  877.     OpenVMS Programming Interfaces: Calling a System Routine
  878.     OpenVMS Calling Standard
  879.  
  880. In addition, if you are a subscriber to the Digital Software Information
  881. Network (available to those with a software support contract), the DSIN
  882. database contains hundreds of worked examples of calling system services
  883. and RTL routines, including the one that seems to trip up almost everyone,
  884. SMG$CREATE_MENU.
  885.                     [lionel@quark.enet.dec.com]
  886.  
  887. ------------------------------------------------------------
  888. PROG2.  How do I get the arguments from the command line?
  889.  
  890. If you're writing a program and want to accept arguments from a foreign
  891. command, you can use LIB$GET_FOREIGN to get the command line and parse
  892. it yourself, or if you're programming in C, use the normal argc/argv
  893. method.
  894.  
  895. To write an application which uses the normal DCL verb/qualifier/parameter
  896. syntax for invocation, see the description of the CLI$ routines in the
  897. OpenVMS Callable Utility Routines Reference Manual.
  898.  
  899. It is possible to write an application which can be used both ways; if a 
  900. DCL verb isn't used to invoke the image, the application parses the command 
  901. line itself.  One way to do this is to call CLI$GET_VALUE for a required
  902. parameter.  If it is not present (or you get an error), call 
  903. LIB$GET_FOREIGN to get the command line and do the manual parse.
  904.  
  905. See also question DCL1.
  906.  
  907. ------------------------------------------------------------
  908. PROG3.  How do I get a formatted error message in a variable?
  909.  
  910. Use the SYS$PUTMSG system service with an action routine that stores
  911. the message line(s) in the variable of your choice.  Be sure the action
  912. routine returns a "false" (low bit clear) function value so that SYS$PUTMSG
  913. doesn't then try to display the message (unless you want it to.)  See the
  914. description of $PUTMSG in the System Services Reference Manual for an
  915. example of using an action routine.
  916.  
  917. ------------------------------------------------------------
  918. PROG4.  How do I link against SYS$SYSTEM:SYS.STB on an AXP system?
  919.  
  920. LINK/SYSEXE is the OpenVMS AXP equivalent of linking against SYS.STB.
  921.  
  922. ------------------------------------------------------------
  923. PROG5.  How do I do a SET DEFAULT from inside a program?
  924.  
  925. The problem is that SYS$SETDDIR only changes the default directory - NOT
  926. the default disk. The default disk is determined by the logical SYS$DISK.
  927. If you want to change the default disk within a program, then call
  928. LIB$SET_LOGICAL to change the logical SYS$DISK. You will need to call both
  929. LIB$SET_LOGICAL and SYS$SETDDIR to change both default disk and the default
  930. directory!
  931.                     [ARNE@ko.hhs.dk]    
  932.  
  933. ------------------------------------------------------------
  934. PROG6.  How do I create a shareable image transfer vector on an AXP system?
  935.  
  936. This is something that was greatly simplified for OpenVMS AXP.  You don't
  937. need to create a separate transfer vector module; just use the SYMBOL_VECTOR
  938. statement in a linker options file.  For example, if your shareable image
  939. has two routines named FOO and BAR, the linker options file should contain
  940. the following line:
  941.  
  942.     SYMBOL_VECTOR=(FOO=PROCEDURE, BAR=PROCEDURE)
  943.  
  944. The Linker manual has more details on this.
  945.  
  946. ------------------------------------------------------------
  947. PROG7.  How do I turn my Fortran COMMON into a shareable image on AXP?
  948.  
  949. You need to add SYMBOL_VECTOR=(<common-name>=PSECT) to your options file.  On
  950. OpenVMS VAX all OVR/REL/GBL psects were automatically exported into the
  951. shareable image's Global Symbol Table.  On OpenVMS AXP you have to tell the
  952. linker that you want this done by means of the PSECT keyword in the
  953. SYMBOL_VECTOR options file statement.
  954.  
  955. This has several advantages over OpenVMS VAX.  First, you don't have to worry 
  956. about the address of the psect when you try to create a new, upwardly 
  957. compatible version of the shareable image. Second, you can control which
  958. psects, if any, are made visible outside the shareable image.
  959.  
  960. By default, COMMON PSECTs in DEC Fortran for OpenVMS AXP (as well as most
  961. other OpenVMS AXP compilers) are NOSHR.  On VAX, the default was SHR which
  962. required you to change the attribute to NOSHR if you wanted your COMMON
  963. to be in a shareable image but not write-shared by all processes on the
  964. system.  If you do want write-sharing, use: 
  965.     CDEC$ PSECT common-name=SHR
  966. in the Fortran source code (the CDEC$ must be begin in column 1) or a linker 
  967. options file PSECT_ATTR statement to set the COMMON PSECT attribute to SHR.
  968.  
  969. For further information, see the Linker manual.
  970.  
  971. ------------------------------------------------------------
  972. PROG8.  How do I convert between IEEE and VAX floating data?
  973.  
  974. In OpenVMS V6.1 there is a routine CVT$CONVERT_FLOAT, documented in the
  975. LIB$ Run-Time Library Reference Manual, which can perform conversions
  976. between any two of the following floating datatypes: VAX (F,D,G,H),
  977. little-endian IEEE (single, double, quad), big-endian IEEE (single, double,
  978. quad), CRAY and IBM System\370.
  979.  
  980. DEC Fortran (all platforms) has a feature which will perform automatic
  981. conversion of unformatted data during input or output.  See the DEC Fortran
  982. documentation for information on "non-native data in I/O" and the
  983. CONVERT= OPEN statement keyword.
  984.  
  985. ------------------------------------------------------------
  986. PROG9.  How do I get the argument count in a Fortran routine?
  987.  
  988. On VAX, many programmers would use a MACRO routine which accessed the
  989. AP register of the caller to get the address of the argument list and
  990. hence the argument count.  This was not guaranteed to work on VAX, but
  991. usually did.  However, it doesn't work at all on OpenVMS AXP, as there
  992. is no AP register.  On Alpha systems, you must use a language's built-in
  993. function to retrieve the argument count, if any.  In Fortran this is
  994. IARGCOUNT, which is also available in DEC Fortran on OpenVMS VAX.
  995.  
  996. Note that omitting arguments to Fortran routines is non-standard and is
  997. unsupported.  It will work in many cases - read the DEC Fortran release
  998. notes for additional information.
  999.  
  1000. ------------------------------------------------------------
  1001. DECW1.  How do I let someone else display something on my workstation?
  1002.  
  1003. On a workstation, you go into "Customize" menu of the session manager utility
  1004. and select "Security".  When the pop-up box appears, you can put
  1005. node/user/tranport to allow who can launch an application to the display on
  1006. that workstation.
  1007.                     [raspuzzi@mrlat.enet.dec.com]
  1008.  
  1009. > Yah, but this doesn't seem to work with non-VMS systems.  What do I put in 
  1010. > for the transport?  I tried "TCPIP" just for kicks, but it didn't work.
  1011.  
  1012.         You need a checklist of sorts:
  1013.  
  1014.       1) Make sure  that  you've  specified  the X-windows "display"
  1015.          correctly  on  the remote side.  For DECNET it's  something
  1016.          like NODE::0.0, for TCP/IP it's Node.Domain:0.0, etc.  On a
  1017.          unix system, define the DISPLAY environment variable so:
  1018.  
  1019.         # setenv DISPLAY myvax.domain:0.0
  1020.  
  1021.       2) If you've verified 1) and things still aren't working, make
  1022.          sure the Security settings on  the  VMS side will allow the
  1023.          connection:  Pull  down the "Options" menu in  the  Session
  1024.          Manager, select "Security..."  near  the  bottom.   If  you
  1025.          don't  find  your  host  (and  username) listed on the left
  1026.          under "Authorized Users", go to the  right side of the menu
  1027.          and   fill   in  the  three  fields,  "Node",   "Username",
  1028.          "Transport".  Then click on the Add botton, then the  Apply
  1029.          and  OK  buttons  to  add  the  new  host  to  the security
  1030.          database.
  1031.  
  1032.           a) There are  various  transports: LOCAL, DECNET, LAT,
  1033.              TCPIP,  etc.   Select  the one appropriate  to  the
  1034.              client machine's connection to the VMS machine.
  1035.  
  1036.       b) If the connection is DECNET, do *NOT* add :: to the
  1037.              node name!
  1038.  
  1039.           c) If the connection is TCPIP, "Username" _must_ be an
  1040.              asterisk (*) because the  TCP/IP protocol used does
  1041.              not provide the remote username.
  1042.  
  1043.           d) If the connection is TCPIP, it's best to use a full
  1044.              domain name, e.g.,  Node.Subd.Domain.  However, you
  1045.              _may_  have  to use the IP address  itself,  rather
  1046.              than  the  domain  name  (EWS  requires  this).   I
  1047.              generally  add two entries for each TPCIP host, the
  1048.              first using the  domain  name,  the  second  the IP
  1049.              address.
  1050.  
  1051.           e) There are a  various  3rd  party vendors who supply
  1052.              TCP/IP  packages for VMS, including but not limited
  1053.              to  TGV  (Multinet)  and  Wollongong  (Pathway  ?).
  1054.              Multinet  (and  DEC's  own  UCX) call the transport
  1055.              "TCPIP", Wollongong, at least in some incarnations,
  1056.              uses "WINTCP".  You need to use the appropriate
  1057.              vendor's package transport name  in the "Transport"
  1058.              field.
  1059.  
  1060.       3) If things _still_  aren't  working, make sure the transport
  1061.          you  want  has  been activated for DECwindows.  This  is  a
  1062.          system manager job, but you can do the ground work yourself
  1063.          before bothering the sysmgr.  Do the following:
  1064.  
  1065.         $ DIR SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM
  1066.  
  1067.          If that file exists, then do:
  1068.  
  1069.         $ SEARCH SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM -
  1070.             $_    DECW$SERVER_TRANSPORTS
  1071.  
  1072.          You sould find something like:
  1073.  
  1074.         $ decw$server_transports == "DECNET,LOCAL,LAT,TCPIP"
  1075.  
  1076.          If the transport you want,  e.g., TCPIP, isn't listed, have
  1077.          your  system  manager  make  the  appropriate  changes  and
  1078.          restart DECwindows.  If the file doesn't exist, the  sysmgr
  1079.          will  have  to  create  it  by  copying  the  corresponding
  1080.          .TEMPLATE file  to  .COM  and  uncommenting  the  line that
  1081.          defines decw$server_transports.
  1082.  
  1083.           a) If you're wanting  to  use  TCP/IP to connect, make
  1084.              sure  TCP/IP is available on the VMS host.   TCP/IP
  1085.              is _not_ native to VMS.  You  need  to  be  running
  1086.              either Digital's UCX or a 3rd party vendor's TCP/IP
  1087.              product.   If  you're  not,  none of the above will
  1088.              help.
  1089.                     [Fairfield@Slac.Stanford.Edu]
  1090.  
  1091. There is a log file created in SYS$MANAGER which tells you which transports
  1092. are loaded, and also tell you what connect attempts were rejected, including
  1093. showing what the presented credentials were.  This file is
  1094. SYS$MANAGER:DECW$SERVER_0_ERROR.LOG, although the 0 could be another number if
  1095. you have multiple servers on the workstation.  I have found this file to be
  1096. very useful for tracking down what needs to be put in the Session Manager
  1097. Security entries.
  1098.                     [rabinowitz@bear.com]
  1099.  
  1100. ------------------------------------------------------------
  1101. DECW2.  How do I create a display on another workstation?
  1102.  
  1103. $ SET DISPLAY /CREATE /TRANSPORT=net_transport /NODE=remote_node
  1104.  
  1105. for LAT the command might look like this:
  1106.  
  1107. $ SET DISPLAY /CREATE /TRANSPORT=LAT /NODE=REMOTE_NODE
  1108.  
  1109. for DECnet:
  1110.  
  1111. $ SET DISPLAY /CREATE /TRANSPORT=DECNET /NODE=NODE
  1112.  
  1113. for TCP/IP
  1114.  
  1115. $ SET DISPLAY /CREATE /TRANSPORT=TCPIP /NODE=128.12.4.122
  1116.  
  1117. Note that LAT is typically used for X terminals but can be used from
  1118. OpenVMS to OpenVMS systems on OpenVMS AXP V6.1 (if you have setup the X
  1119. server to allow the LAT transport - check the docs).  LAT will be supported
  1120. on OpenVMS VAX as a transport for DECwindows in a future OpenVMS VAX
  1121. release.
  1122.                     [raspuzzi@mrlat.enet.dec.com]
  1123.  
  1124. ------------------------------------------------------------
  1125. DECW3.  How can I get the information from SHOW DISPLAY into a symbol?
  1126.  
  1127. Use the undocumented SHOW DISPLAY/SYMBOL, and then reference the symbols
  1128. DECW$DISPLAY_NODE,  DECW$DISPLAY_SCREEN, DECW$DISPLAY_SERVER and/or
  1129. DECW$DISPLAY_TRANSPORT.
  1130.                     [Fairfield@Slac.Stanford.Edu]
  1131.  
  1132. ------------------------------------------------------------
  1133. DECW4.  How do I get a log of a DECterm session?
  1134.  
  1135. If you are working from a Decterm, you can use the AutoPrint feature. Choose
  1136. the "Printer..." menu item from the "Options" menu, set the printing
  1137. destination to the name of the file you want, and set "Auto Print Mode".
  1138. You are now free to continue.
  1139.  
  1140. It should be noted that ALL the characters and escape sequences are captured,
  1141. but if you display the log file on a DECterm you will get EXACTLY what you had.
  1142.                     [fenster@star.enet.dec.com]
  1143.  
  1144. ------------------------------------------------------------
  1145. DECW5.  Problem - the DELETE key deletes forward instead of backward!
  1146.  
  1147. This has to do with Motif's virtual bindings.  When a Motif application starts
  1148. up, it looks at the vendor string returned in the display connection
  1149. information and attempts to match the string to a table of virtual bindings.
  1150.  
  1151. You can override the default bindings in your decw$xdefaults.dat file. Here is
  1152. the entry you would make to get the default VMS bindings.
  1153.     
  1154. *defaultVirtualBindings:\
  1155.  osfCancel    :        <Key>F11    \n\
  1156.  osfLeft    :        <Key>Left    \n\
  1157.  osfUp        :        <Key>Up        \n\
  1158.  osfRight    :        <Key>Right    \n\
  1159.  osfDown    :        <Key>Down    \n\
  1160.  osfEndLine    :Alt        <Key>Right    \n\
  1161.  osfBeginLine    :Alt        <Key>Left    \n\
  1162.  osfPageUp    :        <Key>Prior    \n\
  1163.  osfPageDown    :        <Key>Next    \n\
  1164.  osfDelete    :Shift        <Key>Delete    \n\
  1165.  osfUndo    :Alt        <Key>Delete    \n\
  1166.  osfBackSpace    :        <Key>Delete    \n\
  1167.  osfAddMode    :Shift        <Key>F8        \n\
  1168.  osfHelp    :        <Key>Help    \n\
  1169.  osfMenu    :        <Key>F4        \n\
  1170.  osfMenuBar    :        <Key>F10    \n\
  1171.  osfSelect    :        <Key>Select    \n\
  1172.  osfActivate    :        <Key>KP_Enter    \n\
  1173.  osfCopy    :Shift        <Key>DRemove    \n\
  1174.  osfCut        :        <Key>DRemove    \n\
  1175.  osfPaste    :        <Key>Insert
  1176.  
  1177. To merge:
  1178.  
  1179.     $ xrdb :== $decw$utils:xrdb.exe
  1180.     $ xrdb -nocpp -merge decw$xdefaults.dat
  1181.                     [kleinsorge@star.enet.dec.com]
  1182.  
  1183. ------------------------------------------------------------
  1184. DECW6.  Problem - On a DEC2000-300, Motif doesn't start
  1185.  
  1186. Check for a GQ device by doing a SHOW DEVICE G at the DCL prompt.  If there is
  1187. no GQA0 device:
  1188.  
  1189. a) VMS failed to find the appropriate IRQ information for the Compaq QVision
  1190.    and did not autoconfigure it.  Run the correct ECU (for OSF and VMS) and
  1191.    reboot.
  1192.  
  1193. b) You do not have a Compaq QVision video card.  This card should have Compaq
  1194.    printed on it, and identifies itself as a CPQ3011 or a CPQ3111.  If it is 
  1195.    not one of these 2 devices (as of 7/1/94 and version 6.1) then VMS does not
  1196.    support it.
  1197.  
  1198. If there is a GQA0 device:
  1199.  
  1200. a) There may have been a severe error in the DECwindows startup. Type the
  1201.    contents of SYS$MANAGER:DECW$SERVER_0_ERROR.LOG for any information on
  1202.    errors starting the server.
  1203.  
  1204. b) The sysgen parameter WINDOW_SYSTEM is not set to 1.  This is a common way
  1205.    used by system managers to disable server startup.
  1206.  
  1207. c) You may not have a valid Motif license.    To check for the Motif license,
  1208.    type LICENSE LIST DW-MOTIF/FULL and examine the information displayed.
  1209.    Make sure that it is present, valid and active.
  1210.                     [kleinsorge@star.enet.dec.com]
  1211.  
  1212. ------------------------------------------------------------
  1213. DECW7.  Problem - My LK401 keyboard unexpectedly autorepeats
  1214.  
  1215. There are several modes of failure:
  1216.  
  1217. a) Pressing 2 and 3 keys at the same time causes one key to autorepeat when
  1218.    released.  Check the hardware revision level printed on the bottom of the
  1219.    keyboard.  If the revision level is C01, the keyboard firmware is broken. 
  1220.    Call field service to replace the keyboard with any revision level other 
  1221.    than C01.
  1222.  
  1223. b) Pressing certain keys is always broken.  Typical sympypoms are: delete 
  1224.    always causes a autorepeat, return needs to be pressed twice, etc.  This is
  1225.    frequently caused by having keys depressed while the keyboard is being
  1226.    initialized.  Pressing ^F2 several times or unplugging and replugging the
  1227.    keyboard frequently fix this problem.  There is a patch available to fix 
  1228.    this problem [contact the CSC for information - a CSCPAT number will be 
  1229.    included here when available. - Ed.]
  1230.  
  1231. c) A key that was working spontaneously stops working correctly. This may be
  1232.    either (a) or (b) or it may be bad firmware.  Ensure that you have the most
  1233.    recent firmware installed on your CPU.  An old version of the DEC 3000 
  1234.    firmware had a bug that could cause this symptom.
  1235.                     [kleinsorge@star.enet.dec.com]
  1236.  
  1237. ------------------------------------------------------------
  1238. DECW8.  Problem - My LK411 sends the wrong keycodes or some keys are dead
  1239.  
  1240. Check the firmware revision on the keyboard.  Hardware revision B01 introduced
  1241. an incompatability with the device driver which causes the keyboard to not be
  1242. recognized correctly.  There is a patch available to fix this problem:
  1243. [CSCPAT number TBS - Ed.].  The rev A01 keyboard, and the LK450 should work 
  1244. without problems.
  1245.                     [kleinsorge@star.enet.dec.com]
  1246.  
  1247. ------------------------------------------------------------
  1248. DECW9.  How do I set the title on a DECterm window?
  1249.  
  1250. If you are creating a new DECterm window, check 
  1251. HELP CREATE /TERMINAL /WINDOW_ATTRIBUTES.
  1252.  
  1253. If you want to change the title of an existing window, use the following
  1254. control sequences, where <esc> is the ANSI escape code, value decimal 27, and
  1255. <text> is what you want to display:
  1256.  
  1257. To set the DECterm title, send <esc>]21;<text><esc>\
  1258. To set the icon label, send    <esc>]2L;<text><esc>\
  1259.  
  1260. For example, DCL to display "My DECterm" in title bar:
  1261. $ ESC[0,8]=27
  1262. $ WRITE SYS$OUTPUT "``ESC`21;My DECterm``ESC`\"
  1263.                     [p_lee@decus.ch]
  1264.  
  1265. You can also change the title and the icon using the Options-Window...
  1266. menu.
  1267.  
  1268. ------------------------------------------------------------
  1269. SOFT1.  Where can I find lots of free software for OpenVMS?
  1270.  
  1271. The best starting point for free software for OpenVMS is Hunter Goatley's
  1272. WKU FILESERV server.  If you're using a WWW browser, the URL is:
  1273.  
  1274.     http://www.wku.edu/www_root/fileserv/fileserv.html
  1275.  
  1276. The FILESERV packages are also available via anonymous FTP from:
  1277.  
  1278.       ftp.wku.edu, under [.VMS.FILESERV]. 
  1279.       ftp.spc.edu, under [.MACRO32.SAVESETS] and [.MX]. 
  1280.       ftp.vms.stacken.kth.se, under [.WKU.VMS.FILESERV]. 
  1281.       ftp.shsu.edu, under pub/vms/mx and pub/vms/utilities. 
  1282.       nic.switch.ch, under /mirror/vms/spc. 
  1283.       ftp.technion.ac.il, under /pub/unsupported/vms/spc. 
  1284.       ftp.riken.go.jp 
  1285.  
  1286. or via e-mail from FILESERV@WKUVX1.WKU.EDU. Send the commands HELP and
  1287.    DIR ALL in the body of a mail message for more information.
  1288.  
  1289. If you get the packages via WWW or FTP, they're in ZIP format which requires
  1290. the UNZIP (note: this is not Gnu gunzip!) tool to unpack.  You can get this
  1291. from:
  1292.  
  1293.     ftp://ftp.wku.edu/vms/unzip.exe        ! VAX
  1294.     ftp://ftp.wku.edu/vms/unzip.alpha_exe  ! AXP
  1295.  
  1296. or you can request the FILESERV_TOOLS package from the e-mail server.
  1297.  
  1298. Mosaic 2.1 is available here, but there's also a VMS port of Mosaic 2.4
  1299. available at file://ftp.service.digital.com/pub/vms/Mosaic which was
  1300. built for use with DEC TCP/IP Services for OpenVMS (UCX) V3.0 or V3.1.
  1301. Some people have reported success using this with "UCX emulation" on other
  1302. TCP/IP implementations.
  1303.  
  1304. Another source of free software is the vmsnet.sources newsgroup (and the
  1305. corresponding vmsnet.sources.d discussion group).  See the monthly posting
  1306. "vmsnet.sources archives" for a list of sites which archive submissions
  1307. to vmsnet.sources.
  1308.                 [lionel@quark.enet.dec.com]
  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 orders is 508 841 3502. Lots of good stuff from lots of good
  1320. folks, and copies on media (tapes, CDs) are cheap.
  1321.                 [Everhart@Arisia.gce.com]
  1322.  
  1323. The sources for ZMODEM from the DECUS CD Rom are at:
  1324.   ftp://ftp.infonet.net/pub/systems/vms/zmodem
  1325.                 [kevin@ins.infonet.net]
  1326. There's also ftp://ftp.cdrom.com/.2/simtel/misc/vaxvms/ZMODEM17.ZIP
  1327.                 [csjwp@ttuhsc.edu]
  1328.  
  1329. The links described below were current at one time; your guess is as good as
  1330. mine if they're still valid. ;-) 
  1331.  
  1332.    MPJZ's Hyper-Software-List for OpenVMS is Martin P.J. Zinser's list of 
  1333.    additional software.  
  1334.     http://axp616.gsi.de:8080/www/vms/sw.html
  1335.  
  1336.    Chris Higgins's VMS Software List II 
  1337.     http://csvax1.ucc.ie/www/vms_sw_list/sw_list.html
  1338.  
  1339.    DECUS SIG Tape collections are available on Mark Berryman's system, 
  1340.     ftp://mvb.saic.com 
  1341.  
  1342.    David Jones's DECthreads-based HTTP_SERVER World-Wide Web server for VMS. 
  1343.     http://kcgl1.eng.ohio-state.edu/www/doc/serverinfo.html
  1344.  
  1345.                         [goathunter@WKUVX1.WKU.EDU]
  1346.  
  1347. Lynx (a character-cell World-Wide-Web reader) is available from
  1348. ftp://ftp2.cc.ukans.edu/pub/lynx
  1349.                         [lionel@quark.enet.dec.com]
  1350.  
  1351. An archive of DECwindows and Xwindows software can be found at
  1352. ftp://axp.psl.ku.dk/decwindows
  1353.                         [Lejf@axp.psl.ku.dk]
  1354.  
  1355. ImageMagick is an X11 package for display and interactive
  1356. manipulation of images.  The package includes tools for
  1357. image conversion, annotation, compositing, animation, and
  1358. creating montages.  ImageMagick can read and write many of
  1359. the more popular image formats (e.g. JPEG, TIFF, PNM, XPM,
  1360. Photo CD, etc.). ftp://ftp.x.org/contrib/vms/ImageMagick/ImageMagick-3.3.zip
  1361.                         [cristy@dupont.com]
  1362.  
  1363. BULLETIN, GHOSTSCRIPT, GHOSTVIEW and XV are available from
  1364. ftp://pfc.mit.edu/
  1365.  
  1366. [End of FAQ]
  1367.  
  1368.