
TSIDAC2 Subroutine
5-6 User Reference
Connectivity Systems, Inc.—Copyright © 2006
Use Pursuant to Company Instructions
Accessing DSN Catalog Records
TSIDAC2 Subroutine
Description TSIDAC2 provides the capability to access BIM-EPIC Catalog records
from non-BIM-EPIC programs. This subroutine would be useful, for
example, if you needed to produce reports not provided by BIM-EPIC.
TSIDAC2 can be invoked from any programming language that supports
the CALL facility/construct. TSIDAC2 is located in the BIM-EPIC
installation library as member TSIDAC2.OBJ.
A sample COBOL program, TSIDACC2, is located in the BIM-EPIC
installation library as member TSIDACC2.C.
A COBOL mapping of the BIM-EPIC Catalog records is in the
BIM-EPIC installation library as member TSIDAC2.C. Member
TSIDAC2.A is an Assembler mapping.
The BIM-EPIC installation library must be available when the calling
program is link-edited.
Note:Note:
TSIDAC2 is not a reentrant program and must not be used in a CICS
environment.
DSN Catalog
Record
Structure
Each DSN Catalog dataset entry consists of two types of records.
A single BIM-EPIC dataset definition (EDD) record known as
the master record.
Individual version-level records known as detail records.
One record exists for each version, whether the version is valid,
open, conditionally cataloged, or scratched. If the version is
multi-extent or multi-volume, there is a detail record for each
additional extent or 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 TSIDUTL
INDEX before executing your program.
Kommentare zu diesen Handbüchern