home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #27 / NN_1992_27.iso / spool / comp / os / vms / 18327 < prev    next >
Encoding:
Internet Message Format  |  1992-11-22  |  7.9 KB

  1. Path: sparky!uunet!europa.asd.contel.com!emory!swrinde!elroy.jpl.nasa.gov!nntp-server.caltech.edu!SOL1.GPS.CALTECH.EDU!CARL
  2. From: carl@SOL1.GPS.CALTECH.EDU (Carl J Lydick)
  3. Newsgroups: comp.os.vms
  4. Subject: Guidelines for posting questions to comp.os.vms/info-vax
  5. Date: 22 Nov 1992 18:57:02 GMT
  6. Organization: HST Wide Field/Planetary Camera
  7. Lines: 112
  8. Distribution: world
  9. Message-ID: <1eol5uINNsrs@gap.caltech.edu>
  10. Reply-To: carl@SOL1.GPS.CALTECH.EDU
  11. NNTP-Posting-Host: sol1.gps.caltech.edu
  12.  
  13. I'm proposing the following guidelines for posting questions to this group. 
  14. One would hope that everything I mention below would be obvious to anybody
  15. about to post a question, but that's far to seldom the case (especially in the
  16. period from September through November).  I welcome comments and suggestions
  17. for improving the guidelines.  Responses from Jerry, Jamie, and (shudder) Ehud
  18. (please, Ehud:  Don't turn the temperature up TOO high) would be especially
  19. welcome.
  20.  
  21. The following guidelines for posting  questions  to  COMP.OS.VMS/INFO-VAX  are
  22. intended  to help querants post their questions in such fashion as to maximize
  23. the probability that they'll receive quick, useful responses, and to  minimize
  24. he probability that the questions will annoy the people most likely to be able
  25. to give useful responses.
  26.  
  27. Chances are, before you'll actually get a useful response  to  your  question,
  28. you'll have to conform to these guidelines anyway, so you might as well try to
  29. do so in your original question instead  of  wasting  several  days  and  some
  30. network bandwidth clarifying your question.
  31.  
  32. Perhaps the most important thing to remember is:  You've run into  a  problem,
  33. and haven't been able to figure out how to solve it.  One possible explanation
  34. for this is that you're going about it the wrong way.  Therefore,  asking  for
  35. help  solving  a minor problem in what you think is a "solution" to your major
  36. problem may do you no good whatever.  So in general, there are two things  you
  37. ABSOLUTELY need to tell us if you want help:
  38.  
  39. 1)  How we can get in touch with you to answer your question;
  40. 2)  What you are trying to accomplish;
  41.  
  42. Now, for the specific guidelines I propose:
  43.  
  44. 1)  First and foremost, if you want us to e-mail  responses  to  you  (and  in
  45.     general,  I'd recommend that you actually read this group; there really IS
  46.     a lot of useful stuff you can pick  up  that  way),  please  include  your
  47.     e-mail  address  (including  a fully-qualified domain name) in the body of
  48.     your  message.   The  news/mail  gateway  mangles  addresses.    In   both
  49.     directions (well, actually, I think it's UUNET.UU.NET that tends to mangle
  50.     addresses coming in via mail).  If you really  need  to  have  a  response
  51.     mailed to you, the only way you can guarantee that we'll be able to figure
  52.     out how to do that is if you give us your e-mail address.
  53. 2)  If your question is about a VMS utility that doesn't do what  you  expect,
  54.     include in your question:
  55.     A)  The command you used that generated the "improper" response;
  56.     B)  A description of what you  thought  the  system's  response  should've
  57.         been.   A question of the form "X doesn't work properly.  How do I fix
  58.         that?" is unanswerable.  We have to know HOW X doesn't work  properly.
  59.         Sometimes  the  answer  will  be "X isn't supposed to do that.  You've
  60.         misunderstood the documentation.  To get the response you want, use  Y
  61.         instead."  But  we  can't help you unless we know what it was you were
  62.         trying to accomplish."
  63.     C)  The FULL error message (if any) given to you by  VMS.   VMS  is  *NOT*
  64.         unix.   VMS  error  messages  usually  contain LOTS of information for
  65.         those who understand them.  But we need the FULL  text  of  the  error
  66.         message, exactly as VMS gave it to you.  Vague mention of the message,
  67.         like "it said I didn't have enough memory" is useless.  The actual VMS
  68.         error message, for example, in a case like this example, would usually
  69.         have told us WHAT KIND of memory you ran out of.  So  please,  VMS  is
  70.         trying  to help you find the problem; do us the same favor and give us
  71.         all the information VMS gave you.
  72.     D)  The version number  of  all  relevent  software.   Oddly  enough,  the
  73.         version  numbers  aren't  just  time  stamps.   Things actually change
  74.         between versions of software.  Bugs in one version might not  show  up
  75.         in  other  versions.   So  if you have actually stumbled across a bug,
  76.         please let us know what version of the software you're running, so  we
  77.         can decide whether we might be able to help you.
  78.     E)  Complete  descriptions  (output  of  ANALYZE/RMS/FDL  would   ususally
  79.         suffice) of any of your files involved in the problem;
  80.     F)  If it appears to be a problem with SYSGEN parameters, let us know what
  81.         your  SYSGEN  parameters  currently  are.   Some SYSGEN parameters are
  82.         interrelated.  Since you haven't been able  to  diagnose  the  problem
  83.         yourself,  don't  be  too  sure  that you're even looking in the right
  84.         place.  Again:  Give us all the information that might be necessary to
  85.         solving  the  problem.   Don't  just give us the SYSGEN parameters you
  86.         THINK are causing the problem.  Give us ALL the SYSGEN parameters that
  87.         MIGHT POSSIBLY have an effect on the problem.
  88. 3)  If your problem is that some user-written code doesn't do what you expect,
  89.     then  don't  try  translating  from C (or PASCAL, or FORTRAN, or BASIC...)
  90.     into  English.   Believe  it  or  not,  most  of  us  who  participate  in
  91.     COMP.OS.VMS  actually  understand  one  or more programming languages, and
  92.     some of us even have compilers that we can use.  Furthermore, 99%  of  the
  93.     "compiler  bugs"  people find aren't compiler bugs at all:  they're poorly
  94.     written application code.  By the time you've converted your code into  an
  95.     English  description, you've almost certainly glossed over whatever it was
  96.     that was REALLY causing the problem (once again:  If you knew enough about
  97.     the  real  problem  that  you'd  think  it important to mention it in your
  98.     English-language description, you'd probably also know how  to  solve  the
  99.     problem).   So  don't do us the favor of "summarizing" your problem.  When
  100.     you do that, the problem itself usually gets summarized out of  existence.
  101.     Instead,  find  the  code  that's  causing the problem.  If it's something
  102.     huge, try to find a simpler version of the same sort of code that  creates
  103.     the  same  problem.  Keep working at it until you've got a program of less
  104.     than 100 lines of code that produces the problem, or until you can't  find
  105.     a simpler example that demonstrates the problem.  Strangely enough, by the
  106.     time you've done this, you'll have found the problem  yourself  more  than
  107.     half the time.  And if you HAVEN'T done this, chances are that nobody else
  108.     will be able to figure out what you're talking about enough to  help  with
  109.     your problem.
  110.  
  111.     If, once you've reduced the problem to the simplest example you  can,  you
  112.     still can't figure out what's going wrong, then post the code, the version
  113.     number of the compiler, complete descriptions of any  of  your  own  files
  114.     that  seem  to be related to the problem, and, as always, a description of
  115.     what you think your code SHOULD do, to us, and  you'll  likely  receive  a
  116.     prompt and useful answer.
  117. --------------------------------------------------------------------------------
  118. Carl J Lydick | INTERnet: CARL@SOL1.GPS.CALTECH.EDU | NSI/HEPnet: SOL1::CARL
  119.  
  120. Disclaimer:  Hey, I understand VAXen and VMS.  That's what I get paid for.  My
  121. understanding of astronomy is purely at the amateur level (or below).  So
  122. unless what I'm saying is directly related to VAX/VMS, don't hold me or my
  123. organization responsible for it.  If it IS related to VAX/VMS, you can try to
  124. hold me responsible for it, but my organization had nothing to do with it.
  125.