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

ItemExample of character string patternDescriptionExample of specification
Right truncationnnn*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*mmmThe 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*nnnThe command searches for RDAREAs whose names end with nnn.*RDUSER
The command searches for RDAREAs whose names end with RDUSER.
*mmm*nnnThe 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.
.nnnThe 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 utilitySpecification method
    DirectBatchALL
    pdholdYYY
    pdrelsYYY
    pdopenYYY
    pdcloseYYY
    pddblsYYY
    pddbchgYYY
    pddbfrzYYY
    pdmemdbYYY
    pdbufmodYNN
    pdorbeginYYN
    pdorcheckYYY
    pdrdreflsYYY
    pdorcreateYNN
    pdrorgYNN
    pdreclaimYNN
    pdpgbfonYNN
    pddbstPredicting reorganization timeNNY
    Accumulating condition analysis resultsYYY
    Logical analysis of RDAREAYYY
    Physical analysis of RDAREAYYY
    pdcopyYYN
    pdrstrYYN
    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 utilityMaximum number of RDAREAs with duplicates eliminatedMaximum number of RDAREAs that can be processed
    pdhold4,096No limit
    pdrels4,096No limit
    pdopen4,096No limit
    pdclose4,096No limit
    pddbls4,096No limit
    pddbchg4,096No limit
    pddbfrz4,096No limit
    pdmemdb4,096No limit
    pdbufmod4,0964,096
    pdorbegin4,0964,096
    pdorcheckNo limitNo limit
    pdrdreflsNo limitNo limit
    pdorcreateWhen -o is specified: 1
    When -r is specified: 4,095
    When -o is specified: 1
    When -r is specified: 4,095
    pdrorg11
    pdreclaim11
    pdpgbfon11
    pddbstPredicting reorganization time1No limit
    Accumulating condition analysis results4,096No limit
    Logical analysis of RDAREA4,096No limit
    Physical analysis of RDAREA4,096No limit
    pdcopyNo limitNo limit
    pdrstrNo limitNo 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 utilityProcessing 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.
    pdrelsDoes not eliminate the duplicates and performs the processing as many times as the RDAREA name is specified.
    pdopen
    pdclose
    pddbls
    pddbchgEliminates the duplicates.
    pddbfrzDoes not eliminate the duplicates and performs the processing as many times as the RDAREA name is specified.
    pdmemdbEliminates the duplicates.
    pdbufmodNot applicable
    pdorbeginEliminates the duplicates.
    pdorcheck
    pdrdreflsEliminates the duplicates.
    pdorcreateNot applicable
    pdrorgNot applicable
    pdreclaim
    pdpgbfon
    pddbstPredicting reorganization time
    Accumulating condition analysis resultsEliminates 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).