converse

The EGL converse statement presents a text form in a text application or presents a VGUI record in a program of type VGWebtransaction.

The program waits for a user response, receives the text form or VGUI record from the user, and continues processing with the statement that follows the converse statement.

For an overview of text-form processing, see the following pages in order:
  1. Text forms
  2. Segmentation
For an overview of Web processing, see the following pages in order:
  1. Web transaction support in EGL
  2. Segmentation in Web applications

Syntax diagram for the converse statement
textFormName
Name of a text form that is visible to the program. For details on visibility, see References to parts.
VGUIRecordName
The name of a VGUI record that is visible to the program. For details on that record, see VGUIRecord part in EGL source format. For details on visibility, see References to parts.

An example is as follows:

  converse myTextForm; 
These considerations apply:
  • In relation to text forms, a converse statement is always valid in a called program; but if you are running a main program that is segmented, the converse statement is not valid in these kinds of code--
    • A function that has parameters, local storage, or return values
    • A function that is invoked (directly or indirectly) by a function that has parameters, local storage, or return values.
  • Although use of a converse statement is relatively simple, you get better performance by using a show statement that returns to the beginning of the same program. Use of a show statement requires a more complicated design because the re-invoked program starts at the first line, and that initial code must analyze whether the program is being invoked at the beginning or in the middle of a user-code interaction.
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.