show

The show statement transfers to a new program, first displaying a form or UI record to gather information that is passed to the transferred program.
This process follows these steps:
  1. Commits recoverable resources, closes files, and releases locks
  2. Optionally passes a basic record the program to use. This record, if used, is specified in the returning clause of the show statement.
  3. Ends the first program
  4. Presents the text form or processes the UI record

The show statement is not available in a called program.

For specific considerations that apply to the show statement when you use various user interface technologies, see the related reference at the end of this topic.

Syntax

Syntax diagram for the show statement
formName
Name of a text form or UI record that is visible to the program. For more information on visibility, see Scope. If you include a returning clause in the statement, the text form must be equivalent to the text form that is specified in the inputForm property of the invoked program.
VGUIRecordName
Name of a text form or UI record that is visible to the program. For more information on visibility, see Scope. If you include a returning clause in the statement, the text form must be equivalent to the text form that is specified in the inputForm property of the invoked program.
targetName
Identifier of the program that is invoked after the user submits the text form or Web page. The name can be a direct part reference (no quotation marks), a literal string (in quotation marks), or a variable or constant name. For more information, see "Compatibility" in this topic.
basicRecordName
Name of BasicRecord. The content is assigned to the input record of the receiving program.
properties
For information about the properties that are available with the show statement, including isExternal, see Transfer of control statement properties.

Compatibility

Table 1. Compatibility considerations for the show statement
Platform Issue
CICS® for z/OS® The targetName must be a CICS transaction name.
IMS/VS The targetName must be an IMS™ transaction name.
IMS BMP The show statement is not supported.
z/OS batch The show statement is not supported.

Feedback