-GO Lines of a Communication Monitor Dialog or Communication Monitor

You use these lines to enter generation options in a Communication Monitor or its Dialog. If you enter them in the Dialog, they apply by default to all the Communication Monitors that are attached to this Dialog. You must indicate the following three options in the Communication Monitor: WORKFILB, WORKFILS, and WORKFILO. If they are not present in the Communication Monitor Dialog, they must be indicated in each Communication Monitor. If the parent Dialog is a Server Dialog, you must then indicate them in the Communication Monitor. If these options are missing, the Communication Monitor contains an error. To integrate the Communication Monitor into an application, you must enter the option LOCATION in the -GO Lines of the Folder Dialog, or of the Business Component Dialog if no Folder is specified.

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.

    See List of the generation options in a Communication Monitor Dialog or Communication Monitor.

    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 Communication Monitor Dialog or Communication Monitor

Table 1. Options on a Communication Monitor Dialog or Communication Monitor.

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

Values Meaning
BASE Defines the code of the relational database.

This option is required if a relational table is a component of the Folder, even if it is only the work file.

The value BASE=THREAD is reserved for UNISYS 2200 to indicate an SFS organization.

BASELOC Defines the location of the relational database.

This option is required if the relational database code is specified.

The possible values are LOCAL (default) and REMOTE.

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.

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.

SERVBUFF Specifies the Data Structure that defines the server buffer.

You enter SERVBUFF=xx, where xx is the Data Structure on 2 characters.

Note: The same option must be entered in the Business Component Dialog of the Folder.
WAITINT Option specific to MQ Series. and TCP/IP Socket on MVS™/CICS.

Defines the waiting time, in seconds, between two queries.

Default value for WebSphere® MQ = 0001.

Default value for TCP/IP Socket on MVS/CICS = 1800.

WORKFILB This option is mandatory.

Database Block for a work file with an H organization or external name for a work file with a V organization.

For IBM® CICS - VSAM, enter the DDNAME on 1 to 8 positions.

For GCOS8, the input depends on the blocking type:
  • For a blocking by characters, enter the external name on 4 characters (generated in the SELECT clause) and blocking on the last four characters (generated in the FD clause).
  • For a blocking by record, enter the external name on 5 characters and blocking on the last three characters.
The two parts of the external name, each on 2 characters, are separated by a dash.

For the other variants, enter the logical name, generated in the SELECT clause.

WORKFILS This option is mandatory.

Defines the Segment that is associated with the work file.

WORKFILO This option is mandatory.
Defines the organization of the work file that is used by the Communication Monitor:
  • V for an indexed sequential organization
  • H for a relational organization
  • W for a Working organization

Feedback