-GO Lines
You use these lines to enter generation options in a standard or Client Dialog or Screen.
- 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.
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.
- 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 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.
| 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:
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:
|
| 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:
|
| 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.
| 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:
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 |
| 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:
|