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