Home

SEDIT User`s Guide - Alpha Microsystems

Contents

1. When you use a field expression like this to set a field characteristic be sure to set the m No Expression Value field flag If you don t the value of the expression displays in the field in this case either 1 2 or 4 whichever color number was set The field expression below puts a running report subtotal into accumulator 2303 by adding the value of field three for the current line to the previous value of 303 When this field prints it prints the current value of the accumulator SET 303 303 F3 Since this is a subtotal you would also want to set the field class for this field to 8 16 or 32 depending on the level of subtotal The following example shows how you can set two field characteristics in a single field expression It sets field 12 to display in the same row as field 5 starting one column after the end of field 5 SET FLD ROW F12 FLD ROW F5 SET FLD COL F12 FLD COL F5 FLD CSIZ F5 1 SEDIT User s Guide Rev 03 CHAPTER SIX PRINTING ESP SCREENS SEDIT offers three ways to print the screens you create the key the Main Menu LIST command and the SEDIT commande L option THE PRINT KEY The key prints the current screen image You can print any SEDIT screen display Main Menu Screen Editor or Field Editor Just press pat when the information you want to print is displayed When you use PRNT from the Screen Editor the prin
2. The Field Editor screen looks like this ESP Field Editor Field Number Window Size 0 Field type Field max size Field flags 256 Field modifiers Field min size class 4 Read Security 127 START display format code Background Color Write Security END display format code Foreground Color Field Buffer text for screen titles Field Default Field Expression Pop Up Menu Selections Field Prompt On Line Help Press MENU key to cancel edit and return to screen display Press EXECUTE key to set new field information Enter new field sequence number if desired Row 012 Column 040 27 Apr 92 MOVING THE CURSOR You can use these keys to move among the fields in the Field Editor SEDIT User s Guide Rev 03 Page 4 2 Chapter Four e 75 1j or RETURN to go to the next field e Back TAB surr TAB or 1 to go to the previous field Within a field you can use e 5Jand Jto move right and left e suT 5Jand 59trT L to go to the end or beginning of an entry NEXTWORD J and PREV WORD to move one word at a time CHANGING ENTRIES To change an existing entry in a field you can retype it or use the following editing keys RUBOUT CHAR DEL or CTRL P to delete a character CHAR INS J or CT8L F to insert a space WORD DEL or CR J V to delete a word crA Y to delete to the end of the field
3. Changed Value Post Edit Interrupt numeric value 2048 this is the same as Post Edit Interrupt described above except the return to the calling program occurs only if the user made a change to the field No Display if Blank numeric value 4096 when this flag is set if the field is blank neither the field nor the prompt displays except when the cursor is in the field For example you could design a nine digit zip code field as two separate fields one of five digits and one of four If you set this flag for the four digit field it will disappear if the user enters only the five digit zip code No Prompt Flash numeric value 8192 normally field prompts display in dim intensity and change to bright when the cursor is in the field Setting this flag makes the prompt stay in dim display even when the cursor is in the field No Expression Value numeric value 16384 ESP normally loads the result of a field expression into the field buffer However some field expressions are used for control purposes only and should not be loaded into the buffer Setting this flag tells ESP not to load the field expression value into the field buffer The field buffer is discussed later in this chapter Field expressions are covered in detail in Chapter 5 SEDIT User s Guide Rev 03 The Field Editor Page 4 7 FIELD CLASS Field class values control printing sequences during report generation They have no effect on screens These values are us
4. cra 8 to enter or leave automatic character insert mode DISPLAYING HELP INFORMATION As with all ESP screens you can see help information from the Field Editor by pressing KE PULL DOWN MENUS Three of the fields on the Field Editor have pull down menus to provide you with an easy way to make your choice The fields with pull down menus are Field Flags Field Classes and Field Modifiers When the cursor is in any of these fields you can press to see the pull down menu The currently selected settings are displayed in normal intensity the rest are in dim intensity For example here is the pull down menu for the Field Flags field A EE ER EE Field Flags l 2 Non changeable 512 Right Prompt Display d 4 Display Only 1024 Retain Trailing Blanks 8 Auto Carriage Return 2048 Changed Value Post Edit Interrupt 16 Secured Entry 4096 No Display If Blank 64 Pre Edit Interrupt 8192 No Prompt Flash 128 Post Edit Interrupt 16384 No Expression Value 256 Clear On Entry 4 To turn a setting on or off move the cursor to it using 7 and 1 then press SPACE After making all your changes press EXECUTE If you don t want to keep your changes press MENU J SEDIT User s Guide Rev 03 The Field Editor Page 4 3 When you use a pull down menu ESP keeps track of the
5. it simply stops moving to the left it is not deleted You can use these keys to insert and delete rows and spaces SEDIT User s Guide Rev 03 Page 3 8 Chapter Three TO DO THIS USE THIS KEY Insert a row LINE INS or cTRL BJ Delete a row LINE DEL or CTRL Z Insert a space CHAR INS or CTRL F Delete a space CHAR DEL or CTRL D DELETING A FIELD To delete a field move the cursor to the field as described above Make absolutely sure the field number displayed at the bottom of your screen is the one you want to delete This is especially important with overlapping fields Press DELETE J You can also delete all the fields in a row by moving the cursor to the row and pressing LINE DEL or CTRL ZJ SEDIT User s Guide Rev 03 CHAPTER FOUR THE FIELD EDITOR You set characteristics and parameters for the fields you create in the Screen Editor with the Field Editor This chapter explains how to use the Field Editor and describes each setting available USING THE FIELD EDITOR You can only get to the Field Editor from the Screen Editor To call up the Field Editor press ET from anywhere in the Screen Editor If you are on an existing field when you press LEDIT you see the information for the field If you are not on a field pressing ED creates a new field and you see a blank Field Editor screen
6. Page 5 8 Chapter Five FUNCTION DESCRIPTION Allows editing of a previously skipped field It is the reverse of SKIP Evaluates the expression in a field and returns the value of the field This differs from just referring to the field number in two ways it works only if the field has a field expression and rather than just reading the current field value it forces the field expression to be re evaluated You can use CALL to evaluate an expression in a display only field which might not otherwise be updated HIDDEN Checks to see if a field is hidden it returns true if the field is hidden false if it isn t HIDE Hides a field so it is not displayed on the screen You can reverse this by using the SHOW function JULN Converts a date field value to a Julian date A Julian date is the number of days since January 1 4713BC Converting dates to Julian format allows you to perform arithmetic on date values Returns the data length of the specified field This differs from FLD CSIZ in that if the field buffer is empty LEN returns the size of the field default while FLD CSIZ does not Reverses the effect of HIDE so the field is displayed on the screen Causes the field to be skipped The cursor will not go to the field so it can t be edited The field is still displayed You can reverse SKIP by using ALLOW SKIPPED Checks to see if a field is skipped it returns true if the field is skipped false if it isn t
7. 10 0 0 ON 17 2 0 0 0 0 0 0 Amount 13 97 5 13 0 256 0 T 23 0 0 0 0 0 0 0 Description 6 19 6 37 10 4 0 B 0 0 0 0 0 0 0 0 3 28 7 17 0 4 0 T 9 0 0 0 30 31 0 0 18 19 8 40 0 4 0 T 9 0 0 0 32 33 0 0 20 16 9 45 0 4 0 T 9 0 0 0 32 33 0 0 6 30 10 I2 0 4 4 1 9 0 127 127 32 33 0 0 Fld Expression 3 IF F3 gt 3 SET 1 1 SET 1 1 1 4 F3 100 Fld On line help messag 1 Enter the Identification Number 2 Enter the date of this entry 3 Enter 1 2 3 or 4 4 Enter the amount of this entry 5 Enter a description of the entry The tables below the screen image give the detailed information about each field that you entered into the Field Editor Each field is identified by cursor coordinates and field number The columns give the following information see Chapter 4 for explanations of these fields SEDIT User s Guide Rev 03 General Information Page 6 3 COLUMN DESCRIPTION Max Siz Maximum number of characters allowed Min Siz Minimum number of characters allowed Fld Flags Field Flags Fld Cls Field Class TP Field Type Fld Mod Field Modifiers Spc Mod Special Modifiers Rd Wrt Security Read and write security level settings St End Code Start and end display format codes Bck For Color Background and foreground colors Prompt Field Prompt The print out also lists all field expressions and on line help messages for the screen PRINT DESTINATIONS SEDIT does not allow you to select a printer when you print using eith
8. IF function in field expression 5 5 INC function in field expression 5 5 Inserting rows 3 7 spaces 3 7 Integer in field expression 5 5 J Julian date 5 8 JULN function in field expression 5 8 L Leaving Field Editor 4 3 Screen Editor 3 2 SEDIT 2 3 LEN function in field expression 5 8 Line 3 3 creating 3 4 editing 3 6 types 3 4 LIST command 2 3 6 1 output description 6 2 SEDIT User s Guide Rev 03 Index Logarithm in field expression 5 5 Logical NOT in field expression 5 5 Logical operators in field expression 5 3 Main Menu see ESP Main Menu 3 2 Marking a field 3 6 Mathematical functions in field express 5 4 Maximum size effect of Field Buffer entry 4 4 setting for field 4 4 MENU key 2 5 in Field Editor 4 3 in Screen Editor 3 2 Message field 3 3 entering text in field buffer 4 13 Minimum size setting for field 4 4 Modifiers setting for field 4 7 Modifying an existing field 3 6 Moving an existing field 3 7 Moving the cursor Field Editor 4 1 in Screen Editor 3 1 to edit a field 3 5 N No display if blank flag 4 6 No expression value flag 4 6 No prompt flash flag 4 6 Non changeable field flag 4 5 NOT function in field expression 5 5 Numeric field modifiers 4 10 selecting 4 7 setting format 4 10 special modifiers 4 10 O Operators in field expressions 5 3 precedence in field expression 5 4 Overlapping fields 3 5 P Pop up menu selections setting for field 4 13 Post ed
9. KEY 1 KEY 2 Two keys separated by a slash like this means you need to press them at the same time Hold down the first key and press the second one The halt symbol marks important information you should read carefully before continuing This often indicates something you MUST or MUST NOT do so read carefully The hint symbol marks a helpful bit of information It often points out a short cut which AS may save you time or trouble The remember symbol marks information you need to keep in mind while you are following a set of instructions SEDIT User s Guide Rev 03 Introduction Page 1 3 REFERENCE MATERIAL This book assumes you have a certain amount of knowledge about AMOS in general and AlphaVUE in particular If you need more information about a topic in these areas you can refer to these other manuals published by Alpha Micro e AMOS System Commands Reference Manual e AlphaVUE User s Manual SEDIT User s Guide Rev 03 CHAPTER TWO USING SEDIT This chapter discusses The overall flow of work when using SEDIT Using the SEDIT command The ESP Main Menu and its options How to get help information while using SEDIT The Screen Editor and Field Editor displays OPERATION OVERVIEW d There are three principal screen displays associated with the creation and maintenance of your ESP screens The first is the ESP Main Menu the second is the Screen Editor and the third is the Field Editor The fir
10. OP sa certet ettet tte Mete e tete atate tendo 4 1 Changing Enliles reri ett eR o d A Lett eg 4 2 Displaying Help InforfriallOe oua eoi or genee 4 2 INDIEN 4 2 Leaving the Field e 4 3 THE FIELD EDITOR DEE 4 3 ele Re Ti le EE 4 3 e Ee Kr rale ne DEE 4 4 FIBI IAN OZ each cS a deeg Ce 4 4 Field MIER SIZ Cosas rcte ori eaa eE eR T ESA EIE EE AREEN 4 4 MIDOOW SIZB etn te rone hti me dece eer 4 5 Field Art ct se ecclesia salted cn eee ented vca ce teen E tie ey Sea tele 4 5 ee EE 4 7 PICMG TY EE 4 7 Field Modifier Si a cccverietcoce ttd e Po EU IR Seege 4 7 Special Field Mole eegener 4 10 Read amp Write d s eee perte rra pte te eee tene eran 4 11 Start amp End Display Format siot tr eR ence inb utet sodes 4 11 Background and Foreground Color 4 12 Eeler een ira boe Sta alice eel dene edhe Dub 4 13 HR EE 4 13 Field Klee E 4 13 Pop up Menu Selections AEN 4 13 Se R e ul EE 4 14 O line Help ss E 4 14 CHAPTER FIVE FIELD EXPRESGGIONS AA 5 1 USES OF FIELD EXPRESSIONS 5i ott toe Ee 5 1 GENERAL FORMAT RE 5 1 jo 5 2 Field E 5 2 Glossary Items ione E n rte Hte eod eee 5 2 Operator EE 5 3 NEE Ee 5 4 Mathematical FUnCtons EE 5 4 The IF FUNCHON ior eege eee ies 5 5 The SET FUNCION E 5 5 Lee ie een EE 5 6 Feo HIE e 5 9 SAMPLE FIELD e 5 10 CHAPTER SIX PRINTING ESP SCREENS AAA 6 1 THE PRINT KEY EE 6 1 THELIST COMMAND rer tt tt teer ee D On Rex ENEE 6 1 PRINT DE
11. Starting display format code FLD WSEC Write security POPUP ITEM Item number of the selected item of a pop up list The format for all of these functions is Function F F is the number of the field you want to retrieve the value from or set the value for When used in the SET function these field functions let you set the indicated characteristic of a field normally though not always the current field Combining SET and IF lets you set the characteristics based on other values or conditions For example this IF function sets the color of field 2 to red if the value in field 2 is less than 0 and to white otherwise IF F2 lt 0 SET FLD FCLR F2 4 SET FLD FCLR F2 1 You can set two or more field characteristics in one field expression by using two SET m functions connected with a plus sign There is an example of this at the end of the chapter Except when used within a SET function the field functions retrieve the indicated characteristic from this field or another If you use the field function as part of IF s logical expression you can then set another value based on the retrieved characteristic For example IF FLD BCLR F4 1 SET 4 1 SET 4 0 This sets accumulator 4 to 1 if field 4 s background color is white and sets it to 0 if the background color is anything else Field functions of the second type are SEDIT User s Guide Rev 03
12. enough All users whose security level is at or above the level defined by the read and write security settings can both view and modify this field The default value for each field is 127 the allowed values are 0 to 255 If you do not use SIGNIN leave these values at 127 this allows all users read and write access If you set the security level higher than 127 no one will be able to access the field START amp END DISPLAY FORMAT The Start amp End Display Format codes determine the special display attributes if any used for your field The common display features available are shown in the table below You normally start and end the field using the pairs of values shown in the Start and End Columns The codes for these fields correspond to the standard AMOS 1 TCRT codes SEDIT User s Guide Rev 03 Page 4 12 Chapter Four DISPLAY FEATURE START CODE END CODE Blink EA 22 Underscore 30 Reverse Video 32 Reverse Video Blink 34 The default value for this field is 0 for no display features BACKGROUND AND FOREGROUND COLOR Selections for background and foreground colors let you set the color used in your screen on a field by field basis There is no default setting for either the foreground or background color Both the Background Color and Foreground Color fields accept these values BRIGHT DIM COLOR VALUE VALUE Black White Blue Magenta Red Yellow Green Cyan NOOR WDM OH These numbers correspo
13. press RETURN You can use these commands directly from the Screen Editor by using a slash command See Chapter 3 The following list describes each ESP Main Menu command COMMAND DESCRIPTION EDIT Takes you to the screen editor so you can update the current screen file LIST Prints the current screen file As you develop your screen this is helpful for fine tuning the screen s design and layout the print out helps you see behind the screen to the characteristics of each field The format of the printed screen file is described in Chapter 6 TEST Calls a test program which displays and processes the screen as if it had been called from an application This test program notifies you when pre or post edit interrupts occur and lets you make sure the screen behaves the way you want To leave the test program press MENU Writes the current screen file on the disk and returns you to AMOS command level This is the same as using the save command followed by the our command SAVE Writes the current screen file on the disk without leaving SEDIT As you create your screen get in the habit of flipping back to the Main Menu every so often to use SAVE This protects your work in the unlikely event the computer is rebooted QUIT Abandons any changes you made since the last SAVE command and returns you to AMOS command level quit is helpful when you use SEDIT and want to see an existing screen without making any changes leaving
14. to where you want the field to begin 4 Press ESCAPE m IR f you try to move a field to a location where it does not fit on the screen for example if d you move a 30 character field to start in column 60 the field moves but does not display on your screen ESP does not display partial fields if the entire field does not fit on your screen none of it appears The field still exists and you will see its field number if you move the cursor to its location Centering a Field You can center a field on the line by moving the cursor to the field and pressing LCR J This is most useful for message fields where there is no prompt For data entry or display fields the data portion of the field is centered the prompt may make the field appear not to be centered correctly REARRANGING THE SCREEN In addition to moving a single field as described in the previous section you can move single or multiple fields by inserting or deleting rows or columns When you insert a row all fields on or below the current row move down one row When you delete a row all fields below that row move up one row D Deleting a row deletes all fields in that row When you insert a space all fields to the right on that line move right one space When you delete a space all fields to the right on that line move left one space You cannot delete a field by deleting spaces When the field reaches the cursor position
15. two kinds of fields created for any screen you make with ESP Text fields These include both data fields which can hold information from your application or accept input from the user and message fields such as screen titles Appearance fields either lines or boxes The methods for creating text fields and appearance fields are slightly different SEDIT User s Guide Rev 03 Page 3 4 Chapter Three TEXT FIELDS There are three steps to creating a text field 1 Move the cursor to where you want the first character of the field For data fields this is where the first character of the displayed or entered data should go not the beginning of the prompt for the field For message fields it is where the first character of the message will display 2 Press EDT to enter the Field Editor and define the field s characteristics The Field Editor is described in Chapter 4 3 When you re done using the Field Editor press EXECUTE to save the field and return to the Screen Editor The information you entered in the Field Editor such as a screen prompt appears on the Screen Editor display The field number appears on the bottom status line The field is automatically marked see Marking a Field below You may often find it easier to create a new field by copying an existing field and modifying the copy than to use this process to create the field from scratch How to copy a field is described later in t
16. used internally by ESP If you assign a field number which is already used in this screen ESP renumbers the other field giving it the next higher number and any other fields affected For instance if you have fields 1 through 25 and create a new field 12 old fields numbered 12 through 25 become 13 through 26 If you enter a number higher than any existing field number SEDIT assigns the number one greater than the highest existing field number For example if there are field numbers 1 through 10 and you enter 15 SEDIT uses 11 instead of 15 To check the field number sequence of your screen at the Screen Editor press HOME then press 78 This takes you to field number 1 Each time you press 78 you go to the next higher field SEDIT User s Guide Rev 03 Page 4 4 Chapter Four Field Renumbering After you ve created all the fields for your screen determine the order you want for the fields and renumber them accordingly During development of ESP applications we have found it easiest to use ESP if the fields for user input begin with number 1 followed by display only fields headings and information fields with boxes and lines having the highest numbers This does not require you to create the fields in this order Create the fields in the easiest order for you then renumber them as the last step in creating the screen You can check the field order using at the Screen Editor as described above For any
17. value for the field When you press EXECUTE ESP adds the values associated with your selection s and puts the total in the field If you become familiar with the values associated with your selection s you can enter the total manually bypassing the pull down menu LEAVING THE FIELD EDITOR There are two ways to leave the Field Editor and return to the Screen Editor Press EXECUTE This keeps all your changes to this field Press MENU This abandons any changes you made and returns the field to its previous state If you were creating a field the field is not created THE FIELD EDITOR FIELDS The rest of this chapter describes each field on the Field Editor screen FIELD NUMBER d The field number is a unique identification ESP assigns to each field The first field you create is assigned the number 1 the next is 2 and so on Field numbers determine the order and direction the cursor moves in when your screen is accessed by your application Regardless of a field s position on your screen the cursor always appears first in field 1 then moves to field 2 etc assuming the fields are set to accept input ESP assigns and keeps track of the field numbers for you You can also manually assign the field number Valid numbers are from 1 through 999 The number following the comma in this field is the Field ID It is displayed for your information only you cannot change it SEDIT assigns the Field ID and it is
18. 5 terminals the universal key sequence for its function and the action this key performs from the Screen Editor While HEL is not a function key it is also included EDIT ESCAPE Calls up Field Editor DELETE ESCAPE Deletes field BLOCK MARK cTRL Marks location or field BLOCK COPY ESCAPE Copies marked field MENU ESCAPE Goes to Main Menu SCROLL UP ESCAPE Scrolls screen up SCROLL DOWN ESCAPE J Scrolls screen down SCREEN LEFT ESCAPE Scrolls screen left SCREEN RIGHT F 15 LESCAPE J Scrolls screen right PRINT ESCAPE Prints screen display HELP ESCAPE J Displays help SLASH COMMANDS The Screen Editors slash commands are an alternative way for you to perform any of the commands on the ESP Main Menu Rather than pressing MENU then choosing the command you want just type followed by the first letter of the command Do not press RETURN For example T takes you directly into test mode You can use a slash command anytime you are in the Screen Editor except when the menu requesting the type of line you want is displayed see Creating a Line below You cannot use slash commands from the Field Editor or any of its associated screens If you type just a slash a window appears showing you the possible commands Edit is not listed since you are already editing a screen CREATING FIELDS There are typically
19. APHIC CONVENTIONS EH 1 2 REFERENCE MATERIAL 24 ta see EE Ete i Eod uox e erm MERIT 1 3 CHAPTER TWO USING SEDIT eege ede eae etre ege 2 1 OPERATION OVERVIEW s toits EE c de eripe do uto ee 2 1 THE SEDIT COMMAND tp tener t t RES URRU RR RE RA uen pi abus 2 1 ESP Main Menu Gorrimands co tret rdi ertet etes 2 3 Viewing Help Information EE 2 4 The Sereen e 2 4 The Field Edilor eee Eo DER e ee ee e ec 2 4 CHAPTER THREE THE SCREEN EDITOR sse 3 1 eier LEE 3 1 MOVING THESC USO EE 3 1 SEPIA ING TION KE VSS a aes Sattar a ON RC de dene A uo Chae ated 3 2 The FIEEBD EDIT E eege Eege 3 2 The MENU ISO cat cete e pe it ERE Pe ede 3 2 TRE HELP Key i open EROR ee E E EEN EES 3 2 Function Key Summary Table 3 3 SLASH COMMANDS EE 3 3 CREATING ee RRE 3 3 Text E EE 3 4 Appearance E 3 4 Creating a Line us oh ret naar See Ee 3 4 Drawing d EE 3 5 Overlapping PIGS EE 3 5 EDITING EXISTING FIELDS toto iere eege gaunt 3 5 Positioning the Cursor for Editing Operatons 3 5 Marking Field iore ei eia tie tes endete ceteri tus 3 6 Modifying a E DEE 3 6 Copying a Field EE 3 6 MOWING d FIC DEE 3 7 Centering a Field acs aeter eek expeti re der rena 3 7 Rearranging the Screen E 3 7 Deleting a e EE EE 3 8 SEDIT User s Guide Rev 03 Page ii Table of Contents CHAPTER FOUR THE FIELD EDITOR teugee u eege teenies dnc eects 4 1 USING THE FIELD EDITOR ni ER RP DR RR rre e 4 1 Moving the CUPS
20. All of these functions accept only a field number as an argument For example SKIP F5 All of these functions which set a field characteristic return a numeric value of zero SEDIT User s Guide Rev 03 Field Expressions Page 5 9 ACCUMULATORS Accumulators are memory locations ESP uses to store numbers There are 512 accumulators available to you numbered from 0 through 511 Accumulators are local to each user the values for each user s accumulators are stored in the impure area set up for the user in TOOLBX SYS when the computer boots There are three types of accumulators e Numbers 0 through 250 are for temporary storage of values These accumulators are normally cleared by the INITRM XCALL or TRMINI subroutine so any value in them is lost whenever you leave an ESP application See the ESP Programmer s Guide for more information on TRMINI and INITRM e Numbers 251 through 499 are longer lasting storage locations the values in these accumulators are not cleared by ESP This lets you save a value for later use or pass values from one application to another e Numbers 500 through 511 are used by the DART data base manager to store information about the current data base or report You should not use these accumulators in your application except as they are defined in DART See the DART documentation for more information All accumulators are cleared when your system is booted You cannot use an accumulator for permanent stor
21. DIT User s Guide Rev 03 Page 4 8 Chapter Four The field modifiers for a date field are Embedded Slashes Displays the date with the character separating month day and year after the user makes an entry and exits from the field Dates may be entered with or without slashes European Format Requires the user to enter dates in the European format of DD MM YY Also displays in this format Can be used with or without embedded slashes Sort Format Return Returns date to the calling program in sort format YY MM DD Dates must be in sort format when sent back from the calling program Can be used with or without embedded slashes Sort Format Entry Requires date to be entered in sort format YY MM DD Can be used with or without embedded slashes SEDIT User s Guide Rev 03 The Field Editor Page 4 9 The text field modifiers are Alpha Characters Allows upper and lower case letters Numeric Characters Allows numbers Punctuation Allows the punctuation characters listed below Force Uppercase Converts all entered letters to upper case Spaces Allowed Allows blank spaces as_ valid characters Auto Capitalization Capitalizes the first letter of all words even if they are entered as lower case Yes No Only Limits the valid responses to Yes or No The characters for yes and no are taken from the users current language definition file d ESP uses the AMOS ALF monitor call to determine if a characte
22. ERATOR DESCRIPTION Equal to Not equal to Greater than Less than Greater than or equal to Less than or equal to The relational operators compare two logical values and give a result of either 1 true or 0 false They are OPERATOR DESCRIPTION AND Are both expressions true OR Is either expression true XOR Is only one expression true Precedence In general ESP follows algebraic rules of precedence when evaluating a field expression Multiplication and division are performed before addition and subtraction and so on Operations of equal precedence are performed from left to right You can use parentheses to control the order in which operations are performed This works for the operators listed in the previous sections and the functions described below The operator or function enclosed in the most sets of parentheses is performed first MATHEMATICAL FUNCTIONS You can use the following mathematical functions in a field expression SEDIT User s Guide Rev 03 Field Expressions Page 5 5 FUNCTION DESCRIPTION Absolute value Truncate to integer Logical comparison see the next section Increment accumulator by one Take the integer value Natural logarithm Reverses logical value Set accumulator or value Square root The general format for all these functions is Function expression All of these functions except IF SET and INC are the same as in AIphaBASIC IF is described in the next sectio
23. SEDIT User s Guide ALPHA MICROS YSTEMS RIGHT FROM THE ST DSM 00178 03 A00 1995 Alpha Microsystems REVISIONS INCORPORATED REVISION DATE 00 March 1988 02 June 1992 03 September 1995 SEDIT User s Guide To re order this document request part number DSO 00178 00 This Document applies to ESP versions 2 1 and later The information contained in this manual is believed to be accurate and reliable However no responsibility for the accuracy completeness or use of this information is assumed by Alpha Microsystems This document was written by Robert Shelton This document may contain references to products covered under U S Patent Number 4 530 048 The following are registered trademarks of Alpha Microsystems Santa Ana CA 92799 AMIGOS AlphaBASIC AlphaFORTRAN AlphaMATE AlphaWRITE VIDEOTRAX AMOS Alpha Micro AlphaACCOUNTING AlphaCALC AlphaCOBOL AlphaDDE 77 AlphaLAN AlphaLEDGER AlphaMAIL AlphaNET AlphaPASCAL AlphaRJE CASELODE OmniBASIC VER A TEL The following are trademarks of Alpha Microsystems Santa Ana CA 92799 AlphaBASIC PLUS DART inFront am AlphaVUE AM PC AMTEC ESP MULTI inSight am All other copyrights and trademarks are the property of their respective holders ALPHA MICROSYSTEMS 2722 S Fairview St P O Box 25059 Santa Ana CA 92799 TABLE OF CONTENTS CHAPTER ONE INTRODUCTION AAA 1 1 WHAT ASSSEDI ME 1 1 HOW THIS BOOK IS ORGANIZED ore etat entretien 1 1 GR
24. SEDIT User s Guide Rev 03 DOCUMENT HISTORY REVISION DATE DESCRIPTION 9 1 95 Incorporate all outstanding changes for AlphaCD release Internal paperwork change only No actual change to document 6 25 92 Add field expression functions which were omitted Revision 00 6 4 92 ESP 2 1 inclusion in AMOS 2 2A Replaces ntroduction to ESP General update reformat add new information SEDIT User s Guide Rev 03 A Absolute value in field expression 5 5 Accumulator in field expression 5 9 INC function 5 5 setting in field expression 5 5 ALLOW function in field expression 5 8 Appearance field 3 3 creating 3 4 Arithmetic operators in field expression 5 3 Automatic carriage return flag 4 5 Background color setting for field 4 12 Blank field hiding 4 6 Blinking field setting 4 11 BLOCK MARK key 3 6 Box 3 3 creating 3 5 editing 3 6 C CALL function in field expression 5 8 Centering a field on the line 3 7 Changed value post edit interrupt flag 4 6 Changing entries in Field Editor 4 2 Class setting for report field 4 7 Clear on entry flag 4 6 Color setting for field 4 12 Commands ESP Main Menu 2 3 slash 3 3 Conventions used in this book 1 2 Copying an existing field 3 6 Creating appearance field 3 4 box 3 5 line 3 4 screen field 3 3 3 4 screen file with SEDIT 2 2 Screen overview 2 1 text field 3 4 SEDIT User s Guide Rev 03 INDEX D Data field 3 3 Data type settin
25. STINATIONS E 6 3 THE SEDIT L OPTION 5i rte e d IR De et Peak Eee aaa aime 6 3 SEDIT User s Guide Rev 03 Table of Contents Page iii DOCUMENT HISTORY INDEX READER S COMMENTS SEDIT User s Guide Rev 03 CHAPTER ONE INTRODUCTION The Executive Screen Processor ESP is a software development tool With ESP you can rapidly create and maintain display screens reports and menus with very little programming ESP makes it easy for you to provide consistent screen operation and offers tremendous flexibility For more information about what ESP can do for your application software see the Overview of ESP document WHAT IS SEDIT SEDIT is an AlphaVUE like screen processor with which you can develop and maintain screens Using a what you see is what you get editor you create and position fields on the screen You define parameters and attributes for each field that determine the field s characteristics when a user accesses the screen through your application With SEDIT you can quickly change display colors field lengths field formats default entries display attributes security requirements or help messages without changing your application s source code HOW THIS BOOK IS ORGANIZED This book contains six chapters Chapter 1 Introduction briefly describes SEDIT and explains the graphic conventions used throughout the manual Chapter 2 Using SEDIT describes how to call up and exit SEDIT and gives you a
26. The following sections describe all of these actions POSITIONING THE CURSOR FOR EDITING OPERATIONS The first step for many editing operations is putting the cursor on the field you want to affect You know when the cursor is positioned in a field because its field number appears at the bottom of the screen For text fields the field number is displayed when the cursor is anywhere in the field SEDIT User s Guide Rev 03 Page 3 6 Chapter Three With boxes or lines cursor position is especially important because the field number appears only when the cursor is at specified places on the line or box To see the field number of a box position the cursor on the top line of the box Fora vertical line place the cursor at the top of the line For a horizontal line the cursor can be anywhere on the line MARKING A FIELD To copy delete or move a field you need to mark it first Since ESP identifies a field by one set of cursor coordinates you only need to mark one point in the field rather than a beginning and ending location To mark a field position the cursor on the field as described above Be sure the field number displays at the bottom of your screen Then press BLOCK MARK ESP displays the row and column coordinates of the marked field on the status line You can now perform the function you want as described in the following sections The marked field stays marked unless you delete the field until you ma
27. a rough sketch Include what you want the screen to look like and a preliminary list of all the data fields the screen must hold Planning your screen beforehand can save you time and frustration Screen design is a much broader and more philosophical subject than can be addressed in this document If you are interested in finding information about researched methods for screen designs this book may be very helpful Handbook of Screen Format Design Third Edition by Wilbert O Galitz Published by Q E D Information Sciences Inc MOVING THE CURSOR As stated above the first step in creating a screen field is moving the cursor to where you want the field to be As you move the cursor the column and row coordinates at the bottom of the screen are updated You can position the cursor anywhere on the Screen Editor display with the keys shown in the following table SEDIT User s Guide Rev 03 Page 3 2 Chapter Three TO MOVE THE CURSOR USE THIS KEY or CTRL UO ES T or C18 Kk L LS or LCTRL J U or crat J n To row 1 column 1 HOME J or cTRL To top of screen PREV SCREEN or CTRL J RJ To bottom of screen NEXT SCREEN J or CT8L T Next field TAB or CTRL J Previous field BACK TAB CTRL J 1 Beginning of row SHIFT J End of row SHIFT J THE FUNCTION KEYS You can use the f
28. age of any value You refer to an accumulator using the symbol followed by the accumulator number for example 7 To set an accumulator to a value use the SET function described above For example this field expression adds 2 to the current value of accumulator 205 and displays the new value in the field SET 205 205 2 If you want to increment an accumulator by one you can use the INC function INC 205 You could use an expression such as this one to increment a line counter on a report In field expressions you can use accumulators for storing totals and other calculated values for reports keeping track of the next available value for a field and many other things SEDIT User s Guide Rev 03 Page 5 10 Chapter Five SAMPLE FIELD EXPRESSIONS The following field expression sets the value of this field to the value of field 3 divided by 100 This can be useful to for example let someone enter a percentage as a whole number then use it as a decimal elsewhere F3 100 The next example sets the foreground color for this field based on the field s value The field is red if the value is negative white if it is less than 100 or blue if it is greater than 100 You could use this so account balances of different amounts display in different colors letting you see the largest balances at a glance IF F5 lt 0 SET FLD FCLR F5 4 IF F5 gt 100 SET FLD FCLR F5 2 SET FLD FCLR F5 1
29. de Rev 03 CHAPTER FIVE FIELD EXPRESSIONS In the Field Expression field of the Field Editor you can enter a mathematical formula to calculate the value to use as the default for this screen field This lets you calculate the default entry for the field based on entries in other fields and or values stored in ESP s accumulators You can also set various characteristics of this field such as color and read write security based on these values As this chapter explains field expressions are quite flexible and powerful HR When you use a Field Expression to set the default for a field the Field Expression value GC overrides any entry in Field Default but any Field Buffer entry overrides the Field Expression value You can use Field Expression to set field characteristics even when there is a Field Buffer entry USES OF FIELD EXPRESSIONS You may find field expressions useful in any of these situations e When the default for a field depends on the value of another field For example you could set the default minimum payment based on a percentage of an account balance e When whether to display a field at all depends on the value of another field For example op AlphaCALC s Worksheet Header screen a field expression in the password field displays the field only if you choose password protection e When using ESP to create a report you can sum subtotals or totals in a field using ESP s accumulators accumulators are described late
30. ed by the TBX SCRPRT subroutine See the ESP Programmer s Manual for more information Field Class is a pull down menu field You can make your selections by choosing them on the pull down menu as described earlier in this chapter Assign the Field Class values shown below which best describe the field s function in the report Add the values together to produce a composite class value representing all the classes you want to apply to this field Non printing field Titles Detail headings Detail lines First level of subtotals Second level of subtotals Third level of subtotals Grand totals Field is report only Make sure all fields you want printed have a class designation To cause any field to be print only with no screen display add value 128 plus whatever other class value applies to this field and enter the total as the Field Class setting FIELD TYPE The Field Type determines what type of data is valid in this field Possible field types are e Date e Text e Numeric Type the first character of the type you want The field types are used with the Field Modifiers described in the next section FIELD MODIFIERS The Field Modifiers further define the type of data allowed in the field There is a separate set of modifiers for each field type Field Modifiers is a pull down menu field You can make your selections on the pull down menu or add the values of the selections you want and enter the total in the field SE
31. er Or LIST The printer used depends on one of two things e f you use SIGNIN and have a default printer defined in your SIGNIN user record that printer is used f you didn t use SIGNIN or don t have a default printer in your SIGNIN user record the system default printer is the destination THE SEDIT L OPTION Once you create an ESP screen you don t have to travel through the menu system to print it A command option available with SEDIT lets you make a printable disk file To use this SEDIT feature make sure you re in the account where the screen file is stored and from AMOS command level type SEDIT filename L RETURN filename is your screen file s name and extension If you don t include an extension SEDIT assumes the extension SCR The L option creates a printable disk file containing the same information in the same format as the ESP Main Menu List command This format is described above You can also use a wildcarding feature with the SEDIT L option to print all screens in an account by typing this command SEDIT User s Guide Rev 03 Page 6 4 Chapter Six WILD SEDIT SCR L RETURN If you give your screen files an extension other than SCR use that extension in the command The disk file created by the L option has the same name as your screen file and the first available extension in the series 000 001 and so on If you use the WILD command a separate file is created for each screen
32. field 5 multiplied by 100 SET 23 F5 100 There are more examples of SET in the Field Functions and Accumulators sections FIELD FUNCTIONS The field functions let you retrieve or set the characteristics of a field on this screen There are two types of field functions e Functions which can both retrieve and set a field characteristic These functions all start with the characters FLD except for POPUP ITEM They retrieve the indicated value unless you use them in the SET function e Functions which can only set or retrieve a value not both You do not need to use SET with this type of function display the value of the field expression in the cell For example if you are setting the color to white you don t want the field s value to be set to one To set a field characteristic without changing the value displayed in the field set the No Expression Value flag as described in Chapter 4 m When using a field function to set a field characteristic you normally do not want to Field functions of the first type are SEDIT User s Guide Rev 03 Field Expressions Page 5 7 FUNCTION DESCRIPTION FLD ASC ASCII value of first character FLD BCLR Background color FLD COL Column number FLD CSIZ Number of characters entered the current size of the field buffer See LEN below FLD EDFC Ending display format code FLD FCLR Foreground color FLD ROW Row number FLD RSEC Read security FLD SDFC
33. field that s not in the order you want go to the Field Editor and change the field number FIELD MAX SIZE The Field Max Size setting determines the maximum number of characters allowed in the field If anyone attempts to enter more characters the extra characters are not accepted If you don t enter a window size as described below this value also determines the visible length of the field on the screen For date fields without slashes set this field to 6 for dates with slashes set it to 8 For numeric fields set the maximum size to the number of characters in the largest number which can be entered or displayed Include the decimal point dollar sign any commas or a minus sign if they apply Valid responses to this field are in the range 1 to 155 If you make an entry in the Field Buffer field which is longer than the Field Max Size entry SEDIT increases the Field Max Size value to match the number of characters in the Field Buffer field FIELD MIN SIZE The value in Field Min Size determines the minimum number of characters a user must enter to exit from this field ESP will not allow the cursor out of the field until the user enters this minimum number of characters This setting is useful for fields which MUST be filled in for the data to be valid For instance for a date field you might set this field to 6 If there is no minimum number of characters or if the entry in this screen field is optional set Field Min Si
34. g for field 4 7 Date field modifiers 4 8 selecting 4 7 setting maximum size 4 4 Date formats 4 8 Date value converting to Julian date 5 8 Decimal point setting for numeric field 4 10 Default entry and field buffer 4 13 setting for field 4 13 Deleting existing field 3 8 rows 3 7 spaces 3 7 Designing screens 3 1 Display format setting for field 4 11 Display only field flag 4 5 Drawing box 3 5 line 3 4 E EDIT command 2 3 EDIT key Screen Editor 3 2 4 1 Editing screen fields 3 5 Erasing an existing field 3 8 ESP Main Menu commands 2 3 description 2 2 returning to 3 2 EXECUTE key 2 5 from Field Editor 4 3 F Field allowing editing 5 8 assigning number 4 3 buffer 4 13 checking if hidden 5 8 checking if skipped 5 8 checking length 5 8 clearing marked 3 6 Page ii copying 3 6 creating 3 3 3 4 data type 4 7 default entry 4 13 deleting 3 8 display format 4 11 editing 3 5 entering help message 4 14 expression 4 13 flags 4 5 hiding 5 8 marking 3 6 maximum size 4 4 minimum size 4 4 modifiers 4 7 modifying 3 6 moving 3 7 overlapping 3 5 pop up menu selections 4 13 prompt 4 14 read and write security 4 11 rearranging 3 7 renumbering 4 4 setting class 4 7 setting color 4 12 showing 5 8 skipping 5 8 special modifiers for numeric 4 10 types 3 3 window size 4 5 Field buffer and field maximum size 4 4 setting for field 4 13 Field characteristics in field expres
35. his chapter It s possible to define a field which doesn t completely fit on your screen display For example if you have an 80 character wide display you could define a 30 character field starting in column 60 If this happens the field does not show up on the Screen Editor display but it does exist If you move the cursor to its location its field number displays on the bottom status line and you can edit it as described below APPEARANCE FIELDS There are two kinds of appearance fields lines and boxes The next sections describe how to create them Creating a Line You can create horizontal and vertical lines using this procedure 1 Move the cursor to where you want either the beginning or end of the line 2 Mark this location by pressing BLOCK MARK 3 Move the cursor to where you want the opposite end of the line and press ESCAPE J 1 4 A menu appears at the bottom of your display Type the number corresponding to the line you want There are different types of lines so you can design a screen where boxes and lines neatly intersect with other lines and boxes After you choose the type of line ESP draws the line you selected and displays the field number for the line SEDIT User s Guide Rev 03 The Screen Editor Page 3 5 A line is like any other field you can copy move or delete it Drawing a Box Drawing a box is like drawing a line except you work with the box s opposite corners Boxes are always
36. hout making an entry Valid entries are letters numbers and punctuation marks The default entry for Field Default is blank The Field Buffer entry overrides any entry in Field Default if you have entries in both Field Buffer and Field Default the Field Buffer entry is displayed FIELD EXPRESSION The Field Expression field lets you mathematically calculate field default values and manipulate field parameters and attributes from within the screen Field expressions are discussed fully in Chapter 5 A Field Expression value overrides a Field Default entry unless you set the No Expression Value flag discussed in the Field Flags section of this chapter An entry in Field Buffer overrides a Field Expression value POP UP MENU SELECTIONS Pop up Menu Selections are short lists of items used to validate user entered data If you make an entry in this field the user is not permitted to enter any data not found in the pop up list Pop up lists are created according to certain rules Items in the list are separated by commas spaces are significant We recommend each list item start with a unique character If acomma is a valid entry in the list enter it by using a double comma When using the screen users can make selections by typing the first character of their choice or by pressing NEXT WORD J or PREV WORD to cycle through the choices SEDIT User s Guide Rev 03 Page 4 14 Chapter Four FIELD PROMPT The Field Prompt i
37. in field expression 5 8 SKIPPED function in field expression 5 8 Slash commands 3 3 Space inserting and deleting 3 7 Special modifiers for numeric fields 4 10 Square root in field expression 5 5 Status line contents on Screen Editor 2 4 Subtotals specifying for report 4 7 T TEST command 2 3 Testing a screen 2 3 Text field 3 3 characters allowed 4 9 creating 3 4 editing 3 5 modifiers 4 9 punctuation characters 4 9 selecting 4 7 Titles entering text in field buffer 4 13 Totals specifying for report 4 7 Types of screen fields 3 3 U Underlining a field 4 11 Universal key sequences for Screen Editor function keys 3 3 W WILD command 6 3 Window size setting for field 4 5 Write security setting for field 4 11 Index SEDIT User s Guide Rev 03
38. it in the same condition as when you called it up It can also prevent frustration in the creative process if you call up a screen and make changes that don t work out the way you want them to just quit and start again SEDIT User s Guide Rev 03 Page 2 4 Chapter Two VIEWING HELP INFORMATION While you are using SEDIT you see help messages at the bottom of the screen These one line messages serve as reminders about the type of responses ESP expects from you The text of the message is based on the cursors current location and changes as you move the cursor around the screen If you need more information you can call up more extensive help information by pressing HELP or ESCAPE 2 This help information may be several pages long When there is more than one screen for a topic you can go forward by pressing NEXT scREEN J or crRL T If you want to look at something you ve already passed you can move back to a previous screen using PREV SCREEN or CTRL 8 THE SCREEN EDITOR To call up the Screen Editor from the ESP Main Menu type E RETURN Your screen clears and displays the current layout of the screen file you re editing For new screen files your screen appears blank except for the bottom status line which shows the cursors current column and line position You can now position the fields for your screen by moving the cursor where you want a field to be Fields may be sc
39. it interrupt flag 4 6 changed value only 4 6 Pre edit interrupt flag 4 5 PRINT key 6 1 Printing multiple screen files 6 3 output destination 6 3 screen file 2 3 6 1 Prompt displaying on right 4 6 setting for field 4 14 SEDIT User s Guide Rev 03 Page iii Pull down menus in Field Editor 4 2 making selections 4 2 Punctuation characters for text field 4 9 Q QUIT command 2 3 R Read security setting for field 4 11 Rearranging screen fields 3 7 Relational operators in field expression 5 4 Renumbering screen fields 4 4 Report field setting class 4 7 specifying totals and subtotals 4 7 Retain trailing blanks flag 4 6 Reverse video field 4 11 Right prompt display flag 4 6 Row inserting and deleting 3 7 S SAVE command 2 3 Saving a screen file 2 3 Screen design hints 3 1 overview of creation process 2 1 Screen Editor calling up 2 4 description 2 4 EDIT key 3 2 function keys3 2 3 3 HELP key 3 2 leaving 3 2 MENU key 3 2 moving the cursor 3 1 slash commands 3 3 using 3 1 Screen field see Field 3 3 Screen file editing 2 3 printing 2 3 6 1 to 6 3 saving 2 3 size 2 2 testing 2 3 Secured entry flag 4 5 Security read and write 4 11 SEDIT command choosing a file name 2 2 format 2 1 L option 6 3 overview 1 1 SET function in field expression 5 5 SHOW function in field expression 5 8 SIGNIN default printer 6 3 security settings 4 11 Page iv Size of screen file 2 2 SKIP function
40. n and SET in the one following INC is described further in the Accumulators section later in this chapter The IF Function The IF function selects one of two values based on the results of a logical comparison Since the values it selects can be complex expressions IF is a very powerful function allowing you to choose among many different values for this field expression based on the values of many other fields or expressions The format for IF is IF logical expression expression l expression 2 If logical expression is true the value of the IF function is the value of expression 1 H logical expression is false the value of IF is the value of expression 2 Both expression 1 and expression 2 can be any legal field expression including another IF function you can nest IF functions The SET Function The SET function has two purposes e To place a value into one of ESP s accumulators The accumulators are discussed later in this chapter To set a field characteristic to a particular value You do this by using SET with one of the field functions described in the next section SEDIT User s Guide Rev 03 Page 5 6 Chapter Five The format for SET is SET Destination Value Destination is either an accumulator number or a field function Value is the value you want to set the destination to It can be a constant value or any allowable expression For example this SET function sets accumulator 23 to the value of
41. n overview of its operation Chapter 3 The Screen Editor discusses how to create and position screen fields using SEDIT Chapter 4 The Field Editor describes how to define the characteristics and parameters for each field you create Chapter 5 Field Expressions explains how you can use flexible expressions to set defaults and other characteristics of a field based on the formulas you choose SEDIT User s Guide Rev 03 Page 1 2 Chapter One e Chapter 6 Printing ESP Screens describes the ways you can print while using SEDIT GRAPHIC CONVENTIONS In order to make this document as easy as possible to understand we use several con ventions in layout and type style so you can recognize whether we are talking about a command or key when you re to type an entry and so on CONVENTION EXPLANATION FILE EXT AMOS command names and file names such as TOOLBX SYS are shown in all capitals Screen Editor ESP screen names are printed in the same type face as regular text with initial capitals What You Type Text you are expected to type is shown in a bold Courier typeface Text you should type exactly as shown is in all capitals variable responses or parts of commands such as file names are in lower case ESP Displays Text AMOS or ESP displays on your screen is shown in Courier typeface ESP command names are shown in small bold capitals Keys you need to press are shown in a keycap box
42. nd to the standard AMOS 2 TCRT codes Many terminals let you select display colors from a palette of available colors If the terminal colors have been changed from the default these values may select colors other than those shown in this table A word of caution regarding screen design although changing colors from field to field m may seem like an inviting idea don t do it Just because you have eight colors to work with does not mean any one screen should use all of them Remember the screen you design is your application s face and as such is what people using your product see the most often Be judicious with your palette of colors use them sparingly to accent or highlight For foreground or background color selection encompassing your entire screen use the AMOS PRINT TAB functions See the AlphaBASIC User s Manual for more information SEDIT User s Guide Rev 03 The Field Editor Page 4 13 FIELD BUFFER The Field Buffer sets any information you want pre loaded into this field Valid entries are letters numbers and punctuation marks The default entry for Field Buffer is blank The Field Buffer entry overrides any entry in Field Default if you have entries in both Field Buffer and Field Default the Field Buffer entry is displayed You should enter the text for screen titles and messages in this field FIELD DEFAULT Your entry in Field Default determines the value assumed for this field if the user exits it wit
43. not take any field modifiers SPECIAL FIELD MODIFIERS The Special Field Modifier is used only for numeric type fields It lets you set the number of decimal places displayed When you set a number of decimal places a decimal point is automatically inserted at the proper point in a user entry even if the user enters no decimal point The default setting is blank SEDIT User s Guide Rev 03 The Field Editor Page 4 11 Allows only integers Sets the number of decimal places when the Auto Decimal Point field modifier is set Numbers in this field have a floating decimal point no automatic decimal point positioning occurs READ amp WRITE SECURITY The settings in the Read Security and Write Security fields determine whether the user is allowed to see or make any entry to this field The read security level determines whether or not the user sees this field including its prompt on the screen If the user s read security as set by SIGNIN is less than the read security set for this field it is as if this field does not exist The write security level determines if the user can change or make any entry to this field If the user s write security is not high enough they are not permitted to move the cursor into this field although they will see the prompt and any existing field contents IR Users whose read security does not allow them to view this field cannot make an entry d even if their write security setting is high
44. o create the new screen file and continue or N to exit SEDIT Whether you are creating a new screen or editing an existing one the first screen you see after using the SEDIT command is the ESP Main Menu as shown below HTH TE HHH HTT HHH EEEE EE L L L L L L L L EEEE EE HTH EH HH aT EH HH L L L L L FE AE AEAEE dd EERE EE Executive Screen Processor Version 2 2 xxx 4 bytes in use 109848 bytes available Enter Command Edit Commands currently available Edit Edit the screen information List List field information to printer Test Test the screen Finish Save current changes and leave editor Save Save current changes Leave editor and abandon changes Enter command OR press MENU key to return to edit mode 27 Apr 92 The ESP Main Menu shows you The ESP software version number The size of the current screen file in bytes The available space in bytes this lets you know how much room you have left to work with in your memory partition A list of the ESP Main Menu commands The ESP Main Menu is a central point in using SEDIT it s the first screen you see when you call up SEDIT and you return here to exit SEDIT SEDIT User s Guide Rev 03 Using SEDIT Page 2 3 ESP MAIN MENU COMMANDS When you want to update save or print a screen or leave SEDIT you do so from the ESP Main Menu There are six ESP Main Menu commands to use one of these commands type the first letter of its name and
45. ormation from either AMOS or the users SIGNIN record and let you use this information in a field expression The glossary items available are SEDIT User s Guide Rev 03 Field Expressions Page 5 3 ITEM DESCRIPTION TD Today s date in YYMMDD format TW The day of the week 0 Monday etc UB The user s privilege code UL The user s level UE The user s expertise UM The current memory partition size UX The current radix 8 or 16 PAGE Page number for reports DART only CMP NBR Company number DEFBCOLOR Default background color DEF FCOLOR Default foreground color READ SEC The user s read security level WRITE SEC The user s write security level TIMEOUT The currently set timeout period TIME The current time in HHMM format TRUE 1 FALSE 0 The information for these items comes from the current users SIGNIN record If you don t use SIGNIN all of these items have a value of 0 OPERATORS Field expressions support a full range of arithmetic logical and relational operators You use any of these operators by placing it between the two values you want it to work on The arithmetic operators are OPERATOR DESCRIPTION Addition Subtraction Multiplication Division Exponentiation Take maximum value Take minimum value The logical operators compare two numeric values and give a result of either 1 true or 0 false They are SEDIT User s Guide Rev 03 Page 5 4 Chapter Five OP
46. r Neither the Pre Edit nor the Post Edit Interrupt flags have any effect on screens which will be used only with the DART data base manager Post Edit Interrupt numeric value 128 this flag causes ESP to return to the calling program when the cursor leaves this field after data entry For example you might set Post Edit Interrupt on a customer number field in an invoicing screen so the customer number can be validated from another file Again refer to the ESP Programmers Manual for more information Also see the Changed Value Post Edit Interrupt flag below Clear On Entry numeric value 256 if this flag is set and the user changes the first character in the field the rest of the field is cleared Key fields are good candidates for Clear On Entry because this setting can prevent entry errors caused by incorrect editing of field contents Right Prompt Display numeric value 512 setting this flag displays the prompt for the field to the right of the field instead of the left For example here is Date as a left display prompt and Time as a right display prompt Date Time You can use this on any type of field For example in a percentage field you could use the percent sign as a right prompt Retain Trailing Blanks numeric value 1024 ESP usually strips any trailing blanks at the end of an entry Setting this flag tells ESP not to strip trailing blanks The entire entry including the blanks is returned to the calling program
47. r in this chapter You can change display characteristics based on a field s value For example if a number is negative you could display it in red or in reverse video The following sections describe the various values operators and functions you can use in a field expression The end of this chapter explains some sample field expressions GENERAL FORMAT A field expression can contain any combination of the following SEDIT User s Guide Rev 03 Page 5 2 Chapter Five Numbers References to the values of fields on this screen Glossary items Arithmetic relational and logical operators Mathematical functions ESP field functions which refer to or change characteristics of fields on this screen References to ESP accumulators NUMBERS You can refer to decimal numbers in a field expression just by entering the number FIELD VALUES You can include the value of any field on this screen in a field expression by referring to the field number The format is F is the number of the field to refer to For example F4 uses the current value of field 4 When you refer to a field ESP checks to make sure it exists Therefore you may need to create all fields for a screen then go back to put in the field expressions referring to these fields Af When ESP renumbers fields as described in Chapter 4 it updates all field expressions d to refer to the proper field numbers GLOSSARY ITEMS Glossary items retrieve inf
48. r is a letter and the NUM d monitor call to determine if a character is a number The valid punctuation characters are Period Comma Dash Equal Plus Colon Semi Colon Exclamation Dollar sign Percent Apostrophe Quote At Pound Caret amp Ampersand Asterisk Parentheses _ Underline Qrave Accent Tilde V Back slash Brackets Braces Stile Question mark If you do not enter any field modifiers for a text field the field accepts any printable characte r SEDIT User s Guide Rev 03 Page 4 10 Chapter Four The field modifiers for numeric fields are Leading Dollar Sign Displays the current currency symbol to the left of the field Display Commas Displays a comma every three digits to the left of the decimal point Convert Zero to Blank 4 Converts any zero entry to blanks Especially useful for columnar displays where you may not want columns full of zeros Auto Decimal Point Inserts a decimal point in the field if the user leaves the field without entering one The Special Field Modifier sets how many places are to the right of the decimal point Negative Numbers Allows negative numbers A minus sign indicates the entry is negative Left Justify Overrides normal right justification of the entered number and displays it left justified Leading Zeros ESP normally blanks out leading zeros Setting this flag displays leading zeros Line and box field types do
49. rectangular 1 Move the cursor to where you want one of the box s corners It can be any corner 2 Mark this location by pressing BLOCK MARK 3 Move the cursor to where you want the opposite corner of the box and press ESCAPE B A box appears intersecting the coordinates you marked and its field number displays The position you marked in step 2 remains marked until you change it If you press again a new box is drawn from the marked position to the cursor location overlaying the previous box This lets you easily experiment with drawing boxes of different shapes and sizes OVERLAPPING FIELDS Two or more fields may partially or completely overlap This is normally done with appearance fields such as boxes and text fields such as screen titles but you can also have two data fields in the same location with field expressions that cause one or the other to display based on other values If you move the cursor to overlapping fields only one field number displays at the bottom of your screen This is the top field of the two the one with the higher field number see the section on field numbers in Chapter 4 If you want to edit the bottom field you need to move the top field to another location as described below change the bottom field then move the top field back to the position you want EDITING EXISTING FIELDS Once you create a field you can modify it copy it move it to a new location or delete it
50. reen titles messages data entry fields or special fields such as boxes or lines The bottom status line displays information about the screen you are building From left to right it shows you e The current cursor position e f the cursor is in a field the field number e fthere is a marked location in effect the screen coordinates for the marked area If the marked location is a field its field number appears to the right of the coordinates The system date Not all terminal types can display this information KS Using the Screen Editor is described in Chapter 3 THE FIELD EDITOR Each field you create has certain characteristics associated with it These are determined by the entries you make for it in the Field Editor SEDIT User s Guide Rev 03 Using SEDIT Page 2 5 You can access the Field Editor only from the Screen Editor When you create a field using the Screen Editor as described in Chapter 3 you are transferred to the Field Editor to enter information about the field The Field Editor screen and all of its capabilities are described in Chapter 4 You can return to the Screen Editor from the Field Editor by pressing either e EXECUTE to keep any information you ve added or changed e MENU to abandon your changes and return the field s characteristics to the way they were before or not create a new field It s important to become accustomed to how ESP interprets these two keys m cau
51. rk a different field by using or by saving a field from the Field Editor or leave SEDIT MODIFYING A FIELD To modify an existing field move the cursor to the field making sure its field number appears as described above and press 21 You do not need to mark the field This takes you to the Field Editor where you can modify any of the information for the field When you re done press LEXECUTEJto save your changes and return to the Screen Editor COPYING A FIELD You can copy any field to another location ESP copies all information associated with that field ESP changes only the copied field s row column coordinates and it gives it a new field number To copy a field 1 Move the cursor to the field being sure you see the field number at the bottom of the display 2 Mark the field by pressing BLOCK MARK J 3 Move the cursor to where you want the copied field to begin As when creating a field this is the beginning of the data area not the field s prompt 4 Press BLOCK COPY SEDIT User s Guide Rev 03 The Screen Editor Page 3 7 MOVING A FIELD When you move a field the only thing that changes is its row column coordinates All other information including its field number stays the same To move a field 1 Move the cursor to the field being sure you see the field number at the bottom of the display 2 Mark the field by pressing BLOCK MARK J 3 Move the cursor
52. s a short description or explanatory phrase to identify this field to the user For example on the Field Editor screen the words Field Number are a field prompt The field prompt you enter displays to the left of the field unless you set the Right Prompt field flag as described in the Field Flag section of this chapter The default for this field is blank ON LINE HELP For every field you create you can include an on line help message The message appears at the bottom of the screen when the cursor enters this field and is erased when the cursor leaves the field You can also define a help file to be displayed if a user presses when in this field The default for this field is blank If you make an entry in this field it is in the format On line help information filename All text up to the character displays at the bottom of the screen when the cursor enters this field Any text after a is treated as a file specification for the file to be displayed if the user presses Jin this field For example Press HELP for more information DSK0 SHOW 7 1 You can enter a full file specification for the help file as shown The help file extension defaults to the extension defined in the user s currently selected language definition file You do not have to enter a help file name in this field If you don t when the user presses HELP they see a message telling them no further help is available SEDIT User s Gui
53. ses ESP to store the current settings displayed in the Field Editor and return to the Screen Editor Ej on the other hand aborts any changes made to the current field settings EXECUTE is ESP s normal means of recognizing completion of screen entry SEDIT User s Guide Rev 03 CHAPTER THREE THE SCREEN EDITOR This chapter describes how to use ESP s Screen Editor You design your screen using the Screen Editor by moving the cursor to where you want each field then going to the Field Editor to set the characteristics and parameters for the field The next chapter describes how to use the Field Editor Besides positioning new fields using the Screen Editor you can move copy or delete existing fields This lets you easily try different screen layouts until you find the one you want You can also perform any of the functions available from the ESP Main Menu from the Screen Editor by using a slash command as described below This chapter covers everything you can do with the Screen Editor but first we include a few hints on designing screens DESIGNING SCREENS Screen design is an important part of your application especially as seen through the eyes of the people using your product Although ESP makes creating this visual interface for your application easier than ever before nothing can replace a well thought out design To make the screen creation process easier on you we suggest you begin with
54. sion 5 6 setting with field expression 5 5 Field default relation to field buffer and field expression 4 13 Field Editor abandoning changes 4 3 accessing 2 4 3 2 4 1 changing entries 4 2 description 4 1 leaving2 4 4 3 moving the cursor 4 1 pull down menus 4 2 Field expression accumulators 5 9 and field characteristics 5 6 evaluating from other field 5 8 examples 5 10 field functions 5 6 format 5 1 glossary items 5 2 IF function 5 5 mathematical functions 5 4 not placing in field buffer 4 6 operator precedence 5 4 operators 5 3 referring to other fields 5 2 relation to field default and field buffer 4 13 SET function 5 5 setting accumulators 5 5 setting field characteristics 5 5 uses 5 1 Field flags setting for field 4 5 Field functions in field expression 5 6 Index Field number and copied field 3 6 and overlapping fields 3 5 display 3 4 selecting 4 3 specifying in field expression 5 2 Field value using in field expression 5 2 File creating with SEDIT 2 2 FINISH command 2 3 Foreground color setting for field 4 12 Function keys in Screen Editor 3 2 3 3 universal key sequences 3 3 G Glossary items in field expression 5 2 Graphic conventions 1 2 H Help setting for field 4 14 Help file defining for field 4 14 Help information Field Editor 4 2 for SEDIT 2 4 HELP key 2 4 in Screen Editor 3 2 HIDDEN function in field expression 5 8 HIDE function in field expression 5 8
55. st screen you see when you use SEDIT is the ESP Main Menu The ESP Main Menu is where you start an editing session to create a new screen or modify an existing one It also lets you print and save screens and exit ESP when you are finished From the ESP Main Menu you can access the Screen Editor The Screen Editor is where you position the fields you want on your screen From here you may call up the Field Editor or return to the ESP Main Menu You define individual field parameters and characteristics on the Field Editor screen When you exit the Field Editor you return to the Screen Editor If you use the DART data base manager you can also use the Screen Editor from the DART Maintenance Menu When you do this you do not see the ESP Main Menu The Screen Editor and Field Editor work in the same way whether you access them from DART or through the ESP Main Menu THE SEDIT COMMAND Before beginning an editing session log to the account where you want to create and store your ESP screens To call up the ESP Main Menu from AMOS command level use this command format SEDIT filename RETURN SEDIT User s Guide Rev 03 Page 2 2 Chapter Two filename is the name of the screen file you want to create or modify Unless you specify otherwise SEDIT assumes the file extension is SCR If the filename you specify does not exist SEDIT responds with this message filename does not exist do you wish it created Type Y t
56. tout shows the row and column screen coordinates along with the text of all displayable fields on the screen You do not see individual field information entered via the Field Editor The screen image part of the figure in the next section is an example of what you get using from the Screen Editor THE LIST COMMAND The SEDIT Main Menu uer command prints complete information about the screen you re currently editing It includes an image of the screen and all the information entered in the Field Editor for each field Here is a sample of the List output for a fairly simple ESP screen SEDIT User s Guide Rev 03 Page 6 2 ESP Screen List of SAMPLI E 000 on April 28 Screen uses 820 bytes 1992 1 24 PM Chapter Six 1 2 3 4 5 6 7 123456789012345678901234567890123456789012345678901234567890123456789012345 1 2 3 ESP SAMPLE SCREEN 4 5 6 oe Data Entry J 8 ID Number 9 10 Entry Date TI Entry Code _ 12 Amount 13 Description 14 15 4 16 17 18 Press MENU key to return to AMOS 19 20 Press EXECUTE key to add record to file Fld Max Min Fld Fld T Fld Spc Rd Wrt St End Bck For Loc Siz Siz Flags Cls P Mod Mod Security _Code Color Prompt 8 29 al 6 1 512 O N 128 0 0 0 0 0 0 0 ID Number 10 37 2 8 0 0 0 D 5 0 0 0 0 0 0 0 Entry Date Kl eS 3 1 0 128 MBA 2 0 0 0 0 0 0 0 Entry Code 125 234 4
57. unction keys to access the Main Menu or Field Editor You can also perform some screen editing operations using the function keys as described later Keyboard overlays are available to help you locate the various function keys Three keys you ll use frequently from the Screen Editor are EDT MENU and HELP J THE FIELD EDIT KEY On the Screen Editor you press ET to indicate you want to create a field at the cursor location or edit an already existing field LEO takes you to the Field Editor where you set the characteristics and parameters for the field The Field Editor is described in Chapter 4 THE MENU KEY From the Screen Editor MENU returns you to the Main Menu where you can save print or exit this session THE HELP KEY As with all ESP screens help information is readily available From the Screen Editor you can display two kinds of help information depending on whether or not the cursor is on a field If the cursor is on a field pressing displays an abbreviated form of the Field Editor settings for this field on the bottom status line If the cursor is not on a field pressing displays general information about using the Screen Editor SEDIT User s Guide Rev 03 The Screen Editor Page 3 3 FUNCTION KEY SUMMARY TABLE The following table lists the function keys ESP uses For each it shows the key name function key number for Alpha Micro s AM 6x AM 72 and AM 7
58. user presses a function key to make a selection because you want the user to be able to move through the field but not change the information e Display Only Field numeric value 4 this flag keeps the cursor from moving into this field Screen titles and column headings are good examples of display only fields Auto Carriage Return numeric value 8 if this flag is set and the user enters the maximum number of characters allowed the cursor automatically goes to the next field the user doesn t have to press RETURN For example in the U S a telephone number field may actually be three fields one for area code one for exchange and one for the number Setting Auto Carriage Return on the first two fields causes the cursor to move to the next field as soon as each one is filled Secured Entry numeric value 16 this is a data security feature When this flag is set the characters a user enters in the field are echoed as asterisks This flag is generally set for password fields e Pre Edit Interrupt numeric value 32 this flag causes ESP to return to the calling application program whenever the cursor enters this field before any data entry For example you can set Pre Edit Interrupt for a field so your program can determine from which direction the cursor entered this field For more information on handling terminal input see the ESP Programmer s Manual SEDIT User s Guide Rev 03 Page 4 6 d Chapter Fou
59. ze to zero The valid responses in this field are zero through the Field Max Size value SEDIT User s Guide Rev 03 The Field Editor Page 4 5 WINDOW SIZE The window size determines how many characters of a field actually display on the screen This lets you have fields accept more data than would fit in the screen area allotted for them For example the AlphaCALC cell value field accepts entries of up to 254 characters but only 71 can be shown in the field at once 254 is the field maximum size and 71 is the window size The window size cannot be larger than the field maximum size If you want the window size to be equal to the field maximum enter 0 as the window size FIELD FLAGS The Field Flags setting determines various characteristics for the field mostly dealing with how the field accepts and displays user input Field Flags is a pull down menu field how to display the menu and make your choices is described earlier in this chapter The value for Field Flags is the total of the values of the flags you select The default value is 256 meaning only the Clear On Entry flag is set The following list describes all the flags you can set in this field They are in the same order as they appear on the pull down menu e Non Changeable Field numeric value 2 if you set this flag the user can move the cursor into this field but no input is allowed For example you may want to set this flag for a selection field where the

Download Pdf Manuals

Related Search

Related Contents

Lexibook DJ053TS compact camera  Operating instructions Linear Feeders SLS 250 SLS 400 SLS  Manual --- RackView High Res  New World NW5052FF  - NEC Display Solutions Europe  SATO CL608e  MANUALE DELL`UTENTE  Memorex MP3115 User's Manual  USER MANUAL IFB200  Japanisch-Deutsche Gesellschaft  

Copyright © All rights reserved. Failed to retrieve file