HP 3000 Manuals

Moving from MPE/iX to MPE V [ TurboIMAGE/XL Database Management System Reference Manual ] MPE/iX 5.0 Documentation


TurboIMAGE/XL Database Management System Reference Manual

Moving from MPE/iX to MPE V 

If you need to move a TurboIMAGE database from MPE/iX to MPE V, you need
to perform the following tasks:

   1.  Disable ILR, roll-back recovery, and, if applicable, third-party
       indexing.  Set the critical item update (CIUPDATE) option to
       DISALLOWED.

   2.  Check the buffer specifications to ensure that they are compatible
       with MPE V. TurboIMAGE/XL buffer specifications are set at a large
       fixed number.  Refer to the following discussion of the BUFFSPECS
       parameter of the DBUTIL >>SET command for setting the buffer
       specifications for a database to be moved to MPE V.

   3.  If the TurboIMAGE/XL database you stored has taken advantage of
       dynamic roll-back recovery, check for the presence of a dbname00
       file.  If the dbname00 file exists, the database needs to be
       recovered.  Open the database and close it again.  The recovery
       occurs automatically with the call to DBOPEN.

   4.  Store the database with DBSTORE and be sure to specify the
       TRANSPORT option (see "Major Differences" below).

   5.  If necessary, reenable both ILR and roll-back recovery on MPE V
       after the database is restored.

Major Differences 

   *   A TRANSPORT option has been added to the DBSTORE command.  When
       you are transporting databases from MPE/iX to MPE V, you must use
       this TRANSPORT option.  To do this, supply an INFO parameter as
       follows:

            RUN DBSTORE;INFO="TRANSPORT" 

   *   Disable ILR before transporting TurboIMAGE/XL databases to MPE V.


NOTE Your TurboIMAGE database may be too large to move to the MPE V system, because with the expanded file size available on MPE/iX (4 gigabytes), data sets can exceed the MPE V file size limit (0.5 gigabytes). If you store a database on MPE/iX using DBSTORE with the TRANSPORT option, you will receive an MPE/iX error when a data set larger than the MPE V limit is encountered.
Buffer Specifications For databases that will be moved to MPE V, the DBUTIL >>SET command can be used to specify the number of input/output buffers to be allocated by TurboIMAGE/V in the Database Buffer Area Control Block (DBB) depending on the number of users concurrently accessing the database. The syntax of this command follows: >>SET database name [/maint word] {BUFFSPECS=num buffers (from-users/ to-users)} { [,num buffers(from-users/to-users)]... } For a complete syntax listing of the DBUTIL >>SET command, refer to Chapter 8. Parameters BUFFSPECS is for MPE V compatibility only, because the TurboIMAGE/XL buffer specifications are fixed at a large default value. For databases that will be moved to MPE V, it sets the number of buffers to be allocated by TurboIMAGE/V in the Database Buffer Area Control Block (DBB). The following parameters are used with the BUFFSPECS parameter: num buffers is the number of buffers for the range of users specified between the parentheses that follow. The minimum number of buffers allowed is 5 and the maximum is 255. The number of buffers allocated and the actual amount of performance increase obtained depends on whether ILR is enabled, how many users are accessing the database, the amount of main memory available, and many other factors. from-users is the minimum number of concurrent users (access paths) for which the preceding num buffers should be allocated. The minimum from-users value allowed is 1 and the maximum is 120. The value must be less than the immediately following to-users value. to-users is the maximum number of concurrent users for which the preceding num buffers should be allocated. The minimum to-users value allowed is 1 and the maximum is 120. The value must be greater than the immediately preceding from-users value. Discussion The following BUFFSPECS discussion is for databases that will be moved to MPE V. The buffer specifications are fixed at 1280 on TurboIMAGE/XL. The from-users and to-users counts can be the same. For example: SET ORDERS/SELL BUFFSPECS=10(4/4) is valid. The value of from-users must be less than or equal to the value of to-users. In addition, the from-users/to-users ranges must be specified in increasing order. The ranges may not overlap but they need not be consecutive. If num buffers is not specified for a particular number of users, the default number of buffers is used. These are the default settings assigned by TurboIMAGE on MPE V: b(1/2) b+4( 9/10) b+7(15/16) b+1(3/4) b+5(11/12) b+8(17/18) b+2(5/6) b+6(13/14) b+9(19/120) b+3(7/8) The value of b is equal to the largest number of search items in any detail data set in the database plus 3, or it is equal to 8, whichever is larger. If p is the maximum number of search items (the path count), the value of b can be represented as follows: b = max (p+3,8) For example, the largest path count for a detail data set in the ORDERS database is 4. (This is the path count for the CUST data set.) Therefore, the value of b for the ORDERS database is shown here: b = max (4+3,8) = 8 The default buffer specifications in this case are: 8(1/2),9(3/4),10(5/6),11(7/8),12(9/10),13(11/12),14(13/14),15(15/16),16(17/18),17(19/120) Example 1 :RUN DBUTIL.PUB.SYS Initiate DBUTIL execution. : >>SET ORDERS BUFFSPECS=5(1/120) Specify 5 buffers to be allocated for from 1 to For database ORDERS 120 users (access paths). BUFFER SPECIFICATIONS: DBUTIL confirms the specifications by listing them. 5(1/120) >> Example 2 :RUN DBUTIL.PUB.SYS : >>SHOW ORDERS BUFFSPECS Check the current buffer specifications. BUFFER SPECIFICATIONS: 5(1/120) >>SET ORDERS BUFFSPECS=30(1/30) Specify the new buffer specifications. Here the buffers are increased for Number of buffers must not decrease for the first 30 users. However, the increased users as below: previous buffer setting remains the same for the other users. BUFFER SPECIFICATIONS: 30(1/30),5(31/120) Buffer specifications remain unchanged as below: BUFFER SPECIFICATIONS: 5(1/120) >>SET ORDERS BUFFSPECS=30(1/30),40(31/120) Specify larger number of buffers for increased number of users. BUFFER SPECIFICATIONS: DBUTIL confirms the specifications by 30(1/30),40(31/120) listing them. >>


MPE/iX 5.0 Documentation