2 A Alphanumeric
&nbs (cont.)
p; N Numeric Shift (cont.)
(keyboard)
3 D Displayable
&nbs (cont.)
p; N Non-displayab (cont.)
le
4 R Regular Intensity
&nbs (cont.)
p; H High-intensit (cont.)
y
5 &nb (cont.)
sp; N Non-selector-pen (cont.)
detectable
6 &nb (cont.)
sp; M Modify Data Tag ON
&nbs (cont.)
p; F Modify Data Tag (cont.)
OFF
**
NOTE:
**
In a GUI environment the distinction between the Protect and Skip-Protect attributes is somewhat more important than in (cont.)
a text-based environemnt. If your application is executing in text mode, then the only difference between these (cont.)
attributes is that as the operator is typing into the screen the cursor will automatically skip, upon reaching a (cont.)
Skip-protect attribute on the screen, to the next Unprotected field. This is compared to the cursor simply stopping (cont.)
upon reaching a Protect attribute.
In GUI mode, the operator cannot even place the cursor to any Skip-Protected field on the screen. This is true whether (cont.)
using a mouse or cursor movement keys on the keyboard. That means that if your application expects the operator to (cont.)
point to a certain position or field on the screen, it must not be Skip-Protected.
##
Table of Attributes
In the MAGEC003 copy book included in your MMP's the symbolic six-character name is prefixed with an "AT" so that they (cont.)
will all appear together in a sorted cross reference listing (if used) from the Cobol compiler.
Symbolic Cobol Name Actual Code
Name (in MAGEC003) Value
UANRNF ATUANRNF <
UADRNF ATUADRNF b (blank)
UADHNF ATUADHNF H
UANRNM ATUANRNM (
UADRNM ATUADRNM A
UADHNM ATUADHNM I
UNDRNF ATUNDRNF &
UNDHNF ATUNDHNF O
UNDRNM ATUNDRNM J
UNDHNM ATUNDHNM R
PANRNF ATPANRNF %
PADRNF ATPADRNF - (dash)
PADHNF ATPADHNF Y
PANRNM ATPANRNM _ (underscore)
PADRNM ATPADRNM /
PADHNM ATPADHNM Z
SANRNF ATSANRNF +
SADRNF ATSADRNF 0 (zero)
SADHNF ATSADHNF 8
SANRNM ATSANRNM ' (apostrophe)
SADRNM ATSADRNM 1 (one)
SADHNM ATSADHNM 9
#
Appendix C -- Edit Type Codes
##
Automatic Editing
When you define your mask using MSKDEF, or when you modify it after having allowed the auto-paint feature to generate (cont.)
it for you, you can specify to MAGEC that you desire automatic editing to be done to screen fields. You do this by (cont.)
specifying, for each field, an edit type code.
These same edit type codes are also specified in the dictionary definitions for data items (DIT's). When you use the (cont.)
auto-paint feature (for online screens) or the automatic report program generation (covered in the "Batch Developer" (cont.)
Tutorial) MAGEC sets the screen or report editing formats based upon the edit type codes found in the DIT definitions. (cont.)
You can override them in the MSKDEF or RPTDEF functions if you need to.
There are three general categories of edit types:
AlphaNumeric
Numeric
Dates
The Cobol copy book for a mask or the detail line definition for a report will contain appropriate Cobol edit patterns (cont.)
(ie. ZZZ.99-) based on the edit type. You might refer to the chapter "Analysis of the Generated MMP" (found in the (cont.)
*Programmer's Reference Guide*) for more detail.
For numeric fields there is also a specification as to how many digits left of the decimal point and right of the decimal point are allowed.
One of the alphanumeric types is "T", that means table lookup validation. Operator entries will be validated by looking (cont.)
them up in a MAGEC lookup table. You can define lookup tables and the valid entries in those tables. Refer to the MAGEC (cont.)
"Database Administration" chapter for further details about lookup tables.
##
Table of Edit Types
AlphaNumeric Edit Types:
X
Miscellaneous fields, any characters will be accepted. Example: company name, comments.
b
Same as X.
A
Alphabetic (A-Z and blank) characters only. Example: person's name, city name.
U
Uppercase. Any characters will be accepted as valid, lowercase alphabetics will be converted to uppercase by MAGEC.
T
Table lookup. Same as U plus MAGEC will validate entry against a lookup table.
W
Where to display a description from a lookup table. Used in conjunction with a T field. MAGEC moves the description from the found entry in the table to a W field.
P
Pattern edited alphanumeric field.
Numeric Edit Types:
N
Numeric, MAGEC will pad with leading zeros.
S
Numeric, MAGEC will suppress leading zeros.
=
Same as S, plus trailing minus sign.
Z
Same as S, plus comma insertion.
-
Same as Z, plus trailing minus sign.
$
Same as Z, plus floating dollar sign.
#
Pattern edited numeric field.
Date Edit Types:
M
MM/DD/YY or MM/DD/CCYY (2 or 4-digit years).
D
DD/MM/YY or DD/MM/CCYY (2 or 4-digit year).
Y
YY/MM/DD or CCYY/MM/DD (2 or 4-digit year).
**
**
**
NOTE:
**
When the operator enters data into screen fields MAGEC accepts any valid, unambiguous format depending upon the edit type. For instance, in a type-$ field the operator may enter:
12345.5 -or -
1,234.50 -or-
$1,234.50 etc.
#
Appendix D -- Deleting Sample Online Application
##
If Sample is Already Done
If you are not the first one to follow the tutorial exercise then you will need to delete the previous student's work (cont.)
so that you can start "from scratch". You must be logged on to MAGEC before doing the procedure (cont.)
below.
**
enter SHDPUR 600 Message will tell you to press PF14
press PF14 All customization will be deleted
Mask will be deleted
All selections will be removed
MMP header will be deleted
Mask copybook will be deleted
Screen header will be deleted
#
Appendix E -- Most Used Online Functions
##
Developer's Functions
These are some of the most frequently used online MAGEC functions for application developers.
ALGLST mmm Directory of custom algs. for mask mmm
ALGxxx mmm/pppppppp/etc. Inquiry & maintenence for custom algorithms
BCHPGM nnnB Create batch report program
BCHLOC nnnB Locate batch report headers
DBDITO Character/hex record display/update
DBUTIL Character/hex record display only
DOCxxx topic name Inquiry/maintenence for documentation
ERRxxx eee Inquiry/maintenence for error msgs
LBRxxx member/modifier Inquiry/maintenence for lib member
LBRLST 1 List directory of library members
MMPxxx nnn Inquiry/maintenence for MMP headers
MSKDEF mmm Manual screen painting
MSKDEL mmm Delete mask detail
MSKDUP mmm Duplicate mask detail
MSKCRE mmm Online Mask Create (vs. batch MSKCREAT)
MSKSEE mmm Display generated mask
MSKPOP Display Pop-Up help for Screen Painting
PAINT1 mmm (thru PAINT7) Automatic Screen Painter
RPTDEF nnnB Report Painter
RPTDEL nnnB Delete report detail
RPTDUP nnnB Duplicate report
SCDLST mmm List locate headings for mask mmm
SCDCHG mmm/row/col Change locate heading for field
SCDTBL ttt Where-Used for Table number
SQLCRE mmm Generate SQL customization code
TBLLST ttt List lookup table entries
TBLxxx ttt/cccc Inquiry/maintenance for table entry
TOCLOC ttt List table of contents for lookup tables
TOCxxx ttt Inquiry/maintenance for TOC of lookup tables
TSKLST mmm Developer's task list
VERZUN MSKmmm Version verification for application
LEGEND:** mmm Mask number (pattern: 9xx)
** xxx Standard nine suffixes (ADD, CHG, etc.)
ttt Table number
nnn MMP/MBP number (pattern: 9xx)
pppppppp Insertion point name
cccc 1 thru 16-character code
eee Error number
##
Program Function Keys used in Developer's Functions
PF Keys (general)
PF15 Exit MAGEC
PF9 Swap Windows
PF12 Return to TSKLST (from a development function)
PF1 HELP key
PF2 Field-level HELP
PF16 Copy data to Copy/Paste buffer
PF17 Paste date from Copy/Paste buffer
PF24 Pop-Up short list from prior browse
PF11 Help Index
next: app07.md.txt