Definition tab

The values selected at the Dialog level become the default values of the Communication Monitor and are marked as Inherited in the Communication Monitor Definition tab. Inappropriate default values can be overridden at the Communication Monitor level.

Parent Dialog
This field is displayed in the Communication Monitor editor. It contains the name of the parent Dialog that was selected in the Communication Monitor creation wizard. This parent Dialog can be a Communication Monitor Dialog or a Server Dialog. If it is a Server Dialog, the Communication Monitor cannot inherit the values of the fields that are specific to the Communication Monitors. You can click Change to select another parent Dialog.
Type of COBOL and map to generate
Only the COBOL type X : IBM MVS/ESA OS390 and the transactional monitor variant 0 (IBM®/CICS®) are available.

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.

Note: More information on the Generation target of a Program or a Screen is available.

In a Library, the default values of the COBOL project, COBOL folder, and Map folder (for Screens only) are the values of the current project. If the project and folders are not indicated, the default values in a Dialog are the values of the Library or current project, as applicable. In a Screen or Server, the default values are the values of the Dialog, Library or current project, as applicable.

A COBOL folder or map (for Screen) can be indicated in various entities:
  • A library. It then constitutes the default value for all the Dialogs and Screens or Servers of this Library.
  • A Dialog. It then constitutes the default value for all the Screens or Servers of this Dialog.
  • A Screen or Server. It then applies to the instance only.
COBOL project
The files that are generated from this instance are stored in the project that is indicated 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 Dialog, Inherited from Dialog is then displayed between parentheses next to the project. 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 and map folder (for Screens) are 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 that is displayed in this field, inside the project displayed in 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 Dialog, Inherited from Dialog is then displayed between parentheses next to the folder. 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 that is 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 then 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 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, provided the default generation folder is 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.
Program external name
It is the name of the file that is generated from this instance. The generated file name can then differ from the instance name.
Message size
This field corresponds to the maximum physical size of a message between the client and the server, in kilobytes. Its value is included between 2 and 32 kilobytes. The default is 24.

This value depends on the capacity allowed by the network administration of the application runtime environment. The size of the message corresponds to the useful size of its content.

Error message sent
You can specify whether the Communication Monitor must send the error messages that are associated with the errors. The following values are available:
  • N: No error message sent: Only the error keys are sent.
  • Y: Error message sent: The error messages are sent. This value is the default value in the Dialog.
  • None: The value that is indicated in the Dialog is taken into account.
Communication type
The communication can be local or managed by TCP/IP.
Transaction code
Enter a transaction code that is associated with the Communication Monitor Dialog or the Communication Monitor. It must be on 8 characters maximum.

Feedback