Rational Programming Patterns

Library -G lines tab

This tab contains two subtabs. The -GC Lines subtab is dedicated to the comments on the current Library. In the -GO Lines subtab, you can specify the generation options for your current Library.

-GC Lines

These lines are used for documentation purposes. Comments are available with all entities. You can write or edit text in relation to the selected instance. You can write, modify, move, or delete text lines by using basic word-processing functions.

Error
This column displays a dot on all the existing description lines which are not empty.

Moreover, if this line is not correct, this column also displays an error or warning symbol, depending on the severity of the error. A hover help indicates the source of the error.

Type
To add a line, click Add (or select this action in the contextual menu). Click in the Type field and select one of the following values:
Table 1. Types of -GC lines
Value Comments
* or blank Standard documentation line
A Available on the Segment entity only.

Alias for the Segment name.

Description
Move your cursor to the Description field, and enter your comment.

On a blank-type line you enter a free comment.

On an A-type line you enter the COBOL Segment name.

Note: Double clicking a word selects the word.

-GO lines

Error
This column displays a dot on all the existing description lines which are not empty.

Moreover, if this line is not correct, this column also displays an error or warning symbol, depending on the severity of the error. A hover help indicates the source of the error.

The -GO lines can be updated by administrators only, to enter generation options. The administrator can:
  • Indicate the SCM import environment and application code,
  • Request the keeping of the date transformation function,
  • Modify the format of the generated indexes
  • Request the generation of cursor for update,
  • Request the breakdown of generated dates.

SCM Import environment

On an option line, you can specify the short code of the SCM import environment recognized upon generation and the application code:

EEE DE RE DEFAULTAPP REQUIREDAP

with:
  • EEE: entity type
  • DE: short code of default environment,
  • RE: short code of required environment,
  • DEFAULTAPP: default application code (10 char. max.),
  • REQUIREDAP: required application code.

Date transformation function

For the Batch Applications function only, if:
  • You use a date transformation, generated by default in F9520,
  • The DATPRO option is not used at the Program level,
  • You have specific code lines inF95,
Then you can request, with the option F9520=N, the generation of the standard F9520 subfunction and the preservation of the specific lines entered in F95.

The F9520=N option is therefore recommended.

With the opposite option (F9520=Y, default option), the standard F9520 subfunction is not generated; it is overridden by the specific lines entered in F95.

Note: If the F9520 subfunction contains specific lines, the date transformation standard subfunction is not generated whichever the option selected here. It is generated if you set the DATPRO option in the -GO lines of the specified Program.

Format of generated indexes

This option applies to the indexes which are generated at the beginning or the WORKING-STORAGE SECTION of Programs, under the 01 INDICES level.

By default, these indexes are formatted according to the value of the Program generation variant. This format is displayed in the generated program, on the 01 INDICES line.

If you want to change this format (to increase the size of these indexes, optimize the processing time...), enter the

INDIC=format option (where 'format' is the new format of the indexes, entered (where 'format' is the new format of the indexes, entered in full). This option must be entered alone on a line, beginning in column 1. 'Indexes format' option and, in the 'Line option' field, enter the new format in full.
Example:
Type   Description
 O     INDIC=COMPUTATIONAL-3

Generation of cursor update

If you enter the CURSUPDT=YES option, the SQL Select statements are replaced with cursor for update statements in a read for update access.

Breakdown of the generated dates

You request the breakdown of the generated dates into elementary fields by entering BREAKDATE=YES. This breakdown is effective:
  • For Programs: on the elementary Data Elements of the Segments called in the -CD lines and in the work areas on F-type lines.
  • For Dialogs/Screen: on the elementary Data Elements of the Segments called in the Dialog Complement, in the calls of Segments and in the work areas (on F-type lines).
  • On the Data Elements called in the work areas, on I, E or S-type lines.

If you indicate the BREAKDATE=YES option, the Data Elements defined with a date format are generated as elementary fields. These fields correspond to the year, month, day, and separator (if it is included in the date format).

A date is broken down only if the generated COBOL level of the date field is lower than or equal to 47.

If a VALUE has been entered, it is generated in the group field.

Any additional information (such as a value) must be entered on the same line as the Data Element call on I, E or S-type lines on the work areas. If a continuation line has been specified, the date is not broken down.


Terms of use | Feedback

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