-GO Lines of a Server Dialog or Server
You use these lines to enter generation options in a Server Dialog or a Server.
- Click Add or select this action in the contextual menu. By default, the type of the new line is set to * (comment). To indicate a generation option, click the Type column and select the O line type. Then, enter the generation option in the Description column.
- Click Add an Input Aid call
or select this action in the contextual menu to insert an Input Aid call. A
selection box opens. It displays the available Input Aids that have an O: Generation options
type. Select one of them and click
OK.
The variable labels and the symbolic values that are indicated in the selected Input Aid -D Lines tab are then displayed in the Description column, in a read-only mode. The Input Aid name is displayed in the Input Aid column.
If you click the Input Aid name in the Input Aid column, a button is displayed. Click it to see all the Input Aid description lines in a detail window. In this window, you can modify the variable labels and the symbolic values.Note: The length of a variable label cannot exceed the length that is defined in the Input Aid -D Lines tab.
- If you select Special copy, a dialog box opens. You must select the columns to be copied and indicate whether you want to copy their content to an external editor or to the same tab of another instance of the same entity. The copied content is then placed in the clipboard.
- You can select Special paste to paste a content that was copied from an external editor. In this case, you must select the column where the content is to be pasted. You can also select Special paste to paste a content that was copied from another instance with Special copy.
The first column of the table can be used to select contiguous or non-contiguous lines. To select contiguous lines, click this column on the first line to select and press the shift key on your keyboard. Then, select the other lines by clicking the last line to select or by using the arrow keys on your keyboard. To select non-contiguous lines, click a line, and then select the other lines by clicking the first column and pressing the ctrl key on your keyboard.
- Error
- This column displays a dot on all the existing description lines
that are not empty.
Moreover, if this line is not correct, this column also displays an error or warning symbol, depending on the severity of the error. A hover help indicates the source of the error.
- Type
- You can select one of the following values:
- O to specify a generation option line.
- * to insert a comment or an override. It will not be generated. By default, when a line is created, its type is set to this value.
This column displays a value I on all the Input Aid insertions. This value cannot be selected directly.
- Description
- This column must contain the following information:
- If you inserted an O type line, you must enter an option. The options are
not checked for validation.
See Table 1 for the list of options available on a Server Dialog or Server.
After you declared the relevant options, you must declare additional options if you do not specify a Folder in your application. See Table 2 for the single-view development.
See Table 3 for the list of options on an Initialization/Termination Business Component.
To make the input of the options easy in the -GO Lines, you can open a content assist wizard by pressing Ctrl+Space. This wizard displays the list of the possible options according to the entity type and COBOL type. You can also indicate the options directly by entering the option name, the equals sign (=), and the option value. To activate an option, enter OPTION=YES (OPTION is the option name).
- If you inserted a * type line, you must enter the comment.
- If you inserted an Input Aid call line, the variable labels and the symbolic
values that are indicated in the selected Input Aid -D Lines tab are
displayed.Note: The width of the Description column is limited to 60 characters. To see the whole of an Input Aid call that exceeds 60 characters, hover over the column content. The whole call is then displayed in a tooltip.
- If you inserted an O type line, you must enter an option. The options are
not checked for validation.
- Input Aid
- This column contains the name of a called Input Aid. If you click the button that is displayed when you click in this column, you can see the Input Aid description in a detail window. In this window, you can modify the variable labels and symbolic values.
List of generation options on a Server Dialog or a Server
Table 1 lists the general options on a Server Dialog or a Server. Table 2 is specific to a single-view development. Table 3 lists the options on an Initialization and Termination Business Component or its Dialog.
| Values | Meaning |
|---|---|
| ACCESERR | Defines the maximum number of errors on Segment access that can
be returned to the Client. The value is on 3 characters. The default value is 001. |
| BREAKDATE | Breaks down date Data Elements. The date Data Elements is broken down into elementary Data Elements upon generation. In the -GO Lines, you can also inhibit this option by entering BREAKDATE=NO if it was set to YES in the Library. This breakdown is effective in the
following entities:
Notes:
A date is broken down only if the generated COBOL level of the date field is lower than or equal to 47. If a VALUE has been entered, it is generated in the group field. Any additional information (such as a VALUE) must be entered on the same line as the Data Element call on I, E, or S-type lines in the work areas. If a continuation line has been specified, the date is not broken down. The Data Elements that are called in SQL Segments cannot be broken down, except if these SQL Segments are DB2® Segments and if the DESCR=ALL option is entered in the -GO Lines of the DB2 Database Block. Since host variables cannot be group fields, the elementary fields are generated under a redefined group field in the following way: ffnn-date-BRK REDEFINES ffnn-date. |
| CALLSPG | Option possible on a Client Monitor or Server Monitor. Defines the call type used by the Client or Server Monitors to call the associated Clients or Servers. The default value is CALL. If there is no Client Monitor, it is the call type of the Server by the Client. |
| CALLTYPE | Option possible on a Client Monitor, Server Monitor,
Communication Monitor, Business Component, or Folder. Defines the call type of the Server by the Client. For CICS®, the possible values are LINK and CALL. For GCOS8, the possible values are NTPR, LINK, and CALL. For GCOS7, the possible values are NTPR, LINK, and CALL. For IMS™, the possible values are CALL and CHNG. |
| CHANGE | Specific to TUXEDO. CHANGE=NO (default value): The Business Component is called with the TPNOCHANGE parameter. CHANGE=NO (default value): The Business Component is called with the TPCHANGE parameter. You are advised to indicate the same option in the Business Component Dialog and in the Folder Dialog. |
| CHECKSER | Defines the Logical View data check. CHECKSER=NO (default value): The Business Component does not check the Logical View data. CHECKSER=YES: The Business Component checks the Logical View data. For graphic applications, the VECTPRES and CHECKSER options in the Business Components that call the same Logical Views must be identical. |
| CONNECT | Defines the management of the connections to and the disconnections from
relational databases. CONNECT=YES (default value): The connections and disconnections are generated in the Communication Monitor. For TUXEDO, the connections and disconnections are generated in the Initialization and Termination Business Components (SI or ST type). In this case, you must call one of the Table Segments from the database that you want to connect to or disconnect from. CONNECT=NO (value for TUI applications): The connections and disconnections are generated in the Business Component. |
| CURSUFF | Defines the suffix of cursor names. CURSUFF=NO (default value): The cursor names are not suffixed. CURSUFF=YES: The SQL cursor names are suffixed with the corresponding Screen name. |
| DATAERR | Defines the maximum number of errors on the Logical View data
that can be sent to the Client. The value is two-character long. The default value is 01. Note: The value of this option that is indicated in the Initialization and Termination
Business Component must be identical to the value of the option in all the Business Components of
the Folder.
|
| FORMAT | For graphic applications, you must indicate FORMAT=EXTENDED. |
| INITSERV | Calls an Initialization and Termination Business Component
(IT type). A free reference is set when you indicate an Initialization and Termination Business Component. Content assist is available on this field, as shown by the symbol |
| LGCOMM | Defines the length of the communication area between the following components:
This option has a numeric value on 5 characters. It is required if several Business Components are associated with the Dialog. |
| LGCOMZS | Option possible on a Client Monitor or Server Monitor. Defines the length of the communication area between the Client and Server Monitors. Its value must be 5 characters long (default: 32000). |
| LOCATION | To implement a Communication Monitor, this option must be
indicated in the Folder Dialog, or in the Business Component Dialog if no Folder is specified. You must enter the Communication Monitor name (on 6 characters), a dash, and the environment name (on 20 characters maximum): LOCATION=FMCODE-ENVIRNAME A free reference is set when you indicate a Communication Monitor. Content assist is available on this field, as shown by the symbol |
| MONSER | Defines the name of the Server Monitor for the TUI mode. By default, there is no Server Monitor. |
| NULLMNGT | Defines the presence management of the Logical View Data
Elements. NULLMNGT=NO (default value): The presence of the Logical View Data Elements is not managed at the proxy level. NULLMNGT=YES: The
presence of the Logical View Data Elements is managed at the proxy level.
Note: If
NULLMNGT=YES, then VECTPRES=YES is systematically
implemented.
|
| PACTABLE | Defines the name of the Pactables access program to the CICS Server. Default value: PACTABLE |
| SEGMBUFF | This option can be indicated in a Business Component
only. This option is used for the server buffer. It selects Segments of the Data Structure that defines the server buffer. For example, if you enter SEGMBUFF=s1s2s3, then s1, s2, and s3 represent the first 2 characters of the Segments. 10 Segments can be selected by this option. A maximum of 10 SEGMBUFF options can be called in each Business Component. Selecting the 00 Segment is not necessary. It is systematically generated if it is present in the Data Structure. By default, all the Segments of the Data Structure are selected. |
| SERVBUFF | Available only with if a Folder is specified. This option identifies the Data Structure that defines the server buffer. You indicate SERVBUFF=xx, where xx is the Data Structure on 2 characters. Some Segments of this Data Structure can be selected in each Business Component with the SEGMBUFF option (SEGMBUFF=s1s2s3 for example). |
| TRAN | Specific to TUXEDO. TRAN=YES (default value): Use of the transactional mode for the TUXEDO variant. TRAN=NO: No use of the transactional mode. |
| VECTPRES | Defines the management of the presence of the Logical View Data
Elements. VECTPRES=NO (default value): No management of the presence of the Logical View Data Elements. VECTPRES=YES: Management of the presence
of the Logical View Data Elements.
Note: If CHECKSER=YES, the
VECTPRES=YES option is systematically implemented.
Contrary to the NULLMNGT option, this option cannot be used to check the presence of the Data Elements in the proxy. For graphic applications, the VECTPRES and CHECKSER options in the Business Components that call the same Logical Views must be identical. |
| Values | Meaning |
|---|---|
| ERRLAB | Defines the format of the errors that must be
returned. ERRLAB=YES (default): The Communication Monitor retrieves the key, gravity, and error messages that are returned by the Business Component before it sends back the answer to the Client. ERRLAB=NO: Only the error key is returned. In that case, the error message is locally read by the client application. |
| ERRSERV | Defines the name of the Error Message Server. This option is required. |
| LOCATION | To implement a Communication Monitor, this option must be
indicated in the Folder Dialog, or in the Business Component Dialog if no Folder is specified. You must enter the Communication Monitor name (on 6 characters), a dash, and the environment name (on 20 characters maximum): LOCATION=FMCODE-ENVIRNAME A free reference is set when you indicate a Communication Monitor. Content assist is available on this field, as shown by the symbol |
| LOCKMODE | Defines the lock type. The lock process prevents the update of a set of data in order to avoid inconsistency. If the value is NO (default), no lock is specified. The PESSIMIST value creates an exclusive appropriation of the instance, which is locked to all other users while it is updated. The OPTIMIST value locks the instance upon the update request and compares the initial image of the instance with its current image in the database. If they are identical, the update is accepted. |
| PAGEMODE | Defines the paging mode. The NOEXTEND value (default) is specified to page forward and backward through a predefined population. Each paging operation that is requested by the Client component runs a read request and its result replaces the result of the previous read. The EXTEND value is specified to page forward through a predefined population. The result of each paging is added to the previous read result. The reading of the previous pages is then handled by the graphic client. |
| SRVMGR | Option for the generation of a second COBOL source code that corresponds to
the service manager. This purely technical component generates the facilities that are generated by
the Folder when a Folder is specified. By default, the SRVMGR=YES option is implicit in the Business Components and their Dialog if the LOCATION option is present. The service manager is then generated by default. The service manager name comes from the Service manager external name field in the Business Component Definition tab. If this name is not specified, the service manager name is the Business Component name. You indicate SRVMGR=NO in any Business Component that does not require the generation of a service manager. |
| Values | Meaning |
|---|---|
| ACCESERR | Defines the maximum number of errors on Segment access that can
be returned to the Client. The value is on 3 characters. The default value is 001. |
| CALLTYPE | Option possible on a Client Monitor, Server Monitor,
Communication Monitor, Business Component, or Folder. Defines the call type of the Server by the Client. For CICS, the possible values are LINK and CALL. For GCOS8, the possible values are NTPR, LINK, and CALL. For GCOS7, the possible values are NTPR, LINK, and CALL. For IMS, the possible values are CALL and CHNG. |
| CHANGE | Specific to TUXEDO. CHANGE=NO (default value): The Business Component is called with the TPNOCHANGE parameter. CHANGE=NO (default value): The Business Component is called with the TPCHANGE parameter. You are advised to indicate the same option in the Business Component Dialog and in the Folder Dialog. |
| DATAERR | Defines the maximum number of errors on the Logical View data
that can be sent to the Client. The value is two-character long. The default value is 01. Note: The value of this option that is indicated in the Initialization and Termination
Business Component must be identical to the value of the option in all the Business Components of
the Folder.
|
| PROCESS | Available for TANDEM PATHWAY only. Defines the name of the process when the Business Component is called. It is constituted of 15 characters maximum without space and with no lowercase and uppercase conversion. |
| TRAN | Specific to TUXEDO. TRAN=YES (default value): Use of the transactional mode for the TUXEDO variant. TRAN=NO: No use of the transactional mode. |