Application Display Programming

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, Puerto Rico, or Guam, you can order publications through the IBM Software Manufacturing Solutions at 800+879-2755. Publications are not stocked 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 mail your comments to the following address: IBM Corporation Attention Department 542 IDCLERK 3605 Highway 52 N Rochester, MN 55901-7829 USA or you can fax your comments to: United States and Canada: 800+937-3430 Other countries: (+1)+507+253-5192 If you have access to Internet, you can send your comments electronically to [email protected]; IBMMAIL, to IBMMAIL(USIB56RZ). When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate 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 to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

ContentsNotices . . . . . . . . . . . . . . . Programming Interface Information Trademarks . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xxix xxx xxx xxxi xxxi xxxi xxxi xxxiii

About Application Display Programming (SC41-5715) Who Should Use This Book . . . . . . . . . . . . . . . . . Prerequisite and Related Information . . . . . . . . . . . Information Available on the World Wide Web . . . . . .

Summary of Changes to Application Display Programming

Part 1. Building a Sample Display with Online Help InformationChapter 1. Building a Sample Display with Online Help Information. . .

1-1

Part 2. Programming Application Displays Using Display FilesChapter 2. Defining Your Display in a Display File . . . . . . . . . . . . . Establishing a Display File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Determining File Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . Deciding Whether to Describe Data Inside or Outside Your Program . . . Creating a Display File and Description . . . . . . . . . . . . . . . . . . . . Changing the File Description . . . . . . . . . . . . . . . . . . . . . . . . . . Detecting File Description Changes . . . . . . . . . . . . . . . . . . . . . . . Defining Display Fields and Functions in a Record Format . . . . . . . . . . . Understanding the Field Attribute Characters . . . . . . . . . . . . . . . . . Understanding How Record Format Fields Can Be Used . . . . . . . . . . Defining Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Command Attention (CAnn) and Command Function (CFnn) Keys Specifying Alternative Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . Passing Information via Indicators . . . . . . . . . . . . . . . . . . . . . . . Inserting Constant Field Text from a Message Description . . . . . . . . . Allowing for Right-to-Left Cursor Movement . . . . . . . . . . . . . . . . . . Defining Cursor Movement to Input-Capable Positions Only . . . . . . . . Defining Cursor Progression for Entry Fields . . . . . . . . . . . . . . . . . Defining Attributes for Entry Fields . . . . . . . . . . . . . . . . . . . . . . . Protecting Entry Fields Using Edit Masks . . . . . . . . . . . . . . . . . . . Specifying Right-to-Left Display Processing . . . . . . . . . . . . . . . . . . Specifying Word Wrap for Fields . . . . . . . . . . . . . . . . . . . . . . . . Emphasizing Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editing Output Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Your Own Edit Codes . . . . . . . . . . . . . . . . . . . . . . . . . Specifying Valid Screen Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . Enabling Your Display to Be Printed . . . . . . . . . . . . . . . . . . . . . . Defining Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Program-Described Data . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Input-Only Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Output-Only Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copyright IBM Corp. 1997 .

2-1 2-1 . 2-2 . 2-3 . 2-4 . 2-5 . 2-6 . 2-7 . 2-8 . 2-9 2-11 2-12 2-13 2-14 2-16 2-16 2-16 2-17 2-18 2-19 2-19 2-20 2-21 2-22 2-23 2-23 2-24 2-25 2-27 2-27 2-28 2-28.

iii

Defining Input and Output Files

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-28 3-1 3-1 . 3-2 . 3-2 . 3-3 . 3-3 . 3-4 . 3-4 . 3-5 . 3-5 3-30 3-31 3-33 3-40 3-41 3-41 3-43 3-45 3-45 3-49 3-49 3-49 3-50 3-51 3-51 3-52 4-1 . 4-1 . 4-3 4-10 4-12 4-12 4-15 4-15 4-16 4-17 4-19 4-21 4-22 4-23 4-24 4-24 4-24 4-27 4-27 4-31 5-1 5-2 5-2

Chapter 3. Working with Display Files in an Application . . . . . . . Understanding How the System Allocates Resources . . . . . . . . . . . . Opening Display Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Acquiring a Display Station for I/O Operations . . . . . . . . . . . . . . . . Obtaining Information about Display Files and Display Stations . . . . . . Obtaining Information about Open and I/O Operations . . . . . . . . . . Obtaining Attribute Information about Display Stations . . . . . . . . . . Sending and Receiving Data . . . . . . . . . . . . . . . . . . . . . . . . . . Determining Which Record Formats Are Active on a Display . . . . . . Writing Output to the Display . . . . . . . . . . . . . . . . . . . . . . . . Inviting Input to the Display . . . . . . . . . . . . . . . . . . . . . . . . . Reading Invited Input from the Display . . . . . . . . . . . . . . . . . . . Reading Input from the Display . . . . . . . . . . . . . . . . . . . . . . . Writing Output and Reading Input at the Same Time . . . . . . . . . . Canceling Input That Was Not Waited For . . . . . . . . . . . . . . . . . Locking the Keyboard and Positioning the Cursor During I/O Operations Saving Previously Displayed Information . . . . . . . . . . . . . . . . . . Understanding the Effects of I/O Operations on Command Keys . . . . Avoiding Record Format Problems on the 5250 Display Station . . . . Releasing an Acquired Display Station from I/O Operations . . . . . . . . Closing Display Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mapping Display Operations to High-Level Language Operations . . . . . Sharing Display Files in the Same Job . . . . . . . . . . . . . . . . . . . . Understanding the Open Operation for Files Shared in a Job . . . . . . Understanding the Input/Output Operation for Files Shared in a Job . Understanding the Close Operation for Files Shared in a Job . . . . . Chapter 4. Displaying Groups of Records Using Subfiles . . . . . Recognizing Subfile Uses . . . . . . . . . . . . . . . . . . . . . . . . . . Describing Subfiles in Your DDS Source . . . . . . . . . . . . . . . . . Using a Subfile in a Program . . . . . . . . . . . . . . . . . . . . . . . . Requesting I/O Operations for a Subfile . . . . . . . . . . . . . . . . . . Requesting I/O Operations for a Subfile Record Format . . . . . . . Requesting I/O Operations for a Subfile Control Record Format . . Recognizing Subfile I/O Requests in High-Level Languages . . . . Controlling the Appearance of Subfiles . . . . . . . . . . . . . . . . . . Displaying Horizontal Subfiles with Display Modes . . . . . . . . . . . Specifying Subfile Size Equal to Page Size . . . . . . . . . . . . . . . . Specifying Subfile Size Not Equal to Page Size . . . . . . . . . . . . . Checking Validity on Subfile Data . . . . . . . . . . . . . . . . . . . . . Displaying Error Messages from Subfiles . . . . . . . . . . . . . . . . . Positioning the Cursor on the Displayed Subfile . . . . . . . . . . . . . Positioning the Cursor Initially . . . . . . . . . . . . . . . . . . . . . . Positioning the Cursor When a Roll Key Is Used . . . . . . . . . . . Positioning the Cursor When a Fold or Truncate Key Is Used . . . Positioning the Cursor and Rolling When Two or More Records Are Displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Understanding Subfile DDS and Program LogicExample . . . . . . . Chapter 5. Defining Windows with Display Files Window Terminology . . . . . . . . . . . . . . . . . . DDS Window Keywords . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

iv

Application Display Programming V4R1

Window Representation and Hardware Configuration Creating Windows . . . . . . . . . . . . . . . . . . . Window Definition Records . . . . . . . . . . . . Window Reference Records . . . . . . . . . . . . Window Size and Location . . . . . . . . . . . . . Cursor Position . . . . . . . . . . . . . . . . . . . Error Messages . . . . . . . . . . . . . . . . . . . Subfiles . . . . . . . . . . . . . . . . . . . . . . . . DDS Help Records . . . . . . . . . . . . . . . . . Defining Window Borders . . . . . . . . . . . . . . . Border Defaults . . . . . . . . . . . . . . . . . . . Multiple Border Definitions . . . . . . . . . . . . . UIM Help Window Borders . . . . . . . . . . . . . Defining a Window Title . . . . . . . . . . . . . . . . Reading Data from Windows . . . . . . . . . . . . . Changing Window Borders and Contents . . . . . . Moving and Duplicating Windows . . . . . . . . . . Making Two Windows Seem Active at Once . . . . . . . . Making One Window in a Series Stand Out Removing Windows . . . . . . . . . . . . . . . . . . Removing All Windows . . . . . . . . . . . . . . . Removing More Recent Windows . . . . . . . . . Improving Application Performance . . . . . . . . . System Save and Restore Operations . . . . . . Bypassing System Save and Restore Operations Programming Examples . . . . . . . . . . . . . . . . Using Basic Window Functions . . . . . . . . . . Defining Windows in a Separate Display File . . . . . . . . . . . . . . . . . RPG Program Source RPG Program Source for WINPGM . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5-3 . 5-3 . 5-3 . 5-3 . 5-4 . 5-5 . 5-6 . 5-6 . 5-7 . 5-7 . 5-7 . 5-8 . 5-9 . 5-9 5-10 5-10 5-11 5-11 5-12 5-12 5-13 5-13 5-13 5-13 5-14 5-15 5-16 5-20 5-21 5-22 6-1 6-1 . 6-1 . 6-4 . 6-5 . 6-7 . 6-7 . 6-8 . 6-8 6-10 6-12 6-13 6-14 6-14 6-15 6-16 6-17 6-18 6-20 6-21 6-22 6-23 6-24

Chapter 6. Creating a Graphical Look for Displays . . . . . . . . . . . . . . . . . . . . Factors Affecting the Graphical Look . . . . . . . . . . . . . . . . . . . . . Hardware Configuration Enhanced Display Parameter . . . . . . . . . . . . . . . . . . DDS Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Menu Bars . . . . . . . . . . . . . . . . . . . . . . . . . Defining the Menu-Bar Choices . . . . . . . . . . . . . . . . . Suppressing the Menu-Bar Separator . . . . . . . . . . . . . Defining the Menu-Bar Separator . . . . . . . . . . . . . . . . Selection FieldsOverview . . . . . . . . . . . . . . . . . . . . . DDS for Selection FieldsExample . . . . . . . . . . . . . . Creating a Vertical Single-Choice Selection Field . . . . . . . Creating a Vertical Multiple-Choice Selection Field . . . . . . Creating a Horizontal Selection Field . . . . . . . . . . . . . . Cursor Movement in a Vertical Selection Field . . . . . . . . Cursor Movement in a Horizontal Selection Field . . . . . . . Controlling the Selection Indicators in a Selection Field . . . Creating Pull-Down Menus Using Single-Choice Selection Fields Controlling the Selection Indicators in a Pull-Down Menu . . Defining Accelerator Keys . . . . . . . . . . . . . . . . . . . . Defining a Menu-Bar Switch Key . . . . . . . . . . . . . . . . Defining a Cancel Key . . . . . . . . . . . . . . . . . . . . . . Limiting Function When Cursor is Outside a Pull-Down Menu

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

v

Selection ListsOverview . . . . . . . . . . . . . . . . . . . . . . . DDS for Selection ListsExample . . . . . . . . . . . . . . . . Creating Selection Lists . . . . . . . . . . . . . . . . . . . . . . Controlling the Selection Indicators in a Selection List . . . . . Scroll BarsOverview . . . . . . . . . . . . . . . . . . . . . . . . . Creating a Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . DDS for Scroll BarsExample . . . . . . . . . . . . . . . . . . Scroll Bar Operation . . . . . . . . . . . . . . . . . . . . . . . . Push ButtonsOverview . . . . . . . . . . . . . . . . . . . . . . . DDS for Push ButtonsExample . . . . . . . . . . . . . . . . . Creating Push Buttons . . . . . . . . . . . . . . . . . . . . . . . Controlling the Availability of Choices . . . . . . . . . . . . . . . . Auto-Selection in Single-Choice Selection Fields . . . . . . . . . Auto-Enter in Single-Choice Selection Fields . . . . . . . . . . . . Defining Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Choice Colors and Attributes . . . . . . . . . . . . . . . . Continued-Entry FieldsOverview . . . . . . . . . . . . . . . . . . Specifying Word Wrap on Continued-Entry Fields . . . . . . . DBCS Considerations with Continued-Entry Fields . . . . . . . How DBCS Data is Returned for Continued-Entry Fields . . . Keyboard Functions with Continued-Entry Fields . . . . . . . . Forward Field-Exit Processing . . . . . . . . . . . . . . . . . . . Backward Field-Exit Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . How the Menu Bar Interacts with the Application Defining the MNUBARDSP Keyword on the Application Record Defining the MNUBARDSP Keyword on the Menu-Bar Record Receiving Input from the Pull-Down Menus . . . . . . . . . . . Removing a Pull-Down Menu after Receiving Input . . . . . . Updating a Pull-Down Menu before Displaying . . . . . . . . . Defining Application Help . . . . . . . . . . . . . . . . . . . . . . . Defining Choice-Level Help . . . . . . . . . . . . . . . . . . . . Defining Help for a Field . . . . . . . . . . . . . . . . . . . . . . Key Interaction for Menu Bars and Pull-Down Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cursor Movement Pressing the Tab Key . . . . . . . . . . . . . . . . . . . . . . . . Pressing the Cursor Keys . . . . . . . . . . . . . . . . . . . . . Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . Using the MNUBARDSP Keyword on the Application Record . Using the MNUBARDSP Keyword on the Menu-Bar Record . How the Displays Look . . . . . . . . . . . . . . . . . . . . . . . Simple Hotspots . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Key Emulation . . . . . . . . . . . . . . . . . . . . . Page Up and Page Down Key Emulation . . . . . . . . . . . . Programmable Mouse ButtonsOverview . . . . . . . . . . . . . Pointer Device Events . . . . . . . . . . . . . . . . . . . . . . . AID Codes to be Returned . . . . . . . . . . . . . . . . . . . . . Programmable Mouse ButtonsBenefits . . . . . . . . . . . . Programmable Mouse Buttons Operation . . . . . . . . . . . . Programmable Mouse ButtonsNWS Considerations . . . . . Programmable Mouse ButtonsEvent Processing States . . . Programmable Mouse ButtonsEvent Processing Priority . . Grid Line StructuresOverview . . . . . . . . . . . . . . . . . . . DDS for Grid Line StructuresExample . . . . . . . . . . . . . Grid Line Structures and Windows . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6-24 6-26 6-26 6-28 6-30 6-31 6-33 6-33 6-34 6-35 6-35 6-36 6-37 6-38 6-38 6-39 6-42 6-43 6-43 6-44 6-44 6-49 6-49 6-50 6-50 6-51 6-53 6-55 6-55 6-56 6-56 6-59 6-60 6-61 6-61 6-62 6-62 6-62 6-65 6-67 6-68 6-68 6-69 6-69 6-69 6-70 6-70 6-71 6-72 6-72 6-73 6-79 6-80 6-81

vi


Hardware Requirements for Grid Line Structures Inserting HTML Tags . . . . . . . . . . . . . . . . . . Resolving HTML Field Overlap . . . . . . . . . . Programming Examples . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6-82 6-82 6-83 6-85 7-1 7-1 7-1 7-3 7-3 7-4 7-5 7-6 7-6 7-6 7-6 7-9

Chapter 7. Overriding Display Files and Display File Attributes . . . Determining Whether or Not to Use Overrides . . . . . . . . . . . . . . . . Overriding File Attributes in HLL Programs . . . . . . . . . . . . . . . . . . Overriding File Names in HLL Programs . . . . . . . . . . . . . . . . . . . Overriding Both File Names and Attributes in HLL Programs . . . . . . . Applying Overrides When Compiling a Program . . . . . . . . . . . . . . . Deleting Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displaying Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using File Redirection to Override File Names and Libraries or File Types Overriding Files with the Same File Types . . . . . . . . . . . . . . . . . Overriding Files with Different File Types . . . . . . . . . . . . . . . . . Recognizing Commands That Ignore or Restrict Overrides . . . . . . . . .

Chapter 8. Handling Messages and Errors for Display Files . . . . . . . . 8-1 Creating and Displaying Your Own Messages . . . . . . . . . . . . . . . . . . . 8-1 . . . . . . . . . . . . . . . . . . 8-2 Displaying a Message on the Message Line Displaying a Message on the Message Line When a Subfile Control Record is Written . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Displaying a Message on the Message Line Using a Message Field . . . . 8-3 Priorities for Displaying Messages on a Message Line . . . . . . . . . . . . 8-3 Displaying Messages in a Field on the Display . . . . . . . . . . . . . . . . . 8-3 Displaying Messages on a Program Message Queue . . . . . . . . . . . . . 8-4 Displaying Error Messages through a Subfile . . . . . . . . . . . . . . . . . . 8-4 Sounding an Alarm for Messages . . . . . . . . . . . . . . . . . . . . . . . . . 8-7 Automatically Handling Permanent I/O Errors on Display Stations . . . . . . 8-7 Analyzing Error Messages Sent from the System . . . . . . . . . . . . . . . . . 8-8 Understanding Messages and Message Monitors . . . . . . . . . . . . . . . 8-9 Understanding Major/Minor Return Codes . . . . . . . . . . . . . . . . . . . 8-10 Recovering from Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11 Chapter 9. Creating and Accessing Menus Using Display Files . . Running System and User-Defined Menus . . . . . . . . . . . . . . . . . Returning to a Menu after Running the GO command . . . . . . . . . Determining the Previous Menu . . . . . . . . . . . . . . . . . . . . . . Using the Cancel and Exit Keys on Menus . . . . . . . . . . . . . . . Choosing the Menu That Is Shown at Sign-On Time . . . . . . . . . . Defining Your Own Display File Menus . . . . . . . . . . . . . . . . . . . Understanding DDS and Display File Considerations for Menus . . . Describing Menu Actions in a Message File . . . . . . . . . . . . . . . Naming Help Formats for Menus . . . . . . . . . . . . . . . . . . . . . Building a Display File Menu . . . . . . . . . . . . . . . . . . . . . . . Defining Your Own Program Menus . . . . . . . . . . . . . . . . . . . . . Passing Parameters for Program Menus . . . . . . . . . . . . . . . . . Building a Program Menu . . . . . . . . . . . . . . . . . . . . . . . . . Exiting from a Program Menu without Returning to the Previous Menu Avoiding Menu Name Conflict . . . . . . . . . . . . . . . . . . . . . . . . Naming Your Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . Placing Your Menu in a Higher Library in the Library List . . . . . . . Specifying the Library That Contains the Menu . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9-1 9-1 . 9-1 . 9-1 . 9-2 . 9-3 . 9-4 . 9-4 . 9-5 . 9-6 . 9-7 9-10 9-10 9-11 9-13 9-15 9-15 9-16 9-16

Contents

vii

Using the Generic Menu Specification . . . . . . . . . . . . . . Changing the Command Default after Duplicating a Command Displaying Menu Attributes . . . . . . . . . . . . . . . . . . . . . . Changing Menu Attributes . . . . . . . . . . . . . . . . . . . . . . . Deleting Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 10. Using User-Defined Data Streams . . Understanding Display Station Differences . . . . . . Understanding User-Defined Data Stream Limitations Chapter 11. Passing Data between Programs Passing Data in the Same Routing Step in a Job Passing Data between Routing Steps in a Job .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9-16 9-16 9-16 9-16 9-17 10-1 10-1 10-2 11-1 11-1 11-3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 12. Waiting for Input from a Display File, an ICF File, and a Data Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 13. Using Alternative Character Sets and Code Pages Specifying Character Translation for Fields . . . . . . . . . . . . . . . Determining the Character Identifier (CHRID) Value for Your Display

. . .

12-1 13-1 13-2 13-4 14-1 14-1 14-1 14-1 14-2 14-2 14-2 14-3 14-3 14-3 14-4

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

Part 3. Programming Application Displays Using Panel GroupsChapter 15. Improving Productivity with User Interface Manager . . . . . . . . . . . . . . . . . . . . . . . Increasing User Productivity Increasing Application Programmer Productivity . . . . . . . . . . . . What to Consider before Using UIM Instead of Data Description Specifications (DDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 16. Introduction to the User Interface Manager Overview of UIM . . . . . . . . . . . . . . . . . . . . . . . . What the UIM Supports . . . . . . . . . . . . . . . . . . . . What Is a Panel Group . . . . . . . . . . . . . . . . . . . . What Is a Menu . . . . . . . . . . . . . . . . . . . . . . . . . Creating Objects . . . . . . . . . . . . . . . . . . . . . . . . Elements Within a Panel Group . . . . . . . . . . . . . . . Using the UIM Language Tags . . . . . . . . . . . . . . . . Using Dialog Commands . . . . . . . . . . . . . . . . . . . Using Control Language (CL) Commands . . . . . . . . . Using an Application Programming Interface (API) . . . . Defining a Menu Object Using UIM . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .

15-1 15-1 15-1 15-1 16-1 16-1 16-2 16-2 16-2 16-3 16-3 16-4 16-4 16-5 16-5 16-6

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

viii


Creating a Menu Panel . . . . . . . . . . . . . . . . . . . . Required Tags for a Menu Panel . . . . . . . . . . . . . Source for Example Menu . . . . . . . . . . . . . . . . . Defining a Panel Group Object Using UIM . . . . . . . . . Creating a List Panel . . . . . . . . . . . . . . . . . . . . . . Required Tags for a List Panel . . . . . . . . . . . . . . Source for Example List Panel . . . . . . . . . . . . . . Application Programming for a List Panel . . . . . . . . Creating a Confirmation List Panel . . . . . . . . . . . . . . Required Tags for a Confirmation List Panel . . . . . . Source for Example Confirmation Panel . . . . . . . . . Automatic Confirmation Processing . . . . . . . . . . . . Application Programming for Confirmation Processing . Creating a Data Presentation Panel . . . . . . . . . . . . . Required Tags for a Data Presentation Panel . . . . . . Source for Example Data Presentation Panel . . . . . . Application Programming for a Data Presentation Panel Data Entry Panel . . . . . . . . . . . . . . . . . . . . . . Creating a Panel with a Menu Bar . . . . . . . . . . . . . . Required Tags for a Panel with a Menu Bar . . . . . . . Source for Example Panel with a Menu Bar . . . . . . . Application Programming for a Menu Bar Panel . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16-6 16-8 16-9 16-13 16-13 16-16 16-17 16-25 16-27 16-28 16-28 16-31 16-31 16-32 16-34 16-35 16-46 16-49 16-50 16-52 16-53 16-63 17-1 17-1 17-1 17-3 17-3 17-4 17-4 17-5 17-7 17-8 17-8 17-8 17-9 17-9 17-10 17-10 17-11 17-11 17-13 17-13 17-14 17-14 17-14 17-15 17-15 17-15 17-16 17-16 17-16 17-16 17-16

Chapter 17. Details of Using User Interface Manager . . . . . . . Opening a UIM Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Dialog Variables Restrictions on Using Dialog Variables . . . . . . . . . . . . . . . . Dialog Variable Error Messages . . . . . . . . . . . . . . . . . . . . Providing Field Values for a Display Panel Using Dialog Variables Using Variable Pool Services . . . . . . . . . . . . . . . . . . . . . Character Set and Code Page Considerations . . . . . . . . . . . Managing a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Initializing a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Updating a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Incomplete List Processing . . . . . . . . . . . . . . . . . . . . . . . Removing and Inserting an Entry from a List . . . . . . . . . . . . Controlling List Entries on a List Display . . . . . . . . . . . . . . . Improving Interactive Response Time for a List Display . . . . . . Using Action Lists and Selection Lists . . . . . . . . . . . . . . . . Using Selection Characters . . . . . . . . . . . . . . . . . . . . . . Managing Panel Functions . . . . . . . . . . . . . . . . . . . . . . . . Enabling Conversion to a GUI . . . . . . . . . . . . . . . . . . . . . . Scrolling Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Scrollable Areas . . . . . . . . . . . . . . . . . . . . . . . Defining Function Key Scrolling . . . . . . . . . . . . . . . . . . . . Scrolling and Error Conditions . . . . . . . . . . . . . . . . . . . . . Scrolling a List Area . . . . . . . . . . . . . . . . . . . . . . . . . . Scrolling a Menu Area . . . . . . . . . . . . . . . . . . . . . . . . . Scrolling an Information Area . . . . . . . . . . . . . . . . . . . . . Scrolling Data Item Groups . . . . . . . . . . . . . . . . . . . . . . Scrolling a Text Area . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Contextual Help . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

ix

Command Line Restrictions . . . . . . . . . . . . . . . . . . . . . Command Line Interpretation . . . . . . . . . . . . . . . . . . Entering Commands That Are Too Long . . . . . . . . . . . . Defining Function Keys . . . . . . . . . . . . . . . . . . . . . . . Formatting Function Keys . . . . . . . . . . . . . . . . . . . . Handling Function Keys and VARUPD Value . . . . . . . . . Panel Formatting Concepts . . . . . . . . . . . . . . . . . . . . . When Panel Formatting Is Performed . . . . . . . . . . . . . Application Control of Panel Formatting . . . . . . . . . . . . Limits of the Panel Formatter . . . . . . . . . . . . . . . . . . Folding Up Multiple Panels When EXIT Is Requested . . . . . . Folding Up a List Panel . . . . . . . . . . . . . . . . . . . . . . . Adding a Pop-Up Window over Another Panel . . . . . . . . Using Menu Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . Differences Between Pull-Down Menus and Pop-Up Windows Using Pop-Up Windows . . . . . . . . . . . . . . . . . . . . . . . Defining Application Windows . . . . . . . . . . . . . . . . . . Adding and Removing Windows . . . . . . . . . . . . . . . . Using the Command Line in a Window . . . . . . . . . . . . . UIM as a Request Processor Program When Displaying a Panel Printing Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . Printing a Print Head Panel . . . . . . . . . . . . . . . . . . . Printing a Print Panel . . . . . . . . . . . . . . . . . . . . . . . Using Blank Lines for Separating . . . . . . . . . . . . . . . . Fonts and Highlighting . . . . . . . . . . . . . . . . . . . . . . Printing the Trailer . . . . . . . . . . . . . . . . . . . . . . . . . Defining Prolog Areas . . . . . . . . . . . . . . . . . . . . . . Defining Header Areas . . . . . . . . . . . . . . . . . . . . . . Using the Page-Eject Function During Printing . . . . . . . . Sharing and Overriding Printer Files . . . . . . . . . . . . . . Printing Double-Byte Character Set (DBCS) Considerations Commonly Asked UIM Questions . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17-19 17-19 17-20 17-20 17-20 17-21 17-22 17-22 17-23 17-24 17-24 17-26 17-27 17-27 17-28 17-30 17-30 17-31 17-32 17-33 17-33 17-35 17-35 17-36 17-36 17-36 17-36 17-36 17-37 17-37 17-37 17-37

Part 4. Programming Help DisplaysChapter 18. Making Online Help Information Accessible for Your Display File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enabling the Help Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Choosing between Panel Groups, Documents, and Records for Help . . Defining Which Areas of Your Display Need Online Help Information . . . Specifying Panel Groups for Help in Your Display File . . . . . . . . . . . Copying QUSRTOOL Examples That Specify Help Using Panel Groups Specifying Documents in Your Display File . . . . . . . . . . . . . . . . . . Specifying Records in Your Display File . . . . . . . . . . . . . . . . . . . . Entering the Records That Contain the Help Information . . . . . . . . Using Records and Documents for Help in the Same Display File . . . Understanding the Restrictions on Records . . . . . . . . . . . . . . . . Paging between Help Displays That Use Records . . . . . . . . . . . . Returning Control to Your Program after Pressing the Help Key . . . . . Returning Control to Your Program after Showing the Help Display . . Returning Control to Your Program without Showing the Help Display Chapter 19. Making Online Help Accessible for Your Panel Group. . . . . . . . . . . . . . . . . . . . .

18-1 18-2 18-2 18-3 18-6 18-9 18-9 18-12 18-14 18-15 18-15 18-16 18-20 18-20 18-22 19-1

. . .

x


Definitions and Explanations Help in a List Area . . . . . Coding Help . . . . . . . Help in a Menu Area . . . . Coding Help . . . . . . . Help in a Data Area . . . . Coding Help . . . . . . . Help in a Menu Bar Area . Coding Help . . . . . . . Help in a Function Key Area Coding Help . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

19-1 19-5 19-6 19-7 19-7 19-9 19-10 19-13 19-14 19-15 19-16 20-1 20-1 20-1 20-15 20-16 20-16 20-18 20-18 20-18 20-19 20-19

Chapter 20. Defining Online Help Information . . . . . . . . . . . . Defining Online Help Information in a Panel Group . . . . . . . . . . . Entering the UIM Source for a Panel Group for Help . . . . . . . . . Creating and Deleting Panel Groups . . . . . . . . . . . . . . . . . . Assigning Panel Groups as Help for Commands . . . . . . . . . . . Using Panel Groups in a Search Index . . . . . . . . . . . . . . . . . Copying QUSRTOOL Examples That Define Help in a Panel Group Defining Online Information in a Document . . . . . . . . . . . . . . . . Creating a Document for Help . . . . . . . . . . . . . . . . . . . . . . Viewing the Document without Pressing the Help Key . . . . . . . . Defining Online Help Information in a DDS Record . . . . . . . . . . .

Part 5. Guidelines for IBM AS/400-Style DisplaysChapter 21. Designing IBM AS/400-Style Displays . . . . . . . . . . Using the Displays Example in the QUSRTOOL Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Recognizing the Example Objects Installing the Example Objects . . . . . . . . . . . . . . . . . . . . . . Viewing the Sample Displays, Command, and Online Help Information Copying the Source for the Example Objects for Your Own Use . . . Defining Special Functions and Attributes for All Displays . . . . . . . . Designing the Single-Choice Menu Display . . . . . . . . . . . . . . . . . Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Selection Entry Field . . . . . . . . . . . . . . . . . . . . . . . . Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . General Menu Display Operation . . . . . . . . . . . . . . . . . . . . . Designing the Entry Display . . . . . . . . . . . . . . . . . . . . . . . . . . Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prompt Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Help Information . . . . . . . . . . . . . . . . . . . . . . . . . . General Entry Display Operation . . . . . . . . . . . . . . . . . . . . . Designing the Information Display . . . . . . . . . . . . . . . . . . . . . . Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Location Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prompt Area 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prompt Area 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21-1 21-1 21-1 21-4 21-4 21-7 21-8 21-8 21-9 21-9 21-9 21-10 21-10 21-10 21-10 21-11 21-11 21-12 21-12 21-17 21-17 21-17 21-17 21-19 21-19 21-19 21-20

Contents

xi

Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . Online Help Information . . . . . . . . . . . . . . . . . . . General Information Display Operation . . . . . . . . . . . Designing the List Display . . . . . . . . . . . . . . . . . . . . Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prompt Area . . . . . . . . . . . . . . . . . . . . . . . . . . Instruction Line . . . . . . . . . . . . . . . . . . . . . . . . Options Line . . . . . . . . . . . . . . . . . . . . . . . . . . Column Headings . . . . . . . . . . . . . . . . . . . . . . . Extended Action Entry Area . . . . . . . . . . . . . . . . . List Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . Paging Location Information . . . . . . . . . . . . . . . . . Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . Online Help Information . . . . . . . . . . . . . . . . . . . General List Display Operation . . . . . . . . . . . . . . . Defining the Function Key Area for All Displays . . . . . . . Optional Command Line and Identifier Field . . . . . . . . . . . . . . . . . . . . . . . . . Common Key Assignments Defining Help Information for All Displays . . . . . . . . . . . Help for the Menu Display . . . . . . . . . . . . . . . . . . Help for the Entry Display . . . . . . . . . . . . . . . . . . Help for the Information Display . . . . . . . . . . . . . . . Help for the List Display . . . . . . . . . . . . . . . . . . . Defining and Presenting Messages . . . . . . . . . . . . . . Designing Common User Access (CUA) Entry Level Models Entry Dialog Actions . . . . . . . . . . . . . . . . . . . . . Single-Choice Selection (Menu) . . . . . . . . . . . . . . . Entry Display . . . . . . . . . . . . . . . . . . . . . . . . . . Information Display . . . . . . . . . . . . . . . . . . . . . . List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . Help Information . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21-20 21-20 21-20 21-21 21-21 21-22 21-22 21-22 21-23 21-24 21-24 21-24 21-25 21-25 21-25 21-26 21-33 21-34 21-38 21-44 21-44 21-46 21-47 21-48 21-49 21-50 21-51 21-52 21-53 21-55 21-55 21-57

Part 6. AppendixesAppendix A. UIM Panel Group Definition Language Panel Group Organization . . . . . . . . . . . . . . . Name Syntax . . . . . . . . . . . . . . . . . . . . . . Symbols . . . . . . . . . . . . . . . . . . . . . . . . . Comments . . . . . . . . . . . . . . . . . . . . . . . . Imbeds . . . . . . . . . . . . . . . . . . . . . . . . . . DBCS Graphic Literals . . . . . . . . . . . . . . . . . Hexadecimal Literals . . . . . . . . . . . . . . . . . . APPFMT (Application Formatted Area) . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . Application Formatted Data . . . . . . . . . . . . . . Example: Application Formatted Area . . . . . . . . BOTINST (Bottom Instruction) . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . CHECK (Validity Checking) . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A-1 A-4 A-4 A-5 A-6 A-6 A-6 A-6 A-8 A-8 A-8 A-9 A-9 A-10 A-10 A-10 A-11 A-11

xii


Optional Attributes . . . . . . . . . . . . . . . . . . . . . . Example: Validity Checking . . . . . . . . . . . . . . . . CIT (Title Citation) . . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . Example: Title Citations . . . . . . . . . . . . . . . . . . CLASS (Class Definition) . . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . Example: Class Definitions . . . . . . . . . . . . . . . . Display Forms of Numeric Values . . . . . . . . . . . . . Display Forms of Character, Date, and Time Values . . CMDLINE (Command Line) . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . COND (Condition Definition) . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . . Example: Conditioning an Option . . . . . . . . . . . . . COPYR (Copyright) . . . . . . . . . . . . . . . . . . . . . . Required Text . . . . . . . . . . . . . . . . . . . . . . . . DATA (Data Presentation Area) . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . Print Formatting Considerations . . . . . . . . . . . . . . Example 1: Data Entry Panel . . . . . . . . . . . . . . . Example 2: Two-Column Format in a Data Entry Panel Example 3: Two Presentation Areas for Data Items . . Example 4: Data Presentation Area with a Menu Area Example 5: Data Entry Panel with a Nested Data Group DATAC (Data Item Choices) . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . DATACOL (Data Column) . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . DATAGRP (Data Group) . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . DATAI (Data Item) . . . . . . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . DATAIX (Data Item Extender) . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . DATASLT (Data Selection Field) . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . Example 1: Data Entry Panel . . . . . . . . . . . . . . . Example 2: Multiple-Selection Field . . . . . . . . . . . DATASLTC (Data Selection Field Choice) . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A-11 A-12 A-13 A-13 A-13 A-14 A-14 A-18 A-24 A-24 A-25 A-26 A-26 A-26 A-26 A-27 A-27 A-28 A-29 A-30 A-30 A-31 A-32 A-32 A-33 A-33 A-34 A-34 A-35 A-36 A-36 A-38 A-38 A-38 A-39 A-39 A-39 A-40 A-40 A-41 A-42 A-42 A-43 A-45 A-47 A-47 A-48 A-51 A-51 A-51 A-52 A-53 A-53 A-55

Contents

xiii

Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . DL (Definition List) . . . . . . . . . . . Optional Attribute . . . . . . . . . . Required Tags . . . . . . . . . . . . Optional Tags . . . . . . . . . . . . Example 1: Definition List . . . . . Example 2: Compact Definition List FIG (Figure) . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . Optional Tag . . . . . . . . . . . . . Example: Sample Figure . . . . . HELP (Help Module) . . . . . . . . . . Required Attribute . . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . Example: Help Panel Definition . . HP0 through HP9 (Highlighted Phrase) Optional Text . . . . . . . . . . . . . H1 through H4 (Heading) . . . . . . . Required Text . . . . . . . . . . . . Example: Heading Tags . . . . . . IMHELP (Imbed Help) . . . . . . . . . Required Attribute . . . . . . . . . . Example: Imbedded Help . . . . . IMPORT (Import) . . . . . . . . . . . . Required Attributes . . . . . . . . . Optional Attributes . . . . . . . . . . INFO (Information Area) . . . . . . . . Required Attribute . . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . Print Formatting Considerations . . ISCH (Index Search) . . . . . . . . . . Required Attribute . . . . . . . . . . Required Text . . . . . . . . . . . . Example: Index Search . . . . . . ISCHSUBT (Index Search Subtopic) . Required Attribute . . . . . . . . . . Example: Index Search Hierarchy ISCHSYN (Index Search Synonym) . Required Attribute . . . . . . . . . . Required Text . . . . . . . . . . . . Example: Index Search Synonyms KEYI (Key List Item) . . . . . . . . . . Required Attributes . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . Example: Key Definitions . . . . . KEYL (Key List) . . . . . . . . . . . . . Required Attribute . . . . . . . . . . Optional Attribute . . . . . . . . . . Example: Key List . . . . . . . . . LINES (Unformatted Lines) . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


xiv


Optional Text . . . . . . . . . . . . . . . . . . . . . . . . Example: Unformatted Lines . . . . . . . . . . . . . . LINK (Hypertext Link Definition) . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . Conditional Expressions . . . . . . . . . . . . . . . . . Bidirectional Considerations . . . . . . . . . . . . . . . Example: Hypertext Link . . . . . . . . . . . . . . . . . LIST (List Area) . . . . . . . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . Print Formatting Considerations . . . . . . . . . . . . . Example 1: List Area . . . . . . . . . . . . . . . . . . . Example 2: List Area with Three Layout Columns . . Example 3: List Area with List Column Groups . . . . Example 4: Dynamic List Column Heading Formatting LISTACT (List Action) . . . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . Confirmation Panel Requirements . . . . . . . . . . . Confirmation Panel Conventions . . . . . . . . . . . . Example: List Actions . . . . . . . . . . . . . . . . . . LISTCOL (List Column) . . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . Formatting Considerations . . . . . . . . . . . . . . . . LISTDEF (List Definition) . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . LISTGRP (List Column Group) . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . Example: List Column Group . . . . . . . . . . . . . . LISTVIEW (List View) . . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . LP (List Part) . . . . . . . . . . . . . . . . . . . . . . . . . Example: List Part . . . . . . . . . . . . . . . . . . . . MBAR (Menu Bar) . . . . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . Example: Menu Bar . . . . . . . . . . . . . . . . . . . MBARC (Menu Bar Choice) . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . Required Text . . . . . . . . . . . . . . . . . . . . . . . MENU (Menu Area) . . . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . Example 1: Simple Menu Area . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A-77 . A-77 . A-78 . A-78 . A-78 . A-79 . A-80 . A-80 . A-82 . A-83 . A-83 . A-85 . A-86 . A-86 . A-87 . A-87 . A-88 . A-90 . A-90 . A-91 . A-94 . A-94 . A-94 . A-95 . A-96 . A-96 . A-97 . A-99 . A-99 A-100 A-100 A-100 A-103 A-103 A-103 A-104 A-104 A-105 A-105 A-105 A-107 A-107 A-108 A-108 A-108 A-108 A-110 A-110 A-110 A-111 A-111 A-111 A-112 A-112

Contents

xv

Example 2: Menu Area with Groups MENUGRP (Menu Group) . . . . . . . Optional Attribute . . . . . . . . . . Optional Text . . . . . . . . . . . . . MENUI or MI (Menu Item) . . . . . . . Required Attributes . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . NT or NOTE (Note) . . . . . . . . . . Optional Text . . . . . . . . . . . . . Example: Using a Note . . . . . . OL (Ordered List) . . . . . . . . . . . . Optional Attribute . . . . . . . . . . Required Tag . . . . . . . . . . . . Example: Ordered List . . . . . . . OPTLINE (Option Line) . . . . . . . . Optional Attribute . . . . . . . . . . Optional Text . . . . . . . . . . . . . P (Paragraph) . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . Example: Paragraph Tag . . . . . PANEL (Display Panel) . . . . . . . . Required Attributes . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . Example: Panel Definition . . . . . PARML (Parameter List) . . . . . . . Required Tags . . . . . . . . . . . . . . . . . Example: Parameter List PC (Paragraph Continuation) . . . . . Example: Paragraph Continuation PDACCEL (Pull-Down Accelerator) . Required Text . . . . . . . . . . . . PDFLD (Pull-Down Field) . . . . . . . Optional Attribute . . . . . . . . . . PDFLDC (Pull-Down Field Choice) . . Required Attributes . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . Confirmation Panel Requirements Confirmation Panel Conventions . PK (Programming Keyword) . . . . . Optional Attribute . . . . . . . . . . Required Text . . . . . . . . . . . . PNLGRP (Panel Group) . . . . . . . . Optional Attributes . . . . . . . . . . PRTHEAD (Print Head Panel) . . . . Required Attribute . . . . . . . . . . Optional Attributes . . . . . . . . . . Optional Text . . . . . . . . . . . . . Layout of the Title Lines . . . . . . Example: Print Title Line . . . . . PRTPNL (Print Panel) . . . . . . . . . Required Attribute . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


xvi


Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . PRTTRAIL (Print Trailer Message) . . . . . . . . . . . . . . . . . Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Trailer Message . . . . . . . . . . . . . . . . . . . . PV (Programming Variable) . . . . . . . . . . . . . . . . . . . . . Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . RT (Reverse Text) . . . . . . . . . . . . . . . . . . . . . . . . . . Example 1: Left-to-Right Formatting on a Right-to-Left Panel Example 2: Left-to-Right Formatting on a Left-to-Right Panel SL (Simple List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . Required Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Simple Lists . . . . . . . . . . . . . . . . . . . . . . TEXT (Text Area) . . . . . . . . . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . Cursor positioning . . . . . . . . . . . . . . . . . . . . . . . . . Text Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Text area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TI (Translation List Item) Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . TL (Translation List) . . . . . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Examples: Translation List TOPINST (Top Instruction) . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . Optional Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . TT (Truth Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . Example: Truth Table . . . . . . . . . . . . . . . . . . . . . . TTROW (Truth Table Row) . . . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . UL (Unordered List) . . . . . . . . . . . . . . . . . . . . . . . . . Optional Attribute . . . . . . . . . . . . . . . . . . . . . . . . . Required Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Unordered Lists . . . . . . . . . . . . . . . . . . . . VAR (Variable Definition) . . . . . . . . . . . . . . . . . . . . . . Required Attribute . . . . . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . Dialog Variables Defined by UIM . . . . . . . . . . . . . . . . VARRCD (Variable Record Definition) . . . . . . . . . . . . . . . Required Attributes . . . . . . . . . . . . . . . . . . . . . . . . Optional Attributes . . . . . . . . . . . . . . . . . . . . . . . . . XH1 through XH4 (Extended Help Headings) . . . . . . . . . . Required Text . . . . . . . . . . . . . . . . . . . . . . . . . . . Formatting Rules . . . . . . . . . . . . . . . . . . . . . . . . . Example: Sample Headings . . . . . . . . . . . . . . . . . . . XMP (Example) . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Formatting an Example . . . . . . . . . . . . . . . Appendix B. UIM Dialog Commands The VARUPD Attribute . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A-146 A-146 A-148 A-148 A-148 A-149 A-149 A-150 A-150 A-151 A-152 A-152 A-152 A-153 A-154 A-154 A-155 A-155 A-155 A-157 A-158 A-158 A-158 A-159 A-159 A-159 A-161 A-161 A-161 A-162 A-162 A-162 A-163 A-163 A-164 A-164 A-165 A-165 A-166 A-166 A-166 A-166 A-169 A-169 A-169 A-170 A-170 A-170 A-170 A-171 A-171 B-1 B-4

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

xvii

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

B-4 B-4 B-6 B-6 B-7 B-7 B-7 B-8 B-8 B-9 B-9 B-9 B-9 B-9 B-10 B-10 B-10 B-11 B-11 B-11 B-12 B-12 B-13 B-14 B-14 B-14 C-1 C-1 C-4 C-6 C-6 C-9 C-12 D-1 D-1 D-1 D-3 D-3 D-4 D-4 D-4 D-4 D-4 D-5 D-5 D-5 D-5 D-6 D-6 D-6 D-6 D-6

Appendix C. Feedback Area Layouts for Display Files Open Feedback Area . . . . . . . . . . . . . . . . . . . . . Device Definition List . . . . . . . . . . . . . . . . . . . . I/O Feedback Area . . . . . . . . . . . . . . . . . . . . . . . Common I/O Feedback Area . . . . . . . . . . . . . . . I/O Feedback Area for Display Files . . . . . . . . . . . Get Attributes . . . . . . . . . . . . . . . . . . . . . . . .

Appendix D. Double-Byte Character Set Support for Displays Double-Byte Character Set Fundamentals . . . . . . . . . . . . . DBCS Code Scheme . . . . . . . . . . . . . . . . . . . . . . . . Shift-Control Characters . . . . . . . . . . . . . . . . . . . . . . Using Double-Byte Data . . . . . . . . . . . . . . . . . . . . . . Double-Byte Character Size . . . . . . . . . . . . . . . . . . . . Processing Double-Byte Characters . . . . . . . . . . . . . . . . . Basic Characters . . . . . . . . . . . . . . . . . . . . . . . . . . Extended Characters . . . . . . . . . . . . . . . . . . . . . . . . What Happens When Extended Characters Are Not Processed Device File Support . . . . . . . . . . . . . . . . . . . . . . . . . . What a DBCS File Is . . . . . . . . . . . . . . . . . . . . . . . . When to Indicate a DBCS File . . . . . . . . . . . . . . . . . . . How to Indicate a DBCS File . . . . . . . . . . . . . . . . . . . Improperly Indicated DBCS Files . . . . . . . . . . . . . . . . . Display Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inserting Shift-Control Characters . . . . . . . . . . . . . . . . . Number of Displayed Extended Characters . . . . . . . . . . . Number of Input Fields on a Display . . . . . . . . . . . . . . .

xviii


Effects of Displaying Double-Byte Data at Alphanumeric Work Stations Effects of Displaying DBCS-Graphic Fields on Double-Byte Displays . Application Program Considerations . . . . . . . . . . . . . . . . . . . . . . Designing Application Programs That Process Double-Byte Data . . . Changing Alphanumeric Application Programs to DBCS Application Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DBCS Font Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Finding Out if a DBCS Font Table Exists . . . . . . . . . . . . . . . . . Copying a DBCS Font Table onto Tape or Diskette . . . . . . . . . . . Copying a DBCS Font Table from Tape or Diskette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting a DBCS Font Table Starting the Character Generator Utility . . . . . . . . . . . . . . . . . . Copying User-Defined Double-Byte Characters . . . . . . . . . . . . . . DBCS Font Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DBCS Sort Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using DBCS Sort Tables on the System . . . . . . . . . . . . . . . . . . Finding Out if a DBCS Sort Table Exists . . . . . . . . . . . . . . . . . . Saving a DBCS Sort Table onto Tape or Diskette . . . . . . . . . . . . Restoring a DBCS Sort Table from Tape or Diskette . . . . . . . . . . . Copying a Japanese DBCS Master Sort Table to a Data File . . . . . . Copying a Japanese DBCS Master Sort Table from a Data File . . . . Deleting a DBCS Sort Table . . . . . . . . . . . . . . . . . . . . . . . . . DBCS Conversion Dictionaries . . . . . . . . . . . . . . . . . . . . . . . . . System-Supplied Dictionary (for Japanese Use Only) . . . . . . . . . . User-Created Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . Commands for DBCS Conversion Dictionaries . . . . . . . . . . . . . . Displaying and Printing the DBCS Conversion Dictionary . . . . . . . . Deleting a DBCS Conversion Dictionary . . . . . . . . . . . . . . . . . . DBCS Conversion (for Japanese Use Only) . . . . . . . . . . . . . . . . . Where You Can Use DBCS Conversion . . . . . . . . . . . . . . . . . . How DBCS Conversion Works . . . . . . . . . . . . . . . . . . . . . . . Using DBCS Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . Performing DBCS Conversion . . . . . . . . . . . . . . . . . . . . . . . . Appendix E. Display File Return Codes Major Code 00 . . . . . . . . . . . . . . . Major Code 02 . . . . . . . . . . . . . . . Major Code 03 . . . . . . . . . . . . . . . Major Code 04 . . . . . . . . . . . . . . . Major Codes 0811 . . . . . . . . . . . . Major Code 34 . . . . . . . . . . . . . . . Major Code 80 . . . . . . . . . . . . . . . Major Code 81 . . . . . . . . . . . . . . . Major Code 82 . . . . . . . . . . . . . . . Major Code 83 . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

D-7 D-7 D-7 D-7 D-8 D-8 D-8 D-9 D-9 D-10 D-10 D-10 D-10 D-11 D-12 D-12 D-12 D-12 D-12 D-13 D-14 D-14 D-14 D-15 D-15 D-19 D-19 D-19 D-20 D-20 D-20 D-21 E-1 E-1 E-1 E-2 E-2 E-3 E-3 E-3 E-5 E-6 E-10 F-1 F-1 F-3 F-4 F-5 F-5 G-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Appendix F. Edit Codes . . . . . . . . . . . . . OS/400 Edit Codes . . . . . . . . . . . . . . . . . Examples of Editing Using OS/400 Edit Codes User-Defined Edit Codes . . . . . . . . . . . . . Using User-Defined Edit Codes . . . . . . . . Example of a User-Defined Edit Code . . . .

Appendix G. System/36-Compatible Display Data Management

Contents

xix

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

G-1 G-2 G-2 G-2 G-3 G-3 G-3 G-4 G-4 G-6 G-7 G-7 G-7 G-8 G-8 G-9 G-10 G-10 H-1 X-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xx


Figures2-1. 2-2. 2-3. 2-4. 2-5. 2-6. 2-7. 2-8. 3-1. 3-2. 3-3. 3-4. 3-5. 3-6. 3-7. 3-8. 3-9. 3-10. 3-11. 3-12. 4-1. 4-2. 4-3. 4-4. 4-5. 4-6. 4-7. 4-8. 4-9. 4-10. 4-11. 5-1. 5-2. 6-1. 6-2. 6-3. 6-4. 6-5. 6-6. 6-7. 6-8. 6-9. 6-10. Copyright IBM Corp. 1997

Sample DDS Source for a Display File . . . . . . . . . . . . . . . . . . 2-7 Record Formats in the Program and on the Display . . . . . . . . . . 2-8 DDS for Field-Level Cursor Progression . . . . . . . . . . . . . . . . 2-18 DDS for Subfile-Level Cursor Progression . . . . . . . . . . . . . . . 2-18 Sample DDS for Right-to-Left Display Processing . . . . . . . . . . . 2-19 Sample DDS for Program-to-System Fields . . . . . . . . . . . . . . 2-22 Sample DDS for Two Display Sizes . . . . . . . . . . . . . . . . . . . 2-25 Sample DDS for Subfiles for Two Display Sizes . . . . . . . . . . . . 2-25 Valid Placement of Records on a Screen When the CLRL Keyword Is Not Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6 Wrong Placement of Records on Screen When CLRL Keyword Not Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8 Replacing Record Formats . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Sample DDS Source Showing Use of the SLNO(*VAR) Keyword . . 3-12 Sample DDS Source Showing Difference between CLRL and OVERLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15 Sample DDS Source Showing Use of the PUTOVR Keyword . . . . 3-19 Sample DDS Source Showing Efficient Use of PUTOVR Keyword . 3-20 Sample DDS Source Showing Another Use of PUTOVR Keyword . 3-22 Sample DDS Source Showing Use of the PUTRETAIN Keyword . . 3-24 Sample DDS Source Showing Use of the PUTRETAIN Keyword . . 3-25 . . . 3-27 Sample DDS Source Showing Use of the DSPMOD Keyword Sample DDS to Show Record Format Problems . . . . . . . . . . . 3-47 . . . . . . . . . 4-10 DDS Keyword Processing Order for Subfile Control Vertically Displayed Subfile . . . . . . . . . . . . . . . . . . . . . . . . 4-16 Horizontally Displayed Subfile . . . . . . . . . . . . . . . . . . . . . . 4-16 Horizontally and Vertically Displayed Subfiles Displayed at the Same Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17 Sample DDS Using DSPMOD with Subfiles . . . . . . . . . . . . . . 4-18 Sample DDS Using SFLSIZ, SFLPAG, and ROLLUP Keywords . . 4-19 . . . . . . . . . . . . . . 4-20 Sample DDS for a Variable-Length Record Sample DDS Using the SFLNXTCHG Keyword . . . . . . . . . . . . 4-22 Sample DDS for a Message Subfile . . . . . . . . . . . . . . . . . . . 4-23 Sample DDS Using the DSPATR(PC) Keyword . . . . . . . . . . . . 4-25 Sample DDS Showing Customer Name Search Subfile . . . . . . . 4-32 Window TitleDisplay Example . . . . . . . . . . . . . . . . . . . . . . 5-9 DDS for a Window Title . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10 Radio Buttons and Check Boxes . . . . . . . . . . . . . . . . . . . . . 6-1 Example of a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7 DDS for a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 Menu Bar on a Graphical Display Station with Enhanced Interface . 6-10 Menu Bar on a Nongraphical Display Station with Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10 Menu Bar on a Nongraphical Display Station without Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10 Menu Bar on a Display Station without Enhanced Interface . . . . . 6-10 Selection Fields on a Graphical Display Station with Enhanced Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11 Selection Fields on a Nongraphical Display Station . . . . . . . . . . 6-12 DDS for Single-Choice and Multiple-Choice Selection Fields . . . . 6-13

xxi

6-11. 6-12. 6-13. 6-14. 6-15. 6-16. 6-17. 6-18. 6-19. 6-20. 6-21. 6-22. 6-23. 6-24. 6-25. 6-26. 6-27. 6-28. 6-29. 6-30. 6-31. 6-32. 6-33. 6-34. 6-35. 6-36. 6-37. 6-38. 6-39. 6-40. 6-41. 6-42. 6-43. 6-44. 6-45. 6-46. 6-47. 6-48. 6-49. 6-50. 6-51. 6-52.

Example of DDS for Horizontal Selection Field . . . . . . . . . . . DDS for Suppressing Selection Indicators in a Selection Field . . Suppressed Selection Indicators in Selection Field . . . . . . . . . Example of a Pull-Down Menu . . . . . . . . . . . . . . . . . . . . . DDS for a Pull-Down Menu . . . . . . . . . . . . . . . . . . . . . . . Pull-Down Menu on a Graphical Display Station with Enhanced Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pull-Down Menu on a Nongraphical Display Station with Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pull-Down Menu on a Nongraphical Display Station without Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . Pull-Down Menu on a Display without Enhanced Interface . . . . DDS for Suppressing Selection Indicators in a Pull-Down Menu . Suppressed Selection Indicators on Graphical Display Station . . Suppressed Selection Indicators on Nongraphical Display Station DDS for Accelerator Keys . . . . . . . . . . . . . . . . . . . . . . . Accelerators in a Pull-Down Menu . . . . . . . . . . . . . . . . . . . DDS for Menu-Bar Switch Key and Cancel Key . . . . . . . . . . . Selection Lists on a Graphical Display Station with Enhanced Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selection Lists on a Nongraphical Display Station with Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DDS for Selection ListsExample . . . . . . . . . . . . . . . . . . DDS for Enabling Selection Indicators in a Selection List . . . . . Selection Indicators on Graphical Display Station . . . . . . . . . . Scroll Bar on a Graphical Display Station with Enhanced Interface Scroll Bar on a Nongraphical Display Station with Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DDS for Scroll BarsExample . . . . . . . . . . . . . . . . . . . . . Push Buttons on a Graphical Display Station with Enhanced Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Push Buttons on a Nongraphical Display Station with Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Push Buttons on a Nongraphical Display Station without Underline Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Push Buttons on a Display Station without Enhanced Interface . . DDS for Push ButtonsExample . . . . . . . . . . . . . . . . . . . Control Values for the CHCCTL Keyword . . . . . . . . . . . . . . DDS to Control the Availability of Choices . . . . . . . . . . . . . . Single-Choice Selection Field with an Unavailable Choice . . . . . Examples of Valid DDS for Mnemonics . . . . . . . . . . . . . . . . Examples of DDS Not Valid for Mnemonics . . . . . . . . . . . . . DDS Using CHCAVAIL and CHCSLT for Menu-Bar Choices . . . DDS Using CHCAVAIL and CHCUNAVAIL for Selection Fields . . DDS Using CHCAVAIL, CHCUNAVAIL, and CHCSLT for Selection Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DDS Using CHCAVAIL, CHCUNAVAIL, and CHCSLT for Single Choice Selection List Choices . . . . . . . . . . . . . . . . . . . . . DDS Using CHCAVAIL, CHCUNAVAIL, and CHCSLT for Multiple Choice Selection List Choices . . . . . . . . . . . . . . . . . . . . . Continued-Entry Fields in Rectangular Arrangement . . . . . . . . DDS Using MNUBARDSP on the Application Record . . . . . . . DDS Using MNUBARDSP on the Menu-Bar Record . . . . . . . . DDS for Pull-Down Input (PULLINPUT) Parameter . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6-14 6-17 6-18 6-18 6-19 6-19 6-19 6-20 6-20 6-20 6-21 6-21 6-22 6-22 6-23 6-25 6-25 6-26 6-29 6-29 6-30 6-31 6-33 6-34 6-34 6-34 6-34 6-35 6-36 6-37 6-37 6-38 6-38 6-40 6-41 6-41 6-42 6-42 6-43 6-50 6-52 6-54

xxii


6-53. 6-54. 6-55. 6-56. 6-57. 6-58. 6-59. 6-60. 6-61. 6-62. 6-63. 6-64. 8-1. 8-2. 9-1. 9-2. 16-1. 16-2. 16-3. 16-4. 16-5. 16-6. 16-7. 16-8. 16-9. 16-10. 16-11. 17-1. 17-2. 18-1. 18-2. 18-3. 18-4. 18-5. 18-6. 18-7. 18-8. 18-9. 18-10. 18-11. 19-1. 19-2. 21-1. 21-2. 21-3. 21-4. 21-5. 21-6. 21-7. 21-8. 21-9. 21-10. 21-11.

DDS for Return-Field Parameter . . . . . . . . . . . . . . . . . . . . DDS for Menu-Bar Choice Help . . . . . . . . . . . . . . . . . . . . DDS for Single-Selection Field Choice Help . . . . . . . . . . . . . A Help List for a Menu Bar . . . . . . . . . . . . . . . . . . . . . . . Help for a Named Field . . . . . . . . . . . . . . . . . . . . . . . . . Help for a Constant Field . . . . . . . . . . . . . . . . . . . . . . . . Cursor Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Grid Line Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . DDS for Grid Line StructuresExample . . . . . . . . . . . . . . . DDS Coding Before Adding HTML Keyword . . . . . . . . . . . . . DDS Coding After Adding HTML Keyword . . . . . . . . . . . . . . Graphic Image on an AS/400 5250 Gateway Display . . . . . . . . Sample DDS Source for ERRSFL Keyword . . . . . . . . . . . . . Sample DDS Source for SFLMSGID Keyword . . . . . . . . . . . . DDS Source for Sample Menu Called PERSMENU . . . . . . . . . DDS Source for Program Menu Example . . . . . . . . . . . . . . An Example Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . Required UIM Tags for a Menu Panel . . . . . . . . . . . . . . . . Example List Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . Example of Alternate View of List . . . . . . . . . . . . . . . . . . . Required UIM Tags for a List Panel . . . . . . . . . . . . . . . . . . Example Confirmation List Panel . . . . . . . . . . . . . . . . . . . Example Data Presentation Panel . . . . . . . . . . . . . . . . . . . Example Data Presentation Panel after Scrolling . . . . . . . . . . Required UIM Tags for a Data Presentation Panel . . . . . . . . . Example Panel with a Menu Bar . . . . . . . . . . . . . . . . . . . . Required UIM Tags for a Panel with a Menu Bar . . . . . . . . . . Example of Job Exit Flag . . . . . . . . . . . . . . . . . . . . . . . . Example of Printout . . . . . . . . . . . . . . . . . . . . . . .

Application Display Programming

Documents

display fields

sample display

display fileschapter

ibm representative

ibm branch

related information

licensed program ibm

information available