home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / faq / lq46inst.txt < prev    next >
Text File  |  1998-01-13  |  43KB  |  1,091 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                QEDIT Version 4.6
  7.  
  8.  
  9.                     Full-Screen Text Editor for the HP 3000
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                  Change Notice
  17.                            Installation Instructions
  18.                           Addendum to 4.5 User Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                             Robelle Consulting Ltd.
  38.                            Unit 201, 15399-102A Ave.
  39.                          Surrey, B.C. Canada  V3R 7K1
  40.  
  41.                            Toll-free:  1-888-ROBELLE
  42.                                       (1-888-762-3553)
  43.                             Phone:  (604) 582-1700
  44.                              Fax:  (604) 582-1799
  45.  
  46.                          E-mail:  support@robelle.com
  47.                              Web:  www.robelle.com
  48.  
  49.                                 September 1997
  50.           Program and Manual Copyright Robelle Consulting Ltd.  1977-1997
  51.  
  52.  
  53.           Permission  is  granted  to  reprint  this  document  (but not for
  54.           profit), provided that copyright notice is given.
  55.  
  56.  
  57.           QEDIT and SUPRTOOL are trademarks of Robelle Consulting Ltd.
  58.  
  59.  
  60.  
  61.  
  62.           The following names and marks  are  companies  and  trademarks  of
  63.           their  respective  owners,  designating companies and products not
  64.           provided by or associated with Robelle or  its  QEDIT  editor  and
  65.           SUPRTOOL database handyman products.
  66.           ASK  is  a  trademark  of  COGELOG.   Allbase, HP 3000, HP, HP-UX,
  67.           HPDesk,  IMAGE,  KSAM,  LaserJet,  MM3000,  MPE,  TDP,   TRANSACT,
  68.           TurboIMAGE,  and  VPLUS are trademarks of Hewlett-Packard Company.
  69.           Cognos,  PDL,  PowerHouse,  QDESIGN,  QUICK,  QUIZ,  and  QTP  are
  70.           trademarks  of  Cognos  Incorporated.  Excel, MS-DOS, Windows, and
  71.           Windows NT are trademarks of  Microsoft  Corporation.   IBM  is  a
  72.           registered  trademark  of  International  Business  Machines Corp.
  73.           Klondike is a  trademark  of  Software  Research  Northwest,  Inc.
  74.           Lotus  is a registered trademark of Lotus Development Corporation.
  75.           MANMAN is  a  trademark  of  ASK  Computer  Systems,  Inc.   MPEX,
  76.           SECURITY/3000, and STREAMX are trademarks of VESOFT, Inc.  Mac and
  77.           Macintosh are trademarks of Apple  Computer  Inc.   Netbase  is  a
  78.           trademark  of  Quest  Software.   Nuggets  is  a trademark of Lund
  79.           Performance  Solutions.   Omnidex  is  a  trademark   of   Dynamic
  80.           Information  Systems Corporation.  Oracle is a trademark of Oracle
  81.           Corporation.  Paradox and Quattro Pro are  trademarks  of  Borland
  82.           International.   Reflection  is  a  registered trademark of Walker
  83.           Richer & Quinn,  Inc.   SPEEDWARE  is  a  trademark  of  Speedware
  84.           Corporation.   SPLash!  is  a  trademark  of  Allegro Consultants.
  85.           Superdex is a trademark of Bradmark Technologies, Inc.  Type Ahead
  86.           Engine is a trademark of Telamon, Inc.
  87.  
  88.  
  89.  
  90.  
  91.    Introducing Qedit Version 4.6
  92.  
  93.  
  94.                *  Qedit for Windows
  95.                *  Highlights
  96.                *  Compatibility
  97.                *  CPU Serial Number
  98.                *  Compatibility Mode vs. Native Mode
  99.                *  Known Problems
  100.                *  Documentation
  101.                *  Documentation in WinHelp Format
  102.  
  103.  
  104.           Qedit  is  a  full-screen  editor  for  programmers of the HP 3000
  105.           (MPE/iX and MPE V).  As  a  development  home  base  for  HP  3000
  106.           programmers, it is both fast and efficient.
  107.  
  108.           Every year we update Qedit with a number of new features and fixes
  109.           requested by users.  It is our goal is to provide  PowerHouse  and
  110.           COBOL  developers  with  all  the  necessary facilities to stay in
  111.           Qedit all day.
  112.  
  113.           This change notice includes detailed  steps  for  installation,  a
  114.           description  of  Qedit's  new  features and how to use them, and a
  115.           list of other changes.  Qedit is also available  for  HP-UX,  with
  116.           virtually  identical  features.  Contact us if you would like more
  117.           information.
  118.  
  119.  
  120.    Announcing Qedit for Windows
  121.  
  122.           In the last year we have been busy developing the next  generation
  123.           of  our  popular  editor, Qedit for Windows (QWIN).  QWIN lets you
  124.           edit local MPE/iX  and  HP-UX  files  from  a  single  MS  Windows
  125.           program.   Our new editor consists of a Windows editing client and
  126.           an MPE/iX or HP-UX editing server that work together to edit  your
  127.           host  files  for you.  To take advantage of Qedit for Windows, you
  128.           need both the client and the server.
  129.  
  130.           This change notice includes a description of the server portion of
  131.           Qedit  for  Windows.   If  you  would like to upgrade to Qedit for
  132.           Windows, please contact Robelle Consulting Ltd.
  133.  
  134.  
  135.    Highlights in Version 4.6
  136.  
  137.           *  The new Undo option in the  Redo  command  can  now  cancel  an
  138.              immediately  preceding Undo operation.  If you have consecutive
  139.              Undo operations, you can cancel them with consecutive Undo Redo
  140.              commands.
  141.  
  142.           *  If you use a Text command on a file, the modification timestamp
  143.              is now stored in the workfile.  Knowing when the file was  last
  144.              modified  lets  you  make  sure you are not overwriting someone
  145.              else's revisions.
  146.  
  147.           *  The Text command has undergone major improvements: it has fewer
  148.              limits and it can handle big files better.
  149.  
  150.           *  In  Visual  mode,  the plus (+) and minus (-) signs in the home
  151.              line can now move ahead or back up to 10,000 lines.
  152.  
  153.           *  New  Set  Lang  settings  have  been  added  for  C,  C++,  and
  154.              PowerHouse.
  155.  
  156.           *  List $page will also do a page break on #pragma page.
  157.  
  158.           *  List with $pcl option now closes the printer when running under
  159.              Windows.
  160.  
  161.           *  Robelle has been putting its resources into the development  of
  162.              a  new  product,  Qedit  for  Windows.   For  more details, see
  163.              "Announcing Qedit for Windows" above.
  164.  
  165.  
  166.    Compatibility
  167.  
  168.           This version of Qedit is compatible with all previous versions.
  169.  
  170.  
  171.    CPU Serial Number (HPSUSAN)
  172.  
  173.           Qedit runs only on CPUs whose serial  numbers  have  been  encoded
  174.           (check  "showvar  hpsusan" on MPE/iX).  If it fails to run and you
  175.           see  an  "invalid  HPSUSAN"  error  message,  call   Robelle   for
  176.           assistance.
  177.  
  178.  
  179.    Compatibility Mode vs. Native Mode
  180.  
  181.           Throughout  this change notice and in all the Qedit documentation,
  182.           there are references to compatibility mode and  native  mode.   If
  183.           you are on a Classic HP 3000 (that is, not on MPE/iX), you can use
  184.           the compatibility-mode version of Qedit.   Our  installation  jobs
  185.           will  automatically  install the correct version of Qedit for your
  186.           machine.
  187.  
  188.           Qedit works on both MPE/iX and MPE XL.  Any reference to MPE/iX in
  189.           our  documentation  can  also be considered a reference to MPE XL,
  190.           and vice versa.
  191.  
  192.  
  193.    Known Problems
  194.  
  195.  
  196.    Qedit for MPE
  197.  
  198.           There are currently no known problems with Qedit for MPE.
  199.  
  200.  
  201.    Qedit for Windows (QWIN)
  202.  
  203.           The following are known problems in the either the Qedit client or
  204.           the server:
  205.  
  206.           Access Log File
  207.  
  208.           New client connections are not logged to the access log file.
  209.  
  210.           Client Problems
  211.  
  212.           The following problems appear in the Qedit for Windows client:
  213.  
  214.           a. Changing the right margin in the Options dialog box (File menu)
  215.              has no effect on server documents.
  216.  
  217.           b. A  pattern-matching  Find  command  does  not  work  on   local
  218.              documents.
  219.  
  220.  
  221.    Documentation
  222.  
  223.           If  you  would like to print a copy of the latest user manual, use
  224.           the file Qedit.Doc.Robelle.  To print the manual on your  LaserJet
  225.           or line printer, run the Printdoc program.
  226.  
  227.                :run printdoc.pub.robelle
  228.  
  229.           Printdoc  is  menu-driven and very easy to use.  Printdoc asks you
  230.           for information; if you are unsure of the answer, you can ask  for
  231.           help  by  typing a question mark (?).  Printdoc supports all types
  232.           of LaserJet printers and regular line printers.
  233.  
  234.           If you know  the  filename,  you  can  also  print  other  Robelle
  235.           documentation with Printdoc or you can include the filename in the
  236.           :Run command.  For example, to print this change notice, type
  237.  
  238.                :run printdoc.pub.robelle;info="qedit.docchg.robelle"
  239.  
  240.  
  241.    Documentation in WinHelp Format
  242.  
  243.           Both the MPE and HP-UX editions of the Qedit User Manual  are  now
  244.           available in the popular WinHelp file format of Microsoft Windows.
  245.           Your tape includes a WinHelp  file,  which  is  a  self-extracting
  246.           compressed  file  that  contains  all  five Help files and a Setup
  247.           program.  Use the installation instructions in this change  notice
  248.           to install the WinHelp files on your PC.
  249.  
  250.  
  251.    Installation
  252.  
  253.  
  254.           If  you  are  a  new  Qedit  user,  please follow the installation
  255.           instructions in the Qedit User Manual.  The following instructions
  256.           assume  that  you  are  an existing Qedit user who is upgrading to
  257.           version 4.6.
  258.  
  259.           If you need to install this upgrade in an account other  than  the
  260.           Robelle  account,  follow  the  installation  instructions  in the
  261.           appendix at the end of this change notice.
  262.  
  263.           To install this upgrade of Qedit, follow these steps:
  264.  
  265.           1. Install Qedit.
  266.  
  267.           2. Install the QLIB and/or Bonus programs.
  268.  
  269.           3. Fix the NM compilers (XL only).
  270.  
  271.           4. Fix the MPE V compilers (both systems).
  272.  
  273.           5. Install the WinHelp files (optional).
  274.  
  275.           The installation should take about half an hour, during which time
  276.           no can use Qedit.
  277.  
  278.  
  279.    Installation Assistance
  280.  
  281.           If  you  have  any questions about the upgrade process or run into
  282.           any problems, please call us.  Technical support is  available  on
  283.           weekdays  from  7  a.m. to  4  p.m.,  Pacific  time.  You can also
  284.           receive emergency support outside of these hours  by  calling  our
  285.           regular  phone  number  and  asking the operator to page a support
  286.           person for you.
  287.  
  288.  
  289.    Replace Any Pre-Release
  290.  
  291.           If you are currently running a pre-release version of  Qedit,  you
  292.           should  replace  it  with  this new official release.  Pre-release
  293.           versions expire within two years of their creation  date,  whereas
  294.           this  new  release has no expiry date.  You can easily recognize a
  295.           pre-release by its three-part version number  (e.g.,  4.5.24)  and
  296.           the words "Pre-Release" next to the version number.
  297.  
  298.  
  299.    Important Note About Passwords
  300.  
  301.           None  of  the  jobs  we  supply  have  passwords  in them.  Before
  302.           streaming a job, you may have to add your  system's  passwords  to
  303.           the first line.  Users of MPE XL version 3.0 and later do not have
  304.           to do this because the operating system prompts  you  for  missing
  305.           passwords.   The  same  is  true for MPE V users who have security
  306.           software that inserts passwords.  Most MPE V users  have  to  edit
  307.           the  jobs.   For  example, if the system manager logon password is
  308.           Qwerty, you would do the following:
  309.  
  310.                :editor
  311.                HP32201A.07.22 EDIT/3000
  312.                /text robelle.pub.sys
  313.                FILE UNNUMBERED
  314.                /modify 1
  315.                MODIFY     1
  316.                !job robelle,manager.sys,pub;hipri
  317.                                        i/qwerty
  318.                !job robelle,manager.sys/qwerty,pub;hipri
  319.  
  320.                /keep robtemp
  321.                /exit
  322.                END OF SUBSYSTEM
  323.                :stream robtemp
  324.                :purge robtemp
  325.  
  326.  
  327.    STREAMX Users
  328.  
  329.           Users of STREAMX, a part of SECURITY/3000 from VESOFT  Inc.,  must
  330.           set  a Job Control Word before streaming jobs.  This step prevents
  331.           STREAMX from generating an error if the Robelle account  does  not
  332.           yet exist.  For example,
  333.  
  334.                :setjcw streamxtempnonest 1
  335.                :stream robelle.pub.sys
  336.  
  337.  
  338.    Step 1:  Install Qedit
  339.  
  340.           This   step  requires  three  separate  procedures:  building  (or
  341.           upgrading) the Robelle  account  using  the  job  stream  that  we
  342.           provide,  restoring  all  Robelle  files  from  tape  to disc, and
  343.           streaming the installation job stream.  All these  procedures  can
  344.           easily be accomplished if you log on as Manager.Sys.
  345.  
  346.  
  347.    Create/Update Robelle Account
  348.  
  349.           You  must  build  (or  upgrade)  the  Robelle account with the job
  350.           stream that we provide.  This job removes the passwords  from  the
  351.           Robelle  account  and from the user Mgr.Robelle.  You need to know
  352.           the existing passwords, so that you can put them  back  after  the
  353.           installation.
  354.  
  355.                :hello manager.sys          {log on as system manager}
  356.                :listacct robelle;pass      {look for PASSWORD: }
  357.                :listuser mgr.robelle;pass  {look for PASSWORD: }
  358.  
  359.           Once  you  have  written  down  the  passwords,  stay logged on as
  360.           Manager.Sys and stream the job that builds and updates the Robelle
  361.           account.
  362.  
  363.                :file rtape;dev=tape               {mount Robelle tape}
  364.                :restore *rtape; robelle.pub.sys   {= reply on the console}
  365.                :stream robelle.pub.sys
  366.  
  367.           This job stream will send you a message when it is finished.  Stay
  368.           logged on as  Manager.Sys  and  put  a  password  on  the  Robelle
  369.           account.   If  you are upgrading your Robelle account, use the old
  370.           password.
  371.  
  372.                :altacct robelle;pass=hardpass {hard to guess}
  373.  
  374.           Please note that during installation, we add OP capability to  the
  375.           Robelle account.  Once Qedit has been installed, you can remove OP
  376.           capability.
  377.  
  378.  
  379.    Restore Files
  380.  
  381.           Stay logged on as Manager.Sys and restore the Robelle files:
  382.  
  383.                :file rtape;dev=tape
  384.                :restore *rtape;@.@.robelle  {= reply on console}
  385.  
  386.           Check the :Restore listing for files that were busy and could  not
  387.           be  restored.  There are a number of reasons why a file could have
  388.           been busy: someone may have been using it or backing it up, it may
  389.           have been held as a suspended son process (menu system), or it may
  390.           have been allocated.  If files were busy, chase  away  any  users,
  391.           deallocate any busy programs, then try the :Restore again.
  392.  
  393.  
  394.    Filenames
  395.  
  396.           The  Qedit  program  files  are  restored  to the Pub group of the
  397.           Robelle account.  These are the names of the various files:
  398.  
  399.                qeditnm                     NM Qedit program
  400.                qeditcm      qeditpm     CM Qedit programs
  401.                qcompxl                     NM compiler interface
  402.                qedify       qcompusl    CM compiler interface
  403.                qloadxl                     NM Qedit options
  404.                ederrnm      ederrcm     :Editerror support
  405.                qmap                        reformat MPE V PMAP
  406.  
  407.  
  408.    Install Program Files
  409.  
  410.           Our installation job installs the proper Qedit files into the  Pub
  411.           group  of  the  Robelle  account.   No  one can use these programs
  412.           during the installation.  Warn people  not  to  use  Qedit  for  a
  413.           while, and then stream the job:
  414.  
  415.                :hello mgr.robelle
  416.                :warn @;please exit from Qedit NOW!
  417.  
  418.                :stream install.qeditjob         {supply passwords}
  419.  
  420.           Check the installation job $stdlist.  If anyone was using Qedit or
  421.           attempting to back it up during the  installation,  the  job  will
  422.           fail.   If  the  job  failed,  chase away any users, ensure that a
  423.           backup is not in progress, then stream the installation job again.
  424.  
  425.           The installation job renames your current versions of Qedit to the
  426.           PubOld group of the Robelle account.  If you need  to  move  these
  427.           versions  back  into  production,  use  the  Previous.Qeditjob job
  428.           stream.
  429.  
  430.           You can now access Qedit by entering
  431.  
  432.                :run Qedit.pub.robelle
  433.  
  434.  
  435.    Step 2:  Install QLIB and Bonus Programs
  436.  
  437.           Qedit comes with an array of  contributed  software  in  the  QLIB
  438.           library  (in  the  QLIB  groups  of  the  Robelle  account).  QLIB
  439.           programs may be used on any CPUs and may  be  given  away  freely.
  440.           Your  Robelle  license  may  also entitle you to receive our Bonus
  441.           programs:  Compare/iX, HowMessy, Select, Spell, and Xpedit.  These
  442.           programs  reside  in  the Pub group of the Robelle account.  Bonus
  443.           programs can only be used on authorized machines, and you may  not
  444.           distribute them to anyone.
  445.  
  446.           If you received Bonus programs with this version of Qedit, use the
  447.           job stream called Bonus.Job.Robelle to install both the  QLIB  and
  448.           Bonus  programs.   If  you did not receive Bonus programs, use the
  449.           job stream Qlib.Job.Robelle to install the QLIB programs.
  450.  
  451.                :hello mgr.robelle
  452.                :stream bonus.job.robelle        {or Qlib.Job.Robelle}
  453.  
  454.           If you skip this step, you may end  up  running  old  versions  of
  455.           these programs.
  456.  
  457.  
  458.    Building the Spell Dictionary
  459.  
  460.           Before  you can use the Spell Bonus program or the Word command in
  461.           Qedit, you have to build the main dictionary  for  Spell  with  an
  462.           additional  install  job.   This  job  stream  could take 30 to 60
  463.           minutes; you do not have to wait for it to finish before going  to
  464.           the next step.
  465.  
  466.           By  default,  the  Spell  program uses American spellings.  To use
  467.           British spellings, set the  SpellAmerican  JCW  to  False  in  the
  468.           install job.
  469.  
  470.                :run qedit.pub.robelle          {or use :Editor}
  471.                /text dictmain.spjob
  472.                /modify "setjcw SpellAmerican"  {for British spelling,    }
  473.                /keep robtemp                   {   change True to False}
  474.                /exit
  475.                :stream robtemp
  476.                :purge robtemp
  477.  
  478.           For more information, see the Spell User Manual.
  479.  
  480.  
  481.    Step 3:  Install NM Compiler Interface
  482.  
  483.           If  you  use  any NM compilers on MPE/iX, you will want to install
  484.           the new NM compiler interface.  If you still use the CM  compilers
  485.           as  well,  you  will  also want to install that compiler interface
  486.           (described in step 4 below).
  487.  
  488.  
  489.    Installing the Interface
  490.  
  491.           Assuming that you have restored the Robelle files onto your system
  492.           and   that   you   have   not   done   this  step  before,  stream
  493.           Savecmdf.Qeditjob to make backup copies of the existing HP command
  494.           files  in  the Stdcmd.Sys group.  You need to know the Manager.Sys
  495.           password.
  496.  
  497.                :stream savecmdf.qeditjob.robelle {wait for it to finish}
  498.                :listf @.stdcmd.sys
  499.  
  500.           Then stream Qcompxl.Qeditjob to make  three  (3)  changes  to  the
  501.           Pub.Sys compiler command files:
  502.  
  503.                :stream qcompxl.qeditjob.robelle
  504.  
  505.           This  job  makes  the  following  changes  to the compiler command
  506.           files:
  507.  
  508.           1. Change the run of the compiler program to
  509.                ;xl ="qcompxl.pubnew.robelle, qcompxl.pub.robelle",
  510.           2. Add ";shr" to the File commands for the text and master files.
  511.           3. Change "setjcw jcw=fatal" to an invalid command so that  errors
  512.              in either Qedit or MPE/iX will abort the command file.
  513.  
  514.  
  515.    Compiling Instructions
  516.  
  517.           Now  you  should  be  able  to compile a Qedit file or a Keep file
  518.           either from within Qedit or at the MPE/iX prompt, just by invoking
  519.           the normal command file:
  520.  
  521.                :pasxl source                {from MPE}
  522.                :run qedit.pub.robelle
  523.                /pasxl source                {from Qedit}
  524.  
  525.           Within Qedit, you can specify "*" for the current workfile:
  526.  
  527.                :run qedit.pub.robelle
  528.                /text source
  529.                /pasxl *
  530.                /exit
  531.                :pasxl qeditscr
  532.  
  533.  
  534.    Step 4:  Install CM Compiler Interface
  535.  
  536.           When  installing  Qedit  on MPE/iX, you may have to install the NM
  537.           compiler  interface  (described  earlier)  and  the  CM   compiler
  538.           interface  (described here).  For MPE V, however, you only have to
  539.           worry about the original CM compilers.  After restoring the  files
  540.           from  tape, you have to choose an installation method: integral or
  541.           isolated.
  542.  
  543.  
  544.    Choosing a CM Installation Method
  545.  
  546.           There are two methods of fixing  the  compilers  on  your  system:
  547.           integral  into  Pub.Sys  or  isolated in the Robelle account.  The
  548.           isolated method is best for new or trial-period users  because  it
  549.           is  faster  to  install and easier to remove later.  You can start
  550.           with the isolated method and easily convert to the integral method
  551.           later.
  552.  
  553.  
  554.           Integral  Method.   The compilers in Pub.Sys are "fixed" directly,
  555.           and a segment is added to the system SL.  The standard :Cobol  and
  556.           :Pascal commands of MPE then compile Qedit workfiles.  :Sysdump is
  557.           used to make a new cold load tape for the next time  you  need  to
  558.           boot the system.
  559.  
  560.  
  561.           Isolated  Method.  The MPE compilers are copied into the Q.Robelle
  562.           group and the original compilers are left in  the  Pub.Sys  group.
  563.           No  code  is  added  to  the  system  SL.   Qedit workfiles can be
  564.           compiled only from within Qedit because the "Qedit" compilers  are
  565.           not in Pub.Sys.
  566.  
  567.  
  568.    Integrating CM Compiler Changes
  569.  
  570.           The  job  stream  Qeditj1.Qeditjob.Robelle makes integral compiler
  571.           fixes.  Use it either to update the fixes to a new version  or  to
  572.           re-install  the  fixes  after  an  MPE update from HP.  Before you
  573.           start, you should :Store @.Pub.Sys and save  it  on  tape  because
  574.           this job modifies the compiler program files in Pub.Sys.  You will
  575.           need another small tape for a new cold load tape.
  576.  
  577.           Ensure that no one compiles during  the  installation.   Stop  all
  578.           jobs  and send an operator warning.  Log on as Manager.Sys, modify
  579.           the first line of the Qeditj1 job to include the  passwords,  then
  580.           :Stream the job.
  581.  
  582.                :stream qeditj1.qeditjob.robelle
  583.  
  584.           This  job  runs Qedify.Pub.Robelle, which updates the compilers in
  585.           Pub.Sys and installs nonprivileged hooks into  them  so  that  the
  586.           compilers can access Qedit workfiles.  The job adds a code segment
  587.           from Qcompusl.Pub.Robelle into Sl.Pub.Sys and then requests a tape
  588.           mount for a new cold load tape.
  589.  
  590.           Mount a tape with a write ring and :Reply.  Save this tape and use
  591.           it for future cold  loads.   The  CM  compiler  interface  is  now
  592.           installed.   Compiles  done  inside  or outside Qedit will work on
  593.           either Qedit workfiles or on regular Keep files.
  594.  
  595.  
  596.    Isolating CM Compiler Changes
  597.  
  598.           The job stream Qeditj1a.Qeditjob.Robelle fixes the compilers,  but
  599.           it  isolates  the  changes in the Q.Robelle group.  Ensure that no
  600.           one compiles during the installation.  Stop all jobs and  send  an
  601.           operator  warning.   Modify  the first line of Qeditj1a to include
  602.           the Robelle password, then stream the job:
  603.  
  604.                :stream qeditj1a.qeditjob.robelle
  605.  
  606.           The job uses Qedify.Pub.Robelle to copy the compilers from Pub.Sys
  607.           to the Q.Robelle group, then it "fixes" them so that they can read
  608.           Qedit files.  The original compilers in the Pub.Sys group are  not
  609.           modified.   Once  this  step  is  finished,  you  can  use  the CM
  610.           compilers on Qedit files from within Qedit, but  not  at  the  MPE
  611.           prompt.
  612.  
  613.  
  614.    Step 5:  Install WinHelp Documentation Files (optional)
  615.  
  616.           The Qedit documentation for both MPE and HP-UX is now available in
  617.           the WinHelp file format of Microsoft Windows.  You can  use  these
  618.           files  only  if  you  have  Windows  3.1 or later.  To install the
  619.           WinHelp files on a PC, follow these instructions.
  620.  
  621.  
  622.    Make a Temporary Directory for the Setup Program
  623.  
  624.           From either DOS or the File Manager, make a directory to which you
  625.           can  copy  the  installation files.  You can remove this directory
  626.           after installing the files.
  627.  
  628.                mkdir \robtemp
  629.  
  630.  
  631.    Download the Compressed File
  632.  
  633.           In the next step, use Reflection to download  the  self-extracting
  634.           Zip  file  to  your  PC.   This  Zip file on the HP 3000 is called
  635.           Qedhelp.Whelp.Robelle.  You should be logged on as Mgr.Robelle.
  636.  
  637.           Press Alt-Y to go to the Reflection  Command  Line  window.   Then
  638.           download the file with a binary transfer.
  639.  
  640.                receive c:\robtemp\qedhelp.exe
  641.                       from qedhelp.whelp.robelle binary
  642.  
  643.  
  644.    Expand the Compressed Files
  645.  
  646.           You  only need the following commands to extract the files because
  647.           we provide both the Setup  program  and  the  Help  files  in  one
  648.           self-extracting Zip file.  From the DOS prompt, type the following
  649.           commands:
  650.  
  651.                cd \robtemp          {go to the new Robtemp directory}
  652.                qedhelp.exe          {extract the Help files}
  653.  
  654.  
  655.    Run the Setup Program
  656.  
  657.           From the Program Manager, run the Setup program  by  choosing  the
  658.           Run option from the File menu.  Then enter c:\robtemp\setup in the
  659.           Command Line box and follow the instructions in the Setup program.
  660.  
  661.           You can now access all of the Qedit documentation by selecting any
  662.           of the icons in the "Robelle Help" Program Manager Group.
  663.  
  664.  
  665.    Remove the Robtemp Directory
  666.  
  667.           Before you remove the WinHelp  files,  you  can  copy  them  to  a
  668.           diskette and distribute them to other Qedit users.
  669.  
  670.           To  delete all the WinHelp files and remove the Robtemp directory,
  671.           use either the File Manager or the following DOS commands:
  672.  
  673.                cd \robtemp
  674.                del *.*          {delete all the files in Robtemp}
  675.                cd ..
  676.                rmdir robtemp    {remove the Robtemp directory}
  677.  
  678.  
  679.  
  680.  
  681.  
  682.    Enhancements
  683.  
  684.  
  685.           Every year we provide Qedit users with new  features.   The  major
  686.           enhancements   this   year   include  new  language  settings  for
  687.           PowerHouse,  C  and  C++,   file   modification   timestamp,   and
  688.           multi-rollback Undo.
  689.  
  690.  
  691.  
  692.    Modification Timestamp Stored in Workfile
  693.  
  694.           If  you  use  the  Text  command  to  copy  a  file or to create a
  695.           permanent workfile, Qedit saves a modification timestamp.  If  the
  696.           original  file is then modified before you put your revisions back
  697.           into it with the Keep command, Qedit displays two  (2)  additional
  698.           lines.  For example,
  699.  
  700.                Saved modification timestamp : 1997/03/26  12:29:11
  701.                File modification timestamp  : 1997/03/31  05:40:57
  702.  
  703.           The  first  timestamp  shows you when you used the Text command on
  704.           the original file.  The second timestamp shows you the time  of  a
  705.           subsequent  modification  to the original file by another party or
  706.           process.  Based on this information, you can make sure you are not
  707.           overwriting someone else's changes.
  708.  
  709.           Once  you  use  the  Text command on a file, a Verify Keep command
  710.           will show you the saved timestamp.
  711.  
  712.  
  713.    Undo Command Now Has Redo Option
  714.  
  715.           The  Undo  command  has  a  new  Redo  option.   If  there  is  an
  716.           immediately  preceding Undo operation, the Undo option cancels it.
  717.           To check for a pending Undo, use the  Listundo  command  (it  will
  718.           warn you).
  719.  
  720.           If  you have done consecutive Undo operations, you can cancel them
  721.           with consecutive Undo Redo  commands.   Once  you  do  a  non-Undo
  722.           command,  you  will  no  longer  be  able to cancel preceding Undo
  723.           operations.
  724.  
  725.  
  726.  
  727.    Qedit for Windows
  728.  
  729.  
  730.           Qedit for Windows (QWIN) lets you  edit  local  MPE/iX  and  HP-UX
  731.           files  from a single MS Windows program.  It consists of a Windows
  732.           editing client and an MPE/iX or HP-UX  editing  server  that  work
  733.           together  to  edit  your host files for you.  To take advantage of
  734.           Qedit for Windows, you need both parts: the client and the server.
  735.  
  736.           Qedit   for   Windows   uses   the  popular  TCP/IP  protocol  for
  737.           communicating between the client and the server (this is the  same
  738.           protocol  that  you use to access the Web).  Configuring the Qedit
  739.           server software requires creating the correct  TCP/IP  environment
  740.           for Qedit for Windows.
  741.  
  742.  
  743.    Server Process
  744.  
  745.           The  Qedit  server uses the MPE/iX Remote Process Management (RPM)
  746.           service to start each server session.  With RPM, the client  sends
  747.           a program name and an Info= string along with logon information to
  748.           the  RPM  listening  process.   The  RPM  listening  process  then
  749.           validates the user logon and starts the specified program with the
  750.           Info= string.  The server process is seen as  an  MPE/iX  session,
  751.           but  the  process  is  not included in your user limit.  The Qedit
  752.           server software is not available for MPE V.
  753.  
  754.  
  755.    Logon Sequence
  756.  
  757.           When you first try to open a file in Qedit for  Windows  using  an
  758.           MPE/iX connection, this is what happens:
  759.  
  760.           1. A  new host session is started, and the user name and passwords
  761.              are validated (this includes  additional  logon  processing  by
  762.              products such as SECURITY/3000).
  763.  
  764.           2. The Qedit client asks for the program Ci.Pub.Sys to be run with
  765.              an Info string.  For example,
  766.  
  767.                   qedit.pub.robelle "-d<ip-address>"
  768.  
  769.              The "<ip-address>" is the IP address of the Qedit client.
  770.  
  771.           3. The  Qedit  process  starts,  and  it  verifies  that  you  are
  772.              authorized to use Qedit in server mode.
  773.  
  774.           4. Any system-wide Qeditmgr files are processed.
  775.  
  776.           5. The requested file is opened.
  777.  
  778.           6. A response is sent to the client.
  779.  
  780.           It  is  important to note that logon UDCs are not executed as part
  781.           of this process.  Any environment variables or file equations that
  782.           are  set  up  as part of a logon UDC will not be in effect for the
  783.           Qedit server process.
  784.  
  785.  
  786.    QEDSERVMODE JCW
  787.  
  788.           The Qedit server process always executes the commands in  Qeditmgr
  789.           files  (e.g.,  Qeditmgr.Pub.Sys).   To indicate that you are using
  790.           the Qedit server in either the  server  or  the  non-server  mode,
  791.           which   are  not  exactly  the  same,  we  provide  a  JCW  called
  792.           QEDSERVMODE.  QEDSERVMODE is  set  to  zero  (0)  if  you  are  in
  793.           non-server  mode,  and non-zero if you are in server mode.  If you
  794.           are using the Qedit server, you should modify your  Qeditmgr  file
  795.           so  that  few,  if any, commands are executed in server mode.  For
  796.           example,
  797.  
  798.                if Qedservmode = 0 then
  799.                   set extprog mpex.pub.vesoft
  800.                endif
  801.  
  802.  
  803.    Log Files
  804.  
  805.           The Qedit server can only communicate with Qedit clients.  To help
  806.           system  managers  see  what  is  happening with the Qedit process,
  807.           Qedit for Windows writes to three log files: the access  log,  the
  808.           error log, and the trace log.
  809.  
  810.  
  811.    Console Messages
  812.  
  813.           If  Qedit  cannot  access  any of its log files, it writes the log
  814.           message to the  system  console.   You  can  also  enable  console
  815.           logging  with  the  Debug  command in the Option menu of the Qedit
  816.           client.   If  someone  is  having  trouble  establishing  a   QWIN
  817.           connection  and  the  Qedit log files on the host do not include a
  818.           message about this connection, check the system console.  If Qedit
  819.           was unable to open the log files, it probably reported the message
  820.           on the system console.
  821.  
  822.  
  823.    Access Log
  824.  
  825.           Every time a  Qedit  client  makes  a  connection  to  the  server
  826.           process,  an  entry  is  written  to the access log file, which is
  827.           where the IP address of the client is logged.  Qedit  attempts  to
  828.           find  the  symbolic  name of the client IP address by reverse name
  829.           DNS lookup.  If this lookup  is  not  enabled,  Qedit  writes  the
  830.           numeric form of the IP address to the log file.
  831.  
  832.  
  833.    Error Log
  834.  
  835.           Any  error  conditions encountered by the Qedit server process are
  836.           written to the error log file.  If you suspect a  problem  between
  837.           the  client and the server, start your diagnosis by looking at the
  838.           end of this log file.
  839.  
  840.  
  841.    Trace Log
  842.  
  843.           By default, Qedit does not log messages to  the  trace  log  file.
  844.           You  can  enable  trace file logging by using the Debug command in
  845.           the Option menu of the Qedit client.  The trace log file can  grow
  846.           to  become  very large because Qedit messages are constantly being
  847.           added  to  it.   These  messages  assist  in   understanding   the
  848.           communication  between  the  Qedit  server  process  and the Qedit
  849.           client.  In many cases, their detailed information is the only way
  850.           to diagnose a problem.
  851.  
  852.  
  853.    Log Filenames
  854.  
  855.           If  you  run  Qedit  as Qedit.Pub.Robelle, the three log files are
  856.           located in the Qlog group of the Robelle account.  If you  renamed
  857.           Qedit  or  run it from a different group or account, the group and
  858.           account names for these log files will automatically be  adjusted.
  859.           See the chapter "Installing Qedit" for more details.
  860.  
  861.  
  862.  
  863.    Bugs Fixed
  864.  
  865.  
  866.           List  Command.    The List command now properly parses the $device
  867.           option if the  name  of  the  specified  device  contains  special
  868.           characters.
  869.  
  870.           Qedit  no longer returns an error if the path name of a POSIX file
  871.           contains a directory called "lp."   For example,
  872.  
  873.                List /MYACCT/MYGROUP/lp/myfile
  874.  
  875.           Keep and Shut Commands.   Qedit no  longer  replaces  an  existing
  876.           workfile that requires crash recovery.
  877.  
  878.           Text  Command.    COBOL  files  with more than 65,535 lines are no
  879.           longer treated as unnumbered,  and  the  Text  command  now  works
  880.           properly on these files.
  881.  
  882.           Qedit no longer aborts on Exit when the New and Browse options are
  883.           combined.
  884.  
  885.           Files with more than 2 million lines no longer  run  out  of  line
  886.           numbers when you use the Text command.
  887.  
  888.           A Text command no longer fails if a file contains more than 32,700
  889.           full lines, each between 250 and 256  bytes.   Qedit  now  creates
  890.           Jumbo workfiles for these files.
  891.  
  892.           Qedit  can  now  build a new workfile large enough to hold all the
  893.           lines in a file.
  894.  
  895.           Undo Command.   Canceling an Undo operation no longer removes  the
  896.           entry from the Undo log.
  897.  
  898.           If  you  Shut the current workfile and re-open it immediately with
  899.           Open *, you can now Undo your changes.
  900.  
  901.           UDC Files.   Qedit assumed UDCs ended on a line with  an  asterisk
  902.           (*)  as the first character (not necessarily in the first column).
  903.           Qedit now recognizes the end of a UDC as a  line  containing  only
  904.           asterisks and spaces.
  905.  
  906.           Q  Compilers.    Qedit no longer assumes isolated CM compilers are
  907.           located in the Q group in which the Qedit account resides.   Qedit
  908.           can  now correctly identify the account name that causes different
  909.           compiling errors.
  910.  
  911.           Overriding  $Stdlist's  Record  Length.    Qedit  now   recognizes
  912.           changes  in  $stdlist's  record  length made by a file equate, I/O
  913.           redirection, or the STDLIST run parameter.
  914.  
  915.  
  916.    QLIB and Bonus Enhancements
  917.  
  918.  
  919.           Qedit comes with  an  array  of  contributed  tools  in  the  QLIB
  920.           library.  Your Robelle license may also entitle you to receive our
  921.           five Bonus programs.  All of these tools  are  updated  throughout
  922.           the  year, not necessarily in sync with Qedit or any other Robelle
  923.           product.
  924.  
  925.           If you  have  the  Bonus  programs,  you  may  use  them  only  on
  926.           appropriately  licensed  CPUs.  The QLIB programs, however, may be
  927.           used on any  CPUs  and  given  away  freely.   The  most  recently
  928.           released Bonus and QLIB tools are as follows:
  929.  
  930.                Bonus                   Contributed
  931.                Compare/iX 2.4          Helpcomp 2.2
  932.                HowMessy 2.4            Printdoc 1.6
  933.                Select 3.6              Prose 4.1
  934.                Spell 1.5               Pscreen 89C
  935.                Xpedit 1.5              Qcopy 4.3
  936.                                        Qhelp 2.2
  937.  
  938.  
  939.    Bonus Programs
  940.  
  941.           Since  the  last  major  release  of  Qedit,  the  following Bonus
  942.           programs have been enhanced with these new features:
  943.  
  944.  
  945.    Compare/iX 2.4
  946.  
  947.           The NM Compare program compares two text files and prints out  the
  948.           differences  for you.  Compare works with both Qedit workfiles and
  949.           regular Keep files.  The input filenames can be specified  in  the
  950.           Info=  string.   See  Compare.Docchg.Robelle for a detailed change
  951.           notice for Compare.
  952.  
  953.  
  954.    HowMessy 2.4
  955.  
  956.           HowMessy provides fast reports on the internal efficiency of  your
  957.           database.   Now  use  HowMessy  to  report statistics on IMAGE/SQL
  958.           datasets larger than 4 gigabytes.  See HowMessy.Docchg.Robelle for
  959.           a detailed change notice for HowMessy.
  960.  
  961.  
  962.    Select 3.6
  963.  
  964.           Select  is  a  menu front-end that works on any terminal, allowing
  965.           people to select tasks from a list of choices.  User commands (and
  966.           UDCs)  support  32  parameters  and  :Escape.  Variable-length and
  967.           Qedit-type command files are allowed.   See  Select.Docchg.Robelle
  968.           for a detailed change notice for Select.
  969.  
  970.  
  971.    Spell 1.5
  972.  
  973.           Spell  is  a fast spelling checker for the HP 3000 that reads both
  974.           Qedit and EDIT/3000 files.   Spell  can  read  Qedit's  new  Jumbo
  975.           files.
  976.  
  977.  
  978.    Xpedit 1.5
  979.  
  980.           Xpedit  is  a simple screen editor that is handy for editing small
  981.           files using VPLUS block-mode.  Inverse video  was  added  to  some
  982.           error  messages  to make them stand out more prominently.  See the
  983.           file Xpedit.Docchg.Robelle for a complete description of  Xpedit's
  984.           changes.
  985.  
  986.  
  987.    QLIB Programs
  988.  
  989.           Since the last major release of Qedit, the following QLIB programs
  990.           have been enhanced with these new features:
  991.  
  992.  
  993.    Printdoc 1.6
  994.  
  995.           Printdoc is an easy-to-use utility for  printing  Robelle  manuals
  996.           and  other  documentation.  Printdoc now supports LaserJet 4 and 5
  997.           printers.
  998.  
  999.  
  1000.    Prose 4.1
  1001.  
  1002.           Prose is the text formatter that we use for all our documentation,
  1003.           from  user manuals to on-line Help.  Prose can now read Jumbo text
  1004.           files that are wider than 256 characters.  Prose can also generate
  1005.           RTF  output  with  the  .out (rtf) command.  See the Prose.Docchg.
  1006.           Robelle file for a detailed change notice for Prose.
  1007.  
  1008.  
  1009.    Qcopy 4.3
  1010.  
  1011.           Qcopy is a contributed program that reads and writes Qedit  files.
  1012.           Its  Qeditaccess  routine  decodes  the files for Qcopy.  Although
  1013.           Qeditaccess can read Qedit's new  Jumbo  files,  it  cannot  write
  1014.           them.
  1015.  
  1016.  
  1017.    Qhelp 2.2
  1018.  
  1019.           Qhelp  is an on-line user Help facility that you can tie into your
  1020.           own software.  We use it ourselves in all our software products.
  1021.  
  1022.  
  1023.    Appendix:  Non-Robelle Installation
  1024.  
  1025.  
  1026.           Qedit is usually installed on your HP 3000 in the Robelle  account
  1027.           (see the installation instructions earlier in this change notice).
  1028.           However, you can easily install  Qedit  into  another  account  by
  1029.           following these general steps:
  1030.  
  1031.           1. Create or upgrade the structure of your account
  1032.  
  1033.           2. Restore the files into your account
  1034.  
  1035.           3. Alter any installation jobs to log on to your account
  1036.  
  1037.           4. Stream the installation jobs
  1038.  
  1039.           For  example,  to  install  Qedit into an account called Tools and
  1040.           into the same groups as Qedit  would  have  used  in  the  Robelle
  1041.           account (Pub, Doc, Help, etc.), follow these steps.
  1042.  
  1043.  
  1044.    Step 1:  Upgrade Account Structure
  1045.  
  1046.           With   a  text  editor,  change  all  account  references  in  the
  1047.           Robelle.Pub.Sys job from "robelle" to "tools."  Don't worry  about
  1048.           changes  to  some  of the comments in the job.  Note that this job
  1049.           will change the capabilities, access flags, and logon password  of
  1050.           the  Tools  account.  Examine the job carefully to ensure that the
  1051.           changes do not cause problems for other software  in  the  Robelle
  1052.           account.
  1053.  
  1054.                :run qedit.pub.robelle
  1055.                /text robelle.pub.sys
  1056.                /change "robelle"(upshift) "tools" all
  1057.  
  1058.  
  1059.    Step 2:  Restore Files
  1060.  
  1061.           Restore  the  files  into  your  account,  which  is Tools in this
  1062.           example.
  1063.  
  1064.                :restore *rtape;@.@.robelle;account=tools
  1065.  
  1066.  
  1067.    Steps 3 and 4:  Alter and Stream Installation Jobs
  1068.  
  1069.           Now log on to the Tools account instead of the Robelle account.
  1070.  
  1071.                :hello mgr.tools
  1072.                :run qedit.pub.robelle
  1073.  
  1074.           Before streaming any jobs, you must alter them so that they log on
  1075.           to  the  Tools  account  instead of the Robelle account.  Make the
  1076.           following change to each job in the Qeditjob,  Job,  and  Purgejob
  1077.           groups:
  1078.  
  1079.                /text install.qeditjob
  1080.                /change "robelle"(upshift smart) "tools" all
  1081.                /keep
  1082.                /exit
  1083.                :stream install.qeditjob
  1084.  
  1085.           We  have  used  Robelle's  Qedit  text editor to make the required
  1086.           changes to the account name in this example, but you can  use  any
  1087.           editor.   Just  make  sure  that  all occurrences of "robelle" are
  1088.           changed,  regardless  of  whether  "robelle"  is   in   uppercase,
  1089.           lowercase,  or  mixed  case.   Only  change "robelle" when it is a
  1090.           separate word, not when it is embedded in a longer word.
  1091.