unisys ClearPath OS 2200 Display Processing System (DPS 2200) Form Design Programming Guide Level 6R5A February

Transcription

1 unisys ClearPath OS 2200 Display Processing System (DPS 2200) Form Design Programming Guide Level 6R5A February

2 NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product or related information described herein is only furnished pursuant and subject to the terms and conditions of a duly executed agreement to purchase or lease equipment or to license software. The only warranties made by Unisys, if any, with respect to the products described in this document are set forth in such agreement. Unisys cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material, including direct, special, or consequential damages. You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions. Notice to U.S. Government End Users: This is commercial computer software or hardware documentation developed at private expense. Use, reproduction, or disclosure by the Government is subject to the terms of Unisys standard commercial license for the products, and where applicable, the restricted/limited rights provisions of the contract data rights clauses. Unisys and ClearPath are registered trademarks of Unisys Corporation in the United States and other countries. All other brands and products referenced in this document are acknowledged to be the trademarks or registered trademarks of their respective holders.

3 Contents Section 1. DPS 2200 Overview 1.1. Documentation Updates Conventions Used in this Document DPS 2200 Description DPS 2200 Capabilities DPS 2200 Features DPS 2200 Components Form Design Interface to Applications Programs Additional Components Operating Environments Security Section 2. FORMGEN Processor Tutorial 2.1. Overview Learning to Use FORMGEN FORMGEN Guidelines Beginning the Tutorial Defining Form Attributes Defining Fields and Constants Changing Field Attributes Saving the Form Deleting Test Forms Section 3. FORMGEN Processor Reference 3.1. Calling FORMGEN Exiting FORMGEN Printing a Form Help Forms User Profile Error Handling and Messages Main Menu Form-Level Attributes Menus Image/Field Layout Functions Marking Capability Marking Character Marking Commands Marking Characters or Marking Commands in Text Marking Undo iii

4 Contents Examples of Moves, Copies, and Deletes Repository Interface Repository Interface Menus Marked Area Menu Attributes List Menu Table Entries Menu Range Check Menu Table Check Menu Repeat Images Menu Image/Field Attributes Menu Image/Field Attribute Descriptions Rules for Specifying Attributes Alternate Attributes Menu Attribute Descriptions General Descriptions Attribute Choices for Specific Field Types Generate W/S Menu Print Form Menu Section 4. Form Language Definition Processor (FLDP) 4.1. Overview General Syntax Conventions Calling FLDP FLDP Positional Notation FLDP Definition Commands FORM Command TEMPLATE Command IMAGE Command FIELD Command Definition Statements BACKGROUND_ATTRIBUTES CHARACTER_ATTRIBUTES CHECKNUMBER_TEST CONVERSATION CURSOR DIMENSION EDIT_SYMBOL EMPHASIS FOREGROUND_ATTRIBUTES FUNCTION_KEYS GENERAL_EDIT HIGHLIGHT INPUT_ATTRIBUTES OUTPUT_ATTRIBUTES POSITION_IMAGE PREDEFINED_VALUE REPEAT_IMAGE SECURITY STORAGE iv

5 Contents TAB TEST Section 5. Form Language Manipulation Utility (FLMU) 5.1. Overview Calling FLMU Examples Using FLMU Section 6. Definition Routines (D$DEF) 6.1. Overview Differences from Other Run-Time Routines Similarities to Other Run-Time Routines D$DEF Copy Procedures D$DEF Names Parameter D$DEF Attributes D$DEF Creating Routines D$DEFFLDCRE Function D$DEFFRMCRE Function D$DEFIMGCRE Function D$DEF Modifying Routines D$DEFFLDMOD Function D$DEFFRMMOD Function D$DEFIMGMOD Function D$DEF Retrieving Routines D$DEFFLDRET Function D$DEFFRMRET Function D$DEFIMGRET Function D$DEFNAMRET Function D$DEF Deleting Routines D$DEFFLDDEL Function D$DEFFRMDEL Function D$DEFIMGDEL Function D$DEF Form Library Access Routines D$DEF File Access Authorities D$DEFERASE Function D$DEFLOAD Function D$DEFSAVE Function Miscellaneous Routines D$DEFPRINT Function D$DEFGENWS Function Appendix A. FORMGEN Messages A.1. Acknowledge Messages That Apply to All Functions... A 1 A.2. Error Messages That Apply to All Functions... A 2 A.3. Termination Acknowledge Messages... A 2 A.4. Termination Error Messages... A 3 A.5. Help Error Messages... A v

6 Contents A.6. Image/Field Attributes (A) Acknowledge Message... A 5 A.7. Image/Field Attributes (A) Error Messages... A 5 A.8. Form-Level Attributes (F) Acknowledge Message... A 16 A.9. Form-Level Attributes (F) Error Messages... A 17 A.10. Layout (L) Acknowledge Messages... A 20 A.11. Layout (L) Error Messages... A 20 A.12. Main Menu (M) Acknowledge Messages... A 25 A.13. Main Menu (M) Error Messages... A 27 A.14. Print Menu (P) Acknowledge Messages... A 33 A.15. Print Menu (P) Error Messages... A 33 A.16. Repeat Attributes Menu (R) Acknowledge Message... A 37 A.17. Repeat Attributes Menu (R) Error Messages... A 37 A.18. Profile (U) Acknowledge Message... A 42 A.19. Profile (U) Error Messages... A 42 A.20. Repository Interface Acknowledge Messages... A 46 A.21. Repository Interface Error Messages... A 47 A.22. Initial Values Menu (V) Acknowledge Message... A 49 A.23. Initial Values Menu (V) Error Messages... A 49 A.24. Generate Working Storage Menu (W) Acknowledge Messages... A 50 A.25. Generate Working Storage Menu (W) Error Messages... A 50 A.26. Execute Menu (X) Error Messages... A 57 A.27. Internal Error Messages... A 57 A.28. Error Messages Caused by Invalid Attribute Identifiers and Values... A 68 Appendix B. FDLP Messages Appendix C. D$DEF Messages C.1. Error Messages... C 1 C.2. Warning Messages... C 9 Appendix D. Sample Program Using D$DEF Routines Appendix E. Sample Form Definition Using FLDP Processor Glossary... 1 Index... 1 vi

7 Figures 2 1. Defining a Form vii

8 Figures viii

9 Tables 3 1. Device Type Mnemonics Image/Field Types System-Supplied Field Types Description Attribute Descriptions Mutually Exclusive Attributes Attribute Choices for Field Types A and X Attribute Choices for Field Type B Attribute Choices for Field Types C, I, and N Attribute Choices for Field Types R and D Attribute Choices for ON/OFF Images Valid Form Level Definition Statements for FORM Command Valid Image_Level Statements for Nonrepeating Images Valid Image_Level Statements for Repeating Images Valid Field-Level Statements for Fields (Nonconstant, Nonsystem- Applied) Valid Field-Level Statements for System-Supplied Fields Form Level Attributes, Values, and Defaults Image Level Attributes, Values, and Defaults (Repeats and ON/OFFs) Field Level Attributes, Values, and Defaults ix

10 Tables x

11 Section 1 DPS 2200 Overview The OS 2200 Display Processing System (DPS 2200) enables programmers to define forms (screens) and incorporate them into application programs. It separates the development and use of forms from other tasks in an application program. This guide describes DPS 2200 and how to use it. It is intended primarily for applications programmers who create new forms and modify existing forms. DPS 2200 provides several processors and routines that allow you to create and modify forms in different ways. This guide explains The FORMGEN processor, which allows you to create and modify forms interactively. The Form Language Definition Processor (FLDP), which allows you to create and modify forms in batch mode or in a demand environment. The Form Language Manipulation Utility Processor (FLMU), which allows you to modify, convert, and secure the DPS 2200 form definitions in the form library The D$DEF routines, which allow you to create and modify temporary forms and dynamically define forms during program execution Documentation Updates This document contains all the information that was available at the time of publication. Changes identified after release of this document are included in problem list entry (PLE) To obtain a copy of the PLE, contact your service representative or access the current PLE from the product support Web site: Note: If you are not logged into the product support site, you will be asked to do so

12 DPS 2200 Overview 1.2. Conventions Used in this Document Syntax Conventions This manual uses the following conventions for syntax: Command names, system variable names, and system function names are shown in uppercase letters. User-supplied variable information such as command options, system variable values, and system function values are shown in lowercase italic letters. Naming Conventions The following naming conventions apply to form library names, form names, image names, field names, repeat index names, and cursor field names. Form library This name can be any combination of ASCII letters, digits, the $ symbol, and the minus sign (-). Form Image, field, index, and cursor names This name can be any combination of ASCII letters and digits. The first character must be an ASCII letter, a digit, or an 8-bit character (octal codes 0246 to 0337). All other characters can be any combination of ASCII letters, digits, the minus sign (-), and 8- bit characters (octal codes 0246 to 0337). Trailing spaces are permitted. Embedded spaces are not allowed. The last character cannot be an ASCII minus sign (-). At least one character must be an ASCII letter of 8-bit characters (octal codes 0246 to 0337). Screen Conventions The following screen conventions apply when using DPS 2200: Use the tab key to position the cursor to a field in which you want to enter new data or change existing data. Usually, the fields enclosed in brackets ([ ]) and underscores (_) indicate the number of allowable characters. Output-only (OO) data is displayed in protected fields. You cannot change this data

13 DPS 2200 Overview 1.3. DPS 2200 Description DPS 2200 is an application development tool that simplifies the development of interactive full-screen applications. DPS 2200 enables you to define forms (screens) and incorporate them into your application programs. It separates the development and use of forms from other tasks in an application program DPS 2200 Capabilities DPS 2200 enables you to Reduce program development time for programs requiring full-screen interaction with different types of terminals (device independence) Reduce program development time for transaction programs Reduce errors (DPS 2200 automatically handles input errors) Standardize user interface using the repository Provide easy definition, update, and review of forms Provide form and field security without special security codes in your program Dynamically control field display attributes like intensity, highlight, emphasis, font, and color Refresh a form after accidental destruction Store statistical and trace information about terminals in the TIP environment Define initial default values for fields during form definition Perform run-time validation of user input

14 DPS 2200 Overview DPS 2200 Features DPS 2200 provides the following features: Stores the data defining a form in a form library Generates working storage in the demand environment or batch mode. The output element is compatible with ASCII COBOL, UCS COBOL, ASCII FORTRAN, UCS FORTRAN, or UCS C Completes input/output (I/O) editing within the run-time handler. It removes I/O buffers from a program and transfers only dynamic information to a program. The user program receives and supplies data transferred to and from the form in internal format (for example, numeric computational) Generates internal error messages and displays them on a specified message line when logical errors occur in input data Supports 7-bit and 8-bit character sets Generates up to 10,000 pages of output Provides standard transaction/demand programs to handle LOGON/LOGOFF sequences and to control terminal test modes that enable or disable displaying data fields Supports the integrated recovery environment (IRE) Generates working storage in the repository (UCS COBOL and UCS C) for a form if DPS 2200 is configured to use the repository. See Volumes 1 and 2 of the UCS COBOL Programming Reference Manual and Volumes 1 and 2 of the UCS C Programming Reference Manual for a description of the statements you can use to access this information Provides the capability for an application program to lock the keyboard while an output message is being sent to a terminal. This capability is useful when an application program is busy and cannot receive input from the keyboard until it completes the current operation. It also allows an applications program to send status messages and perform other functions Provides an extended security environment that ensures that sensitive data is protected Provides the capability for run-time validation of input data. At user program execution time, data entered in an I/O field is compared to either a user-defined table of values or a user-defined range Provides the capability to transliterate the literal text and initial field values from the CCS used during screen definition, into the CCS in use at run-time

15 DPS 2200 Overview 1.4. DPS 2200 Components This subsection describes the DPS 2200 components that enable you to define forms and incorporate them into application programs and to manage your DPS 2200 system Form Design The following DPS 2200 components enable you to create and edit forms: FORMGEN processor The FORMGEN processor is a full-screen interactive component of DPS 2200 enabling you to define, modify, and delete forms. FORMGEN includes learning aids and extensive online help screens. FLDP FLDP is the batch mode equivalent of the FORMGEN processor. You define forms with a series of commands. FLDP is for experienced programmers. D$DEF routines The D$DEF routines enable you to dynamically define and edit forms within an application program. D$DEF routines are for experienced programmers. They require knowledge of languages supported by DPS 2200 (such as COBOL) and of other OS 2200 software products. FLMU FLMU enables you to modify, convert, and secure the DPS 2200 form definitions in the form library, and generate working storage Interface to Applications Programs DPS 2200 provides an interface between form definitions and application programs and run-time routines. The DPS 2200 run-time routines operate in the following environments: Demand (remote symbiont interface [RSI]) Transaction Processing/Message Control Bank (TIP/MCB) and Integrated Recovery Version II or III Transaction Processing/communications buffer (TIP/COMPOOL) After you define your form with the FORMGEN processor, FLDP, or the D$DEF routines, you must transfer it to an output file in either COBOL, FORTRAN, or C, depending on your application. This is called generating working storage. The application program manipulates the variables and communicates with the DPS 2200 run-time system collected with the program through a language-dependent interface routine. Interface routines are available for COBOL, FORTRAN, MASM, and C

16 DPS 2200 Overview The run-time routines communicate with an application program and its environment through a comprehensive set of procedures or functions. The application program uses DPS 2200 run-time routines, working storage, and parameter definitions to accomplish interactive tasks. The run-time routines control the terminal through OS 2200 by displaying the form named in the application along with any output variables defined in working storage. Then the run-time system receives the input variables, validates them, and stores them correctly in working storage. A set of error handling routines is available to help you resolve problems with the input Additional Components The following is a list of additional components that enable you to manage, monitor, and control DPS 2200 and your applications. DPSIF DPSPW HELPER LISTER LOGON LOGOFF PAGING REFRESH STATS TCLEAR TMODE TTYPE The File Initialization Processor initializes DPS 2200 system files. The User-id/Password processor generates and maintains information about authorized users of a DPS 2200 system. This component produces information at your terminal about your DPS 2200 configuration. The LISTER processor produces a list of all user records in the password file as well as a list of all forms in the form library. The LOGON processor starts a DPS 2200 session. This processor is optional. The LOGOFF processor removes the user-id/password and its associated security information from the terminal file record. Use it to end a DPS 2200 session. This component retrieves forms stored by DPS 2200 paging functions and displays them on a terminal one at a time. The REF processor redisplays an accidentally destroyed form. This component produces information at your terminal about the use of DPS 2200 in a TIP environment. This component enables you to clear another person's terminal record or your own terminal record. TCLEAR is used only by site administrators. This component turns the test mode on and off for an executing terminal. Test mode causes a terminal to display information that is not normally displayed. This component enables you to specify the terminal type or to ask DPS 2200 what type is currently specified for the terminal

17 DPS 2200 Overview 1.5. Operating Environments You can configure DPS 2200 for a demand (remote symbiont interface [RSI]) environment or for both a demand and TIP environment. An experienced programmer usually performs the configuration. With the TIP and demand configurations, you can execute TIP transactions in a demand environment without recompilation or recollection if they were appropriately coded. Also, you can test TIP transactions in a demand environment using normal programming aids, such as the FLIT processor, PostMortem Dump (PMD) processor, and Programmers Advanced Debugging System (PADS). Programs executed in either a TIP or a demand environment must run on a terminal with the same size screen as the terminal configured with DPS Currently, DPS 2200 supports terminals with a screen size of 24 rows and 80 columns only. This restriction applies only for programs executed in the TIP and demand environments. Programs run in batch mode can execute from any device Security DPS 2200 enables you to generate forms that display only those parts corresponding to the security level of the logged-on user-id. Every user-id has security levels assigned to it. There are two levels of security: Form security defines which forms a particular user-id can access Field security defines which fields a particular user-id can receive Note: The application program should always supply the output data for all fields. DPS 2200 determines whether to display the data. Therefore, you can use the same application program for different displays without being concerned with the kind of display or the current security level. You do not need any code in the program to handle security checking. Form level security returns an error code that the program must accept. You must attach a security level to each form and individual field. DPS 2200 compares these levels with your active security level and takes the appropriate action to ensure that you receive only the proper data

18 DPS 2200 Overview You can define additional levels of security when you define a form. Define forms and their fields as having either soft or hard security, as follows: Soft security A user-id must have a security level equal to or greater than the form or field security level to open the form or receive the fields. Hard security A user-id must have the same security level as the form or field to use the form or fields. Anyone can use a form or field with the lowest security level, which is 1. DPS 2200 always displays a field with this security level. If you do not sign on to DPS 2200 using the LOGON processor, the run-time initialization function of DPS 2200 assigns the lowest security level to you. In demand and batch programs, the DPS 2200 security system links to the Exec security system. Use the Exec user-id, if any, in these programs. In the TIP environment, DPS 2200 uses its own LOGON transaction to link user-ids to terminals, unless TIP session control is configured in the Exec and MCB is in use. TIP session control is available only in the TIP/MCB environment and identifies a TIP user to the transaction system. When it is configured, TIP session control solicits a valid user-id/password similar to demand mode. DPS 2200 performs an ER INFO$ to retrieve the user-id that was in effect when you signed on to the system. It is no longer necessary to execute the LOGON processor to start a TIP session and to set up the security for a specific user-id. This is now done automatically by DPS However, you can still use the LOGON processor

19 Section 2 FORMGEN Processor Tutorial This section introduces the FORMGEN processor and contains a step-by-step procedure that shows how to create a simple form. This tutorial shows some of the capabilities of the FORMGEN processor and provides enough information to get started. See Section 3 for reference information and a more detailed description of the FORMGEN processor Overview The DPS 2200 FORMGEN processor enables you to create and change forms to meet the unique requirements at your site. FORMGEN combines the default attributes that satisfy your requirements with the attributes that you change and the data you enter to produce a form. As you define a form, FORMGEN temporarily stores the data in a workspace in main storage. When you finish defining a form, you must instruct FORMGEN to permanently store a copy of your form in mass storage. This tutorial uses the following definitions for the terms you and end user: In the following discussion, you refers to applications programmers who use FORMGEN to create and modify forms unique to a specific task. They provide the forms needed for a business providing daily service to customers. An end user is a data entry person who uses the forms that you create and modify. For example, an end user might work at a reservations counter and use your form while selling tickets to a ball game or reserving seats for a concert. When end users use your form, they merely tab to the applicable fields you defined and enter a customer's name, address, phone number, requested seat number, and so forth

20 FORMGEN Processor Tutorial Figure 2 1 shows the steps that FORMGEN performs while you define a form, generate working storage for the application programs, and print a listing. It shows the following sequence of events: While defining a form with default attributes or entering new attributes, FORMGEN stores the data in a temporary storage area called a work space. When you finish defining the form, instruct FORMGEN to store the data in permanent storage. Also, instruct FORMGEN to generate working storage for the form. This is the data that an application program reads when it uses the form. If you want a hard copy, instruct FORMGEN to transfer the data to a print file and you can generate the listing from that file. Figure 2 1. Defining a Form

21 FORMGEN Processor Tutorial 2.2. Learning to Use FORMGEN The following example shows you how to use some of the FORMGEN functions. By performing this step-by-step process (WALK-THRU mode), you can see the results of the commands and data you enter. You will be instructed to enter specific commands and data. Screens displaying the menus and forms will show the results of these actions. A brief description of the commands is included. See Section 3 for more detailed information FORMGEN Guidelines The underlined areas in the figures represent fields in the form. You can enter data in these fields in lowercase or uppercase letters. Some parameters have two fields (for example, auto save count). The first field contains data entered with the FORMGEN processor. The second field contains the default value for the first field. You can request user help by entering the help character in a single field or multiple fields and pressing XMIT. FORMGEN displays the help form for the first field in which you requested help. Note: You cannot change data on a menu and request help from that menu with the same transmit sequence. Help requests are processed before any other information on the menu. When you finish with the help for a field, you can request help for the next field by entering the letter e in the help functions selection field at the bottom of the help form and pressing XMIT. Most help forms contain narrative descriptions while a few list all possible values for a field. See Section 3 for additional information about help. Return to the form from which you requested help by either pressing F4 (function key 4) or by entering the letter r in the help functions selection field at the bottom of the help form and pressing XMIT. When FORMGEN displays the form from which you requested help, the cursor is positioned over the first help character

22 FORMGEN Processor Tutorial Beginning the Tutorial Step 1 Call FORMGEN and display the Main Menu by <press XMIT> The Main Menu looks as follows. Device: UTS20 DPS 2200 FORMGEN PROCESSOR Main Menu DPS Level: 6R4 User Level: 6R4 Library command new (DELETE (workspace), ERASE, NEW, OLD, REPLACE, SAVE) Form name example <FORM> Form number 0 <0> File type F <F> (F-Formlib, O-Omnibus) Form library SCREEN$FILE Omnibus name (qual*file.elt/vs) Auto save count 1 <1> (0-99) Expertise level 1 <2> (1, 2, 3) A = Image/field attributes M = Main menu (F1) V = Initial values D = Repository interface O = Exit with omit (F6) W = Working storage E = Exit with replace (F5) P = Print form X = Execute (display) F = Form-level attributes R = Repeat images L = Image/field layout U = User profile? = Help (any field) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

23 FORMGEN Processor Tutorial Step 2 Enter the data for the following main menu fields. Library command Enter NEW in the Library command field (this is a three-character field). This command creates a new form. Form name Enter EXAMPLE in the Form name field (this is an eight-character field). This assigns the name EXAMPLE to the new form. The default name is based on the value in your user profile. Form number The form number must be unique to this form. It identifies the form you are creating. The default value is 0. If you use 0, FORMGEN uses the next available form number. If you are not sure whether you should use the default value, ask your supervisor for a form number to use during this exercise. File type Selects the type of file you want to read data from or which you want to write data to. The default file type is based on the value in your user profile. Form library The name of the file where FORMGEN stores the form you are creating. A form library is like a book library. The default file name is based on the value in your user profile. Your form library file name may differ from the one in the figure (SCREEN$FILE) because your file name is determined when your site administrator configures the system. Auto save count Auto save count instructs FORMGEN to save your form definition in an auto-recovery file after a specified number of updates. This capability lets you recover your form if the system fails while you are working on it. The default auto save count is based on the value in your user profile. Expertise level Enter 1 in the Expertise level field (this is a one-character field). This reflects your current level of experience with FORMGEN. This example can only be performed in WALK-THRU mode, which is only available in expertise level 1. The default value is based on the value in your user profile

24 FORMGEN Processor Tutorial Step 3 Press XMIT. The cursor can be in any position on the screen because the entire form is always read. FORMGEN displays the following message on line 24: *** NEW FUNCTION PERFORMED. ENTER FKEY 4 FOR WALK-THRU MODE *** Step 4 Press F4. FORMGEN displays an introduction to the WALK-THRU mode and instructions about the use of F4 and XMIT Defining Form Attributes Press either F4 or XMIT. FORMGEN displays page 1 of the Form-Level Attributes menu. The Form-Level Attributes menu lets you define the display attributes of your form. For example, you can define components such as form height and function keys. Page 1 looks as follows. EXAMPLE 0 DPS 2200 FORMGEN PROCESSOR Form-level (1 of 3) Final cursor field name <1st I/O field> (Any I/O field) Security level 1 <1> (1-63) Security type S <S> (H-Hard, S-Soft) Form height 1 <last line of text or images> (1-24) Generate prefix Y <Y> (N-No, Y-Yes) Initial conversation mode N <N> (N-No, Y-Yes) Check number validate Test mode Y <Y> (N-No, Y-Yes) N <N> (N-No, Y-Yes) Function keys <N> (A-All, N-None, 1-36) N Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP All fields on page 1 have default values as shown. Do not change any of these values. See Section 3 for a complete description of all the fields on page

25 FORMGEN Processor Tutorial The final cursor field name is blank because you have not yet defined any fields. It defaults to the first I/O field in the form. Step 5 Press XMIT. FORMGEN displays page 2 of the Form-Level Attributes menu. If you changed page 1 before transmitting, FORMGEN displays the following message on line 24 to indicate that all values on page 1 were accepted: *** FORM-LEVEL ATTRIBUTES UPDATED *** Page 2 looks as follows. EXAMPLE 0 DPS 2200 FORMGEN PROCESSOR Form-level (2 of 3) Background color E <E> (B-Blue, C-Cyan, E-Ebony, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) Foreground: Color W <W> (B-Blue, C-Cyan, E-Ebony, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) Intensity N <N> (H-High, L-Low, N-Normal, S-Suppressed) Highlight N <N> (B-Blink, N-None, R-Reverse) Emphasis N <N> (L-Leftcolumn, N-Normal, S-Strike, U-Underscore) Font/Character set N <N> (N-Normal, 1-Alt1) Control characters N <N> (B-Blink, N-None) I18N CCS Number 35 <35> (O-No Transliteration, Greater Than O-CCS) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP All fields on page 2 have default values as shown. Do not change any of these values. See Section 3 for a complete description of all the fields on page

26 FORMGEN Processor Tutorial Step 6 Press XMIT. FORMGEN displays page 3 of the Form Level Attributes menu. If you changed page 2 before transmitting, FORMGEN displays the following message on line 24 to indicate that all values on page 2 were accepted: *** FORM-LEVEL ATTRIBUTES UPDATED *** Page 3 looks as follows. EXAMPLE 0 DPS 2200 FORMGEN PROCESSOR Form-level (3 of 3) Enter special characters: Start image character [ <[> Stop image character ] <]> Field character Alternate field character SOE character _ <_> Thousands delimiter, <,> Decimal point symbol. <.> Marking character No default No default No default Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP All fields on page 3 except the Alternate field character, SOE (start-of-entry) character, and Marking character have default values as shown. Do not change any of these values. See Section 3 for a complete description of all the fields on page 3. Step 7 Press XMIT. FORMGEN displays page 1 of the Form-Level Attributes menu. If you changed page 3 before transmitting, FORMGEN displays the following message on line 24 to indicate that all values on page 3 were accepted: *** FORM-LEVEL ATTRIBUTES UPDATED ***

27 FORMGEN Processor Tutorial Defining Fields and Constants Step 8 Press F4. FORMGEN displays a form containing information about the Image/field layout form. This is where you actually lay out the constants and fields of your form. You can rearrange fields and change information until you are satisfied with your form. When you create a new form, you have access to all positions on the form. This example creates a simple form containing four fields and the text constants identifying each field. FORMGEN defines a field as those positions available for entering information. The text constant is not part of the field. Underscores describe the field size by indicating the number of positions available for entering information. In this example, the first field has 24 underscores. This means that you can enter a maximum of 24 characters in the first field. After reading the information, press XMIT. Because you are creating a new form, the form is blank. Enter the following number of underscores in each field: NAME 24 CITY 16 STATE 6 EDUCATION 24 Enter the following text constants and fields in the following locations. Starting Location row 1 column 1 row 3 column 1 row 5 column 1 row 7 column 1 Text Constant Field NAME: CITY: STATE: EDUCATION: When you finish entering this data, press XMIT

28 FORMGEN Processor Tutorial Step 9 FORMGEN displays a message momentarily on line 24 when it redisplays the form with no changes. The form looks as follows. NAME: CITY: STATE: EDUCATION: If the form is okay, press XMIT a second time and go to step 10. If the form is not okay, change it. To change an existing form, do the following: Type over existing data. Delete existing data. Add new data in any position on the form. When you finish making changes, press XMIT or F4. When the form is okay, press XMIT a second time and go to step

29 FORMGEN Processor Tutorial Step 10 FORMGEN displays the Repeat Images menu with the following message on line 24: *** IMAGE AND FIELD LAYOUT UPDATED *** : * AUTO * The Repeat Images menu looks as follows. EXAMPLE 0 DPS 2200 FORMGEN PROCESSOR Repeat Images 1AME: 2 3ITY: 4 5TATE: 6 7DUCATION: STARTING LINE 1 (n,+n,-n) CHG TYPE INDEX NAME DIR ROW S-COL E-COL COUNT SPACING LINES/UNIT LITERALS Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): *** IMAGE AND FIELD LAYOUT UPDATED *** : * AUTO * On this menu, the line number overwrites the first letter of each text constant. This line number states where your data is located. This menu lets you repeat (duplicate) fields in both vertical and horizontal directions. The top portion of the menu shows the first 12 lines of your form. The bottom portion of the menu is an area for entering applicable information about your repeat operations. This information controls the duplication of the fields. This example shows how to repeat the EDUCATION field. See Section 3 for more information about the Repeat Images menu

30 FORMGEN Processor Tutorial Step 11 Enter the following data: The letter i in the CHG TYPE field informs FORMGEN that you are inserting a repeat. The name index4 in the INDEX NAME field uniquely identifies the field you want to repeat. You can either enter a name or let FORMGEN assign a default name. The letter d in the DIR field specifies repeating (duplicating) the field in the vertical direction (down). The number 7 in the ROW field specifies the number of the first line repeated. The letter y in the LITERALS field specifies repeating the literal values (text constant). The default value is n. However, in your example, you want the literal values repeated. FORMGEN assigns default values for fields in which you did not enter data. EXAMPLE 0 DPS 2200 FORMGEN PROCESSOR Repeat Images 1AME: 2 3ITY: 4 5TATE: 6 7DUCATION: STARTING LINE 1 (n,+n,-n) CHG TYPE INDEX NAME DIR ROW S-COL E-COL COUNT SPACING LINES/UNIT LITERALS i index4 d 7 y Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): *** IMAGE AND FIELD LAYOUT UPDATED *** : * AUTO *

31 FORMGEN Processor Tutorial When you finish entering data, press XMIT. FORMGEN redisplays the Repeat Images menu, with the education field repeated on line 8. In addition, FORMGEN inserts default values in the empty fields and displays the values in uppercase. FORMGEN also displays the following message on line 24 to indicate that the images were successfully updated: *** REPEAT IMAGES UPDATED *** :AUTO * The updated Repeat Images menu looks as follows. EXAMPLE 0 DPS 2200 FORMGEN PROCESSOR Repeat Images 1AME: 2 3ITY: 4 5TATE: 6 7DUCATION: 8DUCATION: STARTING LINE 1 (n,+n,-n) CHG TYPE INDEX NAME DIR ROW S-COL E-COL COUNT SPACING LINES/UNIT LITERALS N INDEX4 D 7_ 1_ 80 2_ 0_ 1_ Y Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): *** REPEAT IMAGES UPDATED *** : * AUTO *

32 FORMGEN Processor Tutorial Changing Field Attributes Step 12 Press F4. FORMGEN displays the Image/Field Attributes menu. The Image/Field Attributes menu looks as follows. EXAMPLE 0 NAME: 1 CITY: 2 STATE: 3 EDUCATION: 4 EDUCATION: 4 DPS 2200 FORMGEN PROCESSOR Image/Field Attributes STARTING LINE 1 (n,+n,-n) STARTING FIELD 1 (n,+n,-n) IMAGE NAME TYPE ATTRIBUTES ( ^ = alternate select menu) 1 IMAGE1 X 2 IMAGE2 X 3 IMAGE3 X 4 IMAGE4 X Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP This menu lets you change the name, type, and attributes of each field. The top portion of the menu shows your fields. The bottom portion shows the image name, type, and attributes for your fields. The menu contains the default names (IMAGE1, IMAGE2, and so forth), field type (X), and attributes (default values only; none are displayed). (See Section 3 for a complete description of the Image Attributes menu.) Enter the following data. (IMAGE1 in the IMAGE NAME column refers to NAME, IMAGE2 refers to CITY, and so forth.) The letter a in the TYPE field tells FORMGEN to make the NAME field an alphabetic field. The letters uc in the ATTRIBUTES field tells FORMGEN to define the uppercase attribute for the NAME field and to display the contents of the field in uppercase

33 FORMGEN Processor Tutorial EXAMPLE 0 NAME: 1 CITY: 2 STATE: 3 EDUCATION: 4 EDUCATION: 4 DPS 2200 FORMGEN PROCESSOR Image/Field Attributes STARTING LINE 1 (n,+n,-n) STARTING FIELD 1 (n,+n,-n) IMAGE NAME TYPE ATTRIBUTES ( ^ = alternate select menu) 1 name a uc 2 city X 3 state X 4 education X Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP When you finish entering data, press XMIT. FORMGEN redisplays the Image/Field Attributes menu, with the values you entered now displayed in uppercase. FORMGEN also displays the following message on line 24: *** IMAGE AND FIELD ATTRIBUTES UPDATED *** :AUTO * Step 13 Press F4. FORMGEN displays a form containing information about the Initial Values function. This capability lets you insert an initial value so that this value is provided when your form is first displayed. This makes your form easier to use and saves time. When you finish reading the information screen, press XMIT. FORMGEN displays the Initial Values form

34 FORMGEN Processor Tutorial The Initial Values form looks as follows. NAME: CITY: STATE: EDUCATION: EDUCATION: Tab to the STATE field and enter MN. The space between the colon and the start of the field is protected. You cannot enter any data into it. Press XMIT. FORMGEN redisplays the form with MN in the STATE field. The Initial Values form looks as follows. NAME: CITY: STATE: MN EDUCATION: EDUCATION: If the form is okay, press XMIT a second time. If the form is not okay, change it and press XMIT. After transmitting, check the form. If it is okay, press XMIT a second time and go to the next step. FORMGEN displays the following message on line 24: *** FIELD INITIAL VALUES UPDATED *** :AUTO *

35 FORMGEN Processor Tutorial Step 14 FORMGEN displays the first Form-Level Attributes menu. (This is the same menu displayed in step 2.) This step lets you make changes to the menu. For example, you may want to enter the final cursor field name now if you do not want to accept the default. As before, press XMIT to move between menus. When you are satisfied with the form-level attributes, press F4. FORMGEN displays the main menu. You have completed defining the form and you can now save it in the form library Saving the Form Step 15 You must save the form so FORMGEN can assign a form number to it and so that the run-time functions can use the form. Because you entered 0 into the Form number field in step 2, FORMGEN assigns the next form number in sequence. To save the form, enter SAV into the Library command field and press XMIT. FORMGEN saves the form and displays the Main Menu, with the next available form number (for example, 1) in the Form number field and the following message on line 24: *** EXAMPLE/1 SAVED INTO FORM LIBRARY *** Step 16 After saving the form, generate either COBOL, FORTRAN, or C working storage for the application programs. Enter W in the Select function field and press XMIT. FORMGEN displays the Generate W/S menu with the default values shown. On this menu, instruct FORMGEN to create a symbolic element containing a data structure defining a form in the workspace, form library, or omnibus file. This data structure is known as working storage. The working storage for a form is copied or included into a COBOL, FORTRAN, or C application program when it is compiled. The working storage enables a program to access the data entered in a form and also to change the data displayed in a form. You must save working storage in an element. You can specify a file and element name in the Output field. If a file name is not specified, TPF$ is assumed

36 FORMGEN Processor Tutorial If an element name is not specified, FORMGEN uses the following default element name: SCREENn/vvvv where n vvvv is the number of the form. is one of the following: COBP, if generating ASCII COBOL or UCS COBOL working storage FTNP, if generating FORTRAN working storage. H, if generating C working storage. For COBOL and FORTRAN, you must call the Procedure Definition Processor (PDP) to process this element after you exit from the FORMGEN processor. EXAMPLE 1 DPS 2200 FORMGEN PROCESSOR Generate W/S Form name EXAMPLE Form number 1 Workspace Y (Y-Yes, N-No) File type F <F> (F-Formlib, O-Omnibus) Form library SCREEN$FILE Omnibus name (qual*file.elt/vs) Language COB <COB> (COB-ASCII COBOL, FOR-FORTRAN, UC-UCS C, UCOB-UCS COBOL) Output type F <F> (F-File, R-Repository) Initial values Y <Y> (N-No, Y-Yes) Generate prefix Y (N-No, Y-Yes) Allow redefine N <N> (N-No, Y-Yes) Storage type D <D> (D-Default, T-Typedef) Output (qual*file.elt/vs) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

37 FORMGEN Processor Tutorial Step 17 Press XMIT. FORMGEN displays the following message on line 24: *** WORKING-STORAGE IN FILE: TPF$.SCREEN-1/COBP *** where TPF$.SCREEN-1/COBP is the default output file name. Step 18 Press F1. FORMGEN displays the Main Menu. You are now back where you were in step 2. This completes the example and the form you created can be used. The working storage generated for your form is now stored in the file named in step Deleting Test Forms Step 19 To delete your completed form or any test or trial forms existing in the form library and workspace, perform the following steps (FORMGEN is still displaying the Main Menu). If you want to print a hard copy of your form, see Section 3 before deleting it. Delete your form from the workspace: 1. Enter DEL in the Library command field. 2. Press XMIT. FORMGEN deletes the form and displays the following message on line 24: *** WORKSPACE IS NOW EMPTY *** Erase your form from the form library: 1. Enter ERA in the Library command field. 2. Press XMIT. 3. Enter ERA in the Library command field and press XMIT a second time. FORMGEN erases the form and displays the following message on line 24: *** EXAMPLE/1 ERASED FROM FORM LIBRARY *** Your task of creating, saving, and deleting your form is complete. To exit FORMGEN, press F

38 FORMGEN Processor Tutorial

39 Section 3 FORMGEN Processor Reference This section describes the FORMGEN processor, an interactive component of the DPS It contains reference information for the applications programmer. It explains in detail how to call and exit FORMGEN, how to define your user profile, how to print a form, and how to display help forms. It also describes the contents of each field in each menu and what they are used for Calling FORMGEN The DPS 2200 FORMGEN processor enables you to create and change forms to meet the unique requirements at your site. FORMGEN combines the default attributes that satisfy your requirements with the attributes that you change and the data you enter to produce a form. There are several options available on the call statement. Normally, you do not use any of these options when you call FORMGEN because the applicable operating parameters are determined when your site administrator configures the system. Select the S or L option only to override the parameters selected during system configuration. Call the FORMGEN processor with the following device-type where options A I Lets you recover a form from the auto-recovery file if you entered the O option in the Select function field or if you pressed function key 6 (F6) the last time you exited FORMGEN. If you entered E in the Select function field or pressed function key 5 (F5) and FORMGEN could not save your form, use this option to attempt to recover it. Auto-recovery overrides this function. Reinitializes FORMGEN. FORMGEN executes the D$GETDEVICE function, which determines the terminal type. This is useful if you entered a terminal type in the processor statement and you want FORMGEN to determine the real terminal type

40 FORMGEN Processor Reference T Y Selects data tracing. Selecting this option executes the D$DUMP function and takes a FORMGEN dump after each input or when FORMGEN detects a fatal error on a DPS 2200 function call. Sets the training mode if TIP files are used. If TIP files are used as form libraries, use the training file instead of the production file. Test mode files are displayed for forms stored in training mode. device-type Terminal mnemonic used to specify if the terminal you are using differs from the terminal type defined as the primary terminal type when your system was configured. If you do not specify a device type, FORMGEN determines the type by using the D$GETDEVICE function (see the DPS 2200 Programming Reference Manual) the first time FORMGEN is called during a run. When you specify a device type, you override the D$GETDEVICE function. Table 3 1 lists the available device-type mnemonics. Table 3 1. Device Type Mnemonics Mnemonic Device Type U200, 200, U2 UNISCOPE 200, UTS 400 in UNISCOPE 200 mode (PROTECT switch on) UTS400, U400, U4, 400 UTS20, U20, 20 UTS 20 UTS30, U30, 30 UTS 30 UTS40, U40, 40 UTS 40 UTS60, U60, 60 UTS 60 DS40, D40, D4 SVT1120, SVT1121, SVT1126 STEP20 UTS 400 in native mode Dataspeed Unisys Video Terminals 1120, 1121, 1126 STEP60 Unisys PC with STEP 60 IBM3270, I3270, 3270 LT300 Unisys LAN terminal 300 Unisys PC with Synchronous Terminal Emulation Package (STEP 20) IBM 3270 series (IBM 3270, IBM 3276, IBM 3277, IBM 3178/3278) with 24x80 form

41 FORMGEN Processor Reference 3.2. Exiting FORMGEN There are four methods available for exiting FORMGEN. The method you choose depends on whether you want to save your changes to the current form and which menu is currently displayed. Methods 1 and 2 - Saving Changes To save your changes to the current form, use one of the following methods: Enter E in the Select function field and press XMIT. Press the F5 key. Note: F5 is not available on UNISCOPE 200 terminals. These two methods of exiting are exactly the same if there are no errors. However, if an error was detected and you press F5 to exit, any changes made on the current form since the last transmit are lost. Note: Function keys do not cause processing of menu information. If you change the menu and use a function key before transmitting, the menu changes are not retained. To save your changes and exit from a form that does not contain the Select function field, use the F5 key. If the form number is 0, FORMGEN saves the form in the next available form. After saving your form, FORMGEN displays a message informing you where your form was saved. If you enter E in the Select function field or press the F5 key when the form library is not available, FORMGEN saves the form in the auto-recovery file and displays the following message: FORMGEN PROCESSOR TERMINATED - FORM NOT REPLACED ( A OPTION AVAILABLE) If you want to recover this form, include the A option when you call FORMGEN. This causes FORMGEN to recover the form from the auto-recovery file. You can then save the form permanently in a form library or omnibus file. Methods 3 and 4 - Discarding Changes If you do not want to save your changes to the current form, use one of the following methods: Enter O in the Select function field and press XMIT. Press the F6 key. Note: F6 is not available on UNISCOPE 200 terminals

42 FORMGEN Processor Reference If you enter O in the Select function field or press F6, FORMGEN saves the form in the auto-recovery file and displays the following message: FORMGEN PROCESSOR TERMINATED - FORM NOT REPLACED ( A OPTION AVAILABLE) If you want to recover this form, include the A option when you call FORMGEN. This causes FORMGEN to recover the form from the auto-recovery file Printing a Form When you finish defining your form, you can generate a hard copy (listing) of the information in your form. The listing includes all initial values and field attributes for an existing form. FORMGEN stores the listing in a default file or a file named by you. Even though FORMGEN stores this data permanently, unless you erase it, you may want to obtain a listing. The listing contains the following information: General form information Form showing literals Form showing initial values and input fields A listing of the fields sorted by their position on the form Producing a Listing Produce a listing of the data defining a form with the following steps: 1. Generate the data and load it into a file or element in FORMGEN. 2. Direct the output from the file to a printer with the FORMGEN Print Form menu. Enter your information in the Output, Site output, Retain output, Destination, Copies, and Banner fields. After entering the data, press XMIT. This transfers the output file from FORMGEN to a printer. 3. You can optionally direct the output from the file to a printer with statement. Do this after exiting from FORMGEN. You can then use statement to transfer the data from an element to a file. Viewing the Print Form Menu To view the FORMGEN Print Form menu to determine what information is needed to print a form: 1. Go to the FORMGEN Main Menu and tab to the Select function field. 2. Enter a P and press XMIT. FORMGEN displays the Print Form menu

43 FORMGEN Processor Reference The Print Form menu looks as follows. FORM 0 DPS 2200 FORMGEN PROCESSOR Print Form Form name EXAMPLE Form number 1 Workspace Y (Y-Yes, N-No) File type F <F> (F-Formlib, O-Omnibus) Form library SCREEN$FILE Omnibus name (qual*file.elt/vs) Output (qual*file(+1).elt/vs) Site output N <N> (Y-Yes, N-No) Retain output N <N> (Y-Yes, N-No) Destination Copies 1_ Banner Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP All fields on this menu have default values assigned if the data defining a form is currently in the workspace. If the data is not in the workspace and you enter N in the workspace field, the data must be in the form library or omnibus file. You may request help by entering the help character (defined in your user profile) on the Print Form menu and pressing XMIT. When the information on the Print Form menu is okay, press XMIT. FORMGEN transfers the data to the output file or element and displays the following message on line 24: PRINT IN FILE: file-or-element-name where file-or-element-name states where the data is stored. Use one of these two methods to return to the Main Menu: Position the cursor to the Select function field, enter M, and press XMIT. Press function key 1 (F1)

44 FORMGEN Processor Reference Printing the Data You can also print the data at your printer after you exit FORMGEN. The methods for printing differ, depending on whether the data is in a file or an element. To print data in a file, enter the following filename,,printer-designation To print data in an element, use the following runstream to transfer the data to a print file and then print prfile.. Assign your print fdp.s4,prfile.. Copy data to your print prfile.. Free your print prfile,,printer-designation.. Direct the data to your printer. For additional runstream information, see the ECL End Use and Programming Reference Manual Help Forms You can display user help forms describing most fields by entering a help character (defined in your user profile) in a field and pressing XMIT. You can request help at any time from any field. Press function key 7 (F7) to request select-function help. Help forms are generally arranged in multiple levels of detail and contain multiple pages. Note: You cannot change data on a menu and request help from that menu with the same transmit sequence. Help requests are processed before any other information on the menu. Most help forms contain narrative descriptions. The following screen shows an example of a help screen for a field:

45 FORMGEN Processor Reference FORM 0 DPS 2200 FORMGEN PROCESSOR Help-level Help-page 1 1 IMAGE/FIELD NAME (no more levels) * IMAGE/FIELD NAME - A field or image name is required for all field types except linked images and system-supplied fields. A default name is initially supplied which you may change. You must erase this name if you change the field type to an "L" or an "S". - This name is used in the working storage generated by DPS 2200 as part of the generated COBOL, FORTRAN, or UC data items E = Exit current help P = Previous level of help +n = Advance n pages N = Next level of help R = Return to current menu -n = Go back n pages Enter a help function (E, N, P, R, +n, -n,?): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP For some attribute fields, all possible values are listed. The following screen is an example of a help screen showing attribute values. FORM 0 DPS 2200 FORMGEN PROCESSOR Help-level Help-page 2 1 ATTRIBUTES Field type : A or X BC= (<E>, B, C, G, M, R, W, Y) SECT= (<S>, H) FC= (<W>, B, C, E, G, M, R, Y) SECF= (<N>, PB, PD) FI= (<N>, H, L, S) SECL= (1-63) FONT= (<N>, 1) REP= "char" CON= (<S>, B, R) RFB= "char" EMP= (<N>, L, S, U) (list may be specified) MWID= (<init-width>-1920) HI= (<N>, B, C, R) (list may be specified) VC= (<N>, T) Justification= (<NJ>, CJ, LJ, RJ) Blank Input= (<BLNK>, NIB) Positioning= (<VPOS>, FPOS) Usage= (<IO>, OO) Case= (<EC>, UC) TAB= (<Y>, N) REPN= (<N>, Y) TDEP= (<N>, Y) F= (<N>, Y) MOD= (<N>, Y) PRO= (<N>, Y) VWID= (<N>, Y) AQ= (<N>, Y) Enter a help function (E, N, P, R, +n, -n,?): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

46 FORMGEN Processor Reference The help functions shown at the bottom of each help screen let you to request additional help, return, exit, and so forth. The following list describes the help functions. E N P Exits the current help form and calls the help form for the next field for which you requested help. Calls the next level of help, if it exists. For example, if you are viewing a help form for expertise level 1, N calls help for expertise level 2. If there are no more levels, FORMGEN displays the following message on line 24: NO MORE LEVELS OF HELP AVAILABLE Calls the previous level of help if you are currently at level 2 or greater (opposite of command N). If you are at level 1, no previous level exists. In this case, FORMGEN displays the following message on line 24: YOU ARE AT THE FIRST LEVEL OF HELP R Returns to the menu from which you requested help. +n Calls the next page in this level of help, if it exists. The letter n is the number of pages you want to move forward. For example, if you are viewing page 2, + or +1 calls page 3. If there are no more pages, FORMGEN displays the following message on line 24: NO MORE PAGES AVAILABLE -n Calls the previous page if you are currently at a page other than the first (opposite of command +n). If you are at page 1, no previous page exists. In this case, FORMGEN displays the following message on line 24: YOU ARE AT THE FIRST PAGE OF HELP When you finish viewing the help forms, you must Return to the form from which you requested help by entering the letter r in the help functions selection field at the bottom of the help form. When FORMGEN displays the form from which you requested help, the cursor is positioned over the first help character. Reenter the character that was there before you requested help

47 FORMGEN Processor Reference 3.5. User Profile Each authorized user-id has a unique user profile that defines the following characteristics: FORMGEN menu characteristics Default values for most of the fields in the FORMGEN menu Special characteristics used by FORMGEN Default form-level attributes Normally, the site administrator creates the user profiles. However, you can call each user profile menu and either accept the default values or change the values to suit your needs. Calling the User Profile Menus You can call the user profile menus in two ways: 1. Call the DPSPW processor and define your user profile before you call FORMGEN. The default form-level attribute values are attached to all new forms created by FORMGEN. If you define your user profile with the DPSPW processor, these values are present each time you call FORMGEN. 2. Call FORMGEN, then call each user profile menu. The User Profile menus displayed by FORMGEN are the same as those displayed by the DPSPW processor, except that the header contains DPS 2200 FORMGEN PROCESSOR instead of DPS 2200 DPSPW PROCESSOR. Any values you change while in the FORMGEN processor are in effect only until you exit FORMGEN. Therefore, the next time you call FORMGEN, the values defined with the DPSPW processor will be in effect again. The values defined with the DPSPW processor stay in effect until you change them with the DPSPW processor. The user profile values are displayed on nine separate User Profile menus. You may call these menus from the Main Menu or from the menus that display the select functions on line 23. If you: Enter U or U1 and transmit, FORMGEN displays User Profile menu 1. Enter U2, FORMGEN displays User Profile menu 2, and so forth. Transmit with nothing in the select function field, FORMGEN displays the next User Profile menu in sequence. If you are on menu 9, FORMGEN displays menu

48 FORMGEN Processor Reference The following screens show the user profile menus. User Profile Menu 1 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (1 of 9) Form name (<FORM>) Form library (<first configured>) File type _ (<F>-Formlib, O-Omnibus) Omnibus file name (<TPF$>) Auto save count (<1>, 0-99) Expertise level _ (<2>, 1, 3) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP User Profile Menu 2 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (2 of 9) Generate w/s language (<COB>-ASCII COBOL, FOR-FORTRAN, UC-UCS C, UCOB-UCS COBOL) Generate w/s initial values _ (<Y>-Yes, N-No) Generate w/s redefines _ (<N>-No, Y-Yes) Generate w/s storage type _ (<D>-Default, T-Typedef) Generate w/s output type Generate w/s output file _ (<F>-File, R-Repository) (<TPF$.SCREEN->) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

49 FORMGEN Processor Reference User Profile Menu 3 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (3 of 9) Repeat direction _ (<D>-Down, R-Right) Repeat start column (HRP) (<1> - 79) Repeat end column (HRP) (<40>, 1-79) Repeat count (<2> - 80) (24 is maximum value for VRP) Repeat spacing (HRP) (<0> - 78) Repeat lines/occ (VRP) (<1> - 12) Repeat literals _ (<N>-No, Y-Yes) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP User Profile Menu 4 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (4 of 9) Print file name (<SCREEN->) Destination (No default) Copies (<1>-63) Banner (No default) Marking command type _ (<M>-Move, C-Copy) Marked area type _ (<W>-Wrapping, R-Rectangular) Use Repository _ (<N>-No, Y-Yes) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

50 FORMGEN Processor Reference User Profile Menu 5 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (5 of 9) Menu foreground color _ Menu background color _ (<C>-Cyan, B-Blue, E-Ebony, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) (<E>-Ebony, B-Blue, C-Cyan, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) Field highlight _ (<R>-Reverse, N-None) Field foreground color _ (<Y>-Yellow, B-Blue, C-Cyan, E-Ebony, G-Green, M-Magenta, R-Red, W-White) Field background color _ ELMS language (<E>-Ebony, B-Blue, C-Cyan, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) (<ENG>-English) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP User Profile Menu 6 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (6 of 9) Help character (<?>) Alternate menu character _ (<^>) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

51 FORMGEN Processor Reference User Profile Menu 7 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (7 of 9) Security level (<1> - 63) Security type _ (<S>-Soft, H-Hard) Generate prefix _ (<Y>-Yes, N-No) Initial conversation mode _ (<N>-No, Y-Yes) Check number validate _ (<Y>-Yes, N-No) Test mode _ (<N>-No, Y-Yes) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP User Profile Menu 8 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (8 of 9) Background color _ (<E>-Ebony, W-White, R-Red, G-Green, B-Blue, Y-Yellow, M-Magenta, C-Cyan) Foreground: Color _ (<W>-White, E-Ebony, R-Red, G-Green, B-Blue, Y-Yellow, M-Magenta, C-Cyan) Highlight Emphasis Intensity _ Font/Character set _ Control characters _ (<N>-Normal, S-Suppressed, H-High, L-Low) (<N>-None, B-Blink, R-Reverse) (<N>-Normal, U-Underscore, S-Strike, L-Leftcolumn) (<N>-Normal, 1-Alt1) (<N>-None, B-Blink) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

52 FORMGEN Processor Reference User Profile Menu 9 FORM 0 DPS 2200 FORMGEN PROCESSOR User profile (9 of 9) Start image character (<[>) Stop image character (<]>) Field character (<_>) Alternate field character (no default) SOE character (no default) Thousands delimiter (<,>) Decimal point symbol (<.>) Marking character (no default) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP 3.6. Error Handling and Messages When FORMGEN detects an error in displayed data, the field where the error occurs blinks and FORMGEN displays an error message describing the error. The field continues to blink until you enter correct data in the field, transmit it, and FORMGEN accepts it. When FORMGEN accepts it, FORMGEN stops displaying the error message. If multiple fields contain bad data, all of those fields blink. FORMGEN displays an error message relating to the error detected first. When you correct an error, the associated field stops blinking. FORMGEN then deletes the applicable message and displays the message describing the next error. FORMGEN displays information and error messages on line 24. Error messages take priority over information messages. All error messages are displayed before information messages. Following are examples of an information message and an error message: *** FUNCTION IN PROGRESS -- PLEASE WAIT *** ***ERROR: FORM NUMBER OUT OF RANGE OR NOT NUMERIC*** See Appendix A for a listing and explanation of the messages

53 FORMGEN Processor Reference 3.7. Main Menu FORMGEN initially displays the Main Menu each time you call the processor. You can return to the Main Menu either of these two ways: Entering M in the Select function field and pressing XMIT Pressing UPPER FUNCTION and F1 at the same time. In the Main Menu, function keys F1 and F2 perform identical actions. The following screen shows the Main Menu with all fields blank. Explanations for each field in the Main Menu follow. Device: DPS 2200 FORMGEN PROCESSOR Main Menu DPS Level: User Level: Library command (DELETE (workspace), ERASE, NEW, OLD, REPLACE, SAVE) Form name <FORM> Form number <0> File type _ <F> (F-Formlib, O-Omnibus) Form library Omnibus name (q ual*file.elt/vs) Auto save count <1> (0-99) Expertise level _ <2> (1, 2, 3) A = Image/field attributes M = Main menu (F1) V = Initial values D = Repository interface O = Exit with omit (F6) W = Working storage E = Exit with replace (F5) P = Print form X = Execute (display) F = Form-level attributes R = Repeat images L = Image/field layout U = User profile? = Help (any field) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP Device This output-only (OO) field identifies the type of terminal in use. DPS Level This OO field identifies the level of DPS 2200 in use. User Level This OO field identifies the level of user-configured DPS 2200 in use. A site may have more than one configuration of DPS 2200 available for use. Each configuration may meet individual and unique site requirements

54 FORMGEN Processor Reference Library Commands This three-character field selects the operation you want to perform. The following list describes the library commands. Delete (DEL) Deletes the form currently in the workspace. This command clears your workspace, but does not affect the form library. Erase (ERA) Erases data defining a form from a form library. This command does not affect the workspace. Also, you cannot use it to clear data in an omnibus file. You must specify a form number and it must be greater than zero. FORMGEN displays default values for the form library and form name, and you can change them if you wish. If you select expertise level 1 or 2, enter the Erase command twice and transmit after each entry. Do not enter any other data on the Main Menu when you specify the Erase command the second time. If you select expertise level 3, enter the Erase command only once, and the data is erased the first time you transmit. New (NEW) Creates a new form in the workspace. To save a form after you create it, enter the Save command. FORMGEN displays default values for the form library, form name, and form number. If you do not change these values, FORMGEN uses the default values. When these fields are blank, FORMGEN assumes the default values. You must execute a Save, Replace, or Delete command before executing another New or Old command. If you select expertise level 3, you can execute the New command at any time. Old (OLD) Reads a form from storage and transfers it to your workspace when you want to modify it or copy it to another form. You must specify a form number. FORMGEN displays the default values for the form library and form name, and you can change them if you wish. If you change the form, you must execute a Save, Replace, or Delete command before executing another New or Old command. If you select expertise level 3, you can execute the Old command at any time

55 FORMGEN Processor Reference Replace (REP) Saves a changed form in an area of storage where a copy currently exists. You cannot use this command to replace data in an omnibus file. You must specify a form number. FORMGEN displays the default values for the form and form name, and you can change them if you wish. Save (SAV) Saves the new form with the New command in a form library or an omnibus file. You can specify whether you want the form saved in a form library or an omnibus file. You also can specify the form number where you want FORMGEN to save your form. If you do not specify a form number or if it is zero, FORMGEN searches the form library for the next available form number. After saving your form, FORMGEN displays the form number. FORMGEN displays default values for the form library, form name, and form number. If you do not change these values, FORMGEN uses the default values. Form Name Form name is the name of an existing form you want to modify, or of a form you want to create. The default form name is based on the value in your user-profile. This value is displayed in the OO field next to the Form Name field. Form Number The form number uniquely identifies a form within a form library. Forms with the same number can exist in different form libraries. A form number is required when the ERA, OLD, and REP library commands are used. A form number with a value of zero is valid when the NEW and DEL library commands are used. If the SAV library command is used and the form number is zero, FORMGEN will save the form using the first unused form number found in the form library. FORMGEN will display the form number that was used, in the Form number field, after the form has been successfully saved. The default form number is 0. File Type The file type selects the type of file you want to read data from or write data to. F Form library file O Omnibus file The default file type is based on the value in your user-profile. This value is displayed in the OO field next to the File type field

56 FORMGEN Processor Reference Form Library A form library contains your forms. To obtain a list of the forms in a form library, enter the help character (defined in your user profile) in the Form name or Form number field and the form library name in the Form library field, then press XMIT. If you enter the help character in the Form library field and press XMIT, FORMGEN lists the name of each configured form library, the maximum number of forms that can be stored in each library, and the maximum number of fields that a form can contain. If you select file type F, FORMGEN stores your form in a form library. If you select File type O, FORMGEN stores your form in an omnibus file. When the file type is O, the value in the form library field is used only for sizing. The form library file name is determined when your site administrator configures the system. The default form library name is based on the value in your user profile. Omnibus Name The omnibus name specifies the name of the file where the omnibus version of the form definition is read or stored. You must enter the file name and element name in valid OS 2200 file name syntax. Refer to the ECL End Use and Programming Reference Manual for a description of valid filename syntax. Specify an omnibus file name only if you select the omnibus file type (O). The default omnibus file name is based on the value in your user profile. Auto Save Count The auto save count specifies how often you want FORMGEN to save the data defining the current form in an auto-recovery file. The data is saved after you press XMIT but before data in the workspace is changed. This lets you recover changes made before the last auto recovery, if the system fails. The default auto-save count is based on the value in your user profile. This value is displayed in the OO field next to the Auto save count field. The system counts only those actions performed when you enter the following select functions. A Image/field attributes F Form-level attributes R Repeat images V L Initial values Layout

57 FORMGEN Processor Reference Expertise Level The expertise level lets you select your current level of knowledge or experience with FORMGEN. The default expertise level is based on the value in your user profile. This value is displayed in the OO field next to the Expertise level field. You must select expertise level 1 to perform the tutorial in Section 3 (walk-through mode). The expertise levels allow for the addition of future enhancements to FORMGEN, making it more flexible and more responsive to experience levels. The expertise levels are as follows: Level 1 = Novice You receive the most helpful and detailed messages. You also receive all acknowledge and error messages. Use this level to enter walk-through mode. Level 2 = Intermediate You receive all acknowledge and error messages. Level 3 = Expert You do not receive any acknowledge messages but you receive all error messages. You do not need to enter the Erase library command twice to erase a form from a form library. In addition, you do not need to execute a Save, Replace, or Delete library command before executing the Old or New library command. This level is for the most experienced user. Select Function Enter one of the select function characters in the Select function field, depending on the task you want to perform. The following list describes the select functions. A = Image/field attributes Select this function when you want to display and change the name, type, and attributes of up to five images/fields at one time. FORMGEN displays a maximum of five images/fields above the attribute menu from the form currently in your workspace. These images/fields are numbered sequentially starting with 1. Corresponding numbers are displayed with each image/field name in the attribute menu so that you know which field you are changing. If your form contains more than five images/fields, call the images/fields you are interested in by entering the appropriate values into the Starting Line and Starting Field fields and pressing XMIT

58 FORMGEN Processor Reference If you prefer to select the attributes from a menu or if there is not enough room in the attribute field to display all the attributes, you may call an Alternate Attribute menu. To call this menu, enter the alternate menu character (defined in your user profile) in the leftmost position of the attribute field and press XMIT. The Alternate Attribute menu contains all possible attributes for the image/field. See 3.12 for a more complete explanation of the Image/Field Attributes menu. D = Repository interface Select this function when you want to access the repository. There are three repository menus: one for marked areas, one for attribute areas, and one for table entries. The first menu is selected with the D, D1, or DM functions; the second menu is selected with the D2 or DA functions; and the third menu is selected with the D3 or DT functions. Marked areas and attribute lists can be saved in and retrieved from the repository. The marked areas and attribute lists are used in the layout function to create or modify forms. Saving the marked areas and attribute lists in the repository allows you to define them once, and then use them as many times as you like. See 3.10 for a more complete explanation of the Repository Interface menu. E = Exit with replace (F5) Select this function to exit FORMGEN and save all changes made to the current form. Pressing F5 performs the same action. Exits from the forms that do not contain the Select function field (Image/field layout, Initial values, and Execute) and saves your changes. If it is a new form, it is saved the same as if executing a Save library command. If it is an existing form, it is replaced the same as executing a Replace library command. F = Form-level attributes Select this function to display and change the form-level attributes of the current form. FORMGEN displays these attributes on three separate menus. Enter function code F1, F2, or F3 to call individual menus. If you enter F, FORMGEN displays the first menu. This is the menu changed most often. See 3.8 for a more complete explanation of the Form-Level Attributes menus. L = Image/field layout Select this function to view the current form and to insert, delete, and modify existing images, fields, text constants, and emphasis constants. At expertise level 1, FORMGEN displays an information form explaining image/field layout. (See step 9 in the walk-through procedure in Section 2 for an explanation of calling the Image/field layout form when you finish reading the information form.) At expertise levels 2 and 3, FORMGEN does not display the information form but goes directly to the Image/field layout form

59 FORMGEN Processor Reference When you call the Image/field layout form by entering L or L1 in the Select function field, FORMGEN lets you lay out your new form or modify the form you transferred into your workspace with the OLD command. When you enter L2 to call the Image/field layout form, FORMGEN displays your form with all images and fields deleted. It displays constants and emphasis text characters only. You must enter the image and field characters. When you modify an image/field, it retains the name, type, and attributes of the original image/field. An image/field is defined as a modified image/field if the new image/field is contained within the original image/field. For example, if you break up a large field into three smaller fields, the modified field is defined as that field where the beginning row and column positions most closely match the beginning row and column positions of the original large field. When you create a new form, it is blank the first time FORMGEN displays it. When you finish entering data or changing existing data, press XMIT. FORMGEN displays an information message momentarily on line 24 and then redisplays your form. If you are satisfied with the form, press XMIT again and FORMGEN displays the menu from which the layout function was called. If you are not satisfied with the form after the first transmit, make your changes and go through the two-transmit sequence again. After exiting from the layout function, FORMGEN returns to the previously executed function. Press F1 to return to the Main Menu. A marking capability is available in the Image/field layout form. This capability enables you to mark an area, using the marking character, and move or copy this area to a different location in the form. You can also move or copy a marked area to a different form. See for a more complete explanation of the marking capability. If you mistakenly enter bad data and transmit, FORMGEN detects the bad data and displays an error message on line 24. Because of the full-screen capability, which saves all changes made to a form, press function key 2 (F2) before transmitting. If you do not, FORMGEN displays another error message. M = Main menu (F1) Select this function to return to the Main Menu. If there is an error on your form, this function is not performed. Pressing F1 performs the same action. However, displayed error messages are ignored and the form is stored as it was after the last transmit sequence without errors

60 FORMGEN Processor Reference O = Exit with omit (F6) Select this function to exit FORMGEN and not save any changes made to the current form since the last save. This function is not executed if there are outstanding error messages. Pressing F6 performs the same action. However, displayed error messages are ignored. P = Print form Select this function to generate a hard copy (listing) of the data defining a form. You can load the data into an output file specified by you or by the system (default). The default output file name is based on the value in your user profile. To print a form different from the form initially identified on the Print Form menu or to print several forms, change the output file name. You can do this by entering the output file name or by erasing the existing output file name. When the output file name field on the Print Form menu is blank, FORMGEN appends the form number to the file name to make it unique. You can generate a hard copy from the workspace, form library, or omnibus file. The values on the Main Menu and whether or not the form is currently in your workspace determine the values FORMGEN displays on the Print Form menu. See 3.14 for a more complete explanation of the Print Form menu. R = Repeat images Select this function to repeat fields with or without text in either the vertical or horizontal directions within the limits of a form. See 3.11 for a more complete explanation of the Repeat Images menu. U = User profile Select this function to display and change user profile values. FORMGEN displays these values on nine separate User Profile menus. You may call these menus from the Main Menu or from the menus that display the select functions on line 23. If you enter U or U1 and transmit, FORMGEN displays User Profile menu 1. If you enter U2, FORMGEN displays User Profile menu 2, and so forth. If you transmit with nothing in the select function field, FORMGEN displays the next User Profile menu in sequence. If you are on menu 9, FORMGEN displays menu 1. The User Profile menus displayed by FORMGEN are exactly the same as those displayed by the DPSPW processor, except the header contains DPS 2200 FORMGEN PROCESSOR instead of DPS 2200 DPSPW PROCESSOR. See 3.5 for more information about user profile attributes and figures showing each user-profile menu

61 FORMGEN Processor Reference See the DPS 2200 Administration Guide for a description of the User Profile menus for the DPSPW processor. Any values you change while in the FORMGEN processor are in effect only during the current session. V = Initial values Select this function to specify initial values for your alphanumeric and alphabetic fields. At expertise level 1, FORMGEN displays an information form explaining initial values. (See step 12 in the walk-through procedure for an explanation of how to call the Initial Values form when you finish reading the information form.) At expertise levels 2 and 3, FORMGEN does not display the information form but goes directly to the Initial Values form. You can enter the initial values on the Initial Values form. You can enter initial values only in the first occurrence of a repeat. When you define initial values for variable width fields, you may need additional space and have to call the Alternate Initial Values menu. Call the Alternate Initial Values menu by entering the alternate menu character (defined in your user profile) in the leftmost position of the fields in your form. When you finish changing existing data, press XMIT. FORMGEN displays an information message momentarily on line 24 and then redisplays your form. If you are satisfied with the form, press XMIT again and FORMGEN displays the menu from which you called the Initial Values form. If you are not satisfied with the form after the first transmit, change it and go through the two-transmit sequence again. This is not the only way to complete this function. You may use the function keys instead of performing the second transmit. W = Working storage Select this function to generate working storage and store the output in a program file for use by the application programs. These can be either COBOL, FORTRAN, or C statements. They can be generated from the current form or from a form in the form library or omnibus file. The default output file name is based on the value in your user profile. To generate working storage for a form different from the form initially identified on the Generate W/S menu or to generate working storage for several forms, change the program file name. Do this either by entering the program file name or by erasing the existing program file name. When the program file name field on the Generate W/S menu is blank, the default names are used. See 3.14 for a more complete explanation of the Generate W/S menu

62 FORMGEN Processor Reference X = Execute (display) Select this function to see what the current form in your workspace looks like during execution of your program using one of the D$SEND functions. Enter the appropriate execute functions in the Select function field as follows: X or X1 selects the D$SEND function. X2 selects the D$SENDF function. X3 selects the D$SENDF1 function. After displaying the result of the Execute (display) select function, press XMIT to return to the menu from which you entered the select function. To test the editing characteristics of the fields in your form, enter the appropriate execute function in the Select Function field as follows: X4 selects the D$SEND function. X5 selects the D$SENDF function. X6 selects the D$SENDF1 function. After displaying the form, you can enter data in the fields and transmit. The D$READ function reads the data and the appropriate send function is called to edit and display the data. If the D$READ function returns a fatal error status in the FCA field-status field, the D$FLDERR function is called to display the appropriate error message. To exit these execute functions, press F1 to return to the main menu. The X7, X8, and X9 values of the execute function are for development use only.? = Help (any field) Use the help character (defined in your user profile) to request an explanation of a field. Most help forms contain a narrative explanation while a few forms list possible values for the Image Attributes menus. Request help by entering the question mark in the leftmost character position of a field and pressing XMIT. The question mark is accepted as input when you execute the Initial Values (V) function or the Execute (display) (X) function

63 FORMGEN Processor Reference Function Keys You can use the function keys to perform several system-defined actions, such as Controlling a sequence of actions Requesting assistance Interrupting program execution When you press a function key, all changes made on the current form since the last transmit sequence are lost (no data is processed). FORMGEN displays the use of each function key, except FKEY11 (F11). The following list describes the function keys. FKEY1 (F1) = Main Menu Press this function key to return to the Main Menu. If you are already in the Main Menu, press F1 to refresh the form. In the Main Menu, F1 and F2 perform identical actions. FKEY2 (F2) = Refresh Press this function key to refresh the current form. When you press this function key, the system deletes any message from line 24 and displays the function key message except when you are viewing the Image/field layout (L), Initial values (V), or Execute (display) (X) forms. When you view either the Image/field layout or Initial Values forms and an error message is displayed, refresh the screen to erase the error message. When you are in the Main Menu, F2 and F1 perform identical actions. FKEY3 (F3) =Undo Auto Press this function key to undo changes made in your form. Each time you change your form and press XMIT, FORMGEN stores the changes. Each time you press function key 3 (F3), FORMGEN reverts your form to the state it was in before your most recent change. You can press F3 as many times as you wish and revert your form back to the state it was in when you executed the last NEW or OLD command. The Undo function is not associated with the auto-save count. Each time you change your form and press XMIT, FORMGEN stores the changes regardless of the auto-save count. The auto-save count does affect the number of changes stored for auto-recovery purposes in the event of a system crash. For example, if your auto-save count is 3 and auto-recovery occurs, you will only lose the changes associated with a maximum of the last three transmit sequences. Auto-recovery causes no additional overhead regardless of the auto-save count. Therefore, it is recommended that you leave your auto-save count at

64 FORMGEN Processor Reference FKEY4 (F4) = Walk-Through Press this function key to select the walk-through mode (tutorial in Section 3). You must select expertise level 1 on the Main Menu before selecting this mode. You can enter walk-through mode only from the Main Menu. FKEY5 (F5) = Exit Press this function key to exit FORMGEN and save all changes to the current form. Choosing select function E and pressing XMIT performs the same action, except that exiting with F5 during an error condition loses any changes made since the last transmit. FKEY6 (F6) = Exit Press this function key to exit FORMGEN but not save any (with omit) changes made to the current form. Choosing select function O and pressing XMIT performs the same action. FKEY7 (F7) = HELP Press this function key to request select function help. You can request help at any time. FKEY11 (F11) = Error Listing Press this function key to generate error listings (dumps). This produces two print files: DPS$FDPABORT and DPSABORT. If an error is detected, use the listing as a diagnostic aid. You can generate a listing at any time; you do not have to wait until FORMGEN displays an error message Form-Level Attributes Menus The Form-Level Attributes menus display the form-level attributes of your current form on three separate menus. You can call this function from the Main Menu or from the menus that display the Select functions on line 23. If you enter F or F1, FORMGEN displays the first menu. If you enter F2, FORMGEN displays the second menu, and so forth. The following screens show the Form-Level Attributes menus. You will likely change the attributes on Menu 1 more often than those on menus 2 and 3. If you transmit when there is nothing in the Select function field, FORMGEN displays the next Form-level Attributes menu. If you are on menu 3, FORMGEN displays menu 1. To use the help character (defined in your user profile) as a special character on menu 3, enter the character twice in the field

65 FORMGEN Processor Reference Form-Level Attributes Menu 1 The following screen shows the first form-level attributes menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Form-level (1 of 3) Final cursor field name <1st I/O field> (Any I/O field) Security level <1> (1-63) Security type _ <S> (H-Hard, S-Soft) Form height <last line of text or images> (1-24) Generate prefix _ <Y> (N-No, Y-Yes) Initial conversation mode _ <N> (N-No, Y-Yes) Check number validate Test mode _ <Y> (N-No, Y-Yes) _ <N> (N-No, Y-Yes) Function keys <N> (A-All, N-None, 1-36) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the form-level attributes. Final cursor field name Specifies cursor positioning after the D$SEND function is performed at run time. The cursor field name must be an I/O field name. If you do not specify a field name, FORMGEN defaults the final cursor field name to the first I/O field on the form. Security level Specifies the security level of your form, by defining the security level that a user must have to access your form. Valid levels are 1 through 63 or the maximum level for your system. A form with the lowest security level (1) can be accessed by anyone. The highest possible security level is 63. You can also set the security level for each field in your form from the Image/Field Attributes menu

66 FORMGEN Processor Reference Security type Specifies how a system checks the security of your form at run time. Soft security means that your security level must be equal to or greater than the security level of the form for you to access it. Hard security means that your security level must exactly equal the security level of the form for you to access it. Form height Specifies the last line of the form; that is, the last protected line of text sent to the screen. Must be equal to or greater than the last line of images, fields, or text, whichever is larger. The default value for this field is the last line containing images, fields, or text. Generate prefix Specifies whether the S# prefix (# is the form number) is attached to the COBOL or C data items when you generate working storage for your form. This attribute applies only when generating COBOL or C working storage. Initial conversation mode Specifies whether your terminal is conversationally linked when DPS 2200 opens your form. Conversation mode lets a transaction specify during output that the next input message from a terminal must be received by a specific transaction. When you select No, the D$OPEN function does not establish the conversation mode. You can use the D$SETRX, D$SETCV, and D$CLCONV functions to control the conversation mode. See the DPS 2200 Programming Reference Manual for additional explanation of the conversation mode. Check number validate Specifies whether DPS 2200 compares the check number in the working-storage header with the check number in the form library at run time. The check number is assigned by the system and is unique to each form. It is an internal system number and you have no control over it. It lets the system verify that, when you run your program, you are using your most recently defined form and not an earlier version. If you enter N, make sure that the copy of your form in working storage for your program is correct. Otherwise, the application programs use an incorrect copy and program activity may be unpredictable

67 FORMGEN Processor Reference Test mode Specifies whether DPS 2200 displays a field marked as a test mode field. DPS 2200 displays a test mode field only if either the form or the terminal is in test mode. If neither the form nor the terminal is in test mode, the program protects the field and does not display it. This capability lets you instruct the program whether to display a field without recompiling the program. Function keys Specifies the acceptable function keys for the application programs using your form. FORMGEN lists these function keys only to remind the programmer which keys are used. You can specify up to 36 function keys. Enter them in sequential order beginning with 1. There are two allowable special entries: N (None) and A (All). The default value is None (N). These function keys are completely separate from the function keys shown on the menus. Note: The default values for these attributes are based on the values defined in your user profile. The default value is displayed in the OO field (second field) next to the attribute field. Form-Level Attributes Menu 2 The following screen shows the second Form-Level Attributes menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Form-level (2 of 3) Background color _ <E> (B-Blue, C-Cyan, E-Ebony, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) Foreground: Color _ <W> (B-Blue, C-Cyan, E-Ebony, G-Green, M-Magenta, R-Red, W-White, Y-Yellow) Intensity _ <N> (H-High, L-Low, N-Normal, S-Suppressed) Highlight <N> (B-Blink, N-None, R-Reverse) Emphasis <N> (L-Leftcolumn, N-Normal, S-Strike, U-Underscore) Font/Character set _ <N> (N-Normal, 1-Alt1) Control characters _ <N> (B-Blink, N-None) I18N CCS Number 35 <35> (O-No Transliteration, Greater Than O-CCS) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

68 FORMGEN Processor Reference The following list describes the form-level attributes. Background color Specifies the color of the background area of the text part of the display. Valid choices are Blue (B) Cyan (C) Ebony (E) Green (G) Magenta (M) Red (R) Yellow (Y) White (W) Foreground Color Specifies the color of the foreground area of the text part of the display. Valid choices are Blue (B) Cyan (C) Ebony (E) Green (G) Magenta (M) Red (R) Yellow (Y) White (W) Foreground Intensity Specifies the intensity of the foreground area of the text part of the display. Valid choices are Suppressed (S) (no display) High (H) Low (L) Normal (N)

69 FORMGEN Processor Reference Highlight Specifies the highlighting of the text part of the display. You may choose any combination of highlight characters. Valid choices are Emphasis None (N) Blinking (B) Reverse video (R) Specifies the type of character emphasis of the display. You may choose any combination. Valid choices are Normal (N) Underscore (U) Strike (S) Leftcolumn (L) Font/Character set Specifies the character font or character set for the display. Valid choices are Normal (N) Alternate (1) Control characters Specifies the control characters that DPS 2200 allows on input during the D$READ run-time function. Control characters are ASCII characters with a decimal value less than 32 (040 octal). Currently, you may specify only blink (B) characters FS=29 (035) and GS=30 (036). Valid choices are None (N) Blink (B) FORMGEN normally removes control characters during input except for LF=10 (012) and FF=12 (014). This attribute lets you use blink characters and applies to all alphanumeric and alphabetic fields in a form

70 FORMGEN Processor Reference I18N CCS Number Specifies the coded character set (CCS) number to be used during DPS output for literal text. Valid choices are Zero (0) (No transliteration prior to sending the screen) Positive integer (An integer that specifies the character set) The default value for the I18N CCS Number is the CCS value taken from the user's locale. Note: The default values for these attributes are based on the values defined in your user profile. The default value is displayed in the OO field (second field) next to the attribute field. Form-Level Attributes Menu 3 The following screen shows the third Form-Level Attributes menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Form-level (3 of 3) Enter special characters: Start image character <[> Stop image character <]> Field character <_> Alternate field character No default SOE character No default Thousands delimiter <,> Decimal point symbol <.> Marking character No default Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

71 FORMGEN Processor Reference The following list describes the form-level attributes. Start image character Defines the starting point of an ON/OFF image on a form that you want DPS 2200 to control separately at run time. An ON/OFF image is a part of a form that you can control separately. This capability lets you control that part of a form enclosed between the start image character ([) and the stop image character (]). At run time, DPS 2200 presents characters to the screen as blanks or displays the fields and text depending on the values of program variables (working storage) Stop image Defines the stopping point of an ON/OFF image on a form that you want DPS 2200 to control separately at run time. For example, if you enclose a field between start and stop image characters ([EDUCATION ]), you can direct DPS 2200 to not display that field. Instead, that area of the screen normally occupied by the EDUCATION field is blank. The ON/OFF image can be turned ON or OFF at run time. You can use this capability for security when you want selected people to view certain information. Field character Defines the I/O, OO, and system-supplied fields on a form. Alternate field character Defines the fields on a form just like the field character. Use the field character and the alternate field character to end one field in the last column of one line and start the next field in the first column of the following line. For example, you can extend a field from one line to the next by using the field character (_) like this: You can also end one field in the last column of a line and start a second field in the first column of the following line by using both the field character (_) and alternate field character (^) like this: ^^^^^^^^^^^^^^^^^

72 FORMGEN Processor Reference SOE character Specifies the SOE substitution character. When initial values are updated for a field where an SOE substitution character is used, all these characters are replaced with the SOE character ( ). If a field currently contains an SOE character, an initial value is not replaced with an SOE character until that initial value is updated. Thousands delimiter Specifies the character used after every third character in an integer. The edit symbols (thousands delimiter and decimal point symbol) must be unique. They cannot be numbers, letters, or a masterspace (@). Also, they cannot be used as replenish characters in the form. Decimal point symbol Specifies the character used as the decimal point symbol. The edit symbols (thousands delimiter and decimal point symbol) must be unique. They cannot be numbers, letters, or a masterspace (@). Also, they cannot be used as replenish characters in the form. Marking character Specifies the character used by the marking function to mark an area in a form (see 3.9). Note: The default values for these attributes are based on the values defined in your user profile. The default value is displayed in the OO field (second field) next to the attribute field Image/Field Layout Functions The image/field layout function enables you to insert, delete, and modify ON/OFF images, fields, text constants, and emphasis constants. For a new form, a blank template is initially displayed when the layout function is entered. For an existing form, the template is displayed showing all ON/OFF images, fields, and constants. ON/OFF images and fields are defined by entering START/STOP image characters and field characters in the template. Text and emphasis constants can be added in any location not occupied by an ON/OFF image or field. ON/OFF images, fields, and constants can be deleted from a form by removing the characters defining them from the template

73 FORMGEN Processor Reference To modify the layout of a form, change the position or length of an ON/OFF image, field, or constant. When the position or length of an ON/OFF image or field is changed, it must overlap the previous location by at least one character position to retain name and attribute information. To exit the layout function, transmit without changing the template or press F Marking Capability The marking function provides marking characters and marking commands enabling you to mark an area of a form and to move, copy, or delete it. This capability includes the following actions: Mark an area in a form by using marking characters, marking commands, or a combination of both. Save a marked area in a scratch pad. Fields, images, constants, and emphasis in the marked area are saved in storage. The scratch pad is located in main storage. A marked area saved into a scratch pad remains there until it is overwritten by another marked area or until you exit FORMGEN. Transfer the marked area, including its attributes, back into the same form or into a different form. Save a marked area in the repository. A marked area remains in the repository until you delete it. There are three types of marking functions: move, copy, and delete. These enable you to manipulate the marked areas in the following ways: Move Copy Delete Moves the marked area to a designated point and deletes the original area. Copies the marked area to a designated point but does not delete the original area. Deletes the marked area from the form and places it in the scratch pad. The marking function uses the values defined in the user profile for the marking command type (move and copy) and the marked area type (wrapping and rectangular) when there are no marking commands specified with the character used to mark the beginning of an area. Rectangular marking cannot go beyond the right boundary of a form. Following are examples of rectangular marking and wrapping marking: Note: The logical AND symbol (^) is used as the marking character in this description. However, this is not the only valid marking character. You can enter the marking character you want on the Form Level Attributes menu

74 FORMGEN Processor Reference Marking Character The marking character is a form-level attribute character that must be defined on the third Form-Level Attributes menu. The marking character has no default and the marking function does not use the marking character defined on the User Profile menu. Therefore if you want to use the marking character, you must define it on the third Form-Level Attributes menu. The layout function performs either a move (M) or a copy (C) depending on what is specified in the Marking command type field in the fourth User Profile menu. The marking function uses the marking character defined as a form level attribute on the Form-Level Attributes menu. The marking function is not aware of the marking character defined in the user profile. The marking character defined in the user profile is a form level attribute when you use the NEW library command to create a new form in your workspace. Use the marking character to mark the beginning and end of an area and also to mark a designated point where you want to insert the marked area when you perform a copy or a move. Using a marking character alone lets you quickly mark an area. However, when you use only a marking character, there are some limitations to what you can do. These limitations follow: You can only move or copy marked areas downward. You must enter three marking characters to perform a move or a copy. Use two characters to mark the area to be moved or copied and one character to designate the position to which to move or copy the marked area. You must enter two marking characters to delete a marked area

75 FORMGEN Processor Reference Marking Commands With marking commands, you have all the capabilities that you do with marking characters plus you can move marked areas down, up, or sideways. You can use command characters and command syntax simultaneously. Here is a description of each command. ^M ^MR ^MW ^ME ^C ^CR ^CW ^CE ^P Marks the beginning of an area that you want to move. The type of marked area (rectangular or wrapping) is determined by the marked area type defined in the user profile. Marks the beginning of an area for a move rectangular procedure. Marks the beginning of an area for a move wrapping procedure. Marks the end of an area for a move procedure. The ME command is optional for a move. You can use only the marking character (^) because when you enter a command to begin marking an area, the system assumes that the next marking character ends the marked area. Marks the beginning of an area that you want to copy. The type of marked area (rectangular or wrapping) is determined by the marked area type defined in the user profile. Marks the beginning of an area for a copy rectangular procedure. Marks the beginning of an area for a copy wrapping procedure. Marks the end of an area for a copy procedure. The CE command is optional for a copy. You can use only the marking character (^) because when you enter a command to begin marking an area, the system assumes that the next marking character ends the marked area. Designates the position where you want to put a marked area. This command does not depend on the marking area type because that is determined by the move (^M) and copy (^C) commands. Note: The logical AND symbol (^) is used as the marking character in this description. However, this is not the only valid marking character. You can enter the marking character you want on the Form Level Attributes menu

76 FORMGEN Processor Reference Marking Characters or Marking Commands in Text When marking characters or marking commands appear in text, the following rules determine the handling of the text: The system cannot distinguish when you enter a valid marking character followed by a valid marking command from the case when you enter a valid marking character followed by text that is the same as a marking command. This means that any text that immediately follows a character command is tested to determine if it is a valid marking command. If you attempt to define a marking character that is already defined as text in a form, the action is rejected and a diagnostic message is generated. If text in a marked area contains the current marking character and you attempt to insert that same marked area, the action is rejected and a diagnostic message is generated Marking Undo You can interrupt a marking activity and restore the data to the way it was at the time of the last update performed by FORMGEN by pressing F3. The undo function is always available for your use Examples of Moves, Copies, and Deletes The following examples show the fields before marking, after marking including the location of the marking characters and commands, and the result after the action is performed

77 FORMGEN Processor Reference

78 FORMGEN Processor Reference Repository Interface You can also use the marking commands to mark an area and save it in the repository. There is a separate repository interface menu for marked areas (see 3.10). Marked Areas Marking commands can also be used to access the repository by appending a digit to the marking command. The digit corresponds to a menu slot in the marked area menu. There are five menu slots in the menu, meaning only digits 1 to 5 can be used. See 3.10 for a description of the Repository Interface Menus. Use the following marking commands to access the repository: ^Mn ^MRn ^MWn ^Pn ^Cn ^CRn ^CWn where n can be 1 through 5 and corresponds to the menu slot number on the Marked Area Repository Interface Menu. All rules for the use of marking commands apply when you use marking commands to access the repository. You cannot access the repository with marking characters only, you must use the marking commands. When you use marking commands to access the repository, they perform their regular function in addition to accessing the repository. The move and copy commands save the marked area in the repository and place the name of the marked area in the corresponding slot of the marked area menu. The put command retrieves the marked area named in the corresponding slot of the marked area menu from the repository and inserts it into the layout of the form

79 FORMGEN Processor Reference When the move and copy commands access the repository, they create a temporary marked area in the repository. This marked area exists for the duration of the FORMGEN session, but is removed from the repository when you exit FORMGEN. You can make the marked area permanent by using the save action in the marked area repository interface menu. Example of Marking Using the Repository The following examples show the fields before marking, after marking including the location of the marking characters and commands, and the results after the action is performed. In this example, a rectangular marked area is moved. The marked area was saved in the scratch pad and also in the repository. The name of the marked area is in the second slot of the Marked Area Repository Interface Menu. Attribute Lists There is one more command that you can use in the layout function to access the repository, the attach attribute list command. The format of this command is ^AL1, ^AL2, ^AL3, ^AL4, or ^AL5. This command attaches the attributes in the attribute list menu slot corresponding to the appended digit in the command. The attributes are attached to the field or image in the form containing the marking character. The attributes are added to any attributes that already exist for the field or image. You can use more than one attach attribute list command at a time in the layout function. For example, you could place an ^AL1 in every field in the form, which would attach the attributes in the first menu slot of the attribute list menu to every field in the form. Or you could place an ^AL4 and ^AL5 in the same field, which would attach the attributes from the fourth and fifth slots of the attribute list menu to that field

80 FORMGEN Processor Reference Example of Attaching Attribute Lists to Images and Fields The following examples show attribute lists being attached to images and fields. In this example, a single attribute list is attached to field 1 and multiple attribute lists are attached to field 2. When an attribute list is attached to an ON/OFF image, the marking character must overwrite either the Start image or Stop image character Repository Interface Menus DPS 2200 can use the Unisys Repository Manager (UREP) during FORMGEN execution to store: A marked area. The marked area can later be retrieved and used to build a new form. Attribute lists. The attribute lists can be retrieved from the repository and attached to fields or images in a new or existing form. A working storage definition form. The working storage definition for a form can be copied into a COBOL or UCS C application during a compile directly from the repository. Table entries. Store tables and entries into the repository that can be referenced by the VC=T attribute. Using the repository allows you to define the forms once, and then use them as often as you need to. This saves time and prevents errors. See Volumes 1 and 2 of the UCS COBOL Programming Reference Manual and Volumes 1 and 2 of the UCS C Programming Reference Manual for a description of the statements you can use to access this information. See the UREP Programming Reference Manual and the UREP Administration Guide for a description of how UREP works and a description of the command language syntax

81 FORMGEN Processor Reference Note: Your DPS 2200 system must be configured to use the repository capability. Contact your System Administrator to see if the repository capability is configured. The repository interface menus let you access the repository. There are three repository menus: one for marked areas, one for attribute lists, and one for table entries. The first menu is selected with the D, D1, or DM functions; the second menu is selected with the D2 or DA functions; and the third menu is selected with the D3 or DT functions. The repository must be enabled in user profile menu 4 before you can use the repository interface menus Marked Area Menu You can create marked areas in the repository by using the marking commands in the layout function. After they are created, you can use the marked area menu to permanently save, retrieve, change names, or remove marked areas from the repository. The menu has five slots. Enter an action code into one or more slots on the menu to select the actions you want performed. When you transmit, the actions are performed. Marked Area Menu The following screen shows the marked area repository interface menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Repository Interface for Marked Areas ACTION MARKED AREA NAME MARKED AREA USER ID SAVED? 1 _ NAME: USER-ID: 2 _ NAME: USER-ID: 3 _ NAME: USER-ID: 4 _ NAME: USER-ID: 5 _ NAME: USER-ID: Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP

82 FORMGEN Processor Reference The following list describes the marked area repository interface menu. ACTION The action to be performed for this menu slot. You can specify the following actions for marked areas in each slot: D E M N R S Delete the contents of the NAME and USER-ID fields for this menu slot. This action does not affect the contents of the repository; it only affects the menu. Erase the marked area with this NAME and USER-ID from the repository. You can only erase marked areas saved under your user-id. Erasing a marked area permanently removes it from the repository. Modify the name of an existing marked area. This enables you to assign a new name to the marked area currently in the menu slot. You cannot modify the USER-ID. Name of the next marked area to be created in this menu slot. After specifying a name, the next ^Cn or ^Mn command (where n is the slot number) will use this name instead of a default name. Retrieve the marked area with this NAME and USER-ID from the repository. After you retrieve a marked area you can insert it into a form layout with the ^Pn command, where n is the corresponding slot in the marking menu. You can retrieve marked areas using any existing USER-ID. Save the marked area with this NAME and USER-ID in the repository. This action causes a marked area created by a ^Cn or ^Mn command to remain in the repository. All temporarily marked areas are removed when you exit FORMGEN. NAME Name of the marked area entity in the repository. The length can be from 1 to 16 characters, and can be A to Z, 0 to 9, $, and -. Default names created by the ^Cn and ^Mn commands are MARKED-AREA-n, where n is 0 to USER-ID The user-id entity under which marked areas are stored in the repository. The length can be from 1 to 12 characters, and can be A to Z, 0 to 9, $, and -. The Erase, Modify, and Save action can be performed only under your user-id. When this field is blank, the default is your user-id

83 FORMGEN Processor Reference Attributes List Menu You can create attribute lists in the repository by entering the attributes directly into the attribute list menu. Then you can save, retrieve, modify, or remove them. The menu has five slots. Enter an action code into one or more slots on the menu to select the actions you want performed. The actions are performed when you transmit. Attributes List Menu The following screen shows the attribute list repository interface menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Repository Interface for Attribute Lists ACTION LIST NAME ATTRIBUTE LIST 1 _ NAME: USER-ID: 2 _ NAME: USER-ID: 3 _ NAME: USER-ID: 4 _ NAME: USER-ID: 5 _ NAME: USER-ID: Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the attribute list repository interface menu. ACTION The action to be performed for this menu slot. You can specify the following actions for the attribute lists in each slot:

84 FORMGEN Processor Reference D E M R S Delete the contents of the NAME, USER-ID, and ATTRIBUTES fields for this menu slot. This action does not affect the contents of the repository, it only affects the menu. Erase the attribute list with this NAME and USER-ID from the repository. You can only erase attribute lists saved under your user-id. Erasing an attribute list permanently removes it from the repository. Modify the name of an existing attribute list. This enables you to assign a new name or attributes to the attribute list currently in the menu slot. You cannot modify the USER-ID. Use the SAVE function to make the changes permanent. Retrieve the attribute list with this NAME and USER-ID from the repository. After you retrieve an attribute list, you can attach it to a field or image with the ^ALn command, where n is the corresponding slot in the attribute list menu. You can retrieve attribute lists using any existing USER-ID. Save the attribute list with this NAME and USER-ID in the repository. This action causes the attribute list to be permanently saved in the repository. NAME Name of the attribute list entity in the repository. The length can be from 1 to 16 characters, and can be A to Z, 0 to 9, $, and -. USER-ID The user-id entity under which attribute lists are stored in the repository. The length can be from 1 to 12 characters, and can be A to Z, 0 to 9, $, and -. The Erase, Modify, and Save action can be performed only under your user-id. When this field is blank, the default is your user-id. ATTRIBUTE LIST The attributes that you want to attach to fields or images. See 3.12 for a complete description of field and image attributes Table Entries Menu You can create table entries in the repository by entering the names directly into the table entries menu. A feature allows you to display all table names from the same menu. All entries are saved under the table name you entered. The menu has a table name entry and 24 fields for entries under the table name. If you need more than the 24 table entries, transmit after you fill the table to provide another screen. There is no limit to the number of entries that may be entered for the table name

85 FORMGEN Processor Reference Table Entries Menu The following screen shows the table entries repository interface menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Repository Interface for Table Entries ACTION _ (C, D, OR L) TABLE-NAME ENTRY01 ENTRY02 ENTRY03 ENTRY04 ENTRY05 ENTRY06 ENTRY07 ENTRY08 ENTRY09 ENTRY10 ENTRY11 ENTRY12 ENTRY13 ENTRY14 ENTRY15 ENTRY16 ENTRY17 ENTRY18 ENTRY19 ENTRY20 ENTRY21 ENTRY22 ENTRY23 ENTRY24 (any number of entries may be entered) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the table entries repository interface menu. ACTION The action to be performed for the TABLE-NAME. The following actions are valid. C D L Create or update the table specified in TABLE NAME with the entries from the nonblank entry fields. First blank terminates scanning. Delete the table specified in TABLE NAME and all table entries associated with that table. List all tables that currently exist in the repository. TABLE-NAME The name of the table to be created, updated, or deleted. ENTRY xx An entry to be inserted in the table specified in TABLE NAME

86 FORMGEN Processor Reference Range Check Menu This menu is displayed when processing a numeric field under the following conditions: The VC attribute is changed to R from the image/field attributes menu. The VC attribute is changed to R from the alternate numeric attribute menu. The image name is changed for a field that already has the VC attribute set to R from the image/field attributes menu. Range Check Menu The following screen shows the range check repository interface menu. FORM 1 DPS 2200 FORMGEN PROCESSOR Repository Interface for Value checking Field name: Enter the RANGE for VC ATTRIBUTE to FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the fields of the range check repository interface menu. Field 1 Field 2 This is the starting range value. This is the ending range value. At run time, the data entered into the field being defined is checked to ensure it is within this range

87 FORMGEN Processor Reference Table Check Menu This menu is displayed when processing an alphabetic/alphanumeric field under the following conditions: The VC attribute is changed to T from the image/field attributes menu. The VC attribute is changed to T from the alternate alphabetic/alphanumeric attribute menu. The image name is changed for a field that already has the VC attribute set to T from the image/field attributes menu. Table Check Menu The following screen shows the table check interface menu. FORM 1 DPS 2200 FORMGEN PROCESSOR Repository Interface for VC=T Attribute Field name: ENTER TABLE NAME FOR THE REPOSITORY FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP Table Check Menu Field Description The field for the table check interface menu is the name of the table in the repository. At run time, the data entered in the field being defined is checked to ensure that it is in this table Repeat Images Menu The Repeat Images menu lets you repeat fields or constants either vertically or horizontally. You can call this form from the Main Menu or from menus displaying the Select functions on line 23. The following screen shows the Repeat Images menu. FORMGEN displays data describing up to three repeats in the lower window. A maximum of 12 lines of data can be displayed in the upper window. The following screen shows that data describing a maximum of three repeat actions can be displayed in the bottom window of the menu. However, if a line in the top window contains more than three images/fields, you can define a repeat for each of them. Even if you define more than three repeat images in a single line, you see only the first three repeats

88 FORMGEN Processor Reference FORM 0 DPS 2200 FORMGEN PROCESSOR Repeat Images STARTING LINE (n,+n,-n) CHG TYPE INDEX NAME DIR ROW S-COL E-COL COUNT SPACING LINES/UNIT LITERALS Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the repeat image attributes. STARTING LINE Specifies the number of the first line of the form appearing at the top of your display. If your form contains more data than you can view on one display, enter a number in this field and press XMIT. This makes the lines of data move up or down. FORMGEN displays the first three repeats after the starting line, that appear in the window. CHG TYPE (change type) Specifies the actions to be performed. The choices are as follows. N I D M Do not change repeat (default) Insert repeat Delete repeat Modify repeat When you enter I, D, or M, the other fields default to their respective values

89 FORMGEN Processor Reference INDEX NAME Specifies a name used to reference a field in a repeat structure. Used in COBOL and C only. Restrictions are as follows: It is a maximum of 16 characters. At least one character must be alphabetic. Characters must be alphanumeric or hyphen (-). A hyphen will be converted to an underscore when generating C working storage. The name must be unique within a form, not including the form name. Leading or trailing hyphens are not allowed. The default value is INDEXn, where n is a unique number. DIR (direction) ROW S-COL E-COL Specifies whether the repeat is vertical (D = down) or horizontal (R = right). Specifies the number of the first line to repeat. The default value is the starting line. Specifies the number of the starting column for a horizontal (starting column) repeat. It must be 1 for vertical repeats. The default value is 1 for vertical repeats and based on the value defined in the user profile for horizontal repeats. Specifies the number of the ending column for a horizontal (ending column) repeat. It must be 80 for vertical repeats. The default value is 80 for vertical repeats and based on the value defined in the user profile for horizontal repeats

90 FORMGEN Processor Reference COUNT Specifies the number of times to repeat an image/field and (repeat count) literal. It must be at least 2. The number you enter into this field is the total number of images/fields and literals present after a repeat, not the repeat count plus the original. The default value is based on the value defined in the user profile. SPACING Specifies the number of blank spaces (columns) between each repeat for a horizontal repeat. It must be 0 for vertical repeats. The default value is 0 for vertical repeats and is based on the value defined in the user profile for horizontal repeats. LINES/UNIT Specifies the number of lines in each repeat occurrence for a vertical repeat. It must be 1 for a horizontal repeat. The default value is 1 for horizontal repeats and is based on the value defined in the user profile for vertical repeats. LITERALS Specifies whether the literals should (Yes) or should not (No) be repeated. The default value is based on the value defined in a user profile Image/Field Attributes Menu The Image/Field Attributes menu lets you define or update the attributes for any individual image or field. These attributes let you define editing characteristics for each image/field, letting you tailor a form to your individual needs. There are default attributes for all field types. You can accept the default values or change them by using this menu. When attributes are redisplayed on the Image/Field Attribute menu, they are shown in alphabetical order with quotation marks around the character attribute values. You can call the Image/Field Attributes menu from the Main Menu or from the menus that display the select functions on line 23. FORMGEN displays the attributes for up to five images/fields at a time in the lower window. A maximum of 12 lines of data is displayed in the upper window

91 FORMGEN Processor Reference The following screen shows the Image/Field Attributes screen. FORM 0 DPS 2200 FORMGEN PROCESSOR Image/Field Attributes current screen STARTING LINE (n,+n,-n) STARTING FIELD (n,+n,-n) IMAGE NAME TYPE ATTRIBUTES ( ^ = alternate select menu) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP _ Attributes for a image/field are normally entered on this menu. As an example, for the background color (BC) of a field/image to be magenta (M) instead of the default ebony (E), enter BC=M in the attributes field. Attributes are redisplayed in alphabetical order, with a comma (,) placed between each attribute (BC=R,FC=G). Also, enclose character attribute values are enclosed in quotation marks, for example, REP= * Image/Field Attribute Descriptions Here is a brief description of some of the fields on the Image/Field Attributes menu. A complete description of all image attributes fields follows the next screen. The IMAGE NAME field lets you assign a unique name identifying a field or image. FORMGEN assigns a default name if none is entered. The TYPE field lets you define the type of data in a field, for example, x = alphanumeric, a = alphabetic, and so forth. Table 3 2 lists all possible field types. The ATTRIBUTES field lets you specify editing characteristics for a field or image. Table 3 4 lists all possible attributes and describes them. Starting Line and Starting Field specify the line and the image or field displayed on the Image Attribute menu. The following paragraphs explain these two fields in more detail

92 FORMGEN Processor Reference Starting Line and Starting Field The starting line number specifies the first line in the top window of the Image Attribute menu. A maximum of 12 lines can be shown in this window. If your form contains more lines than you can view in one window (12), enter the number of the line that you want displayed and press XMIT. This instructs FORMGEN to locate that line and display it on the first line in the top window. The starting field number specifies the current image or field in the first of five lines in the bottom window. Each image or field in the bottom window is identified by placing a number to the left of the image or field name. Each image or field in the top window is identified by replacing the first character of the field with the last digit of the image or field number. These field numbers let you associate an attribute line in the bottom window with an image or field in the top window. You may specify a line number, a field number, or both. FORMGEN attempts to display the requested line in the window and identifies the specified field and the four succeeding fields. Here are some guidelines for using the Starting Line and Starting Field numbers: FORMGEN displays a maximum of 12 lines in the top window (upper portion) of each Image Attributes menu. Each attribute window (bottom window) contains the attributes for five fields, if that many exist. If you enter a Starting Line number but not a Starting Field number, the following rules apply: The line number supersedes the unchanged field number. FORMGEN displays the requested line. If the image or field identified by the current field number is in the window, the field number is not changed. If the image or field identified by the current field number is not in the window, the field number is changed to the number of the first image or field in the window. If there are no images or fields in the window, the field number field is filled with asterisks (*). If you enter a Starting Field number but not a Starting Line number or if you enter both a Starting Field number and a Starting Line number, the following rules apply: The field number supersedes the line number. FORMGEN displays the field specified by the field number. If you do not enter a line number and the requested image or field is in the current window, the window is not changed

93 FORMGEN Processor Reference If you do not enter a line number and the requested image or field is not in the window, FORMGEN changes the window so that the requested field or image is in the top line of the window. If you enter both a line number and a field number, FORMGEN changes the window so that the requested line is in the window if the requested field is also in that window. If you enter both a line number and a field number but the requested field is not in the same window as the requested line, FORMGEN changes the window so that the requested field is in the window (field number takes precedence over the line number). FORMGEN always attempts to display five images or fields in a window. However, FORMGEN does not change a window just so that it can display five images or fields in that window. Instead, FORMGEN identifies only those images or fields in the current window. You may enter both relative line and relative field numbers by a + or preceding the number with a + or a - sign. If you enter only a - in the Starting Line field, FORMGEN scrolls forward or backward 13 lines. If you enter only a + or a - in the Starting Field field, FORMGEN scrolls forward or backward 5 attribute fields. If you enter a 0 in either field, FORMGEN uses a default value of 1. If you enter a blank in either field, FORMGEN remains at the current line number or field number. If you enter an illegal character in either field, FORMGEN remains at the current line number or field number. If you enter an out-of-range number in either field, FORMGEN defaults to the last line number or last field number. FORMGEN displays a line of E* characters at the end of a form if the form ends within a window. The field numbering sequence does not include vertical or horizontal repeats or off characters in ON/OFF images Rules for Specifying Attributes The following statements and examples explain the rules for specifying these attributes. Syntax for Specifying Attributes <attribute-identifier>=(<attribute-value>) Both the <attribute-value> and the accompanying parentheses are optional. If you omit the attribute value, also omit the equal sign and the parentheses

94 FORMGEN Processor Reference Rules for Using Attribute Values If an attribute has a Yes (Y) or No (N) value and a value is not specified, Yes (Y) is assumed. For example, the following two attributes are the same: LZD LZD=Y If an attribute has a value that is not Yes (Y) or No (N), the default value is assumed. For example, the following two attributes are the same: FC FC=W Only attributes whose values are changed to something other than their default value are displayed on the main Image/Field Attributes menu. Attributes that have a Yes (Y) or No (N) value are displayed without the Yes (Y) value. For example: FC=R is displayed because the default for foreground color is W (white). BC=E is not displayed because the default for background color is E (ebony). If you specify an attribute on the main Image/Field Attributes menu that requires other attributes which do not have default values, values are provided. For example, if you enter the OO attribute, TAB=N and PRO are added. The Alternate Attribute menu displays all attribute values. If you enter the OO attribute on the Alternate Attribute menu, enter N in the TAB field and Y in the PRO field, or an error is returned. You cannot leave these fields blank. Therefore, no attribute values change on the Alternate Attribute menus unless you change them. Rules for Using Quotation Marks quotation marks ( open parentheses ) close parentheses, comma = equal sign To use the quotation mark as an attribute value, enter four quotation marks

95 FORMGEN Processor Reference Rules for Using Parentheses Parentheses are necessary only when you specify more than one value for an attribute. This is because leading, embedded, and trailing spaces are ignored if they are outside of quotation marks. The number of opening parentheses must be the same as the number of closing parentheses. For example: EMP=(L,S,U) Rules for Using Commas Use commas when specifying multiple attributes, because spaces are not interpreted as delimiters. For example: HI=B,REP="*", Multiple commas between attributes are interpreted as a single comma. For example: HI=B,,,,REP="*",,,,,, is the same as HI=B,REP="*", Alternate Attributes Menu If necessary, you can define attributes for a field until there is no room in the attributes field. When the attributes field is not large enough for all the required attributes, call an Alternate Attributes menu by entering a carat ( ^ ) and pressing XMIT. The Alternate Attributes menu contains all possible attributes for an image/field. The image/field name and field type are shown on the Alternate Attributes menu as Image/Field name and Image/Field type respectively. When the attributes field on the Image/Field Attributes menu is not large enough, FORMGEN fills the attributes field with * characters. The Alternate Attributes menu must be called to see what attributes are in effect and to make changes. Attributes shown on the Alternate Attributes menu can be changed by tabbing to the desired field and entering the appropriate value

96 FORMGEN Processor Reference Alternate Attributes Menu The following screen shows an example of an Alternate Attributes menu. Default values are enclosed in brackets. Table 3 4 lists all possible attributes and describes them. FORM 0 DPS 2200 FORMGEN PROCESSOR Image/Field Attributes Field name: Field type: BC _ (<E>, B, C, G, M, R, W, Y) SECT _ (<S>, H) FC _ (<W>, B, C, E, G, M, R, Y) SECF (<N>, PB, PD) FI _ (<N>, H, L, S) SECL (<1> - 63) FONT _ (<N>, 1) REP (no default) CON _ (<S>, B, R) RFB (no default) EMP (<N>, L, S, U)* MWID (<INIT WIDTH> -1920) HI _ (<N>, B, C, R)* VC _ (<N>, T) * (NOTE: A list of attribute values may be specified for EMP and HI.) Justification (<NJ>, CJ, LJ, RJ) Blank Input (<BLNK>, NIB) Positioning (<VPOS>, FPOS) Usage (<IO>, OO) Case (<EC>, UC) TAB _ (<Y>, N) REPN _ (<N>, Y) TDEP _ (<N>, Y) F _ (<N>, Y) MOD _ (<N>, Y) PRO _ (<N>, Y) VWID _ (<N>, Y) AQ _ (<N>, Y) FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the fields. Image/field name Identifies a specific field in the form you are defining or changing. You must enter this name for all fields except system-supplied fields and linked ON/OFF images, or the system uses a default name. DPS 2200 uses this name as part of the COBOL, FORTRAN or C name when it generates working storage. The default value is IMAGEn, where n is a unique number. Restrictions are as follows: At least one character must be alphabetic. Characters must be alphanumeric or hyphen ( - ). A hyphen will be converted to an underscore when generating C working storage. The name must be unique within a form, not including the form name. The name cannot exceed 16 characters. It is shortened to 6 characters when generating working storage in FORTRAN. Leading or trailing hyphens are not allowed

97 FORMGEN Processor Reference Image/field type Defines editing of user data and definition of the form when FORMGEN generates working storage. See Table 3 2 for a listing of Image Attributes field types. The default value is X (alphanumeric field type) or O (ON/OFF images). Attributes Specifies editing and display characteristics in your forms for all images/fields. Table 3 3 through Table 3 5 list the attributes that can be used with the different field types. When you enter certain attributes, additional attributes are automatically assigned by FORMGEN. See Table 3-5 for a list of mutually exclusive attributes Attribute Descriptions This subsection describes the field types and attributes you specify on the Image/Field Attributes menu (see 3.12) General Descriptions Table 3 2 through Table 3 10 list the following general information: Image/field types Attributes for system-supplied fields Description of all image/field attributes Mutually exclusive attributes Attributes for other field types Attributes for on/off images Image/Field Types Table 3 2 lists each field type, the COBOL, FORTRAN, and C representations, and maximum field size. You can use any of the field types listed in the table. However, some field types limit the attributes that you can assign to the field. Following are some limitations for field types S and B: Field Type B (exact binary) always defines an OO field. Therefore, you do not have to specify usage (input/output or output-only). Field Type S (system-supplied field) defines a field that DPS 2200 generates or loads data into at run time. In other words, DPS 2200 controls all characteristics of the field. The applications program does not need to be aware of and does not know that type-s fields appear in a form. Defining a field as a type-s field protects the field. If you are using ASCII FORTRAN, the maximum length of an A OR X type field is 511 characters. This limit does not apply if you are using UCS FORTRAN

98 FORMGEN Processor Reference Table 3 2. Image/Field Types Type COBOL FORTRAN C Maximum Size A = Alphabetic* PIC A Characters char 1920 characters B = Exact Binary ** C = Numeric Computational *** PIC (#) Bits int:# 24 octal digits (72 bits) PIC 9(#) COMP Bits int:# 26 positions (18 digits before the decimal point after the decimal point or both before and after) D = Double Precision COMP-2 I = Integer PIC 9(10) COMP Double Precision double Integer int 10 digits 16 significant digits L = Linked ON/OFF N = Numeric Display None None None 1918 characters PIC 9(#) Characters char 26 positions (18 digits before the decimal point after the decimal point or both before and after) O = ON/OFF None None None 1920 characters R = Real COMP-1 Real float 8 significant digits X = Alphanumeric PIC X Characters char 1920 characters S = System Supplied **** **** **** Determined by system-supplied field type. See Table 3 3. Legend * If you are using ASCII FORTRAN, the maximum length of an A or X type field is 511 characters. This limit does not apply if you are using UCS FORTRAN. ** If you are using UC, the maximum length of a B type field is 12 octal digits (36 bits). *** If you are using UC, the maximum length of a C type field is 10 digits rather than 18 digits. **** Generated by DPS 2200 at run time. There is no working storage

99 FORMGEN Processor Reference Restrictions for Field Types When you define a field to use with eportal or TIP Connector terminal type, only the A, C, I, L, N, O, X, and S field types are supported. The B, D, and R field types are restricted. Defining the B, D, and R field types in your DPS form to use with eportal or TIP Connector yields unpredictable results. System-Supplied Field Types When you define a field as a system-supplied field (Type S), also define for what that field is used. Following are two examples of how to use type-s fields: To display the current page count in a type-s field, designate that field with the attribute CPC (current page counter). To display the current user ID in a type-s field, designate that field with the attribute UID (user ID). Table 3 3 lists the attribute name, description, and contents of each system-supplied field. Enter these values into the attributes fields. In the table, LJSF means left-justified, space-filled and RJSF means right-justified, space-filled. Table 3 3. System-Supplied Field Types Description FORMGEN Description Format Size FLDP CONV CPC Conversation Mode (Yes or No) Current Page Counter LJSF 3 CONVERSATION_MODE RJSF 4 CURRENT_PAGE_COUN T D1 Date Format 1 DD/MM/YYYY 10 DATE_1 D2 Date Format 2 DD/MM/YY 8 DATE_2 D3 Date Format 3 DD/MMM/YYYY 11 DATE_3 D4 Date Format 4 DD/MMM/YY 9 DATE_4 D5 Date Format 5 MM/DD/YY 8 DATE_5 D6 Date Format 6 MM/DD/YYYY 10 DATE_6 D7 Date Format 7 DDD-YY (Julian) 6 DATE_7 D8 Date Format 8 YY/MM/DD 8 DATE_8 DPC Data Page Count RJSF 4 DATA_PAGE_COUNT DPSL Current DPS Level LJSF 8 DPS_LEVEL ERHD Error Header Line LJSF 78 (columns 2-79) ERRL Error Line LJSF 78 (columns 2-79) ERROR_HEADER ERROR FNA Form Name LJSF 8 FORM_NAME

100 FORMGEN Processor Reference Table 3 3. System-Supplied Field Types Description FORMGEN Description Format Size FLDP FNB Form Number RJSF 4 FORM_NUMBER FSL Form Security Level RJSF 2 FORM_SECURITY_LEVE L HDRL Message Header Line LJSF 78 (columns 2-79) HEADER IPC Index Page Count RJSF 4 INDEX_PAGE_COUNT ISL LPID Image/Field Security Level Large Terminal Position Identifier (input terminal identification) RJSF 2 IMAGE_SECURITY_LEVE L RJSF 6 LPID NILL Nonfield Blanks for as much space as allocated Up to 511 NIL PID Position Identifier (input terminal identification) RJSF 4 PID T1 Time Format 1 HH:MM 5 TIME_1 T2 Time Format 2 HH:MM:SS 8 TIME_2 T3 Time Format 3 HH:MM:SS:MM M 12 TIME_3 TEST Test Mode (Yes or No) LJSF 3 TEST_MODE TPC Total Page Count RJSF 4 TOTAL_PAGE_COUNT TRX Transaction Code LJSF 6 TRANSACTION_CODE UF1 User Special Field LJSF 1-12 USER_FIELD_1 UF2 User Special Field LJSF 1-12 USER_FIELD_2 UF3 User Special Field LJSF 1-12 USER_FIELD_3 UF4 User Special Field LJSF 1-12 USER_FIELD_4 UF5 User Special Field LJSF 1-12 USER_FIELD_5 UID Current User ID LJSF 12 USER_ID UL Current User Level LJSF 8 USER_LEVEL

101 FORMGEN Processor Reference You may specify the following additional attributes for type-s fields: SECF (<N>, PB, PD) SECL (<1>, - 63) SECT (<S>, H) TDEP (<N>, Y) Notes: Fields UF1 through UF5 must be initialized by the D$PUTUFLD function (see the DPS 2200 Programming Reference Manual). When defining a system-supplied field, except for UF1 through UF5, you need only define the start character. Because DPS 2200 knows the size of the field, the starting position is sufficient and the field is extended or truncated to its actual size. The size of the UF1 through UF5 fields is specified when a form is defined and can be from 1 to 12 characters. General Attribute Descriptions Table 3 4 lists each attribute in alphabetical order and gives the following information: Valid values Description List of allowed field types See for more detailed attribute information for each field type

102 FORMGEN Processor Reference Table 3 4. Attribute Descriptions Attribute AQ BC: B C E G M R W Y BLNK Description Allows a question mark to be entered in all I/O field types. A status of 8 is returned if the field contains a question mark during data transmission. The working storage header cell, S#-QUERY-STATUS, is loaded with the total number of I/O fields containing a question mark. Using this attribute affects the allowable characters for the field. For example, if you specify the AQ attribute on the N, I, D, or R characters, you can enter a question mark in addition to other alpha characters. If you enter alpha characters other than the question mark, you receive a field warning status. Background color: Blue Cyan Ebony Green Magenta Red White Yellow Store blanks in the working storage data item if the field is entered as blanks during input. Allowed Field Types A,C,D,I,N,R,X A,B,C,D,I,N,O,R,X A,X BZ Blank if zero. B,C,D,I,N,R CJ CON: S B R Center justification. During output, the number of leading spaces and the number of trailing spaces are divided in half so that the number of leading spaces is made equal to the number of trailing spaces. During input of alphabetic and alphanumeric fields, the same action is taken. During input of numeric fields, no changes are made. Specifies the initial state of an ON/OFF image. Storage - Display the data from working storage in the field. Blank - Transfer blanks (spaces) to the field. Replenish - Display replenish characters. A,C,D,I,N,R,X A,B,C,D,I,N,O,R,X CR Store CR (credit sign) at end of field if positive. C,D,I,N,R DB Store DB (debit sign) at end of field if negative. C,D,I,N,R DEC Display binary field in decimal. B

103 FORMGEN Processor Reference Table 3 4. Attribute Descriptions DEL Attribute Description Insert the delimiter character before every third digit preceding the decimal point. You can define this delimiter in the Form-Level Attributes menu. Allowed Field Types C,D,I,N,R DPS Display positive and negative signs. C,D,I,N,R EC Either case is allowed. A,X EMP: L N S U EXP F FC: B C E G M R W Y FI: H L N S Emphasis characters: Column left None Strike through Underscore Specifies whether exponential notation is allowed in a real or double-precision field. Fields must be filled. Alphabetic and alphanumeric fields must contain nonblanks, and numeric and computational fields must contain nonzeros. Foreground color: Blue Cyan Ebony Green Magenta Red White Yellow Foreground intensity: High Low Normal Suppressed A,B,C,D,I,N,O,R,X D,R A,C,D,I,N,R,X A,B,C,D,I,N,O,R,X A,B,C,D,I,N,O,R,X FMS Display floating monetary sign. C,D,I,N,R FONT: N 1 FPOS Font or character set for characters: Normal Alternate-1 Fixed field position. Prevents the field from being moved when the size or position of a preceding field changes. A,B,C,D,I,N,O,R,X A,B,D,C,I,N,R,X

104 FORMGEN Processor Reference Table 3 4. Attribute Descriptions Attribute Description Allowed Field Types HI B C N R IO LJ Highlight: Blink Correction Normal Reverse video Indicates Input/Output field. Unless the field is protected with the PRO attribute or the security check fails, you may enter data into this field as well as display the data. Left justification. During output, all leading spaces are changed to trailing spaces. During input of alphabetic and alphanumeric fields, all leading spaces are changed to trailing spaces. During input of numeric fields, no changes are made. A,B,C,D,I,N,O,R,X A,C,D,I,N,R,X A,C,D,I,N,R,X LMS Display leading fixed monetary sign. C,D,I,N,R LS Floating leading numeric sign. C,D,I,N,R LZD Display leading zeros on output. C,D,I,N,R MOD MWID NIB NJ Specifies setting the modified bit during output. Read the field during input, whether it was modified or not. This attribute sets the dynamic character in working storage to M or E. Maximum width for a variable-width field. This attribute can be set to a value greater than the initial field width when the variable-width attribute is set to Yes (VWID = Y). Do not store zeros or blanks in the working storage data item if the field is entered as blanks during input. No justification. The value in working storage must remain intact. A,C,D,I,N,R,X A,X A,C,D,I,N,R,X A,C,D,I,N,R,X NMS Display no monetary sign. C,D,I,N,R NS Field does not have a sign and cannot be negative. C,D,I,N,R OCT Display binary (B) fields in octal format. B OO Output-only field. The field is protected at the terminal, preventing anyone from entering data into the field. When this attribute is set, the default protect attribute (PRO) must also be set. A,C,D,I,N,R,X

105 FORMGEN Processor Reference Table 3 4. Attribute Descriptions Attribute PRO REF = string REPN REP = char RFB = char RJ SECF: N PB PD Description Specifies whether to protect the data when it is displayed. This attribute is similar to the output attribute (OO), except it sets the dynamic character in working storage instead of the field type; that is, the field may be unprotected at run time. Specifies the name of the ON/OFF image linked to this image. Return a field status of 7 if a field contains all replenish (initial) characters during transmission. Allows definition of a replenish character (initial character). This character fills the field except during input when the initial character represents a space. The replenish character (initial character) substitutes for blanks. Conversion occurs during output. Right justification. It cannot be used if the field covers more than one line. During output, all trailing spaces are changed to leading spaces. This may mean that a leading monetary sign is not in the first position. During input of alphabetic and alphanumeric fields, all trailing spaces are changed to leading spaces. During input of numeric fields, no changes are made. Security check fail action return: Normal Protected Blanks. If the security check fails, the field is displayed with protected blanks. Allowed only if security level is greater than 1. Protected Data. If the security check fails, the field is displayed with protected working storage. Allowed only if security level is greater than 1. Allowed Field Types A,B,C,D,I,N,R,X A,C,D,I,N,R,X A,C,D,I,N,R,X A,C,D,I,N,R,X A,C,D,I,N,R,X A,B,C,D,I,N,O,R,S, X SECL Security level of an image or field. A,B,C,D,I,N,O,R,S, X SECT: S H Security type: Soft. Specifies that an end user s security level must be equal to or greater than the security level of the image or field being accessed. Hard. Specifies that an end user s security level must be the same as the security level of the image or field being accessed. A,B,C,D,I,N,O,R,S, X

106 FORMGEN Processor Reference Table 3 4. Attribute Descriptions TAB TDEP Attribute Description Place tab stop at beginning of a field. This attribute has no effect on IBM 3270 and Dataspeed terminals, because these terminals always place a tab stop at the start of each unprotected field. Test-dependent. Specifies whether to check the terminal test mode before displaying the image or field (see form-level TEST MODE attribute or TMODE processor). Allowed Field Types A,C,D,I,N,R,X A,B,C,D,I,N,O,R,S, X TS Trailing numeric sign. C,D,I,N,R UC Convert all input and output to uppercase letters. A,X V= number Field has number digits in the fraction part of a numeric or computational field. The number must be between 0 and 18, inclusive. C,D,I,N,R VC: N T R VPOS VWID Security type: No data validation Use a table of valid values. The values must be within a specified range. Variable position. Moves the field when the immediately preceding field or image changes size or moves. Variable-width field. The horizontal size of the displayed field is variable. Specify the maximum width of the field with the MWID attribute. A,N,X A,B,C,D,I,L,N,O,R, S,X A,X ZB Zero if blank (always assumed). C,D,I,N,R Mutually Exclusive Attributes Some attributes cannot be used at the same time as other attributes. Table 3 5 lists the attributes that cannot be used together (mutually exclusive). If an attribute is not listed in this table, it can be used with other attributes. See Table 3 4 for a list of allowed attributes. Table 3 5. Mutually Exclusive Attributes Attribute Mutually Exclusive Attributes AQ BLNK CJ OO NIB, ZB RJ, LJ, NJ

107 FORMGEN Processor Reference Table 3 5. Mutually Exclusive Attributes Attribute CR DB DEC DEL DPS EC EXP F FMS FPOS IO LJ LMS LS MOD NIB NJ NMS NS OCT OO REP RFB RJ Mutually Exclusive Attributes DB, NS, DPS, LS, TS, EXP CR, LS, NS, DPS, TS, EXP OCT EXP NS, DB, CR UC TS, DB, CR, DEL ZB LMS, NMS VPOS OO RJ, CJ, NJ FMS, NMS TS, NS, DB, CR OO ZB, BLNK CJ, LJ, RJ LMS, FMS TS, LS, DPS, DB, CR DEC TAB, REP, RFB, MOD, IO, AQ, VC OO, RFB OO, REP LJ, CJ, NJ SECF SECF = PB or PD only if SECL > 1 SECL TAB TS UC VC VPOS ZB SECL > 1 only if SECF = PB or PD OO LS, NS, DB, CR, EXP EC OO FPOS F, NIB, BLNK

108 FORMGEN Processor Reference Attribute Choices for Specific Field Types Table 3 6 through Table 3 10 provide the following information: Attributes for specific field types Attributes for On/Off images Default values are enclosed in lesser-than (<) and greater-than (>) symbols. Field Types A and X Table 3 6. Attribute Choices for Field Types A and X Attribute Choices AQ BC Blank Input Case CON EMP F FC FI < N >, Y < E >, B, C, G, M, R, W, Y < BLNK >, NIB < EC >, UC < S >, B, R < N >, L, S, U (Multiple values may be entered.) < N >, Y < W >, B, C, E, G, M, R, Y < N >, H, L, S FONT < N >, 1 HI Justification MOD < N >, B, C, R (Multiple values may be entered.) < NJ >, CJ, LJ, RJ < N >, Y MWID < initial width > Positioning PRO REP REPN RFB SECF < VPOS >, FPOS < N >, Y character < N >, Y character < N >, PB, PD SECL < 1 > - 63 SECT TAB TDEP < S >, H < Y >, N < N >, Y

109 FORMGEN Processor Reference Table 3 6. Attribute Choices for Field Types A and X Attribute Choices Usage VC VWID < IO >, OO < N >, T < N >, Y Field Type B Table 3 7. Attribute Choices for Field Type B Attribute Choices BC BZ CON EMP FC FI < E >, B, C, G, M, R, W, Y < N >, Y < S >, B < N >, L, S, U (Multiple values may be entered.) < W >, B, C, E, G, M, R, Y < N >, H, L, S FONT < N >, 1 HI Positioning RADIX SECF < N >, B, R (Multiple values may be entered.) < VPOS >, FPOS < DEC >, OCT < N >, PB, PD SECL < 1 > - 63 SECT TDEP < S >, H < N >, Y

110 FORMGEN Processor Reference Field Types C, I, and N Table 3 8. Attribute Choices for Field Types C, I, and N Attribute Choices AQ BC Blank Input BZ CON DEL DPS EMP F FC FI < N >, Y < E >, B, C, G, M, R, W, Y < ZB >, NIB < N >, Y < S >, B, R < N >, Y < N >, Y < N >, L, S, U (Multiple values may be entered.) < N >, Y < W >, B, C, E, G, M, R, Y < N >, H, L, S FONT < N >, 1 HI Justification LZD MOD Monetary Sign Numeric Sign Positioning PRO REP REPN RFB SECF < N >, B, C, R (Multiple values may be entered.) < RJ >, CJ, LJ, NJ < N >, Y < N >, Y < NMS >, FMS, LMS < NS >, CR, DB, LS, TS < VPOS >, FPOS < N >, Y character < N >, Y character < N >, PB, PD SECL < 1 > - 63 SECT TAB TDEP Usage < S >, H < Y >, N < N >, Y < IO >, OO V=n < 0 > - 18 VC < N >, R (Can be set to R only for field type N.)

111 FORMGEN Processor Reference Field Types R and D Table 3 9. Attribute Choices for Field Types R and D Attribute Choices AQ BC Blank Input BZ CON DEL DPS EMP EXP F FC FI < N >, Y < E >, B, C, G, M, R, W, Y < ZB >, NIB < N >, Y < S >, B, R < N >, Y < N >, Y < N >, L, S, U (Multiple values may be entered.) < N >, Y < N >, Y < W >, B, C, E, G, M, R, Y < N >, H, L, S FONT < N >, 1 HI Justification LZD MOD Monetary Sign Numeric Sign Positioning PRO REP REPN RFB SECF < N >, B, C, R (Multiple values may be entered.) < RJ >, CJ, LJ, NJ < N >, Y < N >, Y < NMS >, FMS, LMS < NS >, CR, DB, LS, TS < VPOS >, FPOS < N >, Y character < N >, Y character < N >, PB, PD SECL < 1 > - 63 SECT TAB TDEP Usage < S >, H < Y >, N < N >, Y < IO >, OO

112 FORMGEN Processor Reference Table 3 9. Attribute Choices for Field Types R and D Attribute Choices V=n < 0 > - 18 ON/OFF Images Table Attribute Choices for ON/OFF Images Attribute Choices BC CON EMP FC FI < E >, B, C, G, M, R, W, Y < S >, B < N >, L, S, U (Multiple values may be entered.) < W >, B, C, E, G, M, R, Y < N >, H, L, S FONT < N >, 1 HI < N >, B, R (Multiple values may be entered.) SECL < 1 > - 63 SECT TDEP < S >, H < N >, Y

113 FORMGEN Processor Reference Generate W/S Menu The Generate W/S menu lets you create an output element and store the data structures defining your form in that element. To use the default element name, do not enter anything into the output field. The application programs read the data from this element. Instruct FORMGEN to store the data in either COBOL, FORTRAN, or C depending on your application programs. Before you include working storage into your application programs, call the Procedure Definition Processor (@PDP) to process working storage. Generate W/S Menu The following screen shows the Generate W/S menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Generate W/S Form name Form number Workspace _ (Y-Yes, N-No) File type _ <F> (F-Formlib, O-Omnibus) Form library SCREEN$FILE Omnibus name (qual*file.elt/vs) Language <COB> (COB-ASCII COBOL, FOR-FORTRAN, UC-UCS C, UCOB-UCS COBOL) Output type _ <F> (F-File, R-Repository) Initial values _ <Y> (N-No, Y-Yes) Generate prefix _ (N-No, Y-Yes) Allow redefine _ <N> (N-No, Y-Yes) Storage type _ <D> (D-Default, T-Typedef) Output (qual*file.elt/vs) Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the Generate W/S menu fields. Form name Name of the form for which to generate working storage. Form number Number of the form for which to generate working storage

114 FORMGEN Processor Reference Workspace Specifies whether the form for which you want to generate working storage is in the workspace. If you execute the New or Old library command from the Main Menu immediately before generating working storage, the form is in the workspace (see 3.7 for a description of these library commands). In this case, accept the default value of Yes. You do not have to generate working storage from the workspace. If you did not execute the New or Old library command immediately before generating working storage, the form is in the form library or omnibus file. In this case, enter a N (No). The form must be in the form library or omnibus file or FORMGEN displays an error message. If the value in the workspace field is Yes, the following fields are ignored: File type Form name Form number File type Form library name Omnibus file name Specifies whether the form is in the form library or an omnibus file: F= Form library file O = Omnibus file The default file type is based on the value in your user profile. This value is displayed in the OO field next to the File type field. Form library If you select File type F, FORMGEN generates working storage for a form in a form library. If you select File type O, use this field only to size the omnibus element. In other words, compare the number of fields allowed with the number of fields in the omnibus element. The default form library name is based on the value in your user profile. Omnibus name Specifies the file from which you read your form if it is in an omnibus file. Enter the file name in valid OS 2200 file name syntax. Specify an omnibus file name only when you select an omnibus file type. The default omnibus file name is based on the value in your user profile

115 FORMGEN Processor Reference Language Specifies the programming language while generating Working Storage. The available languages are COB = ASCII COBOL FOR and FTN = FORTRAN UC = UCS C UCOB = UCS COBOL The default language is based on the value in your user profile. This value is displayed in the OO field next to the Language field. If the Output Type field specifies that the working storage is stored in the repository, the Language field must be COB, UC, or UCOB. Output type Specifies whether working storage is stored in an element or in the repository. F = File R = Repository If data is stored in a file and you specify COB in the Language field, it is in ASCII COBOL format. If you specify UCOB, data is stored in UCS COBOL format. If the data is stored in the repository, the data is in UCS COBOL format regardless of the language you specify. The default output type is based on the value defined in your user profile. This value is displayed in the OO field next to the Output Type field. Initial values Specifies whether DPS 2200 generates initial values for COBOL or C data items. If you enter No, DPS 2200 does not generate value clauses for fields with defined initial values. The default value is based on the value in your user profile. This value is displayed in the OO field next to the Initial values field. This field applies only to COBOL and C. If the Output Type field specifies that the working storage is stored in the repository, the Initial Values field must be Y

116 FORMGEN Processor Reference Generate prefix Specifies whether DPS 2200 generates prefixes (S #MDNM, where # is the form number) for COBOL or C data items. If you do not enter anything, it is loaded with the value from the Generate Prefix field on the first Form-Level Attributes menu. If you enter Yes or No, the generated prefix value overrides the value on the first Form-Level Attributes menu. Allow redefine Specifies whether to create working storage that can be redefined. If you enter Yes, two forms can use the same data area for working storage. In this case, DPS 2200 uses 02 level data items. This field applies only to COBOL working storage. Only one form uses data from working storage. In this case, there is no need for a level 02 data item because there is only one form. If the Output Type field specifies that the working storage is stored in the repository, the Allow Redefine field must be N. Storage type Specifies the type of UC working storage. The values are D = DEFAULT. T = TYPEDEF. D generates a data structure that actually defines storage. T generates a UC typedef data structure. Output Specifies the file where FORMGEN transfers your form if it is different from the default file and whether to generate working storage in COBOL (COBP), FORTRAN (FTNP), or C (H). The default output file name is based on the value in your user profile

117 FORMGEN Processor Reference Print Form Menu The Print Form menu lets you generate a hard copy (listing) of the information in your form. The listing contains the following information: General form information Form showing literals Form showing initial values and input fields Form showing emphasis characters, if applicable Images/fields sorted by their position on the form and their attributes Print Form Menu The following screen shows the Print Form menu. FORM 0 DPS 2200 FORMGEN PROCESSOR Print Form Form name Form number Workspace _ (Y-Yes, N-No) File type _ <F> (F-Formlib, O-Omnibus) Form library SCREEN$FILE Omnibus name (qual*file.elt/vs) Output (qual*file(+1).elt/vs) Site output _ <N> (Y-Yes, N-No) Retain output _ <N> (Y-Yes, N-No) Destination Copies Banner Select function (A,D,E,F,L,M,O,P,R,U,V,W,X): FKEYS: 1=MAIN 2=REFRESH 3=UNDO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following list describes the Print Form menu. Form name Name of the form to print. Form number Unique number of the form to print

118 FORMGEN Processor Reference Workspace Specifies whether the form to print is in the workspace. If the form is in the workspace, enter Yes. However, you do not have to print a form from the workspace. Also, you do not have to execute the New or Old library command before printing unless you want to print the form in the workspace. If the form to print is in a form library or omnibus file, enter No. If the value in the Workspace field is Yes, the following fields are ignored: File type Form number File type Form library name Omnibus file name Specifies whether the form is in the form library or an omnibus file: F = Form library O = Omnibus file The default file type is based on the value in your user profile. This value is displayed in the OO field next to the File type field. Form library If file type is F, this field names the form library containing the form that you want to print. If file type is O, use this field only to size the omnibus element, in other words, compare the number of fields allowed with the number of fields in the omnibus element. Omnibus name Output Specifies the file containing your form, if it is in an omnibus file. The default omnibus file name is based on the value in your user profile. The file to which FORMGEN transfers your form if it is different from the default file. The default print file name is based on the value in your user profile

119 FORMGEN Processor Reference Site output Specifies whether or not to print the file. Y N Transfer the output file from FORMGEN to a printer Do not print output file The default site output value is based on the value in your user profile. This value is displayed in the OO field next to the Site output field. Retain output Specifies whether or not to keep the file after printing. Y N Retain the file after printing Delete the file after printing The default retain output value is based on the value in your user profile. This value is displayed in the OO field next to the Retain output field. Destination Copies Banner Identifies the printer. The printer must be configured with OS The default destination is based on the value in your user profile. If the user profile value for this field is blank, the default system printer is used. Identifies the number of copies to be printed. The range is 1 through 63. The default value is based on the value in your user profile. A 6-character print banner. The default banner is based on the value in your user profile. If the user profile value for this field is blank, the user's run-id is used

120 FORMGEN Processor Reference

121 Section 4 Form Language Definition Processor (FLDP) This section describes how to use FLDP to create forms from statements entered into an input data file or from statements you enter one at a time. These forms are identical to those produced by FORMGEN Overview FLDP processes source input to produce form definitions. You can execute it in the batch mode or the demand environment. A DPS 2200 applications programmer can also generate forms with the following processors or routines: FORMGEN Processor (see Section 3) D$DEF Routines (see Section 6) You provide the source input to FLDP either in an input data file or one line at a time. This input consists of commands and definition statements that define a form. This creates or replaces the entire definition. No partial updates are performed. To create FLDP source statements for a form you previously defined with the FORMGEN processor or the D$DEF routines, call the FLMU Processor with the F option. Appendix E shows a sample FLDP program. Because FLDP takes source input and processes it to produce forms, you can save your source input and easily modify the source statements to regenerate forms as needed General Syntax Conventions The FLDP follows the conventions set for the Interactive Processing Facility (IPF 1100) command language. These conventions are as follows: To be consistent with IPF 1100 syntax, the FLDP commands consist of a noun followed by a series of keyword parameter values that are specified by either keyword notation (keyword=value) or positional notation (see 4.4). FLDP uses command initiators (FORM, IMAGE, FIELD, and TEMPLATE), definition statements, and command terminators

122 Form Language Definition Processor (FLDP) Definition statements begin with a noun followed by a series of keyword parameters. However, the definition statements are not part of the command line. Place each definition statement on a separate input line or separate it with a semicolon to indicate the end of one statement and the beginning of another. Command terminators consist of the command END_command-name and do not have any keyword parameters associated with them. You can include comments in the command lines by using the masterspace symbol (@) in any column except column 1. A masterspace in column 1 causes termination of the processor. To IPF 1100 and DPS 2200, anything to the right of a masterspace in a command line is a comment. For example: FIELD name of this field is F1 In this example, The name of this field is F1 is a comment. When you cannot fit all the keyword parameters on the same statement line, use an ampersand to continue the statement on the next line. You can use an ampersand in any character position where a blank character (space) is legal, except inside a string. The ampersand must be the last nonblank character before a comment or before the end of the line. For example: DIMENSION HEIGHT= statement continues on next line 24 WIDTH=80 The format of all keyword parameters is keyword=user-supplied-values. Keywords are shown in uppercase characters, but you can enter the keywords in uppercase or lowercase characters. Enter the keywords exactly as they appear. The user-supplied-values are shown as italicized lowercase characters. You can supply keyword parameters in any order for a given statement. For example, these two statements are equivalent: DIMENSION HEIGHT=24 WIDTH=80 DIMENSION WIDTH=80 HEIGHT=24 Use one or more blanks (spaces) to separate the statement noun and the keyword parameters, and to separate the keyword parameters from each other. Multiple consecutive blanks mean the same as a single blank character. In the construct keyword=user-supplied-values, you can use blanks between the keyword and equal sign, and between the equal sign and a user-supplied-value. You can enter more than one command or definition statement on each input line, but you must separate them with a semicolon (;). For example: FIELD NAME=field-name ; END_FIELD

123 Form Language Definition Processor (FLDP) You can abbreviate all DPS 2200 command names and keywords by using the first three characters of each word in the keyword. You can abbreviate one-word commands and keywords with the first three characters of the word. For commands and keywords that are more than one word joined by an underscore (_), construct the abbreviation by using the first three letters of each word and separate each three character set by an underscore. For example: IMAGE NAME GENERAL_EDIT IMA NAM GEN_EDI Some keyword parameters can include a list of values instead of just a single value.you must enclose these lists in parentheses, with the values separated by commas (value-1,value-2). With only a single value, parentheses are optional. You cannot include a null value in a list. For example, you cannot immediately follow a left parenthesis with a comma (,2) or immediately follow a comma with a right parenthesis (2,). Parameters allowing lists appear within parentheses. For example: PARAMETER=( value1 value2 value3 )... In a list of values, there may be blanks before or after the parenthesis and around commas. You can enter either lowercase or uppercase characters for FLDP command and definition statements, keywords, and values. All characters are read in as uppercase. To distinguish between uppercase and lowercase characters when supplying a string value to a keyword parameter, enclose the value in pairs of quotation marks (" "). To include a blank character as a part of a keyword parameter value, use a string enclosed in pairs of quotation marks. A string is any contiguous sequence of characters (including blanks, but excluding quotation marks for unquoted strings). There are two types of strings: quoted and unquoted. A quoted string is zero or more characters enclosed by quotation marks ("). If you need to use a quotation mark itself in a string, use two quotation marks (""). An unquoted string begins with an alphabetic character and contains only alphabetic or numeric characters, or one of the following special characters: * + ( ) / _ :. $. Any other character terminates the string. For example: or FORM NAME = FORM NAME =

124 Form Language Definition Processor (FLDP) Use a comma to separate parameters when you use the FLDP positional notation (see 4.4). Specify user-supplied values in any order when using keywords. You can specify the same definition statement more than once following a command initiator. However, DPS 2200 uses the parameter value of the last occurrence of the definition statement following the command initiator when you specify duplicate parameters. Specify a keyword parameter only once for each definition statement. A keyword parameter is required unless it is enclosed in brackets [ ] in the format. Use default values at run time for parameters where you do not define values Calling FLDP Use the following Executive Control Language (ECL) statement to call [[source-input] [,[source-output] [,[form-library] [,[omnibus-out]]]]] where options A I L N O S U X Y Accepts the results of processing even if errors are detected. In any case, do not exit. Inserts new source language input. Produces a comprehensive listing. Produces an abbreviated listing. Creates an omnibus file and writes the form into it instead of into a form library. Lists the source statements. Updates an existing input element to the next higher element cycle, saving any source language corrections currently applied to the source language input element. Exits if errors are detected, inhibiting further processing of the run. Test mode fields are displayed for forms stored in training files. source-input Symbolic element created (I option), updated (U option), or used as input. source-output Symbolic element created if the I or U options are not specified. This element contains the updated source

125 Form Language Definition Processor (FLDP) form-library Contains the name of the generated form library. Defaults to the first configured form library. omnibus-out Used with the O option to save the form in an omnibus file. This can be any file or element. The default file name is TPF$. The default element name is the form number FLDP Positional Notation As an alternate to keyword notation, you can specify values for certain parameters in FLDP commands and definition statements by entering only the user-supplied value for the parameters. This is called positional notation. Separate each parameter with a comma while using positional notation. Positional notation lets more experienced DPS 2200 programmers save typing time by using the assumed positional order of the keyword parameters. For example, the following two statements have the same result. The first statement uses keyword notation; the second statement uses positional notation. DIMENSION WIDTH=80 HEIGHT=24 DIMENSION 80,24 If you skip a parameter field while using positional notation, preserve the parameter position with a comma. If you skip the first positional parameter, precede the next specified positional parameter with a comma. If you skip the last positional parameter, follow the last specified positional parameter with a comma. If the parameter you skip is between the first and third positional parameters, insert two consecutive commas. For example, the following two statements are the same. In the second statement, TYPE is replaced with a comma. SECURITY TYPE=HARD LEVEL=10 FAIL_ACTION=PROTECTED_BLANKS SECURITY,10,PROTECTED_BLANKS You can mix positional and keyword notation according to the following syntax rules: If you start using keyword notation (KEYWORD=user-supplied-value,) use that notation for the remainder of the statement. If you skip a positional notation field, you cannot subsequently specify it with keyword notation

126 Form Language Definition Processor (FLDP) Specifying a positional parameter followed by a comma indicates skipping the next parameter. You cannot specify this last parameter value with keyword parameter notation after indicating that you want to skip it. For example, the following command is invalid because the command indicates skipping the TYPE parameter: SECURITY,10 TYPE=HARD The following keyword notation is valid: SECURITY,10 FAIL_ACTION = PROTECTED_BLANKS Enclose lists specified as a positional parameter value within parentheses, just as with keyword parameter list. For example: TEMPLATE ("_", "+"), "", "" The keyword parameter description for each statement indicates whether you can specify the parameter by position, and if so, the position assigned to it FLDP Definition Commands When you begin defining a form, use the FORM command as the first command in your source input. You can follow the FORM command with any of the definition statements or command initiators, except for FORM itself. Command Initiators The command initiators are as follows: FORM IMAGE FIELD TEMPLATE Each command initiator has keyword parameters you specify with the command. Each command also has a corresponding command terminator to end the definition process started by the command initiator. These END commands have the form END_command, where command is the name of the command initiator. To start defining an image, enter one of the command initiators. For example: IMAGE... Follow this command with definition statements

127 Form Language Definition Processor (FLDP) Command Terminators The command terminators are as follows: END_FORM END_IMAGE END_FIELD None of these commands contains keyword parameters. To end the image definition, enter one of the command terminators. For example: END_IMAGE Note: There is an exception to the END_command rule. The TEMPLATE command accepts free-format input data. After you enter the TEMPLATE command, enter the template data and then an *END to indicate the end of input data. See for a description of the TEMPLATE command. Definition Command Rules There are a few rules that control the order in which you specify the definition commands. FLDP commands and definition statements are hierarchical. You can nest command initiators within command initiators to create a nested set of image definitions. However, the following restrictions apply to this nesting capability: Do not include the FORM command initiator within any other command initiator and terminator. Use the FORM command initiator as the first command and the END_FORM command terminator as the last command. Enter the rest of the command initiators and corresponding command terminators after the FORM command, but before the END_FORM command. If you use the TEMPLATE command, specify it as the first command after the FORM or IMAGE command to which it applies. Do not nest command initiators between the TEMPLATE and FIELD commands and their corresponding command terminators. You can include definition statements after any command initiator, except the TEMPLATE command. The TEMPLATE command does not accept any definition statements. See 4.6 for a description of the definition statements. The definition statements are valid for one or more of the FLDP commands. These descriptions include any valid restrictions FORM Command The FORM command begins a form definition. Every definition statement entered between this command and its terminator (END_FORM), applies to the form name and number specified on the FORM command

128 Form Language Definition Processor (FLDP) Format FORM [NAME=form-name] [NUMBER=integer] & [FIELD_CHARACTERS=character [, character] ] & [START_IMAGE=character] [STOP_IMAGE=character] [form-level-statements] where NAME= Identifies the form when it is stored. The name can be one to eight characters long consisting of A to Z and 0 to 9. The default name is form. This is the first positional keyword parameter. NUMBER= Identifies a form within a form library. Forms with the same number can exist in different form libraries. Valid form numbers are 0 through the configured maximum number of forms allowed for the form library. If the form number is zero, FLDP will save the form using the first unused form number found in the form library. The default form number is 0. FIELD_CHARACTERS= Identifies field location in a template. You can define one or two characters. Use a list to define two different field characters. The first field character defaults to the underscore and the second character defaults to null. This is the third positional keyword parameter. START_IMAGE= Begins an image definition in a template. The START_IMAGE character defaults to the left bracket ( [). This is the fourth positional keyword parameter. STOP_IMAGE= Ends an image definition in a template. The STOP_IMAGE character defaults to the right bracket ( ]). This is the fifth positional keyword parameter. form-level-statements Table 4 1 lists additional form-level-statements. Example Enter the definition statements (see Table 4 1 and 4.6) after the FORM command. The attributes defined by these statements apply to the form in general. You must have a STORAGE definition statement (see ) within a form definition. FORM Newform,

129 Form Language Definition Processor (FLDP) To end a form definition, enter the END_FORM command. It has no keyword parameters. END_FORM Table 4 1. Valid Form Level Definition Statements for FORM Command Statement Valid Keywords Valid Values BACKGROUND_ ATTRIBUTES COLOR All colors are listed in CHARACTER_ATTRIBUTES FONT_INDEX 0,1 CHECKNUMBER_TEST SET_MODE NO, YES CONVERSATION SET_MODE NO, YES CURSOR IMAGE_NAME Field name DIMENSION EDIT_SYMBOL WIDTH HEIGHT DECIMAL_POINT COMMA Integer (must be 80) Integer (1 : 24) Any character. Cannot be alphanumeric, + or -. EMPHASIS TYPE NONE, UNDERSCORE, STRIKETHROUGH, COLUMN_LEFT FOREGROUND_ ATTRIBUTES INTENSITY COLOR HIGH, NORMAL, LOW. All colors are listed in FUNCTION_KEYS NAME NONE, ALL, F1:F22 HIGHLIGHT TYPE NONE, BLINK INPUT_ATTRIBUTES PREDEFINED_VALUE SECURITY STORAGE CONTROL_ CHARACTERS_ ALLOWED SOE_CHARACTER MARKING_ CHARACTER I18_CCSNUM TYPE LEVEL FAIL_ACTION SOURCE GENERATE_TYPE GENERATE_PREFIX NONE, BLINK One character. Cannot be alphabetic, underscore or masterspace. One character. Cannot be alphanumeric or masterspace. Integer SOFT, HARD integer - 1 : configured maximum DIAGNOSE, NORMAL GENERATE FCA NO, YES TEST SET_MODE NO, YES

130 Form Language Definition Processor (FLDP) TEMPLATE Command Use the TEMPLATE command to simplify the definition of a form, similar to the method used in FORMGEN. When you use the TEMPLATE command, it must immediately follow either a FORM or IMAGE command. Format TEMPLATE where [FIELD_CHARACTERS=character> [, character] ] & [START_IMAGE=character>] [STOP_IMAGE=character>] [template data] *END FIELD_CHARACTERS= Identifies the location of fields in a template. You can define one or two characters. Use a list to define two different field characters. The first field character defaults to the underscore and the second character defaults to null. This is the first positional keyword parameter. START_IMAGE= Begins an image definition in the template. The START_IMAGE character defaults to the left bracket ( [). This is the second positional keyword parameter. STOP_IMAGE= Ends an image definition in a template. The STOP_IMAGE character defaults to the right bracket ( ]). This is the third positional keyword parameter. template data Specifies that template data must follow the TEMPLATE command. It consists of multiple lines of input data that define images and fields. Identify the fields with strings of FIELD_CHARACTERS (usually underscores). An ON/OFF image starts at the position occupied by the START_IMAGE character and ends at the position occupied by the STOP_IMAGE character. If the START_IMAGE and STOP_IMAGE characters are on different lines, the image spans all lines between them. ON/OFF images can be nested. You can nest a maximum of 10 image levels. If the number of START_IMAGE characters does not match the number of STOP_IMAGE characters, FLDP generates a diagnostic message. Begin template data on a line boundary. Spaces are significant in the data. The data consists of a series of lines. Use an *END statement to indicate the end of the template data

131 Form Language Definition Processor (FLDP) The template is as wide as the defined form. It contains the values placed in the form, strings of FIELD_CHARACTERS designating field locations, and START_IMAGE and STOP_IMAGE characters designating the beginning and ending of images. Images and fields are numbered from left to right and from top to bottom, beginning with 1. The template dimensions cannot exceed the configured limits of a DPS 2200 form. After the TEMPLATE command, enter IMAGE and FIELD commands to further define the images and fields. Specify them either sequentially or numerically. If you specify a defined template but do not supply a string number, commands correspond to the images and fields in a sequential order. Each time the FLDP receives a START_IMAGE character or a string of field characters, it defines an image or field. Therefore, if you include a start image character in the template, you must supply the IMAGE command followed by FIELD commands in the order of the fields in the template. The syntax for the IMAGE and FIELD commands lets you define images and fields in addition to those indicated by strings in the templates. Use the TEMPLATE_DEFINED parameter of the IMAGE and FIELD commands. You can easily mix template and non template images and fields in a template (see and ). If you do not enter a TEMPLATE command, you must use the IMAGE and FIELD commands to define the position and attributes of all parts of a defined form, including text. Any undescribed area of a form is interpreted as protected blanks. See APPENDIX E for a sample template definition IMAGE Command The IMAGE command starts the image definition process. Use the IMAGE command to define ON/OFF images, linked ON/OFF images, and vertical and horizontal repeat images. When you define ON/OFF images, either use the TEMPLATE command or the POSITION_IMAGE and DIMENSION statements to define the starting position and length of the image. This ensures compatibility with ON/OFF images defined with FORMGEN. When you define a vertical or horizontal repeat image, either use the TEMPLATE command or the POSITION_IMAGE and DIMENSION statements to define the starting position and length of the image. For a vertical repeat image, the entire line must be included. The REPEAT_IMAGE statement is used to identify the image as a repeat image, rather than an ON/OFF image

132 Form Language Definition Processor (FLDP) When you define a repeat line, define an image that includes the entire line. Then, call the REPEAT_IMAGE statement to identify the image as a repeat, rather than as an ON/OFF image. When you use the TEMPLATE command to lay out the form, specify the START_IMAGE and STOP_IMAGE characters as the first and last characters on the line to define the line as an image. If these characters are not in these positions and no other characters exist between the beginning of the line and the START_IMAGE character or between the end of the line and the STOP_IMAGE character, FLDP repositions the illegally placed image character into its correct position and generates a warning message. If any of the image characters are out of position and a character other than a blank exists between the image character and the end of the line, FLDP generates a fatal error message. If you specify an ON/OFF image on the same line as a repeat image, use two sets of START_IMAGE and STOP_IMAGE characters. One set identifies the repeat image and the other set identifies the ON/OFF images. Format IMAGE [NAME=image-name] [STRING_NUMBER=integer] [TYPE={NORMAL LINKED}] & [REFERENCE_NAME=image-name] [TEMPLATE_DEFINED={NO YES}] [image-level-statements] where NAME= Specifies the name of the defined image. This is the first positional keyword parameter. Specifying a name for linked or repeat images causes an error. The name can be 1 to 16 characters long consisting of A to Z, 0 to 9, and the hyphen. Include at least one alphabetic character. Do not use a hyphen as the first or last character. Case is not significant. The name must be unique within a form. If a name is not specified, the default name is IMAGE#, where # is the first unique number found when all other currently defined names are searched. STRING_NUMBER= TYPE= Specifies the string number in a template definition. Specify a number between 1 and the total number of fields plus START_IMAGE strings in the template. (See the TEMPLATE command for details.) This is the second positional keyword parameter. Specifies types of ON/OFF images. LINKED indicates that the image is linked to a previously defined image. When you specify TYPE=LINKED, supply the name of the image link to the REFERENCE_NAME parameter keyword

133 Form Language Definition Processor (FLDP) NORMAL indicates a normal image definition. NORMAL is the default value. This is not a positional keyword parameter and is required only for LINKED images. REFERENCE_NAME= Specifies the name of the image linked to the current image. This parameter keyword is not positional. The default is the first ON/OFF image immediately preceding the coordinates of the current image. TEMPLATE_DEFINED= Specifies whether the image is laid out in a template. NO indicates that you do not provide a template string for the image. If a STRING_NUMBER is also specified, the string number is ignored. YES indicates that a template is defined and that the image position and length are defined by this template. The STRING_NUMBER keyword parameter contains the string number. If you do not provide a string number, the FLDP uses the next available start image character in the template. This is not a positional keyword parameter. The default value is YES if a template is defined. Otherwise, it is NO. image-level-statements Table 4 2 and Table 4 3 list the image-level statements for nonrepeating and repeating images. Example 1 IMAGE "First-Image" Example 2 IMAGE TYPE=LINKED REFERENCE_NAME= "First-Image" When you do not use the TEMPLATE command to identify an ON/OFF image, there is no specific command to identify the last position of the image. The last position of the image, is determined by the length of the image. You can specify the length with the WIDTH= parameter of the DIMENSION statement. To end the image definition, enter the END_IMAGE command. It has no keyword parameters

134 Form Language Definition Processor (FLDP) Table 4 2. Valid Image_Level Statements for Nonrepeating Images Statement Valid Keywords Valid Values BACKGROUND_ATTRIBUTES COLOR All colors are listed in CHARACTER_ATTRIBUTES FONT_INDEX 0, 1 DIMENSION WIDTH HEIGHT Integer - 2 : 1920 Must be 1 EMPHASIS TYPE NONE, UNDERSCORE, STRIKETHROUGH, COLUMN_LEFT FOREGROUND_ATTRIBUTES INTENSITY COLOR NORMAL, SUPPRESSED, LOW, HIGH All colors are listed in HIGHLIGHT TYPE NONE, REVERSE, BLINK OUTPUT_ATTRIBUTES CONTENTS STORAGE, BLANK POSITION_IMAGE SECURITY COLUMN ROW VARIABLE_COLUMN VARIABLE_ROW TYPE LEVEL FAIL_ACTION Integer Integer YES YES SOFT, HARD Integer - 1 : configured maximum PROTECTED_BLANKS NORMAL TEST DEPENDENT NO, YES

135 Form Language Definition Processor (FLDP) DIMENSION and POSITION_IMAGE are the only valid statements for LINKED images. Table 4 3 describes the valid image_level statements for repeating images. Table 4 3. Valid Image_Level Statements for Repeating Images Statement Valid Keywords Valid Values DIMENSION POSITION_IMAGE REPEAT_IMAGE WIDTH HEIGHT COLUMN ROW VARIABLE_COLUMN VARIABLE_ROW COUNT INDEX_ITEM CONSTANTS SPACING DIRECTION Integer - (1 : 40 for horizontal repeats) (must be 80 for vertical repeats) Integer - (must be 1 for horizontal repeats) (1 :12 for vertical repeats) Integer - (1 : 79 for horizontal repeats) (must be 1 for vertical repeats) Integer - 1 : 24 NO (for vertical repeats) YES (for horizontal repeats) YES Integer - 2 : 80 (24 maximum for vertical repeats) COBOL or C index name NO, YES Integer - (0 : 78 for horizontal repeats) (must be 0 for vertical repeats) DOWN, RIGHT FIELD Command The FIELD command starts field definition. It must be within a FORM or IMAGE command. Format FIELD where [NAME=field-name] [STRING_NUMBER=integer] & [TEMPLATE_DEFINED={NO YES}] NAME= Specifies the name of the field you are defining. Specifying a name for a system-supplied field, text constant or emphasis constant causes an error. The name can be from 1 to 16 characters long consisting of A to Z, 0 to 9, and the hyphen. Case is not significant. Do not use a hyphen for the first or last character. At least one alphabetic character is required. This is the first positional keyword parameter. The default is IMAGE#, where # is the first unique number found when all other currently defined image names are searched

136 Form Language Definition Processor (FLDP) STRING_NUMBER= Specifies the number of the template field string you are defining. When you use more than one template during form definition, the string number corresponds to the template identifying the field. For example, a form and an image each have a template. (See the TEMPLATE command for details.) This is not required for a textual field definition. This is the second positional keyword parameter. TEMPLATE_DEFINED= Specifies whether the field is defined in a template. NO indicates that you do not provide a template string for field layout. If you specify a string number, the number is ignored. YES indicates that a template is defined and that the field position and length are defined by this template. The string number is indicated with the STRING_NUMBER keyword parameter. If you do not provide a string number, FLDP uses the next available field character string. This is not a positional keyword parameter. The default value is YES if a template is defined; otherwise, it is NO. Example FIELD FLD1,1 After you enter the FIELD command, enter the definition statements to define the field attributes. You cannot enter any other commands until you end the field definition with the END_FIELD command

137 Form Language Definition Processor (FLDP) Defining Text Constants When you do not use a TEMPLATE command to lay out the form, you must define all text in the form as constant fields with FIELD commands. The following statements are required to define a text constant: OUTPUT_ATTRIBUTES CONTENTS=CONSTANT Identifies a text field. POSITION_IMAGE c,r Identifies the column (c) and row (r ) for the start of the text. DIMENSION WIDTH=n Specifies the length (n) of the text string. PREDEFINED_VALUE INITIAL_VALUE= text-string Specifies the text. The following statements are required to define an emphasis constant: OUTPUT_ATTRIBUTES CONTENTS=EMPHASIS_CONSTANT Identifies an emphasis field. POSITION_IMAGE c,r Identifies the column (c) and row (r) for the start of the text. DIMENSION WIDTH=n Specifies the length (n) of the text string. PREDEFINED_VALUE INITIAL_VALUE= emphasis-string See Table 4 4 and Table 4 5 list the valid field-level statements

138 Form Language Definition Processor (FLDP) Table 4 4. Valid Field-Level Statements for Fields (Nonconstant, Nonsystem-Applied) Statement Valid Keywords Valid Values BACKGROUND_ ATTRIBUTES COLOR All colors are listed in CHARACTER_ATTRIBUTES FONT_INDEX 0,1 DIMENSION WIDTH HEIGHT VARIABLE_WIDTH MAXIMUM_WIDTH Integer - 1 to 1920 Must be 1 NO, YES Integer - width to 1920 EMPHASIS TYPE NONE, UNDERSCORE, STRIKETHROUGH, COLUMN_LEFT FOREGROUND_ ATTRIBUTES GENERAL_EDIT INTENSITY COLOR All keywords are listed in NORMAL, SUPPRESSED, LOW, HIGH. All values are in HIGHLIGHT TYPE. NONE, REVERSE, BLINK, CORRECTION INPUT_ATTRIBUTES All keywords are listed in OUTPUT_ATTRIBUTES CONTENTS STORAGE, BLANK, REPLENISH PREDEFINED_VALUE POSITION_IMAGE SECURITY REPLENISH_STRING INITIAL_VALUE COLUMN ROW VARIABLE_COLUMN VARIABLE_ROW TYPE LEVEL FAIL_ACTION One character Character string Integer Integer NO, YES NO, YES HARD, SOFT Integer - 1 : configured maximum PROTECTED_BLANKS, PROTECTED_DATA, NORMAL STORAGE DATA_TYPE All choices are listed in TAB TYPE NONE, NORMAL TEST DEPENDENT NO, YES

139 Form Language Definition Processor (FLDP) Table 4 5. Valid Field-Level Statements for System-Supplied Fields Statement Valid Keywords Valid Values OUTPUT_ATTRIBUTES POSITION_IMAGE SECURITY CONTENTS SYSTEM_VALUE COLUMN ROW VARIABLE_COLUMN VARIABLE_ROW TYPE LEVEL FAIL_ACTION SYSTEM All choices are listed in Integer Integer YES YES HARD, SOFT Integer - 1 : configured maximum NORMAL, PROTECTED_BLANKS, PROTECTED_DATA TEST DEPENDENT NO, YES 4.6. Definition Statements Definition statements allow you to define and control attributes, symbols, and other data in the form definition BACKGROUND_ATTRIBUTES Use this statement to specify background display attributes at the form, image, or field level. This is the background color form-level attribute in FORMGEN. Format BACKGROUND_ATTRIBUTES [COLOR={BLACK ; WHITE ; RED ; BLUE ; GREEN ; YELLOW ; MAGENTA CYAN}] where COLOR= Specifies the background color used at run time when DPS 2200 displays a form, image, or field. This is not a positional keyword parameter. Example BACKGROUND_ATTRIBUTES COLOR=RED

140 Form Language Definition Processor (FLDP) CHARACTER_ATTRIBUTES Use this statement to describe character data displayed in a form, image, or field. This is the FONT form-level attribute in FORMGEN. Format CHARACTER_ATTRIBUTES [ FONT_INDEX=integer ] where FONT_INDEX= Specifies the index for the font used to display characters within the form, image, or field. The default is 0 and specifies the normal font. If the index is greater than the number of alternate fonts supported by a terminal, 0 is assumed. This is not a positional keyword parameter. Example CHARACTER_ATTRIBUTES FONT_INDEX= CHECKNUMBER_TEST This statement specifies whether DPS 2200 compares the check number in the form definition and the working storage header at run time. Use this statement only at the form level. This is the check number validate form-level attribute in FORMGEN. Format CHECKNUMBER_TEST SET_MODE=(NO YES) where SET_MODE= Specifies whether to test the check number. The default value is YES. Example CHECKNUMBER_TEST SET_MODE=NO

141 Form Language Definition Processor (FLDP) CONVERSATION Use this statement only at the form level to turn conversation mode on at run time or to not change it. When you specify no, the D$OPEN function does not establish the conversation mode. This is the initial conversation mode form-level attribute in FORMGEN. Format CONVERSATION SET_MODE={NO YES} where SET_MODE= CURSOR Specifies whether to turn conversation mode on for a form. The default value is NO. This is the first positional keyword parameter. This statement specifies the initial cursor location for a form. When a form is displayed, DPS 2200 positions the cursor to the first unprotected location in the form unless you specify otherwise. Use this statement only at the form level. This is the final cursor field name form-level attribute in FORMGEN. Format CURSOR [IMAGE_NAME=image-name] where IMAGE_NAME= Identifies the field in which the cursor is positioned. It is positioned at the start of the field. This is not a positional keyword parameter. If IMAGE_NAME is blank or omitted, the cursor is positioned at the first unprotected position in the form. Example CURSOR IMAGE_NAME="A"

142 Form Language Definition Processor (FLDP) DIMENSION Use this statement to define the dimensions of a form, image, or field. When you use the TEMPLATE command to initially define a form, image, or field, you do not have to use the DIMENSION statement. In this case, form dimensions (including dimensions of fields and images) are determined by the locations and lengths of field character strings, START_IMAGE characters, and STOP_IMAGE characters in the template. To define a repeat image, include the DIMENSION statement, with the WIDTH parameter set to the width of the form. Format DIMENSION [WIDTH=number] & [HEIGHT=number] & [MAXIMUM_WIDTH=number] & [VARIABLE_WIDTH={NO YES}] where WIDTH= Specifies the character width of a form, image, or field. This is also the initial width of a variable-width field. This is the first positional keyword parameter. This parameter is not required for a form. However, if it is specified it must have a value of 80. This parameter is required for an ON/OFF image unless the image is defined by the TEMPLATE command. The width of an ON/OFF image can have a value of 2 through This parameter is not required for a horizontal repeat image. However, if it is specified it can have a value of 1 through 40. The default value is 1. This parameter is not required for a vertical repeat image. However, if it is specified it must have a value of 80. This parameter is not required for input/output (I/O) fields and output-only (OO) fields. The width of a field can be 1 through The default value is 1. This parameter is not required for system-supplied fields. The width of a system supplied field varies based on the type of the system- supplied field. HEIGHT= Specifies the height of the form in rows. This is the form height form-level attribute in FORMGEN. For fields, ON/OFF images, and horizontal repeats, enter 1. For vertical repeats, specify the number of rows in each repeat occurrence. The default value is 1. This is the second positional keyword parameter

143 Form Language Definition Processor (FLDP) MAXIMUM_WIDTH= Specifies the maximum size of a field. Do not specify this parameter unless VARIABLE_WIDTH equals YES. This is the MWID attribute in FORMGEN. VARIABLE_WIDTH= Specifies whether the width of the field is variable. Enter YES only for fields with ALPHABETIC or ALPHA_NUMERIC STORAGE DATA_TYPE. This generates a data item (fieldname-width) in working storage which is used to specify the width of the field. This is not a positional parameter. The default value is NO. This is the VWID attribute in FORMGEN. Example (form) DIMENSION 80,24 Example (field) DIMENSION 120, EDIT_SYMBOL Use this statement to define the decimal character and delimiter symbols to be used at run time. The edit symbols must be unique and cannot be used for replenish characters in the form. They cannot be numbers, letters, +, -, or a master space (@). The default decimal character value is the period (.) and the default delimiter character is the comma (,). The characters must be enclosed in double quotes. Use this statement only at the form level. Format EDIT_SYMBOL [DECIMAL_POINT=character] & [COMMA=character] where DECIMAL_POINT= Specifies the character replacing the period (.) as the decimal character. This is the decimal point symbol form-level attribute in FORMGEN. COMMA= Specifies the character replacing the comma (,) as the delimiter character. This is the thousands delimiter form-level attribute in FORMGEN. Example EDIT_SYMBOL DECIMAL_POINT="." COMMA=","

144 Form Language Definition Processor (FLDP) EMPHASIS Use this statement to specify one or more emphasis characters. Use it at the form, image, or field level. This is the emphasis form-level attribute or the EMP image and field level attribute in FORMGEN. Format EMPHASIS [TYPE]=(NONE UNDERSCORE STRIKETHROUGH COLUMN_LEFT)... where TYPE= Specifies the character used to emphasize a form, image, or field. The default is NONE and indicates that no emphasis is defined. This is the first positional keyword parameter. When you specify NONE, it must be your only entry. However, you can specify any combination of the other entries. Make sure you have a comma between each entry. Examples EMPHASIS NONE EMPHASIS (UNDERSCORE, STRIKETHROUGH) EMPHASIS TYPE=UNDERSCORE FOREGROUND_ATTRIBUTES Use this statement to specify the foreground display attributes for a form, image, or field. Format FOREGROUND_ATTRIBUTES [INTENSITY={NORMAL SUPPRESSED LOW HIGH }] & [COLOR={WHITE BLACK RED BLUE GREEN YELLOW MAGENTA CYAN}]

145 Form Language Definition Processor (FLDP) where INTENSITY= Specifies the intensity of the foreground of display characters. This is the foreground intensity form-level attribute or the FI image and field level attribute in FORMGEN. For form definition, INTENSITY defines the text intensity for UTS and Dataspeed 40/4 terminals. The default value is NORMAL. This is the first positional keyword parameter. NORMAL specifies device default display intensity. SUPPRESSED indicates that the data exists, but is not displayed (if that is possible with the current device and its features). COLOR= Specifies the foreground color used at run time when DPS 2200 displays the form, image, or field. This is not a positional keyword parameter. This is the foreground color form-level attribute or the FC image and field level attribute in FORMGEN. Example FOREGROUND_ATTRIBUTES LOW COLOR=BLUE FUNCTION_KEYS Use this statement to specify the function keys that a program accepts as input to a form at run time. It is for documentation purposes only. Use this statement only at the form level. This is the function keys form-level attribute in FORMGEN. Format FUNCTION_KEYS [NAME=(NONE ALL F1 F2 F3... F36)] where NAME= Specifies one or more names of function keys that your program accepts as input to the form at run time. NONE indicates no keys. ALL indicates all keys. If you specify more than one name, arrange them in a list. The default value is NONE. This is not a positional keyword parameter. Example FUNCTION_KEYS NAME=(F1, F2, F3, F4)

146 Form Language Definition Processor (FLDP) GENERAL_EDIT Use this statement to define general editing and display attributes for an image or field. There are equivalent image and field level attributes in FORMGEN. Format GENERAL_EDIT [ DISPLAY=(BLANK_WHEN_ZERO REPLENISH_FOR_BLANKS INSERT_DELIMITERS ) ] & [ SIGN=(NONE DISPLAY_POSITIVE FLOATING & TRAILING DEBIT CREDIT ) ] & [ RADIX={ DECIMAL OCTAL } ] & [ MONETARY_SIGN={ NONE FLOATING LEADING } ] & [ LEADING_ZEROES={ SUPPRESS DISPLAY } ] & [ DECIMAL_SCALE=integer ] & [ JUSTIFICATION={ NONE LEFT RIGHT CENTER } ] & [ CASE={EITHER UPPER} ] & [ PROTECTED={NO YES} ] & [ SET_MODIFIED={NO Y ES} ] & [ USAGE={ INPUT_OUTPUT OUTPUT } ] & [ EXPONENTIAL NOTATION={ NO YES } ] where DISPLAY= Specifies miscellaneous display characteristics. You can specify more than one value by using a list. Do not specify BLANK_WHEN_ZERO and INSERT_DELIMITERS unless STORAGE DATA_TYPE equals NUMERIC, COMPUTATIONAL, REAL, INTEGER, or DOUBLE_PRECISION. Do not specify REPLENISH_FOR_BLANKS if USAGE=OUTPUT. This is not a positional keyword parameter. BLANK_WHEN_ZERO Indicates that leading zeros are treated as blanks on input and output of a numeric field. This is the BZ attribute in FORMGEN. REPLENISH_FOR_BLANKS Indicates that the replenish character replaces any blanks in the field during input of the field. This is the RFB attribute in FORMGEN. INSERT_DELIMITERS Indicates that, during output, the delimiter character is inserted in a numeric field between every third digit. This is the DEL attribute in FORMGEN

147 Form Language Definition Processor (FLDP) SIGN= Specifies the numeric sign displayed with a numeric field. Use this parameter only when STORAGE DATA_TYPE equals NUMERIC, COMPUTATIONAL, REAL, INTEGER, or DOUBLE_PRECISION. You can specify more than one value by using a list. See Table 4 5 for a list of the mutually exclusive attributes. NONE Displays no sign. This is the NS attribute in FORMGEN. DISPLAY_POSITIVE Displays both the positive sign and the negative sign for a numeric field. This is the DPS 2200 attribute in FORMGEN. FLOATING Displays a floating leading sign for a numeric field. This is the LS attribute in FORMGEN. TRAILING Displays a trailing sign for a numeric field. This is the TS attribute in FORMGEN. DEBIT Displays the debit (DB) symbol for a numeric field if the data value of the field is negative. This is the DB attribute in FORMGEN. CREDIT RADIX= Displays the credit (CR) symbol for a numeric field if the data value of the field is negative. This is the CR attribute in FORMGEN. Specifies the base used to display a numeric value. This is the DEC or OCT image and field level attribute in FORMGEN. Use this parameter only when STORAGE DATA_TYPE equals BINARY. This is not a positional keyword parameter. DECIMAL Displays the numeric value as a decimal number. This is the DEC attribute in FORMGEN. OCTAL Displays the numeric value as an octal number. This is the OCT attribute in FORMGEN

148 Form Language Definition Processor (FLDP) MONETARY_SIGN= Specifies the monetary sign displayed with a numeric field. This is not a positional keyword parameter. Use this parameter only when STORAGE DATA_TYPE equals NUMERIC, COMPUTATIONAL, REAL, INTEGER, or DOUBLE_PRECISION. NONE Displays no sign. This is the NMS attribute in FORMGEN. FLOATING Floats the monetary sign in front of the data value of the field. This is the FMS attribute in FORMGEN. LEADING Fixes the monetary sign at the beginning of the field. This is the LMS attribute in FORMGEN. LEADING_ZEROES= Specifies whether to display leading zeros during output of a numeric field. Use this parameter only when STORAGE DATA_TYPE equals NUMERIC, COMPUTATIONAL, REAL, INTEGER, or DOUBLE_PRECISION. The default value is SUPPRESS. This is not a positional keyword parameter. SUPPRESS Does not display leading zeros. This is the omission of the LZD attribute in FORMGEN. DISPLAY Displays leading zeros in the field. This is the LZD attribute in FORMGEN. DECIMAL_SCALE= Specifies the number of digit places after the decimal point. The maximum is 18. This is the V=n attribute in FORMGEN. This is not a positional keyword parameter. JUSTIFICATION= Specifies data justification for the field. Do not use this parameter if STORAGE DATA_TYPE equals BINARY. The default value is NONE. This is not a positional keyword parameter

149 Form Language Definition Processor (FLDP) NONE Specifies no justification of data during input or output. This is the NJ attribute in FORMGEN. CENTER Specifies center justification of data during input or output. This is the CJ attribute in FORMGEN. LEFT CASE= Specifies left justification of data during input or output. This is the LJ attribute in FORMGEN. RIGHT Specifies right justification of data during input or output. This is the RJ attribute in FORMGEN. Specifies whether data is read as lowercase or uppercase during input. EITHER Specifies that all characters remain unchanged (not converted during output). EITHER is equivalent to the EC attribute in FORMGEN and UPPER is equivalent to the UC attribute. Use this parameter only when STORAGE DATA_TYPE equals ALPHABETIC or ALPHANUMERIC. The default value is EITHER. This is not a positional keyword parameter. PROTECTED= Specifies whether the data is protected when displayed. PROTECTED must equal YES for OO fields. The default value is NO for I/O fields and YES for BINARY type fields. This is not a positional keyword parameter. This is the PRO attribute in FORMGEN. SET_MODIFIED= Specifies whether to set the modified bit for this field when the field is sent during output. Specify NO for OO fields. The default value is NO. This is not a positional keyword parameter. This is the MOD attribute in FORMGEN. USAGE= Specifies usage of the field as INPUT_OUTPUT or OUTPUT, therefore affecting display attribute restrictions. This is not a positional keyword parameter. It is valid only for field definitions. INPUT_OUTPUT Specifies the default value for all field types except BINARY. This is the IO image and field level attribute in FORMGEN

150 Form Language Definition Processor (FLDP) OUTPUT Indicates that the field is used for output only. This is the OO image and field level attribute in FORMGEN. EXPONENTIAL_NOTATION= Specifies whether exponential notation is allowed in a real or double-precision field. This is the EXP attribute in FORMGEN. This is not a positional keyword. Example GENERAL_EDIT DISPLAY=(BLANK_WHEN_ZERO, INSERT_DELIMITERS) & SIGN=FLOATING DECIMAL_SCALE=4 & JUSTIFICATION=RIGHT PROTECTED=YES The PROTECTED and SET_MODIFIED parameters specify initial values for the field control area (FCA) fields HIGHLIGHT Use this statement to highlight a field or image. At the form level, it specifies the literal text highlight. Use this statement at the form, image, or field level. There are equivalent form-level and image and field level attributes in FORMGEN. Format HIGHLIGHT [TYPE=NONE REVERSE BLINK CORRECTION] where TYPE= Specifies the highlighting used while displaying a form, image, or field. You can use any combination of REVERSE, BLINK, or CORRECTION. CORRECTION is valid only for fields. REVERSE is the HI=R attribute, BLINK is the HI=B attribute, and CORRECTION is the HI=C attribute in FORMGEN. The CORRECTION parameter makes the field blink. The CORRECTION parameter is not available at the form level. This is the first positional keyword parameter. The default value is NONE. NONE Example Specifies no highlighting. This is the HI=N attribute in FORMGEN. If you specify NONE, you cannot use any other highlights. HIGHLIGHT (BLINK, CORRECTION)

151 Form Language Definition Processor (FLDP) INPUT_ATTRIBUTES Use this statement to specify input characteristics such as data entry criteria and data input actions. Use this statement at the form or field level. At the form level, only the CONTROL_CHARACTERS_ALLOWED parameter is valid. However, this parameter is not valid at the field level. There are equivalent field level attributes in FORMGEN. Format INPUT_ATTRIBUTES [ DATA_ENTRY={OPTIONAL MANDATORY_ENTRY} ] & [ BLANK_INPUT={UNCHANGED BLANK ZERO} ] & [ REPLENISH_NOTIFICATION = {NO YES} ] & [ ALLOW_QUERY = {NO YES} ] & [ CONTROL_CHARACTERS_ALLOWED = {NONE BLINK} ] & [ VALUE_CHECK = {NONE VCTABLE VCRANGE}] where DATA_ENTRY= Specifies whether data entry in a field is optional or mandatory. The MANDATORY_ENTRY attribute is the F attribute in FORMGEN. This is the first positional keyword parameter. The default value is OPTIONAL. BLANK_INPUT= Controls what is considered input to working storage when the field receives blank input. UNCHANGED Does not change working storage values for this field if blanks were received as input. This is the NIB attribute in FORMGEN. BLANK Inputs blanks (spaces) to working storage when the field receives blanks. This is the default input to ALPHABETIC and ALPHA_NUMERIC type fields when the field receives blanks. This is the BLNK attribute in FORMGEN. ZERO Inputs 0 to working storage. This is the default input to BINARY, NUMERIC, COMPUTATIONAL, REAL, INTEGER, and DOUBLE_PRECISION type fields when the field receives blanks as input. This is the ZB attribute in FORMGEN. This is not a positional keyword parameter

152 Form Language Definition Processor (FLDP) REPLENISH_NOTIFICATION= Controls the value that is returned for the field status when the field is transmitted with all initial (replenish) characters. This is the REPN attribute in FORMGEN. When the field is transmitted with all initial replenish characters, YES returns a value of 7 and NO returns a value of 4. ALLOW_QUERY Allows a question mark to be entered in all I/O field types. A status of 8 is returned if the field contains a question mark during data transmission. The working storage header cell, S#-QUERY-STATUS, is loaded with the total number of I/O fields containing a question mark. This is the AQ attribute in FORMGEN. CONTROL_CHARACTERS_ALLOWED= Specifies which ASCII control characters are allowed during input. Currently, you may specify only NONE or BLINK. BLINK allows the FS (left blink, decimal 28 or octal 34) and GS (right blink, decimal 29 or octal 35) characters. This attribute is valid only at form level. VALUE_CHECK Value Checking (VC) allows data entered in an alphabetic or alphanumeric I/O field to be compared to a table of expected values or data entered in a numeric I/O field to be tested against a minimum and maximum value. Example INPUT_ATTRIBUTES OPTIONAL BLANK_INPUT=ZERO

153 Form Language Definition Processor (FLDP) OUTPUT_ATTRIBUTES Use this statement to define the output data source, data characteristics, and output actions for an image or field. There are equivalent image and field level attributes in FORMGEN. Format OUTPUT_ATTRIBUTES [ CONTENTS={STORAGE BLANK REPLENISH SYSTEM CONSTANT EMPHASIS_CONSTANT} ] & [ SYSTEM_VALUE ={NIL DATE_1 DATE_2 DATE_3 DATE_4 DATE_5 DATE_6 DATE_7 DATE_8 TIME_1 TIME_2 TIME_3 FORM_NAME FORM_NUMBER CURRENT_PAGE_COUNT DATA_PAGE_COUNT TOTAL_PAGE_COUNT INDEX_PAGE_COUNT TRANSACTION_CODE PID LPID FORM_SECURITY_LEVEL IMAGE_SECURITY_LEVEL USER_ID TEST_MODE CONVERSATION_MODE USER_FIELD_1 USER_FIELD_2 USER_FIELD_3 USER_FIELD_4 USER_FIELD_5 DPS_LEVEL USER_LEVEL ERROR HEADER ERROR_HEADER} ] where CONTENTS= Specifies the data sent to the display field during output. The default value is STORAGE. This is not a positional keyword parameter. In FORMGEN, this text is specified with the layout function. STORAGE Displays the data in working storage in the field. If you define an initial value for the field with the INITIAL_VALUE parameter of the PREDEFINED_VALUE statement, the initial value is displayed at run time by DPS To set initial state ON for an ON/OFF image, specify STORAGE at the image definition level. This is the CON=S attribute in FORMGEN. BLANK Sends blanks (spaces) to the field. This is the CON=B attribute in FORMGEN. To specify S for suppression, specify BLANK for the CONTENTS and set GENERAL_EDIT PROTECTED equal to YES. For an ON/OFF image, set CONTENTS equal to BLANK to set initial state to OFF

154 Form Language Definition Processor (FLDP) REPLENISH Fills the field during output with the replenish character. This is the CON=R attribute in FORMGEN. SYSTEM Defines the field as a system-supplied field and indicates that the SYSTEM_VALUE parameter determines the value sent during output to the field. All system-supplied fields are protected during output. This is the S field type in FORMGEN. CONSTANT Defines the field as a text field. The PREDEFINED_VALUE statement and the INITIAL_VALUE parameter defines the value of the field during output. Define a CONSTANT output field for form text when you do not use a TEMPLATE command to define the text. In FORMGEN, this text is specified with the layout function. EMPHASIS_CONSTANT Similar to CONSTANT, except the PREDEFINED_VALUE INITIAL_VALUE statement contains emphasis characters instead of normal text. Emphasis characters cannot overlap fields. The values specified in the initial value buffer are exactly the same as the values for field emphasis. SYSTEM_VALUE= Defines the system value displayed in the field. Indicates a system value when you specify SYSTEM for the OUTPUT_ATTRIBUTES CONTENTS parameter. The system value used with this parameter determines the system field length. Therefore, FLDP ignores dimension specifications for system type fields. Any system-supplied field can span lines, except for system field types ERROR, ERROR_HEADER, and HEADER. Limit these system-supplied fields to one line, columns 2 through 79. There are equivalent image and field level attributes in FORMGEN. If CONTENTS equals SYSTEM and you do not specify a system value, the value defaults to NIL. This is not a positional keyword parameter. Example 1 OUTPUT_ATTRIBUTES CONTENTS=REPLENISH Example 2 OUTPUT_ATTRIBUTES CONTENTS=SYSTEM SYS_VAL=DATE_

155 Form Language Definition Processor (FLDP) POSITION_IMAGE Use this statement to specify the location of the image or field within the form or image that contains it. Use this statement at the field or image level. Format POSITION_IMAGE [COLUMN=number] & [ROW=number] & [VARIABLE_COLUMN={YES NO} ] & [VARIABLE_ROW={YES NO} ] where COLUMN= ROW= Specifies the column position of an image or field. Positioning starts from the left edge of the image that contains the field, or from the left edge of the form if the field is not within an image. Column 1 is the first position (leftmost) of the containing image or form. FLDP consecutively numbers the remaining positions until reaching the full width of the image or form. If the containing image wraps around from one line to another, column 1 is the first position (left-most) on the first (top) line of the image. The column numbers continue consecutively from the end of each line to the beginning of the next line until reaching the end of the image. Specify a value between 1 and FLDP gets the default value from the template. If you do not define a template, there is no default value. This is the first positional parameter. In FORMGEN, this text is specified with the layout function. Specifies the row position of the image or field. Positioning starts from the top edge of the image that contains the field, or from the top edge of the form if the field is not within an image. Row 1 is the first (top) row of the containing image or form. FLDP consecutively numbers the remaining rows until reaching the height of the image or form. Specifies a value between 1 and the maximum number of rows in a form, as specified in your site's configuration of the DPS 2200 system. FLDP gets the default value from the template. If you do not define a template, there is no default value. This is the second positional keyword parameter. In FORMGEN, this text is specified with the layout function

156 Form Language Definition Processor (FLDP) VARIABLE_COLUMN= Specifies whether the column position of the field or image is variable. A variable column field or image is repositioned to the left or right when the field or image preceding it changes in width or is repositioned. Specify YES for images. The default value is YES. This is not a positional parameter. YES NO Specifies a variable column field. Specifies that the field is fixed at its initial column position. VARIABLE_ROW= Specifies whether the row position of the field or image is variable. A variable row, field, or image is repositioned up or down when the field or image preceding it changes in height or is repositioned. For field definitions, specify YES if VARIABLE_COLUMN equals YES and NO if VARIABLE_COLUMN equals NO. Specify YES for images. The default value is YES. This is not a positional keyword parameter. This is the VPOS image and field level attribute in FORMGEN. Example 1 POSITION_IMAGE positions image at column 2, row 2 of image that contains it. Example 2 POSITION_IMAGE COLUMN= PREDEFINED_VALUE Depending on what you specify in the OUTPUT_ATTRIBUTES statement, you may need to define values for attributes that you specify in the OUTPUT_ATTRIBUTES statement (see ). Use the PREDEFINED_VALUE statement to define values for start-of-entry (SOE), replenish string, initial values, and marking characters. Use this statement at the field or form level. Format PREDEFINED_VALUE [ SOE_CHARACTER=character ] & [ REPLENISH_STRING=character ] & [ INITIAL_VALUE=string ] & [ MARKING_CHARACTER=character ] [ I18N,_CCSNUM=integer] where

157 Form Language Definition Processor (FLDP) SOE_CHARACTER= Defines the character in an initial value that is replaced with the SOE symbol. This character cannot be an alphabetic character or an underscore. This parameter is valid only for the FORM command. It is not valid for image or field definitions. There is no default. This is not a positional keyword parameter. This is the SOE form-level attribute in FORMGEN. REPLENISH_STRING= Defines the character string displayed whenever you request the replenish string for I/O fields. DPS 2200 sends this character string to I/O fields during output. The replenish string is the same as the REP= string attribute in FORMGEN. The replenish string cannot be longer than one character. This is the replenish attribute in the image and field level attributes in FORMGEN. This parameter is valid only for field definitions. The default is blank. This is not a positional keyword parameter. INITIAL_VALUE= Defines the string displayed when you specify INITIAL_VALUE for output to a field. It also specifies the textual string if you specify OUTPUT_ATTRIBUTES CONTENTS=CONSTANT. This provides text definition when you do not use a TEMPLATE command. This parameter is valid only for field definitions when DATA_TYPE=ALPHANUMERIC or ALPHABETIC. This is not a positional keyword parameter. In FORMGEN, this is the initial values function. If you set CONTENTS equal to EMPHASIS_CONSTANT, this buffer contains emphasis characters. These character values are the same as those specified for field emphasis. These characters are as follows: N No emphasis 0 No emphasis 1 Underscore U Underscore 2 Strike-through S Strike-through 3 Underscore and strike-through L Left column separator 4 Left column separator 5 Underscore and left column separator 6 Strike-through and left column separator 7 Underscore, strike-through, and left column separator In addition, space, NULL, and any other character are treated as no emphasis

158 Form Language Definition Processor (FLDP) MARKING_CHARACTER= Defines the character used to mark the starting, ending, and insertion point of a defined area in FORMGEN marking. This character is not used by FLDP during form definition. This character cannot be a field character, A-Z, 0-9, or a masterspace. This parameter is valid only for the FORM command. It is not valid for image or field definitions. There is no default. This is not a positional keyword parameter. This is the marking character form-level attribute in FORMGEN. I18N_CCSNUM= Defines the coded character set number used during DPS output for literal text. This parameter is valid only for the FORM command. It is not valid for image or field definitions. The default value for I18N_CCSNUM is the CCS value taken from the user's locale. If this value is 0, DPS does not perform any transliteration before displaying the screen. This is not a positional keyword parameter. This is the I18N CCS Number form-level attribute in FORMGEN. Example 1 PREDEFINED_VALUE REPLENISH_STRING="+" Example 2 PRE_VAL INI_VAL = "This is the initial value for a field" REPEAT_IMAGE Use this statement along with the IMAGE command (see ) to repeat a line in a form. First, define an image with the IMAGE command. Then, further define the image as a repeated image with the REPEAT_IMAGE statement. The REPEAT_IMAGE statement is valid only for the IMAGE command. In FORMGEN, these values are specified on the Repeat Images Attributes Menu. To specify a multiline vertical repeat, use the HEIGHT keyword of the DIMENSION statement. When you use the TEMPLATE command, use the first and last character positions of the line for the START_IMAGE and STOP_IMAGE characters. Format REPEAT_IMAGE [ COUNT=integer ] & [ INDEX_ITEM=name ] & [ CONSTANTS={NO YES} ] & [ DIRECTION={RIGHT DOWN} ] & [ SPACING=integer ]

159 Form Language Definition Processor (FLDP) where COUNT= Defines the number of occurrences for the repeated entity. FLDP uses the repeat count to validate that fields or images do not overlap and that the repeat does not extend beyond the form length. The default value is 2. This is not a positional keyword parameter. This is the COUNT repeat-images attribute in FORMGEN. INDEX_ITEM= Defines the COBOL or C data item used to index the repetition. This name must conform to the standard syntax for image and field names. The default value is INDEXn where n is a unique number. CONSTANTS= Specifies whether the constants within the boundary of the repeat image is repeated. The default value is NO. This is not a positional keyword parameter. This is the LITERALS repeat-images attribute in FORMGEN. DIRECTION= Specifies direction for the repeated image. DOWN means vertical repeat and RIGHT means horizontal repeat. The default value is DOWN. This is the DIR repeat-images attribute in FORMGEN. SPACING= Specifies the number of columns between each horizontal repeat. Must be 0 for vertical repeats. The default value is 0. This is the SPACING repeat-images attribute in FORMGEN. If an ON/OFF image is contained on one line and you want to repeat this line, use two IMAGE commands to define the repeat image and ON/OFF image. First, define the repeat image with the IMAGE command and specify the REPEAT_IMAGE statement for the IMAGE. Then, specify another IMAGE command to define the ON/OFF image. To define an entire line as an ON/OFF image using the TEMPLATE command, define the ON/OFF image with START_IMAGE and STOP_IMAGE characters in the template. To repeat the entire line, enter two consecutive IMAGE commands to define the repeated ON/OFF image

160 Form Language Definition Processor (FLDP) Example FORM A,1... TEMPLATE [ _ _ _ _ Line to occur 5 times ] *END IMAGE TEMPLATE_DEFINED=NO REPEAT_IMAGE COUNT=5 INDEX_ITEM="REPI" CONSTANTS=YES POS_IMA 1,1 ; DIM 80 IMAGE ONI,1 TEMPLATE_DEFINED=YES... END_IMAGE END_IMAGE END_FORM SECURITY Use this statement to specify the security type and level for the entity you define and the display action if security fails. Use this statement at the form, image, or field level. There are equivalent form, image, and field level attributes in FORMGEN. Format SECURITY where [TYPE={SOFT HARD}] & [LEVEL=integer] & [FAIL_ACTION={NORMAL DIAGNOSE PROTECTED_BLANKS PROTECTED_DATA}] TYPE= Specifies how your security is checked at run time. The default value is SOFT. This is the first positional keyword parameter. This is the SECT image attribute in FORMGEN. SOFT Indicates that the end users security level must be equal to or greater than the security level of the form, image, or field in order to access it. HARD Indicates that the end users security level must exactly match the security level of the form, image, or field in order to access it

161 Form Language Definition Processor (FLDP) LEVEL= Specifies the security level for your form, image, or field. Specify an integer between 1 and the system maximum for your DPS 2200 system. The default value is 1. This is the second positional keyword parameter. This is the SECL image attribute in FORMGEN. FAIL_ACTION= Specifies the display action if the security check fails. If SECURITY LEVEL equals 1, FAIL_ACTION must equal NORMAL. For a form security level greater than 1, FAIL_ACTION must equal DIAGNOSE. This is the third positional keyword parameter. This is the SECF image and field level attribute in FORMGEN. This parameter is not specified for form the level, it defaults to either DIAGNOSE or NORMAL. DIAGNOSE Specifies that, if the security check fails for a form, DPS 2200 does not display the form but returns a fatal error with the D$OPEN function. Do not specify DIAGNOSE for images or fields. PROTECTED_BLANKS Specifies that, if the security check fails, DPS 2200 sends protected blanks to the display for the image or field that failed. This is the default value for an image or field. PROTECTED_DATA Example Specifies that, if the security check fails, DPS 2200 displays the data in working storage, if the data is protected. To display attribute values, always specify this value. SECURITY SOFT,5,PROTECTED_DATA

162 Form Language Definition Processor (FLDP) STORAGE Use this statement to specify data and control storage characteristics for a form. A form definition requires this statement. There is no default. Use this statement at the form or field level. Format STORAGE [ SOURCE=GENERATE ] & [ GENERATE_TYPE=FCA ] & [ GENERATE_PREFIX={NO YES} ] & [ DATA_TYPE={ALPHA_NUMERIC ALPHABETIC NUMERIC COMPUTATIONAL BINARY INTEGER REAL DOUBLE_PRECISION}] where SOURCE= This parameter must equal GENERATE. Use it only as a form definition attribute. It is not valid at the image or field level. This is the first positional keyword parameter. There is no equivalent in FORMGEN. GENERATE_TYPE= This parameter must equal the field control area (FCA). It identifies the type of control storage to generate. This keyword parameter is required for form definition and is not valid at the image or field level. This is the second positional keyword parameter. There is no equivalent in FORMGEN. GENERATE_PREFIX= Specifies whether to generate a prefix string for data items while generating working storage. Do not specify this for FIELD or IMAGE commands. It is not a keyword parameter. The default value is NO. This differs from the default value in FORMGEN. This is the generate prefix form-level attribute in FORMGEN. DATA_TYPE= Specifies the type of data storage to generate for a field definition. This is not a positional keyword parameter and is valid only for a field definition. Specify the editing attributes for a field with the GENERAL_EDIT statement. This is equivalent to the COBOL COMP-2 field type. This is the D field type in FORMGEN. The default value is ALPHA_NUMERIC. There are equivalent image level attribute field types in FORMGEN

163 Form Language Definition Processor (FLDP) ALPHA_NUMERIC Specifies that you can combine any characters in the character set as the value for this field. This is the X field type in FORMGEN. ALPHABETIC Specifies that you can use only alphabetic characters, a space, or a combination as the value for this field. This is the A field type in FORMGEN. NUMERIC Specifies that you can use only an integer as the value for this field. The field cannot exceed 18 digits (after editing characters are removed) with a maximum of 18 digits on either side of the decimal point. This is the N field type in FORMGEN. COMPUTATIONAL Specifies that the value of the field is an integer and is used for computations. The field cannot exceed 18 digits (after editing characters are removed) with a maximum of 18 digits on either side of the decimal point. This is the C field type in FORMGEN. BINARY Specifies storing the data for this field in binary form. BINARY fields must be OO fields. This is the B field type in FORMGEN. INTEGER Is the FORTRAN INTEGER type. This is equivalent to COBOL PIC 9(10) COMP and int in C. This is the I field type in FORMGEN. REAL Is the FORTRAN REAL data type. This is equivalent to COBOL COMP-1 and float in C. This is the R field type in FORMGEN. DOUBLE_PRECISION Specifies that this field type represents the FORTRAN DOUBLE PRECISION field type. This is equivalent to double in C. Example (form) STORAGE GEN,FCA GENERATE_PREFIX=YES Example (field) STORAGE DATA_TYPE=COMPUTATIONAL

164 Form Language Definition Processor (FLDP) TAB Restrictions for DATA_TYPE When you define a data type to use with eportal or TIP Connector terminal type, only the ALPHA_NUMERIC, ALPHABETIC, NUMERIC, COMPUTATIONAL, and INTEGER data types are supported. The BINARY, DOUBLE_PRECISION, and REAL data types are restricted. Defining the BINARY, DOUBLE_PRECISION, and REAL data types in your DPS form for use with eportal or TIP Connector yields unpredictable results. Use this statement to set a tab at the beginning of a field. Use this statement only at the field level. Format TAB [ TYPE={NONE NORMAL} ] where TYPE= Specifies type of tab stop to set. NONE Does not set a tab stop. Specify NONE when GENERAL_EDIT USAGE equals OUTPUT. NORMAL Sets a normal tab stop at the beginning of the field. The default values are NORMAL for I/O fields and NONE for OO fields. Because the default value is NORMAL for I/O fields, they automatically contain a tab stop at the start of the field except when you enter NONE or use a UNISCOPE terminal. In these cases, the start-of-field character is occupied. This is the first positional keyword parameter. This is the TAB attribute in FORMGEN. IBM 3270 and Dataspeed terminals always place a tab stop at the start of an unprotected field. The TAB attribute has no effect on these terminals. Example TAB NORMAL

165 Form Language Definition Processor (FLDP) TEST This statement sets the terminal test mode for a form. DPS 2200 displays the image or field only when terminal test mode is ON. Use this statement at the form, image, or field level. If you set test mode for a form and that form is open during run time, an error displays a message other than the production error message. When you set test mode for a form, DPS 2200 enables all test dependent fields defined for that form. You can dynamically set terminal test mode through a DPS 2200 utility. Format TEST [ SET_MODE={NO YES} ] & [ DEPENDENT={NO YES} ] where SET_MODE= Specifies whether to set the terminal test mode when DPS 2200 sends the form to the terminal. This is not a positional parameter and is valid only for form commands. This is the test mode form-level attribute in FORMGEN. YES NO Specifies, if the terminal test mode is not on, to set it to ON before DPS 2200 sends the form to the terminal. Specifies default value of NO. DEPENDENT= Specifies whether to check the terminal test mode before displaying an image or field. This is not a positional keyword parameter and is valid only for image or field commands. This is the TDEP image and field level attribute in FORMGEN. YES NO Displays the image or field only when the terminal test mode is ON. If the terminal test mode is not ON, the image or field is not displayed. Specifies no check of terminal test mode before displaying the image or field. The default value is NO

166 Form Language Definition Processor (FLDP)

167 Section 5 Form Language Manipulation Utility (FLMU) This section describes the FLMU processor, which is a component of DPS It describes the calling statement and options, and shows examples of its use Overview FLMU lets you modify, convert, and secure the DPS 2200 form definitions in the form library. One use of FLMU is to put one or more DPS 2200 form definitions into an omnibus file named SCREEN$OMN. You can then use this file either as a backup file for the same DPS 2200 system or use the form definitions as input to another DPS 2200 system. When you select the I option, FLMU automatically converts existing formats to accommodate changes in the configured DPS 2200 form definition. You can also use FLMU to generate an octal printout of the forms or to upgrade the form library format for future levels of DPS When you call the FLMU processor, the following rules apply: If you call the processor without specifying any options or when you specify only the L option, the D option is assumed (default option). Each option is exclusive of all other options, except that you can combine the C option with the I option for a special action. You can use the L option with any other option Calling FLMU Use the FLMU processor only in the demand environment or the batch mode. Call it with the following [form library] where

168 Form Language Manipulation Utility (FLMU) options C D F G H Converts forms to a DPS 2200 format matching your configuration and level. This option assumes ALL for input, and can be used only with the I option. Do not use the C option and O option together. If you do, a message is displayed stating that conversion cannot be performed during output. DPS 2200 prints the specified forms with ER SNAP$. See the OS 2200 Exec System Executive Requests Programming Reference Manual. This output is designed for use by trained systems analysts, or by the development center when submitted with a user communication form (UCF). The output lists the dumped forms, if the forms are in the range selected. DPS 2200 translates specified predefined forms from the form library to FLDP source statements. The output is contained in the element SCREEN$OMN.FLDPn, where n is the form number. You can then use this element as input to FLDP to produce the identical form. Generated FLDP source is in formatted, nonposition, keyword notation. Templates are not used. The output is optimized because only those attributes with non-default values are generated (see the L option). See Section 4 for details on FLDP. DPS 2200 generates working storage from the form library specified in the processor call statement. The FLMU processor requests input before generating working storage. It transfers the output to a file with the use name of SCREEN$OMN. The element name is SCREEN-#/version, where # is the form number of the form being generated. The version is COBP if generating COBOL working storage, FTNP if generating FORTRAN working storage, H if generating C working storage, or CONNECTOR if generating eportal or TIP Connector working storage. All input must be on the same line. When using the G option to generate working storage, you must separate the following parameters with a space, comma, or any non-numeric character: Language (ASCII COBOL, FORTRAN, UCS C, UCS COBOL, or CONNECTOR). The default is ASCII COBOL. Prefix (YES or NO). The default is the prefix specified when you originally created the form. Initial values (YES or NO). The default is YES. Redefinition (YES or NO). The default is NO. Storage type (DEFAULT or TYPEDEF). The default is the default storage allocation for the compiler. Output type (FILE or REPOSITORY). The default is FILE. DPS 2200 translates specified predefined forms from the form library to HyperText Markup Language (HTML) source statements. The output is contained in the element SCREEN$OMN.HTML-n, where n is the form number

169 Form Language Manipulation Utility (FLMU) I L M O P R S U W Y form library Initiates input of the specified forms from the file SCREEN$OMN, where they were written by the FLMU processor with the O option. This process accommodates definitions created under DPS 2200 systems with different configurations, except for SCRFIELDS. The specified forms cannot be in the DPS 2200 form library. If you attempt to load them into the form library, an error message is generated. File SCREEN$OMN must exist and be either assigned or assignable. You may use this option with the C option. Produces a long listing. When combined with all other options, the L option echoes the input. When combined with the F option, the L option generates all valid attributes for the form, images, and fields. When you specify only the L option, the D option is assumed. Changes the dynamic control indicator of the first I/O field of each specified form to an M if it is defined as a U. Initiates output of the specified forms from the DPS 2200 form library to the SCREEN$OMN file as individual omnibus program file elements. Each form definition has its own omnibus element. The SCREEN$OMN file must exist and be either assigned with exclusive use or available for exclusive use. Do not use the C option and O option together. If you do, a message is displayed stating that conversion cannot be performed during output. Changes the dynamic control indicator of the first I/O field of each specified form to a P if you defined it as a U or M. Reinitializes the specified forms. It is roughly equivalent to initializing the form library with the File Initialization Processor (DPSIF) processor. DPS 2200 prints the specified form by transferring output to print file DPS$time (time indicates current time). The use name DPS$SF$PRINT is attached to the output print file. This accommodates FLMU users printing forms from multiple form libraries, where conflicts might occur in the print file names. Changes the dynamic control indicator to M for all I/O fields with a dynamic control indicator of U. DPS 2200 translates specified predefined forms from the form library to JAVA source statements. The output is contained in the element SCREEN$OMN.JAVA-###, where ### is the form number. Sets the training mode and uses the training file if TIP files are in use. Specifies to FLMU what form library to access. If omitted, DPS 2200 defaults to the first configured form library

170 Form Language Manipulation Utility (FLMU) After the processor call statement, enter one or more line images identifying the particular form numbers that DPS 2200 uses. Square brackets show optional clauses; braces show required alternatives. where ALL [ ALL form-number-1 [:form-number-2] ] [,[+/-] displacement] Includes forms numbered from 1 to the maximum-configured form number in the action. form-number-1 Specifies the starting form number. If form-number-2 is entered, it specifies including the end of a range of numbers (inclusive) in the action. These numbers apply to the DPS 2200 form library form numbers. displacement Displaces the element names in the SCREEN$OMN file from the form numbers in the form library. Preceding displacement with a plus sign (+) adds that value to each form number specified (ALL, range of numbers, or a single number) to get the element name. Preceding displacement with a minus sign (-) subtracts that value from each form number specified to get the element name. If you do not specify a sign, FLMU subtracts the form-number-1 value or a value of 1 if you specified ALL from the displacement value and uses the result as if it had been entered with the appropriate sign preceding it. For example, 10:20,15 is the same as entering 10:20,+5 because (displacement - form-number-1 ) equals +5. Likewise, entering 109:20,7 is the same as entering 10:20,-3 because 7-10 (displacement - form-number-1) equals -3. When you select the I and O options, the omnibus elements have the form number as their element name and a blank version name. The file name is always SCREEN$OMN. To assign SCREEN$OMN to any user file, SCREEN$OMN.,user-file

171 Form Language Manipulation Utility (FLMU) 5.3. Examples Using FLMU The following examples show some of the things you can do with FLMU. Example 1 Copy form definitions numbered 10 through 20 to form definitions 40 through 50. Assume you are in the demand environment and logged on under the special SCREEN$OMN.,F2///3000 ASG FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER 10:20, FORMS OUTPUT TO FILE SCREEN$OMN. ENTER FORM FLMU FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER 40:50 11 FORMS INPUT FROM FILE SCREEN$OMN. ENTER FORM FLMU FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER 10:20 11 FORMS REINITIALIZED. ENTER FORM FLMU COMPLETE

172 Form Language Manipulation Utility (FLMU) Example 2 Copy existing forms from a nonconfigured form library called BACKUP to a configured form library called SCREEN$OMN. ASG BACKUP FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER 1:20 20 FORMS OUTPUT TO FILE SCREEN$OMN. ENTER FORM FLMU DSPIF 6R4 6R4 DPS File Initialization Processor yymmdd hhmm:ss SCREEN NEW1 *** FORM LIBRARY NEW1 INITIALIZED NEW1 FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER ALL ; 20 FORMS INPUT FROM FILE SCREEN$OMN. ENTER FORM FLMU COMPLETE Example 3 Reconfigure DPS 2200 to hold more fields per form SCREEN$OMN,F2///3000 ASG FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER ALL 40 FORMS OUTPUT TO FILE SCREEN$OMN. ENTER FORM FLMU COMPLETE

173 Form Language Manipulation Utility (FLMU) Example 4 After reconfiguring your DPS DSPIF 6R4 6R4 DPS File Initialization Processor yymmdd hhmm:ss ALL *** PASSWORD FILE INITIALIZED *** FORM LIBRARY SCREEN$FILE INITIALIZED *** TERMINAL FILE INITIALIZED *** PAGING FILE INITIALIZED FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss ENTER FORM NUMBER ALL 40 FORMS INPUT FROM FILE SCREEN$OMN. ENTER FORM FLMU COMPLETE

174 Form Language Manipulation Utility (FLMU) Example 5 To generate ASCII COBOL working storage for forms 1 through 10 from form library COBOLWS, set the parameters to the following values: Language to COBOL Prefix to DEF Initial values to YES Redefinition to NO Storage type to DEF Output type to SCREEN$OMN. I: ASG FLMU 6R4 6R4 Form Language Manipulation Utility yymmdd hhmm:ss Enter the following in exact order, separated by commas Language [ <COB>= ASCII COBOL FOR=FORTRAN UC=UCS C UCOB=UCS COBOL], Prefix [ <DEF>=Default Y =YES N =NO) ], Initial Values [ <Y> =Yes N =No ], Redefinition [ <N> =No Y =Yes ], Storage Type [ <DEF>=Default TYP=Typedef ], Output Type [ <F> =File R =Repository ] COBOL, DEF, YES, NO, DEF, FILE ENTER FORM NUMBER 1:10 10 FORMS CONVERTED TO WORKING STORAGE *** ENTER FORM FLMU COMPLETE

175 Section 6 Definition Routines (D$DEF) This section describes the D$DEF routines and how to use them to create new forms and modify existing forms in a temporary workspace. These are temporary forms and you must save them in a form library or they will be lost. These forms are identical to those produced by FORMGEN Overview The D$DEF routines are a component of the DPS These are run-time routines that can be used to create new forms or modify existing forms. After creating and modifying the forms, you must save them in a form library or they will be lost. Definition (D$DEF) routines create, modify, delete, and retrieve forms, images, and fields. They perform the same functions as the FORMGEN processor and FLDP. However, because the D$DEF routines are run-time routines, you can dynamically define a form during program execution. You can embed D$DEF functions in your application programs written in COBOL, FORTRAN, MASM, or C. A DPS 2200 applications programmer can also generate forms with the following processors: FORMGEN Processor (see Section 3) FLDP (see Section 4) Differences from Other Run-Time Routines D$DEF functions differ from other run-time functions because D$DEF routines apply only to temporary forms. A temporary form is similar to an editor's temporary workspace, in which you can do the following: Create new temporary forms Access a previously defined form from the form library or omnibus file Modify temporary forms

176 Definition Routines (D$DEF) D$DEF routines let you save a new form or make permanent changes to an existing form in a form library or omnibus file. If you do not save your temporary form one of the following occurs: The temporary form is deleted when the program terminates. The temporary form is deleted when you create or load another form. The form accessed from the form library remains unchanged. Note: The temporary form is not saved across transactions in a conversationally linked program. Therefore, all your modifications must be made in the same transaction. You can send the temporary form to the terminal, as you would any form in a form library. First, call the D$OPEN function, using 0 as the form number. The D$DEF functions are intended to be as flexible as possible: You do not need a form library or omnibus file to use most D$DEF functions. The exceptions are the D$DEFLOAD, D$DEFSAVE, and D$DEFERASE functions. You may call the functions in any order, but you must create the temporary form first by using D$DEFFRMCRE or load a form in the temporary form using D$DEFLOAD. Attributes controlling the display, editing, and positioning qualities of forms, images, and fields may be passed to the D$DEF functions in any order. All attributes default to a value if not passed to the D$DEF function. See Table 6 1, Table 6 2, and Table 6 3 for default attribute values. Form definition is considered complete any time after you create it with the D$DEFFRMCRE or D$DEFLOAD function. You can now do one of the following: Save the form in a form library at any time using the D$DEFSAVE function. Send it to a terminal. Print it using D$DEFPRINT. Generate working storage using D$DEFGENWS Similarities to Other Run-Time Routines There are interfaces between the D$DEF routines and the same languages as other run time routines. These routines can operate in batch mode, demand, or TIP environments. You must initialize with DPS 2200 before calling any D$DEF routine, just as you must initialize with DPS 2200 before using any of the DPS 2200 functions

177 Definition Routines (D$DEF) 6.2. D$DEF Copy Procedures To call the D$DEF routines, use the following seven copy procedures: DPS-STATUS Use this procedure for all calls to the D$DEF routines. It is similar to the STATUS-WORD, with the addition of a STATUS-EXTENSION for returning attributes. It is the first parameter on a call. When an error occurs, it contains the status code, status function, and a one-character status-indicator ( W =warning, F =fatal, =OK). In addition, the status-extension contains the attribute identifier in error. DPS-OPTIONS Use this procedure for all calls to the D$DEF routines. It is the second parameter on a call. On input, it passes options for controlling D$DEF functions. D$DEF routines search only for valid options and ignore invalid options. DPS-NAMES Use this procedure for all D$DEF calls. It is the third parameter on a call. This procedure passes form library names, form names, or numbers of newly created or modified forms, images, and fields to D$DEF functions. Use this procedure to pass the names of forms, images, or fields you are accessing. DPS-NAME-TABLE The D$DEFNAMRET function uses this procedure to return the names of images and fields in the form. DEF-ATTRS The DEF-ATTRS procedure contains the definitions of all the attribute identifiers and their legal values. All identifiers are prefixed by D-ATT-. All values are prefixed by D-VAL-. These are the values you pass in the DPS-ATTR-TABLE. GENERATE-WS-PKT This procedure is used by the D$DEFGENWS function to control working-storage generation. Information in this table controls the following: Whether to generate working storage in COBOL, FORTRAN, or C Whether initial values should be generated if COBOL or C is used Whether working storage can be redefined if COBOL is used Whether working storage is saved in the repository if COBOL or C is used Whether working storage type is DEFAULT or TYPEDEF if C is used

178 Definition Routines (D$DEF) DPS-ATTR-TABLE Use this procedure to pass attribute identifiers and attribute values to the D$DEF routines. See Table 6 1 for a list of attribute identifiers and values passed to the D$DEF routines. When the attribute table is empty, the following occurs: $ The ATT-ENTRIES count is zero D$DEF assumes defaults on create functions The attributes remain unchanged on modifying functions Note: All attributes have default values. The DPS-ATTR-TABLE procedure also includes the DPS-ATTR-BUFF procedure, which contains all character attribute values D$DEF Names Parameter This is the third parameter passed to all D$DEF routines. This parameter contains information such as the form library name, form name, form number, field name, or image name. Following is an example of how the DPS-NAMES parameter should be setup and the data to save in the DPS-NAMES parameter when calling the D$DEF routines: FORM LIBRARY NAME -- SCREEN$FILE FORM NUMBER FORM NAME -- AAAA FIELD NAME -- IMAGE1 MOVE SCREEN$FILE TO DIRECTORY-PATH-ARRAY(1). MOVE 100 TO FORM-NUMBER. MOVE 2 TO IMAGE-COUNT. MOVE AAAA TO IMAGE-NAME(1). MOVE IMAGE1 TO IMAGE-NAME(2)

179 Definition Routines (D$DEF) D$DEF Attributes Table 6 1, Table 6 2, and Table 6 3 describe the attribute identifiers and values passed to D$DEF routines through the DPS-ATTR-TABLE. An attribute has an identifier (to name it) and a value. The D$DEF routines use the same attribute terminology as FLDP and the FORMGEN processor. All attributes are either numeric or characters, based on their values. An example of a numeric attribute is the field width (D-ATT-DIMENSION-WIDTH). An example of a character attribute is an initial value (D-ATT-INITIAL-VALUE), because its value is a character string. To set the D-ATT-DIMENSION-WIDTH attribute in COBOL, enter MOVE NUMERICC TO ATT-TYPE (1). MOVE D-ATT-DIMENSION-WIDTH TO ATT-ID (1). MOVE 25 TO ATT-NUM-VALUE (1). To set the D-ATT-INITIAL-VALUE character attribute in COBOL, enter MOVE CHARACTERR TO ATT-TYPE (2). MOVE D-ATT-INITIAL-VALUE TO ATT-ID (2). MOVE 25 TO ATT-SIZE (2). MOVE 1 TO ATT-OFFSET (2). MOVE "THIS IS AN INITIAL VALUE!" TO DPS-ATTR-BUFF. Then, to identify the fact that you have defined two attributes, one numeric, and one character, enter MOVE 2 TO ATT-ENTRIES Note that values valid at one level may not be valid at another and that default values depend on the data type of a field (alphanumeric, alphabetic, computational, and so forth). For example, JUSTIFICATION is invalid for a BINARY field. Therefore, the default is NONE rather than right justification. The prefix for the attributes, values, and defaults is specified in the column header. For example, attribute D-ATT-BACKGROUND-COLOR may have D-VAL-BCOL-WHITE as its value

180 Definition Routines (D$DEF) Form Level Attributes Table 6 1 contains the form level COBOL attribute identifiers, possible values, and default values. Table 6 1. Form Level Attributes, Values, and Defaults Attribute (D-ATT-) Type* Values (D-VAL-) Default (D-VAL-)) ALL-FUNCTION KEYS N FKEY-NONE FKEY-ALL FKEY-LIST FKEY-NONE ANTI-CONCAT-CHAR C One character No default BACKGROUND-COLOR N BCOL-WHITE BCOL-EBONY BCOL-RED BCOL-GREEN BCOL-BLUE BCOL-YELLOW BCOL-MAGENTA BCOL-CYAN CHECKMODE N CHECKMODE-NO CHECKMODE-YES BCOL-EBONY CHECKMODE-YES COMMA-SYM C One character, CONTL-CHARACTERS N CONTL-NONE CNTL-BLINK CONTL-NONE CONVERSATION-MODE CON-NO CON-YES CON-NO CURSOR-NAME C Character string No default (required when CURSOR-TYPE is CUR-IMAGE) CURSOR-TYPE N CUR-DEFAULT CUR-IMAGE CUR-DEFAULT DECIMAL-PT-SYM C One character. DIMENSION-LENGTH N Integer 1 DIMENSION-WIDTH (80 is the only valid value) N Integer 80 EMPH-LEFTCOLUMN N ELEFTCOL-NO ELEFTCOL-YES ELEFTCOL-NO Legend * N = Numeric and C= Character

181 Definition Routines (D$DEF) Table 6 1. Form Level Attributes, Values, and Defaults Attribute (D-ATT-) Type* Values (D-VAL-) Default (D-VAL-)) EMPH-STRIKETHROUGH N ESTRKTHRU-NO ESTRKTHRU-YES EMPH- UNDERSCORE N EUNSCORE-NO EUNSCORE-YES ESTRKTHRU-NO EUNSCORE-NO FIELD-CHARACTER C One character _ FONT N FONT-NORMAL FONT-ALT1 FOREGROUND-COLOR N FCOL-WHITE FCOL-EBONY FCOL-RED FCOL-GREEN FCOL-BLUE FCOL-YELLOW FCOL-MAGENTA FCOL-CYAN FOREGROUND-INT N FINT-NORMAL FINT-SUPPRESS FINT-LOW FINT-HIGH FONT-NORMAL FCOL-WHITE FINT-NORMAL FUNCTION-KEY-1 to FUNCTION-KEY-36 N FKEY-NO FKEY-YES FKEY-NO GENERATE-PREFIX N PRFX-NO PRFX-YES PRFX-NO GENERATE-STORAGE N STO-FCA STO-FCA (If not specified, a warning is issued and this value is assumed.) HIGHLT-BLINK N HBLINK-NO HBLINK-YES HIGHLT-REVERSE N HREVERSE-NO HREVERSE-YES HBLINK-NO HREVERSE-NO I18N-CCSNUM C Integer The default for I18N_CCSNUM is the CCS value taken from the user s locale. IMAGE-START-CHAR C One character IMAGE-STOP-CHAR C One character Legend * N = Numeric and C= Character

182 Definition Routines (D$DEF) Table 6 1. Form Level Attributes, Values, and Defaults Attribute (D-ATT-) Type* Values (D-VAL-) Default (D-VAL-)) MARKING-CHARACTER C One character No default NEW-IMAGE-NAME C Character string FORM SECURITY-FAIL N SFAIL-NORMAL SFAIL-DIAGNOSE SFAIL-NORMAL SECURITY-LEVEL N Integer 1 SECURITY-TYPE N SEC-SOFT SEC-HARD SEC-SOFT SOE-CHARACTER C One character No default STORAGE-SOURCE N GEN-GENERATE GEN-GENERATE (If not specified, a warning is issued and this value is assumed.) TEST-MODE N TEST-NO TEST-YES Legend * N = Numeric and C= Character TEST-NO Image Level Attributes Table 6 2 contains the image level COBOL attribute identifiers, possible values, and default values for both repeat and ON/OFF images. Table 6 2. Image Level Attributes, Values, and Defaults (Repeats and ON/OFFs) Attribute (D-ATT-) Type* Values (D-VAL-) Default (D-VAL-)) BACKGROUND-COLOR N BCOL-WHITE BCOL-EBONY BCOL-RED BCOL-GREEN BCOL-BLUE BCOL-YELLOW BCOL-MAGENTA BCOL-CYAN BCOL-EBONY Legend * N = Numeric and C= Character

183 Definition Routines (D$DEF) Table 6 2. Image Level Attributes, Values, and Defaults (Repeats and ON/OFFs) DIMENSION-LENGTH (must be 1 for ON/OFF and horizontal repeats.) N Integer 1 DIMENSION-WIDTH N Integer 1 EMPH-LEFTCOLUMN N ELEFTCOL-NO ELEFTCOL-YES EMPH-STRIKETHROUGH N ESTRKTHRU-NO ESTRKTHRU-YES EMPH-UNDERSCORE N EUNSCORE-NO EUNSCORE-YES FONT N FONT-NORMAL FONT-ALT1 FOREGROUND-COLOR N FCOL-WHITE FCOL-EBONY FCOL-RED FCOL-GREEN FCOL-BLUE FCOL-YELLOW FCOL-MAGENTA FCOL-CYAN FOREGROUND-INT N FINT-NORMAL FINT-LOW FINT-HIGH FINT-SUPPRESS HIGHLT-BLINK N HBLINK-NO HBLINK-YES HIGHLT-REVERSE N HREVERSE-NO HREVERSE-YES ELEFTCOL-NO ESTRKTHRU-NO EUNSCORE-NO FONT-NORMAL FCOL-WHITE FINT-NORMAL HBLINK-NO HREVERSE-NO HOR-DISPLACEMENT N Integer 1 IMAGE-TYPE N IMG-NORMAL IMG-LINKED IMG-NORMAL INDEX-NAME valid for repeats only C Character string INDEXn, where n is a unique number Legend * N = Numeric and C= Character

184 Definition Routines (D$DEF) Table 6 2. Image Level Attributes, Values, and Defaults (Repeats and ON/OFFs) LINK-NAME valid for ON/OFFs only C Character string Name of first previous ON image NEW-IMAGE-NAME C Character string IMAGEn, where n is a unique number OUTPUT-CONTENTS N OUT-STORAGE OUT-BLANK POS-VAR-COLUMN N POSVCOL-NO POSVCOL-YES POS-VAR-ROW N POSVROW-NO POSVROW-YES OUT-STORAGE POSVCOL-YES POSVROW-YES REPEAT-COUNT valid for repeats only N Integer 2 REPEAT-DIRECTION valid for repeats only N REP-DOWN REP-RIGHT REP-DOWN REPEAT-LITERALS valid for repeats only N LIT-NO LIT-YES LIT-NO REPEAT-SPACING valid for repeats only N integer 0 SECURITY-FAIL N FAIL-NORMAL SFAIL-PROBLANK SFAIL-NORMAL SECURITY-LEVEL N Integer 1 SECURITY-TYPE N SEC-SOFT SEC-HARD TEST-DEPENDENT N TST-NO TST-YES SEC-SOFT TST-NO VERT-DISPLACEMENT N Integer 1 Legend * N = Numeric and C= Character

185 Definition Routines (D$DEF) COBOL Attribute Identifiers Table 6 3 contains the field level COBOL attribute identifiers, possible values, and default values. Table 6 3. Field Level Attributes, Values, and Defaults Attribute (D-ATT-) Type* Values (D-VAL-) Default (D-VAL-)) ALLOW-QUERY N AQ-NO AQ-YES BACKGROUND-COLOR N BCOL-WHITE BCOL-EBONY BCOL-RED BCOL-GREEN BCOL-BLUE BCOL-YELLOW BCOL-MAGENTA BCOL-CYAN BLANK-FOR-ZERO N BLANK-NO BLANK-YES BLANK-INPUT N BLANK-UNCHANGED BLANK-BLANK BLANK-ZERO CHARACTER-CASE N CHAR-EITHER CHAR-UPPER DATA-ENTRY N DATA-OPTIONAL DATA-MANDATORY DATA-TYPE N DATA-ALPHANUMERIC DATA-ALPHA DATA-NUMERIC DATA- COMPUTATIONAL DATA-BINARY DATA-INTEGER DATA-REAL DATA-DOUBLE AQ-NO BCOL-EBONY BLANK-NO BLANK-BLANK CHAR-EITHER DATA-OPTIONAL DATA-ALPHANUMERIC Legend * N = Numeric and C= Character

186 Definition Routines (D$DEF) Table 6 3. Field Level Attributes, Values, and Defaults DECIMAL-SCALE N Integer 0 DIMENSION-LENGTH must be 1 N Integer 1 DIMENSION-WIDTH N Integer 1 DIM-VAR-WIDTH N DIMVWID-NO DIMVWID-YES DISPLAY-POSITIVE N DIS-NO DIS-YES EMPH-LEFTCOLUMN N ELEFTCOL-NO ELEFTCOL-YES EMPH-STRIKETHROUGH N ESTRKTHRU-NO ESTRKTHRU-YES EMPH-UNDERSCORE N EUNSCORE-NO EUNSCORE-YES EXPONENTIAL-NOTATION N EXP-NO EXP-YES FONT N FONT-NORMAL FONT-ALT1 FOREGROUND-COLOR N FCOL-WHITE FCOL-EBONY FCOL-RED FCOL-GREEN FCOL-BLUE FCOL-YELLOW FCOL-MAGENTA FCOL-CYAN FOREGROUND-INT N FINT-NORMAL FINT-LOW FINT-HIGH FINT-SUPPRESS HIGHLT-BLINK N HBLINK-NO HBLINK-YES HIGHLT-CORRECTION N HCOR-NO HCOR-YES DIMVWID-NO DIS-NO ELEFTCOL-NO ESTRKTHRU-NO EUNSCORE-NO EXP-NO FONT-NORMAL FCOL-WHITE FINT-NORMAL HBLINK-NO HCOR-NO Legend * N = Numeric and C= Character

187 Definition Routines (D$DEF) Table 6 3. Field Level Attributes, Values, and Defaults HIGHLT-REVERSE N HREVERSE-NO HREVERSE-YES HREVERSE-NO HOR-DISPLACEMENT N Integer 1 INITIAL-VALUE C Character string Blanks INSERT-DELS N DELS-NO DELS-YES JUSTIFICATION N JUS-CENTER JUS-LEFT JUS-NONE JUS-RIGHT LEAD-ZEROS N LEAD-SUPPRESS LEAD-DISPLAY DELS-NO JUS-NONE LEAD-SUPPRESS MAXIMUM-WIDTH N Positive integer Initial length of field MONETARY-SIGN N MON-NONE MON-FLOATING MON-LEADING MON-NONE NEW-IMAGE-NAME C Character string IMAGEn, where n is a unique number NUMERIC-SIGN N NUM-NONE NUM-TRAILING NUM-FLOATING NUM-DISPLAY-POS NUM-CREDIT NUM-DEBIT OUTPUT-CONTENTS N OUT-STORAGE OUT-BLANK OUT-REPLENISH OUT-SYSTEM OUT-CONSTANT OUT-EMPH-CONSTANT POS-VAR-COLUMN N POSVCOL-NO POSVCOL-YES POS-VAR-ROW N POSVROW-NO POSVROW-YES NUM-NONE OUT-STORAGE POSVCOL-YES POSVROW-YES Legend * N = Numeric and C= Character

188 Definition Routines (D$DEF) Table 6 3. Field Level Attributes, Values, and Defaults RADIX N RAD-DECIMAL RAD-OCTAL REPLEN-FOR-BLANKS N REP-NO REP-YES REPLENISH-NOTE N REPNOTE-NO REPNOTE-YES RAD-DECIMAL REP-NO REPNOTE-NO REPLENISH-STRING C One character Blank SECURITY-FAIL N SFAIL-PRODATA SFAIL-PROBLANK SFAIL-NORMAL SFAIL-NORMAL SECURITY-LEVEL N Integer 1 SECURITY-TYPE N SEC-SOFT SEC-HARD SET-MODIFICATION N MOD-NO MOD-YES SET-PROTECTION N PRO-NO PRO-YES SEC-SOFT MOD-NO PRO-NO Legend * N = Numeric and C= Character

189 Definition Routines (D$DEF) Table 6 3. Field Level Attributes, Values, and Defaults SYSTEM-VALUE Output N SYS-NILL SYS-NILL contents must be SYS-DATE-1 OUT-SYSTEM SYS-DATE-2 SYS-DATE-3 SYS-DATE-4 SYS-DATE-5 SYS-DATE-6 SYS-DATE-7 SYS-DATE-8 SYS-TIME-1 SYS-TIME-2 SYS-TIME-3 SYS-FORM-NAME SYS-FORM-NUMBER SYS-DATA-PAGES SYS-PID-NUMBER SYS-LPID-NUMBER SYS-FORM-SECURITY SYS-IMAGE-SECURITY SYS-USER-ID SYS-CURRENT-PAGES SYS-TOTAL-PAGES SYS-INDEX-PAGES SYS-TRAN-CODE SYS-TEST-MODE SYS-CONV-MODE SYS-DPS-LEVEL SYS-USER-LEVEL SYS-USER-FIELD-1 SYS-USER-FIELD-2 SYS-USER-FIELD-3 SYS-USER-FIELD-4 SYS-USER-FIELD-5 SYS-ERROR-LINE SYS-HEADER-LINE SYS-ERROR-HEADER Legend * N = Numeric and C= Character

190 Definition Routines (D$DEF) Table 6 3. Field Level Attributes, Values, and Defaults TAB-SET N TAB-NONE TAB-NORMAL TEST-DEPENDENT N TST-NO TST-YES USAGE N USAGE-INPUT-OUTPUT USAGE-OUTPUT-ONLY VALUE_CHECK N VALCHK-NONE VALCHK-TABLE VALCHK-RANGE TAB-NORMAL TST-NO USAGE-INPUT-OUTPUT VALCHK-NONE VERT-DISPLACEMENT N Integer 1 Legend * N = Numeric and C= Character 6.3. D$DEF Creating Routines These functions create new forms, images, or fields. A new form is a template for lower level images, so you must create it first using the D$DEFFRMCRE function. You can randomly insert fields or images. Use the following functions to create fields, forms, or images: D$DEFFLDCRE D$DEFFRMCRE D$DEFIMGCRE D$DEFFLDCRE Function Use the D$DEFFLDCRE function to create new system-supplied, constant, emphasis-constant, I/O, or OO fields in a temporary form. When you add a field to a temporary form, that form must have been created using D$DEFFRMCRE or loaded using D$DEFLOAD. Fields cannot exist without forms. When you pass a name for constant or system-defined fields, DPS 2200 returns a warning and ignores the name. DPS 2200 returns an internal name for system-defined and constant fields. IMG$0 or IMG$E0 is returned for all constant or emphasis constant fields. Use these internal names to retrieve, modify, or delete fields using D$DEFFLDRET, D$DEFFLDMOD, or D$DEFFLDDEL. Attributes not passed to D$DEFFLDCRE assume their default value. In addition, you can use D$DEFFLDCRE to change constants. The new constants replace the old constants at the given coordinates. New text overwrites old text. However, text cannot overwrite a field or image. In this case, the text that attempted to overwrite the field is ignored and an error is returned. No attributes are necessary to create an I/O field

191 Definition Routines (D$DEF) To create a protected field, enter MOVE NUMERICC TO ATT-TYPE(1). MOVE D-ATT-SET-PROTECTION TO ATT-ID(1). MOVE D-VAL-PRO-YES TO ATT-NUM-VALUE(1). MOVE NUMERICC TO ATT-TYPE(2). MOVE D-ATT-USAGE TO ATT-ID(2). MOVE D-VAL-USAGE-OUTPUT-ONLY TO ATT-NUM-VALUE(2). To specify a field type, enter MOVE NUMERICC TO ATT-TYPE(1). MOVE D-ATT-DATA-TYPE TO ATT-ID(1). MOVE D-VAL-DATA-ALPHANUMERIC TO ATT-NUM-VALUE(1). To create a system-supplied field, enter MOVE NUMERICC TO ATT-TYPE(1). MOVE D-ATT-OUTPUT-CONTENTS TO ATT-ID(1). MOVE D-VAL-OUT-SYSTEM TO ATT-NUM-VALUE(1). MOVE NUMERICC TO ATT-TYPE(2). MOVE D-ATT-SYSTEM-VALUE TO ATT-ID(2). MOVE D-VAL-SYS-DATE-1 TO ATT-NUM-VALUE(2). Constant fields are defined by using the attributes D-ATT-OUTPUT-CONTENTS with value D-VAL-OUT-CONSTANT and D-ATT-INITIAL-VALUE with the initial value string passed in DPS-ATTR-BUFF. Emphasis-constants are special constant fields that are specified by using the same attributes. A value of D-VAL-OUT-EMPH-CONSTANT is specified for D-ATT-OUTPUT-CONTENTS. Special text characters representing emphasis are passed for the initial value. These are identical to the values for field emphasis. N or 0 U or 1 S or 2 Normal (no emphasis) Underscore Strike-through 3 Underscore and strike-through L or 4 Left column separator 5 Underscore and left column separator 6 Strike-through and left column 7 Underscore, strike-through, and left column separator

192 Definition Routines (D$DEF) Rectangular text and emphasis constants are defined using the following attributes: D-ATT-VERT-DISPLACEMENT D-ATT-HOR-DISPLACEMENT D-ATT-DIMENSION-WIDTH D-ATT-DIMENSION-LENGTH D-ATT-OUTPUT-CONTENTS D-ATT-INITIAL-VALUE Following is a list of the attributes and their values that must be specified when defining a rectangular emphasis constant: MOVE NUMERICC TO ATT-TYPE(n). MOVE D-ATT-VERT-DISPLACEMENT TO ATT-ID(n). MOVE Y-coordinate TO ATT-NUM-VALUE(n). MOVE NUMERICC TO ATT-TYPE(n+1). MOVE D-ATT-HOR-DISPLACEMENT TO ATT-ID(n+1). MOVE X-coordinate ATT-NUM-VALUE(n+1). MOVE NUMERICC TO ATT-TYPE(n+2). MOVE D-ATT-DIMENSION-WIDTH TO ATT-ID(n+2). MOVE constant-width TO ATT-NUM-VALUE(n+2). MOVE NUMERICC TO ATT-TYPE(n+3). MOVE D-ATT-DIMENSION-LENGTH TO ATT-ID(n+3). MOVE constant-length TO ATT-NUM-VALUE(n+3). MOVE NUMERICC TO ATT-TYPE(n+4). MOVE D-ATT-OUTPUT-CONTENTS TO ATT-ID(n+4). MOVE D-VAL-OUT-CONSTANT TO ATT-NUM-VALUE(n+4). MOVE D-VAL-OUT-EMPH-CONSTANT TO ATT-NUM-VALUE(n+4). MOVE CHARACTERR TO ATT-TYPE(n+5). MOVE D-ATT-INITIAL-VALUE TO ATT-ID(n+5). MOVE 1 TO ATT-OFFSET(n+5). COMPUTE ATT-SIZE(n+5) = (constant-width * constant-length). MOVE (n+5) TO ATT-ENTRIES. MOVE OOOOOOOOOOOOOOOOOOOOOO... TO DPS-ATTR-BUFF Calling Sequence COBOL: CALL D$DEFFLDCRE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF

193 Definition Routines (D$DEF) FORTRAN: C: CALL DDFLDC (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_deffldcre (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For input: Specify the B option when defining rectangular constants. Specifies the table containing the form library name, form name, and form number. For I/O and OO fields, also specify a field name. Specify 0 for the form number. If a form name is not specified, the default name FORM is assumed. If a name for I/O and OO fields is not passed, the default IMAGEn is used, where n is a unique number. Specifies the table containing the field attributes for the field. Each entry contains an attribute identifier and value. Choose attributes from the field level attributes listed in Table 6 3. Attributes not specified assume their default value. You can change these values by using the D$DEFFLDMOD function (see 6.4.1). Contains all character attribute values

194 Definition Routines (D$DEF) D$DEFFRMCRE Function Use the D$DEFFRMCRE function to create new temporary forms and to define form level attributes. You must use this function before you create new fields or images. To modify an existing form, use D$DEFLOAD (see 6.7.3) instead of D$DEFFRMCRE to load a form from a form library before you create or modify fields or images. If you have a temporary form initialized with a D$DEFFRMCRE function, you must call D$DEFFRMDEL (see 6.6.2) or D$DEFFSAVE (see 6.7.4) before calling D$DEFFRMCRE again. After you call this function, your temporary form is blank, in other words, no constants (text), images, or fields are defined. Only the D-ATT-GENERATE-STORAGE and D-ATT-STORAGE-SOURCE attributes are required for this function. If you do not specify these attributes, DPS 2200 returns a warning and assumes the default values D-VAL-STO-FCA and D-VAL-GEN-GENERATE. Calling Sequence COBOL: CALL D$DEFFRMCRE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDFRMC (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_deffrmcre (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table

195 Definition Routines (D$DEF) COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options No options are supported. DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For input: D$DEFIMGCRE Function Specifies the table containing the form library name, form name, and form number. If a form library name is not specified, DPS 2200 assumes the first configured form library. Specify 0 for the form number. If a form name is not specified, the default name FORM is assumed. Specifies the table containing the global attribute identifiers and values for the form. Choose from the form level attributes listed in Table 6 1. If DPS-ATTR-TABLE does not specify attributes, default values are assumed. Contains all character attribute values. Use the D$DEFIMGCRE function to create ON/OFF, linked ON/OFF, or repeat images in a temporary form. When you add an image to a temporary form, that form must have been previously created by using D$DEFFRMCRE or loaded by using D$DEFLOAD. Images cannot exist without forms. If you pass a name for linked ON/OFF images or repeats, DPS 2200 returns a warning and ignores the name. DPS 2200 returns internal names for linked ON/OFF or repeat images. Use these internal names to retrieve, modify, or delete image attributes by using D$DEFIMGRET, D$DEFIMGMOD, or D$DEFIMGDEL. DPS 2200 provides the default value for any attribute not passed to D$DEFIMGCRE, except image and index names. No attributes are necessary to create an ON/OFF image

196 Definition Routines (D$DEF) To specify an ON/OFF image that is to be initially off, enter MOVE NUMERICC TO ATT-TYPE(1). MOVE D-ATT-OUTPUT-CONTENTS TO ATT-ID(1). MOVE D-VAL-OUT-BLANK TO ATT-NUM-VALUE(1). To specify an ON/OFF image that is to be linked, enter MOVE NUMERICC TO ATT-TYPE(1). MOVE D-ATT-IMAGE-TYPE TO ATT-ID(1). MOVE D-VAL-IMG-LINKED TO ATT-NUM-VALUE(1). MOVE CHARACTERR TO ATT-TYPE(2). MOVE D-ATT-LINK-NAME TO ATT-ID(2). MOVE 1 TO ATT-OFFSET(2). MOVE 10 TO ATT-SIZE(2). MOVE IMAGE-NAME TO DPS-ATTR-BUFF. If this attribute is not specified, the reference name defaults to the ON/OFF image immediately proceeding this image. To create a horizontal repeat image, enter MOVE NUMERICC TO ATT-TYPE(1). MOVE D-ATT-REPEAT-COUNT TO ATT-ID(1). MOVE 4 TO ATT-NUM-VALUE(1). MOVE NUMERICC TO ATT-TYPE(2). MOVE D-ATT-REPEAT-DIRECTION TO ATT-ID(2). MOVE D-VAL-REP-RIGHT TO ATT-NUM-VALUE(2). MOVE NUMERICC TO ATT-TYPE(3). MOVE D-ATT-REPEAT-LITERALS TO ATT-ID(3). MOVE D-VAL-LIT-YES TO ATT-NUM-VALUE(3). MOVE NUMERICC TO ATT-TYPE(4). MOVE D-ATT-REPEAT-SPACING TO ATT-ID(4). MOVE 5 TO ATT-NUM-VALUE(4). MOVE CHARACTERR TO ATT-TYPE(5). MOVE D-ATT-INDEX-NAME TO ATT-ID(5). MOVE 1 TO ATT-OFFSET(5). MOVE 10 TO ATT-SIZE(5). MOVE INDEX-NAME TO DPS-ATTR-BUFF

197 Definition Routines (D$DEF) Calling Sequence COBOL: CALL D$DEFIMGCRE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDIMGC (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_defimgcre (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For input: Specifies the table containing the form library name, form name, and form number. Specify 0 for the form number. If a form name is not specified, the default name FORM is assumed. If a name for ON/OFF images is not passed the default IMAGEn is used, where n is a unique number. Specifies the table containing the image attributes. Each entry contains an attribute identifier and a value. Choose attributes from the field level attributes listed in Table 6 2. Attributes not included in this table assume the default value. Use the D$DEFIMGMOD function to change these attribute values (See 6.4.3). Contains all character attribute values

198 Definition Routines (D$DEF) 6.4. D$DEF Modifying Routines The D$DEF modifying routines modify the attributes of existing forms, images, or fields. They use calling sequences identical to those used in the create routines. While create routines provide default values for incorrect or attributes that are not passed, modify routines do not alter the attributes. Use the following functions to modify forms, images, or fields: D$DEFFLDMOD D$DEFFRMMOD D$DEFIMGMOD Modifying the following two attributes invalidates all other attributes except the positioning attributes: D-ATT-IMAGE-TYPE Changing an ON/OFF image to a linked image Changing a linked image to an ON/OFF image D-ATT-OUTPUT-CONTENTS Changing a system field to a nonsystem field Changing a nonsystem field to a system field Positioning attributes follow D-ATT-DIMENSION-LENGTH Entity height (always 1 for ON/OFF and horizontal repeat images and fields; can be greater than 1 for vertical repeats) D-ATT-DIMENSION-WIDTH Entity width D-ATT-VERT-DISPLACEMENT Entity `Y' coordinate within the form or next outer image D-ATT-HOR-DISPLACEMENT Entity `X' coordinate within the form or next outside image D-ATT-POS-VAR-COLUMN Variable column

199 Definition Routines (D$DEF) D-ATT-POS-VAR-ROW Variable row D-ATT-POS-VAR-WIDTH Variable-width field D-ATT-MAXIMUM-WIDTH Maximum width of variable-width field When you modify attributes other than D-ATT-IMAGE-TYPE and D-ATT-OUTPUT-CONTENTS, the other attributes retain their value unless they conflict with the attributes you are changing D$DEFFLDMOD Function Use the D$DEFFLDMOD function to modify field attributes of an existing field in a temporary form. Use the D$DEFFRMCRE and D$DEFLOAD functions to create temporary forms. Attributes not passed to D$DEFFLDMOD are not altered. It is possible to modify constants in the form. You can overwrite existing constant text with the D$DEFFLDCRE function or specify IMG$0 as the field name in DPS-NAMES on the D$DEFFLDMOD function call. Similarly, you can modify emphasis characters by specifying the name IMG$E0 as the field name. See for details on modifying system-supplied fields. Calling Sequence COBOL: CALL D$DEFFLDMOD USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDFLDM (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_deffldmod (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff);

200 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For input: Specify the B option when defining rectangular constants. Specifies the table containing the form library name, form name, form number, and name of field to modify. Specify 0 for the form number. Specifies the table containing the attribute identifiers and values for the modified attributes. Select field-level attributes from. Contains all character attribute values D$DEFFRMMOD Function Use the D$DEFFRMMOD function to modify the form-level attributes of a temporary form. You must first create a form using the D$DEFFRMCRE function or load an existing form from the form library using the D$DEFLOAD function, before performing this function. All attributes not passed to D$DEFFRMMOD remain unaltered. Calling Sequence COBOL: CALL D$DEFFRMMOD USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDFRMM (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_deffrmmod (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff);

201 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For input: Specifies the table containing the form library name, form name, and form number. If the form library name is omitted, DPS 2200 assumes the first configured form library. Specify 0 for the form number. Specifies the table containing the attribute identifiers and values to modify. Select form-level attributes from. Contains all character attribute values D$DEFIMGMOD Function Use the D$DEFIMGMOD function to modify the attributes of existing images in a temporary form. Attributes not passed to D$DEFIMGMOD are not altered. Lower-level images do not inherit attributes from higher-level images. Calling Sequence COBOL: CALL D$DEFIMGMOD USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDIMGM (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_defimgmod (&dps_status, &dps_options, &dps_names, dps_attr_table, &dps_attr_buff);

202 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For input: Specifies the table containing the form library name, form name, form number, and name of field to modify. Specify 0 for the form number. Specifies the table containing the updated attribute values. For each attribute, an attribute identifier and value are supplied. Unreferenced attributes remain unchanged. Select image-level attributes from. Contains all character attribute values D$DEF Retrieving Routines The D$DEF retrieving routines fetch attributes for forms, images, and fields. The attribute information is returned in the DPS-ATTR-TABLE and DPS-ATTR-BUFF. This differs from the create and modify routines, where you pass DPS-ATTR-TABLE with a list of attributes to set. You can retrieve all attributes, or only those that differ from the defaults, or you can pass (in DPS-ATTR-TABLE) a list of attributes to return. Use the following functions to retrieve attributes for forms, images, or fields: D$DEFFLDRET D$DEFFRMRET D$DEFIMGRET D$DEFNAMRET

203 Definition Routines (D$DEF) D$DEFFLDRET Function Use the D$DEFFLDRET function to retrieve field-level attributes for constant, system-defined, and I/O or OO fields. To retrieve text constant field attributes, specify IMG$0 as the field name in DPS-NAMES. Specify IMG$E0 for emphasis-constants. All constants in the form are treated as a single constant field. Calling Sequence COBOL: CALL D$DEFFLDRET USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDFLDR (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_deffldret (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: A Returns all form attribute values. D R Returns only values different from the defaults Returns only attribute values that you request, and passed as input i in DPS-ATTR-TABLE. DPS-NAMES DN$TBL COBOL dps_names FORTRAN For input: Specifies the table containing the form library name, form name, and form number. Specify 0 for the form number. To retrieve nonemphasis constant field attributes, specify IMG$0 as the field name. Specify IMG$0 to retrieve emphasis constant field attributes

204 Definition Routines (D$DEF) COBOL FORTRAN C Use DPS-ATTR-TABLE AT$TBL dps_attr_table For output: Specifies the table where attributes and individual attribute values are returned. For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For output: Only requested attributes are retrieved in DPS-ATTR-TABLE (R option). Contains all character attribute values D$DEFFRMRET Function Use the D$DEFFRMRET function to retrieve form-level attributes for the temporary form. Calling Sequence COBOL: CALL D$DEFFRMGRET USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: C: CALL DDFRMR (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF) d_deffrmret (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff);

205 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRA N C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: A Returns all image attribute values. D R Returns values different from defaults Returns only attribute values only Requested values pass as input in DPS-ATTR-TABLE. DPS-NAMES DN$TBL COBOL dps_names FORTRAN For input: Specifies the table containing the form library name, form name, and image name. Specify 0 for the form number. If the form library name is omitted, DPS 2200 assumes the first configured form library. COBOL DPS-ATTR-TABLE AT$TBL dps_attr_table For output: Specifies the table where attributes and individual attribute values are returned. For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For output: D$DEFIMGRET Function Only requested attributes are retrieved in DPS-ATTR-TABLE (R option). Contains all character attribute values. Use the D$DEFIMGRET function to retrieve image-level attributes for repeat, ON/OFF, and linked ON/OFF images in a temporary form. Calling Sequence COBOL: CALL D$DEFIMGRET USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. FORTRAN: CALL DDIMGR (DS$STA, DO$OPT, DN$TBL, AT$TBL, AT$BUF)

206 Definition Routines (D$DEF) C: d_defimgret (&dps_status, &dps_options, &dps_names, &dps_attr_table, &dps_attr_buff); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRA N C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: A D Returns all image attribute values. Returns values different from defaults DPS-NAMES DN$TBL dps_names For input: DPS-ATTR-TABLE AT$TBL dps_attr_table For output: R Returns only attribute values only Requested values pass as input in DPS-ATTR-TABLE. Specifies the table containing the form library name, form name, and image name. Specify 0 for the form number. Specifies the table where attributes and individual attribute values are returned. For input: DPS-ATTR-BUFF AT$BUF dps_attr_buff For output: D$DEFNAMRET Function Only requested attributes are retrieved in DPS-ATTR-TABLE (R option). Contains all character attribute values. Use the D$DEFNAMRET function to retrieve image names (including fields) within a temporary form. Note that DPS 2200 uses an internal name for unnamed images. Unnamed images include repeats, linked ON/OFF images, system-supplied fields, text constants, and emphasis constants. The format is the string IMG$ followed by a number. The number is an integer that identifies the unnamed image. This lets you retrieve an unnamed image and modify it if necessary. IMG$0 refers to the constant text in the form. IMG$1 is the first unnamed image of the field, IMG$2 is the second, and so on. If you insert a new unnamed image between IMG$1 and IMG$2, then IMG$2 becomes IMG$3, and the new image becomes IMG$2. IMG$E0 refers to the emphasis-constant text of the form

207 Definition Routines (D$DEF) Calling Sequence COBOL: CALL D$DEFNAMRET USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-NAME-TABLE. FORTRAN: C: CALL DDNAMR (DS$STA, DO$OPT, DN$TBL, NT$TBL) d_defnamret (&dps_status, &dps_options, &dps_names, &dps_name_table); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: S L Returns entities on the same level as the entity specified in the DPS-NAMES parameter. Returns all entities subordinate to the entity specified in the DPS-NAMES parameter. For example, if a form name is specified, all entities are returned

208 Definition Routines (D$DEF) COBOL FORTRAN C Use DPS-NAMES DN$TBL dps_names For input: Specifies the table containing the form library name, form name, form number, and all images applicable to DPS- OPTIONS. The values of DPS-NAMES can be set as follows: FORM-NUMBER This must be set to 0. IMAGE-COUNT If this is set to 0, 1, or any value greater than 12, all fields and images corresponding to level 0 will be returned in the DPS-NAME-TABLE parameter. This is done regardless of the values set in the IMAGE-NAME array. If this is set to a value between 2 and 12, the corresponding IMAGE-NAME will be used as the search name to determine which level to return in the DPS-NAME-TABLE parameter. IMAGE-NAME(1) This can only be set to the form name or spaces. Any other value will result in an error. IMAGE-NAME(2) through IMAGE- NAME(12) These parameters may be set to a valid field or image name of the current form. If the value in IMAGE-COUNT corresponds to the subfield of IMAGE-NAME, this value will be used as the search name to determine which level to return in the DPS-NAME-TABLE parameter. If the search name used does not exist, an error will be returned

209 Definition Routines (D$DEF) COBOL FORTRAN C Use DPS-NAME-TABLE NT$TBL dps_name_table For output: 6.6. D$DEF Deleting Routines Specifies the table for receiving the names of the form entities. It contains the following repeated group of three entries: 1. Level indicator 00 = form definition 01 = next definition 02 = nested entities other numbers = additional nested entries 2. Type of entitiy name. 0 = FORM 1 = IMAGE or subordinate IMAGE 2 = FIELD 3. Entity name (30 ASCII characters) The following subtype values are returned for each entity: 1 = I/O field 2 = OO field 3 = System-supplied field 4 = ON/OFF image 6 = Horizontal repeat image 7=Vertical repeat image The D$DEF deleting routines delete images or fields from a temporary form. They also delete the temporary form itself. Use the following functions to delete images and fields: D$DEFFLDDEL D$DEFFRMDEL D$DEFIMGDEL D$DEFFLDDEL Function Use the D$DEFFLDDEL function to delete a text constant, emphasis-constant, system-supplied, I/O, or OO field from a temporary form. You can delete constant text by using the D$DEFFLDCRE or D$DEFFLDMOD functions to overlap the text with blanks. If you specify IMG$0 as the field name in DPS-NAMES, then the entire base form is replaced with blanks. If you specify IMG$E0, the emphasis buffer is replaced with ASCII 0's, meaning no emphasis

210 Definition Routines (D$DEF) Calling Sequence COBOL: CALL D$DEFFLDDEL USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDFLDD (DS$STA, DO$OPT, DN$TBL) d_defflddel (&dps_status, &dps_options, &dps_names); where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input, table contains form library name, form name, form number, and name of field to delete. Specify 0 for the form number D$DEFFRMDEL Function Use the D$DEFFRMDEL function to delete a temporary form. When you do not plan to save the temporary form, you must delete it before you create or load another form. In addition, D$DEFFRMDEL frees all dynamic storage. Note that when you delete a form, all images and fields within the form are deleted. Calling Sequence COBOL: CALL D$DEFFRMDEL USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDFRMD (DS$STA, DO$OPT, DN$TBL) d_deffrmdel (&dps_status, &dps_options, &dps_names);

211 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input, table contains form library name, form name, and form number. If the form library name is omitted, DPS 2200 assumes the first configured form library. Specify 0 for the form number D$DEFIMGDEL Function Use the D$DEFIMGDEL function to delete a repeat image, ON/OFF image, or linked ON/OFF image from a temporary form. When you delete an image, all subordinate images and fields are unaffected. Calling Sequence COBOL: CALL D$DEFIMGDEL USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDIMGD (DS$STA, DO$OPT, DN$TBL) d_defimgdel (&dps_status, &dps_options, &dps_names); where the COBOL, FORTRAN, and C parameters and their use are as shown. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input, table contains form library name, form name, form number, and name of image to delete. Specify 0 for the form number

212 Definition Routines (D$DEF) 6.7. D$DEF Form Library Access Routines The D$DEF form library access routines Save temporary forms Load a previously defined form from the form library or omnibus file Delete forms from the form library If the repository is configured, the actions performed in the form library are also performed in the repository. You must assign form numbers greater than zero when using these functions. Use the following functions to access a form library: D$DEFERASE D$DEFLOAD D$DEFSAVE Use the following functions to access the repository: D$DEFERASE D$DEFSAVE Notes: If the repository is configured, the D$DEFSAVE and D$DEFERASE functions cannot be used in TIP transactions that use TIP memory. Only one D$DEFSAVE or D$DEFERASE function should be called without committing the changes to TIP if all of the following conditions are true: If Variable Length Records is configured The current form library is a variable length record form library Its index file is reserved as recoverable

213 Definition Routines (D$DEF) D$DEF File Access Authorities The user-id for each DPS 2200 user has file access authorities defined using the User-id/Password processor (DPSPW) (see the DPS 2200 Administration Guide). These authorities determine which D$DEF form library access routines can be called. The following table shows the D$DEF access routines and the authority required to execute the routine. Function D$DEFSAVE D$DEFSAVE D$DEFERASE D$DEFLOAD Authority INSERT UPDATE DELETE DISPLAY D$DEFERASE Function Use the D$DEFERASE function to erase a form from a form library. This function uses the temporary form while erasing the identified form in the form library. Therefore, you must either delete (D$DEFFRMDEL) or save (D$DEFSAVE) the temporary form before calling D$DEFERASE. If you do not do this, you will get a fatal error returned in DPS-STATUS. The fatal error protects you from accidentally destroying a temporary form. This action is also performed in the repository, if it is configured. Note: This function is not valid with omnibus files. Calling Sequence COBOL: CALL D$DEFERASE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDFERS (DS$STA, DO$OPT, DN$TBL) d_deferase (&dps_status, &dps_options, &dps_names);

214 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names Specifies the table containing the form library name, form name, and form number. The form number is required and must be greater than 0. If the form library name is omitted, DPS 2200 assumes the first configured form library D$DEFLOAD Function If the form name is not specified, use the default name FORM. Use the D$DEFLOAD function to load a form from the form library or omnibus file into a temporary form. You must have display authority to call D$DEFLOAD. If you have a temporary form initialized with D$DEFFRMCRE or another D$DEFLOAD, you must call D$DEFFRMDEL or D$DEFSAVE before calling D$DEFLOAD again. Calling Sequence COBOL: CALL D$DEFLOAD USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDLOAD (DS$STA, DO$OPT, DN$TBL) d_defload (&dps_status, &dps_options, &dps_names);

215 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, the N, O, and X options are supported. DPS-NAMES DN$TBL dps_names For input: N Loads the form without looking at the form name. The form name is returned in the DPS-NAMES table. O Loads the form from the omnibus file specified in DPS-NAMES. DIRECTORY-PATH -STR. If the form numbers do not match, DPS 2200 changes the form number of the omnibus element to the form number passed in the DPS-NAMES table. The default file name is TPF$. An element name must be specified. X Performs the same type of form conversion as the FLMU when loading a form from an om only with the O option Specifies the table containing the form library name, form name, and form number. The form number is required and must be greater than 0. If the form library name is omitted, DPS 2200 assumes the first configured form library. If the form name is not specified and the N option is not selected, the default name FORM is assumed. The O option reads the form from an omnibus program file. The file name is passed in the DIRECTORY-PATH-STR part of DPS-NAMES. If aname is not passed, the internal file name TPF$ is assumed. An element name must be specified

216 Definition Routines (D$DEF) D$DEFSAVE Function Use the D$DEFSAVE function to store temporary forms in a form library or omnibus file. You can also use it to save changes made to existing forms. You must have form insert authority to save a new form, and update authority to overwrite an existing form. This action is also performed in the repository, if it is configured and you save the form in a form library. If you save a form in an omnibus file, it is not saved in the repository. You may call this function at any time. It does not invalidate your temporary form, and you may call other D$DEF routines after this function. Calling Sequence COBOL: CALL D$DEFSAVE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDSAVE (DS$STA, DO$OPT, DN$TBL) d_defsave (&dps_status, &dps_options, &dps_names);

217 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, the O, T, U, and W options are supported. DPS-NAMES DN$TBL dps_names For input: O Saves the temporary form in the file named in DPS NAMES.DIRECTORY-PATH-STR. This is an omnibus file. This option is mutually exclusive with the T option. The default file name is TPF$. The default element name is the form number in DPS-NAMES.FORM-NUMBER. T U Overwrites an existing form. If the form does not exist, an error is returned. Do not create a new check number. Use only with the O option. W Saves the form. If a form already exists, an error is returned. Specifies the table containing the form library name, form name, and form number. If the form library name is omitted, DPS 2200 assumes the first configured form library. If the form name is not specified, the default name FORM is assumed. If the form number is not specified, the form number defaults to the next available form number. The O option writes the form to an omnibus program file. The file name is passed in the DIRECTORY-PATH-STR part of DPS-NAMES. If a name is not passed, the internal file name TPF$.fn is assumed where fn is the form number

218 Definition Routines (D$DEF) 6.8. Miscellaneous Routines The D$DEFPRINT and D$DEFGENWS functions do not fit into any of the other subsections so they are described separately D$DEFPRINT Function The D$DEFPRINT function prints a temporary form. The syntax in the listing is compatible with the FORMGEN processor. This function writes output to an SDF element, SDF file, or PRINT$. If the output file is PRINT$ (no file specified), you must be in line-at-a-time mode. (See the explanation of the D$LINIT1 function in the DPS 2200 Run-Time Programming Reference Manual) Calling Sequence COBOL: CALL D$DEFPRINT USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. FORTRAN: C: CALL DDPRNT (DS$STA, DO$OPT, DN$TBL) d_defprint (&dps_status, &dps_options, &dps_names);

219 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown in the following table. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input: DPS-NAMES DN$TBL dps_names For input: Forces DPS 2200 to use DPS-NAMES.DIRECTORY-PATH-STR as the name of the output file where the data is written. Specifies the table containing the form library name, form name, form number, and the name of the file to write the output to: DIRECTORY-PATH(2) = qualifier name DIRECTORY-PATH(3) = file name DIRECTORY-PATH(4) = element name DIRECTORY-PATH(5) = version name These names can be used unless you specify the Q option. If the file name is specified but the element name and version name are blank, output is written to an SDF data file. If the SDF file already exists, it is cycled. If it does not exist, it is cataloged. If the element name is specified, the file corresponding to file name must already exist. If the file name and the element name are both blank, output is to PRINT$. If the Q option is used, DPS-NAMES.DIRECTORY-PATH-STR contains a file name that can be any legal form of qual*file/read/write.element/version

220 Definition Routines (D$DEF) D$DEFGENWS Function The D$DEFGENWS function generates working storage for a temporary form. This function can also output working storage as an element in the file specified in DPS-NAMES.DIRECTORY-PATH-STR. The default output file is TPF$.SCREEN #version, where # is the current form number and version is the language type (COBP=COBOL, FTNP=FORTRAN, and H=C). If DPS 2200 is configured to use the repository, you can specify in the GENERATE-WS-PKT that you want the working storage generated for a form saved in the repository. Notes: If the repository is configured, the D$DEFGENWS function cannot be used in TIP transactions that use TIP memory. Only UCS COBOL and UCS C working storage can be stored in the repository. Calling Sequence COBOL: CALL D$DEFGENWS USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, GENERATE-WS-PKT. FORTRAN: C: CALL DGENWS (DS$STA, DO$OPT, DN$TBL, GN$BUF) d_defgenws (&dps_status, &dps_options, &dps_names, &generate_ws_pkt);

221 Definition Routines (D$DEF) where the COBOL, FORTRAN, and C parameters and their use are as shown. COBOL FORTRAN C Use DPS-STATUS DS$STA dps_status For output. DPS-OPTIONS DO$OPT dps_options For input, no options are supported. DPS-NAMES DN$TBL dps_names For input: GENERATE-WS-PKT GN$BUF generate_ws_pkt For input: Specifies the table containing the form library name, form name, form number, and the name of the file in which to write the output. The name of the output file is specified in DPS-NAMES.DIRECTORY-PATH- STR and can be any legal form of qual*file/read/write.element/version. If blanks are passed in DIRECTORY-PATH-STR, the default output file TPF.SCREEN#/version (where # is the current form number and version is language type COBP=COBOL or FTNP=FORTRAN) is assumed. If the specified output file does not exist, it is cataloged. If a qualifier is not specified, normal Exec rules apply. The data structure contains the language type, prefix generation, initial value generation, redefinition option, and storage type. The default values are: Language = ASCII COBOL, Output Type = File, Prefix = Prefix defined during definition, Initial Values = Yes, Redefinition = No, and Storage = Defaults to compiler default

222 Definition Routines (D$DEF)

223 Appendix A FORMGEN Messages This appendix lists the acknowledge, information, and error messages generated by FORMGEN. The messages are in alphabetical order in each group. A brief explanation and recovery action follows each message. A.1. Acknowledge Messages That Apply to All Functions *** DUMPS CREATED IN FILES: DPSABORT AND DPS$FDPABORT *** You entered function key 11 or you are running FORMGEN using the trace option (T). FORMGEN created dumps in the specified data files. FKEYS: 1=MAIN 2=REFRESH 3=UNDO AUTO 4=WALKTHRU 5=EXIT 6=OMIT 7=HELP The following is the list of available function keys that may be used anywhere in FORMGEN, even in layout or initial values where this message does not appear. 1. Return to the main menu. 2. Refresh the current menu or template (layout). 3. Revert your workspace to its state before you made the changes. 4. Enter walk-through mode, or move to the next function if already in walk-through mode. 5. Exit FORMGEN and save or replace the current form. 6. Exit FORMGEN and do not save or replace the current form. 7. Request select function help. *** FUNCTION IN PROGRESS PLEASE WAIT *** This message is displayed when the function or command you entered takes a noticeable amount of time. The real response message is displayed when the function is complete. *** FUNCTION OMITTED LAST UPDATE NOT PERFORMED *** You exited a function using function key 1. There was an outstanding error in the function from which you exited, so FORMGEN has exited the function without performing the last update A 1

224 FORMGEN Messages *** <form name/form number> REVERTED TO PREVIOUS UPDATE *** You entered function key 3. Your form reverted to the state it was in during the most recent auto save. A.2. Error Messages That Apply to All Functions *** ERROR: READ OF MENU DETECTED ERROR REFRESH PERFORMED *** DPS 2200 detected an error while attempting to read your form or a FORMGEN menu. FORMGEN refreshed, or redisplayed, the entire form. *** ERROR: NO PREVIOUS UPDATE AVAILABLE UNDO NOT PERFORMED *** You entered function key 3 and no updates have been made to the form in your workspace. A form cannot be reverted back past the last NEW or OLD command. *** ERROR: UNKNOWN FUNCTION KEY ENTER VALUES 1-7 OR 11 *** You pressed an invalid function key. The refresh function key (2) normally gives the list of available function keys and the functions they perform. *** ERROR: USER S SECURITY DOES NOT ALLOW DISPLAY OF FORM *** One of the FORMGEN menus has its security level or security type set such that you are not allowed to open and display the menu. *** ERROR: WALK-THROUGH MODE MAY BE ENTERED ONLY FROM THE MAIN MENU *** You entered function key 4 from some menu other than the main menu. Walk-through mode can be entered only from the main menu. You may have been in walk-through mode, but entered a function in the function field which took you out of walk-through mode. The only function which does not exit walk-through is execute (X). A.3. Termination Acknowledge Messages *** FORMGEN PROCESSOR TERMINATED FORM NOT REPLACED ( A OPTION AVAILABLE) *** You terminated FORMGEN using the omit function or function key 6. You had a form in your workspace from a previous NEW or OLD command which was not saved. If you wish to recover this form, reenter FORMGEN with the A option. *** FORMGEN PROCESSOR TERMINATED <form name/form number> SAVED OR REPLACED *** You terminated FORMGEN using the exit function or function key 5. The form that was in your workspace was saved or replaced in the specified form library or omnibus program file. A

225 FORMGEN Messages *** FORM DEFINITION PROCESSOR TERMINATED WORKSPACE WAS EMPTY *** You terminated FORMGEN with exit, omit, function key 5 or function key 6. The WORKSPACE WAS EMPTY message tells you that you did not have a form in your workspace when you terminated. A.4. Termination Error Messages *** ERROR: EXECUTION ENVIRONMENT PROHIBITS USE OF FULL-SCREEN MODE *** You called the FORMGEN processor from a batch run or from a demand run having a BREAKPOINTED print file. *** ERROR: I18N LIBRARY CALL RETURNED AN ERROR *** DPS 2200 detected an error during the call to one of the I18NLIB service routines. *** ERROR: ILLEGAL OPTION SPECIFIED FORMGEN TERMINATED *** You specified an option on the processor call line that is not a valid choice. *** ERROR: MENU FILE NOT: CATALOGUED, INITIALIZED OR TIPREGED *** FORMGEN cannot be entered because one of the following errors occurred on the FORMGEN menu file (FISENG): The file has not been cataloged. The file has not been initialized with DPSIF. The file has not been registered with TIP. This may be an installation or build problem. *** ERROR: MENU LIBRARY CANNOT BE ASSIGNED *** The FORMGEN menu library (FISENG) cannot be assigned because a user may have it exclusively assigned to their run or the file may be unloaded. FORMGEN cannot be entered. *** ERROR: INCORRECT DEVICE TYPE DESIGNATION *** DPS 2200 detected invalid input for your terminal type. For example, you are on a UTS 400 terminal with the FCC/protect switch set to protect. *** ERROR: MENU LIBRARY UNLOADED, NOT CATALOGUED OR BAD LANGUAGE *** You cannot enter FORMGEN because the menu library (FISENG) is not available. The file is either unloaded, assigned exclusively to another run, or not cataloged. BAD LANGUAGE indicates that you specified a value in the second subfield of the processor call line, and that value was not ENG A 3

226 FORMGEN Messages *** ERROR: PASSWORD FILE NOT AVAILABLE UNLOADED OR NOT CATALOGUED *** DPS 2200 returned an error during initialization that indicated your password file is not loaded, assigned exclusively to another run, or is not cataloged. *** ERROR: PASSWORD FILE NOT: CATALOGUED, INITIALIZED OR TIP REGISTERED *** DPS 2200 returned an error during initialization, indicating that one of the following errors occurred while reading your password file: The file has not been cataloged. The file has not been initialized by DPSIF. The file has not been registered with TIP. *** ERROR: UNKNOWN DEVICE TYPE ENTERED FORMGEN TERMINATED *** You attempted to execute FORMGEN and have entered a value in the processor call line terminal type field. This value is not one of the supported DPS 2200 terminal types. A.5. Help Error Messages *** ERROR: UNKNOWN HELP FUNCTION ENTER E, N, P, R, +n, -n *** You entered a help function that is not one of the valid choices. *** NO MORE LEVELS OF HELP AVAILABLE *** You are at the last or most detailed level of help and there are no more levels of help available for this field. *** NO MORE PAGES AVAILABLE *** You are at the last page of the current level of help and there are no more pages available for this level. The top, right corner of the page indicates when there are no more pages and/or levels of help available. *** RELATIVE PAGE NUMBER ENTERED IS TOO LARGE *** You entered either the +n or -n function, where n is the number of pages to go forward or backward, but the number is greater than the number of available pages. *** YOU ARE AT THE FIRST LEVEL OF HELP *** You entered the P help function to go to the previous level of help, but you are already at the first or most general level of help. If you want to exit help, use the E or R help function. A

227 FORMGEN Messages *** YOU ARE AT THE FIRST PAGE OF HELP *** You entered the -n command, where n is the number of pages, but you are already at the first page of the current level of help. A.6. Image/Field Attributes (A) Acknowledge Message *** IMAGE AND FIELD ATTRIBUTES UPDATED *** You performed a successful update in the image/field attributes function (A). A.7. Image/Field Attributes (A) Error Messages *** ERROR: ALLOW QUERY NOT ALLOWED IN OUTPUT-ONLY FIELD *** You cannot define the allow query attribute for an output-only field. *** ERROR: AN ATTRIBUTE VALUE MUST BE SPECIFIED SEE HELP *** You specified a valid attribute identifier (for example, FC), and entered the equal sign, but have not specified a value. *** ERROR: BACK-TO-BACK FIELDS SPECIFIED *** This error can happen if the length of a system-supplied field is modified by FORMGEN to make it the true length. *** ERROR: BAD ATTRIBUTE LENGTH *** You specified more than one character for a replenish character (REP or RFB attribute). *** ERROR: CANNOT DEFAULT REF ATTRIBUTE. NO PREVIOUS ON/OFF TO LINK TO *** You entered the value L for the image type (linked), but did not specify a reference name using the REF attribute. FORMGEN tried to default the reference name to the last nonlinked ON/OFF image, but there are no such images in the form. *** ERROR: CHANGING A FIELD TO IMAGE IS NOT ALLOWED *** You specified an O or L image type for a field (type A, B, C, I, N, R, S, X). This is not allowed. *** ERROR: CHANGING AN IMAGE TO A FIELD IS NOT ALLOWED *** You specified a field type (A, B, C, I, N, R, S, X) for an O or L type ON/OFF image. This is not allowed A 5

228 FORMGEN Messages *** ERROR: DUPLICATE ATTRIBUTE VALUES SPECIFIED FOR *** You attempted to specify an attribute value more than once for the field that is blinking. *** ERROR: DUPLICATE ERROR HEADER SPECIFIED *** You specified the error header (ERHD) system-supplied field type for more than one field. *** ERROR: DUPLICATE ERROR LINE SPECIFIED *** You specified the error line (ERRL) system-supplied field type for more than one field. *** ERROR: DUPLICATE HEADER LINE SPECIFIED *** You specified the header line (HDRL) system-supplied field type for more than one field. *** ERROR: DUPLICATE IMAGE/FIELD OR INDEX NAME SPECIFIED *** You specified an image, field or index name that has already been defined somewhere in the form. This does not include the form name. *** ERROR: DUPLICATE OR MUTUALLY-EXCLUSIVE ATTRIBUTES SEE HELP *** You specified the same attribute more than once, or you specified two attributes that are mutually exclusive. *** ERROR: ERROR LINE IS EXCLUSIVE OF ERROR HEADER *** You specified both ERRL and ERHD system-supplied fields. These values are mutually-exclusive. *** ERROR: FIELD CANNOT SPAN LINES INSIDE REPEAT *** A repeat cannot contain an image or field spanning lines, unless that image or field is completely contained within the first occurrence. *** ERROR: FIELD LENGTH EXCEEDS MAXIMUM ALLOWED FOR TYPE *** The size of the field exceeds the maximum allowable length for the specified field type. Help contains a list of field types and their maximum sizes. *** ERROR: FORM HAS NO FIELDS IMAGE ATTRIBUTES FUNCTION NOT ALLOWED*** You entered the image/field attributes function (A), but the form does not contain any images or fields. There are no attributes to update, so FORMGEN will not allow you to enter this function. A

229 FORMGEN Messages *** ERROR: HEADER LINE IS EXCLUSIVE OF ERROR HEADER *** You specified both an HDRL and ERHD system-supplied field. These values are mutually exclusive. *** ERROR: HIGHLIGHT CORRECTION IS ILLEGAL AT THIS LEVEL ENTER B OR R *** You entered the value C in the highlight field of the form-level attributes menu (F) or for an image. This choice is valid only for fields. ***ERROR: ILLEGAL ACTION TYPE -- VALID ENTRIES ARE C, D, OR L *** You must specify C, D, or L as the action. *** ERROR: ILLEGAL ATTRIBUTE FOR FIELD TYPE SPECIFIED *** You specified an attribute for the blinking field that is not valid for the image or field type. *** ERROR: ILLEGAL ATTRIBUTE SPECIFIED FOR FIELD TYPE *** You specified an attribute for the blinking field that is not valid for the field type. *** ERROR: ILLEGAL ATTRIBUTE SPECIFIED FOR IMAGE TYPE *** You specified an attribute for the blinking field that is not valid for the image type. *** ERROR: ILLEGAL COMBINATION OF HI, MOD, PRO SPECIFY HI=C, MOD=Y, PRO=N *** The PRO, CON, MOD and HI=C attributes specify the dynamic character in working-storage. You specified an unsupported combination of these values. Refer to help for a conversion table from these attributes into the dynamic character. *** ERROR: IMAGE LINKED TO MUST BE AN ON/OFF IMAGE *** You specified a value for the REF (reference name) attribute that is the name of something other than a nonlinked ON/OFF image. You can only link ON/OFF images to nonlinked ON/OFF images. *** ERROR: IMAGE OR FIELD NAME SPECIFIED BUT NOT ALLOWED *** You specified a value in the image name field for either a system-supplied field or a linked ON/OFF image. The image or field does not have a name. *** ERROR: IMAGE OR FIELD NAME SPECIFIED BUT NOT ALLOWED *** You specified an image/field name for a system-supplied field or a linked ON/OFF image. Leave the image/field-name field blank for these types A 7

230 FORMGEN Messages *** ERROR: IMAGE OR FIELD OVERLAPS ANOTHER IMAGE OR FIELD *** You attempted to overlay one field or image over another field or image. *** ERROR: INVALID CHARACTER SPECIFIED IN IMAGE/FIELD OR INDEX NAME *** You specified an illegal character in an image, field or index name. Legal characters are A through Z, 0 through 9, and hyphen. *** ERROR: INVALID COMBINATION OF PRO, MOD OR CON ATTRIBUTE VALUES *** The PRO, CON, MOD and HI=C attributes specify the dynamic character in working storage. You specified an unsupported combination of these values. Refer to help for a conversion table from these attributes into the dynamic character. *** ERROR: INVALID REPLENISH CHARACTER SPECIFIED *** You specified an illegal value for a replenish character. This character cannot be A through Z, 0 through 9, or a masterspace (@). ***ERROR: INVALID VC VALUE--ENTER N OR R*** You attempted to set VC to a value other than N or R for a numeric field. *** ERROR: INVALID VC VALUE --ENTER N OR T*** You have attempted to set the VC attribute to a value other than N or T on an alphabetic or an alphanumeric field. *** ERROR: MAXIMUM FIELD WIDTH CANNOT BE GREATER THAN 1920 *** The maximum field width (MWID) attribute value must be an integer in the range of the field length (number of characters in the template) and 1920 (MAXLINES times MAXCOLUMNS). *** ERROR: MAXIMUM FIELD WIDTH LESS THAN INITIAL WIDTH *** The maximum field width (MWID) attribute value must be an integer in the range of the field length (number of characters in the template) and 1920 (MAXLINES times MAXCOLUMNS). DPS 2200 returns this error if the value is zero or negative. *** ERROR: MAXIMUM WIDTH ATTRIBUTE IS ILLEGAL FOR FIXED WIDTH FIELD *** You specified the MWID attribute, but have not specified the vertical width (VWID) attribute for the field. A

231 FORMGEN Messages *** ERROR: MISMATCHED PARENTHESIS ENTERED SEE HELP *** You do not have the same number of opening parentheses as closing ones. If you want to use a parenthesis as a replenish string, add quotes around the character. *** ERROR: MISMATCHED QUOTES ENTERED SEE HELP *** You have more opening quotation marks than closing quotation marks in a string. If you want to use a quotation mark within a string, you must have two quotation marks for every quotation mark that you want to define. In this case, you must also place quotation marks around the string itself. *** ERROR: MORE THAN 18 DIGITS AFTER DECIMAL SPECIFIED *** The maximum number of digits before or after the decimal point is 18. With attributes, the total size of the field cannot exceed 26. *** ERROR: MORE THAN 18 DIGITS SPECIFIED BEFORE DECIMAL POINT *** A field has more than 18 digits before its decimal point. The maximum number of places for a field is 26 with attributes, but there can be only 18 digits on either side of the decimal point. *** ERROR: MUTUALLY-EXCLUSIVE ATTRIBUTES SPECIFIED *** You specified two attributes that are mutually exclusive for the blinking field. *** ERROR: N, C, I OR R TYPE FIELD SIZE < 1 WITH ATTRIBUTES *** The resulting size of your numeric, computational, integer or real field will be less than one with attributes you specified (for example, CR, DB, DEL, V). *** ERROR: NUMERIC FIELD SIZE MUST BE LESS THAN 26 *** The maximum number of digits before or after the decimal point is 18. With attributes, the total size of the field cannot exceed 26. To get 26, use V=17, CR, or DB and LMS. *** ERROR: ON/OFF IMAGE MUST BE VARIABLE POSITION *** You specified the FPOS attribute for an ON/OFF image. DPS 2200 does not support this. *** ERROR: REP AND RFB ARE MUTUALLY-EXCLUSIVE ATTRIBUTES *** You specified both the REP (replenish) and RFB (replenish-for-blanks) attributes. These attributes are mutually exclusive A 9

232 FORMGEN Messages *** ERROR: REPLENISH ALREADY USED AS DECIMAL POINT OR COMMA SYMBOL *** The character you specified for the decimal point or thousands delimiter is already used as a replenish character, or vice-versa. *** ERROR: REPLENISH CHARACTER NOT ALLOWED FOR PROTECTED FIELDS *** You specified a replenish character for either a binary or an output-only (OO) field. *** ERROR: RIGHT JUSTIFY INVALID FOR SPANNING LINES *** You specified the RJ attribute for a field that spans line boundaries. DPS 2200 does not support this. *** ERROR: SDP DA ATTRIBUTE IS SECF=PD IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP DISP IS FI,HI,FC,BC,EMP,FONT,PRO,CON,MOD ATTRIBUTES *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP IC ATTRIBUTE IS REP= "character" IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP ICFB ATTRIBUTE IS RFB="character" IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP ICN ATTRIBUTE IS REPN IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP IV ATTRIBUTE IS V FUNCTION IN FORMGEN *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. A

233 FORMGEN Messages *** ERROR: SDP LC ATTRIBUTE IS EC IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP LZS ATTRIBUTE IS LZD IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP NTAB ATTRIBUTE IS TAB=N FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP SNA SYSTEM-SUPPLIED VALUE IS FNA IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP SNB SYSTEM-SUPPLIED VALUE IS FNB IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP SSL SYSTEM-SUPPLIED VALUE IS FSL IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SDP Vnumber ATTRIBUTE IS V=number IN FORMGEN SYNTAX *** FORMGEN recognized an attribute that is specified correctly for the SCREEN DEFINITION PROCESSOR (SDP), but whose syntax is different in FORMGEN. FORMGEN provides the correct syntax. *** ERROR: SYSTEM SUPPLIED FIELDS MUST BE VARIABLE POSITION *** You specified the FPOS attribute for a system-supplied field. DPS 2200 only supports the VPOS attribute for these fields. *** ERROR: TAB STOP NOT ALLOWED IN OUTPUT-ONLY FIELD *** You specified the TAB attribute, but the field contains the OO attribute A 11

234 FORMGEN Messages *** ERROR: TOO MANY DIGITS SPECIFIED IN DECIMAL SCALE *** You specified more than 18 digits in the decimal scale (V) attribute. *** ERROR: UNKNOWN ALLOW QUERY VALUE ENTER Y OR N *** You entered a value for the allow query value that is not a valid choice. *** ERROR: UNKNOWN BACKGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value for the BC attribute that is not a valid choice. *** ERROR: UNKNOWN BLANK-FOR-ZERO VALUE ENTER Y OR N *** You entered a value for the BZ attribute that is not a valid choice. *** ERROR: UNKNOWN BLANK INPUT VALUE ENTER BLNK OR NIB *** You entered a value for a blank input attribute that is not a valid choice for A or X type fields (alternate attributes menu). *** ERROR: UNKNOWN BLANK INPUT VALUE ENTER NIB OR ZB *** You entered a value for a blank input attribute that is not a valid choice for C, I, N, or R type fields (alternate attributes menu). *** ERROR: UNKNOWN BLANK INPUT VALUE ENTER Y OR N *** You entered a value for the ZB, BLNK, or NIB attribute that is not a valid choice (main attributes menu). *** ERROR: UNKNOWN CHARACTER CASE VALUE ENTER EC OR UC *** You entered a value for a character case attribute that is not a valid choice (alternate attributes menu). *** ERROR: UNKNOWN CHARACTER CASE VALUE (UC OR EC) ENTER Y OR N *** You entered a value for a character case attribute that is not a valid choice (main attributes menu). *** ERROR: UNKNOWN DATA ENTRY VALUE ENTER Y OR N *** You entered a value for the F attribute that is not a valid choice. *** ERROR: UNKNOWN EMPHASIS VALUE ENTER N,L,S,U OR COMBINATION *** You entered a value for the EMP attribute that is not a valid choice. A

235 FORMGEN Messages *** ERROR: UNKNOWN EXPONENTIAL VALUE SPECIFICATION ENTER Y OR N *** You entered a value for the exponential value attribute that is not a valid choice. *** ERROR: UNKNOWN FIELD TYPE ENTER A, B, C, D, I, N, R, S, X *** You entered a value in the field type field of the image/field menu that is not a valid choice. *** ERROR: UNKNOWN FONT OR CHARACTER SET VALUE ENTER N OR 1 *** You entered a value for the FONT attribute that is not a valid choice. *** ERROR: UNKNOWN FOREGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value for the FC attribute that is not a valid choice. *** ERROR: UNKNOWN FOREGROUND INTENSITY VALUE ENTER N,H,L OR S *** You entered a value for the FINT attribute that is not a valid choice. *** ERROR: UNKNOWN HIGHLIGHT VALUE ENTER N,B,C OR COMBINATION *** You entered a value for the highlight (HI) attribute that is not a valid choice. *** ERROR: UNKNOWN HIGHLIGHT VALUE ENTER N,B,C,R OR COMBINATION *** You entered a value for the highlight (HI) attribute that is not a valid choice. *** ERROR: UNKNOWN IMAGE TYPE ENTER O OR L *** You entered a value in the field-type field of the image/field attributes that is not a valid choice for an ON/OFF image. *** ERROR: UNKNOWN INSERT DELIMITERS VALUE ENTER Y OR N *** You entered a value for the DEL attribute that is not a valid choice. *** ERROR: UNKNOWN JUSTIFICATION VALUE ENTER CJ, LJ, NJ OR RJ *** You entered a value for a justification attribute that is not a valid choice (main attributes menu). *** ERROR: UNKNOWN JUSTIFICATION VALUE (NJ, LJ, RJ OR CJ) ENTER Y OR N *** You entered a value for one of the justification attributes that is not a valid choice (alternate attributes menu). *** ERROR: UNKNOWN LEADING ZEROES VALUE ENTER Y OR N *** You entered a value for the LZD attribute that is not a valid choice A 13

236 FORMGEN Messages *** ERROR: UNKNOWN MODIFICATION VALUE ENTER Y OR N *** You entered a value for the MOD attribute that is not a valid choice. *** ERROR: UNKNOWN MONETARY SIGN VALUE ENTER FMS, LMS OR NMS *** You entered a value for a monetary sign attribute that is not a valid choice (alternate attributes menu). *** ERROR: UNKNOWN MONETARY SIGN VALUE ENTER Y OR N *** You entered a value for one of the monetary sign attributes that is not a valid choice (NMS, FMS, LMS) (main attributes menu). *** ERROR: UNKNOWN NUMERIC SIGN VALUE ENTER NS,CR,DB,LS OR TS *** You entered a value for a numeric sign attribute that is not a valid choice (alternate attributes menu). *** ERROR: UNKNOWN NUMERIC SIGN VALUE ENTER Y OR N *** You entered a value for one of the numeric sign attributes that is not a valid choice (NS, CR, DB, LS, TS) (main attributes menu). *** ERROR: UNKNOWN OUTPUT CONTENTS VALUE ENTER S, B OR R *** You entered a value for the CON attribute that is not a valid choice. *** ERROR: UNKNOWN PROTECTION VALUE ENTER Y OR N *** You entered a value for the PRO attribute that is not a valid choice. *** ERROR: UNKNOWN RADIX VALUE ENTER DEC OR OCT *** You entered a value for a radix attribute that is not a valid choice (alternate attributes menu). *** ERROR: UNKNOWN RADIX VALUE (DEC OR OCT) ENTER Y OR N *** You entered a value for one of the radix attributes that is not a valid choice (Y or N) (main attributes menu). *** ERROR: UNKNOWN REPLENISH NOTIFICATION VALUE ENTER Y OR N *** You entered a value for the REPN attribute that is not a valid choice. *** ERROR: UNKNOWN SECURITY FAIL VALUE ENTER N, PB OR PD *** You entered a value for the SECF attribute that is not a valid choice. A

237 FORMGEN Messages *** ERROR: UNKNOWN SECURITY TYPE ENTER S OR H *** You entered a value for the SECT attribute that is not a valid choice. *** ERROR: UNKNOWN "SELECT" FUNCTION ENTER A,D,E,F,L,M,O,P,R,U,V,W,X *** You entered a value in the function field at the bottom of the menu that is not a valid choice. *** ERROR: UNKNOWN SYSTEM-SUPPLIED FIELD VALUE ENTER Y OR N *** You entered a value for a system-supplied field that is not a valid choice (main attributes menu). *** ERROR: UNKNOWN SYSTEM-SUPPLIED FIELD VALUE SEE HELP *** You entered a value for a system-supplied field that is not a valid choice. Help contains a list of all available choices (alternate attributes menu). *** ERROR: UNKNOWN SYSTEM-SUPPLIED FIELD VALUE SPECIFIED SEE HELP *** You specified an attribute for a system-supplied field that is not a valid choice. Help contains a list of all available choices. *** ERROR: UNKNOWN TAB VALUE ENTER Y OR N *** You entered a value for the TAB attribute that is not a valid choice. *** ERROR: UNKNOWN TEST DEPENDENT VALUE ENTER Y OR N *** You entered a value for the TDEP attribute that is not a valid choice. *** ERROR: UNKNOWN USAGE VALUE ENTER IO OR OO *** You entered a value for a usage attribute that is not a valid choice (alternate attributes menu). *** ERROR: UNKNOWN USAGE VALUE (IO OR OO) ENTER Y OR N *** You entered a value for one of the usage attributes that is not a valid choice (IO or OO) (main attributes menu). *** ERROR: UNKNOWN VALUE ENTERED FOR DISPLAY POSITIVE ENTER Y OR N *** You entered a value for the DPS 2200 attribute that is not a valid choice. *** ERROR: UNKNOWN VARIABLE POSITION VALUE ENTER VPOS OR FPOS *** You entered a value for a position attribute that is not a valid choice (alternate attributes menu) A 15

238 FORMGEN Messages *** ERROR: UNKNOWN VARIABLE-WIDTH VALUE ENTER Y OR N *** You entered a value for the VWID attribute that is not a valid choice. *** ERROR: VC NOT ALLOWED IN FIELD EXCEEDING 16 CHARACTERS *** You attempted to attach the VC attribute to a field with a width exceeding 16 characters. *** ERROR: VC NOT ALLOWED IN OUTPUT ONLY FIELD *** You attempted to attach the VC attribute to an output-only field. *** ERROR: VC ATTRIBUTE NOT ALLOWED FOR THIS FIELD TYPE *** You attempted to attach the VC attribute to a field that is not of type A, N, or X. *** ERROR: VC NOT ALLOWED ON FORM 0 *** You cannot define the VC attribute for FORM 0. *** ERROR: VC WILL NOT FUNCTION WITHOUT THE REPOSITORY *** You must configure the repository in order to set the VC attribute. *** ERROR: UNKNOWN VPOS OR FPOS POSITION VALUE ENTER Y OR N *** You entered a value for one of the position attributes that is not a valid choice (FPOS or VPOS) (main attributes menu). *** ERROR: VWID FIELDS CAUSE WORKING-STORAGE OVERFLOW *** You overflowed working storage for your form. You either defined too many fields, variable-width fields, or too many fields within repeats. *** ERROR: IS AN UNKNOWN ATTRIBUTE IDENTIFIER SEE HELP *** You entered a value in the image/field-level-attributes attribute field that is not a valid choice. Help for this field contains a complete list of available attributes. A.8. Form-Level Attributes (F) Acknowledge Message *** FORM-LEVEL ATTRIBUTES UPDATED *** You performed a successful update of the form-level attributes. A

239 FORMGEN Messages A.9. Form-Level Attributes (F) Error Messages *** ERROR: BAD ATTRIBUTE LENGTH *** You specified more than one character for one of the character attributes in menu 3 of the form-level attributes (F). *** ERROR: COMMA OR DECIMAL POINT SYMBOL ALREADY USED AS REPLENISH CHAR *** The character you specified for the decimal point or thousands delimiter edit symbol is already used as a replenish character. *** ERROR: DECIMAL POINT AND COMMA SYMBOLS MUST BE UNIQUE *** You specified the same character for the thousands delimiter (comma) and the decimal point edit symbol. *** ERROR: DUPLICATE ATTRIBUTE VALUES SPECIFIED FOR *** You attempted to specify an attribute value more than once for the field that is blinking. *** ERROR: FIELD NAME FOR FINAL CURSOR POSITION NOT FOUND *** The field name you specified for final cursor positioning does not exist in the form, or the name contains an illegal character. *** ERROR: FIELD SPECIFIED FOR CURSOR IS NOT AN I/O FIELD *** The name you specified for the final cursor position is not an input-output field. It may be an output only field or an ON/OFF image. *** ERROR: FORM HEIGHT OUT OF RANGE ENTER 1-24 *** You entered a value for form height that is not an integer in the range of 1 to 24 (max lines). *** ERROR: FORM SECURITY OUT OF RANGE ENTER 1-63 *** You entered a value for form security that is not an integer in the range from 1 to the maximum value configured for your DPS 2200 system. The default maximum is 63. This may be different for your system. *** ERROR: FUNCTION KEY OUT OF RANGE ENTER 1-36 *** You entered a value in the function key field of the form-level attributes menu that is not an integer in the range of 1 to A 17

240 FORMGEN Messages *** ERROR: HIGHLIGHT CORRECTION IS ILLEGAL AT THIS LEVEL ENTER B OR R *** You entered the value C in the highlight field of the form-level attributes menu (F) or for an image. This choice is valid only for fields. *** ERROR: ILLEGAL CURSOR NAME SPECIFIED *** You specified an illegal character in the final cursor position field. The name can contain A through Z, 0 through 9, or the hyphen. *** ERROR: ILLEGAL VALUE ENTERED FOR SOE CHARACTER *** You entered an illegal character for the SOE substitution character. This character cannot be a masterspace (@), A through Z, 0 through 9, or an underscore (_). *** ERROR: ILLEGAL VALUE FOR FORM HEIGHT OR REPEAT LINES PER OCCURRENCE *** You specified an out-of-range value for either the form height in form-level attributes, or for the number of lines per occurrence of a repeat. *** ERROR: INVALID CHARACTER MASTERSPACE OR DUPLICATE CHARACTER *** You specified a masterspace (@) character or duplicate character for one of the start image, stop image, field or alternate (second) field characters, start-of-entry (SOE) substitution, or edit symbol characters. *** ERROR: INVALID VALUE SPECIFIED FOR CCSNUM *** You entered a value for the I18N CCSNUM attribute that is not a valid choice. *** ERROR: NON-NUMERIC VALUE ENTERED *** You entered a value that is nonnumeric in the field or fields that are blinking. *** ERROR: REPLENISH ALREADY USED AS DECIMAL POINT OR COMMA SYMBOL *** The character you specified for a replenish character is already used as a decimal point or thousands delimiter edit symbol. *** ERROR: START IMAGE, STOP IMAGE AND FIELD CHARACTERS MUST BE UNIQUE *** You used the same character for one or more of the start (ON) image, stop (OFF) image, field, or second field characters. *** ERROR: UNKNOWN BACKGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value for the background color attribute that is not a valid choice. *** ERROR: UNKNOWN CHECK MODE VALUE ENTER Y OR N *** You entered a value for the check number test that is not a valid choice. A

241 FORMGEN Messages *** ERROR: UNKNOWN CONTROL CHARACTER SPECIFIED ENTER B OR N *** You entered a value for the control characters allowed attribute that is not a valid choice. *** ERROR: UNKNOWN CONVERSATION MODE VALUE ENTER Y OR N *** You entered a value for conversation mode that is not a valid choice. *** ERROR: UNKNOWN EMPHASIS VALUE ENTER N,L,S,U OR COMBINATION *** You entered a value for the emphasis attribute that is not a valid choice. *** ERROR: UNKNOWN FONT OR CHARACTER SET VALUE ENTER N OR 1 *** You entered a value for the FONT attribute that is not a valid choice. *** ERROR: UNKNOWN FOREGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value for the foreground color attribute that is not a valid choice. *** ERROR: UNKNOWN FOREGROUND INTENSITY VALUE ENTER N,H,L OR S *** You entered a value for the foreground intensity attribute that is not a valid choice. *** ERROR: UNKNOWN FUNCTION KEY VALUE ENTER 1-36, A OR N *** You entered a value in the function key field of form-level attributes that is not an integer in the range from 1 to 36, or a value of A (all) or N (none). *** ERROR: UNKNOWN GENERATE PREFIX VALUE ENTER Y OR N *** You entered a value for the prefix that is not a valid choice. *** ERROR: UNKNOWN HIGHLIGHT VALUE ENTER N,B,C,R OR COMBINATION *** You entered a value for the highlight attribute that is not a valid choice. *** ERROR: UNKNOWN SECURITY TYPE ENTER S OR H *** You entered a value for the security type attribute that is not a valid choice. *** ERROR: UNKNOWN "SELECT" FUNCTION ENTER A,D,E,F,L,M,O,P,R,U,V,W,X *** You entered a value in the function field at the bottom of the menu that is not a valid choice. *** ERROR: UNKNOWN TEST MODE VALUE ENTER Y OR N *** You entered a value for test mode that is not a valid choice A 19

242 FORMGEN Messages *** ERROR: +, -, A-Z and 1-9 ARE ILLEGAL VALUES FOR COMMA AND DECIMAL PT *** You specified one of the indicated characters for one of the thousands delimiter A.10. Layout (L) Acknowledge Messages *** ACCESSING THE REPOSITORY --PLEASE WAIT *** This message is displayed when you enter a marking command that accesses the repository, which may take some time. The message is removed when the function is complete. *** IMAGE AND FIELD LAYOUT UPDATED *** You performed a successful update of the image/field layout function (L). This message only appears once you have exited the layout function, so that it does not destroy your template. A.11. Layout (L) Error Messages *** ERROR: ATTACH ATTRIBUTES COMMAND NOT IN FIELD/IMAGE AT ROW=n COL=n *** You entered an ^ALn command to attach an attribute list to a field or image, but the marking character (^) is not in any field or image. *** ERROR: ATTEMPT TO CHANGE THE LENGTH OF SYSTEM FIELD ROW=n COL=n *** Except for NILL and user fields, all system-supplied fields have an internally defined fixed length. You attempted to add or delete characters for one of these fields. *** ERROR: BACK-TO-BACK FIELDS SPECIFIED ROW=n COL=n *** You placed a field character directly adjacent to an alternate (second) field character which would create back-to-back fields. Back-to-back fields may only be defined across line boundaries. *** ERROR: CANNOT DELETE ON/OFF IMAGE STILL LINKED TO *** You attempted to delete an image from the template that still has linked ON/OFF images linked to it. You must link these images to some other ON/OFF image first. *** ERROR: DPS IS NOT CONFIGURED TO USE THE REPOSITORY *** Your DPS 2200 system has not been configured to access the repository. A

243 FORMGEN Messages *** ERROR: FIELD CANNOT SPAN LINES INSIDE REPEAT ROW=n COL=n *** A repeat cannot contain a field spanning lines unless that image or field is completely contained within the first occurrence. *** ERROR: FIELD LENGTH EXCEEDS MAX ALLOWED FOR TYPE ROW=n COL=n *** The size of the field exceeds the maximum allowable length for the specified field type. Help contains a list of field types and their maximum sizes. *** ERROR: FIELD OVERLAPS HORIZONTAL REPEAT OCCURRENCE ROW=n COL=n *** You inserted a field into a template that does not fit entirely within the first horizontal repeat occurrence. *** ERROR: FIELD OVERLAPS MARKED AREA ROW=n COL=n *** You marked an area that does not completely contain a field. *** ERROR: IMAGE CANNOT SPAN LINES INSIDE REPEAT ROW=n COL=n *** A repeat cannot contain an image spanning lines unless that image is completely contained within the first occurrence. *** ERROR: INCOMPATIBLE MARKING COMMAND SPECIFIED ROW=n COL=n *** You entered a starting point command and ending point command that are incompatible. For example: ^MR and ^CE. *** ERROR: IMAGE OVERLAPS MARKED AREA ROW=n COL=n *** You marked an area that does not completely contain an ON/OFF image. *** ERROR: INVALID ATTACH ATTRIBUTES COMMAND AT ROW=n COL=n *** You entered an ^ALn command to attach an attribute list to a field or image, but n is not a digit from 1 to 5. The digit n specifies which menu slot of the repository interface attribute list menu to attach attributes from. *** ERROR: MARKED AREA CONTAINS MARKING CHARACTER AS TEXT ROW=n COL=n *** You attempted to insert a marked area containing a text character that is equal to the marking character. *** ERROR: MARKED AREA OVERLAPS FORM BOUNDS ROW=n COL=n *** You attempted to insert a marked area at a location causing part of the marked area to overlap the form bounds A 21

244 FORMGEN Messages *** ERROR: MARKED AREA START FOUND AFTER MARKED AREA END ROW=n COL=n *** You specified a marked area starting point that is located after the ending point. *** ERROR: MAX FIELD WIDTH IS LESS THAN INITIAL WIDTH ROW=n COL=n *** The maximum width field (MWID) attribute value must be an integer in the range of the field length (number of characters in the template) and 1920 (MAXLINES times MAXCOLUMNS). You increased the size of your field so that its size is greater than the value specified on the MWID attribute. *** ERROR: MAXIMUM IMAGE NESTING LEVEL OF 10 EXCEEDED ROW=n COL=n *** DPS 2200 supports up to 10 nested ON/OFF images, not including repeats and fields. You exceeded this limit. *** ERROR: MORE START IMAGE THAN STOP IMAGE CHARACTERS ROW=n COL=n *** Your form template has more start (ON) image characters than stop (OFF) image characters. The number of these characters must be equal. *** ERROR: MORE STOP THAN START CHARS OR BAD NESTING ROW=n COL=n *** Your form template has more stop (OFF) image characters than start (ON) image characters, or you have not properly nested images inside each other. The first case is more likely. *** ERROR: MORE THAN ONE ENDING POINT FOUND ROW=n COL=n *** You entered more than one ending point for a marked area. Only one area can be marked per transmit. *** ERROR: MORE THAN ONE INSERTION POINT FOUND ROW=n COL=n *** You entered more than one insertion point for the marked area. *** ERROR: MORE THAN ONE STARTING POINT FOUND ROW=n COL=n *** You entered more than one starting point for a marked area. Only one area can be marked per transmit. *** ERROR: MORE THAN 18 DIGITS BEFORE DECIMAL POINT ROW=n COL=n *** There are more than 18 digits before the decimal point. The maximum number of places in a field is 26 with attributes, but there can be only 18 digits on either side of the decimal point. *** ERROR: N, C, I OR R TYPE FIELD SIZE < 1 WITH ATTRIBUTES ROW=n COL=n *** The resulting size of your numeric, computational, integer or real field will be less than one with the attributes you specified (for example, CR, DB, DEL, V). A

245 FORMGEN Messages *** ERROR: NO ATTRIBUTE LIST EXISTS FOR ENTRY NUMBER n *** You entered an ^ALn command to attach an attribute list to a field or image, but there are no attributes in slot n of the repository interface attribute list menu. *** ERROR: NO MARKED AREA DEFINED TO INSERT ROW=n COL=n *** You attempted to insert a marked area and no marked area is defined. *** ERROR: NO MARKED AREA EXISTS FOR ENTRY NUMBER n *** You entered an INSERT command that accesses the repository (^Pn), but the menu slot n in the repository interface marked area menu does not contain the name of a marked area. *** ERROR: NO STARTING POINT FOUND FOR MARKED AREA ROW=n COL=n *** You entered an ending point for a marked area which does not have a corresponding starting point. *** ERROR: NUMERIC FIELD SIZE MUST BE LESS THAN 26 ROW=n COL=n *** The maximum number of digits before or after the decimal point is 18. With attributes, the total size of the field cannot exceed 26. To get 26, use V=17, DEL, CR and LMS. *** ERROR: ON/OFF NOT ENTIRELY IN HORIZONTAL REPEAT ROW=n COL=n *** You inserted a field or image into the template that does not fit entirely within the first horizontal repeat occurrence. *** ERROR: REPOSITORY DEADLOCK ENCOUNTERED -- FUNCTION NOT PERFORMED *** An irresolvable deadlock condition has occurred in the repository, causing the repository function to be rejected. You could try again, or report the problem to your site administrator. *** ERROR: REPOSITORY WAS ROLLED BACK -- FUNCTION NOT PERFORMED *** An error occurred in the repository, causing your last function to be rejected. You could try again, or report the problem to your site administrator. *** ERROR: REQUIRED ENTITY ATTRIBUTE <attr> IS MISSING *** An attempt was made to retrieve a marked area entity from the repository, but a necessary attribute of the entity is missing. This could mean data corruption has occurred in the repository or the entity has been incorrectly modified A 23

246 FORMGEN Messages *** ERROR: RIGHT JUSTIFY INVALID FOR SPANNING LINES ROW=n COL=n *** You specified the RJ attribute for a field that spans line boundaries. DPS 2200 does not support this. *** ERROR: SECOND FIELD CHARACTER REQUIRED BUT NOT DEFINED *** Your form does not have a second field character, but one is required because there are back-to-back fields which cross lines. Use the form-level attributes function (F) to define this character and then reenter the layout function (L). *** ERROR: TEMPLATE CONTAINS ERROR MESSAGE ENTER REFRESH (F2) *** You attempted to modify your template after an error was displayed. FORMGEN assumes there is an error message whether you erase it or not. Use function key 2 (F2) to refresh the template before continuing. *** ERROR: THE REPOSITORY IS NOT INSTALLED ON THIS SYSTEM *** The required common banks to use the repository are not installed on the system you are running on. *** ERROR: THE REPOSITORY MUST BE ENABLED IN YOUR USER PROFILE *** You entered a marking command that accesses the repository before enabling use of the repository. Enter Y (for yes) in the Use Repository field in user profile menu 4. *** ERROR: TOO MANY DIGITS SPECIFIED IN DECIMAL SCALE ROW=n COL=n *** You specified more than 18 digits in the decimal scale (V) attribute. *** ERROR: TOO MANY FIELDS FCA TABLE OVERFLOWED ROW=n COL=n *** You attempted to define more fields than are configured for the specified form library. The field control area (FCA) overflows when the total number of the following fields exceeds the configured maximum: ON/OFF images (nonlinked, one field per repeat occurrence or one field if not inside a repeat) I/O, OO fields (same as ON/OFF images) *** ERROR: TOO MANY FIELDS FIELD TABLE OVERFLOWED ROW=n COL=n *** You attempted to define more fields than are configured for the specified form library. The field table overflows when the total number of the following fields exceeds the configured maximum: ON/OFF images (Two fields each. Do not count repeat occurrences.) I/O, OO and system-supplied fields (One field each. Do not count repeat occurrences.) A

247 FORMGEN Messages *** ERROR: UREP FUNCTION = <func>, ERROR CODE = <code> *** An error occurred in the repository that FORMGEN cannot handle. Report this problem to your site administrator. *** ERROR: VWID FIELDS CAUSE WORKING-STORAGE OVERFLOW ROW=n COL=n *** The working-storage for your form overflowed. You either defined too many fields, too many variable-width fields, or too many fields within repeats. A.12. Main Menu (M) Acknowledge Messages *** AUTO-RECOVERY OF <form name/form number> PERFORMED *** You reentered FORMGEN in an autorecovery situation, or by entering the A option. FORMGEN recovered your form to the state it was in during either the last auto save or the last omit function. *** <form name/form number> CREATED IN WORKSPACE *** You entered the NEW library command. The form <form name/form number> was created in your workspace. You can now update, print, generate working storage for the form, or save it into another form in any form library or omnibus file. *** ENTER ERASE AND {XMIT} AGAIN TO ERASE THE FORM *** You entered the erase (ERA) command the first time, but FORMGEN has not yet erased the form. Reenter the erase (ERA) command without changing any of the other fields in the menu and FORMGEN will erase the form from your form library. *** <form name/form number> ERASED FROM FORM LIBRARY *** You entered the erase (ERA) library command and the form no longer exists in the form library. However, it is in your workspace if you previously executed the NEW or OLD command. *** <form name/form number> LOADED INTO WORKSPACE *** You entered the OLD library command. The form <form name/form number> was read from the specified form library or omnibus program file into your workspace. You can now update, print, generate working storage for the form, or save it into another form in any form library or omnibus file A 25

248 FORMGEN Messages *** NEW FUNCTION PERFORMED. ENTER FKEY 4 FOR WALK-THRU MODE *** You entered the NEW library command and you are at expertise level 1. A new form has been created in your workspace. You may now enter any desired update, print, or generate function. You may also request that FORMGEN step you through the form definition process (walk-through mode) by pressing function key 4. *** OLD FUNCTION PERFORMED. ENTER FKEY 4 FOR WALK-THRU MODE *** You entered the OLD library command and you are at expertise level 1. A new form has been loaded into your workspace. You may now enter any desired update, print, or generate function. You may also request that FORMGEN step you through the form definition process (walk-through mode) by pressing function key 4. *** <form name/form number> REPLACED INTO FORM LIBRARY *** You entered the replace (REP) library command to replace an existing form. The form <form name/form number> was written out to the specified form library (not omnibus file). *** <form name/form number> SAVED INTO FORM LIBRARY *** You entered the save (SAV) library command to save the form in your workspace. The form <form name/form number> was written out to the specified form library (not omnibus file). *** <form name/form number> SAVED INTO SPECIFIED OMNIBUS ELEMENT *** You entered the save (SAV) library command to save the form in your workspace. The form (form name/form number) was written out to the specified omnibus element. *** WARNING: FORM ALREADY EXISTS IN SPECIFIED FORM LIBRARY *** You changed the form name, form number or form library name without entering a library command. FORMGEN checks to see whether or not this form already exists in the specified form library and displays this warning message if it does exist. No error occurred. *** WORKSPACE IS NOW EMPTY *** You entered the delete (DEL) library command. There is no form in your workspace so the only functions you can perform are print, generate working storage or help. If you entered this command by mistake, you can recover your form if you had a nonzero value for auto save count by pressing function key 3. A

249 FORMGEN Messages A.13. Main Menu (M) Error Messages *** ERROR: AUTO-SAVE FILE IN USE AUTO-RECOVERY DISABLED *** There is another FORMGEN user with the same run-id. Autorecovery is disabled for your run, but FORMGEN will otherwise function normally. *** ERROR: CANNOT PERFORM OLD OF UNINITIALIZED FORM *** It is not possible to create an uninitialized form using FORMGEN. However, a form is marked as uninitialized during Screen Definition Processor (SDP) form definition. You cannot execute the OLD library command on this form. You must either execute the erase (ERA) or save (SAV) library commands. *** ERROR: CREATION OF AN ENTITY IN THE REPOSITORY FAILED *** While attempting to create an entity in the repository, an error was returned. This may occur if the entity already exists or if the repository is corrupted. *** ERROR: DELETION OF AN ENTITY FROM THE REPOSITORY FAILED *** While attempting to delete an entity from the repository, an error was returned. This may occur if the repository is corrupted. *** ERROR: DPS-FORM ENTITY NOT FOUND IN THE REPOSITORY *** A DPS-FORM entity was not found in the repository. This may occur if the form definition has not yet been saved in the repository. *** ERROR: DPS-FORM-LIBRARY ENTITY NOT FOUND IN THE REPOSITORY *** A DPS-FORM-LIBRARY entity was not found in the repository. This may occur if the form library has not been initialized with DPSIF since DPS 2200 has been configured to use the repository. *** ERROR: ELEMENT NAME IS REQUIRED *** You must specify an omnibus element name when executing the OLD library command, the print, or the generate working storage functions. FORMGEN will default the element name only on the SAVE command. *** ERROR: ENTER AUTO-SAVE COUNT VALUE 0-99 *** You entered a value in the auto save field that is not a number in the range 0 to 99. *** ERROR: ENTER EXPERTISE LEVEL OF 1, 2 OR 3 *** You entered a value in the expertise level field that is not a valid choice A 27

250 FORMGEN Messages *** ERROR: ENTER LIBRARY COMMAND IN FIRST FIELD OF MAIN MENU ONLY *** You entered a library command in the function field. Enter a library command only in the first field of the main menu. *** ERROR: ENTER NEW OR OLD COMMAND BEFORE ENTERING WALK-THROUGH *** You are in the main menu and your expertise level is 1, but there is no form in your workspace. Enter either the NEW or OLD library command to create a new form or to load an existing form. *** ERROR: ENTER SELECT-FUNCTION IN LAST FIELD OF MENU ONLY *** You entered a function code in the library command field. Enter a function code only in the last field of the main menu. *** ERROR: ENTITY NOT FOUND IN THE REPOSITORY *** An entity could not be found in the repository. This may occur if the repository is corrupted. *** ERROR: ERA COMMAND NOT SUPPORTED FOR OMNIBUS FILES *** You entered the erase (ERA) library command and specified an omnibus file type and name. FORMGEN does not support the erase command for omnibus files. *** ERROR: ERROR OCCURRED ATTEMPTING TO ASSIGN FILE *** FORMGEN was not able to assign the specified file. The file may be unloaded or assigned to another run. *** ERROR: FORM ALREADY EXISTS NEW COMMAND NOT POSSIBLE *** You entered the NEW library command, but the form number you want to create already exists in the specified form library (not omnibus file). You must either choose a different form number or erase the existing form first using the erase (ERA) library command. *** ERROR: FORM DOES NOT EXIST USE SAV COMMAND *** You attempted to use the replace (REP) library command, but the specified form number does not exist in the form library. Use the save (SAV) library command for new forms. *** ERROR: FORM LIBRARY FULL SAVE NOT PERFORMED *** You specified either blanks or 0 for the form number with the save (SAV) library command. FORMGEN attempted to find the next available form in the specified form library, but the library is full. A

251 FORMGEN Messages *** ERROR: FORM LIBRARY NAME IS INVALID OR FORM LIBRARY DOES NOT EXIST *** You entered a form library name that either is not configured with your DPS 2200 system, or a name that contains an illegal character. *** ERROR: FORM LIBRARY NOT: CATALOGUED, INITIALIZED OR TIP REGISTERED *** The specified form library cannot be accessed because of one of the following reasons: It is not cataloged (if Executive system file). It is not initialized by DPSIF. It is not registered with TIP. *** ERROR: FORM NAME DOES NOT MATCH IN FORM LIBRARY *** You specified a form name that does not match the form name/form number saved in the form library. *** ERROR: FORM NUMBER OUT OF RANGE OR NOT NUMERIC *** You entered a form number that is either nonnumeric, has a value of 0, or is greater than the maximum number of forms configured for the specified form library. *** ERROR: FORM WILL OVERWRITE EXISTING ONE USE REP COMMAND *** You attempted to use the save (SAV) library command, but the form library already contains a form for the form number you specified. Use the replace (REP) library command or a different form number. *** ERROR: ILLEGAL SYNTAX SPECIFIED FOR FORM-NAME SEE HELP *** You entered an illegal character or embedded blank in the form name. Legal characters are A through Z and 0 through 9. *** ERROR: INCOMPATIBLE FORM VERSION CONVERT FORMS WITH FLMU *** You attempted to use the OLD library command for a form that was created with a DPS 2200 system that had emphasis-in-text configured and your system does not, or vice-versa. *** ERROR: INVALID FILE NAME SPECIFIED *** You specified an omnibus, print, or generate working-storage output file name that is invalid A 29

252 FORMGEN Messages *** ERROR: I/O ERROR ON OUTPUT FILE -- STATUS: *** An I/O error was returned when attempting to write to a file/element. *** ERROR: OMITTING CHANGES TO THE REPOSITORY FAILED *** While attempting to omit changes made to the repository, an error was returned. *** ERROR: OMNIBUS ELEMENT IS TOO LARGE *** FORMGEN cannot write the form out to the specified omnibus element because it is too large for the specified program file. *** ERROR: OMNIBUS ELEMENT VERSION IS INCOMPATIBLE WITH CONFIGURATION *** You attempted to perform an OLD library command on an omnibus element created by a DPS 2200 system configuration incompatible with your system. The element may have too many fields or more working storage than is available in your system. *** ERROR: REPLACE TO OMNIBUS FILE ILLEGAL. USE THE SAVE COMMAND *** You attempted to use the replace (REP) command on an omnibus file (O). You must use the save (SAV) command even if the element already exists. *** ERROR: REPOSITORY DEADLOCK ENCOUNTERED *** While attempting to update or retrieve information in the repository, a deadlock condition was encountered. *** ERROR: REPOSITORY INITIALIZATION FAILED *** While attempting to initialize the interface to the repository, an error was returned. This may occur if the configured application group is currently down. *** ERROR: REPOSITORY TERMINATION FAILED *** While attempting to terminate the interface to the repository, an error was returned. *** ERROR: RETRIEVAL OF AN ENTITY FROM THE REPOSITORY FAILED *** While attempting to find an entity, in the repository, an error was returned. This may occur if the repository is corrupted. *** ERROR: RETRIEVAL OF AN ENTITY NAME FROM THE REPOSITORY FAILED *** While attempting to retrieve an entity name in the repository, an error was returned. This may occur if the repository is corrupted. A

253 FORMGEN Messages *** ERROR: SECURITY CHECK FAILED SEE HELP ON LIBRARY COMMAND *** The security check failed because you do not have the required form definition security to perform the library command you specified or you cannot access your password file. *** ERROR: SPECIFIED FILE IS NOT A PROGRAM FILE *** The file name you specified must be a program file. It cannot be a data file. *** ERROR: SPECIFIED FILE IS NOT CATALOGUED *** The file you specified as an omnibus file (O) is not cataloged. FORMGEN catalogues files only during execution of the save (SAV) library command, during print, and during generate working-storage output. *** ERROR: SPECIFIED FILE IS READ INHIBITED *** FORMGEN attempted to read from a read-inhibited file during the OLD library command, or the print or generate working-storage functions. *** ERROR: SPECIFIED FILE IS WRITE INHIBITED *** FORMGEN attempted to write to a write-inhibited file during the save (SAV) library command, or the print or generate working-storage functions. *** ERROR: SPECIFIED FILE NOT CATALOGUED ATTEMPTED CATALOGUE FAILED *** FORMGEN could not catalog the file during the save (SAV) library command or during the print or generate working-storage functions. *** ERROR: SPECIFIED FORM DOES NOT EXIST IN LIBRARY *** The form on which you tried to use the OLD or erase (ERA) library commands does not exist in the specified form library (not an omnibus file). *** ERROR: SPECIFIED OMNIBUS ELEMENT NOT FOUND *** You attempted to execute an OLD library command on an omnibus program element that does not exist. *** ERROR: SPECIFIED PROGRAM FILE IS NOT CATALOGUED *** You attempted to execute an OLD library command on an omnibus program file that does not exist. However, you may execute the save (SAV) library command on this file and FORMGEN will catalog it for you. *** ERROR: SPECIFY OMNIBUS FILE NAME ONLY IF FILE TYPE IS "O" *** You entered a value in the omnibus file name field, but the file is a form library file (F). Either change the file type to O, or delete the omnibus file name A 31

254 FORMGEN Messages *** ERROR: THE REPOSITORY IS NOT INSTALLED ON THIS SYSTEM *** DPS 2200 is configured to use the repository; however, the repository is not installed on the system. *** ERROR: THE REPOSITORY MUST BE ENABLED IN YOUR USER PROFILE *** You entered a repository interface function (D, D1, D2, DM, or DA) in the select function field before enabling use of the repository. Enter Y (for yes) in the Use Repository field in user profile menu 4. *** ERROR: UNABLE TO ASSIGN SPECIFIED DATA FILE *** FORMGEN cannot assign the data file you specified. *** ERROR: UNABLE TO ASSIGN SPECIFIED FORM LIBRARY *** The specified form library cannot be accessed because it is assigned to another run or it is unloaded. *** ERROR: UNKNOWN FILE TYPE ENTER F OR O *** You entered a value in the file type field that is not a valid choice. *** ERROR: UNKNOWN LIBRARY COMMAND ENTER DEL, ERA, NEW, OLD, REP, SAV *** You entered a value for the library command that is not a valid choice. *** ERROR: UNKNOWN "SELECT" FUNCTION ENTER A,D,E,F,L,M,O,P,R,U,V,W,X *** You entered a value in the function field at the bottom of the menu that is not a valid choice. *** ERROR: UNKNOWN WORKSPACE VALUE ENTER Y OR N *** You entered a value in the workspace field that is not a valid choice. *** ERROR: WORKSPACE EMPTY ENTER NEW OR OLD COMMAND *** You attempted to execute a FORMGEN function but the workspace does not contain a form. *** ERROR: WORKSPACE NOT SAVED ENTER SAV, REP, OR DEL COMMAND *** You entered a NEW or OLD command before saving (SAV) or deleting (DEL) the form currently in your workspace. *** ERROR: WRONG FILE TYPE FOR SPECIFIED FILE *** You attempted to reference a file that is not a disk file. An equipment code was returned indicating that the file is some other type, for example, a tape file. A

255 FORMGEN Messages A.14. Print Menu (P) Acknowledge Messages *** PRINT IN FILE: <file name> *** You generated a print listing of your form using the print function. The print listing is in the indicated file. *** WORKSPACE EMPTY PRINT FUNCTION NOT PERFORMED *** You requested a print listing with the print function (P) and you did not have a form loaded into your workspace. Either you entered a Y in the workspace field value or you entered an N and the form number was 0. A.15. Print Menu (P) Error Messages *** ERROR: A DATA FILE MUST BE SPECIFIED IF SITE OUTPUT IS Y *** A data file name must be specified in the output field when requesting FORMGEN to direct the output to a printer. *** ERROR: BANNER FIELD CONTAINS INVALID CHARACTER *** You entered a value in the banner field containing invalid characters or embedded blanks. Valid characters are A - Z, 0-9, $, -, or *. *** ERROR: CANNOT PERFORM OLD OF UNINITIALIZED FORM *** It is not possible to create an uninitialized form using FORMGEN. However, a form is marked as uninitialized during form definition with the SCREEN DEFINITION PROCESSOR (SDP). You cannot print these forms. You must erase (ERA) or save (SAV) it. *** ERROR: COPIES FIELD NOT IN RANGE 1-63 *** You entered a value in the print copies field that is not within the valid range of *** ERROR: COPIES FIELD NOT NUMERIC OR NEGATIVE NUMBER *** You entered a value in the print copies field that is not numeric or is a negative numeric value. *** ERROR: CYCLE COMMAND REJECTED, STATUS: [INSERT1] *** While attempting to catalog a new cycle of the output file, an error was returned. Check the status value to determine the cause of the error A 33

256 FORMGEN Messages *** ERROR: DESTINATION FIELD CONTAINS INVALID CHARACTER *** You entered a value in the destination field which contains invalid characters or embedded blanks. Valid characters are A - Z or 0-9. *** ERROR: ELEMENT NAME IS REQUIRED *** You must specify an omnibus element name when using the OLD library command, or the print or generate working storage functions. FORMGEN defaults the element name only on the save (SAV) library command. *** ERROR: ENTER Y OR N FOR RETAIN OUTPUT *** You entered a value for retain output that is not a valid choice. *** ERROR: ENTER Y OR N FOR SITE OUTPUT *** You entered a value for site output that is not a valid choice. *** ERROR: ERROR OCCURRED ATTEMPTING TO ASSIGN FILE *** FORMGEN could not assign the specified file. The file may not be loaded or it may be assigned to another run. *** ERROR: FORM LIBRARY NAME SPECIFIED IS INVALID OR FORM LIBRARY DOES NOT EXIST *** You entered a form library name that either is not configured with your DPS 2200 System or contains an illegal character. *** ERROR: FORM LIBRARY NOT: CATALOGUED, INITIALIZED OR TIP REGISTERED *** The specified form library cannot be accessed because of one of the following reasons: It is not cataloged (if Executive system file). It is not initialized by DPSIF. It is not registered with TIP. *** ERROR: FORM NAME DOES NOT MATCH IN FORM LIBRARY *** You specified a form name that does not match the form name/form number saved in the form library. *** ERROR: FORM NUMBER OUT OF RANGE OR NOT NUMERIC *** You entered a form number that is either not numeric, has a value of 0, or is greater than the maximum number of forms configured for the specified form library. A

257 FORMGEN Messages *** ERROR: ILLEGAL SYNTAX SPECIFIED FOR FORM-NAME SEE HELP *** You entered an illegal character or embedded blank in the form name. Legal characters are A through Z and 0 through 9. *** ERROR: INCOMPATIBLE FORM VERSION CONVERT FORMS WITH FLMU *** You attempted to print a form that was created with a DPS 2200 system that had emphasis-in-text configured and your system does not, or vice-versa. *** ERROR: INVALID FILE NAME SPECIFIED *** You specified an omnibus file name, or a print or generate working-storage output file name that is not valid. *** ERROR: I/O ERROR ON OUTPUT FILE -- STATUS: *** An I/O error was returned when attempting to write to a file/element. *** ERROR: OMNIBUS ELEMENT IS TOO LARGE *** FORMGEN cannot write the form out to the specified omnibus element because it is too large for the specified program file. *** ERROR: OMNIBUS ELEMENT VERSION IS INCOMPATIBLE WITH CONFIGURATION *** The omnibus element you are attempting to print was created by a DPS 2200 configuration incompatible with your system configuration. The element may have too many fields or more working storage than is available on your system. *** ERROR: SECURITY CHECK FAILED SEE HELP ON LIBRARY COMMAND *** The security check failed because you do not have the required form definition security to perform the library command you specified. The other possibility is that you cannot access your password file. *** ERROR: SITE COMMAND REJECTED, STATUS: *** While attempting to print the output file, an error was returned. Check the status value to determine the cause of the error. *** ERROR: SPECIFIED FILE IS NOT A PROGRAM FILE *** The file name you specified is not a program file. It may be a data file. *** ERROR: SPECIFIED FILE IS NOT CATALOGUED *** The file you specified as an omnibus file is not cataloged. FORMGEN catalogues files only during the save (SAV) library command, or for print and generate working-storage output A 35

258 FORMGEN Messages *** ERROR: SPECIFIED FILE NOT CATALOGUED ATTEMPTED CATALOGUE FAILED *** FORMGEN could not catalog the file during the save (SAV) library command, or during the print or generate working storage functions. *** ERROR: SPECIFIED FILE IS READ INHIBITED *** FORMGEN attempted to read from a read-inhibited file during the OLD library command or the print or generate working storage functions. *** ERROR: SPECIFIED FILE IS WRITE INHIBITED *** FORMGEN attempted to write to a write-inhibited file during the save (SAV) library command, or the print or generate working storage functions. *** ERROR: SPECIFIED FORM DOES NOT EXIST IN LIBRARY *** The form you tried to print does not exist in the specified form library (not an omnibus file). *** ERROR: SPECIFIED OMNIBUS ELEMENT NOT FOUND *** You attempted to print a form from an omnibus program element that does not exist. *** ERROR: SPECIFIED PROGRAM FILE IS NOT CATALOGUED *** You attempted to print from an omnibus program file that does not exist. However, you may execute the save (SAV) library command on this file and FORMGEN will catalog it for you. *** ERROR: SPECIFY OMNIBUS FILE NAME ONLY IF FILE TYPE IS "O" *** You entered a value in the omnibus file name field, but the file is a form library file (F). Either change the file type to O or delete the omnibus file name. *** ERROR: UNABLE TO ASSIGN SPECIFIED DATA FILE *** FORMGEN cannot assign the data file you specified. *** ERROR: UNABLE TO ASSIGN SPECIFIED FORM LIBRARY *** The specified form library cannot be accessed because it is assigned to another run or it is unloaded. *** ERROR: UNKNOWN FILE TYPE ENTER F OR O *** You entered a value in the file type field that is not a valid choice. A

259 FORMGEN Messages *** ERROR: UNKNOWN "SELECT" FUNCTION ENTER A,D,E,F,L,M,O,P,R,U,V,W,X *** You entered a value in the function field at the bottom of the menu that is not a valid choice. *** ERROR: WORKSPACE EMPTY ENTER NEW OR OLD COMMAND *** You entered a function in the function field, but you have not specified a NEW or OLD library command. The only functions you can perform are print (P), generate working storage (W) and help. *** ERROR: WRONG FILE TYPE FOR SPECIFIED FILE *** You attempted to reference a file that is not a disk file. An equipment code was returned indicating that the file is some other type, for example, a tape file. A.16. Repeat Attributes Menu (R) Acknowledge Message *** REPEAT IMAGES UPDATED *** You performed a successful update of the repeat images function. A.17. Repeat Attributes Menu (R) Error Messages *** ERROR: ATTEMPT TO DELETE A NON-EXISTENT REPEAT IMAGE *** You entered a D in the CHG TYPE field for a repeat that does not exist. The repeat was never successfully completed or the line in the repeats menu was blank. *** ERROR: ATTEMPT TO MODIFY A NON-EXISTENT REPEAT IMAGE *** You entered an M into the CHG TYPE field for a repeat that does not exist. The repeat was never successfully completed or the line in the repeats menu was blank. *** ERROR: BACK-TO-BACK FIELDS SPECIFIED *** You placed a field character directly adjacent to an alternate (second) field character. This would create back-to-back fields. These may only be defined across line boundaries. *** ERROR: DUPLICATE IMAGE/FIELD OR INDEX NAME SPECIFIED *** You specified an image, field, or index name that has already been defined in the form. This does not include the form name A 37

260 FORMGEN Messages *** ERROR: ENTER NUMERIC VALUE FOR LINES/OCCURRENCE (GREATER THAN 0) *** You entered a value for the number of lines for each repeat occurrence that is not an integer. *** ERROR: ENTER NUMERIC VALUE FOR REPEAT COUNT (2-24) *** You entered a value for the repeat count that is not an integer in the range 2 to 24 (maximum lines). *** ERROR: ENTER NUMERIC VALUE FOR REPEAT ENDING COLUMN (1-80) *** You entered a value for the repeat ending column that is not an integer in the range 1 to 80 (maximum columns). *** ERROR: ENTER NUMERIC VALUE FOR REPEAT ROW NUMBER (1-24) *** You entered a value for the starting row of your repeat that is not an integer in the range 1 to 24 (maximum lines). *** ERROR: ENTER NUMERIC VALUE FOR REPEAT SPACING (0 OR GREATER) *** You entered a value for repeat spacing (number of columns between occurrences) that is not an integer. *** ERROR: ENTER NUMERIC VALUE FOR REPEAT STARTING COLUMN (1-80) *** You entered a value for the repeat starting column that is not an integer in the range 1 to 80 (maximum columns). *** ERROR: FIELD CANNOT SPAN LINES INSIDE REPEAT *** A repeat cannot contain a field spanning lines, unless that field is completely contained within the first occurrence. *** ERROR: FIELD OVERLAPS HORIZONTAL REPEAT OCCURRENCE *** You attempted to insert a horizontal repeat or a field into a horizontal repeat, such that the field will not be completely contained in the repeat occurrence. *** ERROR: HORIZONTAL REPEAT CANNOT BE NESTED INSIDE ANOTHER *** You cannot nest a horizontal repeat within another. The only valid nesting is a horizontal repeat within a vertical repeat. *** ERROR: HORIZONTAL REPEAT MUST BE INSERTED ON 1ST VERTICAL OCCURRENCE *** You attempted to insert a horizontal repeat into some other occurrence than the first occurrence of a vertical repeat. A

261 FORMGEN Messages *** ERROR: ILLEGAL VALUE FOR FORM HEIGHT OR REPEAT LINES PER OCCURRENCE *** You specified an out-of-range value for either the form height in the form-level attributes or for the number of lines per repeat occurrence. *** ERROR: IMAGE CANNOT SPAN OCCURRENCES INSIDE REPEAT *** A repeat cannot contain an image spanning lines unless that image is completely contained within the first occurrence. *** ERROR: IMAGE OR FIELD DEFINED IN HORIZONTAL REPEAT SPACING *** You cannot have an image or field defined within the spacing of a horizontal repeat. *** ERROR: IMAGE OR FIELD OVERLAPS ANOTHER IMAGE OR FIELD *** You attempted to overlay one repeat or image over another repeat or image. *** ERROR: IMAGE OUTSIDE OF FORM OR IMAGE BOUNDARY *** You attempted to insert or modify a repeat that will not fit into 80 characters horizontally (maximum columns). This can be caused by any one of a combination of fields in the menu. *** ERROR: INDICATED HORIZONTAL REPEAT MUST BE CONTAINED IN FORM BOUNDS *** You attempted to insert or modify a repeat that will not fit into 80 characters horizontally (maximum columns). This can be caused by any one of a combination of fields in the menu. *** ERROR: INDICATED REPEAT ENDS INSIDE ANOTHER REPEAT *** You specified a combination of lines per occurrence and a repeat count such that a repeat will overlap another repeat. *** ERROR: INDICATED REPEAT STARTS INSIDE ANOTHER REPEAT *** You specified the row number of a repeat such that it would be partially or completely contained within another repeat. The only nesting allowed is a horizontal repeat within a vertical repeat. *** ERROR: INDICATED VERTICAL REPEAT WIDTH MUST BE EQUAL TO FORM WIDTH *** The vertical repeat for which the change type field is blinking must have the starting column equal to 1 and the ending column equal to 80 (maximum columns) A 39

262 FORMGEN Messages *** ERROR: INVALID CHARACTER SPECIFIED IN IMAGE/FIELD OR INDEX NAME *** You specified an illegal character in an image, field or index name. Legal characters are A through Z, 0 through 9, and the hyphen. *** ERROR: LINE NUMBER FOR INDICATED REPEAT MUST BE IN FORM BOUNDS *** You specified a row number for a repeat that is not in the range 1 to 24 (max lines). *** ERROR: NON-FIRST OCCURRENCES OF INDICATED REPEAT MUST CONTAIN SPACES *** Except for the first occurrence of a repeat, all occurrences must contain spaces. No literals (text) are allowed. *** ERROR: ON/OFF IMAGE NOT ENTIRELY IN HORIZONTAL REPEAT *** You attempted to insert a horizontal repeat, or an image into a horizontal repeat such that the image will not be completely contained in the repeat occurrence. *** ERROR: REPEAT COUNT IS 0, 1 OR TOO LARGE TO FIT IN FORM BOUNDS *** You specified a repeat count less than the minimum allowed (2), or the repeat count is too large for the repeat to be contained within the area of the form. *** ERROR: REPEAT SPACING MUST BE ZERO FOR VERTICAL REPEAT *** You entered a value greater than zero in the repeat spacing field for a vertical repeat. *** ERROR: TOO MANY FIELDS FCA TABLE OVERFLOWED *** You attempted to define more fields than are configured for the specified form library. The field control (FCA) table overflows when the total number of the following fields exceeds the configured maximum: ON/OFF images (nonlinked, one field per repeat occurrence, or one field if not inside a repeat) I/O, OO fields (same as ON/OFF images) A

263 FORMGEN Messages *** ERROR: TOO MANY FIELDS FIELD TABLE OVERFLOWED *** You attempted to define more fields than are configured for the specified form library. The field table overflows when the total number of the following fields exceeds the configured maximum: Repeats (Two fields each) ON/OFF images (Two fields each. Do not count repeat occurrences.) I/O, OO and system-supplied fields (One field each. Do not count repeat occurrences.) *** ERROR: UNKNOWN CHANGE TYPE ENTER N, I, D OR M *** You entered a value in the repeat change type (CHG TYPE) field that is not one of the following valid choices: I = insert new repeat D = delete an existing repeat M = modify an existing repeat N = do not change the repeat *** ERROR: UNKNOWN REPEAT DIRECTION ENTER D OR R *** You entered a value for the direction of your repeat image that is not a valid choice (D = down (vertical) or R = right (horizontal)). *** ERROR: UNKNOWN REPEAT LITERALS ENTER Y OR N *** You specified that you do or do not want to repeat the literals (text) within the first repeat occurrence to be repeated. That is not a valid choice. *** ERROR: UNKNOWN "SELECT" FUNCTION ENTER A,D,E,F,L,M,O,P,R,U,V,W,X *** You entered a value in the function field at the bottom of the menu that is not a valid choice. *** ERROR: VERTICAL REPEAT MUST BEGIN IN COLUMN ONE *** The starting column of a vertical repeat must be the first column. *** ERROR: VWID FIELDS CAUSE WORKING-STORAGE OVERFLOW *** You overflowed the working storage of your form. You either defined too many fields, too many variable-width fields, or too many fields within repeats A 41

264 FORMGEN Messages A.18. Profile (U) Acknowledge Message *** USER PROFILE VALUES UPDATED *** You performed a successful update of the user profile values. A.19. Profile (U) Error Messages *** ERROR: BAD CHARACTER ENTERED FOR *** You entered a value in the specified field that is not a valid character. *** ERROR: BAD FORM LIBRARY SYNTAX SPECIFIED *** You entered a form library name containing invalid characters or embedded blanks. *** ERROR: BAD FORM NAME SYNTAX SPECIFIED *** You entered a form name containing invalid characters or embedded blanks. *** ERROR: DPS IS NOT CONFIGURED TO USE THE REPOSITORY *** A value of R was entered in the output type field and DPS is not configured to use the repository. *** ERROR: DUPLICATE EMPHASIS VALUE SPECIFIED *** You entered an emphasis value more than once in the emphasis field. *** ERROR: DUPLICATE HIGHLIGHT VALUE SPECIFIED *** You entered a highlight value more than once in the highlight field. *** ERROR: ELEMENT EXCEEDS 12 CHARACTER MAXIMUM LENGTH *** You entered an element name that exceeds 12 characters. *** ERROR: FILENAME EXCEEDS 12 CHARACTER MAXIMUM LENGTH *** You entered a file name that exceeds 12 characters. *** ERROR: INVALID FILE NAME SPECIFIED *** You entered a file name that contains invalid characters or embedded blanks or has an improper format. *** ERROR: NON-NUMERIC VALUE ENTERED *** You entered a nonnumeric value in a field that must be numeric. A

265 FORMGEN Messages *** ERROR: OUTPUT FILE ELEMENT NAME CAN BE ONLY 8 CHARACTERS LONG *** You entered an element name for the working storage output file that exceeds 8 characters. The length is restricted to 8 characters so that the form number may be appended to the element name. *** ERROR: PRINT ELEMENT NAME CAN BE ONLY 8 CHARACTERS LONG *** You entered an element name for the print function output file that exceeds 8 characters. The length is restricted to 8 characters so that the form number may be appended to the element name. *** ERROR: PRINT FILE NAME CAN BE ONLY 8 CHARACTERS LONG *** You entered a file name for the print function output file that exceeds 8 characters. The length is restricted to 8 characters so that the form number may be appended to the element name. *** ERROR: QUALIFIER EXCEEDS 12 CHARACTER MAXIMUM LENGTH *** You entered a value for the qualifier that exceeds 12 characters. *** ERROR: REPEAT COUNT OUT OF RANGE ENTER 2-80 *** You entered a value in the repeat count field that is not within the valid range of values. *** ERROR: REPEAT LINES/OCCURRENCE OUT OF RANGE ENTER 1-12 *** You entered a value in the repeat lines/occurrence field that is not within the valid range of values. *** ERROR: REPEAT SPACING OUT OF RANGE ENTER 0-78 *** You entered a value in the repeat spacing field that is not within the valid range of values. *** ERROR: REPEAT STARTING/ENDING COLUMN OUT OF RANGE ENTER 1-79 *** You entered a value in the repeat start column or repeat end column field that is not within the valid range of values. *** ERROR: SECURITY LEVEL OUT OF RANGE ENTER 1-63 *** You entered a value in the security level field that is not within the valid range of values. *** ERROR: UNKNOWN AUTO SAVE COUNT VALUE ENTER 0-99 *** You entered a value in the auto save count field that is not within the valid range of values A 43

266 FORMGEN Messages *** ERROR: UNKNOWN BACKGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value in the background color field that is not a valid choice. *** ERROR: UNKNOWN CHECK MODE VALUE ENTER Y OR N *** You entered a value in the check mode field that is not a valid choice. *** ERROR: UNKNOWN CONTROL CHARACTER SPECIFIED ENTER B OR N *** You entered a value in the control character field that is not a valid choice. *** ERROR: UNKNOWN CONVERSATION MODE VALUE ENTER Y OR N *** You entered a value in the conversation mode field that is not a valid choice. *** ERROR: UNKNOWN EMPHASIS VALUE ENTER N, L, S OR U *** You entered a value in the emphasis field that is not a valid choice. *** ERROR: UNKNOWN EXPERTISE LEVEL VALUE ENTER 1, 2 OR 3 *** You entered a value in the expertise level field that is not a valid choice. *** ERROR: UNKNOWN FIELD BACKGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value in the menu field background field that is not a valid choice. *** ERROR: UNKNOWN FIELD FOREGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value in the menu field foreground field that is not a valid choice. *** ERROR: UNKNOWN FIELD HIGHLIGHT VALUE ENTER N OR R *** You entered a value in the menu field highlight field that is not a valid choice. *** ERROR: UNKNOWN FILE TYPE ENTER F OR O *** You entered a value in the file type field that is not a valid choice. *** ERROR: UNKNOWN FONT OR CHARACTER SET VALUE ENTER N OR 1 *** You entered a value in the font field that is not a valid choice. *** ERROR: UNKNOWN FOREGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value in the foreground color field that is not a valid choice. *** ERROR: UNKNOWN FOREGROUND INTENSITY VALUE ENTER N,H,L OR S *** You entered a value in the foreground intensity field that is not a valid choice. A

267 FORMGEN Messages *** ERROR: UNKNOWN GENERATE PREFIX VALUE ENTER Y OR N *** You entered a value in the generate prefix field that is not a valid choice. *** ERROR: UNKNOWN HIGHLIGHT VALUE ENTER N, B OR R *** You entered a value in the highlight field that is not a valid choice. *** ERROR: UNKNOWN INITIAL VALUES SPECIFICATION ENTER Y OR N *** You entered a value in the initial values field that is not a valid choice. *** ERROR: UNKNOWN LANGUAGE TYPE ENTER COB, FOR, FTN, UC, OR UCOB *** You entered a value in the language type field that is not a valid choice. *** ERROR: UNKNOWN ELMS DIALECT VALUE *** You entered a value for the Extended Language Message System (ELMS) dialect that is not a valid choice. *** ERROR: UNKNOWN ELMS LANGUAGE VALUE *** You entered a value for the ELMS language that is not a valid choice. *** ERROR: UNKNOWN MARKED AREA TYPE ENTER R OR W *** You entered a value in the marked area type field that is not a valid choice. *** ERROR: UNKNOWN MARKING COMMAND VALUE ENTER C OR M *** You entered a value in the marking command field that is not a valid choice. *** ERROR: UNKNOWN MENU BACKGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value in the menu background color field that is not a valid choice. *** ERROR: UNKNOWN MENU FOREGROUND COLOR ENTER B,C,E,G,M,R,W OR Y *** You entered a value in the menu foreground color field that is not a valid choice. *** ERROR: UNKNOWN OUTPUT TYPE VALUE -- ENTER F OR R *** A value was entered in the output type field that was not a valid choice. *** ERROR: UNKNOWN REDEFINITION SPECIFICATION ENTER Y OR N *** You entered a value in the working storage redefinition field that is not a valid choice A 45

268 FORMGEN Messages *** ERROR: UNKNOWN REPEAT DIRECTION VALUE ENTER D OR R *** You entered a value in the repeat direction field that is not a valid choice. *** ERROR: UNKNOWN REPEAT LITERALS VALUE ENTER Y OR N *** You entered a value in the repeat literals field that is not a valid choice. *** ERROR: UNKNOWN SECURITY TYPE ENTER S OR H *** You entered a value in the security type field that is not a valid choice. *** ERROR: UNKNOWN "SELECT" FUNCTION ENTER A,D,E,F,L,M,O,P,R,U,V,W,X *** You entered a value in the function field at the bottom of the menu that is not a valid choice. *** ERROR: UNKNOWN TEST MODE VALUE ENTER Y OR N *** You entered a value in the test mode field that is not a valid choice. *** ERROR: UNKNOWN WORKING-STORAGE DATA TYPE ENTER D *** You entered a value in the working storage data type field that is not a valid choice. *** ERROR: VERSION EXCEEDS 12 CHARACTER MAXIMUM LENGTH *** You entered a file version name that exceeds 12 characters. *** ERROR: CAN NOT BE A MASTERSPACE *** You entered the masterspace (@) character in the specified field and this is not a valid character. *** ERROR: MUST BE UNIQUE *** The values you entered in the specified field must be unique. A.20. Repository Interface Acknowledge Messages *** ACCESSING THE REPOSITORY -- PLEASE WAIT *** This message is displayed when you enter an action that accesses the repository, which may take some time. The real response message is displayed when the function is complete. *** REPOSITORY FUNCTIONS PERFORMED *** This message is displayed when all the actions you specified in the marked area or attribute list menu have completed successfully. A

269 FORMGEN Messages A.21. Repository Interface Error Messages If an error occurs when DPS 2200 is accessing UREP, the file DPS$DDABORT is created. This file contains the repository error messages returned by UREP. Multiple cycles of this file may exist. ***ERROR: CREATION OF A RELATIONSHIP IN THE REPOSITORY FAILED*** The relationship between entities failed. This may occur if the repository is corrupted or entities entered under table name (using the DT function) have the same name. ***ERROR: DEFINING A TEXT ATTRIBUTE IN THE REPOSITORY FAILED*** A link entity could not be created in the repository. This may occur if the repository is corrupted. ***ERROR: DELETION OF A TEXT ATTRIBUTE FROM THE REPOSITORY FAILED*** Unable to delete the entity in the repository. This would occur if a table name could not be deleted due to the repository being corrupted. *** ERROR: DPS IS NOT CONFIGURED TO USE THE REPOSITORY *** Your DPS 2200 system has not been configured to access the repository. *** ERROR: ENTITY <name> ALREADY EXISTS IN THE REPOSITORY *** You tried to create a new marked area or attribute list, but one already exists with that name. Choose a new name or erase the existing entity first. *** ERROR: ENTITY <name> CANNOT BE FOUND IN THE REPOSITORY *** You tried to retrieve or modify this marked area or attribute list, but it does not exist in the repository under the specified USER ID. ***ERROR: ENTITY NOT FOUND IN THE REPOSITORY *** An entity could not be found in the repository. This may occur if the repository is corrupted or if an attempt is made to delete a table that is not in the repository with the DT function. *** ERROR: ILLEGAL ACTION TYPE -- VALID ENTRIES ARE D, E, M, N, R, AND S *** You entered a value in the action field that is not a valid choice. *** ERROR: ILLEGAL ACTION TYPE -- VALID ENTRIES ARE D, E, M, R, AND S *** You entered a value in the action field that is not a valid choice A 47

270 FORMGEN Messages *** ERROR: LINK IN REPOSITORY ALREADY EXISTS FOR THIS FIELD *** A link is already established for this field in the repository. You must use the VC=N attribute to break the link. *** ERROR: MARKED AREA MUST EXIST BEFORE YOU CAN MODIFY IT *** You must retrieve a marked area before you can use the MODIFY action to change its name. *** ERROR: NO ATTRIBUTES ENTERED FOR MODIFY OR SAVE ACTION *** You tried to modify or save an attribute list, but there are no attributes in the slot containing the MODIFY or SAVE action. *** ERROR: RANGE VALUES MUST BE NUMERIC *** The range values entered in the Range Checking menu must be numeric. *** ERROR: REPOSITORY DEADLOCK ENCOUNTERED -- FUNCTION NOT PERFORMED *** An unresolvable deadlock condition has occurred in the repository, causing the repository function to be rejected. You could try again, or report the problem to your site administrator. *** ERROR: REPOSITORY WAS ROLLED BACK -- FUNCTION NOT PERFORMED *** An error occurred in the repository, causing your last function to be rejected. You could try again, or report the problem to your site administrator. *** ERROR: REQUIRED ENTITY ATTRIBUTE <attr> IS MISSING *** An attempt was made to retrieve a marked area or attribute list entity from the repository, but a necessary attribute of the entity is missing. This could mean data corruption has occurred in the repository or the entity has been incorrectly modified. *** ERROR: RETRIEVAL OF AN ENTITY FROM THE REPOSITORY FAILED*** An entity could not be found in the repository. This may occur if the repository is corrupted. *** ERROR: THE REPOSITORY IS NOT INSTALLED ON THIS SYSTEM *** The required common banks to use the repository are not installed on the system you are running on. *** ERROR: UREP FUNCTION = <func>, ERROR CODE = <code> *** An error occurred in the repository that Formgen cannot handle; report this problem to your site administrator. A

271 FORMGEN Messages *** ERROR: YOU CAN ONLY ERASE, MODIFY, OR SAVE ENTITIES USING YOUR USER ID *** You tried to ERASE, MODIFY, or SAVE a marked area or attribute list using a user id other than your own. You are not allowed to do this. *** ERROR: YOU MUST PROVIDE A NAME FOR THIS ACTION *** This action requires that you specify a name in the NAME field. Otherwise, the action is undefined. *** ERROR: YOU MUST SUPPLY A TABLE NAME FOR THE REPOSITORY *** You transmitted from the Table Checking menu without supplying a table name. *** ERROR: YOU MUST SUPPLY UPPER AND LOWER RANGES FOR THE REPOSITORY *** You transmitted from the Range Checking menu without supplying an upper and/or lower range. A.22. Initial Values Menu (V) Acknowledge Message *** FIELD INITIAL VALUES UPDATED *** You performed a successful update with the initial values function. This message appears only after you exit the initial values function so that it does not destroy your template. A.23. Initial Values Menu (V) Error Messages *** ERROR: FORM HAS NO FIELDS INITIAL VALUES FUNCTION NOT POSSIBLE *** You entered the initial values function (V), but your form does not contain any fields for which initial values can be defined. FORMGEN will not enter the function. *** ERROR: ILLEGAL CHARACTER IN INITIAL VALUE *** The alphabetic (A) field contains a nonalphabetic character. *** ERROR: VALUE CHECK SPECIFIED, BUT NO TABLE NAME FOUND IN UREP *** DPS 2200 found a corrupted link in the repository when validating the initial value for a field with the VC=T attribute set. *** ERROR: VALUE CHECK SPECIFIED, BUT NO VC LINK FOUND IN UREP *** DPS 2200 was unable to find the required link in the repository to validate the initial value for a field with the VC=T attribute set A 49

272 FORMGEN Messages *** ERROR: VALUE CHECK SPECIFIED, BUT NO VC TABLE FOUND IN UREP *** DPS 2200 was unable to find the required table in the repository to validate the initial value for a field with the VC=T attribute set. *** ERROR: VALUE CHECK SPECIFIED, BUT UREP ACCESS FAILED *** DPS 2200 was unable to access the repository to validate the initial value for a field with the VC=T attribute set. A.24. Generate Working Storage Menu (W) Acknowledge Messages *** WORKING-STORAGE IN FILE: <file name> *** You generated working storage for your form using the generate working storage function (W). The working storage is contained in the file specified by <file name>. You must now use the PDP processor for both COBOL and FORTRAN. *** WORKING-STORAGE SAVED IN REPOSITORY *** You generated working storage for your form using the generate storage function (W). The working storage was successfully saved in the repository. *** WORKSPACE EMPTY GENERATE WORKING-STORAGE FUNCTION NOT PERFORMED *** You requested working storage generation using the generate function (W). You did not have a form loaded in your workspace and either the workspace field value was Y, or it was N and the form number was 0. A.25. Generate Working Storage Menu (W) Error Messages *** ERROR: AN OUTPUT FILE NAME CANNOT BE SPECIFIED IF OUTPUT TYPE IS "R" *** You entered a value for the output file name when the working storage is going to be saved in the repository. *** ERROR: CANNOT GENERATE WORKING STORAGE - SEE DPS$DDABORT. FOR DETAILS *** An error occurred while attempting to generate working storage for a form. A new cycle of the DPS$DDABORT file will be created. This file will contain a detailed explanation of the problem. A

273 FORMGEN Messages *** ERROR: CANNOT GENERATE WORKING STORAGE - SEE OUTPUT ELEMENT FOR DETAILS *** An error occurred while attempting to generate working storage for a form. The output element specified in the output field on the FORMGEN Working Storage menu will contain a detailed explanation of the problem. *** ERROR: CANNOT PERFORM OLD OF UNINITIALIZED FORM *** It is not possible to create an uninitialized form using FORMGEN. However, a form is marked as uninitialized during form definition with the SCREEN DEFINITION PROCESSOR (SDP). You cannot generate working storage for these forms. You must erase (ERA) or save (SAV) it. *** ERROR: CANNOT SPECIFY INITIAL VALUES WITH TYPEDEF STORAGE TYPE *** You cannot generate C working storage with a storage type of TYPEDEF and specify initial values YES. *** ERROR: CREATION OF AN ENTITY IN THE REPOSITORY FAILED *** While attempting to create an entity in the repository, an error was returned. This may occur if the entity already exists, if the repository is corrupted, or if a field name (for example, number) in a form already exists. If a field name is specified, DPS 2200 prefixes the field name with the form number. However, DPS 2200 generates a field name (S#-NUMBER) while creating a form; therefore, duplicate names are detected. *** ERROR: CREATION OF A RELATIONSHIP IN THE REPOSITORY FAILED *** While attempting to create a relationship in the repository, an error was returned. This may occur if the relationship already exists or if the repository is corrupted. *** ERROR: D AND T ONLY VALID STORAGE TYPE VALUES FOR UC *** You entered a value other than D or T for the storage type value. *** ERROR: DEFINING A TEXT ATTRIBUTE IN THE REPOSITOTY FAILED *** While attempting to define a text attribute in the repository, an error was returned. This may occur if the text attribute has already been defined or if the repository is corrupted. *** ERROR: DEFINING AN ATTRIBUTE IN THE REPOSITORY FAILED *** While attempting to define an attribute in the repository, an error was returned. This may occur if the attribute has already been defined or if the repository is corrupted A 51

274 FORMGEN Messages *** ERROR: DELETION OF AN ENTITY FROM THE REPOSITORY FAILED *** While attempting to delete an entity from the repository, an error was returned. This may occur if the repository is corrupted. *** ERROR: DPS-FORM ENTITY NOT FOUND IN THE REPOSITORY *** A DPS-FORM entity was not found in the repository. This may occur if the form definition has not yet been saved in the repository. *** ERROR: DPS-FORM-LIBRARY ENTITY NOT FOUND IN THE REPOSITORY *** A DPS-FORM-LIBRARY entity was not found in the repository. This may occur if the form library has not been initialized with DPSIF since DPS 2200 has been configured to use the repository. *** ERROR: ELEMENT NAME IS REQUIRED *** You must specify an omnibus element name when using the OLD library command, or the print or generate working storage functions. FORMGEN defaults the element name only on the save (SAV) library command. *** ERROR: ENTITY NOT FOUND IN THE REPOSITORY *** An entity could not be found in the repository. This may occur if the repository is corrupted. *** ERROR: ERROR OCCURRED ATTEMPTING TO ASSIGN FILE *** FORMGEN could not assign the specified file. The file may not be loaded, or it may be assigned to another run. *** ERROR: FORM LIBRARY NAME SPECIFIED IS INVALID OR FORM LIBRARY DOES NOT EXIST *** You entered a form library name that either is not configured with your DPS 2200 system or contains an illegal character. *** ERROR: FORM LIBRARY NOT: CATALOGUED, INITIALIZED OR TIP REGISTERED *** The specified form library cannot be accessed because of one of the following reasons: It is not cataloged (if Executive system file). It has not been initialized by DPSIF. It has not been registered with TIP. A

275 FORMGEN Messages *** ERROR: FORM NAME DOES NOT MATCH IN FORM LIBRARY *** You specified a form name that does not match the form name/form number saved in the form library. *** ERROR: FORM NUMBER OUT OF RANGE OR NOT NUMERIC *** You entered a form number that is either not numeric, has a value of 0, or is greater than the maximum number of forms configured for the specified form library. *** ERROR: FORTRAN WORKING STORAGE CANNOT BE SAVED IN THE REPOSITORY *** DPS 2200 does not support saving FORTRAN or UC working storage in the repository. *** ERROR: I/O ERROR ON OUTPUT FILE -- STATUS: *** An I/O error was returned when attempting to write to a file/element. *** ERROR: ILLEGAL SYNTAX SPECIFIED FOR FORM-NAME SEE HELP *** You entered an illegal character or embedded blank in the form name. Legal characters are A through Z and 0 through 9. *** ERROR: INCOMPATIBLE FORM VERSION CONVERT FORMS WITH FLMU *** You attempted to print a form that was created with a DPS 2200 system that had emphasis-in-text configured and your system does not, or vice-versa. *** ERROR: INVALID FILE NAME SPECIFIED *** You specified an omnibus file name, or a print or generate working-storage output file name that is invalid. *** ERROR: OMITTING CHANGES TO THE REPOSITORY FAILED *** While attempting to omit changes made to the repository, an error was returned. *** ERROR: OMNIBUS ELEMENT IS TOO LARGE *** FORMGEN cannot write the form out to the specified omnibus element because it is too large for the specified program file. *** ERROR: OMNIBUS ELEMENT VERSION IS INCOMPATIBLE WITH CONFIGURATION *** The omnibus element for which you are attempting to generate working storage was created by a DPS 2200 configuration that is not compatible with your system configuration. The element may have too many fields or more working storage than is available on your system A 53

276 FORMGEN Messages *** ERROR: PLUS WORKING STORAGE CANNOT BE SAVED IN THE REPOSITORY *** DPS 2200 does not support saving PLUS working storage in the repository. *** ERROR: REDEFINITION IS NOT ALLOWED FOR W/S SAVED IN THE REPOSITORY *** DPS 2200 does not support redefinition for working storage saved in the repository. *** ERROR: REPOSITORY DEADLOCK ENCOUNTERED *** While attempting to update or retrieve information in the repository, a deadlock condition was encountered. *** ERROR: REPOSITORY INITIALIZATION FAILED *** While attempting to initialize the interface to the repository, an error was returned. This may occur if the configured application group is currently down. *** ERROR: REPOSITORY TERMINATION FAILED *** While attempting to terminate the interface to the repository, an error was returned. *** ERROR: RETRIEVAL OF AN ENTITY FROM THE REPOSITORY FAILED *** While attempting to find an entity in the repository, an error was returned. This may occur if the repository is corrupted. *** ERROR: RETRIEVAL OF AN ENTITY NAME FROM THE REPOSITORY FAILED *** While attempting to retrieve an entity name in the repository, an error was returned. This may occur if the repository is corrupted. *** ERROR: SECURITY CHECK FAILED SEE HELP ON LIBRARY COMMAND *** The security check failed either because you do not have the required form-definition security to perform the library command you specified or you cannot access your password file. *** ERROR: SPECIFIED FILE IS NOT A PROGRAM FILE *** The file name you specified is not a program file. It may be a data file. *** ERROR: SPECIFIED FILE IS NOT CATALOGUED *** The file you specified as an omnibus file is not cataloged. FORMGEN catalogues files only during the save (SAV) library command, or for print and generate working-storage output. A

277 FORMGEN Messages *** ERROR: SPECIFIED FILE NOT CATALOGUED ATTEMPTED CATALOGUE FAILED *** FORMGEN could not catalog the file during the save (SAV) library command, or during the print or generate working storage functions. *** ERROR: SPECIFIED FILE IS READ INHIBITED *** FORMGEN attempted to read from a read-inhibited file during the OLD library command, during a print, or during generate working storage functions. *** ERROR: SPECIFIED FILE IS WRITE INHIBITED *** FORMGEN attempted to write to a write-inhibited file during the save (SAV) library command, during a print, or during generate working storage functions. *** ERROR: SPECIFIED FORM DOES NOT EXIST IN LIBRARY *** The form you tried to generate working storage for does not exist in the specified form library (not an omnibus file). *** ERROR: SPECIFIED OMNIBUS ELEMENT NOT FOUND *** You attempted to generate working storage for an omnibus program element that does not exist. *** ERROR: SPECIFIED PROGRAM FILE IS NOT CATALOGUED *** You attempted to generate working storage for an omnibus program file that does not exist. However, you may execute the save (SAV) library command on this file and FORMGEN will catalog it for you. *** ERROR: SPECIFY OMNIBUS FILE NAME ONLY IF FILE TYPE IS "O" *** You entered a value in the omnibus file name field, but the file is a form library file (F). Either change the file type to O or delete the omnibus file name. *** ERROR: THE REPOSITORY IS NOT INSTALLED ON THIS SYSTEM *** DPS 2200 is configured to use the repository, however, the repository is not installed on the system. *** ERROR: THE REPOSITORY IS NOT INSTALLED ON THIS SYSTEM *** DPS 2200 is configured to use the repository, however, the repository is not installed on the system. *** ERROR: UNABLE TO ASSIGN SPECIFIED FORM LIBRARY *** The specified form library cannot be accessed because it is assigned to another run or it is not loaded A 55

278 FORMGEN Messages *** ERROR: UNKNOWN FILE TYPE ENTER F OR O *** You entered a value in the file type field that is not a valid choice. *** ERROR: UNKNOWN INITIAL VALUES SPECIFICATION ENTER Y OR N *** You entered a value in the initial values field of the working-storage function that is not a valid choice. *** ERROR: UNKNOWN LANGUAGE TYPE ENTER COB, FOR, FTN, UC, OR UCOB*** You entered a value for language type in the working-storage function that is not a valid choice. *** ERROR: UNKNOWN OUTPUT TYPE VALUE -- ENTER F OR R *** You entered a value for in the output type field that is not a valid choice. *** ERROR: UNKNOWN PREFIX INDICATOR ENTER Y OR N *** You entered a value in the prefix field of the working-storage menu that is not a valid choice. *** ERROR: UNKNOWN REDEFINITION SPECIFICATION - ENTER Y OR N *** You entered a value in the redefinition field of the working-storage menu that is not a valid choice. *** ERROR: UNKNOWN STORAGE TYPE SPECIFICATION -- ENTER D OR T *** You entered a value in the data type field of the working-storage menu that is not a valid choice. *** ERROR: UNKNOWN WORKSPACE VALUE ENTER Y OR N *** You entered a value in the workspace field that is not a valid choice. *** ERROR: WRONG FILE TYPE FOR SPECIFIED FILE *** You attempted to reference a file that is not a disk file. An equipment code was returned indicating that the file type is some other type, such as a tape file. *** ERROR: W/S SAVED IN THE REPOSITORY MUST HAVE INITIAL VALUES *** DPS 2200 does not support working storage saved in the repository without initial values. A

279 FORMGEN Messages A.26. Execute Menu (X) Error Messages ***ERROR: VALUE CHECK SPECIFIED, BUT NO TABLE NAME FOUND IN UREP*** DPS 2200 found a corrupted link in the repository when validating the initial value for a field with the VC=T attribute set. ***ERROR: VALUE CHECK SPECIFIED, BUT NO VC RANGE FOUND IN UREP*** DPS 2200 was unable to find the required range values in the repository to validate the input value for a field with the VC=R attribute set. ***ERROR: VALUE CHECK SPECIFIED, BUT NO VC TABLE FOUND IN UREP*** DPS 2200 was unable to find the required table in the repository to validate the input value for a field with the VC=T attribute set. ***ERROR: VALUE CHECK SPECIFIED, BUT NO VC LINK FOUND IN UREP*** DPS 2200 was unable to find the required link in the repository to validate the input value for a field with the VC=T or VC=R attribute set. ***ERROR: VALUE CHECK SPECIFIED, BUT UREP ACCESS FAILED*** DPS 2200 found a corrupted link in the repository to validate the initial value for a field with the VC=T or VC=R attribute set. A.27. Internal Error Messages The following internal errors will not normally occur unless an error occurs internally in FORMGEN or DPS If they occur, the errors are returned from DPS 2200 run-time functions. The message contains the name of the function from which the error was returned (FUNCTION: ). You have no control over these errors. *** INTERNAL ERROR: AUTO-SAVE FILE IS NOT LARGE ENOUGH *** An error occurred while attempting to perform an auto save. The size of the autorecovery file was not large enough. The definition of your form should not be corrupted. Exit FORMGEN normally and reenter. *** INTERNAL ERROR: BAD FORM DESCRIPTION ADDRESS ON OPENSCREEN *** FORMGEN called the D$OPEN function, but the function returned an error indicating the working-storage address does not contain a valid form number. *** INTERNAL ERROR: BAD RETURN FROM FREE OF FILE FUNCTION: *** An error was returned by the specified function while DPS 2200 was attempting to free one of its internal files. This could be the demand terminal file, password file, or the FORMGEN menu library (FISENG) A 57

280 FORMGEN Messages *** INTERNAL ERROR: BAD RETURN FROM SAR$ OPEN FUNCTION: *** The SAR$ routines used to write to print files/elements and to generate working-storage files/elements returned an error during the open function. *** INTERNAL ERROR: BAD RETURN FROM USE OF FILE FUNCTION: *** DPS 2200 returned an error while attempting to perform of one of its files. This could be the demand terminal file or the SCREEN$FILE internal name attached to the FORMGEN menu library. *** INTERNAL ERROR: CANNOT SPECIFY INITIAL VALUES WITH BASED STORAGE TYPE *** The D$DEFGENWS function returned an error indicating that FORMGEN attempted to illegally specify BASED storage type. *** INTERNAL ERROR: CHECK NUMBER FAILED RECOMPILATION REQUIRED *** The D$OPEN function returned this error, even though FORMGEN should always specify NO to check number validate when opening a menu. *** INTERNAL ERROR: CURSOR NAME NOT ALLOWED FUNCTION: *** The D$SEND function returned this error, indicating that the name specified for the final cursor position is not a valid input/output field name. *** INTERNAL ERROR: DBANK CANNOT BE ALLOCATED FUNCTION: *** The DPS 2200 interface or initialization routines returned this error indicating that it could not allocate one or more DPS memory blocks. *** INTERNAL ERROR: DELETE LIST IS CORRUPTED *** The internal linked list used by the layout function to mark deleted image/fields has been corrupted. You have no control over this. *** INTERNAL ERROR: DEMAND TERMINAL FILE CANNOT BE ASSIGNED *** The D$INIT1 function returned this error indicating that it could not assign the demand terminal file. *** INTERNAL ERROR: DID NOT INITIALIZE WITH DPS FUNCTION: *** DPS 2200 returned this error, indicating that FORMGEN attempted to call the specified function before it is called in the D$INIT1 function. *** INTERNAL ERROR: DPS-ATTR-BUFF OVERFLOWED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that the internal buffer used to contain the attributes overflowed. A

281 FORMGEN Messages *** INTERNAL ERROR: DPS-ATTR-TABLE OVERFLOWED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that the internal buffer once contained the attributes that overflowed. *** INTERNAL ERROR: DPS FUNCTION IS NOT ALLOWED FUNCTION: *** DPS 2200 returned this error indicating that the specified function cannot be called by FORMGEN. *** INTERNAL ERROR: DUPLICATE DECIMAL SCALE ATTR FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error indicating that the decimal-scale attribute was entered twice in the DPS-ATTR-TABLE. *** INTERNAL ERROR: DUPLICATE LINK IMAGE NAME SPECIFIED *** The DPS 2200 D$DEF routines (D$DEFIMGCRE or D$DEFIMGMOD) returned this error indicating that a reference (link) name was passed twice. *** INTERNAL ERROR: D$DEF ERROR STACK OVERFLOWED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error indicating that more than 20 errors and warnings have occurred and that the internal error stack has overflowed. *** INTERNAL ERROR: D$DEFFRMCRE/D$DEFLOAD REQUIRED FUNCTION: *** FORMGEN attempted to call the specified DPS 2200 D$DEF function before it created the form with either D$DEFFRMCRE or D$DEFLOAD. *** INTERNAL ERROR: EMPHASIS-IN-TEXT IS NOT CONFIGURED *** FORMGEN attempted to call the D$DEF routines with emphasis-in-text attributes, even though this configuration parameter is not set for your DPS 2200 system. *** INTERNAL ERROR: END-OF-FILE RETURNED BY EXEC ON AN INPUT REQUEST *** The D$READ function detected on input. *** INTERNAL ERROR: ERROR CODE NOT WITHIN RANGE FUNCTION: *** The D$RETURNERR function attempted to retrieve an error code which is not within the defined range of errors or warnings. *** INTERNAL ERROR: ERROR LINE FIELD CANNOT SPAN LINES *** The ERRL, HDRL, and ERHD system-supplied fields cannot span line boundaries A 59

282 FORMGEN Messages *** INTERNAL ERROR: ERROR RETURNED FROM PUT_FIELD SUBROUTINE *** An internal subroutine called put_field returned an error that is beyond your control. *** INTERNAL ERROR: ERROR RETURNED FROM RETURN_FIELD SUBROUTINE *** An internal subroutine called return_field returned an error that is beyond your control. *** INTERNAL ERROR: ERROR TYPE RETRIEVED ILLEGAL FUNCTION: *** The D$RETURNERR function attempted to retrieve an error code for which the type did not match the FATAL (F) or WARNING (W) defined status. *** INTERNAL ERROR: FIELD CAN ONLY BE INSERTED ON 1ST VRP OCCURRENCE *** You may only add fields to the line(s) of the first occurrence of a repeat. The occurrences that are not first may only contain literals (text) that are different from the first occurrence. *** INTERNAL ERROR: FIELD MUST BE INSERTED ON 1ST HRP OCCURRENCE *** You may only add fields to the line(s) of the first occurrence of a repeat. The occurrences that are not first may only contain literals (text) that are different from the first occurrence. *** INTERNAL ERROR: FIELD HAS REPLENISH INITIAL VALUE NOT ALLOWED *** The DPS 2200 D$DEF routines returned this error, indicating that the replenish attribute and initial-value attribute are mutually exclusive. These attributes are no longer mutually exclusive. *** INTERNAL ERROR: FILE WAS CATALOGUED BY FORMGEN *** The DPS 2200 D$DEF routines return this error when they catalogue a file for an omnibus file, print function, or generate working-storage function. FORMGEN should ignore this error. *** INTERNAL ERROR: FI$MNA/SM$ADR CORRUPTED -- FORM IS LOADED *** The DPS 2200 D$DEFLOAD function returned this error, indicating that the specified form definition is corrupted. However, the form was loaded and you may use the L2 function to redefine it. You cannot use the save (SAV) or replace (REP) library command. This function displays the template with text only. All image and field characters are removed. A

283 FORMGEN Messages *** INTERNAL ERROR: FI$MNA/SM$ADR CORRUPTED -- FUNCTION NOT PERFORMED *** After executing the OLD library command on a previously defined corrupted form, you attempted to perform a select function other than L2. Because FORMGEN will not allow you to save, replace, or modify a form definition that is corrupted in this manner, this error message is returned. The form may be redefined using the L2 select function, which displays the template only with text. All image and field characters are removed and must be reentered. *** INTERNAL ERROR: FORM HAS MORE THAN SCRFIELDS FUNCTION: *** The specified DPS 2200 function returned this error, indicating that the form has more fields than specified in the SCRFIELDS build parameter. *** INTERNAL ERROR: FORM LIBRARY CANNOT BE FREED FUNCTION: *** The specified DPS 2200 function returned this error while attempting to do of a form library. *** INTERNAL ERROR: FORM NAME DEFAULTED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that the form name defaulted. FORMGEN should ignore this error. *** INTERNAL ERROR: FORM WILL BE OVERWRITTEN FUNCTION: *** The DPS 2200 D$DEFSAVE function returned this error, indicating that the form to save already exists in the form library. FORMGEN should never receive this error. *** INTERNAL ERROR: FORMGEN MENU DOES NOT EXIST *** The D$OPEN function returned this error, indicating that the menu for the requested function does not exist. This may indicate that FORMGEN did not install correctly, or that this menu was deleted from the FORMGEN menu library (FISENG). *** INTERNAL ERROR: FRAME ON SEND OR SCREENGET IS NO LONGER AVAILABLE *** The DPS 2200 D$SEND or D$READ function returned this error, indicating that the form specified by FORMGEN is no longer open. *** INTERNAL ERROR: FUNCTION CALLED WITH TOO MANY ARGUMENTS *** DPS 2200 returned this error, indicating that the specified function was called with more than the required number or arguments. *** INTERNAL ERROR: FUNCTION NOT IMPLEMENTED FUNCTION: *** DPS 2200 returned this error, indicating that the specified function has not yet been implemented A 61

284 FORMGEN Messages *** INTERNAL ERROR: GEN STORAGE ATTRIBUTE REQUIRED FUNCTION: *** FORMGEN called the D$DEFFRMCRE function without specifying a required attribute and value. *** INTERNAL ERROR: GEN$BASE FOUND BAD FIELD TYPE FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an invalid field type was found while generating the frame or base screen. *** INTERNAL ERROR: HORIZ REPEAT MUST BE VPOS FUNCTION: *** FORMGEN specified a repeat image with fixed positioning. This attribute is not supported with repeats. *** INTERNAL ERROR: ILLEGAL CALLING SEQUENCE FUNCTION: *** DPS 2200 returned this error for the specified function, indicating that FORMGEN called a function with an invalid calling sequence. *** INTERNAL ERROR: ILLEGAL CONTROL CHARACTERS FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an invalid value was received for the control characters attribute. *** INTERNAL ERROR: ILLEGAL ERROR TABLE LENGTH FUNCTION: *** FORMGEN supplied a length that was 0 or negative in the error-msg-table packet for table length. *** INTERNAL ERROR: ILLEGAL FORM HEIGHT FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an out-of-range value was specified for the form height. *** INTERNAL ERROR: ILLEGAL TYPE FOR REPEAT MODIFY FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that FORMGEN passed an illegal value for the image type while modifying a repeat. *** INTERNAL ERROR: ILLEGAL USE OF VARIABLE POSITIONING SPECIFIED *** The DPS 2200 D$DEF routines returned this error, indicating that FORMGEN passed an invalid combination of variable row/column attribute values. *** INTERNAL ERROR: ILLEGAL VALUE SPECIFIED FOR REPEAT WIDTH *** The DPS 2200 D$DEF routines returned this error, indicating that FORMGEN specified an out-of-range value for the width of a repeat. A

285 FORMGEN Messages *** INTERNAL ERROR: IMAGE LINKED TO CANNOT BE A LINKED IMAGE *** The DPS 2200 D$DEF routines returned this error, indicating that FORMGEN attempted to link an image to another linked image. *** INTERNAL ERROR: IMAGE LIST IS CORRUPTED *** The internal image list containing all images/fields in your form, used by the layout function is corrupted. This error is beyond your control. *** INTERNAL ERROR: IMAGE NAME DEFAULTED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an image name defaulted (blanks were specified). FORMGEN should ignore this error. *** INTERNAL ERROR: IMAGE NOT WITHIN INSIDE IMAGE FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that the name specified in the DPS-NAMES table are not in the correct order. *** INTERNAL ERROR: IMAGE OR FIELD OVERWRITES NON-BLANK CONSTANT TEXT *** You inserted nonblank text over a field or image in your template and FORMGEN did not mask out this error correctly. *** INTERNAL ERROR: IMAGE OR FIELD OVERWRITES NON-BLANK EMPHASIS TEXT *** You inserted nonblank emphasis text over a field or image in your template and FORMGEN did not mask out this error correctly. *** INTERNAL ERROR: IMAGE SPECIFIED NOT FOUND FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an image name could not be found in the form definition. *** INTERNAL ERROR: IMAGE TYPE NOT NORMAL/LINKED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that FORMGEN specified an illegal value for the image type attribute. *** INTERNAL ERROR: IMAGES ARE IMPROPERLY NESTED *** The ON/OFF images in the layout function were specified by FORMGEN so that they are improperly nested. This was diagnosed by the D$DEF routines. *** INTERNAL ERROR: IMPROPER CONFIG FOR OPERATION FUNCTION: *** The specified DPS 2200 function returned this error, indicating that your configuration does not allow the specified function to be called A 63

286 FORMGEN Messages *** INTERNAL ERROR: INDEX MUST BE POSITIVE INTEGER FUNCTION: *** DPS 2200 returned this error, indicating that the specified function passed a negative value for an index. *** INTERNAL ERROR: INDEX NAME DEFAULTED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an index name defaulted (blanks were specified). FORMGEN should ignore this error. *** INTERNAL ERROR: INITIALIZED TWICE WITH DPS FUNCTION: *** The D$INIT1 function returned this error, indicating that this function was called twice with no D$CLOSE call between the calls. *** INTERNAL ERROR: INITIAL VALUE TRUNCATED FUNCTION: *** FORMGEN passed an initial value to the D$DEFFLDMOD function that is longer than the length of the field. *** INTERNAL ERROR: INPUT ENTERED IS TOO LARGE *** The D$READ function returned this error, indicating that the input from the terminal is too large to fit in the internal input/output buffer. *** INTERNAL ERROR: INSERT LIST IS CORRUPTED *** The internal linked list used by the layout function to mark inserted images/fields is corrupted. This error is beyond your control. *** INTERNAL ERROR: INTERNAL DPS ERROR. ERROR CODE: FUNCTION *** An internal error occurred when FORMGEN called a DPS 2200 function. This error is beyond your control. *** INTERNAL ERROR: INTERNAL DPS ERROR OCCURRED FUNCTION: *** DPS 2200 returned this error for the specified function, indicating that a nonspecific internal error occurred. *** INTERNAL ERROR: INTERNAL D$DEF ERROR OCCURRED FUNCTION: *** A DPS 2200 D$DEF routine returned this error for the specified function, indicating that a nonspecific internal error occurred. *** INTERNAL ERROR: INVALID CHAR IN INITIAL VALUE FUNCTION: *** The DPS 2200 D$DEFFLDMOD function returned this error, indicating that a nonalphabetic character was found in the initial value for an alphabetic field. A

287 FORMGEN Messages *** INTERNAL ERROR: INVALID CONFIG PARAMETER PASSED TO D$CONFIGSET *** The D$CONFIGSET function returned this error, indicating that FORMGEN called this function with an invalid parameter. *** INTERNAL ERROR: INVALID OPTION PASSED FUNCTION: *** The specified DPS 2200 function detected an invalid option specified in the DPS-OPTIONS parameter. *** INTERNAL ERROR: INVALID OPTION PASSED TO DPS FUNCTION -- FUNCTION: *** DPS 2200 returned this error, indicating that an invalid option was passed to the specified function. *** INTERNAL ERROR: I/O ERROR ON TERMINAL FILE FUNCTION: *** The specified DPS 2200 function returned this error because it could not read or write the terminal file. *** INTERNAL ERROR: LINK NAME DEFAULTED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that a reference (link) name defaulted. FORMGEN should ignore this error. *** INTERNAL ERROR: MAXIMUM WIDTH VALUE MUST BE GREATER THAN ZERO *** A DPS 2200 D$DEF routine returned this error, indicating that FORMGEN passed a value for the maximum width (MWID) attribute that is less than zero. *** INTERNAL ERROR: MENU DOES NOT MATCH CONFIG FUNCTION: *** DPS 2200 returned this error, indicating that one of the FORMGEN menus is incompatible with your configuration. *** INTERNAL ERROR: MODIFY LIST IS CORRUPTED *** The internal linked list used by the layout function to mark modified images/fields is corrupted. This error is beyond your control. *** INTERNAL ERROR: MORE THAN 10 NESTED ON/OFF IMAGES SPECIFIED *** A DPS 2200 D$DEF routine returned this error, indicating that the FORMGEN layout function attempted to define more than the maximum allowed number of nested ON/OFF images. *** INTERNAL ERROR: MULTIPLE ERRORS OCCURRED FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that the function had more than one error. This error should be ignored by FORMGEN A 65

288 FORMGEN Messages *** INTERNAL ERROR: MUTUALLY-EXCLUSIVE CTRL CHAR FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that the control character attribute specified mutually exclusive values. *** INTERNAL ERROR: NO AUTO-SAVE HAS BEEN PERFORMED UNDO NOT POSSIBLE *** FORMGEN attempted to revert to the most recent auto save, but failed due to an internal error beyond your control. Your workspace should not be corrupted. *** INTERNAL ERROR: NO FIELD ERRORS BUT REQUEST FOR ERROR MESSAGE *** DPS 2200 returned this error, indicating that FORMGEN requested an error message when none is available. *** INTERNAL ERROR: NO HELP AVAILABLE FOR THIS FIELD *** You requested help on a particular field for which no help is available. This error may be beyond your control. *** INTERNAL ERROR: NO HELP AVAILABLE FOR THIS FUNCTION *** You requested help from one of the FORMGEN menus for which no help is available. This error may be beyond your control. *** INTERNAL ERROR: NO MESSAGE AVAILABLE FOR ERROR CODE: *** FORMGEN attempted to display an error message, but there is no message for the error code in the ISC/MCON element. This error may be beyond your control. *** INTERNAL ERROR: NO OUTPUT SENT BUT READ FUNCTION REQUESTED *** The D$READ function returned this error, indicating that FORMGEN attempted to read a menu before it was displayed on the terminal. *** INTERNAL ERROR: NO SUCH FUNCTION AVAILABLE FUNCTION: *** DPS 2200 returned this error, indicating that the specified function cannot be called because it does not exist. *** INTERNAL ERROR: NO WORKING STORAGE AVAILABLE FUNCTION: *** The DPS 2200 D$GETWSDEF function returned this error, indicating that FORMGEN called this function for a field or image that does not have any working storage. *** INTERNAL ERROR: OMNIBUS FILE NAME DEFAULTED *** The specified DPS 2200 D$DEF routine returned this error, indicating that an omnibus file defaulted (blanks were specified). FORMGEN should ignore this error. A

289 FORMGEN Messages *** INTERNAL ERROR: ONLY TERM FUNCTIONS ALLOWED FUNCTION: *** DPS 2200 returned this error, indicating that FORMGEN may only call D$CLOSE or D$TERM because it was not initialized with DPS. *** INTERNAL ERROR: OUTPUT FUNCTION DESTROYED THE INPUT *** DPS 2200 returned this error, indicating that a free-format output function (for example, D$PTSCN) has been called so that the input is no longer available. *** INTERNAL ERROR: PRINT OUTPUT FILE NAME DEFAULTED *** The specified DPS 2200 D$DEF routine returned this error, indicating that a file name defaulted (blanks were specified). FORMGEN should ignore this error. *** INTERNAL ERROR: READ OF WRONG MENU MENU WAS NEVER SENT *** The D$READ function returned this error, indicating that FORMGEN attempted to call this function with a form number that is not equal to the one specified on the D$OPEN call. *** INTERNAL ERROR: READ/SEND FUNCTION WAS PERFORMED WITHOUT OPEN *** The D$READ or D$SEND function returned this error, indicating that FORMGEN attempted to call this function before calling the D$OPEN function. *** INTERNAL ERROR: SAR$ ERROR OCCURRED -- SAR$ STATUS: *** The SAR$ routines used to write to print files/elements, to generate working-storage files/elements, and to write omnibus elements returned an error. *** INTERNAL ERROR: SAR$ INSERT ERROR FUNCTION: *** The specified DPS 2200 D$DEF routine returned this error, indicating that an error was returned from one of the SAR$ routines used to write data into omnibus, print and working-storage elements. *** INTERNAL ERROR: SEND FUNCTION WAS PERFORMED WITHOUT OPEN *** The D$SEND function returned this error, indicating that FORMGEN attempted to call this function before calling D$OPEN. *** INTERNAL ERROR: STORAGE SOURCE ATTR REQUIRED FUNCTION: *** The D$DEFFRMCRE function returned this error, indicating that a required attribute identifier and value are missing A 67

290 FORMGEN Messages *** INTERNAL ERROR: SYSTEM SUPPLIED FIELDS MUST BE VARIABLE POSITION *** The DPS 2200 D$DEF routines returned this error, indicating that FORMGEN has not specified variable positioning for a system-supplied field. Fixed positioning is not supported. *** INTERNAL ERROR: THE FUNCTION DOES NOT EXIST IN THE CONFIGURATION *** DPS 2200 returned this error, indicating that FORMGEN called a function that is not valid for your configuration. For example, FORMGEN may call an MCB function, but EXECFILES is on, which condition returns this error. *** INTERNAL ERROR: STATEMENT FOR FORM LIBRARY WAS REJECTED *** The DPS 2200 D$DEF routines returned this error, indicating that they could not perform function. *** INTERNAL ERROR: UNABLE TO SAVE INTO AUTO-SAVE FILE *** FORMGEN attempted to perform an auto save, but an error occurred while writing into the autorecovery file. This error is beyond your control. The form definition may be internally corrupted. A.28. Error Messages Caused by Invalid Attribute Identifiers and Values The following error messages are returned for the specified DPS 2200 D$DEF routines (FUNCTION: ) when FORMGEN passes an invalid attribute or value (FORMGEN should never pass an illegal value because it diagnoses invalid attribute syntax before calling the D$DEF routines): *** INTERNAL ERROR: UNKNOWN ATTRIBUTE VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN BACKGROUND COLOR FUNCTION: *** *** INTERNAL ERROR: UNKNOWN CHECKNUMBER TEST VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN CONV MODE VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN EMPHASIS VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN FIELD-LEVEL ATTRIBUTE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN FIELD TYPE SPECIFIED FUNCTION: *** *** INTERNAL ERROR: UNKNOWN FONT ATTRIBUTE VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN FOREGROUND INTENSITY FUNCTION: *** *** INTERNAL ERROR: UNKNOWN FORM-LEVEL ATTRIBUTE FUNCTION: *** A

291 FORMGEN Messages *** INTERNAL ERROR: UNKNOWN FORM-LEVEL ATTR VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN FUNCTION KEY SPECIFIED FUNCTION: *** *** INTERNAL ERROR: UNKNOWN IMAGE-LEVEL ATTRIBUTE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN IMAGE-LEVEL ATTR VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN INITIAL VALUES SPEC FUNCTION: *** *** INTERNAL ERROR: UNKNOWN LANGUAGE TYPE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN OUTPUT TYPE VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN PREFIX INDICATOR FUNCTION: *** *** INTERNAL ERROR: UNKNOWN REDEFINITION SPEC FUNCTION: *** *** INTERNAL ERROR: UNKNOWN SECFAIL VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN SECURITY LEVEL FUNCTION: *** *** INTERNAL ERROR: UNKNOWN SECURITY TYPE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN STORAGE SOURCE VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN TEST MODE VALUE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN VALUE FOR GEN STORAGE FUNCTION: *** *** INTERNAL ERROR: UNKNOWN VALUE FOR HIGHLIGHT FUNCTION: *** *** INTERNAL ERROR: UNKNOWN VALUE FOR INTENSITY FUNCTION: *** *** INTERNAL ERROR: UNKNOWN VALUE FOR PREFIX FUNCTION: *** *** INTERNAL ERROR: UNKNOWN W/S DATA TYPE FUNCTION: *** *** INTERNAL ERROR: UNRECOGNIZED ATTRIBUTE FUNCTION: *** *** INTERNAL ERROR: VERTICAL REPEAT NOT IN COL 1 FUNCTION: *** FORMGEN passed a starting column value to the specified function so that a vertical repeat will not begin in the first column. *** INTERNAL ERROR: VERT REPS NOT FIXED COL/VAR ROW FUNCTION: *** FORMGEN passed either variable column = YES, or variable row = NO to the specified D$DEF routine. This is not allowed for repeats A 69

292 FORMGEN Messages *** INTERNAL ERROR: WORKING STORAGE FILE DEFAULTED FUNCTION: *** The D$DEFGENWS function returned this error, indicating that the file used to contain working storage defaulted. FORMGEN should ignore this error. *** INTERNAL ERROR: WRONG FORM NUMBER ON OPENSCREEN OF FORMGEN MENU *** The D$OPEN function returned this error, indicating that FORMGEN passed a nonexistent form number to the function. *** INTERNAL ERROR: WRONG NUMBER ARGUMENTS TO DPS FUNCTION: *** A DPS 2200 function returned this error, indicating that FORMGEN passed the incorrect number of parameters to a function. A

293 Appendix B FDLP Messages This appendix lists the error and warning messages generated by FLDP. A brief explanation follows each message. If an error occurs when DPS 2200 is accessing UREP, the file DPS$DDABORT is created. This file contains the repository error messages returned by UREP. Multiple cycles of this file may exist. END FLDP. ERRORS WARNINGS. Your form definition has been completed and the new form written into the specified form library (screen file) or omnibus file. END FLDP. ERRORS WARNINGS NO FORM PRODUCED. An error occurred that has inhibited FLDP from completing your form definition. No form is written into the form library or omnibus file. *ERROR Allow query not allowed in output-only field. Allow query attribute ignored. You cannot define the allow query attribute for an output-only field. *ERROR An error was detected while creating an entity in the repository. While saving the form definition in the repository, an error occurred. *ERROR An error was detected while deleting an entity from the repository. While removing a form definition from the repository, an error occurred. *ERROR An error was detected while omitting changes made to the repository. While committing changes made to the repository, an error was detected. *ERROR An error was detected while retrieving an entity from the repository. While retrieving an entity from the repository, an error occurred B 1

294 FDLP Messages *ERROR An error was detected while retrieving the name of an entity from the repository. While retrieving the name of an entity saved in the repository, an error was detected. *ERROR An error was returned from the repository initialize routine. An error occurred while initializing the interface to the repository. *ERROR An error was returned from the repository terminate routine. While terminating the interface to the repository, an error occurred. Updates to the repository have been committed. *ERROR An I/O error occurred on SAR$ output. This message indicates an internal error. SAR$ returned an error when activating the output. *ERROR Assign error on screen file. Form definition is not saved. FLDP was unable to assign the specified screen file (form library). The file may be unloaded, assigned to another run, or disabled. *ERROR Attempt to link image to non-image. Image definition is ignored. If the image type is link, then the reference (link) name must specify a nonlinked ON/OFF image. You cannot specify another linked image, a repeat, or a field name. *ERROR Attempt to link image to an image that is already linked to. Image definition is ignored. You attempted to specify a link image type for an ON/OFF image that the image is already linked to. You must first specify a different reference name for all images that are linked to this image. *ERROR Attempt to link image to another linked image. Image definition is igsnored. If the image type is link, then the reference (link) name must specify a nonlinked ON/OFF image. You cannot specify another linked image, a repeat, or a field name. *ERROR Attempt to define more than one form per FLDP call. Only the first form defined is saved. Subsequent forms are ignored. There may be only one each of the FORM and END_FORM commands in the runstream. You specified more than one FORM command. The second FORM command is ignored as well as all following source statements. B

295 FDLP Messages *ERROR Attempted to write over existing form definition but you do not have update authority. Form definition is not saved. You must have screen definition update authority to overwrite an existing form in a screen file (form library). *ERROR ATTRIBUTE VC not allowed for output-only field. You cannot define the VC attribute for an output-only field. *ERROR ATTRIBUTE VC NOT ALLOWED ON FORM 0. You cannot define the VC attribute for FORM 0. *ERROR Attribute is not valid for a field definition. Attribute ignored. You specified a parameter that is not valid during field definition. *ERROR Attribute is not valid for a form definition. Attribute ignored. You specified a parameter that is not valid during form definition. *ERROR Attribute is not valid for an image definition. Attribute ignored. You specified a parameter that is not valid during image definition. of DPS internal name failed. This message indicates an internal error. of the omnibus file failed for unknown reasons. of DPS internal name failed. This message indicates an internal error. of the DPS 2200 internal name of the omnibus file failed. *ERROR Bad blank input attribute value. Attribute is ignored. You specified an invalid choice on the INPUT_ATTRIBUTES BLANK_INPUT= statement. The default value is taken. *ERROR Bad blank when zero attribute value. Attribute is ignored. This is an internal error that is beyond your control. An illegal value was detected for the BLANK_WHEN_ZERO attribute B 3

296 FDLP Messages *ERROR Bad data entry attribute value. Attribute is ignored. You specified an invalid choice on the INPUT_ATTRIBUTES DATA_ENTRY= statement. The default value is taken. *ERROR Bad display positive sign attribute value. Attribute is ignored. This is an internal error that is beyond your control. An illegal value was detected for the DISPLAY_POSITIVE attribute. *ERROR Bad generate storage type value. Attribute is ignored. You specified an invalid choice on the STORAGE GENERATE_TYPE= statement. The only valid choice for this statement is FCA. The default value is taken. *ERROR Bad insert delimiter attribute value. Attribute is ignored. This is an internal error that is beyond your control. An illegal value was detected for the INSERT_DELIMITERS attribute. *ERROR Bad leading zero attribute value. Attribute is ignored. This is an internal error that is beyond your control. An illegal value was detected for the MONETARY_SIGN=LEADING attribute. *ERROR Bad monetary sign attribute value. Attribute is ignored. You specified an invalid choice on the GENERAL_EDIT MONETARY_SIGN= statement. The default value is taken. *ERROR Bad numeric sign attribute value. Attribute is ignored. You specified an invalid choice on the GENERAL_EDIT SIGN= statement. The default value is taken. *ERROR Bad read of template data. An error was returned from the internal routine that reads the template. This error is beyond your control. *ERROR Bad read on input file. FLDP cannot read the source input file specified on the processor call line. *ERROR Bad replenish character attribute value. Attribute is ignored. You specified an illegal character on the PREDEFINED_VALUE REPLENISH_STRING= statement. B

297 FDLP Messages *ERROR Bad system value specified. Field definition is ignored. The system value used to specify a system-supplied field is not a valid choice. *ERROR Can not change image type when modifying repeated image. Image modification not completed. You attempted to modify a vertical or horizontal image and change its type. *ERROR Can not default REFERENCE NAME, no previous image to link to. You allowed the reference (link) name for your linked ON/OFF image to default, but there is no previous nonlinked ON/OFF image to link to. *ERROR Character encountered between column 1 and START_IMAGE. The START_IMAGE character in the template for a repeat image is not in column 1. A character, other than a blank, was detected before the START_IMAGE character. *ERROR Delimiter and decimal point are mutually exclusive. The values specified on the EDIT_SYMBOL COMMA= DECIMAL_POINT= statement contain the same values. The default values are taken. *ERROR DPS-FORM entity not found in the repository. A DPS-FORM entity could not be found in the repository for the form name specified on the FORM command. *ERROR DPS-FORM-LIBRARY entity not found in the repository. A DPS-FORM-LIBRARY entity could not be found in the repository for the form library name specified on the call line. *ERROR DPS INITIALIZE FAILED, STATUS CODE*:. A fatal error was returned from the internal FLDP call to the DPS 2200 D$LINIT1 function. The status code displayed with the message is a DPS 2200 error code that is explained in the DPS 2200 Run-Time Programming Reference Manual. *ERROR Duplicate Error line field. Field definition ignored. You attempted to redefine the error line system-supplied field. The current field is not defined. *ERROR Duplicate Header line field. Field definition ignored. You attempted to redefine the header line system-supplied field. The current field is not defined B 5

298 FDLP Messages *ERROR Entity must be contained in first occurrence of the horizontal repeat. Entity definition not completed. You attempted to insert an entity inside a horizontal repeat that is not in the first occurrence of the horizontal repeat. *ERROR Entity not found in the repository. While attempting to save a form definition in the repository, an entity could not be found. *ERROR Entity position causes overlap. Entity definition ignored. You defined a start position for an entity that causes the entity to overlap text or another entity. *ERROR Entity positioned outside of form or image dimensions. Entity definition ignored. The entity is positioned relative to the origin, but it is outside the image because of incorrect horizontal placement. *ERROR Error table length supplied is 0 or negative. You specified an error table length that was 0 or negative. The error table length must be greater than 0. *ERROR Field must not span horizontal repeat occurrence. Entity definition not completed. You attempted to insert a horizontal repeat image or field that does not completely contain the field in the first occurrence of the repeat. *ERROR Field spanning lines not allowed within a repeat image. Field definition is ignored. You cannot define field spanning lines within a vertical repeat unless the image height (number of lines in the occurrence) will encompass the entire field or image. *ERROR Field string number does not have corresponding template string. The image or field string number you specified has no corresponding image or field in the template. *ERROR Field string number has been specified without a template. You must specify the TEMPLATE command in order to specify an image or field string number. B

299 FDLP Messages *ERROR Field string number is out of range of template strings. The image or field string number you specified is larger than the number of images and fields in the template. *ERROR Field table overflowed. Too many entities were defined. Subsequent definitions beyond the maximum allowed are ignored. The internal field table overflowed because you defined more than the maximum configured number of images or fields for the specified screen file (form library). *ERROR Form definition has been completed. Subsequent definition statements and commands are ignored. This is similar to the previous message, except that you have not specified a second FORM command. *ERROR Form name has improper format. Form definition is ignored. An illegal character has been specified in the form name. The form name consists of the A through Z and 0 through 9 characters, and can be a maximum of 8 characters. *ERROR Form name required. Form definition not completed. You must specify a form name when you define a form. *ERROR Form number out of range. Form definition not completed. The specified form number is less than or equal to zero, or it is out of the maximum configured range for the specified form library. *ERROR Horizontal displacement for positioning of a repeat image must be 1. Image definition is not completed. Vertical repeats must begin in column 1. For the POSITION_IMAGE COLUMN= statement, you specified a value such that the column is greater than 1. *ERROR Horizontal repeat must be the first occurrence of a vertical repeat. Entity definition not completed. You attempted to insert a horizontal repeat that is not the first occurrence in the vertical repeat, inside the same vertical repeat. *ERROR Horizontal repeat will overflow right form boundary. Image definition not completed. You attempted to insert a horizontal repeat that spans lines B 7

300 FDLP Messages *ERROR Illegal character for SOE character. Attribute is ignored. The value you specified on the PREDEFINED_VALUE SOE_CHARACTER= statement is not a valid character for the start-of-entry (SOE) substitution character. This character cannot be alphabetic or an underscore ("_"). No default is taken. *ERROR Illegal character for START_IMAGE character. You specified an illegal character for the START_IMAGE attribute in the FORM or TEMPLATE command. The START_IMAGE character cannot be a masterspace. *ERROR Illegal character in name. Entity definition is ignored. An image, field, index, or reference (link) name may consist of the A through Z, 0 through 9, and hyphen characters. The first character must be alphabetic. *ERROR Illegal to insert entity inside repeat on line other than 1. Entity definition is not completed. You may insert images or fields within any line of a multiline vertical repeat, but you cannot insert them on any repeat occurrence except the first. The only entity types that can be inserted after the first occurrence are constants and emphasis-constants. *ERROR Illegal value for attribute specified. The choice you specified on the particular FLDP statement is not a valid choice. The default value is taken. *ERROR Image or field defined in horizontal repeat spacing. You cannot have an image or field defined within the spacing of a horizontal repeat. *ERROR Image string number does not have corresponding template string. The image or field string number you specified has no corresponding image or field in the template. *ERROR Image string number has been specified without a template. You must specify the TEMPLATE command in order to specify an image or field string number. *ERROR Image string number is out of range of template strings. The image or field string number you specified is larger than the number of images and fields in the template. B

301 FDLP Messages *ERROR Improper nesting of images. Image definition ignored. ON/OFF images must be completely contained within each other. If you start a new image within another ON/OFF image, you must end that new image within the same ON/OFF image. *ERROR Improper nesting repeat images. Image definition not completed. You improperly nested repeat images. *ERROR in command name syntax An unrecognized command was entered. A command must be one of the legal commands listed in Section 4 Form Language Definition Processor (FLDP). Following are examples of legal commands: FORM IMAGE FIELD GENERAL_EDIT OUTPUT_ATTRIBUTES STORAGE *ERROR Inconsistent use of second field character in template. You used the second field character incorrectly in the template. *ERROR Internal size of image of field is too small. Entity definition ignored. The attributes for a numeric field will cause the field to be smaller than specified. *ERROR Invalid coordinates for repeat image. Repeat image definition ignored. When defining a vertical repeat image, the Y coordinate cannot equal 0 or 24. *ERROR Invalid value specified for CCSNUM attribute. You attempted to set the CCSNUM attribute to a value that is not valid. *ERROR I/O error on Screen File. Form definition is not saved. A I/O error occurred on the screen file (form library). The file may be disabled, not catalogued, or corrupted B 9

302 FDLP Messages *ERROR - I18N library call returned an error. DPS 2200 detected an error during the call to one of the I18NLIB service routines. *ERROR Maximum number of strings in the template has been exceeded. String number ignored. The number of fields in the template is greater than the SCRFIELD. *ERROR More than 18 digits before decimal symbol. Field definition ignored. The number of digits defined for the DECIMAL_SCALE parameter results in more than 18 digits before the decimal symbol. *ERROR Name not allowed for entity type being defined. Specified name is ignored. You specified a name for a constant, system field, linked ON/OFF image, or a repeat. *ERROR No template has been found for defining the image/field. String number is ignored. You attempted to specify a string number on an IMAGE or FIELD command without a previous TEMPLATE command. The string number is ignored. *ERROR Number of digits after decimal symbol exceeds field length. Decimal scale attribute ignored. The value of the DECIMAL_SCALE parameter is greater than the field length. *ERROR Number of digits after decimal symbol exceeds 18. Field definition ignored. The attributes defined for the field result in more than 18 digits after the decimal symbol. *ERROR Number of fields and images defined exceeds configured maximum. You defined more fields and images than your DPS 2200 system is configured to contain per form (screen). *ERROR Number of START_IMAGE characters exceeds number of STOP_IMAGE characters in template. The number of start (ON) image characters specified in your template must equal the number of stop (OFF) image characters. B

303 FDLP Messages *ERROR Number of STOP_IMAGE characters exceeds number of START_IMAGE characters in template. The number of start (ON) image characters specified in your template must exactly equal the number of stop (OFF) image characters. *ERROR Numeric or Computational field too long. Field definition is ignored. Numeric or computational fields cannot have more than 18 digits on either side of the decimal point, and cannot exceed 26 digits in total length. *ERROR ON/OFF image must not span horizontal repeat occurrence. Entity definition not completed. You attempted to insert a horizontal repeat or an ON/OFF image that does not completely contain the field in the first occurrence of the repeat. *ERROR Optional test of the screen-header checknumber set to YES. Input option is ignored. This is an internal error. This error is returned if an illegal value is detected for the check-mode attribute in the D$DEF routines. *ERROR Position of field will result in back-to-back fields. Field definition ignored. Definition will result in back-to-back fields with no space between them. *ERROR Position of image template improperly specified. An IMAGE command was followed by a TEMPLATE command, but there were no position attributes specified for the image, or they were incorrect. *ERROR Reference to undefined entity [P3]. The specified entity was not defined after it was referenced. *ERROR Repeat count out of range. Repeat Image definition is ignored. The number of repeats specified on the repeat count parameter will cause the image to be repeated outside the dimensions of the form or image. The Repeat Image definition is ignored. *ERROR Repeat image ends within another repeat image. Image definition not completed. The repeat image overlaps into another repeat image because the repeat count is too large or because of incorrect positioning B 11

304 FDLP Messages *ERROR Repeat image will overlap text. Repeat image definition ignored. You tried to insert a repeat image on top of text. *ERROR Repeat of image spanning lines is not legal. Image definition is not completed. The repeat images must be the same width as the maximum width of the form. *ERROR Replenish character definition not allowed for entity being defined. Attribute is ignored. The PREDEFINED_VALUE REPLENISH_STRING= statement is valid only for fields. It is not valid for binary, system-supplied, constant, or emphasis-constant fields, however. The attribute value is ignored. *ERROR Repository deadlock encountered. While saving a form definition in the repository, a deadlock condition was encountered. *ERROR Right justification of field spanning line not supported. Justification attribute is ignored. You specified the GENERAL_EDIT JUSTIFICATION=RIGHT attribute for a field which spans lines. This is not supported in DPS The attribute is ignored. *ERROR Security fail action not valid for entity. Attribute is ignored. The SECURITY FAIL_ACTION statement is valid only for fields and at the form level. See Section 5 Form Language Manipulation Utility (FLMU) for a description of the legal values. The attribute is ignored. *ERROR Size of field exceeds maximum for defined field type. Field definition ignored. The field size specified is greater than the maximum for the defined field type. *ERROR Specified name is too long. Entity definition is ignored. A name can be 8 characters for form name, and 16 for image, field, index, and reference names. The image or field will not be defined. *ERROR Statement not valid for field definition. Statement ignored. You included the specified statement in a field definition, but the statement is not valid for fields. B

305 FDLP Messages *ERROR Statement not valid for form definition. Statement is ignored. The statement you specified is recognized as a valid statement, but is valid only at the image level, field level, or both. It is not valid at the form level. *ERROR Statement not valid for image definition. Statement is ignored. The statement you specified is a valid statement, but it is not valid for an image definition. It may be valid at either the form level or field level. *ERROR String number specified with template defined set to NO. String number ignored. You specified a string number when the TEMPLATE_DEFINED parameter is NO. *ERROR System field types Error and Error-header are exclusive. Field definition is not completed. These system-supplied field types cannot be specified at the same time within the same form. The current field is not defined. *ERROR System field types Error, Header and Error-header cannot span lines. Field definition is not completed. These system-supplied field types must be contained in one line. The field is not defined. *ERROR System field type Error-header can only be defined once. Error-header is exclusive of Error and Header type system fields. Field definition is not completed. You attempted to redefine the error-header system-supplied field by using error-header, error, or header. The current field is not defined. *ERROR System field types Header and Error-header are exclusive. Field definition is not completed. These system-supplied field types cannot be specified at the same time within the same form. The current field is not defined. *ERROR Tab stop not allowed for field starting in column 1. You defined a tab stop for a field starting in column 1. *ERROR Tab stop not allowed for protected fields. Tab attribute ignored. You defined a tab stop for a protected field B 13

306 FDLP Messages *ERROR Tab stop requires a space preceding a field. Tab attribute is ignored. There is no space preceding the defined field. Therefore, you cannot define a tab stop for the field. *ERROR TEMPLATE command not preceded by a FORM or IMAGE command. You included the TEMPLATE initiator command, but it does not immediately follow an IMAGE or FORM initiator command. When you use the TEMPLATE command, it must immediately follow the IMAGE or FORM command it is associated with. *ERROR The attempt to catalog the FILE: failed. DPS 2200 failed when it attempted to catalogue the omnibus output file. *ERROR The element could not be inserted into the output file:. This message indicates an internal error. The attempt to insert the name into the table of contents (TOC) failed. *ERROR The name passed as the output file name: is invalid. The omnibus output file name does not follow standard syntax conventions for a file name. *ERROR The output file is the wrong type. The file must be a DATA file or a PROGRAM file. The output file is invalid, for example, a tape file. *ERROR The output file: could not be assigned. This message indicates an internal error. of the omnibus output file failed for unknown reasons. *ERROR The output file: is not a program file. The omnibus file name specified on the call line is not a program file. *ERROR The output file: is READ inhibited. The omnibus file specified on the call line cannot be read because it is read-inhibited. *ERROR The output file: is WRITE inhibited. The omnibus file specified on the call line cannot be written to because it was write-inhibited with statement or because a write key must be assigned. B

307 FDLP Messages *ERROR The repository is not installed on this system DPS 2200 is configured to use the repository; however, the repository is not installed on the system. *ERROR The value for SOURCE= must be GENERATE. The value specified on the STORAGE SOURCE=statement must be GENERATE. GENERATE is assumed. *ERROR The attribute is not valid at the form definition level. Attribute is ignored. The attribute you specified is a legal FLDP attribute. It is not valid at the form level. It may be valid at either the image level, field level, or both. *ERROR The attribute is not valid at the image definition level. Attribute is ignored. The attribute you specified is a legal FLDP attribute. It is not valid at the image level. It may be valid at either the form level, field level, or both. *ERROR The attribute is not valid for the entity type. Attribute is ignored. The attribute you specified is not valid for the DATA_TYPE (field type) you specified. The attribute is ignored. *ERROR Too many field characters specified. You specified more than two distinct characters for the FIELD_CHARACTERS parameter during a template definition. *ERROR Too many nested images. The maximum number of nested ON/OFF images is 10. You may nest ON/OFF images inside a vertical repeat, horizontal repeat, or both and have fields inside any or all of the images. *ERROR Too many values in list. Attribute is ignored. You specified more values in a list than allowed. The attribute you specified will be ignored. *ERROR Value of REPLENISH_STRING contains illegal character. Replenish string attribute ignored. You specified an illegal character for the replenish string. The replenish string cannot contain a number or an alphabetic character B 15

308 FDLP Messages *ERROR VALUE_CHECK may be used only if RESPOSITORY is configured. You cannot define the VC attribute if the respository is not configured for DPS *ERROR VALUE_CHECK not allowed for field more than 16 chars long. You have attempted to attach the VC attribute to a field exceeding 16 characters in length. *ERROR VCRANGE may be used only with NUMERIC fields. You attempted to set the VC attribute to R on an alphabetic or an alphanumeric field. *ERROR VCTABLE may be used only with ALPHA/ALPHANUMERIC fields. You attempted to set the VC attribute to T on a numeric field. *ERROR Vertical displacement must be 1 when positioning inside an image. Entity definition is not completed. ON/OFF images are all considered to have a height of 1, and they may wrap to span lines. You specified a value of 0 or greater than 1 for the POSITION_IMAGE ROW= statement. *ERROR Vertical repeat overlaps another vertical repeat. Image definition was not completed. The vertical repeat you are attempting to define cannot start or end within another vertical or horizontal repeat. *ERROR - Working storage area overflowed. The number of fields exceeds the configuration for the screen file, or the size of the working storage data for fields exceeds the configuration. The form definition is not saved. *ERROR is an illegal terminator for a FIELD definition. Terminator ignored. A field may be terminated only by an END_FIELD command. *ERROR is an illegal terminator for a FORM definition. Terminator ignored. The form may be terminated only by the END_FORM command. B

309 FDLP Messages *ERROR is an illegal terminator for an IMAGE definition. Terminator ignored. An image definition may be terminated only by the END_IMAGE command, another IMAGE, or a FIELD command. If terminated by another IMAGE or a FIELD command, the image or field will be nested within the first image. Each image requires an END_IMAGE command before the END_FORM. *INTERNAL ERROR. An internal FLDP error occurred that is beyond your control. *INTERNAL ERROR - Attribute buffer overflowed. The internal buffer used by the D$DEF routines to specify character attributes overflowed. This is beyond your control. *INTERNAL ERROR Attribute defined more than once for entity. First value for attribute in table is used. You specified a statement so that an attribute will be defined more than once for the form, image, or field. The first value is accepted and the most recent value ignored. *INTERNAL ERROR - Bad command id returned from Command Analyzer. The FLDP Command Analyzer returned an invalid command ID that is beyond your control. *INTERNAL ERROR - Bad field type value. Field definition is not performed. An invalid value was specified for the DATA_TYPE attribute. This attribute is used to define the field type. *INTERNAL ERROR - Bad image type value. Image definition is not performed. The image type must be either NORMAL or LINK. The image is not defined. *INTERNAL ERROR - Bad status returned from CLOSR$ routine. The SYSLIB CLOSR$ routine used to close the source output file returned an error that is beyond your control. *INTERNAL ERROR - Bad status returned from fetch routine. The internal routine used by FLDP to read the next line of input from the source input file returned an error that is beyond your control B 17

310 FDLP Messages *INTERNAL ERROR - Bad status returned from initialize routine. The internal routine used by FLDP to initialize input from the source input file returned an error that is beyond your control. *INTERNAL ERROR - Bad status returned from POSTPR$ routine. The SYSLIB POSTPR$ routine used to free the files returned an error that is beyond your control. *INTERNAL ERROR - Buffer space exhausted. All of the internal buffer space assigned to FLDP has been used. This error is beyond your control. *INTERNAL ERROR - D$DEFFRMCRE is required before the call of any other function (except for delete). Form definition is ignored. A fatal error was returned from the internal D$DEF routine call to D$DEFFRMCRE. This caused the form to remain undefined. Check errors returned after the form level statements. *INTERNAL ERROR - Field Control Area overflowed. The field control area section of the working storage overflowed because you defined more than the maximum number of images or fields for the specified screen file (form library). This error usually occurs when the number of images or fields within a repeat is greater than the maximum number of images or fields configured for that screen file. *INTERNAL ERROR Form definition is corrupted. One or more of the FI$MNA or SM$ADR offsets has an incorrect value. The D$DEF routines detected internal form corruption that is beyond your control. The form has not been saved into the specified form library (screen file) or omnibus file. *INTERNAL ERROR - Frame overflowed during save. Form definition is not saved. The internal buffer used to contain the literals (text) and emphasis text of the form overflowed. This is beyond your control. *INTERNAL ERROR - Message text. A specific internal error occurred in FLDP that is beyond your control. B

311 FDLP Messages *INTERNAL ERROR - Multiple Decimal scale values in attribute table. First value in table is used. You specified the GENERAL_EDIT DECIMAL_SCALE= statement more than once. The first value was accepted and the most recent value ignored. *INTERNAL ERROR Mutually exclusive attributes defined. First attribute value passed in attribute table is used. Attribute is ignored. You specified two statements in which the attributes are mutually exclusive. The first attribute specified is accepted; the second is ignored. *Invalid screen file name specified on FLDP call. The specified file does not exist. The form library (screen file) name you specified contains an illegal character or does not exist in your DPS 2200 configuration. The form definition is not complete. *WARNING Attempt to use masterspace for definition character. Default is taken. The start, stop, field, alternate field, start-of-entry (SOE) substitution characters, and edit symbols cannot be a masterspace. The default value is taken for the relevant attribute value. *WARNING Bad character case attribute value. Default is taken. You specified an invalid choice on the GENERAL_EDIT CASE= statement. The default value is taken. *WARNING Bad character for edit symbol. Cannot be letter, number, +, -, or identical symbols. Default is taken. You specified an invalid character on the EDIT_SYMBOL DECIMAL_POINT= COMMA= statement. The default value is taken. *WARNING Bad conversation value. Default is taken. The value you specified for the CONVERSATION SET_MODE= statement is not a valid choice. The default value is taken. *WARNING Bad font or character set value. Default is taken. You specified an invalid choice on the CHARACTER_ATTRIBUTES FONT_INDEX= statement. The default value is taken B 19

312 FDLP Messages *WARNING Bad justification attribute value. Default is taken. You specified an invalid choice on the GENERAL_EDIT JUSTIFICATION= statement. The default value is taken. *WARNING Bad output contents value. Default is taken. You specified an invalid choice on the OUTPUT_ATTRIBUTES CONTENTS= statement. The default value is taken. *WARNING Bad positioning of horizontal image. The entity is positioned relative to the origin, but it is outside the image because of bad horizontal displacement. *WARNING Bad positioning of ON image. Must have variable row and variable column positioning. ON/OFF images must have the following attributes specified:position_image VARIABLE_ROW=YESVARIABLE_COLUMN=YES *WARNING Bad positioning of REPEATED images. Must have fixed column and variable row positioning. Repeat images must have the following attributes specified:position_image VARIABLE_ROW=YESVARIABLE_COLUMN=NO *WARNING Bad positioning of SYSTEM or CONSTANT field. Must have variable row and variable column positioning. System-supplied fields, constant and emphasis-constant fields must have the following attributes specified: POSITION_IMAGEVARIABLE_ROW=YESVARIABLE_COLUMN=YES *WARNING Bad prefix generation value. Default is taken. The value you specified for the STORAGE GENERATE_PREFIX= statement is not a valid choice. The default value is taken. *WARNING Bad protect attribute value. Default is taken. You specified an invalid choice on the GENERAL_EDIT PROTECTED= statement. The default value is taken. *WARNING Bad radix attribute value. Default is taken. You specified an invalid choice on the GENERAL_EDIT RADIX= statement. The default value is taken. B

313 FDLP Messages *WARNING Bad security type value. Default is taken. The value you specified for the SECURITY TYPE= statement is not a valid choice. The default value is taken. *WARNING Bad set modified attribute value. Default is taken. You specified an invalid choice on the GENERAL_EDIT SET_MODIFIED= statement. The default value is taken. *WARNING Bad tab set attribute value. Default is taken. You specified an invalid choice on the TAB TYPE= statement. The default value is taken. *WARNING Bad test mode attribute value. Default is taken. You specified an invalid choice on the TEST SET_MODE= statement. The default value is taken. *WARNING Bad value for background color. Default is taken. You specified an invalid choice on the BACKGROUND_ATTRIBUTES COLOR= statement. The default value is taken. *WARNING Bad value for emphasis. Default is taken. You specified an invalid choice on the EMPHASIS TYPE= statement. The default value is taken. *WARNING Bad value for end-of-form. Defaults to last line of literals or fields. The value you specified on the DIMENSION HEIGHT= statement at the form level is not in the range 1 through MAXLINES, or is less than the last line of literals or images/fields. The form height defaults to the last line of literals (text) or images/fields, whichever is greater. *WARNING Bad value for foreground color. Default is taken. You specified an invalid choice on the FOREGROUND_ATTRIBUTES COLOR= statement. The default value is taken. *WARNING Bad value for highlight. Default taken. You specified an invalid choice on the HIGHLIGHT TYPE= statement. The default has been taken. *WARNING Bad value for spacing of vertical repeat image. Default taken. You specified a value other than 0 for spacing during a vertical repeat B 21

314 FDLP Messages *WARNING Duplicate FIELD, ALTERNATE FIELD, or ON/OFF characters were found. Characters defaulted to _, NULL, [, and ]. You specified duplicate FIELD, ALTERNATE FIELD, or ON/OFF characters. They defaulted to '_', 'NULL', '[', and ']'. *WARNING Edit symbol already used as initial character for field. Default edit symbol is taken. This is similar to error 9110, except that you specified an edit symbol that is already used as a replenish (initial) character for some field. *WARNING Edit symbol must be one character. First character is used. The value specified on the EDIT_SYMBOL DECIMAL_POINT= COMMA= statement cannot have values of more than one character in length. The first character specified in the string is accepted. *WARNING EMPHASIS in TEXT has not been configured in this DPS 2200 system. The EMPHASIS attribute is ignored. You specified the OUTPUT_ATTRIBUTES CONTENTS=EMPHASIS_ CONSTANT statement. However, DPS 2200 does not have the TEXT ATTRIBUTES EMPHASIS,ON configuration stream generation statement (SGS) specified. The field definition is ignored. *WARNING Field for final cursor position not found. First I/O field or maxlines, 1 used. The name you specified for the CURSOR IMAGE_NAME= (form-level) statement is not a defined input/output field. The first input/output field in your form has been used. If there are no fields in the form, row=maxlines, column=1 is used for the final cursor position. *WARNING Field must be both variable row and variable column, or fixed row a nd fixed column. Variable row and column are taken. Fields must have the following attributes specified: or POSITION_IMAGE VARIABLE_ROW=YES VARIABLE_COLUMN=YES POSITION_IMAGE VARIABLE_ROW=NO VARIABLE_COLUMN=NO *WARNING Field specified for final cursor position is not an I/O field. Final cursor position defaults to first I/O field. The field you defined for the cursor position is either protected (output only) or it contains an attribute that will not allow it to be the cursor position field. B

315 FDLP Messages *WARNING First field character defined with more than one character. Value truncated to first character in string. You specified more than one character for the field character in the FORM or TEMPLATE command. The first character in the string is taken. *WARNING Illegal character in constant field - spaces inserted. Your constant field (text or literals) contains a character that is used as one of the start, stop image, or field characters. It has been converted to a space. *WARNING Illegal character in initial value. Illegal characters are converted to spaces. If the DATA_TYPE (field type) is alphabetic, the only characters allowed in the PREDEFINED_VALUE INITIAL_VALUE= statement are the A through Z characters. *WARNING Illegal combination of display attributes. Dynamic attributes are set to default. The dynamic attribute used by the Screen Definition Processor and in the user working storage, maps into several FLDP commands. They are as follows: OUTPUT_ATTRIBUTES CONTENTS = { BLANK STORAGE } GENERAL_EDIT PROTECTED = { YES NO } SET_MODIFIED = { YES NO } HIGHLIGHT TYPE = CORRECTION A combination of these attributes does not produce a valid dynamic character. *WARNING Illegal combination of values for attributes which determine dynamic attribute value. Dynamic attributes set to default. The dynamic attribute used by the Screen Definition Processor and in the user working storage, maps into several FLDP commands as follows: OUTPUT_ATTRIBUTES CONTENTS = { BLANK STORAGE } GENERAL_EDIT PROTECTED = { YES NO } SET_MODIFIED = { YES NO } HIGHLIGHT TYPE = CORRECTION A combination of these attributes does not produce a valid dynamic character. *WARNING IMAGE_NAME= is specified when RELATIVE_TO=DEFAULT. The final cursor position will take default action B 23

316 FDLP Messages *WARNING Initial character cannot be edit symbol. Default is taken. The value you specified for the PREDEFINED_VALUE REPLENISH_STRING= statement cannot be the same as one of the values specified on the EDIT_SYMBOL DECIMAL_POINT= COMMA= statement. Since there is no default for replenish (initial) characters, no default is taken. *WARNING Initial character is not specified for RFB attribute. You specified DISPLAY=REPLENISH_FOR_BLANKS and did not supply a value for REPLENISH_STRING. The default value is taken. *WARNING Initial value exceeds maximum possible field length. Initial value is truncated. The string length of the specified initial value is longer than the length of the field. The characters in the initial value string beyond the length of the field will be ignored. *WARNING Initial value is longer than defined field length. Initial value is truncated to field length. The length of the specified initial value is greater than the value you specified on the DIMENSION WIDTH= statement. The initial value is truncated to the size specified in the DIMENSION WIDTH= statement. *WARNING Maximum width is too large. Initial width defaults as maximum. If a field is specified as variable-width, the maximum width cannot be greater than MAXLINES multiplied by MAXCOLUMNS. *WARNING Maximum width must be greater than zero. Initial width defaults as maximum. If a field is specified as variable-width, the maximum width cannot be less than the field's initial width. *WARNING Missing field terminator. A command initiator was detected before an END_FIELD terminator command. *WARNING Missing form terminator. End of form assumed. The end of input was detected or another FORM command was detected before an END_FORM terminator command. *WARNING Missing Image terminator. There is a missing END_IMAGE command in the FLDP syntax. The number of IMAGE and END_IMAGE commands must be equal. B

317 FDLP Messages *WARNING More than one character specified for SOE. SOE value truncated to first character. The SOE_CHARACTER parameter accepts only one character as a value. *WARNING Name is too long. Name value is truncated. The specified name is longer than the maximum allowed value. This is 8 for form name, 16 for image, field, reference (link), and index names. The name is truncated to the maximum size. *WARNING No FIELD definition statements. *WARNING No FORM definition statements. *WARNING No IMAGE definition statements. *WARNING Parameter string truncated due to length. Warning returned when a parameter with a string value, that is, field character, form name, image name, and so forth, is longer than the length of the fields. *WARNING Previous form definition has not been closed. End FORM command assumed. An end-of-file was detected before the required END_FORM command. The END_FORM command has been assumed and form definition completed. *WARNING Reference to undefined entity. A reference was made to an entity that has not been defined for the form. If it is not defined before form definition is terminated, an error message is generated. If it is defined before form definition is terminated, the reference will be completed, and the warning message can be ignored. *WARNING Replenish string exceeds one character. String truncated to the first character. DPS 2200 restricts the length of the replenish string to one character. *WARNING Second Field Character defined with more then one character. Value truncated to first character in string. You specified more than one character for the second field character in the FORM or TEMPLATE command. The first character in the string is taken. *WARNING Security-level must be > 1 to specify PROBLANK or PRODATA You specified FAIL_ACTION=PROTECTED_BLANKS or FAIL_ACTION= PROTECTED_DATA and the security level is 1. The default value is taken B 25

318 FDLP Messages *WARNING Security-level must be = 1 to specify NORMAL security-fail action. You specified FAIL_ACTION=NORMAL and the security level is greater than 1. The default value is taken. *WARNING Specified form height is greater than configured maximum or specified field or image height is not equal to 1. Defaults to configured maximum or 1. The maximum value on the DIMENSION HEIGHT= statement at the form level is MAXLINES. The value for images or fields must equal 1. *WARNING Start of Image Character defined with more than one character. Value truncated to first character in string. You specified more than one character for the start image character in the FORM or TEMPLATE command. The first character in the string is taken. *WARNING START_IMAGE character not in column 1 of line. A repeat image was defined in a template, but the START_IMAGE character is not in column 1. Repeat images must start in column 1 and end in the configured maximum column. *WARNING Statement already occurred for this entity. You specified a command or statement more than once. The values specified in the most recent statement will be accepted. *WARNING Stop of Image Character defined with more than one character. Value truncated to first character in string. You specified more than one character for the stop image character in the FORM or TEMPLATE command. The first character in the string is taken. *WARNING STOP_IMAGE character not in column. The STOP_IMAGE character in the template for a repeat image is not in the last column of the form. Repeat images must start in column 1 and end in the configured maximum column. *WARNING STORAGE GENERATE TYPE= is required for a FORM definition. The default value of FCA is used. *WARNING STORAGE SOURCE= is required for a FORM definition. The default value of GENERATE is used. B

319 FDLP Messages *WARNING System-supplied field exceeds maximum length. Truncated to 511. You attempted to create a system-supplied field with a length greater than 511. The length was defaulted to 511. *WARNING TEMPLATE already defined for this entity. Data entered between this TEMPLATE command and end is ignored. *WARNING The FILE: was cataloged for you. The file specified as the omnibus output file was catalogued for you. *WARNING The FORM name, FORM number defaulted. You did not specify a form number on the FORM command, so FLDP has found the first available form number in the specified form library (screen file). *WARNING The IMAGE name defaulted. You did not specify an image name on the IMAGE command, so FLDP has defaulted the image name. *WARNING The image or field will overwrite non-blank constant text. You attempted to insert constant text over an image or field or vice-versa. The text was converted to spaces where it overlaps the image or field. *WARNING The image or field will overwrite non-blank emphasis text. You attempted to insert emphasis text over an image or field or vice-versa. The text was converted to ASCII zeros where it overlaps the image or field. *WARNING The INDEX name defaulted. You did not specify an index name on the REPEAT_IMAGE command, so FLDP has defaulted the reference name. *WARNING The LINK name defaulted. You did not specify a reference (link) name on the IMAGE command, so FLDP has defaulted the reference name to the first previous ON/OFF image name. *WARNING The marking character cannot be a masterspace. You specified the masterspace (@) character for the marking character attribute. The default value is taken B 27

320 FDLP Messages *WARNING The marking character cannot be a number. You specified a numeric value for the marking character. The default value is taken. *WARNING The marking character cannot be alphabetic characters. You specified an alphabetic value for the marking character. The default value is taken. *WARNING The marking character cannot be equal to a field character. You specified a value for the marking character that is equal to the field character or alternate field character. The default value is taken. *WARNING The marking character cannot be equal to a start/stop image character. You specified a value for the marking character that is equal to the start image character or the stop image character. The default value is taken. *WARNING The marking character cannot be equal to any text constant values. The value you specified for the marking character is already defined as a text constant value. The default value is taken. *WARNING The new form definition: Formname: Number:. The new form definition will overwrite the existing definition. *WARNING The output OMNIBUS file: was defaulted. You specified the O option on the call line, but did not specify an omnibus file name. The name is defaulted. *WARNING Too many field characters specified in the list. The first two characters in the list will be used as field characters. *WARNING Truncation on read of template data. The input for the template you defined has been truncated because it is larger than the maximum allowed size for an image or form. *WARNING Value NONE specified in list will be ignored. The statement has a valid choice of NONE, but you specified other valid choices which make NONE meaningless. NONE is overridden by the other choices. B

321 FDLP Messages *WARNING Width of form must equal configured screen width. Form width is defaulted to configured screen width. The value specified on the DIMENSION WIDTH= statement at the form level must be equal to MAXLINES. *WARNING Width of repeat must be equal to configured screen width. Your template specifies an image that does not include the entire line, or you specified an illegal image width. The repeat image width will be adjusted to include the entire line B 29

322 FDLP Messages B

323 Appendix C D$DEF Messages This appendix lists the error and warning messages generated by the D$DEF routines. A brief explanation follows each message. All D$DEF fatal errors result in the function not being performed. This means that the entity was not created on the D$DEF creation routines, or that the form was not loaded for D$DEFLOAD. For the modify routines, the entity is as it was before the call. If an error occurs when DPS 2200 is accessing UREP, the file DPS$DDABORT is created. This file contains the repository error messages returned by UREP. Multiple cycles of this file may exist. C.1. Error Messages Errors listed in this subsection are always fatal except for error #107. For this error, if fatal errors are detected, a fatal status is returned. If a warning is detected, a warning message is generated. Error # Message Description 100 FORM NUMBER OUT OF RANGE The form number is less than or equal to zero, or out of maximum configured range for the specified form library. 101 FORM NAME DOES NOT MATCH IN FORM LIBRARY The form name is longer than 8 characters, contains an illegal character, or does not match the one in the form library. 102 I/O ERROR ON FORM LIBRARY An I/O error occurred while attempting to read or write the screen record. The demand form library is not initialized. The TIP file is not registered. 103 BAD ASSIGN OF FORM LIBRARY This error occurs in demand mode only. It occurred when attempting to assign the form library. Use DPSIF to catalog the file. 104 INTERNAL ERROR - FRAME SCREEN OVERFLOW 105 INTERNAL ERROR -WORKING STORAGE OVERFLOW There is an internal error. The base screen overflowed while generating the frame. Report this error to your system coordinator. There is an internal error. Working storage overflowed while it was being generated. There are too many fields in the form C 1

324 D$DEF Messages Error # Message Description 106 FORM SPECIFIED IN NAMES TABLE DOES NOT EXIST The form does not exist. No action was taken during the D$DEFERASE or D$DEFLOAD functions. 107 MULTIPLE ERRORS OCCURRED More than one warning or error was found in processing the function. All errors are on the error stack. When a fatal error occurs, a fatal status is returned; otherwise, a warning status is returned. Use D$RETURNERR to return the errors. 108 USER S SECURITY DOES NOT ALLOW FUNCTION TO BE CALLED 109 IMAGE OR FIELD WIDTH IS TOO SMALL 110 FORM CREATE OR FORM LOAD REQUIRED FIRST 111 INTERNAL D$DEF ERROR OCCURRED! Password security failed while attempting to insert (D$DEFFRMCRE), erase (D$DEFERASE), or save (D$DEFSAVE) a form. Refer to Section 4 for a description of FORMGEN security for these functions. The length of a field must be at least one character. An ON/OFF image must have two characters, and a vertical repeat must equal form width. The system attempted to perform some other function before a call to either D$DEFFRMCRE or D$DEFLOAD. There was a general internal D$DEF error due to an invalid input buffer field or other software beyond your control or visibility. Report this error to your system coordinator. 112 INVALID FIELD TYPE SPECIFIED The data type of the specified field is not a valid choice. 113 INVALID NUMERIC OR COMP FIELD WIDTH 114 INVALID ALPHA OR ALPHANUMERIC FIELD WIDTH 115 ILLEGAL CHARACTER IN IMAGE NAME The COMP or NUMERIC field width is greater than the maximum allowed. The field width is greater than the maximum allowed. The field or image name contains an illegal character. 116 DUPLICATE IMAGE NAME The field or image name is already defined. 117 CANNOT POSITION IMAGE OUTSIDE FORM DIMENSIONS 118 ERROR LINE IS EXCLUSIVE OF ERROR HEADER 119 HEADER LINE IS EXCLUSIVE OF ERROR HEADER 120 DUPLICATE ERROR HEADER SPECIFIED The field or image coordinates are outside the range of the form. An error line and an error header cannot occur on the form together. A header line and an error header cannot both occur on the form. The error header is already defined. 121 DUPLICATE ERROR LINE DEFINED The error line is already defined. C

325 D$DEF Messages Error # Message Description 122 DUPLICATE HEADER LINE DEFINED 123 ATTEMPTED FIELD OR IMAGE OVERLAP 124 TOO MANY DIGITS AFTER DECIMAL The header line is already defined. The field or image overlaps a previously defined field or image start or stop location. There are more than 18 digits after the decimal. 125 IMPROPER NESTING OF IMAGES The images are improperly nested. Image A starts outside image B and ends inside image B. 126 INVALID IMAGE TYPE SPECIFIED The image type specified is not ON/OFF, repeat, or LINK. 127 IMAGE LINKED TO IS NOT ON/OFF TYPE 128 IMAGE LINKED TO IS ALINKED IMAGE 129 REPEAT LINE NUMBER OUTSIDE OF FORM The image to be linked must be an ON/OFF image that is not a LINK type. Linking a field to another linked image is not allowed. Image type must be NORMAL. The line number repeated is outside the range of the form. The value must be between 1 and REPEAT COUNT IS TOO LARGE The repeat count causes the image to be beyond line REPEAT STARTS INSIDE ANOTHER REPEAT IMAGE 132 REPEAT ENDS INSIDE ANOTHER REPEAT IMAGE 133 REPEAT WILL OVERLAP ANOTHER IMAGE 134 INTERNAL ERROR - ERROR STACK OVERFLOW The repeat image starts inside another repeat. Repeats cannot be nested unless a horizontal repeat is placed inside a vertical repeat. The repeat overlaps into another repeat, due to a too-large repeat count or bad positioning. All lines after the first line of a repeat must be blank. No other fields or constants may be present. The error stack for containing multiple errors overflowed. This stack has 20 entries. All other errors are lost. 135 BACK-TO-BACK FIELDS DEFINED You attempted to define back-to-back fields. This is not supported. There must be one space between fields. 136 IMAGES MAY NOT BE NESTED MORE THAN 10 DEEP 137 MISSING REQUIRED FORM NUMBER You attempted to nest more than 10 images. This does not include fields inside the images. The form number is required but not specified. 138 MISSING REQUIRED FORM NAME Form name is required but not specified C 3

326 D$DEF Messages Error # Message Description 139 ILLEGAL SYNTAX SPECIFIED FOR FORM NAME 141 FIELD INSERTED NOT ON LINE 1 OF REPEAT The form name contains illegal syntax. When you attempt to insert a field inside a vertical repeat, the insert can be done only within the first occurrence of a repeat. 142 DEFAULT AND TYPEDEF ONLY VALID STORAGE TYPES FOR UC 143 INVALID SYSTEM FIELD TYPE An illegal value was specified for the system-supplied field type. 144 IMAGE SPECIFIED IN NAMES TABLE NOT DEFINED 145 TOO MANY DIGITS BEFORE DECIMAL 146 VERTICAL DISPLACEMENT MUST BE 1 IN IMAGE 147 INTERNAL ERROR - FIELD TABLE OVERFLOW 148 INTERNAL ERROR FCA TABLE OVERFLOW 149 ENTITY POSITIONED OUTSIDE OF IMAGE 150 HORIZONTAL DISPLACEMENT IN REPEAT MUST BE 1 The image name in the name table was not found. This is the image that the image field is inside of. There are more than 18 digits before the decimal point. When positioning relative to ORIGIN of an image, the vertical displacement must be 1 because images wrap. The horizontal displacement may be 80. The current entity causes the field table to overflow. You have defined too many images or fields. The current entity causes the field control area (FCA) table to overflow. The entity is positioned relative to ORIGIN but resides outside the image due to bad horizontal displacement. A vertical repeat must begin in the first column. 151 ERROR LINE FIELD SPANS LINES The error line, error header, or header line cannot span lines. 152 FIELD SPANS LINES INSIDE REPEAT IMAGE 153 IMAGE SPANS LINES INSIDE REPEAT IMAGE 154 TYPEDEF STORAGE TYPE WITH INITIAL VALUES IS ILLEGAL 155 CHARACTER ATTRIBUTE BUFFER OVERFLOWED 156 FIELD LINKED TO IS ALREADY LINKED The end of a repeat does not include the total length of the field-spanning lines. The end of a repeat does not include the total length of the image. Initial values and typedef working storage cannot be generated. The offset into DPS-ATTR-BUFF and the size of the character attribute is less than or equal to 0 or greater than the size of DPS-ATTR-BUFF. The image that you requested to link to is a linked image. C

327 D$DEF Messages Error # Message Description 157 D$DEFFRMDEL/ D$DEFSAVE REQUIRED-PROTECTION 158 ATTEMPT TO DELETE IMAGE LINKED TO BY ANOTHER IMAGE 159 IMPROPER NESTING OF REPEAT IMAGES 160 IMAGE CANNOT SPAN HORIZONTAL REPEAT OCCURRENCES 161 FIELD CANNOT SPAN HORIZONTAL REPEAT OCCURRENCES 162 ENTITY NOT IN FIRST OCCURRENCE OF HORIZONTAL REPEAT 163 HORIZONTAL REPEAT CANNOT EXCEED RIGHT FORM BOUNDARY 164 CANNOT CHANGE IMAGE TYPE WHEN MODIFYING REPEAT 165 REPEAT NOT IN FIRST OCCURRENCE OF VERTICAL REPEAT 166 EMPHASIS IN TEXT MUST BE CONFIGURED TO USE EMPHASIS 167 SDP-CREATED UNINITIALIZED FORM CANNOT BE LOADED 168 PROGRAM FILE IS NOT CATALOGUED D$DEFFRMDEL or D$DEFSAVE is required before calling another D$DEFLOAD, D$DEFFRMCRE, or D$DEFERASE function. You attempted to delete an ON/OFF image that has another ON/OFF image linked to it. You tried to insert a horizontal repeat on top of another horizontal repeat. You tried to insert a horizontal repeat or ON/OFF image that did not have the ON/OFF image contained completely within the first occurrence of the horizontal repeat. You tried to insert a horizontal repeat image or field that did not have the field contained completely within the first occurrence of the repeat. You tried to insert an entity inside a horizontal repeat that is not in the first occurrence of this horizontal repeat. You tried to insert a horizontal repeat that would span lines. You attempted to modify a vertical or horizontal repeat image and change its type. You attempted to insert a horizontal repeat, inside a vertical repeat, that is not in the first occurrence of this vertical repeat. You attempted to define an emphasis field when emphasis is not configured in your DPS 2200 system. You attempted to load a partially defined form that was not fully initialized with the proper values. The form must be recreated. DPS 2200 cannot access the program file to load or save the element. 169 DATA FILE IS NOT CATALOGUED DPS 2200 cannot access the data file during a write. 170 ABNORMAL RETURN FROM SAR_OPEN_OUTPUT CALL 171 ABNORMAL RETURN FROM SAR$ ROUTINE 172 NO ROOM IN FORM LIBRARY TO SAVE FORM DPS 2200 cannot create the output because of an internal error returned by the SAR$ routines. DPS 2200 cannot create the output because of an internal error returned by the SAR$ routines. DPS 2200 cannot save this form into the screen file because every form is already used C 5

328 D$DEF Messages Error # Message Description 173 THE FORM WILL OVERWRITE ANOTHER EXISTING FORM 174 FORM BEING REPLACED DOESN T EXIST IN FORM LIBRARY 175 ILLEGAL VALUE PASSED FOR WORKING STORAGE LANGUAGE 176 ILLEGAL VALUE PASSED FOR WORKING STORAGE PREFIX 177 ILLEGAL VALUE PASSED FOR INITIAL VALUES 178 ILLEGAL VALUE PASSED FOR REDEFINITION 179 ILLEGAL VALUE PASSED FOR STORAGE TYPE 180 BASEDWORKING STORAGE WITH INITIAL VALUES IS ILLEGAL 181 OF THE DPS INTERNAL USE NAME FAILED 182 OF THE DPS USE NAME TO YOUR FILE FAILED 183 THE NAME PASSED AS THE OUTPUT FILE NAME IS INVALID 184 AN ELEMENT NAME MUST BE PASSED FOR THIS FUNCTION 185 THE OMNIBUS ELEMENT IS TOO LARGE FOR CONFIGURATION 186 AN I/O ERROR OCCURRED ON THE SAR$ OUTPUT ROUTINES 187 ELEMENT TO READ COULD NOT BE FOUND 188 ELEMENT INSERTION ERROR OCCURRED DPS 2200 cannot save this form because another form with this number already exists in the screen file. DPS 2200 cannot replace this form because a form with this number does not exist in the screen file. An illegal value for the language type was specified on the call to D$DEFGENWS. An illegal value for the prefix type was specified on the call to D$DEFGENWS. An illegal value for the initial values type was specified on the call to D$DEFGENWS. An illegal value for the redefinition type was specified on the call to D$DEFGENWS. An illegal value for the storage type was specified on the call to D$DEFGENWS. PLUS working storage cannot have initial values if it is based. of the internal use name failed. DPS 2200 could not complete this function. of the internal use name failed. DPS 2200 could not complete this function. The name passed to DPS 2200 is illegally formed. The function D$DEFLOAD requires an element name to load an omnibus element. The function D$DEFLOAD cannot load this element because it is too large. DPS 2200 cannot complete this function because the SAR$ output routines returned an error. The D$DEFLOAD function cannot find the omnibus element to load. An internal error occurred when DPS 2200 tried to insert the name of the element into the files table of contents. 189 FILE IS NOT A PROGRAM FILE! DPS 2200 requires that this is a program file if an element is to be created. 190 FILE COULD NOT BE ASSIGNED! DPS 2200 cannot assign the file to write into or read from an element. 191 FILE READ INHIBITED! The file you are trying to read from is read inhibited. C

329 D$DEF Messages Error # Message Description 192 FILE WRITE INHIBITED! The file you are trying to write into is write inhibited. 193 FILE IS WRONG TYPE! The file you are trying to read from or write into is the wrong type. 194 FILE IS NOT CATALOGED! The file you are trying to read from or write into is not cataloged. 195 ATTEMPT TO CATALOG FILE FAILED 196 D$DEFSAVE REPLACE OPTION NOT VALID FOR OMNIBUS FILES 197 INTERNAL FORM DEFINITION FI$MNA/SM$ADR CORRUPTED 198 CANNOT DEFAULT REF ATTRIBUTE; NO PRIOR IMAGE TO LINK TO 199 ATTEMPT TO CYCLE PRINT FILE FAILED 700 DPS-FORM-LIBRARY ENTITY NOT FOUND IN REPOSITORY 701 REPOSITORY INITIALIZATION ERROR 702 REPOSITORY CREATE ENTITY ERROR DPS 2200 attempted to catalog a file, but failed. You cannot replace an omnibus element. The mnemonic table offsets in this form are corrupted. You attempted to default the reference name of a linked ON/OFF image, but there are no previous ON/OFF images to link to. While attempting to catalog a new cycle of the print file, an error was detected. A DPS-FORM-LIBRARY entity was not found in the repository while attempting to save a form definition or working storage in the repository. An error was detected while initializing the interface to the repository. A create entity error was detected while saving a form definition or working storage in the repository. This error could occur if the form contains a field name matching one that is internally generated by DPS 2200 in the form of a procedure. For example, your form contains a field named NAME or NUMBER. 703 REPOSITORY FIND ENTITY ERROR An error was detected while retrieving an entity from the repository. 704 REPOSITORY DELETE ENTITY ERROR 705 REPOSITORY TERMINATION ERROR 706 REPOSITORY ADD TEXT ATTRIBUTE ERROR 707 REPOSITORY GET ENTITY NAME ERROR While deleting a form definition or working storage from the repository, an error was detected when an entity was deleted. An error was detected while attempting to terminate the interface to the repository. An error occurred while adding a text attribute to an entity in the repository. An error was detected while retrieving the name of an entity from the repository C 7

330 D$DEF Messages Error # Message Description 708 REPOSITORY GET ATTRIBUTE ID ERROR An error was detected while retrieving the identifier of an attribute from the repository. 709 REPOSITORY ENTITY NOT FOUND An entity could not be found while saving a form definition or working storage in the repository. 710 REPOSITORY CREATE RELATIONSHIP ERROR 711 REPOSITORY ADD VALUE ATTRIBUTE ERROR 712 REPOSITORY GET TEXT ATTRIBUTE ERROR 713 REPOSITORY GET VALUE ATTRIBUTE ERROR 714 REPOSITORY DELETE TEXT ATTRIBUTE ERROR 715 REPOSITORY DELETE VALUE ATTRIBUTE ERROR While saving working storage in the repository, an error was detected when a relationship was created between two entities. An error occurred while adding a value attribute to an entity in the repository. An error occurred while retrieving a text attribute from the repository. An error occurred while retrieving a value attribute from the repository. An error occurred while deleting a text attribute from the repository. An error occurred while deleting a value attribute from the repository. 716 REPOSITORY DEADLOCK ERROR While accessing the repository, a deadlock condition was encountered. 717 REPOSITORY ATTRIBUTE NOT FOUND 718 ILLEGAL VALUE PASSED FOR OUTPUT TYPE 719 FORTRAN W/S CAN T BE SAVED IN THE REPOSITORY 720 PLUS W/S CAN T BE SAVED IN THE REPOSITORY 721 W/S SAVED IN THE REPOSITORY MUST HAVE INITIAL VALUES 722 W/S SAVED IN REPOSITORY DOES NOT ALLOW REDEFINITION 723 REPOSITORY NOT INSTALLED ON SYSTEM 724 REPOSITORY OMIT CHANGES ERROR 725 DPS-FORM ENTITY NOT FOUND IN THE REPOSITORY An attribute in the repository could not be found. An unknown value was specified for the output type on the call to D$DEFGENWS. DPS 2200 does not support saving FORTRAN working storage in the repository. DPS 2200 does not support saving PLUS working storage in the repository. Working storage saved in the repository must be defined with initial values. Working storage saved in the repository cannot be defined with redefinition. DPS 2200 is configured to use the repository, however, the repository is not installed on the system. An error was detected while omitting changes made to the repository. A DPS-FORM entity could not be found while replacing a form definition or saving working storage in the repository. C

331 D$DEF Messages Error # Message Description 726 IMAGE OR FIELD DEFINED IN HORIZONTAL REPEAT SPACING 727 CANNOT GENERATEW/S - SEE OUTPUT ELEMENT FOR DETAILS 728 CANNOT GENERATEW/S - SEE DPS$DDABORT. FOR DETAILS You attempted to define a field or an image in the spacing of a horizontal repeat. Only constant literal text or emphasis is allowed. An error occurred while attempting to generate working storage for a form. The output element specified in the output field on the FORMGEN Working Storage menu will contain a detailed explanation of the problem. An error occurred while attempting to generate working storage for a form. A new cycle of the DPS$DDABORT file will be created. This file will contain a detailed explanation of the problem. C.2. Warning Messages D$DEF warnings do not invalidate the function, but the result may not be what you expected. The warning messages listed give the message and an explanation. Following the explanation are any applicable create, or modify routine recovery actions. These are the actions that the D$DEF routines take to recover from the error. Some of the recovery actions give two options (create, update). This shows the warning message differences between the create and update functions. The recovery action is the same when only one option is given. Ignored means the attribute is effectively ignored; otherwise, DPS 2200 uses the assumed value listed or takes the system default. Warning # Message Description 200 FINAL CURSOR FIELD NOT FOUND The name specified to position the final cursor is not in the temporary screen. Create: First I/O field Update: Ignored 201 FINAL CURSOR FIELD NOT I/O FIELD The field specified to position the final cursor is not an I/O field. Create: First I/O field Update: Ignored 202 ILLEGAL FUNCTION KEY VALUE The function key is 0 or outside the maximum range. Ignored C 9

332 D$DEF Messages Warning # Message Description 203 ILLEGAL CONVERSATION MODE VALUE The value for conversation mode must be either YES or NO. Create: NO assumed Update: Ignored 204 ILLEGAL TEST MODE VALUE The value for test mode must be either YES or NO. Create: NO assumed Update: Ignored 205 ILLEGAL SECURITY LEVEL VALUE The security is zero or greater than the maximum allowed. Create: First I/O field Update: Ignored 206 ILLEGAL SECURITY TYPE VALUE The security type must be either HARD or SOFT. Create: SOFT assumed Update: Ignored 207 ILLEGAL VALUE FOR FORM INTENSITY Intensity/highlightmust be HIGH, Ignored LOW, NORMAL, or BLINK. Create: NORMAL assumed Update: 208 ILLEGAL GENERATE PREFIX VALUE Prefix generation specification must be either YES or NO. Create: NO assumed Update: Ignored 209 ILLEGAL FORM HEIGHT SPECIFIED The line number specified for the end of the form is 0 or greater than the form width. Last line of fields or literals 210 INVALID SOE CHARACTER SPECIFIED 211 ILLEGAL ATTRIBUTE FOR FIELD TYPE The start-of-entry (SOE) substitution character is invalid. Ignored The attribute specified is invalid for the field type. Ignored 212 TAB STOP NOT ALLOWED There must be at least one space before the tab stop. Ignored 213 UNRECOGNIZED ATTRIBUTE The attribute specified is not a recognized identifier. The attribute-id is returned. Ignored C

333 D$DEF Messages Warning # Message Description 214 DECIMAL SCALE FIELD DEFINED TWICE 215 TOO MANY DIGITS IN DECIMAL SCALE The decimal point is already specified for the field. Ignored There are too many digits in the decimal point specification. Ignored 216 ILLEGAL CHARACTER SPECIFIED The start character specified was used as a field or stop character, or is an invalid character. Create: assumed Update: Ignored 217 INVALID HIGHLIGHT FOR IMAGE The highlight specified is an illegal value. None assumed 218 INVALID FOREGROUND COLOR The foreground color specified is an illegal value. Create: WHITE assumed Update: Ignored 219 INVALID BACKGROUND COLOR The background color specified is an illegal value. BLACK assumed 220 INVALID DYNAMIC ATTRIBUTE One of the attributes that specifies the dynamic character is invalid. Default assumed 221 TAB NOT ALLOWED IN OUTPUT- ONLY FIELD Ignored 222 TAB NOT ALLOWED IN COLUMN 1 Ignored 223 INVALID REPLENISH CHARACTER The replenish character specified is an illegal character. Ignored 224 MASTERSPACE CHARACTER NOT ALLOWED 225 ILLEGAL CHARACTER IN CONSTANT FIELD - SPACES INSERTED A masterspace was specified for the field, start or stop character. Create: Default taken for character Update: Ignored The initial value for a field must be alphanumeric. Create: Bad character converts to space Update: Ignored C 11

334 D$DEF Messages Warning # Message Description 226 DUPLICATE ATTRIBUTE SPECIFIED A duplicate attribute identifier was specified. Last value specified is assumed 227 WIDTH OF FORM MUST BE MAX CHARACTERS An illegal value for the form width was specified. Form width assumed (80) 228 INVALID FORM OR IMAGE HEIGHT An illegal value for the form, field or image height was specified. 1 assumed 229 MUTUALLY EXCLUSIVE ATTRIBUTES DEFINED 230 INITIAL CHARACTER NOT ALLOWED Two attributes are mutually exclusive. Second attribute ignored The replenish character is not allowed in this type of field. Ignored 231 INVALID SECURITY FAIL ACTION The value specified for security fail action is invalid. Ignored 232 ILLEGAL VALUE FOR GENERATE STORAGE 233 RIGHT JUSTIFY WITH FIELD SPANNING LINES 234 ILLEGAL VALUE FOR ATTRIBUTE xxx 235 ATTRIBUTE xxx NOT VALID AT FORM LEVEL 236 ATTRIBUTE xxx NOT VALID AT FIELD LEVEL 237 ATTRIBUTE xxx NOT VALID AT IMAGE LEVEL The value specified for the generated storage attribute is invalid. FCA assumed Right justificationwas specified for a field spanning lines. This is not supported. Ignored The value for the specified attribute is illegal. Ignored The attribute specified is a legal identifier, but invalid at the form level. The attribute-id is returned. Ignored The attribute specified is a legal identifier, but invalid at the field level. The attribute-id is returned. Ignored The attribute specified is a legal identifier, but it is invalid at the image level. The attribute-id is returned. Ignored C

335 D$DEF Messages Warning # Message Description 238 INTERNAL ERROR - ATTRIBUTE TABLE OVERFLOW 239 MISSING REQUIRED GENSTRG ATTRIBUTE 240 MISSING REQUIRED STRGSORC ATTRIBUTE 241 FINAL CURSOR FIELD NAME NOT ALLOWED 242 INVALID SIZE FOR CHARACTER ATTRIBUTE The number of attributes passed is greater than the size of the attribute list. This is detected during processing the attributes, not before. End of attribute table scan The GENSTRG attribute is required but not specified. FCA assumed The STRGSORC attribute is required but not specified. GENERATE assumed A final cursor field name was passed but CURSOR is DEFAULT. Ignored The length of the character attribute is not valid. Default assumed based on attribute. 243 INVALID CCSNUM VALUE The value specified for the CCSNUM is not valid. DEFAULT assumed. 244 INITIAL VALUE TRUNCATED The initial value is longer than the field length. Truncated 245 ILLEGAL ATTRIBUTE VALUE AT FORM LEVEL 246 ILLEGAL ATTRIBUTE VALUE AT IMAGE LEVEL 247 IMAGE NAME PASSED WHERE NOT ALLOWED 248 INITIAL VALUE IS NON-ALPHANUMERIC 249 CURSOR ATTRIBUTE VALUE IS NOT DEFAULT/IMAGE The attribute-id is legal at the form level, but the value selected is not. Ignored The attribute-id is legal at the image level, but the value selected is not. Ignored A name was passed for a constant, or system field, a linked ON/OFF image, or a repeat. Ignored There is an invalid character in the initial value. Character converted to space. The value specified for the cursor attribute must be neither DEFAULT or IMAGE. DEFAULT assumed 250 FORM WILL BE OVERWRITTEN The form number specified already exists in the screen file. Form is saved C 13

336 D$DEF Messages Warning # Message Description 251 RELATIVE NAME IS NOT ALLOWED A name to position two images relative to each other has been specified but is not allowed. Ignored 252 INVALID RELATIVE DIRECTION The relative direction is invalid. Ignored 253 INVALID VALUE FOR RELATIVE POSITION 254 WIDTH OF REPEAT IS NOT MAX CHARACTERS 255 ILLEGAL VALUE FOR CHECKNUMBER ATTRIBUTE The relative position is invalid. Ignored The width of a repeat must be equal to the configure form width. Maximum characters assumed (80) The value specified on the checknumber is invalid. YES assumed 256 INVALID EMPHASIS VALUE The value specified for the emphasis attribute is invalid. NONE assumed 257 INVALID FONT OR CHARACTER SET VALUE 258 SYSTEM OR CONSTANT FIELDS CANNOT BE FIXED POSITION 259 REPEATED IMAGES MUST BE FIXED COLUMN AND VARIABLE ROW 260 N IMAGES MUST BE VARIABLE COLUMN AND VARIABLE ROW 261 ILLEGAL USE OF VARIABLE POSITIONING The value specified for the font index is invalid. NORMAL assumed A system of constant field cannot be defined as having fixed row or fixed column positioning. Variable column and variable row assumed Vertical repeated images always start in column 1, so they are fixed column. Their row position must be variable. Fixed column and variable row assumed ON images may not be defined with any fixed position. Variable column and variable row assumed An input/output or output-only field must be defined as either fixed column and fixed row or variable column and variable row. Variable column and variable row assumed C

337 D$DEF Messages Warning # Message Description 262 MAXIMUM WIDTH IS INVALID FOR FIXED WIDTH FIELD 263 MAXIMUM WIDTH MUST BE GREATER THAN ZERO 264 MAXIMUMWIDTH IS LESS THAN INITIAL WIDTH The maximum width attribute is invalid if the field was not defined as being variable width. Ignored The value for the maximum width attribute must be greater than 0. Initial width assumed The value for the maximum width Attribute must be greater than or equal to the initial width given to the field. Initial width assumed 265 MAXIMUM WIDTH IS TOO LARGE The value for the maximum width attribute is too large. Initial width assumed 266 ILLEGAL CHARACTER FOR EDIT SYMBOL 267 INITIAL CHARACTER CANNOT BE THE SAME AS EDIT SYMBOL 268 EDIT SYMBOL ALREADY USED AS INITIAL CHARACTER FOR FIELD 269 HORIZONTAL REPEAT IMAGE MUST BE VARIABLE POSITION 270 SPACING FOR VERTICAL REPEAT IMAGES MUST BE ZERO 271 DELIMITER AND DECIMAL POINT ARE MUTUALLY EXCLUSIVE 272 BAD D_ATT_STORAGE_SOURCEVALUE Edit symbols cannot be letters, numbers, +, -, or identical symbols. Default assumed The initial character for a numeric input/output field cannot be the same as one of the edit symbols. Attribute ignored The edit symbols for a form cannot be modified to be the same as the initial character for a numeric input/output field. Default assumed You tried to specify fixed positioning when inserting a horizontal repeat. Variable assumed You specified a value other than 0 for spacing when inserting a vertical repeat. Assumed You may not enter a delimiter and a decimal point that are identical. Ignored You entered an illegal value for D_ATT_STORAGE_TYPE. Ignored C 15

338 D$DEF Messages Warning # Message Description 273 A NEW FORM NAME OR FORM NUMBER DEFAULTED 274 THE IMAGE NAME WAS DEFAULTED 275 THE INDEX NAME WAS DEFAULTED DPS 2200 defaulted the form name and number because either the form name was passed as spaces or the form number was 0. Default taken DPS 2200 defaulted the image name because spaces were passed as the name. Default taken DPS 2200 defaulted the horizontal or vertical repeat image name for you. Default taken 276 THE LINK NAME WAS DEFAULTED DPS 2200 defaulted the name of the image to link to for linked ON/OFF images. Default taken 277 THE WORKING STORAGE OUTPUT WAS DEFAULTED 278 OUTPUT PRINT FILE WAS DEFAULTED DPS 2200 defaulted the output file name to TPF$ and defaulted the element to SCREEN-#/<language>. Default taken DPS 2200 defaulted the output file to TPF$. Default taken 279 OMNIBUS FILE WAS DEFAULTED DPS 2200 defaulted the output omnibus file to TPF$ and the element name to current version number. Default taken 280 FILE WAS NOT CATALOGED, BUT WAS CATALOGED FOR YOU 281 ILLEGAL VALUE FOR CONTROL CHARACTER - DEFAULT TAKEN 282 CONTROL CHARACTERS MUTUALLY EXCLUSIVE - DEFAULT TAKEN 283 INTERNAL FORM DEFINITION CORRUPTED. FORM IS LOADED The output file you specified did not exist, so it was cataloged for you. File cataloged You specified illegal values for control characters. Default taken You entered control characters that are mutually exclusive. Default taken The internal mnemonic table offsets are corrupted due to internal errors in D$DEF, FLDP, or FORMGEN. You will not be allowed to call D$DEFSAVE to replace this form. Offset corrected C

339 D$DEF Messages Warning # Message Description 284 ILLEGAL COMBINATION OF HIGHLIGHT, SET_MODIFIED, PROTECTED 285 THE IMAGE OR FIELD WILL OVERWRITE NON-BLANK CONSTANT TEXT 286 THE IMAGE OR FIELD WILL OVERWRITE NON-BLANK EMPHASIS TEXT 287 SYSTEM-SUPPLIED FIELD EXCEEDS MAXIMUM LENGTH. TRUNCATED TO THE FINAL CURSOR POSITION HAS DEFAULTED TO THE FIRST I/O FIELD 289 INITIAL CHARACTER IS NOT SPECIFIED FOR RFB ATTRIBUTE 290 SECURITY-LEVEL MUST BE > 1 TO SPECIFY PROBLANK OR PRODATA 291 SECURITY-LEVEL MUST BE = 1 TO SPECIFY NORMAL SECURITY-FAIL ACTION 292 STORAGE TYPE VALUE SPECIFIED FOR COBOL OR FORTRAN - IGNORED 293 PREFIX VALUE SPECIFIED FOR FORTRAN - IGNORED HIGHLIGHT must be correct, SET_MODIFIED must be yes, and PROTECTED = NO to use these attributes in combination. Ignored You defined nonblank constant text over an image or a field. The text over the image or field is ignored. You defined nonblank emphasis text over an image or a field. The text over the image or field is ignored. You attempted to create a systemsupplied field with a length greater than 511. The length defaulted to 511. The final cursor position was deleted or modified to be an output-only field. You specified a value of YES for the replenish-for-blanks attribute, but you have not specified a replenish character. Ignored You specified a value of PROBLANK or PRODATA for the security-fail attribute and the security level equals 1. Default taken You specified a value of NORMAL for the security-fail attribute and the security level attribute is greater than 1. Default taken You specified a value other than D in GEN-WS-LANGUAGE of the GENERATE-WS-PKT when generating COBOL or FORTRAN working storage with D$DEFGENWS. Default taken You specified a value other than N in GEN-WS-PREFIX of the GENERATE-WS-PKTwhen generating FORTRAN working storage with D$DEFGENWS. Default taken C 17

340 D$DEF Messages Warning # Message Description 294 INITIAL VALUES VALUE SPECIFIED FOR FORTRAN - IGNORED 295 REDEFINITION VALUE SPECIFIED FOR FORTRAN OR UC - IGNORED 296 MARKING CHARACTER CANNOT BE A MASTERSPACE 297 MARKING CHARACTER CANNOT BE EQUAL TO FIELD CHARACTER 298 MARKING CHARACTER CANNOT BE EQUAL TO START/STOP IMAGE CHARACTER 299 MARKING CHARACTER CANNOT BE EQUAL TO ALPHABETIC CHARACTERS 300 MARKING CHARACTER CANNOT BE A NUMBER 301 MARKING CHARACTER CANNOT BE EQUAL TO TEXT CONSTANT VALUES 302 ALLOW QUERY NOT ALLOWED IN OUTPUT- ONLY FIELD 303 VALUE CHECK NOT ALLOWED IN FIELD EXCEEDING 16 CHARACTERS You specified a value other than N in GEN-WS-INITIAL-VALUES of the GENERATE-WS-PKTwhen generating FORTRAN working storage with D$DEFGENWS. Default taken You specified a value other than N in GEN-WS-REDEFINITION of the GENERATE-WS-PKTwhen generating FORTRAN working storage with D$DEFGENWS. Default taken You gave the marking character attribute the value of the masterspace(@). Default taken You gave the marking character attribute a value that is equal to the field character or alternate field character attributes. Default taken You gave the marking character attribute a value that is equal to the start image character or stop image character attributes. Default taken You gave the marking character attribute a value that is an alphabetic character (A through Z). Default taken You gave the marking character attribute a numeric value (0 through 9). Default taken You gave the marking character a value that is already defined as a text constant. Default taken Ignored You tried to attach the VC attribute to a field more than 16 characters long. Ignored C

341 D$DEF Messages Warning # Message Description 304 VALUE CHECK NOT ALLOWED IN OUTPUT- ONLY FIELD 305 UNKNOWN VALUE CHECK VALUE ENTER N, T, OR R 306 VALUE CHECK NOT ALLOWED ON FORM VALUE CHECK WILL NOT FUNCTION WITHOUT THE REPOSITORY 308 VC=T MAY ONLY BE USED ON ALPHA/ALPHANUMERIC FIELDS 309 VC=R MAY ONLY BE USED ON NUMERIC FIELDS You tried to attach the VC attribute to an output-only field. Ignored You specified a value other than N, T, or R for the VC attribute. Ignored The VC attribute cannot be used on form 0. Ignored The VC attribute cannot be used if DPS 2200 is not configured to use the repository. Ignored You specified a value of T for the VC attribute for a field that is not alphabetic or alphanumeric. Ignored You specified a value of R for the VC attribute for a field that is not numeric. Ignored C 19

342 D$DEF Messages C

343 Appendix D Sample Program Using D$DEF Routines This appendix provides an example of a program that defines forms using the more popular DPS 2200 functions and D$DEF routines. IDENTIFICATION DIVISION. PROGRAM-ID. deftest. AUTHOR. RENE S. DUPRE DATE-WRITTEN REMARKS. * THIS IS AN EXAMPLE OF A COBOL PROGRAM USING * SOME OF THE MORE POPULAR FUNCTIONS AND D$DEF ROUTINES. THIS PROGRAM * CAN BE RUN IN BOTH A DEMAND AND A TIP ENVIRONMENT. ENVIRONMENT DIVISION. CONFIGURATION SECTION. SOURCE-COMPUTER. UNIVAC OBJECT-COMPUTER. UNIVAC DATA DIVISION. WORKING-STORAGE SECTION. 77 SCR-NAM PIC X(10) VALUE SPACES. 77 SCR-NUM PIC 9(10) VALUE ZEROS. 77 END-MSG PIC X(80) VALUE SPACES. * HERE WE COPY ALL THE PROCEDURES THAT WE WILL NEED * COPY DPS-STATUS. COPY INFO-BUFFER. COPY SENDERROR. COPY DPS-NAMES. COPY DPS-OPTIONS. COPY DPS-ATTR-TABLE. COPY DEF-ATTRS. COPY SCREEN-TEMP HEADINGS. 05 CONSTANT-LEN PIC 9(5) COMP VALUE CONSTANT PIC X(25) VALUE THIS IS A CONSTANT FIELD! D 1

344 Sample Program Using D$DEF Routines / *************************************************************** **************************************************************** PROCEDURE DIVISION. 000-MAIN-PROGRAM. PERFORM 200-INIT-DPS. PERFORM 100-CHECK-PASS. PERFORM 210-TERM-DPS. STOP RUN. 100-CHECK-PASS. IF INFO-CONVERSATION NOT = Y PERFORM 110-FIRST-PASS ELSE PERFORM 120-SECOND-PASS. 110-FIRST-PASS. MOVE A TO SCR-NAM, S0-NAME. MOVE 45 TO SCR-NUM. PERFORM 400-CREATE-FORM. PERFORM 500-CREATE-CONSTANT-FIELD. PERFORM 510-CREATE-IO-NUM-FIELD. PERFORM 300-OPEN-SCREEN-0. PERFORM 220-SET-CONVERSATION. PERFORM 310-SEND-SCREEN-0. PERFORM 410-DELETE-FORM. 120-SECOND-PASS. PERFORM 320-READ-SCREEN-0. PERFORM 230-CLEAR-CONVERSATION. MOVE >> END OF D$DEF TEST!! << TO END-MSG. PERFORM 330-END-MESSAGE. / ************************************************************* * * * D P S E N V I R O N M E N T R O U T I N E S * * * ************************************************************* D

345 Sample Program Using D$DEF Routines 200-INIT-DPS. CALL D$INIT USING DPS-STATUS, INFO-BUFFER. IF STATUS-FATAL GO TO 900-ERROR-EOJ. 210-TERM-DPS. CALL D$TERM USING DPS-STATUS. IF STATUS-FATAL GO TO 900-ERROR-EOJ. 220-SET-CONVERSATION. CALL D$SETCV USING DPS-STATUS. IF STATUS-FATAL GO TO 900-ERROR-EOJ. 230-CLEAR-CONVERSATION. CALL D$CLCONV USING DPS-STATUS. IF STATUS-FATAL GO TO 900-ERROR-EOJ. ************************************************************ * * * D P S R O U T I N E S * * * ************************************************************ 300-OPEN-SCREEN-0. CALL D$OPEN USING DPS-STATUS, SCREEN-TEMP-0. IF STATUS-FATAL GO TO 900-ERROR-EOJ. 310-SEND-SCREEN-0. CALL D$SEND USING DPS-STATUS, SCREEN-TEMP-0. IF STATUS-FATAL GO TO 900-ERROR-EOJ. 320-READ-SCREEN-0. CALL D$READ USING DPS-STATUS, SCREEN-TEMP-0. IF STATUS-FATAL GO TO 900-ERROR-EOJ. 330-END-MESSAGE. CALL D$ENDMSG USING DPS-STATUS, END-MSG. IF STATUS-FATAL GO TO 900-ERROR-EOJ. / ************************************************************ * * * D P S D $ D E F R O U T I N E S * * * ************************************************************ 400-CREATE-FORM. MOVE 1 TO IMAGE-COUNT. MOVE 0 TO ATT-ENTRIES. MOVE SCR-NUM TO FORM-NUMBER. MOVE SCR-NAM TO IMAGE-NAME (1) D 3

346 Sample Program Using D$DEF Routines * ** DEFINE NUMERIC ATTRIBUTES FOR THE FORM PERFORM 525 DEF-NUM-ATT. MOVE D-ATT-ALL-FUNCTION-KEYS TO ATT-ID (ATT-ENTRIES). MOVE D-VAL-FKEY-ALL TO ATT-NUM-VALUE (ATT-ENTRIES). PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-TEST-MODE TO ATT-ID (ATT-ENTRIES). MOVE D-VAL-TEST-YES TO ATT-NUM-VALUE (ATT-ENTRIES). * ** CREATE THE FORM ** CALL D$DEFFRMCRE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. IF DEF-STATUS-FATAL GO TO 900-ERROR-EOJ. 410-DELETE-FORM. MOVE 1 TO IMAGE-COUNT. MOVE 0 TO ATT-ENTRIES. MOVE SCR-NUM TO FORM-NUMBER. MOVE SCR-NAM TO IMAGE-NAME (1). CALL D$DEFFRMDEL USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES. IF DEF-STATUS-FATAL GO TO 900-ERROR-EOJ. 500-CREATE-CONSTANT-FIELD. * ********************* * ** Constant Field ** * ********************* MOVE 2 TO IMAGE-COUNT. MOVE 0 TO ATT-ENTRIES. MOVE SPACES TO IMAGE-NAME (IMAGE-COUNT). * DEFINE NUMERIC ATTRIBUTES PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-VERT-DISPLACEMENT TO ATT-ID (ATT-ENTRIES). MOVE 5 TO ATT-NUM-VALUE (ATT-ENTRIES). PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-HOR-DISPLACEMENT TO ATT-ID (ATT-ENTRIES). MOVE 26 TO ATT-NUM-VALUE (ATT-ENTRIES). D

347 Sample Program Using D$DEF Routines PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-DIMENSION-WIDTH TO ATT-ID (ATT-ENTRIES). MOVE CONSTANT-LEN TO ATT-NUM-VALUE (ATT-ENTRIES). PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-OUTPUT-CONTENTS TO ATT-ID (ATT-ENTRIES). MOVE D-VAL-OUT-CONSTANT TO ATT-NUM-VALUE (ATT-ENTRIES). * ** DEFINE CHARACTER ATTRIBUTES PERFORM 526-DEF-CHR-ATT. MOVE D-ATT-INITIAL-VALUE TO ATT-ID (ATT-ENTRIES). MOVE CONSTANT-LEN TO ATT-SIZE (ATT-ENTRIES). MOVE 1 TO ATT-OFFSET (ATT-ENTRIES). MOVE CONSTANT TO DPS-ATTR-BUFF. * ** CREATE THE FIELD CALL D$DEFFLDCRE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. IF DEF-STATUS-FATAL GO TO 900-ERROR-EOJ. 510-CREATE-IO-NUM-FIELD. * ************************* * ** I/O Numeric Field ** * ************************* MOVE 0 TO ATT-ENTRIES. MOVE 2 TO IMAGE-COUNT. MOVE NUM1 TO IMAGE-NAME (IMAGE-COUNT). * ** DEFINE NUMERIC ATTRIBUTES PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-VERT-DISPLACEMENT TO ATT-ID (ATT-ENTRIES). MOVE 12 TO ATT-NUM-VALUE (ATT-ENTRIES). PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-HOR-DISPLACEMENT TO ATT-ID (ATT-ENTRIES). MOVE 36 TO ATT-NUM-VALUE (ATT-ENTRIES). PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-DIMENSION-WIDTH TO ATT-ID (ATT-ENTRIES). MOVE 8 TO ATT-NUM-VALUE (ATT-ENTRIES). PERFORM 525-DEF-NUM-ATT. MOVE D-ATT-DATA-TYPE TO ATT-ID (ATT-ENTRIES). MOVE D-VAL-DATA-NUMERIC TO ATT-NUM-VALUE (ATT-ENTRIES) D 5

348 Sample Program Using D$DEF Routines * ** CREATE THE FIELD CALL D$DEFFLDCRE USING DPS-STATUS, DPS-OPTIONS, DPS-NAMES, DPS-ATTR-TABLE, DPS-ATTR-BUFF. IF DEF-STATUS-FATAL GO TO 900-ERROR-EOJ. 525-DEF-NUM-ATT. ADD 1 TO ATT-ENTRIES. MOVE D-ATT-TYPE-NUMERIC TO ATT-TYPE (ATT-ENTRIES). 526-DEF-CHR-ATT. ADD 1 TO ATT-ENTRIES. MOVE D-ATT-TYPE-CHARACTER TO ATT-TYPE (ATT-ENTRIES). / ************************************************************ * * * D P S E R R O R R O U T I N E S * * * ************************************************************ 900-ERROR-EOJ. CALL D$DUMP. CALL D$CLCONV USING DPS-STATUS. CALL D$ERRMSG USING DPS-STATUS. CALL D$TERM USING DPS-STATUS. STOP RUN. D

349 Appendix E Sample Form Definition Using FLDP Processor This sample form can be defined by the source input stream that follows. FAMILY HISTORY FOR:, Date: (last) (first) (mi) Father s Name: (first) (mi) (last) Mother s Name: ( ) (first) (mi) (last) (maiden) Brothers Names: Sisters Names: First Last First Last More brothers? (Y or N) More sisters? (Y or N) The following form specifications apply to the definition. Define the brother and sisters names fields as a repeating image. Define the more brothers and `more sisters questions as ON/OFF fields E 1

350 Sample Form Definition Using FLDP Processor The following example uses the TEMPLATE command to define the layout of the form, and then uses command and definition statements to define the attributes of the entities. Some abbreviations and positional notations are used to illustrate their usage in a definition. FORM NAME=Family NUMBER=100 STORAGE GENERATE,FCA GENERATE_PREFIX=YES TEMPLATE FIELD_CHARACTERS="^" STA_IMA="" STO_IMA="" FAMILY HISTORY FOR: ^ ^ ^ ^ ^ ^ ^ ^, ^ ^ ^ ^ ^ ^ ^ ^ ^ Date: ^ (last) (first) (mi) Father s Name: ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ (first) (mi) (last) Mother s Name: ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ( ^ ^ ^ ^ ^ ^ ^ ^ ) (first) (mi) (last) (maiden) Brothers Names: Sisters Names: First Last First Last [ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ] [ More brothers?(y or N) ^ ] [ More sisters?(y or N) ^ ] *END FIELD NAME=Last STRING_NUMBER=1 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL HIGHLIGHT REVERSE GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=First STR_NUM=2 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL HIGHLIGHT REVERSE GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Middle STR_NUM=3 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL HIGHLIGHT REVERSE GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD E

351 Sample Form Definition Using FLDP Processor FIELD STR_NUM=4 OUTPUT_ATTRIBUTES CONTENTS=SYSTEM SYS_VAL=DATE_1 END_FIELD FIELD NAME=Dadfirst STR_NUM=5 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Dadmi STR_NUM=6 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Dadlast STR_NUM=7 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Momfirst STR_NUM=8 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Mommi STR_NUM=9 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Momlast STR_NUM=10 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD E 3

352 Sample Form Definition Using FLDP Processor FIELD NAME=Mommaiden STR_NUM=11 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD IMAGE STR_NUM=12 REPEAT_IMAGE COUNT=7 INDEX_ITEM=Syblings FIELD NAME=Brofirst STR_NUM=13 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Bromi STR_NUM=14 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Brolast STR_NUM=15 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Sisfirst STR_NUM=16 STORAGE DATA_TYPE=ALPHABETIC ; TAB multi command example GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Sismi STR_NUM=17 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD FIELD NAME=Sislast STR_NUM=18 STORAGE DATA_TYPE=ALPHABETIC TAB NORMAL GENERAL_EDIT USAGE=INPUT_OUTPUT PRO=NO SET_MOD=NO DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD END_IMAGE E

353 Sample Form Definition Using FLDP Processor IMAGE NAME=More-on STR_NUM=19 OUTPUT_ATTRIBUTES state is ON FIELD NAME=Morebro STR_NUM=20 TAB NORMAL STORAGE DAT_TYP=ALPHABETIC GENERAL_EDIT DIS=REPLENISH_FOR_BLANKS PREDEFINED_VALUE REPLENISH_STRING="_" END_FIELD END_IMAGE IMAGE NAME=More-on2 STR_NUM=21 OUTPUT_ATTRIBUTES state is OFF FIELD NAME=Moresis STR_NUM=22 TAB NORMAL STORAGE DAT_TYP=ALPHABETIC GENERAL_EDIT DIS=REP_FOR_BLA PRE_VAL REP_STR="_" END_FIELD END_IMAGE END_FORM E 5

354 Sample Form Definition Using FLDP Processor E

355 Glossary A absolute element An executable, machine-language element produced by the Collector, one of the system processors. Absolute elements are created from user-defined relocatable elements, together with elements from the relocatable subroutine library. access privilege The privilege level of an activity while it is executing a specific level of software. It also defines the access control for a bank (in other words, the level of software that can access the bank). As a result, it is part of the access key for an activity and access lock for a bank. ACOB Abbreviation for ASCII COBOL compiler. Also, ASCII COBOL programming language. See COBOL. alphabetic item An item that consists of a combination of letters A to Z and spaces. alphanumeric A field type within DPS 2200 based on the COBOL X data type. In FORMGEN, this is specified with the X field type and in FLDP with STORAGE DATA_TYPE=ALPHA_NUMERIC. This field type lets the user enter any of the printable ASCII or katakana characters during input. alphanumeric item A data item that consists of a combination of any of the allowable characters in the ASCII character set. alternate DPS 2200 system A DPS 2200 system that is not the main production system, but is installed on the same machine. The alternate DPS 2200 feature was implemented in DPS 2200 level 3R1to provide a way to migrate to new DPS 2200 levels without affecting the production environment. ANSI APL Abbreviation for American National Standards Institute. Abbreviation for A Programming Language. It is an algorithmic and procedural language used primarily at interactive terminals Glossary 1

356 Glossary application group A group consisting of an integrated recovery database, audit trail, data dictionary (optional), and message retention files. application program A COBOL, FORTRAN, or C program written to create, access, retrieve, and update information in the database. Application programs include data manipulation language (DML) commands. ASCII Abbreviation for American Standard Code for Information Interchange. An 8-bit code used to represent data and certain machine statements (such as a carriage return). ASCII is used in both computers and data communications. Unlike Fieldata, ASCII can represent both uppercase and lowercase letters, as well as numbers and special characters. ASCII COBOL compiler See ACOB. assign To designate a file for use by your run. You cannot use a file unless it is assigned to your run. Internally, a file is assigned to your run when it is listed on your run's program control table. When a file is no longer assigned to your run, it is said to be released from your run. attribute A characteristic describing a property of a form, image, or file (for example, color or length). auto save count A number that specifies how often you want FORMGEN to save the data defining the current form in the autorecovery file. The data is saved after you press XMIT but before data in the workspace is changed. autoflag A build directive for DPS 2200 instructing the build procedure to use the options required for the COBOL flagging compiler. auto-undo The capability to revert the FORMGEN workspace to the state where it was just before the last update transmit. B background color (1) This attribute specifies the color of the background area of a screen. (2) The BC attribute in FORMGEN. back-to-back Pertaining to consecutive fields with no blanks between them. Glossary

357 Glossary bank (1) The basic program entity for which storage allocation is required. (2) A discrete portion of a program that, when loaded into main storage, occupies a contiguous portion of space (physical addresses). bank descriptor index (BDI) An unsigned integer in the range of zero to n-1, where n is the maximum number of BDIs allowed in a given bank descriptor table. The integer is used to locate a bank descriptor in this table. basic mode The mode of address generation and instruction execution that does not use virtual addressing. TIP primitives are supported in basic mode. basic mode bank A bank that can be accessed only through the basic mode addressing and execution environment. batch mode The mode of execution that is designed to process a run from start to finish without further instructions from the programmer. These runs use routine and repetitive functions, process large amounts of data, or require a lot of processing time. Contrast with demand mode. BC BDI See background color. See bank descriptor index. blank if zero (1) An attribute that commands DPS 2200 to display a field as blank if the value in working storage for that field is zero. (2) The BZ attribute in FORMGEN. BLNK (1) An attribute that commands DPS 2200 to store blanks in a working storage data item if the field is entered as blanks during input. (2) The BLNK attribute in FORMGEN. breakpoint To divert output from the PRINT$ file (the primary print file for batch runs) or the terminal display (demand runs) to a user-defined print file. Use statement to perform a breakpoint on a file. BZ See blank if zero Glossary 3

358 Glossary C catalog To create a permanent file by entering information about the file in the master file directory. coded character set (CCS) A set of unambiguous rules that establish a character set and the one-to-one relationship between each character of the set and its bit representation. CDML Abbreviation for ASCII COBOL Data Manipulation Language. center justification This attribute commands DPS 2200 to center justify a field during output. character set The Data Management System (DMS 2200) character set that contains the entire International Organization for Standardization (ISO) character set of letters, digits, symbols, punctuation marks, and spaces. CJ See center justification. clearance level A hierarchical classification for files, tape volumes, and subsystems. Clearance levels can range from 0 to 63, with 63 being the most restrictive. CMS 1100 See Communications Management System. COBOL Abbreviation for Common Business Oriented Language. A widely used programming language, intended primarily for business applications. In COBOL, instructions are patterned after English language sentences. Collector A system processor that joins relocatable elements into an absolute element. Collector directive An instruction to the Collector that lets the programmer direct and control the collection process. Either include Collector directives in the runstream itself (after statement) or add them from a symbolic element. common bank A bank that can be an active part of more than one program at a time. Communications Management System (CMS 1100) The real-time program that handles message transfers between a specific user terminal, TIP application programs, and database. See COMPOOL. Glossary

359 Glossary COMPOOL A component of CMS 1100 that is the default message handler for TIP. COMPOOL records are used to transfer data from one program to another, initiate scheduling of the input transaction, and transfer output to a terminal. The Message Control Bank (MCB) is an alternative to COMPOOL for TIP message handling. COMUS An interactive software installation and maintenance program used to install TIPUTIL and other OS 2200 products. COMUS configure A utility that runs after the SYS FIN. COMUS configure lets you change the component status in the master configuration table (MCT). constant fields Part of the base form. You can create a constant field (literal or text) separately as different fields, but you modify, retrieve, or delete them as a single field. control page The control and status information stored in a dedicated location in a terminal's memory. This information controls data transfers to and from peripherals and the type of transmission to the host. constant field Part of the base form; may be literal or text. You can create constant fields separately as different fields, but you modify, retrieve, or delete them as a single field. CR See credit sign. credit sign (1) This attribute commands DPS 2200 to place a credit sign at the end of a negative field. (2) The CR attribute in FORMGEN. D data administrator The person who defines storage areas, allocates file space, maintains data security, and monitors the overall network and relational database development and production. Data Management System (DMS 2200) A hierarchical database system within UDS that uses TIP file control. Data Management Utility (DMU) A collection of routines used to do a variety of utility functions on a Data Management System database. This utility is available for DMS 2200 users. data manipulation language (DML) The language interface between ASCII COBOL and ASCII FORTRAN user programs and the database in a Data Management System (DMS 2200) Glossary 5

360 Glossary Data Reorganization Utility (DRU) A DMS 2200 utility provided for network database users to allow their schemas to be changed and areas to be reorganized according to the changes specified. The DRU can be used to reorganize hierarchical databases created with DMS DB See debit sign. debit sign (1) An attribute that commands DPS 2200 to place a debit sign at the end of a negative field. (2) The DB attribute in FORMGEN. DEC default DEL delete (1) An attribute that commands DPS 2200 to display a binary field in decimal characters. (2) The DEC attribute in FORMGEN. The value the system uses for a parameter when none is specified on a control statement. (1) An attribute that commands DPS 2200 to insert a comma as a delimiter before every third digit preceding the decimal point. (2) The DEL attribute in FORMGEN. To remove a file from the master file directory or mark an element in a program file as deleted, by using statement. When files are deleted, they are removed immediately. When elements are deleted, they are not physically removed until the file is packed with statement. demand mode The mode of execution that processes a run interactively as it is entered from a terminal. Demand mode lets you correct errors immediately and get answers quickly. Contrast with batch mode. demand run A run entered interactively at a terminal. Demand runs let you correct errors immediately and get answers more quickly than you could by using batch runs. demand terminal A terminal from which demand runs can be submitted. DIAG$ A diagnostic file used to store the contents of the system's storage areas at the time a program terminates. A printout or dump of the information saved in the DIAG$ file can be produced by using the PostMortem Dump processor. DISENG The form library used by DPS 2200 to store forms used by the DPSIF and DPSPW processors. Glossary

361 Glossary display positive sign (1) An attribute that commands DPS 2200 to display positive and negative signs. (2) The DPS 2200 attribute in FORMGEN. Display Processing System (DPS 2200) An OS 2200 product that manages display-oriented transactions in an online environment. Display Processing System File Initialization Processor (DPSIF) A DPS 2200 processor that is used to initialize files. Display Processing System User-id/Password Processor (DPSPW) A DPS 2200 processor that is used to maintain user-id records and user profiles. DML See data manipulation language. DMS 2200 A system of components that implements, manages, and protects large-scale databases. DMU DPS DPSIF DPSPW See Data Management Utility. See display positive sign. See Display Processing System File Initialization Processor. See Display Processing System User-id/Password Processor. DPS 2200 See Display Processing System. DRU DS40 See Data Reorganization Utility. A mnemonic for DATASPEED 40 terminals. dynamic bank The banks that are loaded only when actually in use (based or with outstanding I/O) Glossary 7

362 Glossary E EC ECL EM EMP Allows both uppercase and lowercase characters. The EC attribute in FORMGEN. See Executive Control Language. See extended mode. An attribute that defines the emphasis characters. The EMP attribute in FORMGEN. emphasis constant A field identical to a constant field, except for containing emphasis text. Emphasis text represents underscore, strike-through, and left-column separator emphasis. EOC EOI EOM EOT ER Abbreviation for end of character. Abbreviation for end of input. Abbreviation for end of message. Abbreviation for end of transmission. See Executive request. error message The text explaining each command's error status. ETX Abbreviation for end of text. emphasis constant Identical to a constant field, except that is contains emphasis text. Emphasis text represents underscore, strike-through, and left-column separator emphasis. Exec See Executive. Executive A software program supplied by Unisys that controls the system's operating environment. The Executive processes user runs, controls files, manages the system's resources, and performs input/output operations for the user. The Executive is the central component of the operating system (OS 2200) and enforces security control. Glossary

363 Glossary Executive Control Language (ECL) The interface between programmers and the operating system. It provides a set of statements to start and control runs; generate and execute programs; create, delete, erase, copy, and otherwise manipulate files; and send messages to the console and other terminals. Executive request (ER) A set of programmed instructions that lets the Executive perform service functions such as reading and printing data and terminating a program. Selected ERs affect system security. The ability to execute these ERs is controlled, and this lets specified users override security restrictions and validations. EXP (1) An attribute that specifies whether exponential notation is allowed in a real or doubleprecision field. (2) The EXP attribute in FORMGEN. EXPOOL Executive buffer pool. An area of the OS 2200 used by the operating system as temporary data space. extended mode The mode of execution that allows 16 base registers, increased address space, and additional machine instructions. extended mode addressing A form of addressing that uses virtual addressing. F F FAS FC (1) An attribute that specifies that alphabetic and alphanumeric fields must contain nonblanks, and numeric and computational fields must contain nonzeros. (2) The F attribute in FORMGEN. See File Administration System. See foreground color. Federal Information Processing Standards (FIPS) A set of data processing standards adopted by the United States Government. FI field See foreground intensity. The part of an image or form where you can enter information. A field, defined by field or alternate field characters, can extend across multiple lines. A field does not include the literal text (label) that defines the field. It can be input/output (I/O), output-only (OO), or system defined Glossary 9

364 Glossary field spanning line A line that ends in the last column of one line and continues in the first column of the next line. File Administration System (FAS) A software product used by the site coordinator to plan, control, and monitor the files and mass storage space in the system. FAS provides a virtual mass storage system, backup and recovery of files, reports on user's files, and a way to retain files in a directory other than the master file directory (archival storage). File Utility Routines/Program File Utility Routines (FURPUR) A system processor used to manipulate files. With ECL statements, you can use FURPUR to copy files and elements, position tapes, delete files and elements, erase files, and list file information. FIPS See Federal Information Processing Standards. fixed field position (1) An attribute that specifies that the field is not to be moved if the size or position of the preceding field changes. (2) The FPOS attribute in FORMGEN. FLDP FMS FONT See Form Language Definition Processor. (1) An attribute that commands DPS 2200 to display a floating monetary sign. (2) The FMS attribute in FORMGEN. (1) An attribute that specifies the character font. (2) The FONT attribute in FORMGEN. foreground color (1) An attribute that specifies the color of the foreground area of a screen. (2) The FC attribute in FORMGEN. foreground intensity (1) An attribute that specifies the intensity of the foreground area of the text part of the display. (2) The FI attribute in FORMGEN. form The template that comprises images and fields. FORMGEN A DPS 2200 component for defining, modifying, and deleting forms. Form Language Definition Processor (FLDP) The DPS 2200 processor used to create forms that are identical to those produced by the FORMGEN processor and the D$DEF routines. form library Files for storing forms. They can be Exec or TIP files and are direct access files unique to DPS They are not program files or SDF files. Glossary

365 Glossary FPOS See fixed field position. full-screen mode A special input mode that lets the you enter data and statements a full screen at a time, instead of a line at a time. You enter full-screen mode with statement. The screens of information are not processed until the operator terminates full-screen mode with FUL statement. Full-screen mode allows you to disregard the position of the cursor when you transmit; all changes made to the form are saved regardless of cursor position. fundamental security The basic security software included with OS 2200 upon which all other security options are based. FURPUR See File Utility Routines/Program File Utility Routines. G General Purpose Typical Exec (GPTE) A configuration supplied by Unisys. Configuration probing tailors this configuration by marking what is not available in the master configuration table. All GPTE sites have the same Exec absolute. GPTE See General Purpose Typical Exec. H HAA HI See Heritage Application Access. See highlight. Heritage Application Access (HAA) A component of the Unisys TransIT Open/OLTP suite of products. TransIT Open/OLTP provides an open environment for distributed transaction processing (DTP). DTP is a form of computing that enables multiple application programs, possibly on different computers, to share resources and to participate in transactions. HAA provides protection in your investment in existing, non-distributed transactions (heritage application programs) by allowing them to be called in a DTP environment. highlight (1) An attribute that specifies the highlighting of the text part of the display. (2) The HI attribute in FORMGEN Glossary 11

366 Glossary High-Volume Transaction Processing (HVTIP) A specialized technique used for applications requiring a high rate of throughput, and whose processing of a transaction may pass through an arbitrary sequence of subprograms. HVTIP See High-Volume Transaction Processing. I IBM3270 Mnemonic for the IBM 327x family of terminals. image Part of a form. There are ON/OFF, linked, and repeat images. The attributes of an ON/OFF image can be different from the attributes of the form it is part of. An image is separately defined and controlled with start and stop image characters and can be part of vertical and horizontal repeat images. An image may comprise nested images or fields. integrated recovery The OS 2200 features that encompass database recovery for TIP and UDS and message recovery for TIP/MCB and CMS The integrated recovery system is an umbrella term for all the software that works together as a subsystem to the operating system and its surrounding environment. internal image name Repeat images, linked ON/OFF images, and system-supplied, constant, and emphasis constant fields do not have names. To reference them, the create routines return an internal image name. The format of this name is IMG$n, where n is the number of the unnamed field or image. The internal name for a constant is always IMG$0. The internal name for an emphasis constant is always IMG$E0. L left justification (1) An attribute that commands DPS 2200 to left-justify a field during output. (2) The LJ attribute in FORMGEN. Linking System An OS 2200 product that is used to produce executable TIP elements. UCS compilers are used to produce standard object modules for TIP batch, demand, and transaction programs. The static linker is used to create zero overhead object modules (ZOOM) from UCS- or MASM-generated object modules, other ZOOMs, or a mixture of object modules and ZOOMs. See also object module, Universal Compiling System, zero overhead object module (ZOOM). LJ See left justification. Glossary

367 Glossary LMS (1) An attribute that commands DPS 2200 to display a leading fixed monetary sign. (2) The LMS attribute in FORMGEN. logical COMPOOL record A chain of physical COMPOOL blocks identified by a COMPOOL-id. When a user program reads (or writes) a logical COMPOOL record, the data is transferred from the various physical COMPOOL blocks to the user's buffer as a contiguous record (or vice versa). long message output A DPS 2200 configuration directive that enables the sending of large messages to a terminal. LS LZD (1) An attribute that commands DPS 2200 to display a leading numeric sign. (2) The LS attribute in FORMGEN. (1) An attribute that commands DPS 2200 not to suppress leading zeros during output. (2) The LZD attribute in FORMGEN. M MCB See Message Control Bank. Message Control Bank (MCB) A common bank that interfaces with the Communications Management System (CMS 1100) and transaction programs to provide message recovery and transaction scheduling. CMS 1100, TIP file control, and Exec step control use the MCB to interface message recovery and transaction scheduling information. message parameter area (MPA) The 16-word header of the logical COMPOOL record. MOD MPA MWID (1) An attribute that commands DPS 2200 to set the modified bit during output. (2) The MOD attribute in FORMGEN. See message parameter area. (1) An attribute that specifies the maximum width for a variable-width field. (2) The MWID attribute in FORMGEN Glossary 13

368 Glossary N NIB NJ NMS (1) An attribute that commands DPS 2200 not to store zeros or blanks in working storage if the field is entered as blanks during input. (2) The NIB attribute in FORMGEN. See no justification. (1) An attribute that commands DPS 2200 not to display a monetary sign. (2) The NMS attribute in FORMGEN. no justification (1) An attribute that commands DPS 2200 not to justify a field during output. (2) The NJ attribute in FORMGEN. NS (1) An attribute specifying that a field does not have a sign and that it cannot be negative. (2) The NS attribute in FORMGEN. O object module (OM) An element in a program file that is produced by a language processor or the static linker. It contains bank templates that can be used to create banks. OCT (1) An attribute that commands DPS 2200 to display binary fields in octal format. (2) The OCT attribute in FORMGEN. online batch TIP program A batch program that is scheduled by the transaction system rather than by a batch runstream. This program has a main storage allocation at the same priority as the batch run, and it runs at a lower priority than the transactions. This type of TIP program uses the CONECT primitive to provide an interface to the TIP facilities. Unlike a batch- CONECT program, it is scheduled by TIP from the online program file and must have a VALTAB entry. operating system (OS) A set of programs that performs housekeeping tasks on a system. The OS includes the entire set of system software available for the system that is either a part of, or operates under, the Exec system. OS See operating system. Glossary

369 Glossary P parameter Any value on a control statement. For example, labels, options, and fields are parameters. partial send A DPS 2200 feature (configuration directive is TRANSMIT OUTPUT CHAN) that lets you specify the fields on a terminal that should be refreshed on subsequent transfers of the same screen. password A string of characters you must enter correctly before you can use the system. Each user-id has its own unique password. Passwords are a way to prevent others from using your user-id. physical COMPOOL block A physical record on mass storage or in main storage (in the CMS 1100 D-bank) that is part of a logical COMPOOL record. PID PLE PLUS PMD See position identifier. See problem list entry. A compiler used to generate and maintain Unisys software. See PostMortem Dump processor. position identifier (PID) The internal number used by TIP to address a terminal. PostMortem Dump processor A system processor that produces a printout (dump) of the main storage a program occupied when it terminated. print file A special data file used for information that is to be printed. A user can divert output to or from a print file with statement. PRINT$ PRO The primary print file for batch runs. The PRINT$ file stores the runstream itself and all output produced during the run. After the run terminates, the PRINT$ file is automatically printed. (1) An attribute that specifies whether to protect the data when it is displayed. (2) The PRO attribute in FORMGEN Glossary 15

370 Glossary problem list entry (PLE) A PRIMUS document containing a description of a system software or hardware problem and a detailed description of the resolution to that problem. A PLE is generated when the responsible organization determines how to resolve the problem submitted on a UCF. The information in a PLE should be technically and professionally correct. processor call statements A group of ECL statements that are used to call the system processors and compilers. statement, for example, is used to call the FORTRAN compiler. All processor call statements follow the same basic format. project-id A name or number used to classify a run for file access and accounting purposes. The user's project-id is also used as the qualifier for file names when none is specified. public file A file that everyone has access to. Anyone who wants to use a private file, on the other hand, must use the same project-id or account number as the person who created the file. Q qualifier A string of characters used to prefix a file name to make the name unique. The qualifier is separated from the basic file name with an asterisk (for example: QUAL*FILE). If a user does not provide a qualifier when a file is named, the system uses the user's project-id. R READ$ The primary input file for batch runs. READ$ serves as a holding area for the runstream. During the course of the run, the Exec retrieves the ECL statements, data, and other images from the READ$ file and processes them in order. relocatable subroutine library (SYS$RLIB$) A component of the operating system that contains subroutines for use by a user. For example, you can perform sort and merge operations and mathematical calculations. Resident Transaction Program System (RTPS) A feature that allows transaction programs to be loaded and permanently "stuck" in realtime position in main storage. The program can then process incoming transactions without constant program reloading. restart To return to a previous checkpoint and continue the run from there, instead of starting over from the beginning. Runs are often restarted after an error or malfunction occurs. Glossary

371 Glossary right justification (1) An attribute that commands DPS 2200 to right-justify a field during output. (2) The RJ attribute in FORMGEN. RJ RO RTPS run-id See right justification. Abbreviation for relocatable output. See Resident Transaction Program System. A string of characters that identifies a run to the Exec. Provide the run-id on statement. S SBR Abbreviation for System Base Release. SCRFIELDS The DPS 2200 build directive that defines the maximum number of fields in a form. scratch pad A temporary area in storage containing the data defining a marked area. SECF SECL SECT SDF (1) An attribute that specifies the action if a security check fails. (2) The SECF attribute in FORMGEN. (1) An attribute that specifies the security level of a field or image. (2) The SECL attribute in FORMGEN. (1) An attribute that specifies the security type: hard or soft. (2) The SECT attribute in FORMGEN. Abbreviation for system data format. SDF files See system data format files. scratch pad A temporary area in storage containing the data defining a marked area. screen The part of a terminal used to display data Glossary 17

372 Glossary security level The executing clearance level and compartment set for a subject; the clearance level and compartment set for an object. session SGS SIMAN A connection with an OS 2200 system using batch, demand, or TIP mode. The OS 2200 system requires all users to be validated (user-id/password) and ensures that all users are executing with a valid clearance level, compartment set, account number, and project-id. See stream generation statement. See Site Management Complex. Site Management Complex (SIMAN) An interactive software product that security officers, site administrators, and users use to install and update records in the security systems and resource control databases. site-id SSG A string of characters that identifies a terminal. Site-ids are assigned when a system is installed. See symbolic stream generator. stateless environment An environment in which you can modify existing forms in any order; you are not forced to follow a predetermined sequence. status A value returned by the called system or device indicating the results of that call. stream generation statement (SGS) A statement that COMUS uses to set or change system values during generation. There are two types of SGSs: control and application. Control SGSs direct the execution of the generation. Application SGSs define the characteristics of application routines you want to maintain. subfield A subdivision within a field. Slashes (/) are used to separate subfields. When subfields are used, they represent separate but related parameters. SUPUR program file A TIP user file that you designate with the SUPUR utility as a storage area for non HVTIP application programs. In a conventional transaction environment, you get better performance with SUPUR program files, and you can update them more easily than the standard online files. Glossary

373 Glossary SUPUR utility A TIP utility you can use to create and maintain SUPUR program files. It is part of a system that lets you replace any transaction program in a SUPUR program file while it is being used in an active TIP scheduling environment. symbolic stream generator (SSG) A general-purpose interpreter that manipulates symbolic streams. It maintains symbolic streams that a user can list, correct, and update to use later. SYSLIB System service routine library. Its file name is SYS$LIB$*SYSLIB. It contains system definitions and procedures, processor interface routines, and utility routines. SYS$*LIB$ Abbreviation for system library. SYS$*RLIB$ See relocatable subroutine library. system absolute library The system absolute library file used to store the system processors and language processors (compilers). The file name is SYS$*LIB$. system data format (SDF) files Files that contain only symbolic images (data, directives, or runstreams) in system data format. They are commonly used as print files or for data storage. system generation The process of tailoring the operating system to the particular hardware configuration and software requirements of a site. The end result of a system generation is a tape that contains a copy of the operating statement, system relocatable library See relocatable subroutine library. T TAB (1) An attribute that commands DPS 2200 to place a tab stop at the beginning of a field. (2) The TAB attribute in FORMGEN. table of contents (TOC) A directory in a program file that is used to keep track of the elements, entry-points, and procedures. The table of contents comprises an element table, three procedure tables, and an entry-point table. TDEP See test dependent Glossary 19

374 Glossary temporary file A file that exists only for the duration of a run. When the run terminates or if you release the file from your run, it no longer exists. temporary program file (TPF$) A mass storage file assigned automatically by the Exec to each run. test dependent (1) An attribute that specifies whether to check the terminal test mode before displaying the field or image. (2) The TDEP attribute in FORMGEN. text constant Characters that define elements such as field tables, column tables, titles, and so forth. These characters do not make up a field and they take on the attributes of the defined form. TIP See Transaction Processing. TIP application group An application group used in the TIP environment. See application group. TIP primitives The assembler language subroutines written for TIP to provide an interface to the TIP/Exec Executive requests or extended mode calls. They provide the correct calling sequence for system services and give you a fixed interface between your program and TIP. TIP program validation table (VALTAB) A TIP system file containing transaction code definitions called VALTAB entries and information on the characteristics of the associated transaction programs. TIP session control feature A security feature that validates the user security identity (user sign-on and security record) as a communications path is opened to a terminal through CMS This feature also identifies all work done by a user in the TIP system. This feature is available with all levels of security. TMODE TOC TPF$ A DPS 2200 program that lets you turn the test mode on and off for an executing terminal. See table of contents. A temporary program file that the system automatically creates for each active run. TPF$ can be used as a working file during a run. Glossary

375 Glossary Transaction Processing (TIP) A modular extension of the OS 2200 Exec system that provides a high-performance system for real-time processing in which a user causes the execution of a predefined transaction program by entering an input message from a remote terminal. The program accesses the application database and returns a response to the user. TS TTYPE (1) An attribute that commands DPS 2200 to display a trailing numeric sign. (2) The TS attribute in FORMGEN. A DPS 2200 program that enables a user to specify the terminal type or to ask DPS 2200 what terminal type is currently specified for that terminal. U UC UCF (1) An attribute that commands DPS 2200 to convert all input and output to uppercase. (2) The UC attribute in FORMGEN. See User Communication Form. Universal Compiling System (UCS) A system for compiling extended mode programs written in UCS FORTRAN, UCS COBOL, or UCS C. The UCS compilers produce an absolute element in a standard form called an object module. UCS and the Linking System allow object modules written in different languages to be linked together as a program. See also Linking System and zero overhead object module. Universal Data System (UDS) A modular collection of related Unisys products used for database management. UPA See user parameter area. User Communication Form (UCF) A PRIMUS document containing a description of a system software or hardware problem. A UCF is generated by a customer and contains a description of the problem and a description of the product running when the problem occurred. A PLE is generated when the responsible organization determines how to resolve the problem submitted on a UCF. The information in a PLE should be technically and professionally correct. user-id A string of characters used to identify an individual using the system. user parameter area (UPA) A parameter area that immediately follows the message parameter area (MPA) in the COMPOOL record. Its length can be configured and it can contain any information you specify Glossary 21

376 Glossary user security record A record attached to your user-id that specifies security attributes establishing the range and limits within which you may access objects. UTS Universal Terminal System terminals. V validation table (VALTAB) See TIP program validation table. VALTAB entry The transaction code definitions produced by the VTBUTL utility and maintained in the VALTAB. A VALTAB entry tells the system which program to execute in response to a transaction code, and it controls the way the system uses the program. value A characteristic assigned to an item, such as an attribute. It can contain alphabetic, numeric, or special characters. value check (VC) A DPS 2200 field attribute specifying that data entered in the field at run-time must be validated against either a user defined table of values or a user defined range. variable position (VPOS) A DPS 2200 field or image attribute specifying that a field can be moved if the size of the preceding field is changed or moved. variable width (VWID) A DPS 2200 field or image attribute that lets you specify variable widths for fields. VINDEX The index for the VALTAB that identifies transaction programs by 6-character action codes. VPOS See variable position. VTBUTL utility A utility that defines the transaction codes for your system and produces the VALTAB entries. VWID See variable width. Glossary

377 Glossary W working storage A data structure that defines a form. The working storage for a form is copied or included in a COBOL, FORTRAN, or C application program when it is compiled. The working storage enables a program to access the data entered in a form and also to change the data that is displayed in a form. workspace A temporary area in storage reserved for you use while you create a new form or change an existing form. X XDEF Abbreviation for external definition. Z ZB See zero if blank. zero if blank (1) An attribute that commands DPS 2200 to display zeros in a field if the value in working storage for that field is blank. (2) The ZB attribute in FORMGEN. zero overhead object module (ZOOM) The object module that supports TIP. A ZOOM is similar to a standard object module in that it is an executable absolute element with a nonzero subtype. The subtype for a ZOOM is unique to distinguish it from standard object modules. The static linker is used to produce a ZOOM from one or more standard object modules, other ZOOMs, or a mix of object modules and ZOOMs. ZOOM See zero overhead object module Glossary 23

378 Glossary Glossary

379 Index A applications programs interface to, 1-5 attributes D$DEF, 6-5 B BACKGROUND_ATTRIBUTES statement, 4-19 C calling FLDP, 4-4 calling FLMU, 5-1 calling FORMGEN, 2-4, 3-1 calling statements FLDP, 4-4 FLMU, 5-1 FORMGEN, 3-1 changing constants, 6-16 CHARACTER_ATTRIBUTES statement, 4-20 CHECKNUMBER_TEST statement, 4-20 commands FLDP explanation, 4-6 FIELD, 4-15 FORM, 4-7 image, 4-11 TTEMPLATE, 4-10 comparing check numbers, 4-20 components additional, 1-6 controlling conversation mode, 4-21 CONVERSATION statement, 4-21 copy procedures D$DEF attribute identifiers, 6-5 explanation, 6-4 names parameter, 6-4 copying marked areas, 3-37 creating new fields, 6-16 creating ON/OFF images, 6-21 creating routines D$DEF D$DEFFLDCRE function, 6-16 D$DEFIMGCRE, 6-21 explanation, 6-16 creating temporary forms, 6-20 CURSOR statement, 4-21 D D$DEF attributes, 6-5 D$DEF file access authorities, 6-39 D$DEF routines copy procedures, 6-4 creating routines, 6-16 definition, 1-5 deleting routines, 6-35 explanation, 6-1 form library access routines, 6-38 miscellaneous routines, 6-44 modifying routines, 6-24 retrieving routines, 6-28 D$DEFERASE function, 6-39 D$DEFFLDCRE function, 6-16 D$DEFFLDDEL function, 6-35 D$DEFFLDMOD function, 6-25 D$DEFFLRET function, 6-29 D$DEFFRMCRE function, 6-20 D$DEFFRMMOD function, 6-26 D$DEFFRMRET function, 6-30 D$DEFGENWS function, 6-46 D$DEFIMGDEL function, 6-37 D$DEFIMGMOD function, 6-27 D$DEFIMGRET function, 6-31 D$DEFLOAD function, 6-40 D$DEFNAMRET function, 6-32 D$DEFPRINT function, 6-44 definiltion statements OUTPUT_ATTRIBUTES, 4-33 defining attributes, Index 1

380 Index defining decimal characters, 4-23 defining editing attributes, 4-25 defining fields and constants, 2-9 defining form attributes, 2-6 defining form dimensions, 4-22 defining form-level attributes, 6-20 defining forms, 4-7, 4-10 defining marking characters, 3-36 defining output characters, 4-33 defining user profiles, 3-9 definition statements BACKGROUND_ATTRIBUTES, 4-19 CHARACTER_ATTRIBUTES, 4-20 CHECKNUMBER_TEST, 4-20 CONVERSATION, 4-21 CURSOR, 4-21 DIMENSION, 4-22 EDIT_SYMBOL, 4-23 EMPHASIS, 4-24 explanation, 4-19 FORGROUND_ATTRIBUTES, 4-24 FUNCTION_KEYS, 4-25 GENERAL_EDIT statement, 4-25 HIGHLIGHT, 4-30 INPUT_ATTRIBUTES, 4-31 POSITION_IMAGE, 4-35 PREDEFINED_VALUE, 4-36 REPEAT_IMAGE statement, 4-38 SECURITY, 4-40 STORAGE statement, 4-42 TAB, 4-44 TEST, 4-44 deleting forms, 2-19 deleting images, 6-37 deleting routines D$DEF D$DEFFLDDEL, 6-35 D$DEFFRMDEL function, 6-36 D$DEFIMGDEL function, 6-37 explanation, 6-35 deleting temporary forms, 6-36 deleting text constants, 6-35 describing character data, 4-20 DIMENSION statement, 4-22 discarding form changes, 3-3 DPS 2200 capabilities, 1-3 components, 1-5 definition, 1-3 features, 1-4 FORMGEN tutorial, 2-3 operating environments, 1-5, 1-7 security, 1-7 DPS-ATTR-TABLE parameter, 6-5 DPS-NAMES parameter, 6-4 E EDIT_SYMBOL statement, 4-23 EMPHASIS statement, 4-24 erasing forms, 6-39 error handling, 3-14 exiting FORMGEN, 3-3 F FIELD command, 4-15 field-level statements, 4-17 FLDP calling, 4-4 definition commands, 4-6 positional notation, 4-5 syntax, 4-1 FLDP processor definition, 1-5 FLMU calling, 5-1 examples, 5-5 explanation, 5-1 FLMU processor definition, 1-5 FOREGROUND_ATTRIBUTES statement, 4-24 FORM command, 4-7 Form Language Manipulation Utility (See FLMU), 5-1 form library access routines D$DEFERASE function, 6-39 D$DEFLOAD function, 6-40 D$DEFSAVE function, 6-42 explanation, 6-38 FORMGEN processor calling format, 3-1 definition, 1-5, 2-1 error handling, 3-14 exiting, 3-3 guidelines for using, 2-3 help forms, 3-6 image/field layout form, 2-9 initial values form, 2-15 main menu, 3-15 main menus, 2-4 menus Index

381 Index attributes list, 3-45 form-level attributes, 3-26 form-level attributes, page 1, 2-6 form-level attributes, page 2, 2-7 form-level attributes, page 3, 2-8 image/field attributes, 2-14 repeat images, 3-49 repeat images, empty, 2-11 repeat images, with data, 2-12 menus print form, 3-5 tutorial, 2-3 user profile menus, 3-9 FORMGEN tutorial, 2-1 guidelines, 2-3 form-level attributes, 6-6 form-level attributes menu, 2-6, 3-26 form-level attributes menu (page 2), 2-7 form-level attributes menu (page 3), 2-8 forms deleting, 2-19 discarding changes to, 3-3 help, 3-6 printing, 3-4 saving, 2-17 saving changes to, 3-3 FUNCTION_KEYS statement, 4-25 functions D$DEFERASE, 6-39 D$DEFFLDCRE, 6-16 D$DEFFLDDEL, 6-35 D$DEFFLDMOD, 6-25 D$DEFFLDRET, 6-29 D$DEFFRMDEL, 6-36 D$DEFFRMERET, 6-30 D$DEFGENWS, 6-46 D$DEFIMGCRE, 6-21 D$DEFIMGDEL, 6-37 D$DEFIMGMOD, 6-27 D$DEFIMGRET, 6-31 D$DEFLOAD, 6-40 D$DEFNAMRET, 6-32 D$DEFPRINT, 6-44 D$DEFSAVE, 6-42 D$FEFFRMCRE, 6-20 D$SEFFRMMOD, 6-26 image/field layout, 3-34 marking, 3-35 G GENERAL_EDIT statement, 4-25 generate working storage menu, 2-17 generating working storage, 6-46 getting help, 3-6 H HIGHLIGHT statement, 4-30 highlighting fields and images, 4-30 I IMAGE command, 4-11 image/field attributes menu, 2-14, 3-52 image/field layout form, 2-9 image/field layout functions, 3-34 images nonrepeating, 4-13 repeating, 4-15 initial values form, 2-15 INPUT_ATTRIBUTES statement, 4-31 L loading forms, 6-40 M main menu FORMGEN field explanations, 2-5 FORMGEN screen, 2-4 main menu (FORMGEN), 3-15 marking characters and commands, 3-35 marking characters in text, 3-38 marking commands, 3-37 menus attributes list, 3-45 form-level attributes, 2-6, 3-26 form-level attributes, page 2, 2-7 form-level attributes, page 3, 2-8 generate working storage, 2-17 image/field attributes, 2-14 image/field attributes menu, 3-52 main, 2-4, Index 3

382 Index marked area, 3-43 print form, 3-5 repeat images, 3-49 repeat images, with data, 2-12 user profile, 3-9 menus repeat images, empty, 2-11 miscellaneous routines D$DEFGENWS function, 6-46 D$DEFPRINT, 6-44 modifying field attributes, 6-25 modifying field-level attributes, 6-26 modifying image attributes, 6-27 modifying ON/OFF images, 3-34 modifying routines D$DEF D$DEFFLDMOD, 6-25 D$DEFFRMMOD, 6-26 D$DEFIMGMOD function, 6-27 explanation, 6-24 moving marked areas, 3-37 N nonrepeating images, 4-13 O operating environments, 1-7 OUTPUT_ATTRIBUTES statements, 4-33 P POSITION_IMAGE statement, 4-35 positional notation in FLDP, 4-5 PREDEFINED_VALUE statement, 4-36 print form menu, 3-5 printing forms, 3-4 printing temporary forms, 6-44 R repeat images menu, 3-49 repeat images menu (empty), 2-11 repeat images menu (with data), 2-12 REPEAT_IMAGE statement, 4-38 repeating form lines, 4-38 repeating images, 4-15 repository interface attribute lists, 3-41 marked area menus, 3-43 marked areas, 3-40 menus, 3-43 respository interface attributes list menu, 3-45 restoring marked data, 3-38 retrieving field-level attributes, 6-29 retrieving form-level attributes, 6-30 retrieving image names, 6-32 retrieving image-level attributes, 6-31 retrieving routines D$DEF D$DEFFLDRET function, 6-29 D$DEFFRMRET function, 6-30 D$DEFIMGRET function, 6-31 D$DEFNAMRET function, 6-32 explanation, 6-28 run-time routines overview, 1-5 S saving form changes, 3-3 saving forms, 2-17 security explanation, 1-7 SECURITY statement, 4-40 setting terminal test mode, 4-44 specifying attribute values, 4-36 specifying background displays, 4-19 specifying cursor location, 4-21 specifying emphasis characters, 4-24 specifying field location, 4-35 specifying foreground display, 4-24 specifying function keys, 4-25 specifying input characters, 4-31 specifying security type, 4-40 specifying storage characteristics, 4-42 specifying tabs in fields, 4-44 starting field definition, 4-15 starting image definition, 4-11 statements field-level, 4-17 STORAGE statement, 4-42 storing temporary forms, 6-42 Index

383 Index T TAB statement, 4-44 TEMPLATE command, 4-10 temporary forms deleting, 6-36 deleting images, 6-37 deleting text constants, 6-35 printing, 6-44 storing, 6-42 TEST statements, 4-44 U user profile menus, 3-9 user profiles description, 3-9 User-id/password processor, Index 5

384 Index Index

385 .

386 2012 Unisys Corporation. All rights reserved. * *