DBALL keyword

The DBALL keyword specifies to search logical group DBDSs automatically.

Term logical group is a unique-term that is used in IMS HP Image Copy information. A logical group refers to a group of databases that have logical relationships between the databases and their related index databases.

The DBALL keyword does not support DEDBs and Fast Path secondary indexes.

Functions that support this keyword
Image Copy function
Statements that support this keyword
GLOBAL statement
Site default option
Supported
Related keyword
None.
Format
Read syntax diagramSkip visual syntax diagramDBALL=NYXIDX(YXIDX,NY)
First operand
Y
Searches the logical group DBDSs from the DBD and processes the identified DBDSs.
XIDX
Searches and processes the DBDSs that are logically related with each other. Their related index databases are not searched or not processed.
N
Does not search the logical group DBDSs.
Second operand
If you omit the second operand, N is used as the default.
N
Specifies that the time stamps of IC data sets for logically related databases are not the same.
Y
Specifies that the time stamps of IC data sets for logically related databases are the same.
Default value
DBALL=N
Usage notes
  • To search all DBDSs, including logically related databases, IMS HP Pointer Checker is required.
  • When ICOUT=ddname is specified, DBALL=Y or DBALL=XIDX is ignored for that statement. However, when ICOUT=ddname, DBALL=Y, and VIC=Y are specified, IMS HP Image Copy searches for index databases that have logical relationships with the specified database, and creates a virtual image copy for the index databases.
  • For the optional parameter for the auto-searched DBDS, the first DBDS optional parameter that is specified for ICEIN in the same logical group is used.
  • If you specify DBALL=(N,Y) on the GLOBAL statement, IMS HP Image Copy ends with a return code of 16 with a DBALL operand error.
  • If you specify DBDALLOC=N with DBALL=Y or DBALL=XIDX on the ICEIN statement, DBALL=Y or DBALL=XIDX is ignored.
  • When DBALL=XIDX and IDXSRCH=Y are specified, the Image Copy function processes DBDSs in the following order:
    1. Searches for the related primary and secondary index DBDSs from the DBD (IDXSRCH=Y specification).
    2. Searches for the DBDSs that have logical relationships with each other (DBALL=XIDX specification).