home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / m23216s1.zip / README.000 < prev    next >
Text File  |  1993-12-23  |  7KB  |  163 lines
  1.  
  2. README.TXT for CICS OS/2 V2.0 - 24 September 1993.
  3. --------------------------------------------------
  4.  
  5. This file documents the latest updates to the CICS OS/2 system.
  6.  
  7.  
  8.  
  9.   ************************************************************************
  10.   *                                                                      *
  11.   *        IMPORTANT      IMPORTANT      IMPORTANT      IMPORTANT        *
  12.   *        ---------      ---------      ---------      ---------        *
  13.   *                                                                      *
  14.   *   A problem may occur starting CICS OS/2 on some systems. The        *
  15.   *   symptom is a system wait of about 5 minutes during initialization. *
  16.   *   The system will recover and operate correctly.                     *
  17.   *                                                                      *
  18.   *   The bypass is to update the default Btrieve value for the          *
  19.   *   'Maximum number of cursors'. This value, for the supplied system,  *
  20.   *   should be increased from 60 to at least 500. For systems with      *
  21.   *   additional files and more tasks defined this number will require   *
  22.   *   to be higher.                                                      *
  23.   *                                                                      *
  24.   *   Instructions on how to update the value are provided below.        *
  25.   *                                                                      *
  26.   ************************************************************************
  27.  
  28.  
  29.  
  30. Additional information on the CICS OS/2 internal file manager, Btrieve
  31. version 6.15 from Novell.
  32.  
  33. Btrieve is discussed in Chapters 6 and 7 of the CICS OS/2 Operations
  34. manual.
  35.  
  36. Starting the File manager.
  37.  
  38.   When CICS OS/2 is initiated it normally starts the file manager
  39.   automatically. On occasions it may be necessary to start the file
  40.   manager manually, for example, to change the default value of an option.
  41.   To start the file manager set the current directory to the
  42.   \CICS200\BIN directory and type the following at an OS/2 prompt.
  43.  
  44.     START BTRIEVE
  45.  
  46.   When the file manager initialises it will display a logo panel, click on
  47.   the OK pushbutton or press Enter to display the control panel.
  48.  
  49. File manager Home directory.
  50.  
  51.   The CICS OS/2 installation procedure allocates a directory, \BTRIEVE, on
  52.   the boot drive. This directory is known as the HOME directory.
  53.   This directory may be moved to an alternative drive and also renamed to
  54.   another name.  If it is necessary to change the directory Btrieve must
  55.   be manually started and the home directory named in the 'Activities'
  56.   pull down option.
  57.   The Home directory normally contains the specified file manager options
  58.   in a file named 'NOVDB.INI' and the manager's log file.
  59.  
  60. Modifying the default Brieve options.
  61.  
  62.   The OPTIONS pulldown menu contains items for setting the initialization
  63.   options. Options may only be changed when CICS OS/2 is not active. In
  64.   addition, the file manager must be stopped and restarted before any
  65.   changes take effect.
  66.   A common problem when changing the Btrieve options is not to save the
  67.   values. After any options have been modified they should be saved by
  68.   selecting the  'Save current settings' from the OPTIONS pulldown. The
  69.   named home directory must exist before the values may be saved.
  70.  
  71. File Manager options.
  72.  
  73.   These are discussed in the Operations manual.
  74.  
  75.   However, the following options need careful review.
  76.  
  77.   Initialization.
  78.  
  79.   The CICS system may fail to successfully initialise if the values of the
  80.   following options are too small.
  81.  
  82.   - Maximum open files.
  83.     Ensure the value of this option is at least 10 higher than the number
  84.     of files defined in the file control table (FCT).
  85.   - Maximum number of cursors.
  86.     The recommended value for this option is the maximum number of tasks
  87.     defined in the System Initialization table (SIT) plus one, multiplied
  88.     by the number of files defined in the file control table (FCT).
  89.     Experience has shown, on some hardware systems, this calculated number
  90.     is insufficient and should be increased by 100. If this number is too
  91.     small the system may wait for about 5 minutes during initialization.
  92.   - Number of Btrieve worker threads.
  93.     The minimum value for this should be 10.
  94.   - Number of I/O threads.
  95.     See the Operation's guide, chapter 6, for recommended values. We suggest
  96.     the minimum value for this should be 10.
  97.  
  98.   File integrity.
  99.  
  100.   The Transaction durability option, if selected, will force the file
  101.   manager to write the data to disk before returning to the application
  102.   program.  If this option is not selected any committed data is held in
  103.   the file manager's cache buffer prior to writing the data to disk, thus
  104.   if a system failure occurs prior to the cache buffer being flushed data
  105.   may be lost. Note, there may be a performance degradation if this option
  106.   is selected.
  107.  
  108.  
  109. Environment variable.
  110.  
  111.   The file manager uses an environment variable BTRINTF to locate its home
  112.   directory. This variable is set, by the CICSENV command file, to the
  113.   \BIN sub-directory of the CICS system.
  114.  
  115.       eg    'SET BTRINTF=/H:'cicsdir'\BIN'
  116.  
  117.   where cicsdir is the drive and path of the CICS system.
  118.  
  119.  
  120.  
  121. File Manager Utilities.
  122.  
  123. BUTIL.
  124.  
  125.   This is a general purpose utility to manipulate Btrieve files and is
  126.   documented in Chapter 6 of the CICS Operations manual.
  127.  
  128.   The environment variable BRQPARMS is provided to override the default
  129.   BUTIL record size. This is necessary if the file manager memory option
  130.   'maximum record size' has a value of less than 57000. If this value is
  131.   less than Butil's maximum record size, default 57000, status 97 will
  132.   occur. To set Butil's maximum record size specify the environment
  133.   variable BRQPARMS.
  134.  
  135.   eg  set BRQPARMS=/d:16500
  136.  
  137.   NOTE: CICS OS/2 supports a maximum file record size of 32767.
  138.  
  139.  
  140. PBROLL.
  141.  
  142.   This utility is provided to recover a Btrieve file from a back up copy
  143.   and the log file. It is documented in Chapter 6 of the CICS Operations
  144.   manual.
  145.  
  146.   The manual documents the steps necessary to create a log file as:
  147.  
  148.   - Create the log configuration file, BLOG.CFG
  149.   - Back up your data files before logging begins.
  150.  
  151.   In addition, logging requires to be activated by selecting the 'Log all
  152.   operations' option in the Control panel.
  153.  
  154.  
  155.  
  156.   **************************************************************
  157.   **************************************************************
  158.   ***                                                        ***
  159.   ***                   End of Document                      ***
  160.   ***                                                        ***
  161.   **************************************************************
  162.   **************************************************************
  163.