
Accessing DSN Catalog Records (TSIDAC2)
Chapter 4. Accessing the DSN Catalog 4-5
Accessing DSN Catalog Records (TSIDAC2)
You may want to access DSN Catalog information with your own programs to produce your
own reports or for other reasons. The TSIDAC2 subroutine is provided for this purpose and is
located in the BIM-EPIC installation library as member name TSIDAC2.OBJ.. A sample
COBOL program (TSIDACC2) is located in the BIM-EPIC installation library as member
name TSIDACC2.C.
TSIDAC2 is not reentrant and should not be used in an online CICS environment.
Each dataset's DSN Catalog entry consists of two types of records:
• A single dataset definition (EDD) record (called the master record).
• Individual version-level records (called detail records). One record exists for each
version, whether it is valid, open, conditionally cataloged, or scratched. If the version is
multi-volume, there is a detail record for each additional volume.
The DSN Catalog dataset also includes an index. Each time a new record is added to the DSN
Catalog file, another index entry is added to the end of the index area. This means that
information obtained sequentially may not be in alphabetical order. To re-sequence the index,
use the INDEX function of TSIDUTL.
In random access, TSIDAC2 returns the master record for a specific dataset the first time it is
called for that dataset. On each subsequent call, TSIDAC2 returns a detail record for that
dataset.
In sequential access, TSIDAC2 returns each record for a single dataset in order, and then
moves to the next dataset in the DSN Catalog’s index sequence and begins returning its
records, one at a time. Detail records are always returned current version first, then each
successively older version.
Description
DSN Catalog
Record Structure
About Sequential
and Random
Access
Komentarze do niniejszej Instrukcji