home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / newsletter / 1992 / w1992-03.txt < prev    next >
Text File  |  1994-04-12  |  21KB  |  524 lines

  1.  
  2.         What's Up DOCumentation
  3.  
  4.  
  5.  
  6.        Robelle Consulting Ltd.
  7.        Unit 201, 15399-102A Ave.
  8.        Surrey, B.C.  Canada  V3R 7K1
  9.        Phone:  (604) 582-1700
  10.        Fax:  (604) 582-1799
  11.  
  12. Date:  July 17, 1992
  13.  
  14. From:  Robert M. Green, CEO
  15.        David J. Greer, President
  16.        Michael Shumko, Customer Support
  17.  
  18. To:    Users of Robelle Software
  19.  
  20. Re:    News of the HP 3000, 1992 #3
  21.  
  22.      What You Will Find in This News Memo:
  23.  
  24.        News Tidbits
  25.        Suprtool/XL version 3.4 Doubles Sort Speed!
  26.        Technical Tips
  27.        About Robelle
  28.        New Orleans Calendar of Events
  29.        The Warning Signs
  30.        A Pop Quiz on Quality
  31.        Logon Command Files
  32.        Robelle Products:  Problems, Solutions, and Suggestions
  33.  
  34.  
  35.  
  36.                                  News Tidbits
  37.  
  38. Shared X-Windows Applications. At the BWRUG vendor show,
  39.  
  40. HP demonstrated what they called Groupware - software  that  allows  users  at
  41. multiple  workstations  to  share  the  same  data files.  The demo showed two
  42. X-terminals sharing the same application,  with  the  two  users  interacting.
  43. Anything  that  was  done on one screen was seen on the other screen, and vice
  44. versa.  This will permit users working in different offices, or even different
  45. cities,  to  work  together  on a project.  Sounds like HP's vision of 1995 is
  46. well underway.
  47.  
  48. Bull Picks Big Blue.
  49.  
  50. Groupe Bull, the troubled French computer maker, announced that it had  chosen
  51. IBM's  Power  Architecture  over  HP PA-RISC.  IBM, HP, Motorola and MIPS have
  52. each been courting computer systems vendors to get them to  adopt  their  RISC
  53. chips.  IBM and HP waged a tough battle to win Bull's favor, but the deal came
  54. down to cash and resources. In the end, IBM gave Bull  a  stronger  commitment
  55. than  HP.  "HP saw the deal as a risk, a potential black hole. IBM saw it as a
  56. chance for significant market penetration," said Bob Herwick, an analyst  with
  57. the securities firm of Hambrecht and Quist.  [from UnixWorld]
  58.  
  59. Australian Airline Regulations.
  60.  
  61. The  original  Macintosh  Portable weighs 6.5 kg with an empty hard drive.  In
  62. order to stay within airline cabin baggage, Apple recommends keeping the  hard
  63. drive not more than half-full.  [Australian MacWorld]
  64.  
  65.                  Suprtool/XL version 3.4 Doubles Sort Speed!
  66.  
  67.  
  68. Every spring, Robelle Consulting releases a new version of  Suprtool,  the  HP
  69. 3000  utility  program  that  provides  speedy  access to your data.  Suprtool
  70. typically lets you access  your  data  from  two  to  ten  times  faster  than
  71. traditional  tools,  combining  the  features  of Query, Sort and Fcopy.  This
  72. year's release includes numerous enhancements, not the least  of  which  is  a
  73. doubling of sort speed in the Native-Mode version.
  74.  
  75. The improvements for 1992 include:
  76.  
  77.   * Faster Sorting on MPE XL
  78.  
  79.     Suprtool/XL  sorts records twice as fast as last year's version, using our
  80.     proprietary  sorting  algorithms.   Previous  versions  called  HP's  sort
  81.     intrinsics.
  82.  
  83.   * Simple Reports Made Easy
  84.  
  85.     The  List command, which is used to produce formatted record displays, now
  86.     supports sub-headings and a new option for producing simple reports.   The
  87.     reporting  options  include  page  numbers,  titles,  column headings, and
  88.     LaserJet capabilities such as Landscape and Duplex mode.
  89.  
  90.   * On-line Tutorial to Learn About New Features
  91.  
  92.     An on-line tutorial is now included for first-time Suprtool users, or  old
  93.     friends  who  want  to  catch  up on the latest features.  The tutorial is
  94.     constructed using the new Q and Userpause commands to display comments and
  95.     wait for the user to press return before continuing.
  96.  
  97.   * New Commands, Options, Features
  98.  
  99.     Other  changes  include  two new commands for working with use-files, more
  100.     support  for  packed-decimal  (comp-3)  fields  in  the  Table  and  Chain
  101.     commands,  a  Quiet option on the Use command, and tighter syntax checking
  102.     of the Output, Sort and Use commands.
  103.  
  104.   * New and Improved Bonus Programs
  105.  
  106.     Suprtool includes a number of bonus programs at no extra cost.   HowMessy,
  107.     which  reports  on  internal  database  efficiency,  is  now  available in
  108.     Native-Mode, and displays the highwater mark of detail datasets.  The  new
  109.     Spell  is  an  English-language  spelling  checker  for  your  letters and
  110.     documentation.  The Prose text-formatter is now in Native-Mode.
  111.  
  112. A complete description of these and all the new  features  is  in  the  change
  113. notice  which accompanies update tapes.  All Suprtool users on support receive
  114. an update automatically.  The update tape contains the latest  manuals,  which
  115. can  be  printed  on your own printers using our Printdoc utility.  The entire
  116. manual is available in the on-line help, too.
  117.  
  118. If you are  a  Suprtool  user  but  your  service  has  lapsed,  don't  worry.
  119. Robelle's  reasonable  pricing policy lets you get back on support without any
  120. penalty, just by paying the current support fee.  This  entitles  you  to  the
  121. latest  version,  technical  support  for a year, and our famous What's Up Doc
  122. newsletter.
  123.  
  124. If you aren't a Suprtool user, find out what you're missing.  Demo  tapes  are
  125. free.
  126.  
  127.  
  128.                                 Technical Tips
  129.  
  130. Scary Error Messages.
  131.  
  132. If you start running out of disc space, MPE XL can report bogus,  scary  error
  133. messages.   For  example,  Steve Hammond at AAMC did a /TEXT of a spoolfile in
  134. Qedit, and got the error messages FWRITED ERROR 96 and DISC  I/O  ERROR.   For
  135. some  reason,  this  worried Steve.  Further investigation revealed that there
  136. was nothing wrong with his disc drive.  In fact, he wasn't even  out  of  disc
  137. space  -  he had plenty of free space.  It turned out that the account was out
  138. of disc space.  That is, there was a  limit  on  the  number  of  sectors  the
  139. account could occupy, and when he tried to exceed that limit, MPE mis-reported
  140. the error in a particularly worrisome way.
  141.  
  142.  
  143.                                 About Robelle
  144.  
  145. Welcome Facer Information Design.
  146.  
  147. We recently transferred the Australian and New Zealand territories from Co-Cam
  148. to Facer Information Design.  Laurie Facer is  now  in  charge  of  sales  and
  149. support for Australia and New Zealand, bringing his expertise with the HP 3000
  150. and the Australian market to Robelle.  Welcome aboard Laurie, we wish you  the
  151. very best of luck with your new enterprise.
  152.  
  153. Welcome Neil Armstrong!  Say hello to our first astronaut/Robellian.
  154.  
  155. Neil  is the newest addition to our technical support team and has had lots of
  156. experience with our products while working for Domtar,  Gilles  Schipper,  and
  157. Leach  & Garner.  He and his wife, Alyson, have made the big move from Toronto
  158. to Vancouver with their two boys, Nathan (21 months)  and  Conner  (1  month).
  159. Neil  was  born  on Friday the 13th, which may explain his sense of humor that
  160. only a select few can understand.  We're glad to have you here, Neil!
  161.  
  162. Bob Green Goes Green.
  163.  
  164. The Suprtool 3.4 manual was printed on paper made from recycled stock.  Future
  165. Robelle manuals will also be printed on recycled paper.
  166.  
  167.  
  168.                         New Orleans Calendar of Events
  169.  
  170.    Robelle has a full roster at the  Interex  conference  in  New  Orleans,
  171.    being  held  August 24-27.  Bob Green, David Greer and Ken Robertson are
  172.    all presenting papers.  Bob, David,  and  Mike  Shumko  will  be  giving
  173.    product  tutorials  to  help  you  brush  up  on your Qedit and Suprtool
  174.    skills.  Look for your Robelle information packets in the mail in a  few
  175.    weeks.
  176.  
  177.    Monday, 24 August
  178.       11:00 - 11:50  How Developers Can Adopt Self-Describing Files, David
  179.    Greer
  180.       20:00 - 23:00  Robelle Customer Appreciation Party, Grand Ballroom A
  181.  
  182.    Tuesday, 25 August
  183.       10:00 - 10:50  The Warning Signs: A Pop Quiz on Quality, Bob Green
  184.       11:00 - 11:50  Ten Essential Qedit Skills, Mike Shumko
  185.       14:00 - 15:50  Qedit Problem-Solving with the Developer, Bob Green
  186.  
  187.    Wednesday, 26 August
  188.       11:00 - 11:50  Learn Ten Essential Suprtool Skills, Mike Shumko
  189.       14:00 - 15:50  Suprtool Performance with the Developer, David Greer
  190.  
  191.    Thursday, 27 August
  192.       09:00 - 10:50  LaserJet Lustre: Making Your HP 3000 Reports Shine,
  193.    Robertson
  194. &f0S*p+0x-1215Y&f0S*p+4a+4B*c1950a1215b10g2P&f1S
  195. *c1950a4B*c0P*c4a1215B*c0P*p+1950X*c0P
  196. *p-1950x+1215Y*c1954a4B*c0P
  197. *p+25X*c1950a25B*c40g2P*p-1215y-25X*p+25y+1950X
  198. *c25a1215B*c2P&f1S
  199.  
  200.  
  201.                               The Warning Signs
  202.  
  203.                             A Pop Quiz on Quality
  204.  
  205.                        by Robert Green and David Greer
  206.  
  207. Here is a sneak preview of a talk that I will be presenting at the New Orleans
  208. conference.  Throughout the talk I will give real-life examples of each point.
  209. See how your shop rates.  [Bob Green]
  210.  
  211. I was presenting my paper, Improving Software Quality, before a hometown crowd
  212. in  Vancouver, when a local consultant rose to ask a question.  "Responding to
  213. the users sounds fine," she said, "but I've seen a lot of  systems  where  the
  214. programmers  did  constant changes and patches to give the users whatever they
  215. wanted.  Most of the systems were a buggy, kludgy, impossible mess. How do you
  216. avoid that?"
  217.  
  218. "That's  the  topic  for  another paper," I replied, with a quick tap dance to
  219. distract the audience.  Later, I admitted to myself what a good point she  had
  220. made.
  221.  
  222. Robelle  creates  software tools.  About once a month we release a new version
  223. of Qedit and Suprtool.  We are constantly on  the  go,  so  how  do  we  avoid
  224. producing a disaster?
  225.  
  226. I  went  to my partner David Greer for the answer.  At Robelle I'm the one who
  227. leans toward wild, creative  impulses.   David  is  stronger  on  reliability,
  228. discipline,  and  long-range  thinking.   I  was  so concerned by bureaucratic
  229. software groups which didn't satisfy user needs that I was overlooking another
  230. style  of shop:  groups with weak software skills who react to user complaints
  231. as fire fighting.
  232.  
  233. The ideal software group uses feedback and repeated development cycles to find
  234. out  what  users really need.  But it also uses rigorous software engineering.
  235. Despite the constant changes, the ideal software group ensures  that  existing
  236. features  continue to work and future changes are possible.  My previous paper
  237. on improving software quality was only half the story.  Now David Greer and  I
  238. finish it off.
  239.  
  240. Everyone  is  in  favor  of  software  quality,  but not everyone is producing
  241. quality software.  How can you tell if a  software  group  has  gone  off  the
  242. track? It could be your DP department, your computer manufacturer, or even one
  243. of your software suppliers.
  244.  
  245. Teaching Quality Without "Should" and "Ought"
  246.  
  247.  
  248. To avoid having the talk degenerate into a sermon, we have organized our ideas
  249. into  a non-threatening Pop Quiz -- a way to quietly rate your quality record.
  250. The quiz consists of  giveaway  phrases  that  warn  of  a  troubled  software
  251. project, remarks such as "that's not my job" and "it's against our policy."
  252.  
  253. See  how  many of these phrases you've heard.  Score 5 penalty points for each
  254. one you hear regularly.  We made the penalty 5 points so you  could  fudge  if
  255. you want to.
  256.  
  257.  
  258.      a.  That's a feature, not a bug.
  259.  
  260.      b.  That's an error in the manual.
  261.  
  262.      c.  Why would you want to do that?
  263.  
  264.      d.  If there are no questions, everyone must be happy.
  265.  
  266.      e.  We've lost the source code.
  267.  
  268.      f.  We're too busy to document that.
  269.  
  270.      g.  It must be a hardware problem.
  271.  
  272.      h.  It would cost too much to update the paperwork.
  273.  
  274.      i.  No one will ever notice.
  275.  
  276.      j.  One more Go To won't hurt much.
  277.  
  278.      k.  We'll just reuse this data item.
  279.  
  280.      l.  That could never fail -- don't bother testing for it.
  281.  
  282.      m.  Fascinating project -- too bad it failed.
  283.  
  284.      n.  We tested it once by hand, isn't that enough?
  285.  
  286.      o.  It's fixed, but is waiting for the next release cycle.
  287.  
  288.      p.  It can't be changed, too much code references it.
  289.  
  290.      q.  That would mean changing all the programs.
  291.  
  292.      r.  We gave the users what they asked for.
  293.  
  294. Computing Your Score
  295.  
  296.  
  297. Now  calculate  your  score.   Remember, five points per warning sign, and the
  298. lower the score, the better.
  299.  
  300.      0 is too good. You must have cheated.
  301.  
  302.      20 is excellent.  Congratulations.
  303.  
  304.      40 is respectable.  Good work.
  305.  
  306.      60 is worrying.
  307.  
  308.      80 or more is a disaster.  Update your resume.
  309.  
  310.  
  311.                              Logon Command Files
  312.                            by Christopher Hart, BTS
  313.  
  314. This article is reprinted with the kind permission of  IMRUG  -  Intermountain
  315. Regional Users Group Quarterly Newsletter, March 1992.
  316.  
  317. MPE/XL  (soon  to become MPE/iX) introduced the concept of command files as an
  318. alternative to UDCs.  A command file can do everything that a UDC can,  except
  319. for  a  couple of minor exceptions.  The first is that they cannot be executed
  320. at logon time.  A UDC file can have an OPTION LOGON statement  that  allows  a
  321. command  to  be  executed at logon time.  The second is that the UDC file does
  322. provide a level of security, especially when at the account or system level.
  323.  
  324. With the combination of a simple OPTION LOGON UDC and a command  file,  it  is
  325. possible to give anyone their own custom logon file:
  326.  
  327. Sample UDC file:
  328.  
  329.      start
  330.      option logon
  331.      if finfo("!hpuser.cdmfiles",0) then
  332.         xeq !hpuser.cmdfiles
  333.      endif
  334.      *****
  335.  
  336. The  above  UDC will first test to see if a file that matches your logon is in
  337. the CMDFILES group.  If it does exist, it will be executed by the  UDC.   This
  338. allows  any user who wants a variety of different tasks to be performed, to be
  339. easily set up and modified as needed.  This allows for a single account  level
  340. UDC to service any or every logon in the account.
  341.  
  342. A sample logon command file may look as follows:
  343.  
  344.      setvar hppath "!hpgroup,pub,pub.sys,cdmfiles"
  345.      setjcw glancekey = 2
  346.      xeq allowme,cdmfiles
  347.      setvar hpprompt "!!hpgroup:"
  348.      if hpldevin = 221 then
  349.        setvar hptypeahead true
  350.        echo Type ahead has been turned on for this terminal on ldev 221
  351.      endif
  352.  
  353. The  first thing this command file does is to alter the path command HPPATH to
  354. include the CMDFILES group.  Any command file can then be executed at the  MPE
  355. prompt.   The  second  line  sets up a JCW for a product called HPGLANCE.  The
  356. third line is a command file executing  a  secondary  command  file.   Command
  357. files  can be 15 levels deep, but I wouldn't want to debug one that deep.  The
  358. fourth line changes the : prompt to the name of the current group followed  by
  359. a  :.   If  you  were in the Pub group, the prompt would change to PUB:.  This
  360. allows you to see what group you are in at all times.  The double !! in  front
  361. of  the  HPGROUP  system  variable tells the system to dynamically evaluate it
  362. each time it is referenced.  This means that when you use the CHGROUP command,
  363. the  prompt  will  change  to the current group that you are in.  On the fifth
  364. through eighth lines, I evaluate which logical device I am logged on  to.   In
  365. my work environment, I have a PC on which I use Reflection with its type ahead
  366. used within Reflection, and a secondary HP-700/92 work terminal  that  I  want
  367. the  HPTYPEAHEAD  turned  on.   This  tests to see if I have logged on to that
  368. secondary terminal and if the  LDEV  matches,  it  will  set  the  type  ahead
  369. variable.   It  then echoes to the screen telling me that the terminal now has
  370. type ahead turned on.
  371.  
  372. The logon command file can have most anything you want in  it  local  to  you.
  373. Because  it  is  not a UDC file, it can be updated and changed at any point in
  374. time.
  375.  
  376.  
  377.            Robelle Products:  Problems, Solutions, and Suggestions
  378.  
  379.  
  380. Qedit  Version 4.0
  381.  
  382. Compiling Part of a Quiz Program.
  383.  
  384. Our  dealer in Sweden, Ole Nord, sends us the following UDC.  It allows you to
  385. ZZ-mark part of your file and let Quiz execute only the marked  part  of  your
  386. file.  The same UDC lets you execute a complete file, as usual.
  387.  
  388.      quiz source=$null,info=" ",vers=current
  389.      comment   Specify parameter 1 (source) as:
  390.      comment     <filename> for an mpe file
  391.      comment     *          for currently-open file (qeditscr)
  392.      comment     'zz'       for range set by ZZ command
  393.      comment     '  '       for interactive mode Quiz
  394.      if finfo("!source",0) or ("!source" = "$null") then
  395.        echo Filename !source used as input to Quiz
  396.        file qsource=!source
  397.      else
  398.        echo Range !source saved in Hold file
  399.        /holdq !source
  400.        file qsource=hold
  401.      endif
  402.      setjcw cierror,0
  403.      continue
  404.      setpowerhouse ,!vers
  405.      if cierror = 0 then
  406.        continue
  407.        run quiz.!vers.cognos;info="auto=qsource suspend !info"
  408.      endif
  409.      setpowerhouse true
  410.      ***
  411.  
  412. Detecting a LAN terminal.
  413.  
  414. Qedit's visual mode editing reads and writes  full  screens  of  data  to  the
  415. terminal or PC, in a single, large FREAD or FWRITE.  We are getting reports of
  416. this failing on PCs connected to the HP 3000 via LANs.  If  we  were  able  to
  417. detect  that  the  PC  was  on  a LAN we might be able to do something to work
  418. around the problem.  Does anybody out there know how to detect that the PC  is
  419. on a LAN, maybe using FCONTROL calls?
  420.  
  421. Suprtool  Version 3.4
  422.  
  423. Suprtool Examples.
  424.  
  425. The  Suprtool  manual is full of examples of source code which calls Suprtool2
  426. and Speed Demon.  Of course nobody wants to type those examples from  scratch,
  427. but  we've  learned  that  many  customers  are  doing  exactly that.  This is
  428. error-prone and tedious.  Here's a tip:  the manuals are on your system in the
  429. Doc.Robelle   group.   For  example,  the  Speed  Demon  manual  is  the  file
  430. Demon.Doc.Robelle.  You can use your favorite text editor, Qedit,  to  text  a
  431. copy  of  the  documentation  file  and  extract  the  portions  that  you are
  432. interested in.  The files are stored in Qedit's compressed format, so  if  you
  433. use  another  editor you will have to convert the file to "editor keep" format
  434. first.  Use our Qcopy program to do this.
  435.  
  436.      :run qcopy.qlib.robelle
  437.      >from demon.doc.robelle; to=mysource; new
  438.      >exit
  439.  
  440. Updating Records with Suprtool and Dbedit.
  441.  
  442. There  are times when you need to serially read a big dataset and update a few
  443. selected records.  Suprtool  is  very  fast  at  selecting  the  records,  but
  444. unfortunately  you  can't use Suprtool to update them.  You could use Query to
  445. find and update the records, but it will be very slow.  If  the  entries  that
  446. you  have  selected  are identified by a unique IMAGE key (for example, if you
  447. are serially reading and updating entries in a big master  dataset),  you  can
  448. use  Suprtool  to  generate  a list of key-values and use Dbedit to update the
  449. records.  Steps 1 and 3 use MPE/XL i/o redirection, Classic users  would  need
  450. to perform these steps inside an editor.
  451.  
  452. 1.  Create  a  workfile  with  the  commands to get into Dbedit and set up the
  453. modification.
  454.  
  455.      :build keylist;rec=-80,,f,ascii;temp
  456.      :file keylist,oldtemp;dev=disc;acc=append
  457.      :echo BASE sales,1,writer      >> *keylist
  458.      :echo EDIT                     >> *keylist
  459.      :echo MODIFY cust-mast:amount  >> *keylist
  460.  
  461. 2. Append the key values plus the constant that you want updated using the new
  462.    LIST command options from Suprtool 3.4.
  463.  
  464.      :file suprlist=*keylist
  465.      :run suprtool.pub.robelle
  466.      >base sales,5,reader
  467.      >get cust-mast
  468.      >if cust-status="I"
  469.      >extract cust-number             {cust-number is the key}
  470.      >extract amount=0                {field to be changed to zero}
  471.      >list oneperline noname norec noskip
  472.      >exit
  473.  
  474. 3. Append the command that Exit from Dbedit and Suprtool.
  475.  
  476.      :echo //                       >> *keylist
  477.      :echo EXIT                     >> *keylist
  478.      :echo EXIT                     >> *keylist
  479.  
  480.      The keylist file now looks like this.
  481.  
  482.      BASE sales,1,writer
  483.      EDIT
  484.      MODIFY cust-mast:amount
  485.      187654
  486.      0
  487.      876677
  488.      0
  489.      //
  490.      EXIT
  491.      EXIT
  492.  
  493. 4. Finally run Suprtool using the workfile of commands and data as input.
  494.  
  495.      :reset keylist
  496.      :run Suprtool.Pub.Robelle;stdin=keylist
  497.  
  498. For  detail datasets this approach may be too complicated. After providing all
  499. the search and sort fields, there may  be  more  than  one  record.   Dbedit's
  500. prompting  sequence  would  then  be different and the wrong records could get
  501. updated.
  502.  
  503. Xpress  Version 2.8
  504.  
  505. NS-less E-Mail Between HP 3000s.
  506.  
  507. Ole Nord has managed to get Xpress electronic mail exchanging  messages  among
  508. multiple  HP  3000s,  using  only  a  PC  instead of Network Services.  The PC
  509. executes a Reflection command file which dials up the  various  CPUs  involved
  510. and  picks  up  and  delivers  the  Xpress  mail.  It does the job quickly and
  511. inexpensively.  The only drawback is that Xpress attached files are not sent.
  512.  
  513.  
  514.  
  515.    Fortune Cookie of the Month
  516.  
  517.    "Duct tape is like The Force.  It has a light side, a dark side, and  it
  518.    holds the universe together." -- Carl Zwanzig
  519. &f0S*p+0x-270Y&f0S*p+4a+4B*c1950a270b10g2P&f1S
  520. *c1950a4B*c0P*c4a270B*c0P*p+1950X*c0P
  521. *p-1950x+270Y*c1954a4B*c0P
  522. *p+25X*c1950a25B*c40g2P*p-270y-25X*p+25y+1950X
  523. *c25a270B*c2P&f1S
  524.