-GO Lines

You use these lines to enter generation options in a standard or Client Dialog or Screen.

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.

    The options vary according to the Dialog and Screen type and to the COBOL type.

    See List of the generation options for a standard Dialog or Screen or List of the generation options for a Client Dialog or Screen.

    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 for a standard Dialog or Screen

The options that can be entered in the -GO Lines of a standard Dialog or Screen can also be entered in the Complement tab of a standard Dialog.

Table 1. Options on a standard Dialog or Screen.

This table presents the options that can be indicated in the Complement tab of a standard Dialog or in the -GO Lines of a standard Dialog or Screen. If the options are entered in the Dialog, they become the default options of the Screens.

Values Meaning
ATTRE UNISYS 2200: Defines the default attributes at the Screen level.
ATTRIB UNISYS 2200: Keeps the display of the attributes that are dynamically specified (Reverse video and Blink). This option applies to F7020.

CICS®: Recognizes the dynamic modification of the presentation attributes. This option applies to F7020.

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.

CSSA On standard Dialog only: Memorizes all the SSAs that are used upon a generated access to a database. This option is valid for all the Screens of the Dialog.

When this option is specified, all the Screens in the Dialog must be recompiled because the length of the communication area is increased.

DCPROC Generates the DECLARE CURSOR of DB2, NONSTOP SQL, and DATACOM tables in the PROCEDURE DIVISION, FOC function.

If this option is not specified, the DECLARE CURSOR is generated in the WORKING-STORAGE SECTION.

DFHAID IBM® CICS: Initializes the PF key table with the content of DFHAID.
DYNAM Calls Pactables Tables with a dynamic call.
DYNPRT Specifies the recognition of the variable field protection in the DE-AT table (position 5) and the automatic processing of the protection in F7020.

Enter an F in position 5 of the DE-AT table for the Data Element. The Data Element then becomes protected and is received by the program (nature F).

This option is unavailable with the IBM 36, UNISYS A series variant (SDF format).

F10 Processes each category (top, bottom, repetitive) if the category contains at least one variable field or access to a Segment.
FOR Formats the generated COBOL lines. The DATA DIVISION lines are left-aligned, the PROCEDURE DIVISION lines are not aligned and there is one COBOL command per line.
With this option, up to 150 lines are possible in a COBOL paragraph (between two periods).
Warning: This option still exists but is no longer maintained
HEXVAL UNISYS A: Generates fields with an HEXADECIMAL value as PIC XX.
HLPI Generates the file access with the HLPI interface.
HLPVAL Sends the values to be checked (indicated in the -D Lines of a Data Element) to the error messages file. It is true even if this check has been removed from the Screen where the Data Element is called.
HPRT Calls the documentation that is associated with the protected fields (P or F type). It includes the documentation of the Data Element (Data Element -D Lines) and the associated Texts and comments (C or T line after an F line) in the Screen -GE Lines.

In the help program, the screen flow is as follows: first the help on the variable Data Elements, then the help on the protected Data Elements (in the order of the -CE Lines).

IMSME IMS™ Generates the multiscreen variant.
INDEXS DL/1: Generates the Segment access through secondary indexes.

This option is not compatible with the NOP58 option if the target Segment is different from the source Segment and if the source Segment is not generated in the PSB field.

LOGMES CICS multiterminal and MICRO FOCUS: Generates a logical message. This message manages both the screen display and the sending of messages to the communication monitor, which is selected with the MONIT option (if it is not a default value in the COBOL type).

AS/400® and IMS: This option is used for the internet only.

LPAGE or LPA Manages the LOGICAL PAGING in implicit mode (with PA1 function key) or in explicit mode (with a logical paging operator on the Screen -CE Lines).

The LPAGE option is available with a monitor, a submonitor, or with MONITOFF.

With the MONITOFF option, paging applies to the same Screen only.

With a monitor or submonitor, paging applies to several Screens if the Screen codes are entered on the Dialog work areas.
Note: If submonitors are used, all the Screens that constitute a paging group must be in the same submonitor.

The LPAGE and SWAP options are not compatible. If they are both indicated, only the LPAGE option is recognized.

MONIT IBM CICS and UNISYS A Series: Generates with a monitor.
MONITOFF or MOFF IMS: Gets one transaction code per Dialog Screen and does not generate a monitor.

MONITOFF and NOTRAC are incompatible. If they are both entered, only the MONITOFF option is recognized.

NOATTR IMS: Generates the protected fields in the MOD without their attributes (ATTR=YES). This option is valid for all the Screens of a Dialog.
NOLOCK AS/400: Reads the Segments without update. It adds the WITH NO LOCK clause to the read function when the file is open in OPEN I-O.

This option does not work if several Segments of a same file are accessed, some with update, some without, because READ WITH NO LOCK removes the preceding lock.

NOOCF Does not set value 1 to the OCF variable upon the first program input (no F0160 function).
NOOPEN MICRO FOCUS and DEC: Optimizes the opening of the HE file (help file backup), the LE, OU, EM (error messages) files, and the CONNECT to ORACLE.
NOPSB Limits the Segment generation.

In each Screen, only the Segments in use and their hierarchical parents are generated. In the monitor and submonitors, the PSB field is no longer generated and is not sent to the Screens.

NORPT Does not automatically process the repeated Data Elements.
NOSAV DEC/VAX, GCOS7, MICRO FOCUS, ICL, and IBM 38: Avoids generating the description of, and the physical access to the HE help file.
NOSDERR UNISYS 2200: Recognizes the ERMSG Data Element in the message, which therefore is not sent by the SEND ERROR clause.
NOTRAC IMS: Does not generate the transaction code in the MID of the first Screen of the Dialog.
OCF Sets value 1 to the OCF variable upon the first program input (current default value).
OFF Generates the programs and maps of the Dialog with the MDT-OFF option (default value for GCOS7 FORMS).
ON Generates the programs and maps of the Dialog with the MDT-ON option (default value, except for GCOS7 FORMS).
PACSQL Recognizes the data that is entered in the Segment -GG Lines for the SQL statements.
PSBINIT CICS-DL/1 Screen with monitor option: Used for the connection to the PSB and its termination (SCHEDULE PSB and TERMINATE) on the submonitor and not on each Screen.
REFER or REF Generates the list of all the Data Elements that are referenced in the Dialog program. This list is formatted as comments in the WORKING-STORAGE SECTION. It includes the following Data Elements:
  • Data Elements from the Segments that are called in the -CS Lines,
  • Data Elements from the Segments that are called in the work areas, on F-type lines,
  • Data Elements that are directly called in the work areas on I-, E-, or S- type lines,
  • Data Elements that are directly called in the -CE Lines.
REPET or RPT Validates, transfers, and sets the attributes for the variable fields that are repeated horizontally or vertically.

When a repeated field is used in a Segment access, you must indicate the number of repeated uses in the Screen -CS Lines.

SQLALL or SQA SQL: Lists all the table columns in the Segment access commands:
(SELECT ALL COLDELCOn, ...  
        INTO   :FFNN-DELCOn)
SQLCA or SQC SQL: Generates the INCLUDE SQLCA statement in the WORKING-STORAGE SECTION if one or more DB2 or NONSTOP SQL Segments are called in the Screen (-CS Lines tab, Organization = S, Q, or N).
SQLIND or SQI Generates the presence indicators for the Data Element before it is updated or displayed.
SQLREF or SQR Generates the indicators for the new V-FFnn-DELCO structure. Cross-references are then automatically managed.
SSMON Recognizes the PSB of the submonitor that each Screen belongs to. One PSB is then generated for each submonitor instead of one PSB for all the Screens in the Dialog (see the -GG Lines).
SWAP IMS: Option to be used with a monitor or submonitor.

The Screen to branch to through a function key is indicated in the MFS map. In each map, a 10-character FUNC field is generated and includes the PF key value and the external name of the next Screen to branch to.

For End-Of-Conversation, the external name of the Screen must not be entered.

When a deferred branching is used, or when OPER is set with the PF key, the external name is the name that corresponds to the generated map.

The FUNC field is processed in the monitor or submonitor.

The SWAP option improves performance as it avoids loading the program which processes the branching.

Note: If the MONITOFF or LPAGE option is specified, the SWAP option is not recognized.
TMF TANDEM: Recognizes the transactional mode by generating BEGIN-TRANSACTION and END-TRANSACTION in the requesters and BEGIN-WORK and COMMIT-WORK orders in the Pacweb communication monitor.
TS CICS: Manages the communication area outside the LINKAGE SECTION. This area is described in the WORKING-STORAGE SECTION and saved in TEMPORARY STORAGE by default. In addition, with MDTOFF and a call to the help function, the Screen is saved in only one area.
TZVAR BULL: Uses the reception and display areas in case of an error.
ZNUM GCOS7 (except GCOS7 FORMS) and GCOS8: Conditions the transfer of the numeric fields to the message (F8145) by the fact that no error was encountered (SCR-ER = 0).

List of the generation options for a Client Dialog or Screen

These options are effective if they are entered in the -GO Lines. Other options can be entered in the Complement tab of the Client Dialog.

Table 2. Options on a Client Dialog or Screen.

This table presents the options that can be indicated on Client Dialogs and Screens. If the options are entered at the Dialog level, they become the default options of the Screens.

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

FORMAT Defines the format of the Logical View Data Elements.

With the INTERNAL value, the Data Elements that are called in the Logical View are generated with their internal format and their usage is recognized.

With the EXTENDED option, the format of the Data Elements is computed. Their usage is ignored and replaced by the DISPLAY usage. For signed numeric Data Elements, it is replaced by the SIGN IS LEADING usage.

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.

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

LTHENATT Defines the length of the backup area of the DE-ATT table (default: 2000).
LTHREPET Defines the length of the backup area of the repetitive category (default: 1000).
LTHSCREEN Defines the length of the backup area of the screen message (default: 6000).
NOMAP Generates or does not generate the map, according to the value of the option in the Dialog and the Screen.

The generation of the map also depends on the Generation with map check box in the Screen Definition.

The value NOMAP is equivalent to NOMAP=YES. It inhibits the generation of the map.

The value NOMAP=NO generates the map.

The value of the option in the Dialog is automatically taken into account in the Screen. To keep this value in all the Screens of the Dialog, there is no need to enter this option in all the Screens.

However, to modify the value of the option that is indicated in the Dialog in some Screens, you must indicate it. The two following cases are possible:
  • If the Dialog contains the value NOMAP or NOMAP=YES and if the Screen contains the value NOMAP=NO, the Screen map is generated.
  • If the Dialog contains the value NOMAP=NO and if the Screen contains the value NOMAP or NOMAP=YES, the Screen map is not generated.

Feedback