Library -G lines tab
This tab contains the -GC Lines for the comments on the current Library and the -GO Lines for the generation options.
-GC Lines
These lines are used for documentation purposes. You can write or edit text in relation to the selected instance. You can write, modify, move, or delete text lines by using the standard word-processing functions.
- Click Add or select this action in the contextual menu to add a comment line or an alias for a Segment. Then, click in the Type column to select the line type to be inserted. Enter the comment or the alias in the Description field.
- Click Add an Input Aid call or select this action in the contextual menu to insert
an Input Aid call. A selection box opens. It displays the available
Input Aids that have a C: Comments type. Select one of them and click OK.
The variable labels and the symbolic values that are indicated in the selected Input Aid -D Lines tab are then displayed in the Description column, in a read-only mode. The Input Aid name is displayed in the Input Aid column.
If you click the Input Aid name in the Input Aid column, a button is displayed. Click it to see all the Input Aid description lines in a detail window. In this window, you can modify the variable labels and the symbolic values.Note: The length of a variable label cannot exceed the length that is defined in the Input Aid -D Lines tab.
- Error
- This column displays a dot on all the existing description lines
that 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
- You can select one of the following values:
- No value or * to insert a standard documentation line,
- A on a Segment only, to insert an alias for the Segment name.
This column displays a value I on all the Input Aid insertions. This value cannot be selected directly.
- Description
- This column can be entered or not according to the inserted line type:
- If you inserted a comment or an alias line, you must move your cursor to this column and enter
the required information:
- On a line without any line type or with a * line type, enter a free comment. You can use the standard word-processing shortcuts to copy, paste, and delete text content in the comment lines. Double-clicking a word selects the word.
- On an A line type, enter the Segment COBOL name.
- If you inserted an Input Aid call line, the variable labels and the symbolic
values that are indicated in the selected Input Aid -D Lines tab are
displayed.Note: The width of the Description column is limited to 60 characters. To see the whole of an Input Aid call that exceeds 60 characters, hover over the column content. The whole call is then displayed in a tooltip.
- If you inserted a comment or an alias line, you must move your cursor to this column and enter
the required information:
- Input Aid
- This column contains the name of a called Input Aid. If you click the button that is displayed when you click in this column, you can see the Input Aid description in a detail window. In this window, you can modify the variable labels and symbolic values.
-GO lines
- Click Add or select this action in the contextual menu to indicate a generation option. Click in the Type column and select the O line type, then enter the generation option in the Description column. You can also add a comment line.
- Click Add an Input Aid call or select this action in the contextual menu to insert
an Input Aid call. A selection box opens. It displays the available
Input Aids that have an O:
Generation options type. Select one of them and click OK.
The variable labels and the symbolic values that are indicated in the selected Input Aid -D Lines tab are then displayed in the Description column, in a read-only mode. The Input Aid name is displayed in the Input Aid column.
If you click the Input Aid name in the Input Aid column, a button is displayed. Click it to see all the Input Aid description lines in a detail window. In this window, you can modify the variable labels and the symbolic values.Note: The length of a variable label cannot exceed the length that is defined in the Input Aid -D Lines tab.
- Error
- This column displays a dot on all the existing description lines
that 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
- You can select one of the following values:
- O: Generation option line,
- *: Line to insert a comment or an override. It will not be generated.
This column displays a value I on all the Input Aid insertions. This value cannot be selected directly.
- Description
- This column must contain the following information:
- If you inserted an O type line, you must enter the option name followed by the equals sign (=) and the option name. To activate an option, enter OPTION=YES (OPTION is the option code).
- If you inserted a * type line, you must enter the comment.
- If you inserted an Input Aid call line, the variable labels and the symbolic
values that are indicated in the selected Input Aid -D Lines tab are
displayed.Note: The width of the Description column is limited to 60 characters. To see the whole of an Input Aid call that exceeds 60 characters, hover over the column content. The whole call is then displayed in a tooltip.
- Input Aid
- This column contains the name of a called Input Aid. If you click the button that is displayed when you click in this column, you can see the Input Aid description in a detail window. In this window, you can modify the variable labels and symbolic values.
List of the generation options
- SCM Import environment:
On an option line, you can specify the short code of the SCM import environment that is 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 characters maximum),
- REQUIREDAP: required application code.
- Date transformation function: This option can be used in the following context:
- For the Batch Applications function only,
- If you use a date transformation, which is generated by default in F9520,
- If the DATPRO option is not used at the Program level,
- If the F95 function contains specific code lines.
The F9520=NO option is therefore recommended.
With the opposite option (F9520=YES, default option), the standard F9520 subfunction is not generated; it is overridden by the specific lines that are 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 that 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.
You can change this format, for example to increase the size of these indexes or optimize the processing time. Indicate the INDIC=format option, where format is the new format of the indexes, which is written in full.
Example:Type Description O INDIC=COMPUTATIONAL-3
- Generation of CURSOR FOR 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 datesYou request the breakdown of the generated dates into elementary fields by entering BREAKDATE=YES. This breakdown is effective at several levels:
- For Programs: on the elementary Data Elements of the Segments that are 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 that are called in the Dialog Complement, in the -CS Lines and in the work areas (on F type lines).
- On the Data Elements that are called in the work areas, on I, E or S type lines.
If you indicate the BREAKDATE=YES option, the Data Elements that are 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 was 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.