Nonstop Database, HiRDB Version 9 Command Reference

[Contents][Index][Back][Next]

1.5.2 Specification of RDAREAs in operation commands and utilities

This subsection discusses the specification of RDAREAs in operation commands and utilities.

Organization of this subsection
(1) Specifying RDAREAs
(2) RDAREA specification rules
(3) Notes

(1) Specifying RDAREAs

You can choose the following methods to specify RDAREAs in operation commands and utilities:

(a) Specifying an RDAREA name (direct specification)

You can specify one or more RDAREA names directly on the command line.

(b) Specifying a group of RDAREAs (batch specification)

You can use the method described below to specify RDAREAs in operation commands in the batch mode. This method enables you to specify a group of RDAREAs.

Table 1-5 Specifying a group of RDAREAs in the batch mode

Item Example of character string pattern Description Example of specification
Right truncation nnn* The command searches for RDAREAs whose names begin with nnn. RDUSER*
The command searches for RDAREAs whose names begin with RDUSER.
nnn*mmm* The command searches for RDAREAs whose names begin with nnn and contain mmm. RD*USER*
The command searches for RDAREAs whose names begin with RD and contain USER.
nnn*mmm The command searches for RDAREAs whose names begin with nnn and end with mmm. RD*USER
The command searches for RDAREAs whose names begin with RD and end with USER.
Right and left truncation *nnn* The command searches for RDAREAs whose names contain nnn. *RDUSER*
The command searches for RDAREAs whose names contain RDUSER.
*nnn*mmm* The command searches for RDAREAs whose names contain nnn and mmm. *RD*USER*
The command searches for RDAREAs whose names contain RD and USER.
Left truncation *nnn The command searches for RDAREAs whose names end with nnn. *RDUSER
The command searches for RDAREAs whose names end with RDUSER.
*mmm*nnn The command searches for RDAREAs whose names contain mmm and end with nnn. *RD*USER
The command searches for RDAREAs whose names contain RD and end with USER.
.nnn The command searches for RDAREAs whose names end with nnn preceded by any one character for each period (.) that is specified. This method is supported only for pdcopy and pdrstr. ..RDUSER
The command searches for RDAREAs whose names consist of 8 characters and end with RDUSER.
(c) Specifying ALL in an argument of an operation command or utility (ALL specification)

When ALL is specified, the processing is performed on all RDAREAs.

When you use ALL, it must be specified at the beginning of the arguments. Neither direct specification nor batch specification can be used together with an ALL specification.

(2) RDAREA specification rules

  1. Which of the specification methods is supported (direct specification, batch specification, ALL specification) depends on the operation command or utility. The table below shows for each command the specification methods that are supported.

    Table 1-6 Support of direct specification, batch specification, and ALL specification

    Operation command or utility Specification method
    Direct Batch ALL
    pdhold Y Y Y
    pdrels Y Y Y
    pdopen Y Y Y
    pdclose Y Y Y
    pddbls Y Y Y
    pddbchg Y Y Y
    pddbfrz Y Y Y
    pdmemdb Y Y Y
    pdbufmod Y N N
    pdorbegin Y Y N
    pdorcheck Y Y Y
    pdrdrefls Y Y Y
    pdorcreate Y N N
    pdrorg Y N N
    pdreclaim Y N N
    pdpgbfon Y N N
    pddbst Predicting reorganization time N N Y
    Accumulating condition analysis results Y Y Y
    Logical analysis of RDAREA Y Y Y
    Physical analysis of RDAREA Y Y Y
    pdcopy Y Y N
    pdrstr Y Y N

    Legend:
    Y: Supported
    N: Not supported

  2. The maximum length of the character string used to specify RDAREAs depends on the limitations of the OS and shell scripts. An error will result if a specified character string exceeds the permissible maximum length, and the corresponding operation command or utility will not execute.
  3. If an RDAREA name is specified in duplicate, the duplicates are eliminated during processing. However, for the following operation commands and utilities, any duplication of an RDAREA name will result in an error and the duplicates will not be eliminated:
    • pdorcreate -o
    • pdrorg
    • pdreclaim
    • pdpgbfon
  4. The table below lists the maximum numbers of RDAREAs that can be specified. These are the numbers of RDAREAs that can be specified as targets of processing after duplicates have been eliminated. An error results if the number of RDAREAs (after duplicates have been eliminated) exceeds the applicable maximum value.

    Table 1-7 Maximum number of RDAREAs that can be specified

    Operation command or utility Maximum number of RDAREAs with duplicates eliminated Maximum number of RDAREAs that can be processed
    pdhold 4,096 No limit
    pdrels 4,096 No limit
    pdopen 4,096 No limit
    pdclose 4,096 No limit
    pddbls 4,096 No limit
    pddbchg 4,096 No limit
    pddbfrz 4,096 No limit
    pdmemdb 4,096 No limit
    pdbufmod 4,096 4,096
    pdorbegin 4,096 4,096
    pdorcheck No limit No limit
    pdrdrefls No limit No limit
    pdorcreate When -o is specified: 1
    When -r is specified: 4,095
    When -o is specified: 1
    When -r is specified: 4,095
    pdrorg 1 1
    pdreclaim 1 1
    pdpgbfon 1 1
    pddbst Predicting reorganization time 1 No limit
    Accumulating condition analysis results 4,096 No limit
    Logical analysis of RDAREA 4,096 No limit
    Physical analysis of RDAREA 4,096 No limit
    pdcopy No limit No limit
    pdrstr No limit No limit

(3) Notes

  1. The following apply to specifying the asterisk (*) and period (.) in character string patterns:
    • For pdcopy and pdrstr
      You can specify as many asterisks (*) and periods (.) as you wish at any locations within a character string pattern. However, a character string pattern cannot consist of only asterisks, or only periods, or only a combination of asterisks and periods.
    • For utilities other than pdcopy or pdrstr
      You can specify as many asterisks (*) as you wish at any locations within a character string pattern. However, a character string pattern cannot consist of only asterisks.
  2. The percent sign (%) must not be specified in a character string pattern.
  3. For an RDAREA name or pattern character string to be treated as being case sensitive, you must enclose the entire character string between double quotation marks ("). When a character string is not enclosed between double quotation marks ("), the system treats it as being in all uppercase letters. Note also that a character string that contains a space must be enclosed between double quotation marks ("). If you are using sh (Bourne shell), csh (C shell), or ksh (Korn shell), you must enclose the entire character string between single quotation marks (').
    Any pattern character string specified in pdcopy or pdrstr is always treated as being case sensitive regardless of whether it is enclosed between double quotation marks (").
  4. When an RDAREA name is duplicated in different specification methods (such as the same RDAREA is included in a batch specification and in an RDAREA name specification, or in another batch specification), whether the RDAREA is processed more than once depends on the operation command or utility, as show in the table below.

    Table 1-8 Operation command or utility processing when an RDAREA name is duplicated

    Operation command or utility Processing when an RDAREA name is duplicated
    pdhold
    • When -s is specified:
      Eliminates the duplicates.
    • When an option other than -s is specified:
      Does not eliminate the duplicates and performs the processing as many times as the RDAREA name is specified.
    pdrels Does not eliminate the duplicates and performs the processing as many times as the RDAREA name is specified.
    pdopen
    pdclose
    pddbls
    pddbchg Eliminates the duplicates.
    pddbfrz Does not eliminate the duplicates and performs the processing as many times as the RDAREA name is specified.
    pdmemdb Eliminates the duplicates.
    pdbufmod Not applicable
    pdorbegin Eliminates the duplicates.
    pdorcheck
    pdrdrefls Eliminates the duplicates.
    pdorcreate Not applicable
    pdrorg Not applicable
    pdreclaim
    pdpgbfon
    pddbst Predicting reorganization time
    Accumulating condition analysis results Eliminates the duplicates.
    Logical analysis of RDAREA
    Physical analysis of RDAREA
    pdcopy
    pdrstr
  5. The total number of characters in a specified character string pattern must not exceed the maximum permissible length for an RDAREA name (which is 30 characters).