Rational Developer for System z

Library Definition

The purpose of this tab is to define a Library. It consists in specifying the default generated language, and the options associated with the dates.

Type of COBOL code
This field is used to automatically adapt the extracted elements from a higher level Library to the COBOL type specified.
Extracted entities include the internal usage of Data Elements, COBOL literals, Programs and Data Structure calls, Reports with a WRITE AFTER mode specified (if the language variant recommends the WRITE BEFORE mode).
Table 1. List of COBOL types
Value Comments
N No adaptation to any language variant (default option at definition level).
0 IBM MVS/ESA OS/390
1 IBM DOS/VSE
3 UNIX, WINDOWS
4 BULL GCOS7
5 BULL GCOS8
8 UNISYS A SERIES : this variant is required at the Library level to work in half-byte packed mode.
Note: If this value '8' is entered on the Library Definition after the Data Element formats have been defined, the formats of the elements entered on the definition and Segment/Screen call of elements (including fillers and undefined elements), must be reentered to take the lengths into account.

This option can also be used with BULL GCOS8. In that case, the generation variant '5' must be entered in the Programs and Screens.

F TANDEM
I DEC/VAX VMS
K COBOL ICL 2900
O COBOL AS/400
U COBOL UNISYS 2200 Series
X COBOL II IBM MVS/ESA OS/390.
Q ACUCOBOL
C COBOL source code
Generated language
You select the program generation language, depending on the hardware in use:
  • C: COBOL,
  • or COBOL II, 85, LE which is the default value.

COBOL target

By default, the generated COBOL files are stored with the design files. However you can separate them from the design files or even change the generation project and folder.

Note: Additional information related to the Generation target of a Program or a Screen is available.
COBOL project
The files generated from this instance will be stored in the project displayed in this field.

The project of the corresponding design file is the default project. If it has been kept, Default is displayed between parentheses next to the project. However, if it has been explicitly changed in the instance, only the project is displayed here, without any other indication. If it has been explicitly changed in the generation Library, Inherited from Library is then displayed between parentheses next to the project. In the instance, you can overwrite the value inherited from the Library.

You can select a new project by clicking the arrow or the Change COBOL project and folder button.

If you change the project, it will be taken into account upon the next generation.

COBOL folder
The files generated from this instance will be stored in the folder displayed here, inside the project displayed in the previous field

The folder of the corresponding design file is the default folder. If it has been kept, Default is displayed between parentheses next to the folder. However, if it has been explicitly changed in the instance, only the folder is displayed here, without any other indication. If it has been explicitly changed in the generation Library, Inherited from Library is then displayed between parentheses next to the folder. In the instance, you can overwrite the value indicated in the Library.

If the default folder has been kept, you can specify a root path for the generated files in the Properties wizard (accessed by clicking the Change project properties button). This path will be automatically inserted in this field, at the beginning of the folder.

You can select a new folder by clicking the arrow or the Change COBOL project and folder button.

If you change the folder, it will be taken into account upon the next generation.

Change project properties
This button opens the Properties wizard, where you can specify
  • A root path for the generated files, provided the default generation folder has been kept.
  • A root path for the metadata files, which are stored by default in the same folder as the other generated files.
Note: A detailed help is available from the Properties wizard of the project.
Change COBOL project and folder
This button opens a selection page with all the projects and folders already present in your workspace.

Expand the appropriate project and select a folder or create a folder. Click OK. The selected folder and project are then automatically displayed in the corresponding fields here.

Map type
Enter the TP monitor variant:
Table 2. Possible values of the TP monitor variant, according to the selected COBOL type
Values Comments
N No generation.
0
  • Variants 0, 1, X
  • Variant Q for ACUCOBOL
  • Variant 3 for UNIX, WINDOWS
  • Variants 4, 5 for BULL GCOS7 and GCOS8
  • Variant I for IBM DOS/VSE
  • Variant U for UNISYS 2200 Series
  • Variant 8 for UNISYS A Series
  • Variant O for COBOL AS/400.
1
  • Variants 0, X.
  • Variant 3
  • Variants 4, 5
2
  • Variants 0, 1, X
  • Variant 3.
3 Variants 0, X
4
  • Variants 0, X
  • Variant 3
5 Variants 0, X for CICS (IBM) monitor
C
  • Variants 4, 5, U
  • Variants 0, 1, X
  • Variant K
  • Variant 8
F
  • Variant 4 for (BULL GCOS7
R Variant F for 'REQUESTER' type program or variant R for 'CLIENT' type program.
S Variant F for 'SERVER' type program or variant R for 'SERVICE' type program.
Alphanumeric delimiter
This character delimits alphanumeric literals in the generated COBOL programs.
Depending on the value in the COBOL type field, the default option is:
  • ': a quotation mark for IBM variants type,
  • : a double quotation mark for other variants.
Note: With these default options, the single and double quotation marks, if any, included in the Data Element labels are displayed as blanks in the -CE Lines tab.
Decimal point delimiter
When using the OnLine Systems Development function, this field specifies the character to be used as the decimal separator:
  • . period,
    Example: 1000.00
  • , comma,
    Example: 1000,00.
Century system date
With this option, the system date indicates the century in the generated applications:
Table 3. Specification of the century system date
Values Comments
N With COBOL II or COBOL 85.

This is the default value.

If the year is smaller than the value entered in the Century reference date field, it is prefixed by 20. If it is greater, it is prefixed by 19

C With COBOL II or COBOL 85 compatible with the year 2000.

Direct retrieval of the system date including the century according to the COBOL capabilities.

W With other COBOL languages.

A value is set for the century as with the N value.

Century reference date
This year is used to calculate the century during a date transformation containing only the year. The default value upon the creation of the generation parameters is 61.
This calculation occurs if:
  • The system date does not include the century and the calculation is performed with the N or W value entered in the Century system date field.
  • A date transformation operator is used. The calculation mode depends on the operator used.
Generated date format
When using the OnLine Systems Development function, this field specifies the date format to be used in generated programs:
Table 4. Specification of the English or French date format
Values Comments
E MM/DD/YY format.
F DD/MM/YY format.
Comments insertion option
You can use the O or N values but you are advised to rather use the Y or S values presented in the table:
Table 5. Options for the insertion of comments
Values Comments
Y The titles and frames of functions or subfunctions, and the inserted comments (' * ' operator) are present in the generated COBOL.

Moreover punctuation is automatically calculated for comment lines which do not include a block type.

The block type of the next processing is then taken into account for this calculation.

S

The titles and frames of functions or subfunctions, and the inserted comments ('*' operator) are ignored at generation time.

O

Same as the Y value. However in the Batch Applications function, the punctuation of comments is not calculated; it varies according to the block type present on these lines.

N

Default option when the Library is created. Same as the S value. However for the Pacbench C/S and OLSD functions, the inserted comments lines ('*' operator) are included in the generated COBOL.


Terms of use | Feedback

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