Definition tab
In this tab, you must indicate the generation target and the external name of the error message file, and the generation language and option. If a specific error message file was created to replace the standard messages of the errors that are detected automatically, you must indicate it.
- Error Message type
- The value of this field was selected when the
Error Message instance was created. It cannot be modified. Each Error Message type is associated with an entity type:
- A B : Batch type is associated with a Data Structure.
- An O : Standard Dialog type is associated with a standard Dialog.
- A C : Client Dialog type is associated with a client Dialog.
- An S : Server Dialog type is associated with a server Dialog.
- Linked entity
- The value of this field was selected when the
Error Message instance was created. It cannot be modified.
It contains an instance of the linked entity that is associated with the Error Message type.
By default, the error messages that are indicated in all the instances that constitute the linked entity are generated. So, if a Data Structure is selected, the messages that are indicated in all its Segments are generated by default. The same principle applies to the Screens that constitute a standard Dialog, the client Screens that constitute a client Dialog, and the Servers that constitute a Server Dialog. However, in the Selection tab of the Error Message editor, you can select the constitutive instances whose error messages are to be generated.
COBOL target
By default, the generated COBOL files are stored with the design files in a root folder whose default name you can change. You can separate them from the design files or even change the generation project and folder.
In a Library, the default values of the COBOL project and of the COBOL folder are the values of the current project.
- COBOL project
- The files that are 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 is kept, Default is displayed between parentheses next to the project. However, if it is explicitly changed in the instance, only the project is displayed in this field, without any other indication. If it is 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 that is inherited from the Library.
You can select a new project in the list.
If you change the project, the COBOL folder is automatically set to the default value (rpp). The new project then applies to the next generation.
- COBOL folder
- The files that are generated from this instance are stored in the folder displayed in this
field, inside the project from the previous field.
The folder of the corresponding design file is the default folder. If it is kept, Default is displayed between parentheses next to the folder. However, if it is explicitly changed in the instance, only the folder is displayed in this field, without any other indication. If it is 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 is kept, you can specify a root path for the generated files in the Properties wizard (accessed by clicking Change project properties). This path is automatically inserted in this field, at the beginning of the folder.
You can select a new folder in the list. Creating a folder is impossible at this stage. Folders must have already been created in the project, for example from the Resource perspective.
If you change the folder, it applies to the next generation.
- Change project properties
- Click to open the Properties wizard, where you can complete the following actions:
- Change the default folder. This folder contains the design files and is the default target of the generated and metadata files.
- Indicate a root path for the generated files, if the default generation folder has been kept.
- Indicate 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.
- External name
- This name represents the name of the file that is generated from
this instance.
Its default value is the instance name but you can modify this value.
- Generated language
- You can specify the generation language (EN or FR) for the error messages.
- Generation option
- Select one of the following options:
- C1: Generation of the error messages that are specified in the linked entity and in its constitutive instances (for example a Data Structure and its Segments, or a Dialog and its Screens). This value can be selected for all the Error Message types.
- C2: Same as C1,
plus generation of the documentary error messages for the Batch type,
or generation of the online help for the Dialog (standard
or client) type. Note: This option is not available for the Server Dialog type.
- C3: Generation of the error messages of the Dialog type (standard, client, or server) only. The error messages of the constitutive instances are not generated.
- Specific error message file
- You indicate whether a specific error message file is taken into account.
The error messages it contains will replace the standard messages when errors are detected by the controls that are specified on the Segment -CE Lines tab.
The specific error message file must contain the following lines. Some or all of the messages (second part of each line) can be modified:Figure 1. List of the standard error messages that can be customized2 = INVALID ABSENCE FOR THE FIELD 3 = INVALID PRESENCE FOR THE FIELD 5 = INVALID VALUE FOR THE FIELD 4Z = NON-NUMERICAL CLASS FIELD 4A = NON-ALPHABETICAL CLASS FIELD 8F = INVALID CREATION RECORD 9F = INVALID DELETE/MODIFY RECORD 9G = END OF LIST DU = INVALID CREATION RECORD NF = INVALID DELETE/MODIFY RECORD EN = END OF LIST AB = ABSENCE OF RECORD
With the following options, you can select a specific error message file:- Select a specific file in your workspace: If you select this option, the
files with a .txt extension in the .INTER project of the
current location are listed. You must then select one of these files.
If you work on Pacbase migrated applications, you can take into account the specific error message file that is extracted from Pacbase. If a specificErrorLabel.txt specific error message file is present in the .INTER project of the current location, it is automatically recognized.
- Select a specific file in your computer: If you select this option, you must enter the entire file path or select it by clicking Browse. The file must have a .txt extension.
- No specific file: This option is selected by default. It means that the standard error messages will be taken into account in the application.
- Select a specific file in your workspace: If you select this option, the
files with a .txt extension in the .INTER project of the
current location are listed. You must then select one of these files.