home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / viscobv1.zip / install.txt < prev    next >
Text File  |  1998-03-24  |  44KB  |  1,013 lines
  1. ===========================================================================
  2.  
  3.                 VisualAge COBOL Enterprise for OS/2 V2.2
  4.  
  5.  
  6.                            Installation Notes
  7.  
  8. ===========================================================================
  9.  
  10. 1.0  Before You Install
  11. 2.0  Hints and Tips for Installing VisualAge COBOL
  12. 3.0  Trouble-Shooting for Installing VisualAge COBOL
  13. 4.0  Installing the Application Understanding Host JCL Scanner
  14. 5.0  Unattended Install
  15.  
  16.  
  17. 1.0  Before You Install
  18. ==================
  19.  
  20. 1.1  To install the product:
  21. ---------------------------
  22.  
  23. 1. Uninstall any previous versions of the product from the system.
  24.  
  25.    Important!
  26.  
  27.    If you have a previous release of VisualAge COBOL installed and
  28.    have created projects on the desktop, move those projects into a
  29.    folder on the desktop before uninstalling your current release of
  30.    VisualAge COBOL.
  31.  
  32.    Projects left on the desktop will lose inheritance information,
  33.    which may impact the ability to migrate them to VisualAge COBOL
  34.    Version 2.2.
  35.  
  36. 2. Insert the VisualAge for COBOL CD-ROM or access the LAN where the
  37.    VisualAge COBOL image resides.
  38.  
  39. 3. From the command line, change to the directory where the installation
  40.    program is located (for the CD-ROM, it is the root directory).
  41.  
  42. 4. For a basic installation, type:
  43.      install
  44.    from the command line.
  45.  
  46.    For a shared installation, enter:
  47.      shrdinst
  48.    from the command line.
  49.  
  50.    (If you're not sure which you should choose, read "Choosing Basic or
  51.    Shared Installation" in the "Getting Started" (GC26-9051) manual.
  52.  
  53.    The main "VisualAge COBOL Installation" window and the "Instructions"
  54.    window appear.
  55.  
  56. 5. Follow the prompts to proceed with the installation. See section 2.0
  57.    "Hints and Tips for Installing VisualAge COBOL" in this file for more
  58.    installation information.
  59.  
  60.    Some components require that other components get installed. When you
  61.    select a certain component you may see others also selected. For
  62.    example, the COBOL Editor requires WorkFrame. The installation utility
  63.    automatically selects any other components required.
  64.  
  65.    Note: The "Update CONFIG.SYS" box directs the install program to
  66.    automatically update your CONFIG.SYS file. A copy of your original
  67.    unmodified CONFIG.SYS file is saved as the next unused file name in the
  68.    ascending sequence of CONFIG.001, CONFIG.002, and so on. A higher number
  69.    in the file name extention indicates a more recent copy. This box is
  70.    checked by default. We recommend you leave this box checked to update
  71.    CONFIG.SYS automatically. If you choose not to have the install program
  72.    update your CONFIG.SYS, you must make the changes yourself before you
  73.    run VisualAge COBOL. For the changes, see the CONFIG.ADD file in the
  74.    same drive and path as CONFIG.SYS (this file is created by VisualAge COBOL
  75.    following installation).
  76.  
  77. 6. A message window tells you when the installation is complete. Shut down
  78.    and restart your system to make the changes to your CONFIG.SYS file take
  79.    effect.
  80.  
  81. For information on hardware and software requirements, see "Hardware and
  82. Software Requirements" in the "Getting Started" manual.
  83.  
  84. For more information on the product or to report problems, visit the
  85. following web site:
  86.   http://www.software.ibm.com/ad/vacobol
  87.  
  88.  
  89. 2.0  Hints and Tips for Installing VisualAge COBOL
  90. ==================================================
  91.  
  92. The following is a list of items that you should be aware of during the
  93. install:
  94.  
  95. 2.1)  Be certain that the drive with your swapper file has enough space.
  96.       The installation program could add 15MB to your swapper if your RAM
  97.       is being used by other programs.
  98.  
  99. 2.2)  When transferring files to another computer, be aware that files for
  100.       desktop objects (such as projects) have extended attributes, which are
  101.       not supported on some file systems and file transfer utilities (for
  102.       example: DOS, TCP/IP, PKZIP). Such files can be packed using EPFIPAK2
  103.       (which can be found in the directory \IBMCOBOL\CLIENTPK), transferred
  104.       to the other computer and unpacked using EPFIUPK2 (which can be found
  105.       in the directory \IBMCOBOL\CLIENTPK).
  106.  
  107. 2.3)  Using HPFS, you should not install VisualAge COBOL in a directory
  108.       structure that  has a blank as part of the directory name. For
  109.       example:
  110.           D:\VisualAge COBOL\PRODUCT
  111.       The install itself works, however, some components do not run
  112.       correctly.
  113.  
  114. 2.4)  If you do not install the full product, certain topics in the
  115.       "Information Notebook" might not be available.
  116.  
  117. 2.5)  Determine if you need to place CONFIG.DFM in a directory: If you are
  118.       using APPC for host/workstation communication, you must also install
  119.       the SdU component. Remote E/C/D requires the CONFIG.DFM file (which
  120.       VisualAge COBOL installs in the IBMCOBOL\SAMPLES\SDU directory). You
  121.       need to copy the CONFIG.DFM file into the IBMCOBOL\MACROS directory.
  122.       We suggest that you keep the original, unmodified  version of
  123.       CONFIG.DFM in the IBMCOBOL\SAMPLES\SDU directory for recovery
  124.       purposes.
  125.  
  126. 2.6)  Update the COBLPATH4 environment variable in your CONFIG.SYS: If,
  127.       before installing VisualAge COBOL, you had an LPATH or LPATH2
  128.       environment variable that pointed to private LPEX macros, then you need
  129.       to append the contents of the LPATH or LPATH2 environment variable to
  130.       the contents of the COBLPATH4 environment variable (which is created by
  131.       VisualAge COBOL).
  132.  
  133.       For example, if LPATH or LPATH2 contained:
  134.           D:\MYMACROS
  135.       As a result of installing VisualAge COBOL assume the COBLPATH4
  136.       environment variable was set to:
  137.           E:\IBMCOBOL\MACROS
  138.       Then you should update the COBLPATH4 environment variable to:
  139.           E:\IBMCOBOL\MACROS;D:\MYMACROS
  140.       then your private macros that were in D:\MYMACROS are available.
  141.  
  142. 2.7)  If you are going to develop Object Oriented applications, you must
  143.       install the Warp Toolkit development tools (to have SOM available).
  144.  
  145. 2.8)  The installation of VisualAge COBOL, by default, sets the LANG
  146.       variable in your CONFIG.SYS to En_US. If, however, you already have
  147.       the LANG variable set, the install does not attempt to change the
  148.       LANG variable.
  149.  
  150. 2.9)  Product Incongruencies: The following products or components cannot
  151.       co-exist on the same machine:
  152.       - COBOL GUI Designer and VisualAge RPG
  153.       - VisualAge COBOL and the workstation feature of CODE/370
  154.         (Remote Edit/Compile/Debug has equivalent function.)
  155.       - Remote Edit/Compile/Debug and
  156.         - CODE/400
  157.         - CODE/370
  158.         - VisualAge RPG
  159.  
  160.         Installation of VisualAge COBOL with products or components listed
  161.         may result in failures of some functions in those products.
  162.  
  163.  
  164. 2.10) Remote E/C/D: The file MVSINFO.DAT, located in the MACROS directory,
  165.       is deleted if you uninstall Remote E/C/D. This file contains user
  166.       configuration information (like system name and userID) for Remote
  167.       E/C/D. Copy MVSINFO.DAT to a user directory before uninstall so you
  168.       do not lose your own configuration information. After a reinstall you
  169.       can copy MVSINFO.DAT back to the MACROS directory.
  170.  
  171.       Note: There have been some minor changes to the MVSINFO.DAT file for
  172.       the new release. An old MVSINFO.DAT file still works. You may
  173.       choose to update the new MVSINFO.DAT file with the data from the old
  174.       MVSINFO.DAT file.
  175.  
  176. 2.11) SMARTdata UTILITIES:
  177.       - Remote VSAM access to MVS alternate index files depends on the
  178.         installation of two MVS DFSMS APARs:
  179.             OW20884 and OW23571 (these APARs apply to DFSMS Version 1.4.0
  180.         and below).
  181.         In addition, the DFM startup parameter MAX_CONV_LOCK in the DFM00
  182.         member of the MVS system parmlib should be set to the maximum number
  183.         of 100. (The IEFPARM statement in the DFM procedure identifies the
  184.         system parmlib.)
  185.       - COBOL "Return Status = 02" when accessing remote MVS indexed files
  186.         with alternate keys that allow duplicates depends on the
  187.         installation of the MVS DFSMS APAR:
  188.             OW26104 (this APAR applies to DFSMS Version 1.4.0 and below).
  189.         This return status indicates an input-output statement was
  190.         successfully executed but a duplicate key was detected.
  191.  
  192. 2.12) Transaction Assistant: CICS Setup: To execute an application that
  193.       contains code generated by Transaction Assistant requires the CICS
  194.       Client to be installed. If both the CICS for OS/2 and the CICS Client
  195.       are on the same machine, make sure that the CICS Client entries
  196.       precede the CICS for OS/2 entries in the LIBPATH statement in
  197.       CONFIG.SYS.
  198.  
  199. 2.13) Only for LPEX on OS/2 Warp Version 4 with FixPak 5 applied: Under
  200.       certain conditions when closing the last LPEX window, LPEX generates
  201.       an exception. The exception occurs after LPEX has finished all
  202.       critical processing, such as saving user data. If you are running
  203.       with AUTOFAIL set to YES you probably will not be aware of the
  204.       exception. If you are running with AUTOFAIL set to NO, a SYS3175
  205.       exception message box is displayed. AUTOFAIL is set in CONFIG.SYS.
  206.  
  207.  
  208. 3.0  Trouble-Shooting for Installing VisualAge COBOL
  209. ====================================================
  210.  
  211.  
  212. 3.1  If Something Goes Wrong
  213. ----------------------------
  214.  
  215.     This section describes what to do if you encounter a problem or an
  216.     error when you run the install program. Online help is also available
  217.     for error messages, both from the "Help" button on the message window,
  218.     or from the index or contents of the online install help.
  219.  
  220.     Q: If you Get an Error Message
  221.  
  222.     A: Select the "Help" button for the error for information on how to
  223.        correct it. Also note the message number and the file name where
  224.        the error occurred, if one is indicated. If you cannot successfully
  225.        complete the installation and have to call VisualAge COBOL Service
  226.        and Support, this information may help identify your problem (see
  227.        "Getting Support for Using VisualAge COBOL" in the "Getting Started"
  228.        manual).
  229.  
  230.     Q: If You Select Stop
  231.  
  232.     A: If you select the "Stop" button on the Install progress window, the
  233.        install program immediately stops and displays a window that asks
  234.        if you want to back out of the installation so far. You cannot
  235.        resume the install program from this point; you must end it and
  236.        start again.
  237.  
  238.        In the confirmation window:
  239.        - Select "Yes" to undo everything that the install program has
  240.          done up to that point. We recommend you choose this option. Any
  241.          desktop objects are deleted.
  242.        - Select "No" to leave the files that have already been installed.
  243.  
  244.        Once the program has ended, you can restart it from the beginning.
  245.  
  246.     Q: If the Install Program Fails
  247.  
  248.     A: If the install program fails, it displays a window that asks if you
  249.        want to back out of the installation:
  250.        - Select "Yes" to undo everything that the install program has done
  251.          up to that point. We recommend you choose this option.
  252.        - Select "No" to leave the files that have already been installed.
  253.  
  254.        The most likely reason for the failure is that not enough disk
  255.        space is available. To solve this problem:
  256.        - Make more room on your target drive.
  257.        - Choose a different target drive.
  258.        - Select fewer components to install.
  259.  
  260.        If disk space is not a problem, run CHKDSK on the:
  261.        - Drive where OS/2 is installed
  262.        - Target drive to ensure there are no file system problems.
  263.  
  264.        If you are using a response file, make sure you specified responses
  265.        for CFGUPDATE, DELETEBACKUP, FILE, SAVEBACKUP, and WORK, and at
  266.        least one component name for COMP. If you do not give responses for
  267.        these keywords, the install program may fail. Make sure that you
  268.        specified the component names correctly. Also make sure that you
  269.        specified the required command-line options as described in the
  270.        "Unattended Install" section below, in "Installing Using Response
  271.        Files".
  272.  
  273.        If you try the install program again with the response file,
  274.        specify the command-line options: /L1:errorlog and /L2:historylog
  275.        to create an error log and history log, respectively. Specify the
  276.        path and file name for both. If the problem still occurs, these
  277.        logs may help you determine the cause.
  278.  
  279.        If you have tried all of these suggestions and the install program
  280.        still fails, contact VisualAge COBOL Service and Support (see
  281.       "Getting Support for Using VisualAge COBOL" in the "Getting Started"
  282.        manual).
  283.  
  284.     Q: If You Can't Delete an Object Because It's in Use
  285.  
  286.     A: When you delete a component, if any objects or files are in use,
  287.        they are not deleted. A message informs you when this happens. The
  288.        rest of the component and its desktop objects are deleted.
  289.  
  290.        After you shut down and restart your system, these objects should
  291.        be deleted automatically.
  292.  
  293.        If they are not, run the delete action again. From an OS/2 command
  294.        line, change to the directory containing the Compiler and Nonvisual
  295.        Tools and type: epfinsts. If this fails, rename the subdirectory,
  296.        shut down, and try to delete it again.
  297.  
  298.     Q: If VisualAge COBOL Doesn't Appear in the Installation Utility
  299.  
  300.     A: If you start the Installation Utility and VisualAge COBOL is not
  301.        listed in the window, select "Installed Products" from the "View"
  302.        menu to display it.
  303.  
  304.     Q: If You Can't Install Additional Components
  305.  
  306.     A: If you attempt to use the Installation Utility to install additional
  307.        components and get an error of EPFIE114, you must select the drive
  308.        where the install image resides. See step 2 in the "Reinstalling or
  309.        Installing Components" section below, under "Method 2: Using the
  310.        Installation Utility to Add or Delete Components".
  311.  
  312.     Q: If You've Tried Everything and It Still Doesn't Work
  313.  
  314.     A: If the install program continues to fail after you've tried
  315.        everything suggested by the error message help and this section,
  316.        contact VisualAge COBOL Service and Support (see "Getting Support
  317.        for Using VisualAge COBOL" in the "Getting Started" manual).
  318.  
  319.        Be sure to inform them what error messages you see, and what file
  320.        names,if any, are given in those messages. If you are using
  321.        response files, tell them the contents of your error and history
  322.        logs.
  323.  
  324.  
  325. 3.2  Reinstalling or Installing Components
  326. ------------------------------------------
  327.  
  328.     To reinstall a component or the entire product, you must first delete
  329.     the entire product.
  330.  
  331.     You can use one of three methods to add or delete components:
  332.  
  333.     1. Run the original install program interactively (see "Method 1"
  334.        below).
  335.  
  336.     2. Use the Installation Utility icon from the main "VisualAge COBOL"
  337.        window (see "Method 2" below).
  338.  
  339.     3. Run the original install program with a response file.
  340.  
  341.  
  342.     The steps for methods 1 and 2 are very similar, other than the initial
  343.     interface. The steps for using a response file are described in the
  344.     "Unattended Install" section below in "Adding or Deleting Components
  345.     Using a Response File".
  346.  
  347.     Important: Before uninstalling Remote E/C/D, copy the file MVSINFO.DAT
  348.     from the IBMCOBOL\MACROS directory into a separate user directory or
  349.     diskette. When uninstalling Remote E/C/D, VisualAge COBOL deletes the
  350.     MVSINFO.DAT file, which contains user customization information (such
  351.     as the MVS system address and TSO userid). After you reinstall Remote
  352.     E/C/D, copy the original MVSINFO.DAT file back into the IBMCOBOL\MACROS
  353.     directory.
  354.  
  355.     Important Information for Shared Install!
  356.     -----------------------------------------
  357.     If you are adding components, make sure you have access to the LAN
  358.     directory where the VisualAge COBOL installation files reside. If not,
  359.     VisualAge COBOL attempts to install on the drive where the local files
  360.     from the shared install reside. VisualAge COBOL then issues an error
  361.     message stating the drive is not ready.
  362.  
  363.  
  364.     3.2.1  Method 1: Using the Install Program to Add or Delete Components
  365.     ----------------------------------------------------------------------
  366.  
  367.     1. Insert the VisualAge COBOL CD-ROM, or access the LAN where the
  368.        VisualAge COBOL image resides.
  369.  
  370.     2. From the command line, change to the directory where the installation
  371.        program is located. (For the CD-ROM, it is the root directory; for
  372.        the LAN directory name, ask your LAN administrator.)
  373.  
  374.     3. On the command line:
  375.        - For a basic installation, type: install
  376.        - For a shared installation, type: shrdinst
  377.  
  378.        The main "VisualAge COBOL Installation" window and the
  379.        "Instructions" window appear.
  380.  
  381.     4. Select "Continue" in the Instructions window.
  382.  
  383.        The "Installation options" window appears showing the following
  384.        options:
  385.  
  386.        - Update the currently installed components
  387.  
  388.          Do not use this option. It is provided to support corrective
  389.          service (CSDs) for VisualAge COBOL. To reinstall a component,
  390.          delete it first, then reinstall.
  391.  
  392.        - Delete the installed components and re-install
  393.  
  394.          Choose this option to delete the installed components, including
  395.          their Desktop objects and entries in any .INI files. You can then
  396.          reinstall them if you want. If you want to update components, but
  397.          think you may have corrupted your Desktop objects or .INI entries,
  398.          choose this option to delete the components entirely. Then
  399.          reinstall them.
  400.  
  401.  
  402.     3.2.2  Method 2: Using the Installation Utility to Add or Delete
  403.     ----------------------------------------------------------------
  404.     Components
  405.     ----------
  406.  
  407.     1. From the task bar, select "VisualAge COBOL", then select the
  408.        "Install/Uninstall Utility" icon.
  409.  
  410.     2. To add components:
  411.  
  412.        a. From the "File" pull-down, select "Open Catalog". Select "Drive".
  413.           The "Open drive catalog" window appears. In the "Drive" entry
  414.           field, select the drive where the install image resides (CD-ROM
  415.           or a LAN drive). In the "Filename" entry field, ensure that
  416.           /IBMCOBOL.ICF is displayed. Click on "Open".
  417.  
  418.        b. From the "Action" pull-down, select "Install".
  419.  
  420.  
  421.     3.2.3  Updating Components for Corrective Service
  422.     -------------------------------------------------
  423.  
  424.     Once you have gone through the steps in "Reinstalling or Installing
  425.     Components" above, and arrived at the Installation options window:
  426.  
  427.     1. Choose "Update the currently installed components" and select
  428.        "Continue".
  429.  
  430.        The Update window appears, displaying the product information.
  431.  
  432.     2. When you've chosen the options you want, select "Update".
  433.  
  434. For more trouble-shooting information, see the Product README file on the
  435. CD or click on the "Trouble-Shooting" button in the "Information Notebook".
  436.  
  437.  
  438. 4.0  Install the Application Understanding Host JCL Scanner
  439. ===========================================================
  440.  
  441. If you want to use Application Understanding (AU) to scan JCL on a VSE
  442. host system, you need the VSE JCL Scanner, which will be available
  443. in the next release of VSE.
  444.  
  445. The MVS JCL Scanner is shipped with VisualAge COBOL for OS/2. THESE HOST
  446. PARTS MUST BE MANUALLY UPLOADED TO MVS. These parts do not need to be
  447. uploaded to the host again once done successfully.
  448.  
  449. The MVS subdirectory on the drive and under the main directory that you
  450. installed AU contains the following host parts:
  451.  
  452. ARDV000.CLI
  453.     Use this clist to submit the JCL scan FROM THE WORKSTATION. The Remote
  454.     E/C/D component must be installed and setup to submit the JCL scans
  455.     from the workstation. This sample clist must be modified for your
  456.     installation and added as member ARDV000 to the userid.ARD.CLIST PDS,
  457.     which must be available to the NFS transaction defined for VisualAge
  458.     COBOL. The ARDV000.CLI datasets allocation (default) values are:
  459.     Record Format=FB, Record Length=80, Block Size=6160, Primary
  460.     Quantity=7, Secondary Quantity=24.
  461.  
  462. ARDV000.JCL
  463.     Use this JCL to run the JCL scan in batch on MVS. This sample JCL must
  464.     be modified for your installation and added to a JCL PDS. The
  465.     ARDV000.JCL datasets allocation (default) values are: Record Format=FB,
  466.     Record Length=80, Block Size=6160, Primary Quantity=7, Secondary
  467.     Quantity=24.
  468.  
  469. ARDV00.LOD
  470.     This file is a loadlib that has been unloaded into a sequential file
  471.     using the MVS XMIT utility. It must be sent to your MVS system and
  472.     transformed back into a loadlib.
  473.  
  474.     If you use the sample CLIST, ARDV000.CLI to run the JCL scan on MVS,
  475.     the loadlib must then be made available to the NFS transaction defined
  476.     for VisualAge COBOL.
  477.  
  478.     If you use the sample JCL, ARDV000.JCL, to submit the JCL scan on MVS,
  479.     this loadlib must be available to the batch job running the JCL scan.
  480.     You may want to use the batch job when scanning many JOBs (100s of
  481.     members of a PDS) in a single run especially if your NFS transaction
  482.     has a time limit measured in seconds.
  483.  
  484.  
  485. 4.1  Creating the ARDV000 LOADLIB
  486. ---------------------------------
  487.  
  488. The steps to create ARDV000 LOADLIBs on your MVS system are:
  489.  
  490. 1. On your MVS system
  491.  
  492.    Allocate a sequential file to receive ARDV000.LOD. This dataset has:
  493.    Record Format=FB, Record Length=80, Block Size=3120, Space=250 blocks,
  494.    Secondary Blocks=5.
  495.  
  496. 2. On your workstation
  497.  
  498.    Send ARDV000.LOD to the file allocated on your MVS system. To do this,
  499.    open a command window and position to the drive where ARDV000.LOD was
  500.    installed by entering: d:, where "d" is the drive containing
  501.    redevelopment tools.
  502.  
  503.    Then enter: cd ibmcobol\mvs
  504.  
  505.    This command makes MVS the current directory.
  506.  
  507.    Then enter: send ardv000.lod b:'userid.ardv000.lod'
  508.    where:
  509.    o send is the Communication Manager command
  510.    o ardv000.lod is the part from the MVS directory
  511.    o b: is your Communication Manager session for MVS
  512.    o userid.ardv000.lod is the sequential dataset you allocated in step 1.
  513.  
  514. 3. From your MVS system
  515.  
  516.    Create the loadlib from the sequential dataset. From the MVS ready
  517.    prompt enter: receive indsn('userid.ardv000.lod')
  518.    where: userid.ardv000.lod is the sequential dataset you allocated in
  519.           step 1.
  520.  
  521.    At the prompt to enter the name to be used for loadlib, enter:
  522.      dsn('<high-level-qualifiers>.ardv000.loadlib')
  523.  
  524.    The loadlib is allocated if it does not already exist and the sequential
  525.    file is transformed into a loadlib and copied to it. If you wish to
  526.    allocate the loadlib prior to issuing the receive, the attributes for a
  527.    3380 device are: Record Format=U, Record Length=0, Block Size =32760,
  528.    Space=Tracks, Secondary=15 Tracks, Directory Blocks=10).
  529.  
  530.  
  531. 4.2  Allocating MVS Datasets
  532. ----------------------------
  533.  
  534. The following MVS datasets must be allocated before the JCL scan is run:
  535.  
  536. Note: The value .yyyy used in the following instructions represents 0 or
  537. more qualifiers used in your MVS dataset names.
  538.  
  539. CDIF PDS
  540.    userid.yyyy.CDIF (VF, 255, 23476) Information extracted from the
  541.    scanned JCL is placed in this dataset. The first time you run the
  542.    Application Understanding JCL request you need to specify this PDS name.
  543.    Size is determined by how many scans you wish to save. Each scan generates
  544.    a member that can be several times larger than the JCL being scanned
  545.    because the JCL is exploded to include the JCL from called PROCs.)
  546.  
  547. Message Log PDS
  548.    userid.yyyy.MSG (VB, 255, 23476) A list of the JCL member scanned and
  549.    any error encountered during the scan is placed in this dataset. The
  550.    first time you run the Application Understanding JCL Scan request you
  551.    need to specify this PDS name. This is a relatively small PDS containing
  552.    one member for each JCL scan that your run.
  553.  
  554. ProcLib List
  555.    userid.yyy.ARDLIB sequential data set (FB, 80, 3200) (1 track should be
  556.    sufficient). If you are using the sample CLIST to run the JCL scan from
  557.    the workstation, you must edit this dataset creating one line for each
  558.    procedure library used by the JCL being scanned.
  559.  
  560.    The following is an example file:
  561.      SYS1.ADPROC
  562.      SYS1.PP.PROCLIB
  563.      USERID.ABC.TESTPROC
  564.  
  565.    If you are using the sample JCL (found in ARDV000.JCL located in the
  566.    directory \IBMCOBOL\MVS) to submit the JCL scan on MVS, you can EITHER:
  567.  
  568.    - Create one line for each proclib used (as described above) and provide
  569.      the userid.yyy.ARDLIB data set name on the //ARDLIB DD statement in
  570.      the sample JCL.
  571.    - List the proclib data set names directly in the sample JCL on the
  572.      //ARDLIB DD statement in the JCL.
  573.  
  574.  
  575. 5.0  Unattended Install
  576. =======================
  577.  
  578. This section describes the response file that you can tailor for
  579. unattended install, the different command-line options you can use and
  580. the values the install program returns. It also gives instructions on
  581. installing using Response files.
  582.  
  583.  
  584. 5.1  Response File Format and Parameters
  585. ----------------------------------------
  586.  
  587. The response file is a flat ASCII file that consists of a number of
  588. response lines and optional comment lines. Lines can be up to 255 bytes
  589. in length, and are separated by a new-line sequence.
  590.  
  591. A comment line begins with an asterisk (*) or semi-colon (;). Response
  592. lines tell the install program how to install. Each response line has the
  593. format:
  594.    keyword = response
  595. Keywords are not case sensitive.
  596.  
  597. For the VisualAge COBOL install program, the keywords and the responses to
  598. specify for each are:
  599.  
  600. __________________________________________________________________________
  601.  
  602.  
  603. Keyword        Response
  604. -------        --------
  605.  
  606. CFGUPDATE      AUTO to automatically update CONFIG.SYS; MANUAL to not
  607.                update CONFIG.SYS. If you choose not to update CONFIG.SYS
  608.                automatically, you must update it yourself before you
  609.                reboot (see the CONFIG.ADD file that VisualAge COBOL
  610.                generates). The install program prompts you to confirm that
  611.                this is what you want.
  612.  
  613. COMP           The name of a component to install. You must specify each
  614.                component with its own COMP keyword. Note that many
  615.                components require that other components be installed to
  616.                work correctly. All the components are listed in
  617.                UNATTEND.RSP; you can delete any you do not want.
  618.  
  619. COPY           The source and target files for a copy process outside of
  620.                the install program. This parameter is useful if you are
  621.                using an SDM to install VisualAge COBOL over a LAN, and
  622.                you want to copy other files that are not part of
  623.                VisualAge COBOL to the workstations. The format for COPY
  624.                is:
  625.                   COPY = sourcefile targetfile
  626.                If targetfile already exists, it is overwritten. If either
  627.                file specification is incorrect, the copy is not done.
  628.  
  629. DELETEBACKUP   YES to delete a backup version along with the product when
  630.                Delete is chosen; NO to keep the backup version. This
  631.                setting is only used when you delete the product. See
  632.                "Reinstalling or Installing Components" in "Trouble-Shooting
  633.                for Installing VisualAge COBOL", section 3.0 in this file
  634.                for details on deleting the product.
  635.  
  636. FILE           The directory where you want to install your COBOL product.
  637.  
  638. INCLUDE        The name of another response file to include. You can have
  639.                up to five levels of nested response files. If you don't
  640.                specify the fully-qualified file name, the install program
  641.                looks for the response file using the following search
  642.                order:
  643.  
  644.                1.  The current directory.
  645.                2.  The path specified by the /G command-line option.
  646.                3.  Directories specified by the PATH environment variable.
  647.                4.  Directories specified by the DPATH environment variable.
  648.  
  649.                If the file name specified contains a wildcard character
  650.                (* or?), the first matching file is used.
  651.  
  652. SAVEBACKUP     Yes to save a backup copy; NO to not save a backup. This
  653.                setting is only used when you install corrective service
  654.                (CSDs) for VisualAge COBOL.
  655.  
  656. USEREXIT       The name of a program that you want the install program to
  657.                call. This is useful if you are installing VisualAge COBOL
  658.                using an SDM, and want to perform additional tasks. If you
  659.                do not specify the fully-qualified file name, the install
  660.                program looks for the program file using the following
  661.                search order:
  662.  
  663.                1.  The current directory.
  664.                2.  Directories specified by the PATH environment variable.
  665.                3.  Directories specified by the DPATH environment variable.
  666.  
  667.                If the file name specified contains a wildcard character
  668.                (* or ?), the first matching file is used.
  669.  
  670. WORK           The directory where you want to install the Warp Toolkit.
  671.  
  672. You must specify responses for the CFGUPDATE, DELETEBACKUP, FILE,
  673. SAVEBACKUP, and WORK keywords, and specify at least one component for the
  674. COMP keyword, for the install program to work correctly.
  675.  
  676.  
  677. 5.2  Command-Line Options
  678. -------------------------
  679.  
  680. You can specify a number of command-line options for the
  681.    install
  682. command. If you run install or shrdinst interactively, you don't have to
  683. specify any options. If you run install with a response file, you must
  684. specify
  685.  
  686.    install2:
  687.      /A
  688.      /C
  689.      /O
  690.      /P
  691.      /R
  692.      /X
  693. All other options are optional.
  694.  
  695. __________________________________________________________________________
  696.  
  697.  
  698. The command-line options are:
  699.  
  700.  
  701. Option                         Description
  702. ------                         -----------
  703. /A:action                      Specifies the action to perform,
  704.                                    action
  705.                                can be any of:
  706.  
  707.                                D       Delete.
  708.                                I       Install.
  709.                                U       Update. (Note that you should only
  710.                                        use this action when you are
  711.                                        installing corrective service
  712.                                        (CSDs) to VisualAge COBOL.
  713.  
  714. /C:<sourcedir>\IBMCOBOL.ICF    Specifies the catalog file that contains
  715.                                the information about the VisualAge COBOL
  716.                                files. You must specify the drive and
  717.                                directory, which are the same as the
  718.                                install program.
  719.  
  720.                                Note: <sourcedir> is the source directory
  721.                                      where source files reside.
  722.  
  723.  
  724. /G:includepath                 Specifies the path the install program
  725.                                should use to locate response files.
  726.  
  727. /L1:<targetdir>\errorlog       Specifies the error log file. The install
  728.                                program logs the install events in this
  729.                                file and prefixes them with a time stamp.
  730.                                If you do not specify a path and file name,
  731.                                IWZINSTS.OUT is created in the temporary
  732.                                install directory (usually on the drive
  733.                                with the most available space). If you do
  734.                                not specify this option, messages are not
  735.                                logged.
  736.  
  737.                                Note: <targetdir> is the target directory
  738.                                      where you installed the product.
  739.  
  740. /L2:<targetdir>\historylog     Specifies the history log file. The install
  741.                                program logs the install events in this file
  742.                                and prefixes them with a time stamp. If you
  743.                                do not specify a path and file name, the
  744.                                history log is created in the temporary
  745.                                install directory (usually on the drive with
  746.                                the most available space). If you do not
  747.                                specify this option, the history is not
  748.                                logged.
  749.  
  750. /O:DRIVE                       Specifies that the program files are being
  751.                                copied from a local or remote disk drive,
  752.                                not a mainframe host.
  753.  
  754. /P:"VisualAge COBOL Enterprise for OS/2 V2.2"
  755.                                Specifies the name of the product to install.
  756.  
  757. /R:<targetdir>\UNATTEND.RSP    Specifies the response file to use. If you
  758.                                do not specify the fully-qualified file name,
  759.                                the install program looks for the response
  760.                                file using the following search order:
  761.  
  762.                                1.  The current directory.
  763.                                2.  The path specified by /G, if any.
  764.                                3.  Directories specified by the PATH
  765.                                    environment variable.
  766.                                4.  Directories specified by the DPATH
  767.                                    environment variable.
  768.  
  769. /S:<sourcedir>                 Specifies the directory where the source
  770.                                files reside.
  771.  
  772. /T:<targetdir>                 Specifies the directory where the files
  773.                                should be installed. If you use this option,
  774.                                it overrides what is specified for FILE in
  775.                                the response file.
  776.  
  777. /TU:<targetdir>\CONFIG.SYS     Specifies the CONFIG.SYS file to be updated.
  778.  
  779. /X                             Specifies that the install program runs
  780.                                unattended, using a response file.
  781.  
  782.  
  783. __________________________________________________________________________
  784.  
  785.  
  786. 5.3  Return Codes
  787. -----------------
  788.  
  789. The install program returns a 2-byte hexadecimal value to the SDM,
  790. indicating success or failure, what steps should be taken next, and what
  791. type of messages, if any, were logged:
  792.  
  793. o    Successful installation. No other action required.
  794.      00 00   No messages were logged.
  795.  
  796. o    Successful installation. Restart the workstation operating system. Do
  797.      not call the install program again.
  798.  
  799.      FE 00   No messages were logged.
  800.      FE 04   Warning messages were logged.
  801.      FE 08   Error messages were logged.
  802.      FE 12   Severe error messages were logged.
  803.  
  804. o    Successful installation. Restart the workstation operating system and
  805.      call the install program again.
  806.  
  807.      FF xx   xx can be any value from 00 to FF.
  808.  
  809. o    Installation did not complete successfully; an unexpected condition
  810.      was encountered.
  811.  
  812.      16 00   The install program was invoked incorrectly.
  813.      16 04   Messages were logged.
  814.  
  815. If you created user exits for the install program to call (as specified by
  816. the USEREXIT keyword in the response file), your user exit must return a
  817. 2-byte hexadecimal value to the install program as follows:
  818.  
  819. 00 00   Your program completed successfully.
  820.  
  821. FE 00   Your program completed successfully, and requires the workstation
  822.         operating system to be restarted without calling the install
  823.         program again. When you return this value, the install program
  824.         displays a message to restart the operating system.
  825.  
  826. FF xx   Your program completed successfully, and requires the workstation
  827.         operating system to be restarted and the install program to be
  828.         called again. When you return this value, the install program
  829.         displays a message to to restart the operating system and to try
  830.         the action again.
  831.  
  832. If your program is in REXX, you can use the REXX EXIT command and return
  833. the value in decimal instead of hexadecimal.
  834.  
  835. If your program returns a different value to the install program, the
  836. install program displays a message that a product-specific error occurred,
  837. indicating the name of your program and the return code.
  838.  
  839.  
  840. 5.4  Installing Using Response Files
  841. ------------------------------------
  842.  
  843. If you are installing from a CD-ROM or LAN server, you can run the install
  844. program unattended, using a response file to specify what to install and
  845. where. You can use response files for either a basic or shared
  846. installation.
  847.  
  848. To install using a response file:
  849.  
  850. 1.  Create a response file, or tailor the sample response file, UNATTEND.RSP,
  851.     provided in the IBMCOBOL\EXTRAS directory of the CD-ROM. You can copy
  852.     UNATTEND.RSP to your hard drive and change the appropriate responses.
  853.     Make sure that:
  854.  
  855.     o    FILE specifies the directory where you want to install the
  856.          Compiler and Nonvisual Tools for a basic install. For a shared
  857.          install, it is known as the local file directory.
  858.  
  859.     o    WORK specifies the directory where you want to install the Warp
  860.          Toolkit.
  861.  
  862.     o    COMP keywords specify the components you want to install.
  863.  
  864.     Note: For shared install, you do not need WORK.
  865.  
  866.     For a list of all the parameters you can change, see "Unattended
  867.     Install", section 5.0 in this file.
  868.  
  869. 2.  From an OS/2 command line, change to the CD-ROM or LAN directory where
  870.     the install program resides.
  871.  
  872. 3.  Invoke the basic install program with the command:
  873.  
  874.         install2 /A:I /X /R:d:\UNATTEND.RSP /C:IBMCOBOL.ICF
  875.         /P:"VisualAge COBOL Enterprise for OS/2 V2.2" /O:DRIVE
  876.  
  877.     where d:\UNATTENDED.RSP or <targetdir>\UNATTEND.RSP is your response file.
  878.  
  879.     For a description of the /A command-line option and other command-line
  880.     options, see section 5.2, "Command-Line Options". See also section 5.0,
  881.     "Unattended Install".
  882.  
  883. 4.  Or, invoke the shared install program with the command:
  884.  
  885.         install2 /A:I /X /R:d:\UNATTEND.RSP /P:"VisualAge COBOL Enterprise
  886.         for OS/2 V2.2" /O:DRIVE /C:<sharedir>\IBMCOBOL\SHARED\IBMCOBOL.ICF
  887.         /S:<sharedir>\
  888.  
  889.     where <sharedir> is the base LAN directory where the source files reside.
  890.     For  the /S option, ensure that there is a back slash (\) at the end.
  891.  
  892.     Note: If you want to log any error messages that are generated, specify
  893.     the /L1:errorlog option, where errorlog is the path and file name to
  894.     use for the error log. This is usually a good idea because messages are
  895.     not displayed during an unattended install; if you don't log them, you
  896.     have no record of what errors occurred.
  897.  
  898.     For a description of the /A command-line option and other command-line
  899.     options, see section 5.2, "Command-Line Options". See also section 5.0,
  900.     "Unattended Install".
  901.  
  902. 5.  You can then leave the install program unattended. When it is complete,
  903.     the OS/2 command prompt appears in the OS/2 session where you ran the
  904.     install2 command.
  905.  
  906. 6.  If you choose not to have the installation program update your
  907.     CONFIG.SYS, make the changes to it now BEFORE you reboot. (See the
  908.     CONFIG.ADD file that VisualAge COBOL generates.)
  909.  
  910. 7.  Shut down and restart your system to make the changes to your
  911.     CONFIG.SYS file take effect.
  912.  
  913. You have now successfully installed VisualAge COBOL, and are ready to go!
  914. See the "Getting Started" manual for what to do next.
  915.  
  916.  
  917. 5.5  Adding or Deleting Components Using a Response File
  918. --------------------------------------------------------
  919.  
  920. To add or delete components using a response file:
  921.  
  922. 1.  Modify the appropriate parameters in your response file.
  923.  
  924.     If you are deleting components, make sure that:
  925.  
  926.     o   COMP keywords specify the components to delete.
  927.     o   DELETEBACKUP specifies whether you want to delete backup files
  928.  
  929.     If you are adding components, make sure that:
  930.  
  931.     o   FILE specifies the directory where you want to install the
  932.         Compiler and Nonvisual Tools for a basic install. For a shared
  933.         install, it is known as the local file directory.
  934.  
  935.     o   WORK specifies the directory where you want to install the Warp
  936.         Toolkit.
  937.  
  938.     o   COMP keywords specify the components you want to install.
  939.  
  940.         Note: For shared install, you do not need WORK.
  941.  
  942. 2.  Change the CD-ROM or LAN directory where the VisualAge COBOL install
  943.     program resides.
  944.  
  945. 3.  To delete or install components from a basic install:
  946.  
  947.     For example, to install, enter:
  948.  
  949.         install2 /A:I /X /R:<targetdir>\UNATTEND.RSP /C:IBMCOBOL.ICF
  950.         /P:"VisualAge COBOL Enterprise for OS/2 V2.2" /O:DRIVE
  951.  
  952.     where d:UNATTEND.RSP or <targetdir>\UNATTEND.RSP is your response file
  953.  
  954.      For a description of the /A command-line option and other command-line
  955.     options, see section 5.2, "Command-Line Options". See also section 5.0,
  956.     "Unattended Install".
  957.  
  958.     Or, for a shared install program:
  959.  
  960.     For example, to install, enter:
  961.  
  962.         install2 /A:I /X /R:d:\UNATTEND.RSP /P:"VisualAge COBOL
  963.         Enterprise for OS/2 V2.2" /O:DRIVE /C:<sharedir>
  964.         \IBMCOBOL\SHARED\IBMCOBOL.ICF /S:<sharedir>\
  965.  
  966.     where sharedir is the base LAN directory where the source files reside.
  967.     For the /S option, ensure that there is a back slash (\) at the end.
  968.  
  969.     For a description of the /A command-line option and other command-line
  970.     options, see section 5.2, "Command-Line Options". See also section 5.0,
  971.     "Unattended Install".
  972.  
  973. 4.  You can then leave the install program unattended while the components
  974.     are deleted or installed.
  975.  
  976. 5.  When the install program has finished, the OS/2 command prompt appears
  977.     in the OS/2 session where you ran the install2 command.
  978.  
  979. 6.  If you added components and chose not to have the installation program
  980.     update your CONFIG.SYS, make the changes to it now BEFORE you reboot.
  981.     (See the CONFIG.ADD file that VisualAge COBOL generates.)
  982.  
  983. 7.  Shut down and reboot your workstation.
  984.  
  985.  
  986.  
  987. ==========================================================================
  988.  
  989.  
  990. Copyright IBM Corporation 1998 - All Rights Reserved.
  991.  
  992. US Government Users Restricted Rights - Use, duplication or disclosure
  993. restricted by GSA ADP Schedule Contract with IBM Corp.
  994.  
  995.  
  996. ==========================================================================
  997.  
  998.  
  999. Trademarks
  1000.  
  1001. The following terms are trademarks of International Business Machines
  1002. Corporation in the United States or other countries, or both:
  1003.  
  1004. IBM
  1005. VisualAge
  1006.  
  1007. Other terms used in Installation Notes, which may be denoted by a double
  1008. asterisk (**), are trademarks or service marks of others.
  1009.  
  1010.  
  1011. ==========================================================================
  1012.  
  1013.