═══ 1. Installation on the AS/400 ═══ Installation of Guidelines on the AS/400 1. Sign onto the AS/400 as QSECOFR. 2. If you have previously installed the Guidelines library set on the AS/400 the following libraries may already exist on your machine: GUIDED1 GUIDEF1 GUIDEP1 Rename these libraries as follows: RNMOBJ OBJ(GUIDED1) OBJTYPE(*LIB) NEWOBJ(GUIDED1OLD) RNMOBJ OBJ(GUIDEF1) OBJTYPE(*LIB) NEWOBJ(GUIDEF1OLD) RNMOBJ OBJ(GUIDEP1) OBJTYPE(*LIB) NEWOBJ(GUIDEP1OLD) 3. If you have previously installed the Guidelines shared folder on the AS/400 then rename it as follows: RNMDLO DLO(GUI_INST.ALL) NEWDLO(GUI_INST.OLD) 4. Insert the supplied cartridge into your AS/400 tape drive. It is assumed throughout this document that the cartridge drive name is TAP01. If you are using a drive with a different name then substitute the name you are using. 5. Restore the Guidelines library set from the distribution cartridge with the following commands: RSTLIB SAVLIB(GUIDED1) DEV(TAP01) ENDOPT(*LEAVE) RSTLIB SAVLIB(GUIDEF1) DEV(TAP01) ENDOPT(*LEAVE) RSTLIB SAVLIB(GUIDEP1) DEV(TAP01) ENDOPT(*LEAVE) Check that all objects were restored for the library after each command. 6. Restore the Guidelines shared folder from the distribution cartridge with the following command: RSTDLO DLO(*ALL) SAVFLR(GUI_INST.ALL) DEV(TAP01) ENDOPT(*REWIND) NEWOBJ(*NEW) Check the resulting messages. The last message should say how many objects were restored. Note: There should be zero objects not installed. 7. To set up the library list on the AS/400 when PC sessions connect, the commands SETGUILIBL and RTVGUILIB must be available. To ensure that they are accessible, they should be copied to a library which is in all users library list. For example to duplicate the commands into QUSRSYS (which is part of QSYSLIBL), type the following: CRTDUPOBJ OBJ(SETGUILIBL) FROMLIB(GUIDEP1) OBJTYPE(*CMD) TOLIB(QUSRSYS) CRTDUPOBJ OBJ(RTVGUILIB) FROMLIB(GUIDEP1) OBJTYPE(*CMD) TOLIB(QUSRSYS) 8. If you have previously installed the Guidelines libaries, you can restore the host applications, library lists and authorisation codes from the GuideF1Old library. For each of CMP10, CMP11, CMP12, CMP13 and CMP91: CPYF FROMFILE(GUIDEF1OLD/CMPnn) TOFILE(GUIDEF1/CMPnn) MBROPT(*REPLACE) 9. If this is a new installation or additional AS/400 products have been installed, to enable the AS/400 communications programs to operate correctly, you must enter an authorisation code. Enter the command: GUIDEP1/SETGUIAUT and enter the authorisation codes provided by your software supplier and press Enter. 10. The DESKTOP GUIDELINES PACK has now been installed. Separate packs are also available, which, if supplied with the cartridge, should be loaded onto the AS/400 shared folder prior to loading Guidelines onto any PCs. Load the entire contents of any extension diskettes onto a PC (with PC Support loaded and connected to the AS/400 containing Guidelines (I drive)). To do this, place the diskette into the drive (A), and type: COPY A:\*.* I:\GUI_INST.ALL 11. Note: When installing Guidelines on the PC, it is faster to copy the contents of the shared folder to the PCs local hard disk first. ═══ 2. PIP Installation on the AS/400 ═══ Installation of Product Improvement Packs on the AS/400 1. Sign onto the AS/400 as QSECOFR. 2. From Guidelines Version 3 PIP3 onwards, the directory for PIPs will be in the format GUV3PIP.nnn instead of GUI_INST.PIP as in earlier releases. This allows multiple PIPs to remain loaded on the AS/400 and renaming is only required if reinstallation takes place (using the RNMDLO command). In this section nnn refers to the PIP number (eg. PIP3 is 003 etc). 3. Insert the supplied cartridge into your AS/400 tape drive. It is assumed throughout this document that the cartridge drive name is TAP01. If you are using a drive with a different name then substitute the name you are using. 4. If System 21 Application Manager is installed, this PIP may be loaded as with other System 21 application PTFs. 5. If System 21 Application Manager is not loaded, restore the Product Improvement Pack shared folder from the distribution cartridge with the following commands: RSTLIB LIB(P#GUV30nnn) DEV(TAP01) RSTDLO DLO(*ALL) SAVFLR(GUV3PIP.nnn) DEV(*SAVF) SAVF(P#GUV30nnn/GUV3Pnnn) NEWOBJ(*NEW) Check the resulting messages. The last message should say how many objects were restored. Note: There should be zero objects not installed. 6. The DESKTOP GUIDELINES PACK has now been installed. Other required Extension packs not included on the cartridge, should be loaded onto the AS/400 shared folder prior to loading Guidelines onto any PCs. Load the entire contents of any extension diskettes via a PC to the shared folder on the I drive. ═══ 3. Installation on the PC ═══ Installation of Guidelines on the PC 1. If you have previously installed Guidelines on the PC then: a) Move all your .GUI, .H, .HPP and any other user files, from the Guide and CSS directories and its subdirectories. You should also use this opportunity to back these files up. b) Drop the Guide and Css directories into the shredder. Delete the Guidelines and JBA Open ToolCASE folders. Delete the Guidelines Template from the Templates folder. c) Delete all references to Guide and Css and their subdirectories in your Config.Sys and remove any environment variables set up by previous installations of Guidelines and/or Css. These include SET JBAxxxx=, SET GUE=, SET BINDPATH=, SET HOSTTYPE=, SET CSSXLAT=, SET CSSSYN=, SET CSSLOC=, SET CSSPROFILE=. For further details refer to the ReadMe.1st file supplied. 2. Note: It can be considerably faster to copy the contents of all floppy disks or the contents of the AS/400 shared folder to the PCs local hard disk first. 3. If installing Guidelines from floppy disks, insert disk 1 into the drive and in an OS/2 session on the PC, enter the following commands: a) A: (Change to floppy drive). b) INSTALL (This starts up the main Guidelines installation program). 4. If installing Guidelines from a single directory, in an OS/2 session on the PC, enter the following commands: a) D: (Where D: is the drive where the packs are located). b) CD \GUI_INST.ALL (or to the directory where the packs have been copied to). c) INSTALL (This starts up the main Guidelines installation program). 5. The following window will be displayed: 6. Select the Directories item from the Install menu pull down. The following window will be displayed: The Install from path will default to the directory from which you have run the install program. Set the Install to path to the directory into which you want to install Guidelines. Do not make the 'Install To' path the same as the 'Install From' path. Set the Install To path to D:\Guide (where D: is a drive of your choice). Press the OK button. If the specified Install To directory does not exist, you will be prompted to create it. 7. Select the Install Guidelines item from the Install menu pull down. The following window will be displayed: In this window you can customize your installation. If your disk space is at a premium, you can choose not to install support for certain PC platforms and compilers. The installer can be instructed to ignore any sample applications and/or documentation. You may also select to install either the Guidelines design-time and run-time support, or the run-time support only. 8. Make your selections and press the OK button. The following window will be displayed: In this window you can specify which drives the install program will search for C++ compilers and tools. By default, all the local hard disk drives will be selected. You can select additional drives to search, such as network drives, or deselect drives which you know do not contain any compilers. Note: Selecting potentially large drives such as a network drive or a CD-ROM drive could cause the search portion of the install process to take considerably longer than usual. 9. Make your selections and press the OK button. The following window will be displayed: If your name and company are displayed and your registration number has not changed since the previous instalation, there is no need to re enter the registration number. Else, enter the registration number (obtained from Product Support) and your name and company. 10. Press the OK button. to start the install process. During this the following window will be displayed which indicates the progress of the installation: If installing from floppy disks, insert disks as requested. After the installation has completed, a message will be displayed advising you that Guidelines was installed successfully. Note: You will only need to re-boot the PC when you have fully completed installation. If a message appears advising to to re-boot, you may safely treat it as a reminder that you must re-boot before you run Guidelines. 11. If installing Extension Packs from floppy disks, only one pack can be installed at a time. Insert an Extension Pack disk 1 and follow the procedure for installing from a single directory, inserting floppy disks as requested. Repeat this process for each Extension Pack to be installed. Note that there is no need to reboot until all packs have been installed. 12. Select the Install Extensions option from the Install menu pull down. The following window will be displayed which contains a list of all the packs found in the Install From directory: By default all the found packs will be selected for installation. The extension files will be installed into the directory specified in the Directories menu item from the main window. You will be presented with the window which allows you to customize the installation, followed by the registration number window. Note: There is no need to re-enter the registration number again, even if the entry field is empty. It will default to the number entered when installing the Guidelines base product. 13. When all the packs have been installed, select the Exit option from the Install menu pull down. 14. The installation is now complete, shut down OS/2 and reboot the PC if necessary. ═══ 4. PIP Installation on the PC ═══ Installation of Product Improvement Pack on the PC 1. When installing, treat the PIP as a Guidelines Extension. 2. Note that the Guidelines Base Pack (GDR) PIP should also be installed as an extension. All PIPs must be loaded to the same directories as the main Guidelines Packs. 3. See the documentation supplied with the PIP for specific details, including pre-requisites for installation. ═══ 5. Specifying the Translation Table ═══ Specifying the Translation Table A new Communications Manager translation table must be set up, and the Communications Manager configuration must be changed to refer to it. These changes only need to be done once for any one Communications Manager configuration file, and may have been made when Communications Manager was set up. If you are not sure, follow these instructions to make the changes: 1. Open an OS/2 window or full-screen session. In the following commands, C:\CMLIB is assumed to be path that Communications Manager was installed to. If Communications Manager was installed to a different drive or directory, substitute that name instead. Enter the following command: DIR C:\CMLIB\JBAGTAB.DAT If the file was found, skip the next step. If not, enter the following command: COPY d:\css\DATA\JBAGTAB.DAT C:\CMLIB\JBAGTAB.DAT Where d:\css is the drive and directory into which you installed Client/Server Support. 2. Update Communications Manager following the steps below, dependant on which version of the product is installed: For Communications Manager Version 1 a) From the Communication Manager Main Menu, press F10 and select Advanced from the menu bar. b) Select option 4 Configuration and press Enter to confirm the name of the configuration file you wish to modify. c) Select option 1 Workstation Profile and then select option 2 Change to change the profile. d) The workstation profile details are displayed. Ensure that the Translation Table option is specified as JBAGTAB.DAT. e) Press Enter four times to save the changes. Press F10 and select option 1 Run Verify from the Verify menu to verify your changes. The verification should complete without error. If errors do occur, consult your network administrator or your software supplier. The changes to Communications Manager 1 are now complete. For Communications Manager Version 2 (CM/2) a) Open the Communications Manager/2 folder and double-click on the Communications Manager Setup icon. b) Press OK then Setup. c) Select the configuration file you wish to change from the right-hand list box and press OK d) Select Change Workstation Information... from the Options menu. e) Enter JBAGTAB.DAT into the field labelled ASCII/EBCDIC translation table file name and press OK f) Press Close and then answer Yes to the question 'Would you like to dynamically update your SNA resources?' g) Press Close The changes to Communications Manager 2 are now complete.