AREA keyword

The AREA keyword specifies the names of areas in the database to be processed. The AREA keyword is applicable only to DEDBs.

Functions that support this keyword
  • Image Copy function
  • Recovery function
  • Create Image Copy function
Statements that support this keyword
  • IC/AIC statement
  • CIC/ACIC statement
  • RCV statement
  • CRC statement
Site default option
Not supported
Related keyword
DBD keyword
Format
Read syntax diagramSkip visual syntax diagramAREA=areaname(,areaname)RANGE( n1, n2)
areaname
The name of an area in the database. areaname can be specified with wildcard characters. Wildcard characters supported are asterisk (*) and percent (%) symbol. An asterisk (*) represents 0 - 8 characters, whereas a percent (%) symbol represents a single character. For example, AREA=area* matches area, area1, area1234, and so on. If two or more asterisks (*) are specified in sequence, only the first asterisk is recognized. The specification by using wildcard characters cannot be used for the RCV control statement.
(areaname1,areaname2,...)
A list of target areas in the database. Area names in the list can also be specified with wildcard characters. You can specify 1 - 2048 areas in the list. All areas specified in the list must exist at run time. The list form cannot be used for the RCV control statement.
RANGE(n1,n2)
The range of area numbers of the target areas in the database. n1 and n2 are area numbers, which are sequential decimal numbers assigned to the areas in a database. n1 and n2 can be in the range of 1 - 2048. n2 must be equal to or greater than n1. At least one area must exist in the specified range. The range format cannot be used for the RCV control statement.
Default value
None.

How duplicate specification is processed

If there are duplicate areas selected in the list format (areaname1,areaname2,...), areas are prioritized in the following order, and duplication is eliminated:

  1. Areas selected by areaname without wildcard characters
  2. Areas selected by areaname with wildcard characters

If duplicate areas are of the same priority, the area that is selected earlier is higher in priority.

If there are duplicate areas selected over multiple ICEIN statements, areas are prioritized in the following order, and duplication is eliminated:

  1. Areas selected by no AREA parameter, areas selected by areaname without wildcard characters, or areas selected by the GROUP statement
  2. Areas selected by RANGE(n1,n2)
  3. Areas selected by areaname with wildcard characters

If duplicate areas are of the same priority, except for the first case (no AREA parameter), the area that is selected earlier is higher in priority. If duplicate areas are of the first case, duplication is not eliminated.