gtpd2m1w | Data Communications Services Reference |
The purpose of the mapping support package is to construct and format application to application, application to terminal, and terminal to application data streams. Input messages originating with field oriented terminals (e.g., 3277 display station) consist of device dependent control characters and text. This package deletes the former and arranges the latter in a symbolically addressable manner for the requesting user program. Similarly, output data streams created by user application programs are comprised solely of text. This package inserts into this data stream the appropriate special device control characters required to display the information on field oriented terminals (e.g., 3270 CRTs) or to print the formatted information on hard copy devices (1980-24, 3284, 3286, 3287, 1977).
When mapping application to terminal and application to application data streams, 03-ASF inserts device dependent special control characters into the user created text. The Terminal Map Record which defines the format of the message and field position and characteristics, is referenced to provide the necessary information to create the updated data stream. The output mapping facility is available for formatting 3270 display stations and printers, and the 1977, 1980-21, and 1980-24 hard copy terminals.
The second function of this program is to assemble input message blocks containing fields which have been modified by terminal operator action; these fields are components of a multiple page display at a CRT terminal. As the terminal operator completes data entry for each page or panel, 03-ASC files the input message and stores the prime file address in the MSS. When the terminal operator has completed multiple screen input activity, this program will assemble the chain of input blocks for mapping.
The generation of physical map records on file and symbolic reference modules (DSECTS) in assembled programs is dependent upon an input source of parameterized macro statements. The user defines and names fields and the characteristics associated with each format. These source statements are then catalogued under unique format or map names in a Map Source Statement Library; this library provides the input to the offline element of the Map File Create And Load Program (03-ASL) and the MVS Assembler.
This macro provides the capability for the user to identify various displays or reports by assigning unique map names and map sequence numbers to each of the formats. In addition, the user defines overall characteristics (terminal type, message block size, mode, upper case conversion for input data, etc.) for each of the formats.
This macro provides the capability for the user to assign symbolic names to individual fields and define those fields with various characteristics (length, 3270 attributes, constant text). The former allows the user program to symbolically address individual fields in a DSECT; the latter allows the user to vary the delineation of fields within a format.