EGL Reference Guide for iSeries

show

The show statement presents a text form from a main program:

  1. Commits recoverable resources, closes files, and releases locks
  2. Optionally, passes a basic record for use by the program that is specified in the show statement's returning clause (if any)
  3. Ends the first program
  4. Presents the text form

The show statement is not available in a called program.

If you include a returning clause in the show statement, the EGL run time invokes the specified program when the user presses an event key. The form data is assigned to the receiving program's input form. The passed record (unchanged by user input) is assigned to the receiving program's input record.

If you do not include a returning clause, the operation ends when the text form is presented.



Syntax diagram for the show statement

formPartName
Name of a text form that is visible to the program. For details on visibility, see References to parts. If you include a returning clause in the statement, the text form must be equivalent to the text form specified in the inputForm property of the program being invoked.
targetName
Name of the program that is invoked after the user submits the text form.
sysVar.transferName
A system variable that contains the identifier of the program to be invoked. Use this variable to set the identifier at run time.
basicRecordName
Name of a record of type basicRecord. The content is assigned to the receiving program's input record.
externallyDefined
An indicator that the program is externally defined. This indicator is available only if you set the project property for VisualAge Generator compatibility and is appropriate only if you are generating a COBOL program.

It is recommended that a non-EGL-generated program be identified as externally defined not in the show statement, but in the linkage options part that is used at generation time. (The related property is in the linkage options part, transferLink element, and is also called externallyDefined.) You can make the identification, however, in either way.


Related concepts
References to parts


Related reference
sysVar.transferName


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]