home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gbase311.zip / INSTALL.INF (.txt) < prev    next >
OS/2 Help File  |  1995-05-25  |  62KB  |  393 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Installation ΓòÉΓòÉΓòÉ
  3.  
  4.  JBA Open ToolCASE Installation 
  5.  
  6.  Installation of the JBA Open ToolCASE consistes of three stages: 
  7.  
  8.   1. Installation of the software onto the AS/400 via cartridge. 
  9.  
  10.   2. Installation of the Guidelines and Client/Server software onto the PC from 
  11.      the AS/400 via PC Support. 
  12.  
  13.   3. Configuration of Communications Manager and Guidelines to use the 
  14.      Client/Server Support facilities. 
  15.  
  16.  These instructions assume at least an operating knowledge of AS/400 and PC 
  17.  commands and procedures. For example, the use of the cartridge drive on an 
  18.  AS/400 and the use of a diskette drive on a PC, as well as OS/400 and OS/2 
  19.  commands which enable you to operate an AS/400 and a PC. 
  20.  
  21.  Note:  OS/400 version 2.2 or above and OS/2 version 2.1 or above are required 
  22.  to load this software. You must also ensure that you have loaded appropriate 
  23.  C++ compiler(s), OS/2 PC Support and Communications Manager or CM/2, and that 
  24.  you have started PC Support and have configured a shared folder drive on the 
  25.  AS/400 onto which the JBA Open ToolCASE shared folder will be restored. 
  26.  
  27.  Select a topic below for more information:- 
  28.  
  29.      o Installation on the AS/400 
  30.      o Installation on the PC 
  31.      o Specifying the Translation Table 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 1.1. Installation on the AS/400 ΓòÉΓòÉΓòÉ
  35.  
  36.  Installation on the AS/400 
  37.  
  38.       1. Sign onto the AS/400 as QSECOFR. 
  39.  
  40.       2. If you have previously installed the JBA Open ToolCASE library set on 
  41.          the AS/400 the following libraries may already exist on your machine: 
  42.  
  43.            GUIDED1 
  44.  
  45.            GUIDEF1 
  46.  
  47.            GUIDEP1 
  48.  
  49.      Rename these libraries as follows: 
  50.  
  51.            RNMOBJ OBJ(GUIDED1) OBJTYPE(*LIB) NEWOBJ(GUIDED1OLD) 
  52.  
  53.            RNMOBJ OBJ(GUIDEF1) OBJTYPE(*LIB) NEWOBJ(GUIDEF1OLD) 
  54.  
  55.            RNMOBJ OBJ(GUIDEP1) OBJTYPE(*LIB) NEWOBJ(GUIDEP1OLD) 
  56.  
  57.       3. If you have previously installed the JBA Open ToolCASE shared folder 
  58.          on the AS/400 then rename it as follows: 
  59.  
  60.            RNMDLO DLO(GUI_INST.ALL) NEWDLO(GUI_INST.OLD) 
  61.  
  62.       4. Insert the supplied cartridge into your AS/400 tape drive. It is 
  63.          assumed throughout this document that the cartridge drive name is 
  64.          TAP01. If you are using a drive with a different name then substitute 
  65.          the name you are using. 
  66.  
  67.       5. Restore the JBA Open ToolCASE library set from the distribution 
  68.          cartridge with the following commands: 
  69.  
  70.            RSTLIB SAVLIB(GUIDED1) DEV(TAP01) ENDOPT(*LEAVE) 
  71.  
  72.            RSTLIB SAVLIB(GUIDEF1) DEV(TAP01) ENDOPT(*LEAVE) 
  73.  
  74.            RSTLIB SAVLIB(GUIDEP1) DEV(TAP01) ENDOPT(*LEAVE) 
  75.  
  76.      Check that all objects were restored for the library after each command. 
  77.  
  78.       6. Restore the JBA Open ToolCASE shared folder from the distribution 
  79.          cartridge with the following command: 
  80.  
  81.            RSTDLO DLO(*ALL) SAVFLR(GUI_INST.ALL) DEV(TAP01) ENDOPT(*REWIND) 
  82.         NEWOBJ(*NEW) 
  83.  
  84.      Check the resulting messages. The last message should say how many objects 
  85.      were restored. 
  86.  
  87.      Note:  There should be zero objects not installed. 
  88.  
  89.       7. To set up the library list on the AS/400 when PC sessions connect, the 
  90.          commands SETGUILIBL and RTVGUILIB must be available.  To ensure that 
  91.          they are accessible, they should be copied to a library which is in 
  92.          all users library list. For example to duplicate the commands into 
  93.          QUSRSYS (which is part of QSYSLIBL), type the following: 
  94.  
  95.            CRTDUPOBJ OBJ(SETGUILIBL) FROMLIB(GUIDEP1) OBJTYPE(*CMD) 
  96.         TOLIB(QUSRSYS) 
  97.  
  98.            CRTDUPOBJ OBJ(RTVGUILIB) FROMLIB(GUIDEP1) OBJTYPE(*CMD) 
  99.         TOLIB(QUSRSYS) 
  100.  
  101.       8. If you have previously installed the Guidelines libaries, you can 
  102.          restore the host applications, library lists and authorisation codes 
  103.          by copying the appropriate files from the renamed files library as 
  104.          follows: 
  105.  
  106.            CPYF FROMFILE(GUIDEF1OLD/CMP10) TOFILE(GUIDEF1/CMP10) 
  107.         MBROPT(*REPLACE) 
  108.  
  109.            CPYF FROMFILE(GUIDEF1OLD/CMP11) TOFILE(GUIDEF1/CMP11) 
  110.         MBROPT(*REPLACE) 
  111.  
  112.            CPYF FROMFILE(GUIDEF1OLD/CMP12) TOFILE(GUIDEF1/CMP12) 
  113.         MBROPT(*REPLACE) 
  114.  
  115.            CPYF FROMFILE(GUIDEF1OLD/CMP91) TOFILE(GUIDEF1/CMP91) 
  116.         MBROPT(*REPLACE) 
  117.  
  118.       9. If this is a new installation or additional AS/400 products have been 
  119.          installed, to enable the AS/400 communications programs to operate 
  120.          correctly, you must enter an authorisation code. Enter the command: 
  121.  
  122.            GUIDEP1/SETGUIAUT 
  123.  
  124.         and enter the authorisation codes provided by your software supplier 
  125.         and press Enter. 
  126.  
  127.  
  128. ΓòÉΓòÉΓòÉ 1.2. Installation on the PC ΓòÉΓòÉΓòÉ
  129.  
  130.  Installation on the PC 
  131.  
  132.       1. If you have previously installed Guidelines on the PC then: 
  133.  
  134.          a. Move all your .GUI files, and any other user files, from directory 
  135.             Guide and its subdirectories.  You should also use this opportunity 
  136.             to back these files up. 
  137.  
  138.          b. Move all your .H files, and any other user files, from directory 
  139.             Css and its subdirectories. 
  140.  
  141.          c. Drop the Guide and Css directories into the shredder.  Delete the 
  142.             Guidelines and JBA Open ToolCASE folders. Delete the Guidelines 
  143.             Template from the Templates folder. 
  144.  
  145.          d. Delete all references to Guide and Css and their subdirectories in 
  146.             your Config.Sys and remove any environment variables set up by 
  147.             previous installations of Guidelines and/or Css.  These include SET 
  148.             JBAxxxx=, SET GUE=, SET BINDPATH=, SET HOSTTYPE=, SET CSSXLAT=, SET 
  149.             CSSSYN=, SET CSSLOC=, SET CSSPROFILE=. More environment variables 
  150.             may be listed in ReadMe.1st 
  151.  
  152.       2. If installing Guidelines from floppy disks, insert disk 1 into the 
  153.          drive and in an OS/2 session on the PC, enter the following commands: 
  154.  
  155.          a. A: (Change to floppy drive). 
  156.  
  157.          b. INSTALL (This starts up the main Guidelines installation program). 
  158.  
  159.       3. If installing Guidelines from an AS/400 shared folder, in an OS/2 
  160.          session on the PC, enter the following commands: 
  161.  
  162.          a. I: (Change to PC support drive, PC support must be up and running). 
  163.  
  164.          b. CD \GUI_INST.ALL (Shared folder restored from tape). 
  165.  
  166.          c. INSTALL (This starts up the main Guidelines installation program). 
  167.  
  168.       4. The following window will be displayed: 
  169.  
  170.       5. Select the Directories item from the Install menu pull down. The 
  171.          following window will be displayed: 
  172.  
  173.          The Install from path will default to the directory from which you 
  174.          have run the install program. 
  175.  
  176.          Set the Install to path to the directory into which you want to 
  177.          install Guidelines. Do not leave the Install to path the same as the 
  178.          Install from path. Set the Install to path to D:\Guide (where D: is a 
  179.          drive of your choice). Press the OK button. If the specified Install 
  180.          to directory does not exist, you will be prompted to create it. 
  181.  
  182.          Note:  This is the ONLY time that the Install to path is used. DO NOT 
  183.          use it to specify the Install to directories when installing 
  184.          extensions. It is explained below how to do this. 
  185.  
  186.       6. Select the Install Guidelines item from the Install menu pull down. 
  187.          The following window will be displayed: 
  188.  
  189.          In this window you can customize your installation. Unless you need to 
  190.          conserve disk space, accept the defaults. If your disk space is at a 
  191.          premium, you can choose not to install support for certain PC 
  192.          platforms and compilers. 
  193.  
  194.          The installer can be instructed to ignore any sample applications 
  195.          and/or documentation. You may also select to install either the 
  196.          Guidelines design-time support, or the run-time support, or both. 
  197.          However, note that if you disable both of these options, Guidelines 
  198.          will be unusable! 
  199.  
  200.       7. Make your selections and press the OK button. The following window 
  201.          will be displayed: 
  202.  
  203.          In this window you can specify which drives the install program will 
  204.          search for C++ compilers and tools. By default, all the local hard 
  205.          disk drives will be selected. You can select additional drives to 
  206.          search, such as non-local drives, or deselect drives which you know do 
  207.          not contain any compilers. 
  208.  
  209.          Note:  Selecting potentially large drives such as a network drive or a 
  210.          CD-ROM drive could cause the search portion of the install process to 
  211.          take considerably longer than usual. 
  212.  
  213.       8. Make your selections and press the OK button. The following window 
  214.          will be displayed: 
  215.  
  216.          If your name and company are displayed and your registration number 
  217.          has not changed since the previous instalation, there is no need to re 
  218.          enter the registration number. Else, enter the registration number 
  219.          (obtained from Agent Support) and your name and company. 
  220.  
  221.       9. Press the OK button. to start the install process. During this the 
  222.          following window will be displayed which indicates the progress of the 
  223.          installation: 
  224.  
  225.          If installing from floppy disks, insert disks as requested. 
  226.  
  227.          After the installation has completed, a message will be displayed 
  228.          advising you that Guidelines was installed successfully. 
  229.  
  230.          Note:  If you intend to continue on with these instructions, it is not 
  231.          necessary to re-boot the PC as suggested. 
  232.  
  233.      10. If installing Extension Packs from floppy disks, only one pack can be 
  234.          installed at a time. Insert an Extension Pack disk 1 and follow the 
  235.          procedure for installing from a shared folder, inserting floppy disks 
  236.          as requested. Repeat this process for each Extension Pack to be 
  237.          installed. Note that there is no need to reboot until all packs have 
  238.          been installed. 
  239.  
  240.      11. Select the Install Extensions option from the Install menu pull down. 
  241.          The following window will be displayed which contains a list of all 
  242.          the packs found in the Install from directory: 
  243.  
  244.          By default all the found packs will be selected for installation. 
  245.  
  246.          The target paths at the bottom of the dialog default to Guide and Css 
  247.          on the boot drive. Change the drives if required, accept these 
  248.          directories and press the OK button. If the Css directory does not 
  249.          exist, you will be prompted to create it. You will be presented with 
  250.          the window which allows you to customize the installation, followed by 
  251.          the registration number window. 
  252.  
  253.          Note:  There is no need to re-enter the registration number again, 
  254.          even if the entry field is empty. It will default to the number 
  255.          entered when installing the Guidelines base product. 
  256.  
  257.      12. When all the packs have been installed, select the Exit option from 
  258.          the Install menu pull down. 
  259.  
  260.      13. The installation is now complete, shut down OS/2 and reboot the PC. 
  261.  
  262.      The Guidelines desktop folder will allow you to start up Guidelines, run 
  263.      the Install program (for installing new packs) access sample GUIs and 
  264.      executables, gain access to help text and view installed products and 
  265.      their versions. 
  266.  
  267.      Startup Guidelines. If the Css directory is not on the boot drive, you 
  268.      will initially receive error messages to the effect that some Css header 
  269.      files have not been found. To overcome this, select the Environment option 
  270.      from the Output menu, and for each compiler that you intend to use, select 
  271.      Edit then Paths. A window similar to that shown below will be displayed: 
  272.  
  273.      Do the following: 
  274.  
  275.      For OS/2 platforms, either:- 
  276.  
  277.         Click the Use Config.Sys checkbox so that it is checked. 
  278.  
  279.      or:- 
  280.  
  281.          1. Modify the INCLUDE statement D:\Css\Inc, plus any other paths where 
  282.             application database or Guidelines DLL header files occur. 
  283.  
  284.          2. Modify the LIB statement to include D:\Css\OS2\Lib, plus any other 
  285.             paths where user library or Guidelines DLL library files occur. 
  286.  
  287.      Note:  D:\Css is the drive and directory into which you installed the 
  288.      Client/Server Support packs. 
  289.  
  290.      For Windows platforms:- 
  291.  
  292.          1. Modify the INCLUDE statement to include D:\Css\Inc, plus any other 
  293.             paths where application database or Guidelines DLL header files 
  294.             occur. 
  295.  
  296.          2. Modify the LIB statement to include D:\Css\Win\Lib, plus any other 
  297.             paths where user library or Guidelines DLL library files occur. 
  298.  
  299.      Note:  D:\Css is the drive and directory into which you installed the 
  300.      Client/Server Support packs. 
  301.  
  302.      Exit Guidelines, electing to Save Settings. 
  303.  
  304.      Note:  When you next start Guidelines, all the header files should be 
  305.      found successfully. 
  306.  
  307.      Existing users will need to re enter server and database definitions using 
  308.      the Css Configuration Utility in the JBA Open ToolCASE folder. 
  309.  
  310.      Before attempting to use any Client/Server functions to access an AS/400 
  311.      check: 
  312.  
  313.       1. You have configured your local Css configuration files using the Css 
  314.          configuration utility. 
  315.  
  316.       2. The Workstation Profile has the translation table entry filename 
  317.          specified as JBAGTAB.DAT, and this file exists in your Communications 
  318.          Manager directory. See Specifying the Translation Table 
  319.  
  320.       3. You can start up a 5250 workstation session and log in with a valid 
  321.          username and password. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 1.3. Specifying the Translation Table ΓòÉΓòÉΓòÉ
  325.  
  326.  Specifying the Translation Table 
  327.  
  328.  A new Communications Manager translation table must be set up, and the 
  329.  Communications Manager configuration must be changed to refer to it. These 
  330.  changes only need to be done once for any one Communications Manager 
  331.  configuration file, and may have been made when Communications Manager was set 
  332.  up. If you are not sure, follow these instructions to make the changes: 
  333.  
  334.   1. Open an OS/2 window or full-screen session. In the following commands, 
  335.      C:\CMLIB is assumed to be path that Communications Manager was installed 
  336.      to. If Communications Manager was installed to a different drive or 
  337.      directory, substitute that name instead. 
  338.  
  339.      Enter the following command: 
  340.  
  341.        DIR C:\CMLIB\JBAGTAB.DAT 
  342.  
  343.  If the file was found, skip the next step. If not, enter the following 
  344.  command: 
  345.  
  346.        COPY d:\css\DATA\JBAGTAB.DAT C:\CMLIB\JBAGTAB.DAT 
  347.  
  348.  Where d:\css is the drive and directory into which you installed Client/Server 
  349.  Support. 
  350.  
  351.   2. For Communications Manager Version 1 
  352.  
  353.      a. From the Communication Manager Main Menu, press F10 and select Advanced 
  354.         from the menu bar. 
  355.  
  356.      b. Select option 4 Configuration and press Enter to confirm the name of 
  357.         the configuration file you wish to modify. 
  358.  
  359.      c. Select option 1 Workstation Profile and then select option 2 Change to 
  360.         change the profile. 
  361.  
  362.      d. The workstation profile details are displayed. Ensure that the 
  363.         Translation Table option is specified as JBAGTAB.DAT. 
  364.  
  365.      e. Press Enter four times to save the changes. Press F10 and select option 
  366.         1 Run Verify from the Verify menu to verify your changes. The 
  367.         verification should complete without error. If errors do occur, consult 
  368.         your network administrator or your software supplier. 
  369.  
  370.         The changes to Communications Manager 1 are now complete. 
  371.  
  372.   3. For Communications Manager Version 2 (CM/2) 
  373.  
  374.      a. Open the Communications Manager/2 folder and double-click on the 
  375.         Communications Manager Setup icon. 
  376.  
  377.      b. Press OK then Setup. 
  378.  
  379.      c. Select the configuration file you wish to change from the right-hand 
  380.         list box and press OK 
  381.  
  382.      d. Select Change Workstation Information... from the Options menu. 
  383.  
  384.      e. Enter JBAGTAB.DAT into the field labelled ASCII/EBCDIC translation 
  385.         table file name and press OK 
  386.  
  387.      f. Press Close and then answer Yes to the question 'Would you like to 
  388.         dynamically update your SNA resources?' 
  389.  
  390.      g. Press Close 
  391.  
  392.         The changes to Communications Manager 2 are now complete. 
  393.