Rational Developer for System z, Version 7.5

-W Lines tab

The purpose of the '-W Lines' tab is to modify the Working Storage and/or Linkage sections, supplementing the descriptions obtained automatically. It will complement the Data Division in the generated Program.

The '-W Lines' tab enables you to complement the standard processing of the COBOL Data Division:
  • by adding information in the Working-Storage Section,
  • by adding sections at the end of the Data Division.
The line beginning determines the location where this customized information will be generated:
  • at the beginning of the Working-Storage Section if the line beginning is alphabetic,
  • at the end of the Data Division if the line beginning is numeric.
In the '-W Lines' tab, you can:
  • Insert comments,
  • Call Data Elements in the desired format
  • Call Data Structures and Segments,
  • Generate the indexes used in a table search (with the 'SCH' (Search) operator). This is done by specifying an 'Occurs' value (which generates an Occurs clause ).

Recommendation

The 'CD Lines' tab defines resources that are external to the program (file, databases, etc.), whereas the '-W Lines' tab groups the work and link areas.

This way, they can be organized easily. If you call a Data Structure in the '-W Lines' tab, you cannot specify all the information (such as file matching, generation information...) you can specify in the 'CD Lines' tab.

Description of the tab

The '-W Lines' tab displays lines, if any, which call Data Elements, Data Structures, comments... It is constituted of three different parts:
  • On the left, an area with the list of -W lines already inserted. Each line begins with the icons representing the inserted elements. Next to the icons, you can see the two characters of the COBOL position, and the three characters which represent the line number of the called element. Then, after a comma, the information varies according to the inserted element.
    • Comment (Comment icon). After the comma, you can see the text of the inserted comment and, in parentheses, the occurs number.
    • Data Element (Data Element icon). After the comma, you can see the Data Element name
    • Data Structure (Data Structure icon). After the comma, you can see the Data Structure 'code in program'. And then, in parentheses, you can see the Segment (the last two characters of the Segment codes) if Segments have been specified for this Data Structure call, or you can see 'all segments' if no Segment has been specified.
    • Under the Data Structure call, there may be one or more Segments (Segment icon). If no Segment has been selected, all the Segments are selected by default and they are not displayed here.
  • In the center part, buttons which enable you to add -W lines to your Programs/Macros, remove existing ones or move them up/down.
  • On the right, sections which open up depending on your selection in the left area:
    • If you select a comment, the -W Line Comment Line Definition section opens up.
    • If you select a Data Element, the Data Element Call Definition opens up. From there, you can access the Data Element editor tabs, and you can also change the Data Element while keeping all the Definition information already entered.
    • If you select a Data Structure, the Data Structure Call Definition opens up, From there, you can access the Data Structure editor tabs, and you can also change the Data Structure while keeping all the Definition information already entered.
    • If you select a Segment, the Segment Call Definition opens up, where you indicate the (Segment code in the Program' and from where you can access the Segment editor tabs.
Related reference
Macro Overview tab
-G Lines tab
Keywords tab
Documentation tab
Program Overview tab
Program Definition tab
-CD Lines tab
-CP Lines tab
-G Lines

Terms of use | Feedback

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