In the Initial selection panel, enter
additional information to identify the segment that you want to display.
Before you begin
For DEDB users: On the Initial selection panel, you
specify the DEDB area where you want to work. An area can have one or more area data sets,
called multiple area data sets (MADS). An individual area data set is referred to as ADS.
Any subsequent panel that is a view of a DEDB area displays the first available ADS for
that area. Available refers to the status of the ADS in the RECON data sets.
Any panel where you can change the data of an ADS attempts to propagate such a change to
all the available ADS for that area. This propagation can fail on some ADS. MADS are
possibly available, but not necessarily in sync with each other, as IMS does tolerate a finite number of read/write
errors on ADS. Such a failure does not abort the process of propagating the change to all
available ADS.
When you change an ADS, the change is recorded. You can reverse this change by starting
the Undo function. When you perform an undo, IMS Database
Repair Facility attempts to propagate the undo
to all available ADS for this area.
Procedure
The Initial selection panel differs by database organization type.
If you are processing a partitioned database and you want to specify an RBA, block number, or
CI number, enter the name of the database partition in the Partition DBD name
field.
Note: The PSE Name field shows the HALDB Partition Selection exit
routine.
You can enter a question mark (?) to display the Partition Selection List panel
to select the partition. In the Partition Selection List panel,
a list of database partition names that belong to the master DBD name is shown.
This panel shows the partition name (DBD name field), partition ID,
partition high key and its length, randomizing module, number of RAPs per block or CI, and the high
block number of the root addressable area.
The Partition High Key field shows the highest value of a root segment key
in this partition. If X'FF's is displayed, it indicates that the highest key is the length of the
key filled with FFs.
Select one of the partition names by typing an S in the selection field. Then,
press Enter to return to the Initial selection panel.
Specify the data set group or the area number of the data set that contains the segment that
you want to display in the Data set group field or the Area
number field.
For an HDAM or HIDAM database, enter the data set group number (1 - 10).
For a PHDAM and PHIDAM database, enter a value of A through J.
For a DEDB, enter the area number (1 - 9999).
Enter one of the following fields to display the information about a specific segment, block,
or CI. The RBA, Blk/CI #, and Root key options are mutually exclusive. If you want to display the
free space element (FSE) chain or root anchor points (RAPs) in a specific block or CI, specify the
RBA, block, or CI in which the FSE chain or the RAPs exist.
RBA
Specify the relative byte address (RBA) used for accessing a database segment. You can access
any segment provided that the RBA points to a valid segment code.
To display an
individual segment, the RBA must point to a valid segment code. For any other RBA,
IMS Database
Repair Facility displays the
block that contains that RBA.
To view the FSE chain or RAPs in a specific
block or CI, you must specify an RBA, and that RBA must be within the block or
CI.
If the database data set is one of the following types, the
maximum database size can be 8 GB:
HDAM or HIDAM database OSAM data set and the block size is even.
HDAM or HIDAM database VSAM linear data set (OSAM LDS) with the extended
addressability attribute.
PHDAM or PHIDAM database OSAM data set and OSAM8G is specified in the RECON
data sets.
PHDAM or PHIDAM database VSAM linear data set (OSAM LDS) with the extended
addressability attribute and OSAM8G is specified in the RECON data sets.
An RBA beyond 4 GB for such database data set can be
specified in hexadecimal format by the following expressions:
A nine-digit value. Add a 1 at the beginning of the RBA value. For example,
to specify an RBA value of 4294968320, you enter 100000400. The maximum value
is X'1FFFFFFFF'.
An eight-digit value. Increment the last bit of the RBA value by 1. For
example, to specify an RBA value of 4294968320, you enter 00000401. The
maximum value is X'FFFFFFFF'.
When either of these values is supplied, IMS Database
Repair Facility assumes that the value
is over 4 GB for the database data set.
Note: A nine-digit
RBA is used only when you enter the value. IMS Database
Repair Facility shows the RBA value
in eight digits.
BLK # or CI #
Specify a block number or a CI number. Zero is not a valid number.
Root key
Specify the key to use to access a database root segment.
For a PHDAM and PHIDAM database, if
you specify a root key, IMS Database
Repair Facility determines the database
partition to which it belongs. A message is displayed with this information. If
you specify both a partition DBD name and a root key on this panel, the partition
DBD name is ignored.
If you want to display the FSE chain or RAPs, specify the FSE chain
field or the RAPs field. The FSE chain and RAPs options are mutually
exclusive.
FSE chain
Specify Y to display the FSE chain in a block
or CI. This option is applicable for HD databases.
RAPs
Specify
Y to display the RAPs associated with HDAM, PHDAM, or HIDAM database. For
HIDAM databases, this option is applicable only when RAPs exist.
RAPs are present in all blocks (including bitmap blocks), but not in unused blocks (all X'0000'
or X'FFFF'). A valid FSE chain is identified by the first 4 bytes of the block, the
FSEAP, where the first 2 bytes are nonzero and the second 2 bytes are zero. If you
request FSE=Y or RAPS=Y, and IMS Database
Repair Facility detects that the requested
block (or the block that is associated with the requested RBA) does not have an FSE
chain or RAPs, a message is displayed to alert you that this block does not have an FSE
chain or RAPs.
Press Enter.
The panel that is displayed next
differs by which option you selected:
If you specify an RBA that points to the beginning of a segment and do not select the FSE chain
or the RAPs option, the Segment Prefix
panel is displayed. See Viewing and updating segment prefix.
If you specify a block number or CI number, or an RBA that does not point to the beginning of a
segment, and do not select the FSE chain or the RAPs option, the Block/CI data panel is
displayed. See Viewing and updating block or CI data in the Block/CI data panel.