Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

7.104.1 REQUEST Parameters

ACROSS_SEP

ADD_KEY

BROWSELIST

CHANGE_KEY

...

SHOW_NEXT

STD_HEAD

TEXT

USER_KEYS


Anchor
FIELDS
FIELDS
FIELDS

Specifies either the field(s) that are to be input at the workstation or the name of a group that specifies the field(s) to be input. An expandable group expression is allowed in this parameter.

Portability Considerations

Visual LANSA has multi-page and field spanning line restrictions:

Multi-page data (i.e. if the screen format is larger than one page) can be displayed in a Web browser window but NOT in a LANSA function.
If a process containing multi-page data is compiled, a warning will be issued if the process is WEB/XML enabled. If the process is NOT WEB/XML enabled, a full function check error will be issued.

Field spanning (i.e. when the field is larger than one line on the screen) is not supported - only a single line will be displayed. No error or warning is issued.

Anchor
DESIGN
DESIGN
DESIGN

Specifies the design/positioning method which should be used for fields that do not have specific positioning attributes associated with them.

...

*ACROSS indicates that fields should be designed "across" the screen in a row.

Anchor
IDENTIFY
IDENTIFY
IDENTIFY

Specifies the default identification method to be used for fields that do not have a specific identification attribute associated with them.

...

*NOID indicates that no identification of the field is required. Only the field itself should be included into the screen design.

Anchor
IDENT_ATR
IDENT_ATR
IDENT_ATR

Specifies display attributes that are to be associated with identification text (labels, description, column headings, etc) that are displayed on the screen.

...

This parameter is ignored in SAA/CUA processes in SAA/CUA compliant partitions. In such partitions the attributes are determined from the partition wide standards for labels and column headings.

Anchor
DOWN_SEP
DOWN_SEP
DOWN_SEP

Specifies the spacing between rows on the display that should be used when automatically designing a screen. The value specified must be *DESIGN or a number in the range 1 to 10. Refer to the table in the comments section for details of what value *DESIGN is actually specifying.

Anchor
ACROSS_SEP
ACROSS_SEP
ACROSS_SEP

Specifies the spacing between columns on the display that should be used when automatically designing a screen. The value specified must be *DESIGN or a number in the range 1 to 10. Refer to the table in the comments section for details of what value *DESIGN is actually specifying.

Anchor
BROWSELIST
BROWSELIST
BROWSELIST

Specifies the name of a browse list which is also to be included into the screen format, and optionally, the number of entries of the browse list that should appear in the screen panel.

...

If a browse list is specified it must be defined elsewhere in the RDML program with a DEF_LIST (define list) command.

Anchor
EXIT_KEY
EXIT_KEY
EXIT_KEY

Specifies the following things about the EXIT function key:

...

Note

Note: In SAA/CUA applications it is recommended that only the following 2 variations of the EXIT_KEY parameter are used:

            EXIT_KEY(*YES *EXIT *HIGH)  in a "main program"
           EXIT_KEY(*YES *RETURN *LOW)  in "subroutines"

Anchor
MENU_KEY
MENU_KEY
MENU_KEY

Specifies whether the MENU function key is to be enabled when this screen format is displayed at the workstation. In addition it also specifies what is to happen if the MENU key is used.

...

If a condition name is specified it must be defined within the RDML program by a DEF_COND (define condition) command.

Anchor
ADD_KEY
ADD_KEY
ADD_KEY

Specifies whether the ADD function key is to be enabled when this screen format is displayed at the workstation. In addition it also specifies what is to happen if the ADD key is used.

...

If a condition name is specified it must be defined within the RDML program by a DEF_COND (define condition) command.

Anchor
CHANGE_KEY
CHANGE_KEY
CHANGE_KEY

Specifies whether the CHANGE function key is to be enabled when this screen format is displayed at the workstation. In addition it also specifies what is to happen if the CHANGE key is used.

...

If a condition name is specified it must be defined within the RDML program by a DEF_COND (define condition) command.

Anchor
DELETE_KEY
DELETE_KEY
DELETE_KEY

Specifies whether the DELETE function key is to be enabled when this screen format is displayed at the workstation. In addition it also specifies what is to happen if the DELETE key is used.

...

If a condition name is specified it must be defined within the RDML program by a DEF_COND (define condition) command.

Anchor
PROMPT_KEY
PROMPT_KEY
PROMPT_KEY

Specifies whether the PROMPT function key is to be enabled when this screen format is displayed at the workstation. In addition it also specifies what is to happen if the PROMPT key is used.

...

If a condition name is specified it must be defined within the RDML program by a DEF_COND (define condition) command.

Anchor
USER_KEYS
USER_KEYS

USER_KEYS

Specifies up to 5 additional user function keys that can be enabled when the screen format is displayed at the workstation.

...

Note that the IF_KEY command refers to the keys by symbolic names that indicate the order they are declared in the USER_KEYS parameter, not the actual function key numbers assigned to them. This makes changing function key assignments easier.

Anchor
PANEL_ID
PANEL_ID
PANEL_ID

Specifies the identifier that is to be assigned to the panel or pop-up window created by this command.

...

This parameter is ignored if the current partition definition indicates that panel identifiers are never required, no matter what value is specified.

Anchor
PANEL_TITL
PANEL_TITL
PANEL_TITL

Specifies the title that is to be assigned to the window panel.

...

This parameter is valid for SAA/CUA applications only.

Anchor
SHOW_NEXT
SHOW_NEXT
SHOW_NEXT

Specifies whether the "next function" field should be shown on line 22 of the screen. The next function field is facility that allows transfer between the functions in a process without the need to return to the process menu each time. Refer to The Process Control Table in the LANSA for i User Guide for more details about "next function" processing.

...

Portability Considerations

This feature is not known to Visual LANSA and will be ignored, with no known effect to the application, if used in Visual LANSA code.

Anchor
TEXT
TEXT
TEXT

Allows the specification of up to 50 "text strings" that are to appear on the screen panel or report. Each text string specified is restricted to a maximum length of 20 characters.

...

  • Never specify *TMAPnnn identifiers of your own or change *TMAPnnn identifiers to other values. Leave the assignment and management of *TMAPnnn identifiers to the screen and report design facilities.

  • When copying a command that has an *TMAPnnn identifier, remove the *TMAPnnn references (ie: the whole TEXT parameter) from the copied command. If you fail to do this, then the full function checker will detect the duplicated use of *TMAPnnn identifiers, and issue a fatal error message before any loss occurs.

  • Never remove an *TMAPnnn identifier from a command. If this is done then the associated text map may be deleted, or reused in another command, during a full function check or compilation. Loss of text details is likely to result.

  • Never "comment out" a command that contains a valid *TMAPnnn identifier. This is just another variation of the preceding warning and it runs the same risks of loss or reuse of text.

  • Never specify *TMAPnnn values in an Application Template. In the template context *TMAPnnn values have no meaning. Use the "text string" format in commands used in, and initially generated by, Application Templates.

Anchor
CURSOR_LOC
CURSOR_LOC
CURSOR_LOC

Specifies any user controlled cursor positioning that is required. The CURSOR_LOC parameter must always contain 2 values, which may take any of the following forms:

...

When the REQUEST command is executed #ROW and #COL are both zero, which is an invalid cursor location. In such cases normal LANSA cursor control is resumed and the user positioning request is ignored. However, after completion of the command fields #ROW and #COL will contain the location of the cursor at the time the REQUEST command completed execution.

Anchor
STD_HEAD
STD_HEAD
STD_HEAD

Specifies whether or not the standard LANSA design for the screen heading lines (lines 1 and 2) should be used.

...

*NO indicates that the standard LANSA screen heading lines should not be used. In this case lines 1 and 2 of the display can be used to position user fields.

Anchor
OPTIONS
OPTIONS
OPTIONS

Specifies special display options for this screen panel.

...

Portability Considerations

Not supported and should not be used in portable applications. If used in Visual LANSA code, a Full Function Check fatal error will be issued.

Anchor
IGCCNV_KEY
IGCCNV_KEY
IGCCNV_KEY

Controls the appearance of the text "Fnn=XXXXXX" in the function key area, of the function key assigned to support IGC conversion.

...