AS/400 Advanced Series IBM

Application Display ProgrammingVersion 4

SC41-5715-00

AS/400 Advanced Series IBM

Application Display ProgrammingVersion 4

SC41-5715-00

Take Note!

Before using this information and the product it supports, be sure to read the general information under Notices on page xxix.

First Edition (August 1997)This edition applies to the licensed program IBM Operating System/400 (Program 5769-SS1), Version 4 Release 1 Modification 0,and to all subsequent releases and modifications until otherwise indicated in new editions.

Make sure that you are using the proper edition for the level of the product.

Order publications through your IBM representative or the IBM branch serving your locality. If you live in the United States, PuertoRico, or Guam, you can order publications through the IBM Software Manufacturing Solutions at 800+879-2755. Publications are notstocked at the address given below.

IBM welcomes your comments. A form for readers comments may be provided at the back of this publication. You can also mailyour comments to the following address:

IBM CorporationAttention Department 542IDCLERK3605 Highway 52 NRochester, MN 55901-7829 USA

or you can fax your comments to:

United States and Canada: 800+937-3430Other countries: (+1)+507+253-5192

If you have access to Internet, you can send your comments electronically to IDCLERK@RCHVMW2.VNET.IBM.COM; IBMMAIL, toIBMMAIL(USIB56RZ).

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believesappropriate without incurring any obligation to you.

Copyright International Business Machines Corporation 1997. All rights reserved.Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject torestrictions set forth in GSA ADP Schedule Contract with IBM Corp.

ContentsNotices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxixProgramming Interface Information . . . . . . . . . . . . . . . . . . . . . . . . . xxxTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxx

About Application Display Programming (SC41-5715) . . . . . . . . . . . xxxiWho Should Use This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiPrerequisite and Related Information . . . . . . . . . . . . . . . . . . . . . . . xxxiInformation Available on the World Wide Web . . . . . . . . . . . . . . . . . . xxxi

Summary of Changes to Application Display Programming . . . . . . . . xxxiii

Part 1. Building a Sample Display with Online Help Information

Chapter 1. Building a Sample Display with Online Help Information . . . 1-1

Part 2. Programming Application Displays Using Display Files

Chapter 2. Defining Your Display in a Display File . . . . . . . . . . . . . . 2-1Establishing a Display File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Determining File Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Deciding Whether to Describe Data Inside or Outside Your Program . . . . 2-3Creating a Display File and Description . . . . . . . . . . . . . . . . . . . . . 2-4Changing the File Description . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5Detecting File Description Changes . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Defining Display Fields and Functions in a Record Format . . . . . . . . . . . . 2-7Understanding the Field Attribute Characters . . . . . . . . . . . . . . . . . . 2-8Understanding How Record Format Fields Can Be Used . . . . . . . . . . . 2-9Defining Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11Defining Command Attention (CAnn) and Command Function (CFnn) Keys 2-12Specifying Alternative Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13Passing Information via Indicators . . . . . . . . . . . . . . . . . . . . . . . 2-14Inserting Constant Field Text from a Message Description . . . . . . . . . 2-16Allowing for Right-to-Left Cursor Movement . . . . . . . . . . . . . . . . . . 2-16Defining Cursor Movement to Input-Capable Positions Only . . . . . . . . 2-16Defining Cursor Progression for Entry Fields . . . . . . . . . . . . . . . . . 2-17Defining Attributes for Entry Fields . . . . . . . . . . . . . . . . . . . . . . . 2-18Protecting Entry Fields Using Edit Masks . . . . . . . . . . . . . . . . . . . 2-19Specifying Right-to-Left Display Processing . . . . . . . . . . . . . . . . . . 2-19Specifying Word Wrap for Fields . . . . . . . . . . . . . . . . . . . . . . . . 2-20Emphasizing Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21Adding Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22Editing Output Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23Defining Your Own Edit Codes . . . . . . . . . . . . . . . . . . . . . . . . . 2-23Specifying Valid Screen Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24Enabling Your Display to Be Printed . . . . . . . . . . . . . . . . . . . . . . 2-25Defining Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27

Using Program-Described Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27Defining Input-Only Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-28Defining Output-Only Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-28

Copyright IBM Corp. 1997 iii

Defining Input and Output Files . . . . . . . . . . . . . . . . . . . . . . . . . 2-28

Chapter 3. Working with Display Files in an Application . . . . . . . . . . 3-1Understanding How the System Allocates Resources . . . . . . . . . . . . . . . 3-1Opening Display Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Acquiring a Display Station for I/O Operations . . . . . . . . . . . . . . . . . . . 3-2Obtaining Information about Display Files and Display Stations . . . . . . . . . 3-3

Obtaining Information about Open and I/O Operations . . . . . . . . . . . . . 3-3Obtaining Attribute Information about Display Stations . . . . . . . . . . . . . 3-4

Sending and Receiving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4Determining Which Record Formats Are Active on a Display . . . . . . . . . 3-5Writing Output to the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5Inviting Input to the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-30Reading Invited Input from the Display . . . . . . . . . . . . . . . . . . . . . 3-31Reading Input from the Display . . . . . . . . . . . . . . . . . . . . . . . . . 3-33Writing Output and Reading Input at the Same Time . . . . . . . . . . . . 3-40Canceling Input That Was Not Waited For . . . . . . . . . . . . . . . . . . . 3-41Locking the Keyboard and Positioning the Cursor During I/O Operations . 3-41Saving Previously Displayed Information . . . . . . . . . . . . . . . . . . . . 3-43Understanding the Effects of I/O Operations on Command Keys . . . . . . 3-45Avoiding Record Format Problems on the 5250 Display Station . . . . . . 3-45

Releasing an Acquired Display Station from I/O Operations . . . . . . . . . . 3-49Closing Display Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-49Mapping Display Operations to High-Level Language Operations . . . . . . . 3-49Sharing Display Files in the Same Job . . . . . . . . . . . . . . . . . . . . . . 3-50

Understanding the Open Operation for Files Shared in a Job . . . . . . . . 3-51Understanding the Input/Output Operation for Files Shared in a Job . . . 3-51Understanding the Close Operation for Files Shared in a Job . . . . . . . 3-52

Chapter 4. Displaying Groups of Records Using Subfiles . . . . . . . . . . 4-1Recognizing Subfile Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1Describing Subfiles in Your DDS Source . . . . . . . . . . . . . . . . . . . . . . 4-3Using a Subfile in a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10Requesting I/O Operations for a Subfile . . . . . . . . . . . . . . . . . . . . . . 4-12

Requesting I/O Operations for a Subfile Record Format . . . . . . . . . . . 4-12Requesting I/O Operations for a Subfile Control Record Format . . . . . . 4-15Recognizing Subfile I/O Requests in High-Level Languages . . . . . . . . 4-15

Controlling the Appearance of Subfiles . . . . . . . . . . . . . . . . . . . . . . 4-16Displaying Horizontal Subfiles with Display Modes . . . . . . . . . . . . . . . 4-17Specifying Subfile Size Equal to Page Size . . . . . . . . . . . . . . . . . . . . 4-19Specifying Subfile Size Not Equal to Page Size . . . . . . . . . . . . . . . . . 4-21Checking Validity on Subfile Data . . . . . . . . . . . . . . . . . . . . . . . . . 4-22Displaying Error Messages from Subfiles . . . . . . . . . . . . . . . . . . . . . 4-23Positioning the Cursor on the Displayed Subfile . . . . . . . . . . . . . . . . . 4-24

Positioning the Cursor Initially . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24Positioning the Cursor When a Roll Key Is Used . . . . . . . . . . . . . . . 4-24Positioning the Cursor When a Fold or Truncate Key Is Used . . . . . . . 4-27Positioning the Cursor and Rolling When Two or More Records AreDisplayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27

Understanding Subfile DDS and Program LogicExample . . . . . . . . . . . 4-31

Chapter 5. Defining Windows with Display Files . . . . . . . . . . . . . . . 5-1Window Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2DDS Window Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

iv Application Display Programming V4R1

Window Representation and Hardware Configuration . . . . . . . . . . . . . . . 5-3Creating Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

Window Definition Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3Window Reference Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3Window Size and Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4Cursor Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6Subfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6DDS Help Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

Defining Window Borders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7Border Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7Multiple Border Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8UIM Help Window Borders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

Defining a Window Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9Reading Data from Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10Changing Window Borders and Contents . . . . . . . . . . . . . . . . . . . . . 5-10Moving and Duplicating Windows . . . . . . . . . . . . . . . . . . . . . . . . . 5-11Making Two Windows Seem Active at Once . . . . . . . . . . . . . . . . . . . 5-11Making One Window in a Series Stand Out . . . . . . . . . . . . . . . . . . . 5-12Removing Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

Removing All Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13Removing More Recent Windows . . . . . . . . . . . . . . . . . . . . . . . . 5-13

Improving Application Performance . . . . . . . . . . . . . . . . . . . . . . . . 5-13System Save and Restore Operations . . . . . . . . . . . . . . . . . . . . . 5-13Bypassing System Save and Restore Operations . . . . . . . . . . . . . . 5-14

Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15Using Basic Window Functions . . . . . . . . . . . . . . . . . . . . . . . . . 5-16Defining Windows in a Separate Display File . . . . . . . . . . . . . . . . . 5-20RPG Program Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21RPG Program Source for WINPGM . . . . . . . . . . . . . . . . . . . . . . 5-22

Chapter 6. Creating a Graphical Look for Displays . . . . . . . . . . . . . . 6-1Factors Affecting the Graphical Look . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Hardware Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1Enhanced Display Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

DDS Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5Creating Menu Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

Defining the Menu-Bar Choices . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7Suppressing the Menu-Bar Separator . . . . . . . . . . . . . . . . . . . . . . 6-8Defining the Menu-Bar Separator . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

Selection FieldsOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10DDS for Selection FieldsExample . . . . . . . . . . . . . . . . . . . . . . 6-12Creating a Vertical Single-Choice Selection Field . . . . . . . . . . . . . . . 6-13Creating a Vertical Multiple-Choice Selection Field . . . . . . . . . . . . . . 6-14Creating a Horizontal Selection Field . . . . . . . . . . . . . . . . . . . . . . 6-14Cursor Movement in a Vertical Selection Field . . . . . . . . . . . . . . . . 6-15Cursor Movement in a Horizontal Selection Field . . . . . . . . . . . . . . . 6-16Controlling the Selection Indicators in a Selection Field . . . . . . . . . . . 6-17

Creating Pull-Down Menus Using Single-Choice Selection Fields . . . . . . . 6-18Controlling the Selection Indicators in a Pull-Down Menu . . . . . . . . . . 6-20Defining Accelerator Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21Defining a Menu-Bar Switch Key . . . . . . . . . . . . . . . . . . . . . . . . 6-22Defining a Cancel Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23Limiting Function When Cursor is Outside a Pull-Down Menu . . . . . . . 6-24

Contents v

Selection ListsOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-24DDS for Selection ListsExample . . . . . . . . . . . . . . . . . . . . . . . 6-26Creating Selection Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26Controlling the Selection Indicators in a Selection List . . . . . . . . . . . . 6-28

Scroll BarsOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-30Creating a Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-31DDS for Scroll BarsExample . . . . . . . . . . . . . . . . . . . . . . . . . 6-33Scroll Bar Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-33

Push ButtonsOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-34DDS for Push ButtonsExample . . . . . . . . . . . . . . . . . . . . . . . . 6-35Creating Push Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-35

Controlling the Availability of Choices . . . . . . . . . . . . . . . . . . . . . . . 6-36Auto-Selection in Single-Choice Selection Fields . . . . . . . . . . . . . . . . 6-37Auto-Enter in Single-Choice Selection Fields . . . . . . . . . . . . . . . . . . . 6-38Defining Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-38Defining Choice Colors and Attributes . . . . . . . . . . . . . . . . . . . . . . . 6-39Continued-Entry FieldsOverview . . . . . . . . . . . . . . . . . . . . . . . . . 6-42

Specifying Word Wrap on Continued-Entry Fields . . . . . . . . . . . . . . 6-43DBCS Considerations with Continued-Entry Fields . . . . . . . . . . . . . . 6-43How DBCS Data is Returned for Continued-Entry Fields . . . . . . . . . . 6-44Keyboard Functions with Continued-Entry Fields . . . . . . . . . . . . . . . 6-44Forward Field-Exit Processing . . . . . . . . . . . . . . . . . . . . . . . . . . 6-49Backward Field-Exit Processing . . . . . . . . . . . . . . . . . . . . . . . . . 6-49

How the Menu Bar Interacts with the Application . . . . . . . . . . . . . . . . 6-50Defining the MNUBARDSP Keyword on the Application Record . . . . . . 6-50Defining the MNUBARDSP Keyword on the Menu-Bar Record . . . . . . . 6-51Receiving Input from the Pull-Down Menus . . . . . . . . . . . . . . . . . . 6-53Removing a Pull-Down Menu after Receiving Input . . . . . . . . . . . . . 6-55Updating a Pull-Down Menu before Displaying . . . . . . . . . . . . . . . . 6-55

Defining Application Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56Defining Choice-Level Help . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-56Defining Help for a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-59

Key Interaction for Menu Bars and Pull-Down Menus . . . . . . . . . . . . . . 6-60Cursor Movement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-61

Pressing the Tab Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-61Pressing the Cursor Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-62

Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-62Using the MNUBARDSP Keyword on the Application Record . . . . . . . . 6-62Using the MNUBARDSP Keyword on the Menu-Bar Record . . . . . . . . 6-65How the Displays Look . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-67

Simple Hotspots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-68Command Key Emulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-68Page Up and Page Down Key Emulation . . . . . . . . . . . . . . . . . . . 6-69

Programmable Mouse ButtonsOverview . . . . . . . . . . . . . . . . . . . . 6-69Pointer Device Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-69AID Codes to be Returned . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-70Programmable Mouse ButtonsBenefits . . . . . . . . . . . . . . . . . . . 6-70Programmable Mouse Buttons Operation . . . . . . . . . . . . . . . . . . . 6-71Programmable Mouse ButtonsNWS Considerations . . . . . . . . . . . . 6-72Programmable Mouse ButtonsEvent Processing States . . . . . . . . . . 6-72Programmable Mouse ButtonsEvent Processing Priority . . . . . . . . . 6-73

Grid Line StructuresOverview . . . . . . . . . . . . . . . . . . . . . . . . . . 6-79DDS for Grid Line StructuresExample . . . . . . . . . . . . . . . . . . . . 6-80Grid Line Structures and Windows . . . . . . . . . . . . . . . . . . . . . . . 6-81

vi Application Display Programming V4R1

Hardware Requirements for Grid Line Structures . . . . . . . . . . . . . . . 6-82Inserting HTML Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-82

Resolving HTML Field Overlap . . . . . . . . . . . . . . . . . . . . . . . . . 6-83Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-85

Chapter 7. Overriding Display Files and Display File Attributes . . . . . . 7-1Determining Whether or Not to Use Overrides . . . . . . . . . . . . . . . . . . . 7-1Overriding File Attributes in HLL Programs . . . . . . . . . . . . . . . . . . . . . 7-1Overriding File Names in HLL Programs . . . . . . . . . . . . . . . . . . . . . . 7-3Overriding Both File Names and Attributes in HLL Programs . . . . . . . . . . 7-3Applying Overrides When Compiling a Program . . . . . . . . . . . . . . . . . . 7-4Deleting Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5Displaying Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6Using File Redirection to Override File Names and Libraries or File Types . . 7-6

Overriding Files with the Same File Types . . . . . . . . . . . . . . . . . . . . 7-6Overriding Files with Different File Types . . . . . . . . . . . . . . . . . . . . 7-6

Recognizing Commands That Ignore or Restrict Overrides . . . . . . . . . . . . 7-9

Chapter 8. Handling Messages and Errors for Display Files . . . . . . . . 8-1Creating and Displaying Your Own Messages . . . . . . . . . . . . . . . . . . . 8-1

Displaying a Message on the Message Line . . . . . . . . . . . . . . . . . . 8-2Displaying a Message on the Message Line When a Subfile Control Recordis Written . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

Displaying a Message on the Message Line Using a Message Field . . . . 8-3Priorities for Displaying Messages on a Message Line . . . . . . . . . . . . 8-3Displaying Messages in a Field on the Display . . . . . . . . . . . . . . . . . 8-3Displaying Messages on a Program Message Queue . . . . . . . . . . . . . 8-4Displaying Error Messages through a Subfile . . . . . . . . . . . . . . . . . . 8-4Sounding an Alarm for Messages . . . . . . . . . . . . . . . . . . . . . . . . . 8-7Automatically Handling Permanent I/O Errors on Display Stations . . . . . . 8-7

Analyzing Error Messages Sent from the System . . . . . . . . . . . . . . . . . 8-8Understanding Messages and Message Monitors . . . . . . . . . . . . . . . 8-9Understanding Major/Minor Return Codes . . . . . . . . . . . . . . . . . . . 8-10Recovering from Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11

Chapter 9. Creating and Accessing Menus Using Display Files . . . . . . 9-1Running System and User-Defined Menus . . . . . . . . . . . . . . . . . . . . . 9-1

Returning to a Menu after Running the GO command . . . . . . . . . . . . . 9-1Determining the Previous Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1Using the Cancel and Exit Keys on Menus . . . . . . . . . . . . . . . . . . . 9-2Choosing the Menu That Is Shown at Sign-On Time . . . . . . . . . . . . . . 9-3

Defining Your Own Display File Menus . . . . . . . . . . . . . . . . . . . . . . . 9-4Understanding DDS and Display File Considerations for Menus . . . . . . . 9-4Describing Menu Actions in a Message File . . . . . . . . . . . . . . . . . . . 9-5Naming Help Formats for Menus . . . . . . . . . . . . . . . . . . . . . . . . . 9-6Building a Display File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

Defining Your Own Program Menus . . . . . . . . . . . . . . . . . . . . . . . . 9-10Passing Parameters for Program Menus . . . . . . . . . . . . . . . . . . . . 9-10Building a Program Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11Exiting from a Program Menu without Returning to the Previous Menu . . 9-13

Avoiding Menu Name Conflict . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15Naming Your Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15Placing Your Menu in a Higher Library in the Library List . . . . . . . . . . 9-16Specifying the Library That Contains the Menu . . . . . . . . . . . . . . . . 9-16

Contents vii

Using the Generic Menu Specification . . . . . . . . . . . . . . . . . . . . . 9-16Changing the Command Default after Duplicating a Command . . . . . . . 9-16

Displaying Menu Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16Changing Menu Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16Deleting Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17

Chapter 10. Using User-Defined Data Streams . . . . . . . . . . . . . . . . 10-1Understanding Display Station Differences . . . . . . . . . . . . . . . . . . . . 10-1Understanding User-Defined Data Stream Limitations . . . . . . . . . . . . . . 10-2

Chapter 11. Passing Data between Programs . . . . . . . . . . . . . . . . 11-1Passing Data in the Same Routing Step in a Job . . . . . . . . . . . . . . . . 11-1Passing Data between Routing Steps in a Job . . . . . . . . . . . . . . . . . . 11-3

Chapter 12. Waiting for Input from a Display File, an ICF File, and aData Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

Chapter 13. Using Alternative Character Sets and Code Pages . . . . . 13-1Specifying Character Translation for Fields . . . . . . . . . . . . . . . . . . . . 13-2Determining the Character Identifier (CHRID) Value for Your Display . . . . . 13-4

Chapter 14. Improving System Performance with Displays . . . . . . . . 14-1Deferring the Write Operation for a Display File . . . . . . . . . . . . . . . . . 14-1Designating the Primary Screen Size for a Display File . . . . . . . . . . . . . 14-1Writing Only One Page of Subfile Records at a Time . . . . . . . . . . . . . . 14-1Sharing an Open Data Path (ODP) for the Same Job . . . . . . . . . . . . . . 14-2Sending Records with Input Fields to the Display in Order . . . . . . . . . . . 14-2Overlapping and Not Deleting Repeatedly Sent Records . . . . . . . . . . . . 14-2Restoring the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-3Defining Command Attention Keys Rather Than Command Function Keys . 14-3Using the Invite Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-3Using Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4

Part 3. Programming Application Displays Using Panel Groups

Chapter 15. Improving Productivity with User Interface Manager . . . . 15-1Increasing User Productivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1Increasing Application Programmer Productivity . . . . . . . . . . . . . . . . . 15-1What to Consider before Using UIM Instead of Data DescriptionSpecifications (DDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1

Chapter 16. Introduction to the User Interface Manager . . . . . . . . . . 16-1Overview of UIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-1What the UIM Supports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2What Is a Panel Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2What Is a Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2Creating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3Elements Within a Panel Group . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3Using the UIM Language Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-4Using Dialog Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-4Using Control Language (CL) Commands . . . . . . . . . . . . . . . . . . . . 16-5Using an Application Programming Interface (API) . . . . . . . . . . . . . . . 16-5Defining a Menu Object Using UIM . . . . . . . . . . . . . . . . . . . . . . . . 16-6

viii Application Display Programming V4R1

Creating a Menu Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-6Required Tags for a Menu Panel . . . . . . . . . . . . . . . . . . . . . . . . 16-8Source for Example Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-9

Defining a Panel Group Object Using UIM . . . . . . . . . . . . . . . . . . . 16-13Creating a List Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-13

Required Tags for a List Panel . . . . . . . . . . . . . . . . . . . . . . . . 16-16Source for Example List Panel . . . . . . . . . . . . . . . . . . . . . . . . 16-17Application Programming for a List Panel . . . . . . . . . . . . . . . . . . 16-25

Creating a Confirmation List Panel . . . . . . . . . . . . . . . . . . . . . . . . 16-27Required Tags for a Confirmation List Panel . . . . . . . . . . . . . . . . 16-28Source for Example Confirmation Panel . . . . . . . . . . . . . . . . . . . 16-28Automatic Confirmation Processing . . . . . . . . . . . . . . . . . . . . . . 16-31Application Programming for Confirmation Processing . . . . . . . . . . . 16-31

Creating a Data Presentation Panel . . . . . . . . . . . . . . . . . . . . . . . 16-32Required Tags for a Data Presentation Panel . . . . . . . . . . . . . . . . 16-34Source for Example Data Presentation Panel . . . . . . . . . . . . . . . . 16-35Application Programming for a Data Presentation Panel . . . . . . . . . . 16-46Data Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-49

Creating a Panel with a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . 16-50Required Tags for a Panel with a Menu Bar . . . . . . . . . . . . . . . . . 16-52Source for Example Panel with a Menu Bar . . . . . . . . . . . . . . . . . 16-53Application Programming for a Menu Bar Panel . . . . . . . . . . . . . . 16-63

Chapter 17. Details of Using User Interface Manager . . . . . . . . . . . . 17-1Opening a UIM Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-1

Defining Dialog Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-1Restrictions on Using Dialog Variables . . . . . . . . . . . . . . . . . . . . . 17-3Dialog Variable Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . 17-3Providing Field Values for a Display Panel Using Dialog Variables . . . . 17-4Using Variable Pool Services . . . . . . . . . . . . . . . . . . . . . . . . . . 17-4Character Set and Code Page Considerations . . . . . . . . . . . . . . . . 17-5

Managing a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-7Defining a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-8Initializing a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-8Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-8Updating a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-9Incomplete List Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-9Removing and Inserting an Entry from a List . . . . . . . . . . . . . . . . 17-10Controlling List Entries on a List Display . . . . . . . . . . . . . . . . . . . 17-10Improving Interactive Response Time for a List Display . . . . . . . . . . 17-11Using Action Lists and Selection Lists . . . . . . . . . . . . . . . . . . . . 17-11Using Selection Characters . . . . . . . . . . . . . . . . . . . . . . . . . . 17-13

Managing Panel Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-13Enabling Conversion to a GUI . . . . . . . . . . . . . . . . . . . . . . . . . . 17-14Scrolling Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-14

Defining Scrollable Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-14Defining Function Key Scrolling . . . . . . . . . . . . . . . . . . . . . . . . 17-15Scrolling and Error Conditions . . . . . . . . . . . . . . . . . . . . . . . . . 17-15Scrolling a List Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-15Scrolling a Menu Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-16Scrolling an Information Area . . . . . . . . . . . . . . . . . . . . . . . . . 17-16Scrolling Data Item Groups . . . . . . . . . . . . . . . . . . . . . . . . . . 17-16Scrolling a Text Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-16

Defining Contextual Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-16

Contents ix

Command Line Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-19Command Line Interpretation . . . . . . . . . . . . . . . . . . . . . . . . . 17-19Entering Commands That Are Too Long . . . . . . . . . . . . . . . . . . . 17-20

Defining Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-20Formatting Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-20Handling Function Keys and VARUPD Value . . . . . . . . . . . . . . . . 17-21

Panel Formatting Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-22When Panel Formatting Is Performed . . . . . . . . . . . . . . . . . . . . 17-22Application Control of Panel Formatting . . . . . . . . . . . . . . . . . . . 17-23Limits of the Panel Formatter . . . . . . . . . . . . . . . . . . . . . . . . . 17-24

Folding Up Multiple Panels When EXIT Is Requested . . . . . . . . . . . . . 17-24Folding Up a List Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-26

Adding a Pop-Up Window over Another Panel . . . . . . . . . . . . . . . 17-27Using Menu Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-27

Differences Between Pull-Down Menus and Pop-Up Windows . . . . . . 17-28Using Pop-Up Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-30

Defining Application Windows . . . . . . . . . . . . . . . . . . . . . . . . . 17-30Adding and Removing Windows . . . . . . . . . . . . . . . . . . . . . . . 17-31Using the Command Line in a Window . . . . . . . . . . . . . . . . . . . . 17-32

UIM as a Request Processor Program When Displaying a Panel . . . . . . 17-33Printing Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-33

Printing a Print Head Panel . . . . . . . . . . . . . . . . . . . . . . . . . . 17-35Printing a Print Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-35Using Blank Lines for Separating . . . . . . . . . . . . . . . . . . . . . . . 17-36Fonts and Highlighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-36Printing the Trailer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-36Defining Prolog Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-36Defining Header Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-36Using the Page-Eject Function During Printing . . . . . . . . . . . . . . . 17-37Sharing and Overriding Printer Files . . . . . . . . . . . . . . . . . . . . . 17-37Printing Double-Byte Character Set (DBCS) Considerations . . . . . . . 17-37Commonly Asked UIM Questions . . . . . . . . . . . . . . . . . . . . . . . 17-37

Part 4. Programming Help Displays

Chapter 18. Making Online Help Information Accessible for YourDisplay File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1

Enabling the Help Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2Choosing between Panel Groups, Documents, and Records for Help . . . . 18-2Defining Which Areas of Your Display Need Online Help Information . . . . . 18-3Specifying Panel Groups for Help in Your Display File . . . . . . . . . . . . . 18-6

Copying QUSRTOOL Examples That Specify Help Using Panel Groups . 18-9Specifying Documents in Your Display File . . . . . . . . . . . . . . . . . . . . 18-9Specifying Records in Your Display File . . . . . . . . . . . . . . . . . . . . . 18-12

Entering the Records That Contain the Help Information . . . . . . . . . 18-14Using Records and Documents for Help in the Same Display File . . . . 18-15Understanding the Restrictions on Records . . . . . . . . . . . . . . . . . 18-15Paging between Help Displays That Use Records . . . . . . . . . . . . . 18-16

Returning Control to Your Program after Pressing the Help Key . . . . . . 18-20Returning Control to Your Program after Showing the Help Display . . . 18-20Returning Control to Your Program without Showing the Help Display . 18-22

Chapter 19. Making Online Help Accessible for Your Panel Group . . . 19-1

x Application Display Programming V4R1

Definitions and Explanations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1Help in a List Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5

Coding Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-6Help in a Menu Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7

Coding Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-7Help in a Data Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-9

Coding Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-10Help in a Menu Bar Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-13

Coding Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-14Help in a Function Key Area . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-15

Coding Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-16

Chapter 20. Defining Online Help Information . . . . . . . . . . . . . . . . 20-1Defining Online Help Information in a Panel Group . . . . . . . . . . . . . . . 20-1

Entering the UIM Source for a Panel Group for Help . . . . . . . . . . . . . 20-1Creating and Deleting Panel Groups . . . . . . . . . . . . . . . . . . . . . 20-15Assigning Panel Groups as Help for Commands . . . . . . . . . . . . . . 20-16Using Panel Groups in a Search Index . . . . . . . . . . . . . . . . . . . . 20-16Copying QUSRTOOL Examples That Define Help in a Panel Group . . 20-18

Defining Online Information in a Document . . . . . . . . . . . . . . . . . . . 20-18Creating a Document for Help . . . . . . . . . . . . . . . . . . . . . . . . . 20-18Viewing the Document without Pressing the Help Key . . . . . . . . . . . 20-19

Defining Online Help Information in a DDS Record . . . . . . . . . . . . . . 20-19

Part 5. Guidelines for IBM AS/400-Style Displays

Chapter 21. Designing IBM AS/400-Style Displays . . . . . . . . . . . . . 21-1Using the Displays Example in the QUSRTOOL Library . . . . . . . . . . . . 21-1

Recognizing the Example Objects . . . . . . . . . . . . . . . . . . . . . . . 21-1Installing the Example Objects . . . . . . . . . . . . . . . . . . . . . . . . . 21-4Viewing the Sample Displays, Command, and Online Help Information . . 21-4Copying the Source for the Example Objects for Your Own Use . . . . . . 21-7

Defining Special Functions and Attributes for All Displays . . . . . . . . . . . 21-8Designing the Single-Choice Menu Display . . . . . . . . . . . . . . . . . . . . 21-8

Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9Menu Selection Entry Field . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10Online Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10General Menu Display Operation . . . . . . . . . . . . . . . . . . . . . . . 21-10

Designing the Entry Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-11Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-11Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-12Prompt Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-12Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-17Online Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-17General Entry Display Operation . . . . . . . . . . . . . . . . . . . . . . . 21-17

Designing the Information Display . . . . . . . . . . . . . . . . . . . . . . . . 21-17Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-19Location Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-19Prompt Area 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-19Prompt Area 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-20

Contents xi

Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-20Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-20Online Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-20General Information Display Operation . . . . . . . . . . . . . . . . . . . . 21-21

Designing the List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-21Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-22Prompt Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-22Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-22Options Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-23Column Headings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-24Extended Action Entry Area . . . . . . . . . . . . . . . . . . . . . . . . . . 21-24List Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-24Paging Location Information . . . . . . . . . . . . . . . . . . . . . . . . . . 21-25Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-25Online Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-25General List Display Operation . . . . . . . . . . . . . . . . . . . . . . . . 21-26

Defining the Function Key Area for All Displays . . . . . . . . . . . . . . . . 21-33Optional Command Line and Identifier Field . . . . . . . . . . . . . . . . . 21-34Common Key Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . 21-38

Defining Help Information for All Displays . . . . . . . . . . . . . . . . . . . . 21-44Help for the Menu Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-44Help for the Entry Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-46Help for the Information Display . . . . . . . . . . . . . . . . . . . . . . . . 21-47Help for the List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-48

Defining and Presenting Messages . . . . . . . . . . . . . . . . . . . . . . . 21-49Designing Common User Access (CUA) Entry Level Models . . . . . . . . 21-50

Entry Dialog Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-51Single-Choice Selection (Menu) . . . . . . . . . . . . . . . . . . . . . . . . 21-52Entry Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-53Information Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-55List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-55Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-57

Part 6. Appendixes

Appendix A. UIM Panel Group Definition Language . . . . . . . . . . . . A-1Panel Group Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4Name Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6Imbeds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6DBCS Graphic Literals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6Hexadecimal Literals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6

APPFMT (Application Formatted Area) . . . . . . . . . . . . . . . . . . . . . . A-8Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8Application Formatted Data . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9Example: Application Formatted Area . . . . . . . . . . . . . . . . . . . . . A-9

BOTINST (Bottom Instruction) . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10

CHECK (Validity Checking) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11

xii Application Display Programming V4R1

Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11Example: Validity Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . A-12

CIT (Title Citation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13Example: Title Citations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13

CLASS (Class Definition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-14Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-14Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18Example: Class Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24Display Forms of Numeric Values . . . . . . . . . . . . . . . . . . . . . . . . A-24Display Forms of Character, Date, and Time Values . . . . . . . . . . . . . A-25

CMDLINE (Command Line) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-26Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-26Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-26Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-26

COND (Condition Definition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-27Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-27Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-28Example: Conditioning an Option . . . . . . . . . . . . . . . . . . . . . . . . A-29

COPYR (Copyright) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-30Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-30

DATA (Data Presentation Area) . . . . . . . . . . . . . . . . . . . . . . . . . . A-31Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-32Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-32Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-33Print Formatting Considerations . . . . . . . . . . . . . . . . . . . . . . . . . A-33Example 1: Data Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . A-34Example 2: Two-Column Format in a Data Entry Panel . . . . . . . . . . . A-34Example 3: Two Presentation Areas for Data Items . . . . . . . . . . . . . A-35Example 4: Data Presentation Area with a Menu Area . . . . . . . . . . . A-36Example 5: Data Entry Panel with a Nested Data Group . . . . . . . . . . A-36

DATAC (Data Item Choices) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-38Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-38Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-38

DATACOL (Data Column) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-39Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-39Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-39

DATAGRP (Data Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-40Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-40Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-41

DATAI (Data Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-42Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-42Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-43Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-45

DATAIX (Data Item Extender) . . . . . . . . . . . . . . . . . . . . . . . . . . . A-47Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-47Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-48

DATASLT (Data Selection Field) . . . . . . . . . . . . . . . . . . . . . . . . . . A-51Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-51Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-51Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-52Example 1: Data Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . A-53Example 2: Multiple-Selection Field . . . . . . . . . . . . . . . . . . . . . . A-53

DATASLTC (Data Selection Field Choice) . . . . . . . . . . . . . . . . . . . . A-55

Contents xiii

Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-55Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-56

DL (Definition List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-57Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-57Required Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-57Optional Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-58Example 1: Definition List . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-58Example 2: Compact Definition List . . . . . . . . . . . . . . . . . . . . . . A-58

FIG (Figure) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-59Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-59Optional Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-59Example: Sample Figure . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-59

HELP (Help Module) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-60Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-60Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-60Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-61Example: Help Panel Definition . . . . . . . . . . . . . . . . . . . . . . . . . A-62

HP0 through HP9 (Highlighted Phrase) . . . . . . . . . . . . . . . . . . . . . . A-63Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-63

H1 through H4 (Heading) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-65Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-65Example: Heading Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-65

IMHELP (Imbed Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-66Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-66Example: Imbedded Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-66

IMPORT (Import) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-67Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-67Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-67

INFO (Information Area) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-68Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-68Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-68Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-68Print Formatting Considerations . . . . . . . . . . . . . . . . . . . . . . . . . A-69

ISCH (Index Search) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-70Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-70Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-70Example: Index Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-70

ISCHSUBT (Index Search Subtopic) . . . . . . . . . . . . . . . . . . . . . . . . A-71Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-71Example: Index Search Hierarchy . . . . . . . . . . . . . . . . . . . . . . . A-71

ISCHSYN (Index Search Synonym) . . . . . . . . . . . . . . . . . . . . . . . . A-72Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-72Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-72Example: Index Search Synonyms . . . . . . . . . . . . . . . . . . . . . . . A-72

KEYI (Key List Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-74Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-74Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-75Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-75Example: Key Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-75

KEYL (Key List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-76Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-76Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-76Example: Key List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-76

LINES (Unformatted Lines) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-77

xiv Application Display Programming V4R1

Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-77Example: Unformatted Lines . . . . . . . . . . . . . . . . . . . . . . . . . . A-77

LINK (Hypertext Link Definition) . . . . . . . . . . . . . . . . . . . . . . . . . . A-78Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-78Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-78Conditional Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-79Bidirectional Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . A-80Example: Hypertext Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-80

LIST (List Area) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-82Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-83Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-83Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-85Print Formatting Considerations . . . . . . . . . . . . . . . . . . . . . . . . . A-86Example 1: List Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-86Example 2: List Area with Three Layout Columns . . . . . . . . . . . . . . A-87Example 3: List Area with List Column Groups . . . . . . . . . . . . . . . . A-87Example 4: Dynamic List Column Heading Formatting . . . . . . . . . . . A-88

LISTACT (List Action) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-90Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-90Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-91Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-94Confirmation Panel Requirements . . . . . . . . . . . . . . . . . . . . . . . A-94Confirmation Panel Conventions . . . . . . . . . . . . . . . . . . . . . . . . A-94Example: List Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-95

LISTCOL (List Column) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-96Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-96Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-97Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-99Formatting Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-99

LISTDEF (List Definition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-100Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-100Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-100

LISTGRP (List Column Group) . . . . . . . . . . . . . . . . . . . . . . . . . . A-103Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-103Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-103Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-104Example: List Column Group . . . . . . . . . . . . . . . . . . . . . . . . . A-104

LISTVIEW (List View) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-105Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-105Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-105

LP (List Part) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-107Example: List Part . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-107

MBAR (Menu Bar) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-108Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-108Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-108Example: Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-108

MBARC (Menu Bar Choice) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-110Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-110Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-110

MENU (Menu Area) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-111Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-111Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-111Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-112Example 1: Simple Menu Area . . . . . . . . . . . . . . . . . . . . . . . . A-112

Contents xv

Example 2: Menu Area with Groups . . . . . . . . . . . . . . . . . . . . . A-112MENUGRP (Menu Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-114

Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-114Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-114

MENUI or MI (Menu Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-115Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-115Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-115Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-116

NT or NOTE (Note) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-117Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-117Example: Using a Note . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-117

OL (Ordered List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-118Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-119Required Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-119Example: Ordered List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-119

OPTLINE (Option Line) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-120Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-120Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-120

P (Paragraph) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-121Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-121Example: Paragraph Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . A-121

PANEL (Display Panel) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-122Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-122Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-123Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-127Example: Panel Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . A-127

PARML (Parameter List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-129Required Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-129Example: Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . A-130

PC (Paragraph Continuation) . . . . . . . . . . . . . . . . . . . . . . . . . . . A-131Example: Paragraph Continuation . . . . . . . . . . . . . . . . . . . . . . A-131

PDACCEL (Pull-Down Accelerator) . . . . . . . . . . . . . . . . . . . . . . . A-132Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-132

PDFLD (Pull-Down Field) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-133Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-133

PDFLDC (Pull-Down Field Choice) . . . . . . . . . . . . . . . . . . . . . . . . A-134Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-134Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-134Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-136Confirmation Panel Requirements . . . . . . . . . . . . . . . . . . . . . . A-136Confirmation Panel Conventions . . . . . . . . . . . . . . . . . . . . . . . A-136

PK (Programming Keyword) . . . . . . . . . . . . . . . . . . . . . . . . . . . A-138Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-138Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-138

PNLGRP (Panel Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-139Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-139

PRTHEAD (Print Head Panel) . . . . . . . . . . . . . . . . . . . . . . . . . . A-142Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-142Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-142Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-143Layout of the Title Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-143Example: Print Title Line . . . . . . . . . . . . . . . . . . . . . . . . . . . A-145

PRTPNL (Print Panel) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-146Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-146

xvi Application Display Programming V4R1

Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-146Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-146

PRTTRAIL (Print Trailer Message) . . . . . . . . . . . . . . . . . . . . . . . . A-148Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-148Example: Trailer Message . . . . . . . . . . . . . . . . . . . . . . . . . . . A-148

PV (Programming Variable) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-149Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-149

RT (Reverse Text) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-150Example 1: Left-to-Right Formatting on a Right-to-Left Panel . . . . . . A-150Example 2: Left-to-Right Formatting on a Left-to-Right Panel . . . . . . A-151

SL (Simple List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-152Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-152Required Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-152Example: Simple Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-153

TEXT (Text Area) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-154Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-154Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-155Cursor positioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-155Text Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-155Example: Text area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-157

TI (Translation List Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-158Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-158Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-158

TL (Translation List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-159Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-159Examples: Translation List . . . . . . . . . . . . . . . . . . . . . . . . . . A-159

TOPINST (Top Instruction) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-161Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-161Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-161

TT (Truth Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-162Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-162Example: Truth Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-162

TTROW (Truth Table Row) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-163Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-163

UL (Unordered List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-164Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-164Required Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-165Example: Unordered Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . A-165

VAR (Variable Definition) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-166Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-166Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-166Dialog Variables Defined by UIM . . . . . . . . . . . . . . . . . . . . . . . A-166

VARRCD (Variable Record Definition) . . . . . . . . . . . . . . . . . . . . . . A-169Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-169Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-169

XH1 through XH4 (Extended Help Headings) . . . . . . . . . . . . . . . . . A-170Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-170Formatting Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-170Example: Sample Headings . . . . . . . . . . . . . . . . . . . . . . . . . . A-170

XMP (Example) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-171Example: Formatting an Example . . . . . . . . . . . . . . . . . . . . . . A-171

Appendix B. UIM Dialog Commands . . . . . . . . . . . . . . . . . . . . . . B-1The VARUPD Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4

Contents xvii

ACTIONS (Menu Bar Cursor Action) . . . . . . . . . . . . . . . . . . . . . . B-4CALL (Call Program) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6CHGVIEW (Change View) . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6CMD (System Command) . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-7CMDLINE (Command Line) . . . . . . . . . . . . . . . . . . . . . . . . . . . B-7DSPHELP (Display Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-7ENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-8EXIT (Exit Display) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-8EXTHELP (Extended Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . B-9HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-9HELPHELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-9HELPIDX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-9HOME (Display Home Menu) . . . . . . . . . . . . . . . . . . . . . . . . . . B-9KEYSHELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-10MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-10MOREKEYS (Display More Function Keys) . . . . . . . . . . . . . . . . . . B-10MOVETOP (Move to Top) . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11MSG (Display Message) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11PAGEDOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11PAGEUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12PRINT (Print Display) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12PROMPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13PULLDOWN (Display Pull-Down Menu) . . . . . . . . . . . . . . . . . . . . B-14RETRIEVE (Retrieve Command String) . . . . . . . . . . . . . . . . . . . . B-14RETURN (Return Control to Application) . . . . . . . . . . . . . . . . . . . B-14

Appendix C. Feedback Area Layouts for Display Files . . . . . . . . . . . C-1Open Feedback Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

Device Definition List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-4I/O Feedback Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6

Common I/O Feedback Area . . . . . . . . . . . . . . . . . . . . . . . . . . C-6I/O Feedback Area for Display Files . . . . . . . . . . . . . . . . . . . . . . C-9Get Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-12

Appendix D. Double-Byte Character Set Support for Displays . . . . . . D-1Double-Byte Character Set Fundamentals . . . . . . . . . . . . . . . . . . . . D-1

DBCS Code Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1Shift-Control Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3Using Double-Byte Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3Double-Byte Character Size . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4

Processing Double-Byte Characters . . . . . . . . . . . . . . . . . . . . . . . . D-4Basic Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4Extended Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-4What Happens When Extended Characters Are Not Processed . . . . . . D-4

Device File Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5What a DBCS File Is . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5When to Indicate a DBCS File . . . . . . . . . . . . . . . . . . . . . . . . . . D-5How to Indicate a DBCS File . . . . . . . . . . . . . . . . . . . . . . . . . . D-5Improperly Indicated DBCS Files . . . . . . . . . . . . . . . . . . . . . . . . D-6

Display Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-6Inserting Shift-Control Characters . . . . . . . . . . . . . . . . . . . . . . . . D-6Number of Displayed Extended Characters . . . . . . . . . . . . . . . . . . D-6Number of Input Fields on a Display . . . . . . . . . . . . . . . . . . . . . . D-6

xviii Application Display Programming V4R1

Effects of Displaying Double-Byte Data at Alphanumeric Work Stations . . D-7Effects of Displaying DBCS-Graphic Fields on Double-Byte Displays . . . D-7

Application Program Considerations . . . . . . . . . . . . . . . . . . . . . . . . D-7Designing Application Programs That Process Double-Byte Data . . . . . D-7Changing Alphanumeric Application Programs to DBCS ApplicationPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-8

DBCS Font Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-8Finding Out if a DBCS Font Table Exists . . . . . . . . . . . . . . . . . . . D-8Copying a DBCS Font Table onto Tape or Diskette . . . . . . . . . . . . . D-9Copying a DBCS Font Table from Tape or Diskette . . . . . . . . . . . . . D-9Deleting a DBCS Font Table . . . . . . . . . . . . . . . . . . . . . . . . . . D-10Starting the Character Generator Utility . . . . . . . . . . . . . . . . . . . . D-10Copying User-Defined Double-Byte Characters . . . . . . . . . . . . . . . . D-10

DBCS Font Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-10DBCS Sort Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-11

Using DBCS Sort Tables on the System . . . . . . . . . . . . . . . . . . . . D-12Finding Out if a DBCS Sort Table Exists . . . . . . . . . . . . . . . . . . . . D-12Saving a DBCS Sort Table onto Tape or Diskette . . . . . . . . . . . . . . D-12Restoring a DBCS Sort Table from Tape or Diskette . . . . . . . . . . . . . D-12Copying a Japanese DBCS Master Sort Table to a Data File . . . . . . . . D-12Copying a Japanese DBCS Master Sort Table from a Data File . . . . . . D-13Deleting a DBCS Sort Table . . . . . . . . . . . . . . . . . . . . . . . . . . . D-14

DBCS Conversion Dictionaries . . . . . . . . . . . . . . . . . . . . . . . . . . . D-14System-Supplied Dictionary (for Japanese Use Only) . . . . . . . . . . . . D-14User-Created Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-15Commands for DBCS Conversion Dictionaries . . . . . . . . . . . . . . . . D-15Displaying and Printing the DBCS Conversion Dictionary . . . . . . . . . . D-19Deleting a DBCS Conversion Dictionary . . . . . . . . . . . . . . . . . . . . D-19

DBCS Conversion (for Japanese Use Only) . . . . . . . . . . . . . . . . . . . D-19Where You Can Use DBCS Conversion . . . . . . . . . . . . . . . . . . . . D-20How DBCS Conversion Works . . . . . . . . . . . . . . . . . . . . . . . . . D-20Using DBCS Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-20Performing DBCS Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . D-21

Appendix E. Display File Return Codes . . . . . . . . . . . . . . . . . . . . E-1Major Code 00 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1Major Code 02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1Major Code 03 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2Major Code 04 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2Major Codes 0811 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-3Major Code 34 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-3Major Code 80 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-3Major Code 81 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-5Major Code 82 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-6Major Code 83 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-10

Appendix F. Edit Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-1OS/400 Edit Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-1

Examples of Editing Using OS/400 Edit Codes . . . . . . . . . . . . . . . . . F-3User-Defined Edit Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-4

Using User-Defined Edit Codes . . . . . . . . . . . . . . . . . . . . . . . . . . F-5Example of a User-Defined Edit Code . . . . . . . . . . . . . . . . . . . . . . F-5

Appendix G. System/36-Compatible Display Data Management . . . . . G-1

Contents xix

Clearing Lines on the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-1Input Data for Display File Records . . . . . . . . . . . . . . . . . . . . . . . . G-2Input Data from the Work Station Controller . . . . . . . . . . . . . . . . . . . G-2Self-Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2Return Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-3Erase Input Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-3Display Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-3Positioning the Cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-4Displaying Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-4Put Override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-6Handling Signed Numeric Data . . . . . . . . . . . . . . . . . . . . . . . . . . . G-7Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-7Help Key Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-7Using Command Keys to Exit Application Help . . . . . . . . . . . . . . . . . G-8Cancel-Invite Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-8Retain Command and Function Keys . . . . . . . . . . . . . . . . . . . . . . . G-9System/36 Functions Not Supported . . . . . . . . . . . . . . . . . . . . . . . . G-10Restricted DDS Keywords/Functions . . . . . . . . . . . . . . . . . . . . . . . . G-10

Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . H-1

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1

xx Application Display Programming V4R1

Figures2-1. Sample DDS Source for a Display File . . . . . . . . . . . . . . . . . . 2-72-2. Record Formats in the Program and on the Display . . . . . . . . . . 2-82-3. DDS for Field-Level Cursor Progression . . . . . . . . . . . . . . . . 2-182-4. DDS for Subfile-Level Cursor Progression . . . . . . . . . . . . . . . 2-182-5. Sample DDS for Right-to-Left Display Processing . . . . . . . . . . . 2-192-6. Sample DDS for Program-to-System Fields . . . . . . . . . . . . . . 2-222-7. Sample DDS for Two Display Sizes . . . . . . . . . . . . . . . . . . . 2-252-8. Sample DDS for Subfiles for Two Display Sizes . . . . . . . . . . . . 2-253-1. Valid Placement of Records on a Screen When the CLRL Keyword Is

Not Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63-2. Wrong Placement of Records on Screen When CLRL Keyword Not

Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83-3. Replacing Record Formats . . . . . . . . . . . . . . . . . . . . . . . . . 3-93-4. Sample DDS Source Showing Use of the SLNO(*VAR) Keyword . . 3-123-5. Sample DDS Source Showing Difference between CLRL and

OVERLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-153-6. Sample DDS Source Showing Use of the PUTOVR Keyword . . . . 3-193-7. Sample DDS Source Showing Efficient Use of PUTOVR Keyword . 3-203-8. Sample DDS Source Showing Another Use of PUTOVR Keyword . 3-223-9. Sample DDS Source Showing Use of the PUTRETAIN Keyword . . 3-24

3-10. Sample DDS Source Showing Use of the PUTRETAIN Keyword . . 3-253-11. Sample DDS Source Showing Use of the DSPMOD Keyword . . . 3-273-12. Sample DDS to Show Record Format Problems . . . . . . . . . . . 3-474-1. DDS Keyword Processing Order for Subfile Control . . . . . . . . . 4-104-2. Vertically Displayed Subfile . . . . . . . . . . . . . . . . . . . . . . . . 4-164-3. Horizontally Displayed Subfile . . . . . . . . . . . . . . . . . . . . . . 4-164-4. Horizontally and Vertically Displayed Subfiles Displayed at the Same

Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174-5. Sample DDS Using DSPMOD with Subfiles . . . . . . . . . . . . . . 4-184-6. Sample DDS Using SFLSIZ, SFLPAG, and ROLLUP Keywords . . 4-194-7. Sample DDS for a Variable-Length Record . . . . . . . . . . . . . . 4-204-8. Sample DDS Using the SFLNXTCHG Keyword . . . . . . . . . . . . 4-224-9. Sample DDS for a Message Subfile . . . . . . . . . . . . . . . . . . . 4-23

4-10. Sample DDS Using the DSPATR(PC) Keyword . . . . . . . . . . . . 4-254-11. Sample DDS Showing Customer Name Search Subfile . . . . . . . 4-325-1. Window TitleDisplay Example . . . . . . . . . . . . . . . . . . . . . . 5-95-2. DDS for a Window Title . . . . . . . . . . . . . . . . . . . . . . . . . . 5-106-1. Radio Buttons and Check Boxes . . . . . . . . . . . . . . . . . . . . . 6-16-2. Example of a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-76-3. DDS for a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-96-4. Menu Bar on a Graphical Display Station with Enhanced Interface . 6-106-5. Menu Bar on a Nongraphical Display Station with Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106-6. Menu Bar on a Nongraphical Display Station without Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106-7. Menu Bar on a Display Station without Enhanced Interface . . . . . 6-106-8. Selection Fields on a Graphical Display Station with Enhanced

Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-116-9. Selection Fields on a Nongraphical Display Station . . . . . . . . . . 6-12

6-10. DDS for Single-Choice and Multiple-Choice Selection Fields . . . . 6-13

Copyright IBM Corp. 1997 xxi

6-11. Example of DDS for Horizontal Selection Field . . . . . . . . . . . . 6-146-12. DDS for Suppressing Selection Indicators in a Selection Field . . . 6-176-13. Suppressed Selection Indicators in Selection Field . . . . . . . . . . 6-186-14. Example of a Pull-Down Menu . . . . . . . . . . . . . . . . . . . . . . 6-186-15. DDS for a Pull-Down Menu . . . . . . . . . . . . . . . . . . . . . . . . 6-196-16. Pull-Down Menu on a Graphical Display Station with Enhanced

Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-196-17. Pull-Down Menu on a Nongraphical Display Station with Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-196-18. Pull-Down Menu on a Nongraphical Display Station without

Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-206-19. Pull-Down Menu on a Display without Enhanced Interface . . . . . 6-206-20. DDS for Suppressing Selection Indicators in a Pull-Down Menu . . 6-206-21. Suppressed Selection Indicators on Graphical Display Station . . . 6-216-22. Suppressed Selection Indicators on Nongraphical Display Station . 6-216-23. DDS for Accelerator Keys . . . . . . . . . . . . . . . . . . . . . . . . 6-226-24. Accelerators in a Pull-Down Menu . . . . . . . . . . . . . . . . . . . . 6-226-25. DDS for Menu-Bar Switch Key and Cancel Key . . . . . . . . . . . . 6-236-26. Selection Lists on a Graphical Display Station with Enhanced

Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-256-27. Selection Lists on a Nongraphical Display Station with Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-256-28. DDS for Selection ListsExample . . . . . . . . . . . . . . . . . . . 6-266-29. DDS for Enabling Selection Indicators in a Selection List . . . . . . 6-296-30. Selection Indicators on Graphical Display Station . . . . . . . . . . . 6-296-31. Scroll Bar on a Graphical Display Station with Enhanced Interface . 6-306-32. Scroll Bar on a Nongraphical Display Station with Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-316-33. DDS for Scroll BarsExample . . . . . . . . . . . . . . . . . . . . . . 6-336-34. Push Buttons on a Graphical Display Station with Enhanced

Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346-35. Push Buttons on a Nongraphical Display Station with Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346-36. Push Buttons on a Nongraphical Display Station without Underline

Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-346-37. Push Buttons on a Display Station without Enhanced Interface . . . 6-346-38. DDS for Push ButtonsExample . . . . . . . . . . . . . . . . . . . . 6-356-39. Control Values for the CHCCTL Keyword . . . . . . . . . . . . . . . 6-366-40. DDS to Control the Availability of Choices . . . . . . . . . . . . . . . 6-376-41. Single-Choice Selection Field with an Unavailable Choice . . . . . . 6-376-42. Examples of Valid DDS for Mnemonics . . . . . . . . . . . . . . . . . 6-386-43. Examples of DDS Not Valid for Mnemonics . . . . . . . . . . . . . . 6-386-44. DDS Using CHCAVAIL and CHCSLT for Menu-Bar Choices . . . . 6-406-45. DDS Using CHCAVAIL and CHCUNAVAIL for Selection Fields . . . 6-416-46. DDS Using CHCAVAIL, CHCUNAVAIL, and CHCSLT for Selection

Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-416-47. DDS Using CHCAVAIL, CHCUNAVAIL, and CHCSLT for Single

Choice Selection List Choices . . . . . . . . . . . . . . . . . . . . . . 6-426-48. DDS Using CHCAVAIL, CHCUNAVAIL, and CHCSLT for Multiple

Choice Selection List Choices . . . . . . . . . . . . . . . . . . . . . . 6-426-49. Continued-Entry Fields in Rectangular Arrangement . . . . . . . . . 6-436-50. DDS Using MNUBARDSP on the Application Record . . . . . . . . 6-506-51. DDS Using MNUBARDSP on the Menu-Bar Record . . . . . . . . . 6-526-52. DDS for Pull-Down Input (PULLINPUT) Parameter . . . . . . . . . . 6-54

xxii Application Display Programming V4R1

6-53. DDS for Return-Field Parameter . . . . . . . . . . . . . . . . . . . . . 6-566-54. DDS for Menu-Bar Choice Help . . . . . . . . . . . . . . . . . . . . . 6-576-55. DDS for Single-Selection Field Choice Help . . . . . . . . . . . . . . 6-576-56. A Help List for a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . 6-596-57. Help for a Named Field . . . . . . . . . . . . . . . . . . . . . . . . . . 6-596-58. Help for a Constant Field . . . . . . . . . . . . . . . . . . . . . . . . . 6-596-59. Cursor Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-606-60. Grid Line Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-806-61. DDS for Grid Line StructuresExample . . . . . . . . . . . . . . . . 6-806-62. DDS Coding Before Adding HTML Keyword . . . . . . . . . . . . . . 6-856-63. DDS Coding After Adding HTML Keyword . . . . . . . . . . . . . . . 6-866-64. Graphic Image on an AS/400 5250 Gateway Display . . . . . . . . . 6-8