CDO$HELP.HLB  —  File Area Key Properties, area_properties
    Format

      { EXACT_POSITIONING           }
      { ANY_CYLINDER                }
      { BEST_TRY_CONTIGUOUS         }
      {                             }
      { CONTIGUOUS                  }
      { POSITION position-type      }
      { VOLUME numeric-literal      }
      {                             }
      { ALLOCATE numeric-literal    }
      { BUCKET_SIZE numeric-literal }
      { EXTENSION numeric-literal   }
      {                             }

1  –  Parameters

1.1  –  position-type

    Defines the alignment of an allocated area. The default alignment
    value is NONE. For more information, see RMS_Keyword_Mapping_Tables.

1.2  –  numeric-literal

    Specifies a positive integer.

2  –  Description

    Area properties provide additional control over file or area
    space allocation on disk devices to optimize performance.

    You usually include areas using indexed files. A file can contain
    up to 255 areas. Define areas in numerical order, beginning with
    0.

    For a description and valid values for a particular keyword, see
    the OpenVMS documentation on RMS.

    For a mapping of CDO keywords to symbolics, see RMS_Keyword_
    Mapping_Tables.

3  –  Examples

    1.CDO>  DEFINE RMS_DATABASE EMPLOYEE_INFO DESCRIPTION IS "INFORMATION ON"
      cont> "CURRENT EMPLOYEE".
      cont>   RECORD EMPLOYEE_REC.
         .
         .
         .
      cont>   AREAS.
      cont>     AREA 0
      cont>       ALLOCATE 1000
      cont>       BUCKET_SIZE 10
      cont>       EXTENSION 100
      cont>       CONTIGUOUS.
      cont>     AREA 1
      cont>       ALLOCATE 1000
      cont>       BUCKET_SIZE 1
      cont>       EXTENSION 100
      cont>       BEST_TRY_CONTIGUOUS.
      cont>     AREA 2
      cont>       ALLOCATE 1000
      cont>       BUCKET_SIZE 1
      cont>       EXTENSION 100
      cont>       BEST_TRY_CONTIGUOUS.
      cont>   END AREAS.
         .
         .
         .
      cont> END EMPLOYEE_INFO RMS_DATABASE.
      CDO>

      This example shows the syntax for defining the ALLOCATE,
      BUCKET_SIZE, EXTENSION, CONTIGUOUS, and BEST_TRY_CONTIGUOUS
      properties for three areas in the EMPLOYEE_INFO RMS database
      element.

    2.CDO>  DEFINE RMS_DATABASE MORE_EMPLOYEE_INFO
      cont>   "DESCRIPTION IS " DATA ON CURRENT EMPLOYEES ".
      cont>   RECORD EMPLOYEE_REC.
      cont>     FILE_DEFINITION
      cont>     AREA 1
      cont>     POSITION NONE.
         .
         .
         .
      cont> END MORE_EMPLOYEE_INFO RMS_DATABASE.
      CDO>

      This example shows the syntax that defines the NONE position
      type option for the area property POSITION in the MORE_
      EMPLOYEE_INFO RMS database element.
Close Help