Rational Developer for System z, Version 7.6

-GO Lines section

You use this section to enter the generation options of the Dialog, which can also be entered in the Options field of the Dialog Complement tab, plus the BREAKDATE option, which cannot be specified in the Dialog Complement.

To indicate an option, you must enter O in the Type column, and the option in the Description column.

Enter the option's name, followed by the = sign, and the option's value.

To activate an option, enter OPTION=YES (OPTION is the option code).

-GO Lines

The following table lists all the options which can be entered in the -GO Lines or in the Complement tab. (See further down for the BREAKDATE option)

Values Meaning
ATTRE UNISYS 2200: Definition of the default attributes at the Screen level.
ATTRIB UNISYS 2200: The display of the attributes dynamically specified (Reverse video and Blink) is kept. This option applies to F7020.

CICS: The dynamic modification of the presentation attributes is taken into account. This option applies to F7020.

CSSA Memorizes all the SSA's during a generated access to a Database. This option is valid for all the Screens of a Dialog.

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

CVISION GCOS6: This option allows to download the standard validations (presence validation, numeric validation, formatting of the initialization character) onto the CVISION screen manager, thus improving performances.
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: its content initializes the PFKEYS Table.
DYNAM Pactables table DYNAM-called.
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 given Data Element. The Data Element then becomes protected and is received by the program (nature F).

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

F10 Processes any category (top, bottom, repetitive), provided that it contains at least one variable field or access to a Segment.
FOR Formatting of the generated COBOL: left-justified DATA DIVISION, no justification for the PROCEDURE DIVISION but one COBOL command per line.

This option may be entered on the Library Definition tab. In this case, the Dialog is generated in formatted COBOL even if the FOR option is not explicitly entered in this field.

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 in PIC XX.
HLPI Generates the file access with the HLPI interface.
HLPVAL The values to be checked (indicated in the -D Lines of a Data Element) are sent to the error messages file even though this check has been removed from the Screen in which the Data Element is called.
HPRT Calls the documentation associated with the protected fields (P or F type). This includes the documentation associated with the Data Element as well as the associated Texts and comments in the Screen's -GC Lines section

In the Help program, the screen flow will be: first the help on the variable Data Elements, then the help on the protected Data Elements (in the order of the -CE Lines tab).

IMSME Generates the 'Multi-Screens' variant for IMS.
INDEXS DL/1: Generates the Segment Accesses via secondary indexes.

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

LOGMES With the CICS multi-terminal and Microfocus variants, this option generates a logical message which manages both the screen display and the sending of messages to the communications monitor selected with the MONIT option (if it is not a default value in the variant).

AS400 and IMS: This option is used only for the Web.

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

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

With the MONITOFF option, paging can only be performed on the same Screen.

With a (sub-)monitor, paging is possible on several Screens by entering the Screen codes on the Dialog -W Lines tab.
Note: If sub-monitors are used, all the Screens that make up a paging group must be in the same sub-monitor.

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

MONIT UNISYS A Series: generation with a monitor.

IBM CICS: generation with a monitor.

MONITOFF or MOFF IMS: One transaction code per Dialog Screen and no monitor generation.

MONITOFF and NOTRAC are incompatible. If both are 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 with all the Screens of a Dialog.
NOLOCK AS400: Reads the Segments without update and with the addition of the WITH NO LOCK clause in 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, since READ WITH NO LOCK removes the preceding lock.

NOOPEN MICROFOCUS and DEC: Optimizes the opening of the HE file (Help file backup), the LE, OU, EM files (error messages) and the CONNECT to ORACLE.
NOOPENB HP3000, TurboImage: Stops the opening of the TurboImage database. The OPEN is not generated in the program.
NOPSB Segment generation limitation:

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

NOSAV With DEC/VAX, GCOS7, MICROFOCUS, ICL, IBM 36 and 38, and BOS/TP: 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: The transaction code is not generated in the MID of the first Screen of the Dialog.
OCF The OCF variable is set to value '1' upon the first program run (Current default value).
OFF The Dialog's programs and maps are generated with option MDT-OFF (default value for Gcos7 FORMS).
ON Default value (except for Gcos7 FORMS). The Dialog's programs and maps are generated with the MDT-ON option.
PACSQL Takes into account the data entered in the Segment -GG Lines for the SQL statements.
PSBINIT CICS-DL1 Screen with monitor option: Allows to perform the connection to the PSB and its termination (SCHEDULE PSB and TERMINATE) on the sub-monitor and not on each Screen.
REFER or REF Generates the list of all the Data Elements used in a Dialog. This list is found in the WORKING-STORAGE SECTION and has a documentary value. It includes the:
  • Data Elements from the Segments called in the -CS Lines,
  • Data Elements from the Segments called in the -W Lines, on F-type lines,
  • Data Elements directly called in the -W Lines on I-, E-, or S- type lines,
  • Data Elements directly called in the -CE Lines.
REPET or RPT Validation, transfer and positioning of the attributes for the variable fields which are repeated horizontally and/or vertically.

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

SQLALL or SQA SQL: All the table columns are listed in the Segment access commands:
(SELECT ALL COLDELCOn, ...  
        INTO   :FFNN-DELCOn)
SQLCA or SQC SQL: The INCLUDE SQLCA is generated in the WORKING-STORAGE if one or more DB2 or Non-Stop SQL Segment is called in the Screen: (-CE Lines tab, Organization = S, Q or N).
SQLIND or SQI Presence indicators are generated for the Data Element before it is updated or displayed.
SQLREF or SQR The indicators are generated for the new V-FFnn-DELCO structure, allowing the automatic management of the cross-references.
SSMON This option allows the coding of one PSB for each sub-monitor instead of one PSB for all the Screens in the Dialog. (Refer to the -GG Lines section of the -G Lines tab).
SWAP IMS: Option to be used with a (sub-)monitor.

This option allows to indicate, in the MFS map, the code of the Screen to branch to via a Function Key. In each map, a 10-character FUNC field is generated and includes the PFKEY value and the external name of the next Screen to branch to.

For End-Of-Conversation, the external name of the Screen must be left blank.

When using deferred branching, or setting OPER with the PFKEY, the external name is that of the generated map.

The FUNC field is processed in the (sub-)monitor.

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

Note: If the MONITOFF or LPAGE option is selected, the SWAP option is not taken into account.
TMF TANDEM: With this option, the transactional mode is recognized by the generation of BEGIN-TRANSACTION and END-TRANSACTION in the requesters and of BEGIN-WORK and COMMIT-WORK orders in the PacWeb Communications Monitor.
TS CICS: The Communication Area is managed outside the LINKAGE SECTION. This area is described in WORKING and saved in TEMPORARY STORAGE by default. In addition, if MDTOFF and call of the HELP function, the Screen is saved in only one area.
TZVAR BULL: With this option, the reception and display areas are used in case of error.
ZNUM The transfer of the numeric fields to the message (F8145) is conditioned by the fact that no error was encountered (SCR-ER = 0).

To specify here the breakdown of the generated dates into elementary fields, you must enter BREAKDATE=YES. You can also inhibit it by entering BREAKDATE=NO if it has been set to YES at the Library level.

This breakdown will be effective:
  • For Programs: on the elementary Data Elements of the Segments called in the Call of Data Structures (-CD Lines tab) and in the Work Areas (-W Lines tab).
  • For Dialogs/Screens: on the elementary Data Elements of the Segments called in the Dialog Complement (Complement tab), in the Screen Calls of Segments (-CS Lines tab) and in the Work Areas (-W Lines tab).
  • on Data Elements called in the Work Areas (-W Lines tab).

    If you indicate the BREAKDATE=YES option, the Data Elements defined with a date format will be generated as elementary fields which correspond to the year, month and day and a separator (if it 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 will be broken down only if the generated COBOL level of the date field is lower than or equal to 47.

The Data Elements called in SQL Segments cannot be broken down, except if these SQL Segments are DB2 Segments and if the DESCR=ALL option has been entered on the generation options (-GO Lines section of the -G Lines tab) of the DB2 Block.

Since host variables cannot be group fields, the elementary fields will be generated under a redefined group field in the following way:
ffnn-date-BRK REDEFINES ffnn-date
.

If a VALUE has been entered, it will be 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 (-W Lines tab). If a continuation line has been specified, the date will not be broken down.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)