Rational Developer for System z, Version 8.0

Data Structure call

To display the contents of this section, you must select a Data Structure call in the tree or click Add Data Structure. You must give the Data Structure its code and location in the generated Program, and some physical characteristics. You must also select which of its Segments are to be taken into account. From here, you can access the Data Structure editor tabs.

Data Structure selection
The called Data Structure is shown here. You can change it by clicking Change. The values already entered in the call are kept and automatically apply to the new Data Structure.
Segment selection
Rather than describing all the Segments belonging to the Data Structure, you can select only the required Segment. This way, you avoid unnecessary description lines and wasted work area space.
  • If you select all Segments, the Data Structure call includes all the Segments (their codes are not shown on the call line).
  • If you select Specified Segments, the list in the left part then displays one line for each Segment of the Data Structure. You must remove the unwanted Segments. To do so, click a Segment in the tree and click Remove. Repeat this operation with other Segments as many times as necessary.
  • If Segment codes have been parameterized in a Macro, click Parameterized selection and specify these Segment codes in the edit box.
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.
Code in program
This code is two characters long. The first character must be alphanumeric and the second character must be either numeric or alphabetic.

It sets the sequence in which the Data Structure or Report is processed in the program.

When the Data Structure or Report is used only once in a program, it is advised to indicate the code entered as the Data Structure or Report name. This name is entered upon creation. However if it is called more than once in a program, you can differentiate these calls.

You can parameterize this code in a Macro with $n.

Format type
Select the format of the Data Elements called in the Segments of the Data Structure:
  • E : Input,
  • I: Internal,
  • S: Output.
Note: The Data Elements making up the Segments must not exceed 999 characters.
Generated description type
You select the type of record description to be used in the COBOL program to allow different uses of the Segment description stored in the Library.
Table 2. Values of the generated description types
Value Meaning
Redefined records No VALUE clause is generated
1: Records without initial values Records without initial values or occurs. These records contain the Segment common part, followed by the different specific parts.

If the Data Structure description is included in the COBOL FILE SECTION, the COBOL record level field must be set to 2: COBOL 01 level for DS area and segments at 02 level.

With this value, the specific Segments are described without redefines, at the COBOL level 02. Several Segment descriptions are grouped under the same I/O area.

2: Records with initial values Records with the specific initial values indicated in the Segment -CE Lines tab. These values can also default to blank or zero depending on the format. Initial values are also generated for the multiple occurrence fields if the Generated language of the Library is set to D: COBOL II, 85, LE.
3: Records with occurs (used with level 2) Records which incorporate the number of occurrences indicated in the Table size field of the Segment Definition tab.

No VALUE clause is generated.

If the Data Structure description is included in the COBOL FILE SECTION, the COBOL record level field must be set to 2: COBOL 01 level for DS area and segments at 02 level.

This type of description cannot be used if the common part Segment of this Data Structure is assigned a value in the Table size field of the Segment Definition tab. In that case, set the Organization to W: File description in Working and the Usage to T: Table stored in memory.

4: Records with occurs (used with level 3) Records which incorporate the number of occurrences indicated in the Table size field of the Segment Definition tab. The associated 'Level' field must be set to 3.

The associated COBOL record level must be set to 3: COBOL level varying with records description type

Comment specific to the OnLine Systems Development function: The index is not generated if the Generated description type set to 4: Records with occurs (used with level 3), and the COBOL record level is set to 3: COBOL level varying with records description type,

A COBOL level 02 is used to access the table made up of occurs of the same record (ddssT).

A COBOL level 01 is used to group the whole Data Structure (common or specific parts, whether occurred or not). A group level field that incorporates all instances is generated.

This type of description cannot be used if the common part Segment of this Data Structure is assigned a value in the Table size field of the Segment Definition tab. In that case, set the Organization to W: File description in Working, and the Usage to T: Table stored in memory.

COBOL record level
This option is used with the Generated description type field. It defines the COBOL level number for the descriptions of Data Structures, Segments and Data Elements. In the following descriptions, the expression 'D.S. Area' is meant as the dd00 area (possibly 1-dd00, 2-dd00).
Table 3. Possible values for the COBOL record lvel
Value Meaning
1: COBOL 01 level for DS area and segments If the Data Structure description is included in the COBOL FILE SECTION, the Segments must be redefined.

If a Data Structure has no common part with a non-redefined description, the D.S. Area is only included when the Generated description type is set to Redefined records.

2: COBOL 01 level for DS area and segments at 02 level If the Generated description type is set to Redefined records, the D.S. Area and Segments are described at level 02. Preferably set the Organization to L: Working with placement and define the higher levels through work areas.
3: COBOL level varying with records description type Level 02 for D.S. Area and level 03 for Segments if the Generated description type is set to 1: Records without initial values, 2: Records with initial values or 3: Records with occurs (used with level 2).

Level 01 for D.S. Area and level 03 for Segments if the Generated description type is set to 4: Records with occurs (used with level 3).

Level 03 for both the D.S. and Segments if the Generated description type is set to Redefined records.

4: COBOL 02 level for Data Elements, DS Areas and Segment levels disappear Reserved for the D.S. with an Organization set to L: Working with placement and a Usage set to D: Output file.

Level 02 for the group Data Elements or elementary Data Elements that are not part of a group. The elementary Data Elements that are part of a group are displayed but the D.S. Area and Segment levels are not included.

Level 01 is to be defined in the -W Lines tab.

5: COBOL 01 level for Data Elements, DS Areas and Segment levels disappear Organization set to L: Working with placement or W: File description in Working and a Usage set to D: Output file.

Level 01 for the group Data Elements or elementary Data Elements that are not part of a group. The Elementary Data Elements that are part of a group are displayed but the D.S. Area and Segment levels are not included.

Organization
Select a line in the drop-down list.

You can select whether the Data Structure must be generated in the WORKING-STORAGE SECTION, or as the description of a Pactables Table.

You can also use this field to specify database descriptions when the Database Description function is not used. These values are taken into account by application Programs.

Table 4. Possible values for the organization
Value Comment
S: Sequential Only authorized value for a Report, a sequential file or a sort file Data Structure.
V: VSAM, UFAS One of the two possible values for an indexed file Data Structure

This value generates the STATUS KEY IS clause. The corresponding field is declared in the File Status field of the -CD Line Definition of the -CD Lines tab (the part which can be viewed by clicking More).

I: Indexed The other possible value for an indexed file Data Structure.

This value corresponds to an indexed sequential organization (ISP for GCOS8 BCD).

An ISP file coded LE is generated in 3 work areas:
  • LE-FILE,
  • LE-DATA
  • INVKEY.
The VALUE of LE-DATA is the external file name which must be the file code in the preceding $ DATA line. In the job control lines, the ISP lines give the physical characteristics of the file.
G: Table description This value generates the communication area with the Pactables function.
L: Working with placement File descriptions are generated in the , in the location you indicate in the COBOL position field.
W: File description in Working File descriptions are generated in the , before the WSS-BEGIN' constant.
Y: Pacbench C/S Call of the COPY clause which corresponds to the communication area between the client and the server (Pacbench C/S Business Components only).
X: Comment Data Structure used as a comment, not used for generation.
2: DB2 Segments or VAX/SQL Generation and description of a DB2 or VAX/SQL Segment. Only the physical accesses are not generated. The structure of the variable indicators corresponding to the columns of the DB2 or VAX/SQL table is always generated.
Q: DB2 or ALLBASE/SQL Reserved for the description of SQL/DS, DB2/2 or DB2/6000 databases (IBM), or ALLBASE/SQL databases (HP3000), or DB2/2 or DB2/600 databases (MICRO FOCUS).
D: DL/1, IDS I and II Reserved for the description of Segments or records of the IMS (DL/1), IDS I or IDS II databases, in the generation of DBD, SYSGEN, schemas or application programs
B: IDMS  
A: ADABAS  
T: 'TOTAL' files  
O: ORACLE (< V6)  
C: INTEREL RDBC or RFM  
R: RDMS  
4: DB2/400  
M: DATACOM DB  
N: NONSTOP SQL  
P: ORACLE V6 and V7  
9: INFORMIX, SYBASE, INGRES/SQL, or SQL SERVER  
Z: Data Structure for SOCRATE/CLIO  
F: Formal for SOCRATE/CLIO  
Subschema
A subschema is a group of Data Elements called in the Segment.

This field is used with the Pactables function, to indicate which subschema is to be described. It is numeric, from 0 to 9 (0 corresponds to subschema 10).

Group segments by Data Structure
If this box is checked, all the Segments of the same Data Structure are to be grouped in the generated code.
If you click the buttons in the bottom part of the section, you open the corresponding Data Structure tabs.

Terms of use | Feedback

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