home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / faq / lq44inst.txt < prev    next >
Text File  |  1995-12-11  |  19KB  |  467 lines
  1.  
  2.                                QEDIT Version 4.4
  3.  
  4.                     Full-Screen Text Editor for the HP 3000
  5.  
  6.                            Installation Instructions
  7.  
  8.  
  9.  
  10.  
  11.                             Robelle Consulting Ltd.
  12.                            Unit 201, 15399-102A Ave.
  13.                          Surrey, B.C. Canada  V3R 7K1
  14.  
  15.                           Toll-free:  1-800-561-8311
  16.                             Phone:  (604) 582-1700
  17.                              Fax:  (604) 582-1799
  18.  
  19.                          E-mail:  support@robelle.com
  20.                          WWW:  http://www.robelle.com
  21.  
  22.                                  October, 1995
  23.  
  24.  
  25.    Installation
  26.  
  27.  
  28.           These  notes assume that you are an existing Qedit user who wishes
  29.           to upgrade to version 4.4.  If you are a new  Qedit  user,  please
  30.           follow the installation instructions in the user manual.
  31.  
  32.           To install this version of Qedit, use the following steps:
  33.  
  34.           1. Install Qedit.
  35.  
  36.           2. Install the QLIB and/or Bonus programs.
  37.  
  38.           3. Fix the NM compilers (XL only).
  39.  
  40.           4. Fix the MPE V compilers (both systems).
  41.  
  42.           5. Install the WinHelp files (optional).
  43.  
  44.           It  should  take about half an hour to complete all the steps.  No
  45.           one can use Qedit during this time.
  46.  
  47.           If you need to install this upgrade in an account other  than  the
  48.           Robelle  account,  refer to the appendix at the end of this change
  49.           notice before starting any installation steps.
  50.  
  51.  
  52.    Installation Assistance
  53.  
  54.           If you have any questions about the upgrade process, or  run  into
  55.           any  problems,  please call us.  Technical support is available on
  56.           weekdays from 7 a.m. to 4 p.m., Pacific time.  As  well,  you  can
  57.           receive  emergency  support  outside of these hours by calling our
  58.           regular phone number and asking the operator  to  page  a  support
  59.           person for you.
  60.  
  61.  
  62.    Replace Any Pre-Release
  63.  
  64.           If  you  are currently running a pre-release version of Qedit, you
  65.           should replace it with this  new  official  release.   Pre-release
  66.           versions  expire  within two years of their creation date, whereas
  67.           this new release has no expiry date.  You can tell  a  pre-release
  68.           by  a  three-part  version  number  (e.g.,  4.2.52)  and the words
  69.           "Pre-Release" next to the version number.
  70.  
  71.  
  72.    Important Note About Passwords
  73.  
  74.           None of the  jobs  we  supply  have  passwords  in  them.   Before
  75.           streaming  a  job,  you may have to add your system's passwords to
  76.           the first line.  Users of MPE XL 3.0 and higher  versions  do  not
  77.           have  to  do  this, since the operating system prompts for missing
  78.           passwords.  The same is true for MPE V  users  who  have  security
  79.           software  that  inserts  passwords.  Most MPE V users have to edit
  80.           the jobs.  For example, if the system manager  logon  password  is
  81.           QWERTY, you would do the following:
  82.  
  83.                :editor
  84.                HP32201A.07.22 EDIT/3000
  85.                /text robelle.pub.sys
  86.                FILE UNNUMBERED
  87.                /modify 1
  88.                MODIFY     1
  89.                !job robelle,manager.sys,pub;hipri
  90.                                        i/qwerty
  91.                !job robelle,manager.sys/qwerty,pub;hipri
  92.  
  93.                /keep robtemp
  94.                /exit
  95.                END OF SUBSYSTEM
  96.                :stream robtemp
  97.                :purge robtemp
  98.  
  99.  
  100.    STREAMX Users Please Note:
  101.  
  102.           Users  of  STREAMX, a part of SECURITY/3000 from VESOFT Inc., must
  103.           set a Job Control  Word  before  streaming  jobs.   This  prevents
  104.           STREAMX  from  generating an error if the Robelle account does not
  105.           yet exist.  For example,
  106.  
  107.                :setjcw streamxtempnonest 1
  108.                :stream robelle.pub.sys
  109.  
  110.  
  111.    Step 1:  Install Qedit
  112.  
  113.           There are three steps to install Qedit  on  your  system.   First,
  114.           build  (or upgrade) the Robelle account using a job stream that we
  115.           provide.  Second, restore all Robelle files  from  tape  to  disc.
  116.           Third, stream the installation job stream.  All of these steps are
  117.           easily accomplished if you log on as Manager.Sys.
  118.  
  119.  
  120.    Create/Update Robelle Account
  121.  
  122.           You must build (or upgrade)  the  Robelle  account  with  the  job
  123.           stream  we  provide.   This  job  removes  the  passwords from the
  124.           Robelle account and from the user Mgr.Robelle.  You need  to  know
  125.           the  existing  passwords,  so  that you can put them back once the
  126.           installation is complete.
  127.  
  128.                :hello manager.sys          {logon as system manager}
  129.                :listacct robelle;pass      {look for PASSWORD: }
  130.                :listuser mgr.robelle;pass  {look for PASSWORD: }
  131.  
  132.           Once you have written  down  the  passwords,  stay  logged  on  as
  133.           Manager.Sys and stream the job that builds and updates the Robelle
  134.           account.
  135.  
  136.                :file rtape;dev=tape               {mount Robelle tape}
  137.                :restore *rtape; robelle.pub.sys   {=Reply on the console}
  138.                :stream robelle.pub.sys
  139.  
  140.           This job launches another job, which  sends you a message when  it
  141.           has  completed.   At  this  point,  the  Robelle  account  has the
  142.           password XXXX, and the Mgr.Robelle user does not have a  password.
  143.           You  should  put  the  previous  passwords  back,  or  change  the
  144.           passwords to something that will be hard for outsiders to guess.
  145.  
  146.                :altacct robelle;pass={robelle account password}
  147.                :altuser mgr.robelle;pass={mgr.robelle user password}
  148.  
  149.           Please note that during installation, we add OP capability to  the
  150.           Robelle  account.   When  the  Qedit installation is complete, you
  151.           can, if you wish, remove the OP capability.
  152.  
  153.  
  154.    Restore Files
  155.  
  156.           Stay logged on as Manager.Sys and restore the Robelle files:
  157.  
  158.                :file rtape;dev=tape
  159.                :restore *rtape;@.@.robelle  {=reply on console}
  160.  
  161.           Check the :Restore  listing  for  any  files  that  could  not  be
  162.           restored  because  they  were Busy.  Either someone is using them,
  163.           they are held as suspended son processes (menu system),  they  are
  164.           allocated,  or  someone  is backing them up! Chase away any users;
  165.           deallocate any busy programs; then try the :Restore again.
  166.  
  167.  
  168.    Filenames
  169.  
  170.           The Qedit program files are  located  in  the  Pub  group  of  the
  171.           Robelle account.  Here are the names of the various files:
  172.  
  173.                qeditnm                     {NM Qedit program}
  174.                qeditcm         qeditpm     {CM Qedit programs}
  175.                qcompxl                     {NM compiler interface}
  176.                qedify          qcompusl    {CM compiler interface}
  177.                qloadxl                     {NM Qedit options}
  178.                ederrnm         ederrcm     {:Editerror support}
  179.                qmap                        {reformat MPE V PMAP}
  180.  
  181.  
  182.    Install Program Files
  183.  
  184.           Our  installation  job  installs Qedit.  No one can be using these
  185.           programs when you do the installation.  Warn  people  not  to  use
  186.           Qedit for a while, and then stream our installation job:
  187.  
  188.                :hello mgr.robelle
  189.                :warn @;please exit from Qedit NOW!
  190.  
  191.                :stream install.qeditjob           {supply passwords}
  192.  
  193.           Check the installation job $STDLIST.  If anyone was using Qedit or
  194.           attempting to back it up, the  job  will  fail.   Chase  away  any
  195.           users,  ensure  that  backup  is  not in progress, then stream the
  196.           installation job again.
  197.  
  198.           The installation job renames your current versions of Qedit to the
  199.           PubOld  group  of  the Robelle account.  If you need to move these
  200.           versions back  into  production,  use  the  Previous.QeditJob  job
  201.           stream.
  202.  
  203.           You can now access Qedit by entering
  204.  
  205.                :run Qedit.pub.robelle
  206.  
  207.  
  208.  
  209.    Step 2:  Install QLIB, Bonus Programs
  210.  
  211.           Qedit  comes  with  an  array  of contributed software in the QLIB
  212.           library (in  the  QLIB  groups  of  the  Robelle  account).   QLIB
  213.           programs  may  be  used  on any CPUs and may be given away freely.
  214.           Your Robelle license may also entitle you  to  receive  our  Bonus
  215.           programs:    Compare/iX,  HowMessy,  Select,  Spell,  and  Xpedit.
  216.           These programs reside in the Pub group  of  the  Robelle  account.
  217.           Bonus  programs  can  only be used on authorized machines, and you
  218.           may not distribute them to your friends.
  219.  
  220.           If you received Bonus programs with this version of Qedit, use the
  221.           job  stream  called Bonus.Job.Robelle to install both the QLIB and
  222.           Bonus programs.  If you did not receive Bonus  programs,  use  the
  223.           job  stream Qlib.Job.Robelle to install the QLIB programs.  If you
  224.           skip this step, you may end  up  running  old  versions  of  these
  225.           programs.
  226.  
  227.                :hello mgr.robelle
  228.                :stream bonus.job.robelle        {or Qlib.Job.Robelle}
  229.  
  230.    Building the Spell Dictionary
  231.  
  232.           The  Spell  Bonus  program  requires  an additional install job to
  233.           build its main dictionary.  This job is required if  you  want  to
  234.           use  Spell, and the Spell and Word commands in Qedit.  By default,
  235.           the American spellings are used.  To use British spellings, modify
  236.           the line that sets the SpellAmerican JCW so that the JCW is set to
  237.           False.  This job stream could take 30 to 60 minutes  to  complete;
  238.           there is no reason to wait for it to finish before going on to the
  239.           next step.
  240.  
  241.                :run qedit.pub.robelle          {or use :Editor}
  242.                /text dictmain.spjob
  243.                /modify "setjcw SpellAmerican"  {For British spelling...}
  244.                /keep robtemp                   {...change True to False}
  245.                /exit
  246.                :stream robtemp
  247.                :purge robtemp
  248.  
  249.           See the Spell user manual for more information on using Spell.
  250.  
  251.  
  252.    Step 3:  Install NM Compiler Interface
  253.  
  254.           On MPE/iX, if you use any NM compilers, you will want  to  install
  255.           the  new NM Compiler Interface.  If you still use the CM compilers
  256.           as well, you will want to install that compiler interface too,  as
  257.           described under step 4.
  258.  
  259.  
  260.    Installing the Interface
  261.  
  262.           Assuming that you have Restored the Robelle files onto your system
  263.           and  that  you  have   not   done   this   step   before,   Stream
  264.           Savecmdf.Qeditjob to make backup copies of the existing HP command
  265.           files in  the  Stdcmd.Sys  group.   You  will  need  to  know  the
  266.           Manager.Sys password:
  267.  
  268.                :stream savecmdf.qeditjob.robelle {wait for it to finish}
  269.                :listf @.stdcmd.sys
  270.  
  271.           Then  Stream Qcompxl.Qeditjob to make three changes to the Pub.Sys
  272.           compiler command files:
  273.  
  274.                :stream qcompxl.qeditjob.robelle
  275.  
  276.           1. Change the run of the compiler program to have
  277.               ;xl ="qcompxl.pubnew.robelle, qcompxl.pub.robelle",
  278.           2. Add ";shr" to the File commands for the text and master files.
  279.           3. Change "setjcw jcw=fatal" to an invalid command  to  abort  the
  280.              command file on errors in either Qedit or MPE/iX.
  281.  
  282.  
  283.    Compiling Instructions
  284.  
  285.           At any point, either within Qedit or at the MPE/iX prompt, you now
  286.           should be able to compile a Qedit file or a  Keep  file,  just  by
  287.           invoking the normal command file:
  288.  
  289.                :pasxl source                {from MPE}
  290.                :run qedit.pub.robelle
  291.                /pasxl source                {from Qedit}
  292.  
  293.           Within Qedit, you can specify "*" for the current workfile:
  294.  
  295.                :run qedit.pub.robelle
  296.                /text source
  297.                /pasxl *
  298.                /exit
  299.                :pasxl qeditscr
  300.  
  301.  
  302.    Step 4:  Install CM Compiler Interface
  303.  
  304.           When  installing  Qedit  on MPE/iX, you may have to install the NM
  305.           Compiler  Interface  (described  earlier)  and  the  CM   Compiler
  306.           Interface  (described  here).   MPE V, on the other hand, has only
  307.           the original "CM" compilers to worry about.  After  Restoring  the
  308.           files  from  tape,  you  have  to  choose  an installation method:
  309.           integral or isolated.
  310.  
  311.  
  312.    Choosing a CM Installation Method
  313.  
  314.           There are two methods of fixing  the  compilers  on  your  system:
  315.           integral  into  Pub.Sys  or  isolated in the Robelle account.  The
  316.           isolated method is best for new or trial-period users, because  it
  317.           is  faster  to  install and easier to remove later.  You can start
  318.           with the isolated method and convert  easily  to  integral  method
  319.           later.
  320.  
  321.  
  322.           Integral  Method.   The  compilers in Pub.Sys are "fixed" directly
  323.           and a segment is added to the System SL.  The standard :Cobol  and
  324.           :Pascal  commands  of  MPE  will  then  compile  Qedit  workfiles.
  325.           :Sysdump is used to make a new cold load tape for  the  next  time
  326.           you must boot the system.
  327.  
  328.  
  329.           Isolated  Method.  The MPE compilers are copied into the Q.Robelle
  330.           group and the original compilers are left in  the  Pub.Sys  group.
  331.           No  code is added to the System SL.  Because the "Qedit" compilers
  332.           are not in Pub.Sys, you can not  compile  Qedit  workfiles  except
  333.           from within Qedit.
  334.  
  335.  
  336.    Integrating CM Compiler Changes
  337.  
  338.           The  job  stream  Qeditj1.Qeditjob.Robelle makes integral compiler
  339.           fixes.  Use it either to update the fixes to a new version  or  to
  340.           re-install the fixes after a MPE update from HP.  Because this job
  341.           modifies the compiler program files in Pub.Sys, you should  :Store
  342.           @.Pub.Sys  before  starting  and  save  the  tape.   You will need
  343.           another small tape for a new Cold Load tape.
  344.  
  345.           Ensure  that  no  one  will  compile  until  the  installation  is
  346.           complete.   Stop all jobs and send an operator warning.  Log on as
  347.           Manager.Sys, modify the first line of the Qeditj1 job  to  include
  348.           the passwords, then :Stream the job.
  349.  
  350.                :stream qeditj1.qeditjob.robelle
  351.  
  352.           The job runs Qedify.Pub.Robelle to update the compilers in Pub.Sys
  353.           and install non-privileged hooks  into  them,  so  that  they  can
  354.           access  Qedit  workfiles.   The  job  adds  a  code  segment  from
  355.           Qcompusl.Pub.Robelle into Sl.Pub.Sys  and  then  requests  a  tape
  356.           mount for a new cold load tape.
  357.  
  358.           Mount a tape with a write ring and :Reply.  Save this tape and use
  359.           it for any future cold loads.  The CM Compiler  Interface  is  now
  360.           installed.   Compiles  done  inside  or outside Qedit will work on
  361.           either Qedit workfiles or on regular Keep files.
  362.  
  363.  
  364.    Isolating CM Compiler Changes
  365.  
  366.           The job stream Qeditj1a.Qeditjob.Robelle fixes the compilers,  but
  367.           isolates  the  changes in the Q.Robelle group.  Ensure that no one
  368.           will compile until the installation is complete.   Stop  all  jobs
  369.           and  send  an operator warning.  Modify the first line of Qeditj1a
  370.           to include the Robelle password, then stream the job:
  371.  
  372.                :stream qeditj1a.qeditjob.robelle
  373.  
  374.           The job uses Qedify.Pub.Robelle to copy the compilers from Pub.Sys
  375.           to  the Q.Robelle group, then "fix" them to read Qedit files.  The
  376.           original compilers in the Pub.Sys group are  not  modified.   Once
  377.           this step is completed you can use the CM compilers on Qedit files
  378.           from within Qedit, but not at the MPE prompt.
  379.  
  380.  
  381.    Step 5:  Install WinHelp Documentation Files (optional)
  382.  
  383.           The Qedit for  MPE  and  Qedit  for  HP-UX  documentation  is  now
  384.           available  in  Microsoft Windows WinHelp format.  To install these
  385.           files onto a PC, do the following.  To use WinHelp with  our  Help
  386.           files, your PC must have Microsoft Windows 3.1 or a later version.
  387.  
  388.  
  389.    Make a Temporary Directory for the Setup Program
  390.  
  391.           From DOS or File Manager make a  directory  for  the  installation
  392.           files  (you can remove this directory after installing the WinHelp
  393.           files):
  394.  
  395.                mkdir \robtemp
  396.  
  397.  
  398.    Download Compressed File
  399.  
  400.           Now  download  the  self-extracting   Zip   file   to   your   PC.
  401.           Instructions  for  downloading  this  file  using  Reflection  are
  402.           outlined  for  you.   The  file  on  the   HP   3000   is   called
  403.           qedhelp.whelp.robelle.  You should be logged on as Mgr.Robelle.
  404.  
  405.           Press  Alt-Y to go to the Reflection command line window (you must
  406.           use binary transfer):
  407.  
  408.               receive c:\robtemp\qedhelp.exe
  409.                       from qedhelp.whelp.robelle binary
  410.  
  411.  
  412.    Expand the Compressed Files
  413.  
  414.           Since  we  provide  the  Setup  program  and  Help  files  in  one
  415.           self-extracting  Zip file, you need only the following commands to
  416.           extract the  files.   From  the  DOS  prompt  type  the  following
  417.           commands:
  418.  
  419.              cd \robtemp            {go to where we downloaded the file}
  420.              qedhelp.exe            {extract the help files}
  421.  
  422.  
  423.    Run the Setup Program
  424.  
  425.           From within Program Manager, run the Setup program by choosing Run
  426.           from the File menu, then enter  c:\robtemp\setup  in  the  Command
  427.           Line  box.   Follow  the  instructions  as  provided  by the Setup
  428.           program.
  429.  
  430.           You can now access all the Qedit documentation by selecting any of
  431.           the icons in the "Robelle Help" Program Manager Group.
  432.  
  433.  
  434.    Remove the Robtemp Directory
  435.  
  436.           You  can  now  remove  all  the  files from the Robtemp directory.
  437.           Either delete them from the File Manager or use the following  DOS
  438.           commands:
  439.              cd \robtemp
  440.              del *.*
  441.              cd ..
  442.              rmdir robtemp
  443.  
  444.           You  could  also  copy  the  files  in  robtemp  to a diskette and
  445.           distribute to other Qedit users.
  446.  
  447.  
  448.    Documentation
  449.  
  450.           If you wish to print copies of the revised user  manual,  use  the
  451.           file  Qedit.Doc.Robelle.   To  print  it  on your printer, whether
  452.           LaserJet or line printer, run the Printdoc program.
  453.  
  454.                :run printdoc.pub.robelle
  455.  
  456.           Printdoc is menu-driven and very easy to use.  Printdoc  asks  you
  457.           for  information,  and  if you are not sure of the answer, you can
  458.           ask for help by typing a question mark (?).  Printdoc supports all
  459.           types of LaserJet printers and regular line printers.
  460.  
  461.           You  can  also print documentation other than user manuals, if you
  462.           know the filename.  If you wish, you can include the  filename  in
  463.           the :Run command.  For example, to print this change notice, type
  464.  
  465.                :run printdoc.pub.robelle;info="qedit.docchg.robelle"
  466.  
  467.