The purpose of this tab is to identify the external resources
of a Program. These resources are represented by Data Structures.
For each external resource, you must specify its:
- Physical characteristics, which, along with the type of COBOL
code, generate the SELECT clauses and ensure adequate
physical accesses,
- File matching criteria, controlled by three different fields (for
input Data Structures):
- Sort key, which identifies the keys to match on, arranged hierarchically
from the major-most key,
- Number of control breaks, which specifies how many control breaks
there are,
- Synchronization level, which specifies the number of levels to
match.
- The generated description type: Several description variants may
be defined from the Data Structure descriptions contained in the library.
These variants are:
- The format type used,
- The selection of certain Segments, taken from the various Data
Structure descriptions in the library,
- The selection of certain reserved Data Elements or groups of Data
Elements,
- The record description mode (redefined or not, repeated, etc.),
and the COBOL level number,
- The location of the generated description in the DATA
DIVISION (this location can vary from one record to another),
- Use characteristics, which generate input/output processing as
well as other standard processing (check, update, printing...).
Data Structure calls are used to describe three basic
types of elements, which are specified in the
Organization field.
These are:
- Standard Files,
- Database Blocks,
- Work Areas or Linkage Areas.
At the Program level, you can build a composite Data
Structure, i.e. call different Data Structures on the same -CD line.
Limitations: There is no limitation on
the number of Data Structure calls per Program. However, principal
Data Structures, or Data Structures with control breaks or file matching
must appear among the first 23. If not, file matching might not be
carried out as desired and the updating of these principal data structures
will not take place.
For files whose organization is I:
Indexed, V: VSAM, UFAS or S:
Sequential, the number of call lines must not exceed 100.
The
maximum number of times a single data structure can be called is limited
to 500, for all the programs that are generated in one run.
Recommendation
In this tab, you can specify
internal resources: Work or Linkage Areas, that is Data Structures
or Data Elements. However, you may use the -W Lines tab
preferably, as it is dedicated to that purpose.
Note: For a Macro,
the lines indicated on the Working Storage tab are incorporated into
the calling Program, but not the lines indicated on the -W
Lines tab. Furthermore, a Data Structure call in the -W
Lines tab can include no more than four Segments. Also,
utilization, control breaks, and file matching cannot be specified
in the -W Lines tab.
Description of the tab
The -CD
Lines tab lists the Data Structures called in the Program.
It looks like this:

It is constituted of three
different parts:
- An area with a tree structure which displays :
- On the first level, the CD line, which represents the called
resource, i.e. the Data Structure. The CD line displays:
- the Data Structure category among the following ones:
- Input file (
icon),
- Output file (
icon),
- Input/output file (
icon),
- Working file (
icon),
- Report line (
icon),
- the Data Structure code in program. If
it is a composite Data Structure, only the code in program of
the principal Data Structure is displayed,
- the Data Structure name (chosen upon creation)
in parentheses. If the Data Structure is composite, you can see the
names of all the Data Structures which make up this -CD line (the
first Data Structure displayed being the principal Data Structure).
- the sort keys, if any has been indicated
in the -CD Line Definition (Data Structure).
- On the second level, the Data Structure which makes up the -CD
line. If it is a composite Data Structure, each called Data Structure
is displayed. The Data Structure name is followed, in parentheses,
by the Segments selected for this Data Structure.
- On the third level, the selected Segments for each Data Structure.
If no Segment has been specified, all the Segments of the Data Structure
are selected by default and their codes do not appear here. Only the
indication 'all segments' is displayed at the
Data Structure call level.
- Buttons which enable you to add Data Structures to your Programs,
remove existing ones or move them up/down.
- Sections which open up depending on your selection
in the tree. If you select a:
- -CD line, that is a first-level branch in the tree, two cases
are possible:
- If the -CD line calls Data Structures (Input file, Working file...),
the -CD Line Definition (Data Structure) section
opens up. This is where you enter all the characteristics of the external
resource in the Program.
- If the -CD line calls Reports, the -CD Line Definition
(Report) section opens up.
- Data Structure, the Data Structure Call section
opens up, that is its composition (where you select all or some of
the Data Structure's Segments). From there, you can access the Data
Structure editor tabs.
- Segment, the Segment Call section opens
up, where you indicate the Segment code in the Program and
from where you can access the Segment editor tabs.
- Report, the Report Call section opens
up. From there, you can call another Report, indicate its suffix
in the program or access the Report editor tabs.