GDDM V3R2 Base Application Programming Guide
GDDM V3R2 Base Application Programming Guide
Previous topic |
Next topic |
Contents |
Index |
Contact z/OS |
Library |
PDF |
BOOK
Selecting fields from a map for use in complex dialogs GDDM V3R2 Base Application Programming Guide SC33-0867-01 |
|
A map may contain fields that you intend to use in some circumstances and not in others. For example, a data-entry map might include column headings, some of which are not always required. GDDM lets your program decide at execution time which fields are to display data. Your program can select particular fields if you follow this procedure. When you define the map, you specify default data for the fields in question. During execution, your program chooses, for each I/O operation and each field, either to use the default data, or to use data from the ADS, or to leave the data already present in the field as it is. In a column-heading field, for instance, the default data could be the heading text. Before sending the page to the terminal, your program might either put the default data into the field, or put blanks into it from the ADS, or leave it unchanged from previous operations. A field that is to be treated in this way must have an extra element associated with it in the ADS, called a selector adjunct. When you create a map, you must tell GDDM-IMD which fields are to have selector adjuncts. You do so on the Field Naming or Application Data Structure Review frame of the GDDM-IMD map editor. In your program, you put a code into the selector adjunct. The code is interpreted when you execute an MSPUT call. It tells GDDM whether MSPUT is to update the field, and if so, whether default data or data from the ADS is to be used. The ADS in Figure 90 in topic 16.1.1 has a selector adjunct at A . GDDM-IMD gives selector adjuncts the same names as the associated fields, with a suffix of "_SEL" in PL/I, "-SEL" in COBOL, and "S" in Assembler. Selector adjuncts are one byte long. In addition to selector adjuncts, there are several other types of adjunct. They are a general control mechanism used for several different purposes. You can use them to:
Subtopics: |
 Copyright IBM Corporation 1990, 2012 |
