home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / newsletter / 1989 / w1989-07.txt < prev    next >
Text File  |  1999-04-28  |  16KB  |  409 lines
  1.  
  2.          What's Up DOCumentation
  3.  
  4.  
  5.  
  6.         Robelle Consulting Ltd.
  7.         8648 Armstrong Rd., R.R.#6
  8.         Langley, B.C.  Canada V3A 4P9
  9.         Telephone: (604) 888-3666
  10.         Fax:  (604) 888-7731
  11.  
  12.  Date:  September 8, 1989
  13.  From:  Robert M. Green, President
  14.         David J. Greer, Research & Development
  15.         Michael C. Shumko, Customer Support
  16.  To:    Users of Robelle Software
  17.  Re:    News of the HP 3000, 1989 #7
  18.  
  19.       What You Will Find in This News Memo:
  20.  
  21.         News Tidbits
  22.         Ten Programs Compete for $2500 Award
  23.         Technical Tips
  24.         About Robelle
  25.         Linking PowerHouse with QEDIT, Part II
  26.         Robelle Products:  Problems, Solutions, and Suggestions
  27.  
  28.  
  29.                                  News Tidbits
  30.  
  31.  700/92 Firmware Lockup.  A user site recently had a firmware lockup on a
  32.  700/92 terminal.  The screen displayed `Port 1 Error 1', the keyboard did not
  33.  respond, and switching the machine off and on did not change the situation.
  34.  A call to HP resulted in having them hold down the `d' key (for `default')
  35.  while powering up the terminal.  The terminal then resumed normal operation.
  36.  Another fix would be to remove the battery from the terminal.  This operation
  37.  apparently requires thirteen paper clips to hold some piece in alignment
  38.  while the battery is removed and re-inserted.  Not for the faint of heart.
  39.  Another weird thing has been happening on their 700/92.  After a power fail,
  40.  the RETURN key is sometimes stuck ON.  They'll come in to work and see
  41.  columns of colons marching off the top of the screen.
  42.  
  43.  Little-Known Forms of Address.
  44.  Senator:  Your Platitude   Representative:  Your Ineptitude
  45.  Earl:  Your Earliness      Basketball player:  Your Altitude
  46.  Viscount:  Your Viscosity  Duke of Earl:  Oh wo-wo-o yi-yi-yi-i-i
  47.  
  48.  :SHOWOUT # Does Not Work on MPE XL.  We mentioned that SHOWOUT # would show
  49.  the spoofles for all jobs and sessions, but that is only true for MPE V, not
  50.  MPE XL.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                      Ten Programs Compete for $2500 Award
  58.  
  59.  INTEREX and ROBELLE held a contest this year for the best new contribution to
  60.  the HP 3000 library.  Robelle Consulting Ltd. is putting up a prize of $2500
  61.  for the winner, who will be selected by Bob Green, President of Robelle, from
  62.  among ten finalist programs selected by the INTEREX library committee.
  63.  The criterion for success in this contest is:  "most incremental value to the
  64.  HP 3000 installed base."  Factors that will be considered in determining the
  65.  winner include "new functionality provided by the program, generality of
  66.  appeal, reliability, quality of documentation, and installation ease." These
  67.  are the ten contributions that made the cut:
  68.  
  69.  CURVPLOT   Plots x,y data on graphics terminals and plotters.
  70.             by Jobst Brandt, Hewlett-Packard Labs
  71.  FQ         Fast-Query report writer.
  72.             by David Hurst, Reliance Electric Company
  73.  LIBUTIL    Stores many MPE files in one file (i.e., a library).
  74.             by Mats Halvarsson, Sweden
  75.  MAIL       Electronic mail system.
  76.             by Gary Dietz and Kevin Kelly of Whitman College, Washington
  77.  FORMPEEK   "Peek" into VPLUS forms files and fast forms files.
  78.             by Otis Whitehurst, Vermont Housing Finance Agency
  79.  NULLITEM   Finds and fixes IMAGE <null items> (i.e., binary zero).
  80.             by Charles Glenn, Germantown, Maryland
  81.  ENFORCER   Forces password changes and validates access to ports.
  82.             by Gary Dietz and Kevin Kelly of Whitman College, Washington
  83.  PASSUTIL   Ages user passwords and forces password changes.
  84.             by David Hurst, Reliance Electric Company (rewrite)
  85.  SPELLCK    Spelling checker with dictionary.
  86.             by Brent Davis, E-Systems, Salt Lake City
  87.  HPFUTIL    File inquire/update utility for MPE/KSAM/IMAGE.
  88.             by John Archer, General Tire Co., Akron, Ohio
  89.  
  90.  These are all high-quality programs and will be extremely valuable to many HP
  91.  3000 users.  Release F0 of the contributed library, which is being
  92.  distributed now, contains all ten finalists, plus many other new
  93.  contributions.  Installation members of INTEREX receive a copy of the library
  94.  on magnetic tape as part of their yearly membership fee ($400 per year).
  95.  
  96.  The winner will be announced on Monday night during the Robelle "harbor
  97.  cruise" party and the award will be presented Thursday, just before the
  98.  Hewlett-Packard Management Roundtable.
  99.  
  100.                                 Technical Tips
  101.  
  102.  Invalid Numeric Digits.  Recent issues of the Oklahoma Users Group Newsletter
  103.  have contained entertaining articles on writing a program to find invalid
  104.  packed-decimal (COMP-3) fields.  First Colin Schmidt published a COBOL
  105.  program to check fields, then David Kingsella took the program apart in print
  106.  and put it back together, and Colin replied to the criticisms.  Finally,
  107.  David Kingsella noted "Having done all of that, I turned to page 8-18 of the
  108.  new COBOL-II Reference Manual and discovered that you can use the `IF
  109.  NUMERIC' class test on a packed numeric field, thus eliminating our need to
  110.  code a subroutine to accomplish this feat." We must remember to read our user
  111.  manuals more often.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                     Linking PowerHouse with QEDIT, Part II
  119.  
  120.     Last issue we discussed how PowerHouse is accessed on the HP 3000 and
  121.     how best to access the QUIZ module from QEDIT.  This issue we go on to
  122.     QDD, QDESIGN, QUICK, and QTP.  The QUIZ UDC last issue would be better
  123.     if it had a FILE equation for the source file, as shown below in the
  124.     UDCs for QDD, QDESIGN, and QTP.
  125.  
  126.  
  127.  "No Data Dictionary":  QSCHEMA and QDD
  128.  
  129.  When you run any PowerHouse tool, it expects to find a data dictionary (i.e.,
  130.  the QSCHEMAC file or DICT/3000).  You create a binary QSCHEMAC file (code is
  131.  640) from a source file using the QDD program.  In this example, schema is
  132.  the dictionary source file:
  133.  
  134.       :run qedit.pub.robelle
  135.       /set udc phudc.catalog.robelle
  136.       /open schema
  137.       /QDD *
  138.  
  139.  Here is the QDD UDC from PHUDC, modified for QEDIT:
  140.  
  141.       QDD source,info=" ",vers=current
  142.       comment  PowerHouse 5.01
  143.       file qsource=!source
  144.       file coghelp=coghelp.!vers.cognos
  145.       file coghlib=coghlib.!vers.cognos
  146.       file cogmpe=cogmpe.!vers.cognos
  147.       run qdd.!vers.cognos;info="auto=qsource udc=$catalog &
  148.         suspend !info"
  149.       reset qsource
  150.       reset cogsort
  151.       reset coghelp
  152.       reset cogmpe
  153.       ****
  154.  
  155.  When running other PowerHouse modules, there are three ways to point to the
  156.  data dictionary:
  157.  
  158.  1.  :FILE QSCHEMAC = xxxx
  159.  
  160.  You could add this MPE command to each UDC.  But because this method is not
  161.  portable to non-HP computers, Cognos may be phasing :FILE commands out over
  162.  time.  We suggest method 2 or 3 instead.
  163.  
  164.  2.  :RUN quiz;INFO = "DICT=xxxx"
  165.  
  166.  This method works on all platforms and makes sense when you have only one
  167.  dictionary.  If you are planning to do more than one application, you will
  168.  probably end up with several dictionaries, since that simplifies maintenance.
  169.  In this case, use method 3.
  170.  
  171.  3.  >SET DICT xxxx
  172.  
  173.  This command appears in the source code of each PowerHouse program.  This is
  174.  the best method when you can't point to a unique dictionary in the UDC.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  Quick
  182.  
  183.  QUICK, the PowerHouse screen-handler, is composed of two programs:  QDESIGN
  184.  to translate a screen-layout source file into a binary screen file, and QUICK
  185.  to execute the screen file.  Only the original source file can be a QEDIT
  186.  file, so there is no need to add AUTO=!SOURCE to the QUICK UDC, only to the
  187.  QDESIGN UDC.  Once you have compiled a screen, the GO command in QDESIGN will
  188.  invoke QUICK to test it.
  189.  
  190.  Here are the UDCs for QDESIGN and QUICK, modified for use inside QEDIT (the
  191.  changes are underlined):
  192.  
  193.       QDESIGN source,info=" ", vers=current
  194.       comment UDC to compile Quick 5.01 screens
  195.       comment   The source file may be a QEDIT file.
  196.       file qsource=!source
  197.       file quick=quick.!vers.cognos
  198.       file qshow=qshow.!vers.cognos
  199.       file qcoblib=qcoblib.!vers.cognos
  200.       file coghelp=coghelp.!vers.cognos
  201.       file coghlib=coghlib.!vers.cognos
  202.       file cogmpe=cogmpe.!vers.cognos
  203.       run qdesign.!vers.cognos;info="auto=qsource udc=$catalog &
  204.          suspend !info"
  205.       reset qsource
  206.       reset quick
  207.       reset qshow
  208.       reset qcoblib
  209.       reset coghelp
  210.       reset coghlib
  211.       reset cogmpe
  212.       ****
  213.  
  214.       QUICK info=" ",vers=current
  215.       comment UDC to execute a 5.01 Quick screen or application
  216.       comment There are no QEDIT input files here!
  217.       file cogmpe=cogmpe.!vers.cognos
  218.       run quick.!vers.cognos;info="udc=$catalog suspend !info"
  219.       reset cogmpe
  220.       ****
  221.  
  222.  These UDCs are from version 5.01.  For 5.06, an extra FILE equation is needed
  223.  to specify QEDIT as the COGEDITR.
  224.  
  225.  Remember, QUICK accepts compiled screens, which have a file code of 641.  It
  226.  does not accept raw screens in QEDIT format.  QUICK also accepts run-time
  227.  parameter files, called "QKGO files".  These are binary files with the code
  228.  650; they tell QUICK which screen to start with and what options to use.
  229.  These cannot be QEDIT files either, although they can be passed in as targets
  230.  of the AUTO= parameter in the QUICK UDC.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  QTP
  238.  
  239.  QTP is the volume transaction processor of PowerHouse.  The language is like
  240.  QUIZ, but supports updates also.  Here is the QTP UDC from PHUDC, modified
  241.  for use from QEDIT:
  242.  
  243.       QTP source,info=" ",vers=current
  244.       comment PowerHouse 5.01, accepts QEDIT source file
  245.       file qsource=!source
  246.       file qshow=qshow.!vers.cognos
  247.       file qcoblib=qcoblib.!vers.cognos
  248.       file cogsort=cogsort.!vers.cognos
  249.       file coghelp=coghelp.!vers.cognos
  250.       file coghlib=coghlib.!vers.cognos
  251.       file cogmpe=cogmpe.!vers.cognos
  252.       run qtp.!vers.cognos;info="auto=qsource udc=$catalog &
  253.          suspend !info"
  254.       reset qsource
  255.       reset qshow
  256.       reset qcoblib
  257.       reset cogsort
  258.       reset coghelp
  259.       reset coghlib
  260.       reset cogmpe
  261.       ***
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.    [Next issue: Native-Mode PowerHouse and other useful tips.]
  269.  
  270.  
  271.             Robelle Products:  Problems, Solutions, and Suggestions
  272.  
  273.  New Versions of MPE
  274.  
  275.  Reminder.  When you receive a new version of MPE from HP, you get new
  276.  versions of the HP compilers and of the system SL.  You may need to
  277.  `re-qedify' your compilers or re-install Speed Demon or SUPRTOOL2 into the
  278.  system SL.
  279.  
  280.  Qedifying the Compilers.  If you compile Qedit files (filecode = 111) or
  281.  compile the currently-texted file (:compile *), you will need to re-qedify
  282.  the HP compilers.  This is done by streaming one of two jobs.  Which one
  283.  needs to be streamed depends on where you keep the qedified compilers.  If
  284.  :LISTF @.Q.ROBELLE shows some compilers (e.g., COBOLII, SPL, FTN, etc.), then
  285.  stream QEDITJ1A.JOB.ROBELLE (isolated installation).  If the :LISTF shows
  286.  only QEDIFY and QPUSL, then stream QEDITJ1.JOB.ROBELLE (integrated
  287.  installation).  See the QEDIT Installation Manual for details on integrated
  288.  versus isolated.  This doesn't apply to Native Mode compilers on MPE XL.  NM
  289.  compilers cannot be qedified.
  290.  
  291.  Speed Demon.  If programs suddenly start giving unresolved external
  292.  references for SPDEDBINIT, SPDESCAN, SPDESHUT, SPDEERROR, or SPDEEXPLAIN, you
  293.  need to re-install Speed Demon into the system SL.  Stream DEMON.JOB.ROBELLE.
  294.  
  295.  SUPRTOOL2.  If programs start getting unresolved external references for
  296.  SUPRTOOL2, stream SUPR2JOB.JOB.ROBELLE.  This re-installs SUPRTOOL2 into the
  297.  system SL.
  298.  
  299.  New Cold Load Tapes.  If you use QEDITJ1, DEMON, or SUPR2JOB jobs, you will
  300.  have to create a new cold load tape.  This is because these jobs make changes
  301.  to the system SL, changes that would be lost with the next cold load, unless
  302.  the changes are saved on a new cold load tape.  You don't have to make the
  303.  cold load tape right away; you can wait until the users have gone home.  And
  304.  if you stream more than one of these jobs, you can wait until after the last
  305.  one to make the cold load tape.
  306.  
  307.  SUPRTOOL  Version 3.1.1 and 3.1.2
  308.  
  309.  Adjust Batch Jobs for Holidays.  In automating production batch jobs, it
  310.  would be very nice to know, at the MPE command level, whether today is a
  311.  holiday (or yesterday or tomorrow).  You can do if hpday = 1 then to check
  312.  for Sunday, but you can't do if hpday = holiday then.  Everyone has his own
  313.  schedule of holidays.  Here is how we cope with this problem in our backup
  314.  job, using SUPRTOOL to compare yesterday's date to a list of holidays for the
  315.  year:
  316.  !comment  Occasionally the backup is not run.  This is usually
  317.  !comment  because of holidays, when nobody is in the office.
  318.  !comment  There is a file, SKIPDAYS.STREAMS.PROD, which
  319.  !comment  contains a list of dates in YYMMDD Ascii format.
  320.  !comment  Because the backup runs after midnight, it checks if
  321.  !comment  YESTERDAY's date is in the file.  If it is, the JCW
  322.  !comment  SKIPTODAY is set to 1 (done using the SUPRTOOLOUTCOUNT
  323.  !comment  JCW, which has how many records SUPRTOOL selected).
  324.  !  run suprtool.pub.robelle
  325.     input skipdays.streams.prod; out $null
  326.     define skipdate,1,6
  327.     item skipdate,date,yymmdd
  328.     if skipdate = $today(-1)
  329.     exit
  330.  !  setjcw skiptoday = suprtooloutcount
  331.  !if skiptoday > 0 then
  332.  !  tellop YESTERDAY WAS A HOLIDAY.
  333.  !  tellop NO PARTIAL BACKUP TODAY.
  334.  !else
  335.  !  comment  Insert the BACKUP commands here:
  336.  !  comment      STORE, etc.
  337.  !endif
  338.  
  339.  The skipdays file is a regular 80-byte file with records in the following
  340.  format:
  341.       ----+----1----+----2----+----3----+----4
  342.       890102    Monday after New Years day
  343.       890327    Easter Monday
  344.       890522    Victoria Day (Canada)
  345.       890603    Canada Day
  346.       890807    Civic Holiday (B.C.)
  347.       890904    Labour Day
  348.       891009    Thanksgiving (Canada)
  349.       891225    Christmas Day
  350.       891226    Boxing Day (Canada)
  351.  
  352.  QEDIT  Version 3.7 and 3.7.1
  353.  
  354.  :REFLECT Commands from Batch Mode.  The :REFLECT pseudo-MPE command in Qedit
  355.  allows you to execute Reflection commands from UDCs, command files, and use
  356.  files.  This is also supposed to work from a batch job, but does not.  A
  357.  pre-release version of Qedit is available which corrects this problem.
  358.  
  359.  FTN A.02.00 Patch.  A user has passed on this patch to fix a problem where
  360.  the Qedified Fortran 77 compiler goes into a loop.  It appears to this user
  361.  as if HP has fixed the temporary file problem in this release:
  362.       :hello manager.sys
  363.       :run patch.pub.sys
  364.       File? FTN.PUB.SYS
  365.       ?M,32,10132
  366.       051404,140050
  367.  
  368.  DBAUDIT  Version 1.9
  369.  
  370.  Pagelength Is Wrong.  Version 1.9 of DBAUDIT has a bug that causes page
  371.  breaks to occur at the wrong place.  This problem has been fixed in version
  372.  1.9.1 of DBAUDIT.  Here are two workarounds to the problem in 1.9:
  373.     Set Pagenumbers Off          Drop page breaks in the "Body", or
  374.     :Run Auditold.Pub.Robelle    Use version 1.8 of DBAUDIT.
  375.  Version 1.8 is very similar to version 1.9, except that it is missing the new
  376.  EXTRACT command.  Since EXTRACT is used to generate standard MPE files,
  377.  rather than reports, you can use version 1.9 for EXTRACT.  If this causes you
  378.  any grief, contact our office about getting a copy of DBAUDIT 1.9.1.
  379.  
  380.  QLIB  Version 5.2
  381.  
  382.  A frequent question in technical support is "Does such and such from the QLIB
  383.  work on MPE XL?"  Here is the current status:
  384.  
  385.                     MPE-Only  XL-Only  Either MPE
  386.        cmswitch                   x
  387.        cookie                               x
  388.        dbcheck2                             x
  389.        deskqed                              x
  390.        equater                              x
  391.        filerpt          x
  392.        howmessy                             x
  393.        netxfer                              x
  394.        nicepmap                             x
  395.        prose                                x
  396.        pscreen                              x
  397.        qcopy                                x
  398.        qhelp                                x
  399.        routines                             x
  400.        select                               x
  401.        sue              x
  402.        tapedir          x
  403.        tdbcheck                             x
  404. *c1950a250b10g2P
  405.  
  406.     Fortune Cookie of the Month
  407.  
  408.     Don't ever let a machine know you're in a hurry.
  409.