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 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 that is inherited from the Library.

You can select a new project in the drop-down list.

If you change the project, the COBOL file and map file (for Screens) are automatically set to the default value (rpp). The new project will be taken into account upon the next generation.

COBOL folder
The files that are 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 in the drop-down 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 will be taken into account upon the next generation.

Change project properties
This button opens the Properties wizard, where you can perform 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
This field is optional. You enter it only if a specific file exists for the error messages. This file has a .properties extension. Click Browse to easily select the specific file.

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.

If you migrate Pacbase applications, this file was created by the MILA procedure.

You can also create a specific error message file. To do so, create a file with a .properties extension. Copy and paste all the following lines and modify some or all the messages (second part of each line):
Figure 1. List of the standard error messages that can be customized
2 = 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

Feedback