-GO Lines of a Server Dialog or Server

You use these lines to enter generation options in a Server Dialog or a Server.

You can add a line in the table in two ways:
  • 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.
You can create, reorder, or remove lines with the table buttons (whose position can be modified with the design editors preferences) or with the contextual menu that you open by right-clicking the table. You can also use the contextual menu to Copy and Paste lines. The Special copy and Special paste choices are also available in the Data Element -D Lines, Report -L Lines, and -G Lines of all the entities.
  • 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.

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

Table 1. Options on a Server Dialog or a Server.

This table presents the options that can be indicated on a Server Dialog or a Server. If the options are entered in the Server Dialog, they become the default options of the Servers of the Dialog. However, some options must be indicated in Servers only and some options must be specified in certain types of Servers.

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:
  • In Programs, on the elementary Data Elements of the Segments that are called in the -CD Lines and in the work areas.
  • In Dialogs and Screens, on the elementary Data Elements of the Segments that are called in the Dialog Complement tab, in the -CS Lines tab, and in the work areas.
  • On the Data Elements that are called in the work areas.

    If you activate the BREAKDATE option, the Data Elements that are defined with a date format are generated as elementary fields that correspond to the year, month, and day. It also contains a separator if a separator is included in the date format

    Example of a date defined with an M-type format (MM/DD/YYYY):

    10 ffnn-date.
     11 ffnn-date-MMX.
      12 ffnn-date-MM PICTURE 99.
     11 ffnn-date-S1  PICTURE X.
     11 ffnn-date-DDX.
      12 ffnn-date-DD PICTURE 99.
     11 ffnn-date-S2  PICTURE X.
     11 ffnn-date-YYX.
      12 ffnn-date-YY PICTURE 9(4).
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 content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

LGCOMM Defines the length of the communication area between the following components:
  • Communication Monitor (graphic application) and Business Component,
  • Folder and Business Component,
  • TUI Client or Client Monitor and the Business Component.

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 content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

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.

Table 2. Additional options for a single-view development.

This table presents the additional options when an application handles only one Logical View and therefore does not include the specification of a Folder. A service manager must be generated (in version 9.6 and higher) for each Business Component that is not integrated into a Folder. This purely technical component manages the facilities that are handled by the Folder when a Folder is specified. To generate it, the LOCATION=FMCODE-ENVIRNAME option must be indicated in the Business Component or in its Dialog. The presence of LOCATION triggers the default recognition of the implicit SRVMGR=YES option.

The options that are entered in the Business Component Dialog become the default options of the Business Components that belong to the Dialog.

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 content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

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.

Table 3. Options on an Initialization and Termination Business Component.

This table presents the options that can be indicated on a Server with an Initialization and Termination Business Component type, or on its Dialog. If the options are entered in the Dialog, they become the default options of the Initialization and Termination Business Components.

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.


Feedback