Retrieving Modified Data

Pageable Maps › Dialog and Program Operations › Retrieving Modified Data

Retrieving Modified Data

What is Retrieved?

Modified data in fields in the header and footer area for a pageable map can be retrieved on mapin:

The CA ADS runtime system automatically retrieves modified values from the header or footer.
The COBOL or PL/I MAP IN HEADER statement is used to retrieve a modified value in either the header or footer area
The Assembler #MREQ MAP IN HEADER=YES statement is used to retrieve a modified value in either the header or footer area

The retrieved value from each modified field (MDT set on) in the header or footer area is updated to program variable storage if DATA is Y (YES) for the field.

The mapping runtime system updates a scratch record when operator modifications are made to fields in detail occurrences but does not update program variable storage. Therefore, CA ADS dialogs and application programs that use pageable maps in the UPDATE paging mode must include statements that update program variable storage when necessary.

CA ADS and the DMLs provide statements that retrieve modified detail occurrences; either all data fields or only those fields in the occurrence for which the MDT is set on can be retrieved. The retrieved value for each modified field (MDT set on) in the detail occurrence is moved to program variable storage if DATA is specified as Y (YES) for the field on mapin.

CA ADS and DML commands that retrieve modified detail occurrences are as follows:

Language	Retrieve from Header/Footer Area	Retrieve from Detail Occurrence
CA ADS	Fields automatically retrieved	GET DETAIL statement
COBOL PL/I	MAP IN HEADER statement	MAP IN DETAIL statement
Assembler	#MREQ IN HEADER=YES statement	#MREQ IN DETAIL=YES statement Note: The HEADER specification in each statement retrieves data from both the header and footer areas.

Language

Retrieve from Header/Footer Area

Retrieve from Detail Occurrence

CA ADS

Fields automatically retrieved

GET DETAIL statement

COBOL

PL/I

MAP IN HEADER statement

MAP IN DETAIL statement

Assembler

#MREQ IN HEADER=YES statement

#MREQ IN DETAIL=YES statement

Note: The HEADER specification in each statement retrieves data from both the header and footer areas.

Note:

For information about CA ADS specifications for pageable maps, see the CA ADS Reference Guide.
For information about PL/I statements for pageable maps, see the appendix “PL/I DML Statements for Pageable Maps.”
For more information about COBOL or Assembler pageable map statements, see the CA IDMS DML Reference Guide for Assembler or the CA IDMS DML Reference Guide for COBOL.