Adding external resources to a Program

External resources are files that are represented by Data Structures or Reports. To add external resources in a Program, you must specify their logical and physical characteristics and the way they are to be used in the Program.

Procedure

  1. Open the -CD Lines tab of a Program.
  2. Click Add CD Line. A selection wizard opens then.
  3. In this wizard, you can select one or more Data Structures or Reports, or both. If the list is large, you can reduce it by entering a string as a filter. The filter applies to the name or the label of the instance.
    • If the Data Structure or Report that you want to call is displayed in the selection wizard, click its corresponding check box and click OK.
      Note: By default, a Data Structure is inserted as a sequential file with fixed-length records. It contains all of the Data Structure records with the Data Elements in internal format and without the optional Data Elements.
    • To create a Data Structure or Report, click New Data Structure or New Report. In the creation wizard, enter its name and label and click OK. The new instance is then displayed in the selection list. If you select it and click OK, it is called in the -CD Lines tab.
  4. Complement the -CD line if necessary.
    Note: The actions that are available from the buttons are also available from the contextual menu of the tree.
    1. To insert a Data Structure in an existing Data Structure -CD line to specify a composite Data Structure, select this -CD line or a Data Structure call line that is nested under the -CD line. Click Add Data Structure.

      In the selection wizard that opens, select the instance that you want to call in the Program and click OK.

      If the instance does not exist yet, click New Data Structure. In the creation wizard, enter its name and label and click OK. The new Data Structure is then displayed in the selection list. If you select it and click OK, it is nested under the selected -CD line.

    2. To insert a Report in an existing Report -CD line to specify a composite Report, select this -CD line on the first level of the tree, or a Report call line that is nested under the -CD line (on the second level of the tree). Click Add Report.

      In the selection wizard that opens, select the instance that you want to call in the Program and click OK.

      If the instance does not exist yet, click New Report. In the creation wizard, enter its name and label and click OK. The new Report is then displayed in the selection list. If you select it and click OK, it is nested under the selected -CD line.

    3. To insert a Segment in a Data Structure that is already called in the Program, select this Data Structure call line or a Segment call line and click Add Segment.

      In the selection wizard that opens, select the instance that you want to call in the Program and click OK.

      If the instance does not exist yet, click New Segment. In the creation wizard that opens, enter its name and label and click OK. The new Segment is then displayed in the selection list. If you select it and click OK, it is nested under the selected Data Structure call line.

What to do next

After the -CD lines have been inserted, you modify the default characteristics of the -CD lines in the sections that automatically open, depending on your selection:

  • To change a Data Structure code in program, external name, or describe its usage for example, you must select a Data Structure CD line and modify the values from the table or the -CD Line Definition (Data Structure) section. You can click More in the definition section to access specifications that are not displayed directly in the section.
  • To specify whether all of the Data Structure Segments are to be called in the CD line, you must select a Data Structure call line. Then, you can modify the selection in the Data Structure call section. From this section, you can also change the called Data Structure and access the Data Structure editor. The called Data Structure can also be changed directly from the table.
  • To specify the Segment code in program, you must select a Segment call line and enter this code in the table or the Segment call section. You can also access the Segment editor.
  • To enter the characteristics of the Report that is called in the -CD Lines, you must select a Report line. Then, you can modify the default values in the table or the -CD Line Definition (Report) section.
  • To change the suffix of a Report, you must click the Report call line and enter this suffix in the table or the Report call section. From this section, you can also change the called Report and access the Report editor.

Feedback