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.
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 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.