Rational Developer for System z, Version 7.6

-GG Lines section

You use this section in relation to a given Screen or Dialog in order to override some of the values of the generated constants.

To specify an overriding line, you must enter G in the Type column.

You must enter two elements in the Description field of each line:
  • A left-justified two-character code, according to the environment in use. Refer to the Code list below
  • The new value, from the 21th position of the field.

Code List

  • 01: IMS

    Modification of the value of the TYPE parameter (Terminal type) in the DEV macro-instruction of the MFS format description. (Default value: TYPE=(3270,2)).

    MULTI-TERMINAL DIALOGS: The same screen description can be generated for different terminal types:
      Type  Description                     
      G     01 n                3270-A1 
      G     01 n                3270-A2 
    with n = 0-9
  • 02: IMS

    Modification of the value of the FILL parameter in the MFLD macro-instruction of the MOD. (Default value: FILL=PT).

  • 03: ALL ENVIRONMENTS
    Modification of the external name of the HELP function display program. (Default value: PACHELP).
    Note: This external name can be entered on the HELP Screen Definition. Therefore, this option should no longer be used.
  • 04: ALL ENVIRONMENTS

    Modification of the external name of the program which manages the accesses to the Pactables function. (Default value: PACTABLE).

  • 05: GCOS7, GCOS7 FORMS

    Modification of the name of the Screen backup file when the HELP function is called: (Default value: HE)

    DEC/VAX, ICL, IBM 36, IBM 38/AS 400, MICROFOCUS, DM6 TP and BOS/TP:

    Modification of the name of the Screen backup file for HELP function calls. The new value must be coded as: XX EXTERN, where: XX is the name of the file and EXTERN is the external name of this file; two blank characters must be inserted between these two names. (Default value: HE SAVESCR).

  • 06: CICS

    Modification of the first four characters of the name of the TS used by the HELP function. (Default value: PAC7).

  • 07: GCOS7

    Value used to replace blanks in output messages. (Default value: 19).

  • 08: GCOS7 FORMS

    Modification of the NORMAL value of the intensity attribute. (Default value: SPACE).

  • 09: GCOS7 FORMS

    Modification of the BRIGHT value of the intensity attribute. (Default value: BD).

  • 10: GCOS7 FORMS

    Modification of the DARK value of the intensity attribute. (Default value: CN).

  • 11: CICS DL/1: HLPI

    Database Lock shift (Y/N) when access with update. (Default value: LOCKED).

  • 12: DEC/VAX, IBM CICS, DPS7 and DPS8 with the MULTI-SCREEN type transaction variant, ICL, MICROFOCUS, BOS/TP:

    Modification of the name of the subprogram called for message reception and formatting. (Default value: ZAR980; For MICROFOCUS: ZAR980.EXE in DOS, ZAR980.DLL in OS/2, UNIX).

    For IBM CICS, ZAR980 corresponds to user program PRUSER To replace the standard PRCGI, see parameter number 22.

    For Dialog Web Revamping, use the ZAR990 program which is the same as ZAR980 but with a web specificity.

  • 13: GCOS8

    Modification of the number of characters sent in each 'DISPLAY' for the message display. (Default value: 2000).

  • 14: DEC/VAX

    Modification of the number of characters sent in each message DISPLAY(when there are too many characters, another DISPLAYis executed). (Default value: 1000).

  • 15: IBM 36, IBM 38/AS 400

    DISPLAY FILE external name. (Default value: SCRFILE).

  • 16: CICS

    Option to write the TEMPORARY STORAGE in AUXILIARY STORAGE ('AUXILIARY') instead of MAIN STORAGE. (Default value: MAIN)

  • 17: ALL ENVIRONMENTS

    Character string (11 characters maximum) for the HELP Screen title. (Default value: SPACE).

  • 18: ICL

    Name of the file used by the monitor in order to save the communication area.

    For a Web connection, all environments except IMS: Name of the contextual backup file. The new value must be coded as in parameter 05.
    Example: WE SAVEWEB, where WE corresponds to the name of the file in the program and, after two blank characters, SAVEWEB corresponds to the external name of the file
  • 19: IMS

    At the Dialog or sub-monitor level, for Screens using DB2 segments:

    For each DBRM: external name of the Screen (8 characters).

    The lines which include this parameter are grouped as comments at the beginning of the WORKING-STORAGE SECTION of the generated (sub-)monitor.

  • 20: IMS
    External name of the module which replaces the standard module (external name: CALL) in monitors and sub-monitors.
    Note: With COBOL II, if this parameter is not entered, a dynamic COBOL CALL is generated.
  • 21: IBM CICS, IBM 38/AS 400, UNISYS 2200, TANDEM, GCOS7 FORMS

    This parameter takes the values ARRAYor TABLE if a field is repeated horizontally AND vertically on the Screen. The logical message will be initialized from the physical message, so that they will match.

  • 22: IBM CICS

    For the multi-terminal type variant, name of the subprogram which replaces the standard PRCGI subprogram (external name D4R980) that formats a '3270' type message.

  • 26: UNISYS 2200

    It enables you to replace the default intensity attribute NORMAL with LOW, since some screens do not make any difference between the NORMAL and HIGH intensity values.

    The LOW attribute will therefore be present in the generated MAP (FORM NAME) of the considered Screen, along with the other default label attributes, specified in the Dialog or Screen Definition.

    This parameter requires that the ATTRE option be used in the Dialog Complement tab. With this option, the definition of the default attributes is generated for each Screen.

  • 27: IBM 38/AS 400
    Indicator number if error on the first line of a repetitive category. On the next lines, the indicator is incremented by 1.
    Example: The indicator is set to 34; each Data Element of the first line of the repetitive category will be assigned indicator 34, those on the second line, indicator 35.
  • 28 IBM 38/AS 400
    Recognition of lowercase characters in the DDS of the Screen format in the CHGINPDFT (LC) clause.
    Note: The LC value must be typed in uppercase characters.
  • 29: TANDEM Requester

    Generation of the ESCAPE ON clause on the screen's ACCEPT. (Default value = SPACE). The information specified for this parameter (up to 40 characters) will be added after the ESCAPE ON clause.

  • 30: TANDEM Requester

    Assignment of a function key for end of input when a PFKey is not used as the operation code.

  • 31 CICS

    BMS MAP: Modification of the parameters of the CTRL option contained in the definition of the MAP SET (DFHMSD).

    By default, the generation is: CTRL=(FREEKB,FRSET).

    The modified parameters are parenthesized instead of FREEKB,FRSET.

  • 32: UNISYS-A

    Insertion of working descriptions between the I-O-MESSAGE area and the other areas of the linkage section.

    To do so, you must indicate the location of the Dialog linkage description. This description is generated by default from line 00001 onwards. The first two digits of this line number can now be parameterized.

  • 33: BULL

    Parameterization of the loading of the backup file's key for the help function.

    By default, the key is loaded from the terminal code defined in the TRANSACTION-STORAGE. To parameterize the key loading, the parameter 33 is associated with the Data Division area in which the key is initialized (for example USER-ID defined in the TDS-STORAGE).

    You must therefore code:
             33               USER-ID   

    The name of this field is limited to 14 characters. The default value of this parameter is XTERM and the key loading is performed from the K-Sscre-XTERM field.

  • 34: WEB CONNECTION, MICROFOCUS, TANDEM, AS400 and UNISYS, format nnnn (0100 by default)

    Parameter which indicates the size of the backup file of the Dialog's common area.

  • 35: ALL ENVIRONMENTS FOR A WEB CONNECTION

    Length of the logical message (5 characters). The default value of this parameter is 14000. It does not include the length of the constant part of the message.

  • 36: COMMUNICATION TYPE
    • Communication for CICS:
      • ECI: the generated Communication Monitor (default value)
      • CPIC: CPIC LU 6.2 communication.
      • SOCKET: TCP-IP
      • MQSERIES
    • Communication for IMS
      • CPIC: default value
      • MQSERIES
    • Communication for GCOS7 and GCOS8
      • XCP2: default value
      • TCPTDS (for WEB Gcos7) : TCP/IP Access TDS
    • Communication for MICROFOCUS, TANDEM and UNISYS
      • SOCKET: TCP-IP, default value
  • 37: LENGTH OF THE COMMUNICATION BUFFER with an nnnnn FORMAT
    • CICS and IMS MQSERIES: 14200 as the default value for MQSERIES
    • CICS SOCKET: 02048 as the default value
    • GCOS7 XCP2 and GCOS8 XCP2: 4092 as the default value
    • TANDEM SOCKET: 14200 as the default value
    • WEB GCOS7 TCPTDS : 14200 as the default value
  • 38: TIMEOUT
    Maximum waiti time for a client communication (format: nnnn) in seconds.
    • CICS
      • SOCKET:1800 as the default value
    • CICS, IMS
      • MQSERIES: unlimited as the default value.
  • 39: UNISYS

    Name of the Dialog's context backup file.

    Format: 40 characters long

  • 40: TANDEM/PATHWAY

    Name of the Tandem process

    Format: 20 characters long

IMS: GENERATION OF A PSB PER SUB-MONITOR

In order to implement this option, you must specify SSMON in the Options field of the Dialog Complement tab.

In order to generate a PSB per sub-monitor (as opposed to a general PSB for the whole Dialog), you must specify on a 'G'-type line, in the -GG Lines section of each sub-monitor with:
  • PSB= left-justified in the Description field,
  • PSB code, from position 21 of the Description field.
This line must be the first line in the -GG Lines section.
Note: Each Screen must belong to only ONE sub-monitor.

Terms of use | Feedback

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