Rational Developer for System z, Version 8.0

Comment

To display the contents of this section, you must select a comment call in the tree. You enter a comment and indicate where it is to be inserted in the generated program.

COBOL position
You indicate the placement and the sequence in which the lines entered in this tab are to be generated. These characters form the first two characters of a sequencing number, with the value in the line number as the last three digits.
Table 1. Values for the COBOL position
Value Meaning
For a batch program
AA to ZZ and 0A to 0Z These values cause the lines entered in this tab to be generated at the beginning of the WORKING-STORAGE SECTION.
These lines are generated:
  • Before the description of the Data Structures whose organization is W: file description in Working and whose code in program matches this prefix or is greater than it,
  • Before the description of the Data Structures whose organization is L: Working with placement, and whose COBOL position matches this prefix or is greater than it.
00 to 09, 1A to 19... 9A to 99 The lines entered in this tab will be generated in the WORKING-STORAGE SECTION, after all the Data Structures whose COBOL position is lower than this prefix
For a transactional program
AA to 0Z The description is generated in the WORKING-STORAGE SECTION.
00 to 99 The description is generated in the LINKAGE SECTION.
AA and 00 These values are used for automatically generated data.
99 With a Line number = 999, this value is used for the PROCEDURE DIVISION statement. Therefore, you can use it to create a line with a sequencing number 99999, which replaces the PROCEDURE DIVISION line automatically generated.
$n This value represents a parameterized value in a Macro.
Line number
This line number, constituted of three digits, is concatenated with the two characters of the COBOL position. The line number can be:
  • 0 to 999: It is advised to number the lines, starting with 10, by intervals of 10, to facilitate any future insertion
  • $n0 to $n9: In a Macro, only the first two characters of the Line number can be parameterized.
Comment
Enter the comment which is to be inserted in the generated code.
When used in combination with the Occurs field, you must declare the work areas by entering their data names in the following format; w-ddss-eeeeee, where:
  • w = WORKING-STORAGE SECTION prefix (alphabetic or numeric),
  • dd = Data Structure which includes the work area,
  • ss = Segment,
  • eeeeee = Data Element.
The value entered in this field must be left-aligned. The w- prefix can be omitted, but two spaces must then be entered to replace it.
Occurs
You must indicate a number in this field when the data name (entered in the Comment field if you are viewing a comment call, or in the Text before field if you are viewing a Data Element call) repeats several times. You enter the maximum number of occurrences. This value is numeric, on five characters maximum.
An entry in this field causes the generation of the following three indexes (ddss = Segment code):
  • IddssM initialized to the value entered.
  • IddssL initialized to zero. This index can be used to load the table. It keeps track of the actual table size
  • IddssR initialized to zero. This index can be used for table searches.

In a Macro, you can parameterize it by assigning it a $n value


Terms of use | Feedback

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