Rational Developer for System z, Version 7.5

Data Element call

This wizard contains the information specified in the 'Data element call' section of the '-W Lines' tab of the Program. You specify where this Data Element will be located in the generated Program, its format and its corresponding data-name.

COBOL position
This field enables you to indicate the placement and the sequence in which the lines entered in this tab will 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.
Value Meaning
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.
Relatively to the Data Structures called in the -W Lines tab, these lines will be generated as follows:
  • Before the description of 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 Data Structures whose organization is 'L: Working with placement' or 'D: DL/1,IDS I and II', 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
$n This represents a parameterized value in a Macro-Structure
Line number
This line number, constituted of three digits, will be concatenated with the two characters of the 'COBOL position'. The line number can be:
  • 0 to 999: As a recommendation, you should number the lines, starting with 10, by intervals of 10, to facilitate any future insertion
  • $n0 to $n9: In a Macro-Structure, only the first two characters of the Line number can be parameterized.
Line type
Here you must select which format is going to be used for the Data Element call:
  • E’: Input format,
  • I’: Internal format,
  • S’: Output format.
Text before
This field is divided into two sub-fields:
  • The 'Level or Section', constituted of the first 17 positions of the field, In this sub-field, you must enter the COBOL level number (01, 05...) or the Section name (LINKAGE SECTION,...) in which this line will be generated.
  • The 'Work area declaration', which starts from position 18, to the end of the field. You must declare the beginning of the data-name, which will be concatenated with the Data Element code to constitute the actual data-name.
    So you must enter w-ddss- (without omitting the dashes), where:
    • w = Working-storage prefix (alpha or numeric),
    • dd = Data Structure code, including the work area,
    • ss = Segment code,
    Once concatenated with the Data Element code, the data name will be: w-ddss-eee (with eeeeee as the Data Element code). Cross-references between the Data Element and the Program will be established automatically.
    Note: When a Data Element existing in the Repository is called in a work and link area, you must enter the beginning of the data-name in this field. Otherwise, the generated code will be formatted this way:
    03 DDSS-DELCO PICTURE X.
Text after
In this field, you must enter the characters which will be inserted in the generated code, after the data-name. Most often, you just enter a period ('.') but you can also enter other values (ex: 'VALUE SPACE').
Occurs
You enter here the maximum number of occurrences for the table. This is a pure numeric field, on 5 characters maximum.
An entry in this field causes the generation of the following three indices: IddssM, IddssL and IddssR (ddss = Segment code).
  • IddssM initialized to the value entered.
  • IddssL initialized to zero. This index may be used to load the table. It keeps track of the actual table size
  • IddssR initialized to zero. This index may be used for table searches.
The Data Structure and Segment codes are entered, prefixed with some work area prefix code in the following format: 'w-ddss' or 'w-ddss-eeeeee'.

In a Macro-Structure, it can be parameterized by assigning it a $n value


Terms of use | Feedback

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