-GO Lines of a Folder Dialog or Folder

You use these lines to enter generation options on a Folder Dialog or Folder. You are advised to indicate the options on the Dialog so that they automatically apply to all the Folders that are attached to this Dialog. However, the options INITSERV and PROCESS must be entered at the Folder level.

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

    See List of the generation options in a Folder Dialog or a Folder.

    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 the generation options in a Folder Dialog or a Folder

Table 1. Options on a Folder Dialog or Folder.

This table presents the options that can be indicated on a Folder Dialog or a Folder. If the options are entered in the Folder Dialog, they become the default options of the Folders.

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

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.

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.

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.

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