show

The show statement presents a text form (including forms buffered with the display statement) or processes a VGUI record 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 or processes the VGUI record

The show statement is not available in a called program.

If you are processing a text form, the following statements apply:
  • If you do not include a returning clause, the operation ends when the text form is displayed.
  • If you include a returning clause, a specified program receives control after the user presses an event key. The form is assigned to the receiving program's inputForm property, and the passed record (unchanged by user input) is assigned to the receiving program's input record.
If you are processing a VGUI record, the following statements apply:
  • If you do not include a returning clause, the operation ends when the Web page is displayed.
  • If you include a returning clause, a specified program of type VGWebTransaction receives control after the user submits a form. The form data is assigned to the receiving program's input UIrecord; and the passed basic record (unchanged by user input) is assigned to the receiving program's input record.

Passing the record is optional.


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.
VGUIRecordName
Name of the VGUIRecord to present to the user.
targetName
Identifier of the program that is invoked after the user submits the text form or Web page. If the target program is on CICS®, use the transaction ID; otherwise, use the program name.
sysVar.transferName
A system variable that contains the identifier of the program or transaction 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 you are returning control to a CICS-based program defined outside of EGL or VisualAge® Generator. This indicator is available only if you set the project property for VisualAge Generator compatibility.

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, transferToTransaction element, and is also called externallyDefined.) You can make the identification, however, in either way.

Related concepts
References to parts

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.