Rational Developer for System z, Version 7.5

-CD Lines tab

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:
  • Logical characteristics, from which the description of data will be generated in the DATA DIVISION. as well as the way its is used in the Program,
  • Physical characteristics, which, along with the type of COBOL code, generate the SELECT clauses and ensure adequate physical accesses,
  • Use characteristics, which generate input/output processing as well as other standard processing (check, update, printing...).

At the Program level, you can build a composite Data Structure, i.e. call different Data Structures on the same -CD line.

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:
  • On the left, 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 (Input file icon),
        • Output file (Output file icon),
        • Input/output file (Input/Output file icon),
        • Working file (Working file icon),
        • Report line (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.
  • In the center part, buttons which enable you to add Data Structures to your Programs, remove existing ones or move them up/down.
  • On the right, 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.
Related tasks
Adding external resources to a Program

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)