Pageable Maps › Dialog and Program Operations › Building and Displaying Fields › Displaying Fields

Displaying Fields

If the AUTODISPLAY option is on for the dialog, the program runtime system automatically displays the first page of a pageable map when the first detail occurrence of the second page of occurrences is created. The first page of a pageable map consists of fields in the header and footer areas and the first page of detail occurrences.

The program runtime system continues to build detail occurrences after the first page of the map is displayed, if necessary. After the first page is displayed, control is passed to the terminal operator as described as follows:

• CA ADS—Control is passed to the terminal operator when a DISPLAY command is issued after the final detail occurrence is built for the map.
• COBOL, PL/I, and Assembler programs—Control is passed to the terminal operator immediately after the first page of detail occurrences is displayed. The terminal operator can page through the map while additional detail occurrences are being built. A mapin operation can be initiated after all detail occurrences for a pageable map are built.

Requesting Display of Detail Occurrences

The following table lists the statements that request display of a page of detail occurrences and pass control to the terminal operator:

How Statements are used

The previous statements are used in the following ways:

• To initiate a mapout when mapout operations are under the control of the program runtime system, as determined by the paging-type option for the paging session.

  Note: For more information, see Building and Displaying Fields.

• To display the first page of a pageable map (application program only) when fewer detail occurrences are built than can be displayed on the first page of the map. COBOL and PL/I programs issue a status code and Assembler programs return a value when the first page of a pageable map is displayed. If the appropriate status code or value has not been received when the runtime system finishes building detail occurrences for the map, a MAP OUT RESUME or #MREQ OUT RESUME statement must be used to display the first page of the map.