EGL Reference Guide for iSeries
The show statement presents a text form from a main program:
- Commits recoverable resources, closes files, and releases locks
- Optionally, passes a basic record for use by the program that is specified
in the show statement's returning clause (if any)
- Ends the first program
- 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.

- 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 ]
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.