Definition tab
The values that are specified in the Dialog becomes the default values of the Folders that are attached to the Dialog. They are marked as Inherited in the Folder Definition tab. You can overwrite these default values in each Folder.
- 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 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 Dialog, Inherited from Dialog is then displayed between parentheses next to the project. 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 folder and map folder (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 Dialog, Inherited from Dialog is then displayed between parentheses next to the folder. 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, provided 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.
- Proxy
- The explanations of the COBOL target are relevant but they apply to the proxy that is generated from the Folder. This proxy has a .txt extension. It is used in a Client that was created in a graphical development tool. In this case, it contains the information that is required to interface the Client with the Server. You specify the generation project and folder of the Folder proxy. They default to the project and folder of the Folder design file.
- Program external name
- The name entered here is the name of the file that is generated from this instance. The generated file name can then differ from the instance name.
- Lock option
- The upload and download mechanisms used in the management of Folders increase the time lapse
between the reading of the initial image of a Folder and the return of its updated image. In this
context, a lock process can adequately prevent simultaneous updates on the same Folder occurrence.
In this manner, the coherence of accumulated updates is ensured. The following values are available:
- N: No lock option: This option is selected by default.
- P: Lock option - Before update: This option creates an exclusive ownership of the Folder, which is locked to all other users during the update.
- O: Lock option - After update: This option is active only when the update is requested. It compares the Folder image that is initially loaded with the current image. If they are identical, the update is accepted.
If you select a lock option, you must write the lock and unlock processing in the Business Component that is associated with the Folder root node. You must then create a subfunction that depends on a function 05*C. To do so, open the function and subfunction creation wizard from the COBOL code editor. Select the Business Component model with an Insertion relative to the Logical View processing, then select the service LOCK or UNLOCK.
- Paging mode
- Two paging modes are available:
- N: Non-extend paging mode: This option makes it possible to page forward and backward through a predefined population. Each paging operation (forward or backward) runs a reading request and its result replaces the result of the previous reading.
- E: Extend paging mode: This option makes it possible to page forward through a predefined population. The result of each paging adds to the result of the previous reading. The reading of the previous pages is then handled by the graphic client.
- Error Server
- If you do not specify it in the Dialog, you must specify it in the Folder. It is required. It
must correspond to a Server with a type E: Error Message Server and must be
defined.
It is used to access the error message file.
- Buffer
- The message between Client and Server can convey contextual data that is related to the
execution of the called service. You must manage this data in a structure that is named a user
buffer.
With the buffer, you can set fields that complement the technical Buffer (for the data compression or the identification of the end user for example). This buffer is included in each message that is exchanged between all the Business Components of the Dialog and the Client. If your application is to use a user buffer, you must declare the corresponding Segment in the -CS Lines of the Business Component Dialog and select the value W as its organization.
The Business Components of a Folder (root and depending nodes) must use the same Segment to define the user buffer. This rule is automatically respected if these Business Components belong to the same Dialog.
The user buffer of a Business Component that is called or associated with a reference node must have the same length as the buffer that is used for the root or dependent nodes.
A user buffer must not contain repeated or FILLER Data Elements.
In the Definition tab of the Folder Dialog, you must select the Segment that constitutes the user buffer. You can assign it a Code in the Folder that can be different from the Segment name to differentiate two buffer calls in a Folder.
In the Description type field, you can select one of the following values:- Conventional (fixed): The content of the 00 common Segment and the selected specific Segment is taken into account.
- 1: Database Segments: Only the content of the selected specific Segment is taken into account.
- E: Table type: Reserved for Table-type Segments.
- 2 : Conventional (variables) : ????
In the External name field, you can enter a name that is different from the Segment name. This name represents the name of the file that is generated from the buffer????