Mapper 35R1 Advanced Vol2

UNISYS 1100/2200 MAPPER®
Advanced Run Design

Efficiency
Student Guide
Volume 2
Copyright:" 1991 Unisys Corporation.

Unisys is a registered trademark of Unisys Corporation.
MAPPER is a registered trademark of Unisys Corporation.
Level 35R1 October 1991
Printed in U S America
SE 1565 UE 8416R2
8
Screen
Design
Methods
Module 8
Screen Design Methods
Objectives
Upon completion of this module, you should be able to:
1. Compare the screen input reserved words INPUT$, INVAR$, INVR1$,
INSTR$ within a run.
2. Describe the purposes and differences between the following statement:
a. LFC
b. SFC
c. FMT
d. OUV
e. ITV
3. Handle function key input within a run.
4. Describe the purpose of the 'forced transmit' and 'spaces' features of the
OUT statement.
8-1
Screen Input Reserved Words
• Use one of four reserved words

- Input$
Invar$
- invr1C1
- Instr$
• Allow you to capture user input from

terminal screen
• @CHG statement is used to load
variable(s) with user input
• Tab set is required to begin each user
entry field
@Brk .
Enter the appropriate information and transmit.
Last name:
First name:
Birthdate:
Employee #:
Place cursor here.> , and transmit .
@Brk out,-0,2,10,1,1 .
@Chg ?
8-2
INPUT$
• Used to capture input from terminal

screen
• Can capture up to 40 values (one for
each tab set placed on screen)
• @CHG statement loading reponse(s)
from INPUT$ to variable(s), must
follow the @OUT statement
Last name 0 smith

First name 0 Joe
Birthdate ❑ 010160
(1VIMDDYY)
Input$ Table
4- 256 Characters
smith
joe
40 010160
Values
@Out,c,d,r
@Chg Input$ v5h12,v6h10,v7i6
8-3
INVAR$ Pt
• Same as INPUT$ except:

@CHG statement loading reponse(s) from
INVAR$ to variable(s), must be before @OUT
statement
— if variables have been filled previously and
user does not fill all entry fields, corresponding
variables will be left unchanged
Last name 0 smith

First name 0 Joe
Birthdate o 010160
(MNIDDYY)
(
lnvar$ Table
4-- 256 Characters
smith
Joe
40 010160
Values
@Chg Invar$ v5h20,v6h100,716

COut,c,citr
8-4
INVR1$
• Same as INVAR$ except:

— Fields terminated by defined length of
corresponding variable or end of screen line
— Tab characters may be captured via INVR1$
allowing more than 40 inputs to be captured
— First tab character on each line may not be
captured
Last name 0 smith First name 0 joe

Birthdate 0 010160
(MMDDYY)
Invarl$ Table
4.-- 256 Characters
smith first name
010160
40
Values
©Chg invri $ v5s80,v616

@Out,c,d,r
8-5
INSTR$
• Used to capture a full line of input per

variable
• Tab character not required
• First variable will contain first line of
input following SOE character or first
line on screen if no SOE
— Second variable contains second line, etc.
End of line terminates input for each

variable
• Tabs including first tab on a line may
be captured
• @CHG statement precedes @OUT
6Text line 10 Sub 1

°Text line 2
DText line 3
Instr$ Table
80 Characters -••
❑ Text line 1 0 Sub 1
0 Text line 2
0 Text line 3
24
Values
@Chg lnstr$ vl s110,v2s80,v3s110

@Out,c,d,r
Output Variable Statement
@OUV,[sci,col] yid .
scl Screen line number on which to begin display.

Default = current screen line.
col Column position at which to begin display.

Default = current column position.
vld Data to display. Data can be a variable, constant,

literal, reserved word, or any combination.
Quickly displays data to the screen

— Interim display
Use as a debug tool to display

variables and reserved words
Use with @ITV (next page) when
capturing screen inputs
— More efficient than @BRK OUT sequence
— No screen erase features
— Cursor is always placed at the end of data sent
If @ITV immediately follows, interim

effect is altered
— Run execution is halted until user transmits or
hits a function key
8-8
Input Variable Statement
@ITV, [lab] .
lab Label to go toff the user presses a function key.
Variables in which to capture input (max = 40).
• Captures input values from screen

— First tab character on screen = first variable
• -0 result is not altered

• Line zero executions
— Are ignored (except '")
— Can be captured if tab character is placed in
home position of screen
• Takes control of function key

executions
FKEY$ is loaded when a function key is pressed
— Run execution is transferred to specified label
— Routines handling function key executions can
be internal only
• Stalls @OUV or @OUT (with an interim

display) until user transmits or
presses function key
8-9
@OUV Example
• RCR to process
LI NE's i RLO •St SHFTO HLD CHRS HLD LNO. UNDO. 1E188
.DATE 27 SEP 98 12:12. RID 1E 24 JUL 98 CRAIG
.TEST
41:
1$405 coni ss' ,+(totaDa8 .
a
@command
@command
@command
• Variable < total > is put to the screen via @OUV for 5 seconds
LINES 1 FNII. Metest HF11. NLD CHM. HLD 1,1* UNDOO. 1E188
.DATE 27 SEP 98 12:12:24 RID lE 24 JUL 98 CRAIG
JEST
@tot,O,c,1 r.81 'sales co sirs' <total>a8 .
@ouv,1415 (total) .
@wat 5848
@command
@command
@command
8-10
@0 UV / @ITV
Scenario
The run designer is writing a run that will solicit the user for many data
entries. The run will request one entry per screen. What would be the most
efficient way to accomplish this task?
Historical Solution
Use the @BRK I OUT combination to re-display the input screen.
Alternative Solution
Use the @OLTV / ITV combination

Disadvantages -
• No screen erase feature
• Only useful when soliciting one entry item per screen
8-11
@OLN / @ITV Example I
• RCR to process
LIt4D '112FMTO PLO SH110 HLD CHRS0 HLD 0 1E188 0

.DATE S 98 11:25:49 RID 11 24 JUL 98 CRAIG
.TEST
slog
ark ldv (line)a3=4
1111n,13,a,100 (lastlin)i2
Oibrk out -8
I •A:
1VM
alwr1,64 a,189, line> 2-7 E(value) .
@if (line) (lastlin) ulic to . ;inc (line) gto 861.,
N82:ds LO,a,106,„,9„ Your report has sucessfully been updated?'
@wat 5r1i; .
@gto end .
• Input screen is displayed. User enters the first value and transmits
Please enter your value: valuell
• Input screen is displayed the second time
Please enter your value: Puel
8-12
@OUV gnv Example I

• User enters second value
Please enter your value:
• Balance of screen entries are made

Updated report is displayed for 5 seconds
.DA
.MAPPER FREE FORM:
valuel
value2
value3
value4
value5
value6
value?
value8
8-13
Example Comparison
• Same task could have been accomplished this way
LIND 1 FMTO, RI) - SHM HLD CHRS HLD 11, 2E108

.DATE 27 SEP 98 11:18:38 RID 2E 27 SEP 98 CRAIG
.TEST2
@log
OUR lay (line)a37.4
@lln,8,a,1110 (lastlin)i2
o ,a„
8wr1,94 a,1,(line) 2-7 (value) .
@if (line) (lastlin) ulic gto 883. ;inc (line) gto 081_.
@802:aspLO,a,190.,„,g„ Your report has sucessfully been updated?'
Swat 588e
..... END REPORT
Comparisons
OUV/111/ BRK/OUT
Example Example
Functions 19 31
I/Os 50 74
Logic
Lines 44 64
Data
Lines 112 191
8-14
grry @OUV Example 2

• RCR to process
Line Rani. - 1E1

.DATE 98 18:48:41 RID lE 24 JUL 98 CRAIG
.TEST
elOO:hrk
Please enter:
your last name:
your first name:
your Middle name:
•Jou ace". -a• v. res e. a tuto tan gt ease again.. t
PcoMsand .
\„ @command .
• Menu is displayed. User presses a function key
Please enter:
your last name:
your first name:
your middle name:
• Error message is displayed for 2 seconds
Please enter:
your last name:
your first name:
your Middle name:
pi ti PS
8-15
Command Handler Statement
@CHD [c,d,r,rern lab .

c,d,r Report containing a command handler routine.
Report must be in the same character set as the
calHn g run.
rel? Y = Ignore release ( " ) command, do not allow

user to exit run. N = Allow user to exit run by
transmitting the release command ( " ).
lab Label where command handler routine begins.

Enter LIN1 in this field to begin at line one of an
external routine.
• Takes control of line zero executions

▪ ICVAR$ captures line zero entry
— Utilize by initializing a string variable via @CHG
• Takes control of function key

executions
FKEY$ Is loaded when function key is pressed
• Handler routines can be internal or

external
8-16
The Command Handler Statement
Scenario
A run designer needs to design a run for non-MAPPER users. One of the
requirements of this run is to over-ride line zero requests. The run designer
also wishes to design screens that allow the user to perform tasks by selecting
function keys. Therefore, the traditional function key processing (F1 -
resume, F2 - repaint, etc.), will be overwritten.
Solution
Utilize the @CHD statement to take control of line zero entry attempts
Include FKEY$ in an @IF statement to determine which function key was
pressed
• Run will branch to appropriate label containing a function key routine
8-17
Command Handler Example
RCR to process
LIMO 1 FRO EL) test SHFT)' HLD CHRSO HLD LN' UNDO. 1E168
.DATE 81 OCT 98 89:59:53 RID iE 24 JUL 98 CRAIG
.TEST
Enter Customer Code:

Enter Product Type:
Fl: Display Report F2=Qui t
@Chg Iovar$ (linezero)s80 .
@Eft Chg Invar$ (oust)a4,(prod)a9
Nutr0,2,3, L1
@If $ key$ 8,(2841,(39),2,019)
(48:Lok,O,b,6 Wr1,8,1),6,6 'product',1 cust' ,(prod),(cust> .
Kto 18 ,
NO:Dsp,001,6
@Gto 18
@48:Rel
@99:Ldv,p (linezero)
You entered <linezero> on line zero. This is not allowed.
@Erk Out .
Nat 3890 .
Kto 18 .
• Menu is displayed - User enters values and transmits
Enter Customer Code

Enter Product Type:
• Menu is redisplayed - User presses Fl

Enter Product Type: ...
F2:Quit
• Report is displayed verifying the update - User presses Fl to continue
LIND' 1 FMTO RLQ - SHFTO HLD CHRS) HLD IMO O 688

.DATE 81 OCT 98 IBM: 39 RID 6B 81 OCT 98 CRAIG
.chd stuff Corporate Production 8888802
*St.Status.By. Product .Serial.Produc.Oraer.Cust.Produo.Produc. Ship .Ship .Spo.
*ca. Date .In. Type .Number. Cost .Humbr.Code. Plan .Actual. Date .Order, Cod.
• 111011.11.
Blackboxl i moo
8-18
Command Handler Example
• Menu is redisplayed. User attempts to request a manual function

Enter Product Type:
Fl= Display Report F2=Quit
• Interim error message is displayed for 5 seconds
You entered tot 6100 on line zero. This is not allowed.
• Menu is redisplayed. User presses F2

Enter Product Type:
Ti: Display Report
Active logo is displayed - Run is terminated
*WM* BLUE BELL EDNET SYSTEM *****

** MAPPER 35R1 VIOSP 6R1 **
•UNIT :11638 USER: CRAIG *
******* MODE 182 DATA BASE ******
8-19
Key Statement
@KEY
Takes control of function keys only

— Does not control line zero entries
• This example is similar to the previous. The main difference is that the
run will not take control of line zero.
LIND FMTO RLQ - SHFTO HLD CHRSO HLD L 1E198

.DATE 81 OCT 98 18:87:35 RID lE 24 JUL 98 CRAIG
.TEST
t118:Brk
Enter Product Type
FL= Display Report F2=Quit
@Brk hg Invar$ (cust)a4,(prod)a9
Matz_ 13,L1
@If ixey$ ii,(61) 1,(38),2,(40)
126:Lok,8,b,6 Wr1,11,b,6,6 'product' cus ,(proa),(cust)
Kto 18
MO:Rel
END REPORT .....
8-21
Format Statement
@FMT [c d If] fieldl[field,field,...]
c,d,r Report from which to use fields to create a

format. (Default = -0)
field Fields to use to create a format (use field names
or character positions / lengths)
• Creates a report format for a following

output
— Format is temporary
— Format is available until another run statement
is processed
• Run must be registered as format
sensitive
• List fields in any order
— Partial fields are acceptable
• Line type character (column 1) is
automatically included
• Print temporary format by using @AUX
or @PRT
8-22
Format Statement Example

• RCR to process
• Report is displayed in format 0. User presses Fl to continue
LI ND 1 FMTO RLI - SHFTO HLD CHRS0 HLD LNO 1,, IDS

.DATE 22 SEP 98 13:39:12 RID ID 28 SEP 92 MODE122
.@991231 Corrate Order Status NO 86
St.Order . Product .Ora.Cust. Unit .Extendea.Re a.Sale.
.Qty.Code. Retail . Retail .De ivr.Rep .
*Ca.Numher. Type Customer
ie ii----
OR 999518 GREENBOX9 2 AMCO 848312 DJR AMERICAN OIL CO. 73
OR 999518 BLACKBOX9 1 ANCO 848312 DJR AMERICAN OIL CO. 73
OR 999518 GREENBOX7 1 AMCO 848312 DJR AMERICAN OIL CO. 73
OR 96652S BLACMBOX4 1 ARCO 848412 LSJ ARGENTINE CORP 23
OR 96652S GREENBOX4 2 ARCO 848412 LSJ ARGENTINE CORP 23
OR 96652S GREENBOX5 1 ARCO 848412 LSJ ARGENTINE CORP 23
OR 997538 GREENBOX5 1 DICO 848312 LSJ DIGITAL CORP 17
OR 998428 BLACEBOX8 1 FEDS 848312 PLR FED SYSTEMS CORP 15
OR 998428 BLACEB0X0 1 FEDS 848312 PLR FED SYSTEMS CORP 15
OR 967518 GREENBOX1 1 FEDS 848312 PLR FED SYSTEMS CORP 15
OR 945258 GREENBOX8 1 FEDS 848312 PLR FED SYSTEMS CORP 15
• Report is displayed in new format
LINES 1 FMT0 0 RL) - SHFT0 HLD CHRS0 HLD LNC 0 IN 0

.DATE 28 SEP 98 13:39:12 RID 1D 28 SEP 90 MODE122
M91231 Corporate Order Status D000006
* Product .Cust. .
* Type .Code. Customer . City :State:
ie
GREENBOX9 AMCO AMERICAN OIL CO. NEW ORLEANS LA
BLACEBOX9 A NCO AMERICAN OIL CO. NEW ORLEANS LA
GREENBOX7 AMCO AMERICAN OIL CO. NEW ORLEANS LA
BLACEBOX4 ARCO ARGENTINE CORP NEW YORE NY
GREENBOX4 ARCO ARGENTINE CORP NEW YORE NY
GREENBOX5 DICO DIGITAL CORP NEW YORE NY
ELACEBOX8 FEDS FED SYSTEMS CORP WASHINGTON DC
EAMON FEDS FED SYSTEMS CORP WASHINGTON DC
GREENBOXI FEDS FED SYSTEMS CORP WASHINGTON DC
OREM FEDS fELMIREAM WASHINGTON TYDCT 1
8-23
Load Field Character Statement
@LFC v
v Variable to capture the format of the report or

result on display
• Captures format of report or result

currently on display
• Current display can be 'user altered'
— Created by manual shifting / holding
— Created by the temporary VIEW command
• Variable is loaded with X's and spaces

X's represent character positions to include in
format
— Spaces represent character positions to
exclude from format
Set Format Characters Statement
@SFC[IcId,r] yid .
c,d,r Report on which to set the format, Default = -O.
vld Variable name from a previous @LFC statement

or characters (X's and spaces) defining a new
format.
Establishes a format for a following

output
In the yid field of @SFC statement:
— Specify variable name (containing X's and
spaces)
— Actually place x's and spaces (in single

quotes), in yid field
Print temporary format by using @AUX

or @PRT
8-25
Temporary Report Formatting
Scenario
The run designer needs to write a run that will display several 'like' reports to
the user. The designer wishes to give the user the opportunity to alter the
format of the first report displayed. Next the designer wants to save and reuse
this temporary format for subsequent report displays. This way, the user
won't have to shift each individual report.
Historical Solution
Set up a format in Report 0 . The drawback is that in this scenario, all six
formats are already utilized.
Solution
Use @LFC and @SFC to capture, save, and reuse temporary report formats.
8-26
@LFC @SFC Example
• RCR to process
Lined 410 - 63E6

.DATE ' '8 11:54:34 RID 63E 61 OCT 96 CRAIG
JONAH WI ORO
CT MEN - F7) TO CREATE FORMAT FOR THE FOLLOWING REPORTS'
ilDSP, 0, D,18 .
.DSP, 0, D,11 .
EISRH,O,1),11 " 'CUST Cow FEDS ,
@HP -it 8 •
#MLEVP,J;IAM
..... END REPORT
• ID is displayed. User selects 'VIEW' (F7) to create a temporary format

• User transmits from 'Create temporary format'
M91231 Status Report Coiporate Order Status D000006

St.Order • Product .Ord.Cust. Unit .Extended.Re a .Sale.
*Cd.NumLer. Type .Qty.Code. Retail • Retail .De ivr.Rep .....Customer
..........:
41.7..
OR 99951S GREENBOX9 2 AMCO 846312 DJR AMERICAN OIL CO. 73
OR 999515 BLACHBOX9 1 ACCO 848312 DJR AMERICAN OIL CO. 73
OR 99951S GREENBOX7 1 AMCO 846312 DJR AMERICAN OIL CO. 73
OR 966525 BLACHBOX4 1 ARCO 848412 LW ARGENTINE CORP 23
OR 966525 GREENBOX4 2 ARCO 840412 LW ARGENTINE CORP 23
OR 96652S GREENBOX5 1 ARCO Change View
OR 997535 GREENBOX5 1 DICO 7
OR 99842S BLACEBOXS 1 FEDS 5
OR 998425 BLACHBOX6 1 FEDS 5
OR 96751S GREENBOX1 1 FEDS Display alternate format (Fn)
OR 94525S GREENBOX8 1 FEDS Display and bold headings (DH) 5
OR 99725S BLACHBOX4 1 IHTR Hold lines on screen (Hn) 3
OR 98782S BLACHBOX9 1 USSC Shift display (SO 4
OR 967555 GREENBOX9 1 USSC 4
..... END R
1Resume 2Paint 4Re turn 5 SHOP 9 AQuit
8-27
@LFC @SFC Example
• Fill in 'View' menu. Place an 'x' for every field to include in new format
Type an X in the fields you want to display and press XMIT.

2Paint 3 4Return 5 6 7 8HelP
• Report is displayed in new format. Press Fl to continue

Line0. I Roll,. - 1D9
.DATE 18 JUL 98 12:27:11 RID a 2? SEP 89 Shift
.M91231 Status Report Corporate Order Status MOON
* Product .Cust. .
* Type .Code. Customer City :State:
M10.0411111041. t 4Wi++WrAI.flmomWsr11.10.0,011.0111.0410.1..s arrsMIPi411111m1MWOmi4MOOM
GREENBOX9 AMC° AMERICAN OIL CO. NEW ORLEANS LA

BLACEBOX, AMC° AMERICAN OIL CO. NEW ORLEANS LA
GREENBOX? MO AMERICAN OIL CO. NEW ORLEANS LA
BLACKBOX4 ARCO ARGENTINE CORP NEW YORK NY
GREENBOX5 DI CO DIGITAL CORP HEW YORK NY
BLACKBOX8 FEDS FED SYSTEMS CORP WASHINGTON DC
BLACEBOX8 FEDS FED SYSTEMS CORP WASHINGTON DC
GREENBOX1 FEDS FED SYSTEMS CORP WASHINGTON DC
GREENBOX8 FEDS FED SYSTEMS CORP WASHINGTON DC
EAMON INTR INTERNATIONAL CO CHICAGO ILL
BLACXBOX9 USSC UNION STEEL/SULFR SEATTLE WASH
GREENBOX9 USSC UNION STEEL/SULFR SEATTLE WASH
..... END REPORT .....
8-28
@LFC @SFC Example
• Report 10D is displayed in the format created by 'View'

• Press Fl to continue
(
LineOP Ro110, - Shift 18D8
.DATE 11:47:44 RID 81 OCT 98 CRAIG
.PIZZA MMK Corporate Order Status D88 86
* Product .Cust.
* Type .Code. Customer City :State:
PIZZABOX8 FEDS FED SYSTEMS CORP WASHINGTON DC
PIZZABOX4 ARCO ARGENTINE CORP NEW YORE NY
PIZZABOX4 INTR INTERNATIONAL CO CHICAGO ILL
PIZZABOX9 AMCO AMERICAN OIL CO. NEW ORLEANS LA
PIZZABOX9 USSC UNION STEEL/SULFR SEATTLE WASH
PIZZABOX4 ARCO ARGENTINE CORP NEW YORK NY
PIZZABOX5 ARCO ARGENTINE CORP NEW YORK NY
PIZZABOX3 DICO DIGITAL CORP NEW YORK NY
PIZZABOX? AMCO AMERICAN OIL CO. NEW ORLEANS LA
PIZZABOX9 AMCO AMERICAN OIL CO. NEW ORLEANS LA
PIZZABOX9 USSC UNION STEEL/SULFR SEATTLE WASH
..... END REPORT.....
• Report 11D is displayed in the format created by 'View'

Linello 1 Ro1I - Shift 11D8

.DATE 11:46:22 RID 81 OCT 98 CRAIG
.fruit Corporate Order Status D888986
* Product .Cust.
* Type .Code. Customer City .State.
. .
FRUITBOX8 FEDS FED SYSTEMS CORP WASHINGTON DC
FRUITBOX4 ARCO ARGENTINE CORP NEW YORK NY
FRUITBOX4 INTR INTERNATIONAL CO CHICAGO ILL
FRUITBOX9 ANCO AMERICAN OIL CO. NEW ORLEANS LA
FRUITBOX9 USSC UNION STEEL/SULFR SEATTLE WASH
FRUITBOX4 ARCO ARGENTINE CORP NEW YORE NY
FRUITBOX5 ARCO ARGENTINE CORP NEW YORE NY
FRUITBOX5 DICO DIGITAL CORP NEW YORE NY
FRUITBOX? AMCO AMERICAN OIL CO. NEW ORLEANS LA
FRUITBOX9 AMCO AMERICAN OIL CO. NEW ORLEANS LA
FRUITBOX9 USSC UNION STEEL/SULFR SEATTLE WASH
8-29
@LFC @SFC Example
• 11D search result is displayed

Line,. 1 Rol10 -
• 4 LINE(S) FOUND OUT OF 14 LINES
****
• FEDS
:DAtE 11:46:22 RID 11D 01 OCT 90 CRAIG
.fruit Corporate Order Status D 86
St.Order . Product .Ord.Cust. Unit .Extended.Re d .Sale.
*Ca.Number. Type .Qty.Code. Retail . Retail .De ivr.Rep .. ..Customer
_ .... ..
OR I•FOS 840312 PLR FED SYSTEMS CORP 15
OR 99842S FROITBOX8 1 FEDS 840312 PLR FED SYSTEMS CORP 15
OR 96751S FRUITBOX1 1 FEDS 840312 PLR FED SYSTEMS CORP 15
OR 945255 FRUITBOX8 1 FEDS 840312 PLR FED SYSTEMS CORP 15
. END REPORT
• Search result is displayed in 'saved' format
Linen i Roll - Shift RESULT

. 4 LINE(S) FOUND OUT OF 14 LINES
****
FEDS
:DAtE a 11:46:22 RID 11D ei OCT 90 CRAIG
.fruit Corporate Order Status D 8866
* Product .Cust. .
* Type .Code. Customer City .State.
FRUITBOX0 FEDS FED SYSTEMS CORP 'WASHINGTON DC.
8-30
Statement Matrix
OUV ITV CHD KEY
Takes Control of
Line Zero
Captures Line
Zero Entries
Takes Control of
Function Keys
V i,71
Places Data to
Screen
V
Captures Screen
Entries
i
8-31
The Forced Transmit
@OUT,c,d,r,11q ssi,tp,se,id,pdq,protect?thant?,outsp?,blink?,sn,lab
Screen input handling technique

Considers an entire screen of data
input regardless of where user
transmits
• Enter Y in twelfth subfield of @OUT
statement
Auto parameter FCXMIT must be
enabled
• Forced transmits will reset 10$, LLP$,
and DLP$ counts
Forced Transmit
Scenario
The run designer is having trouble with a run in production. The run- displays
data entry screens to the user. There are several fields per screen that need to
be filled in. The problem is - users even though they are probably entering
data into everyfield, only 'part' of the data is actually getting loaded into the
screen input variables properly. The reason for this is that the user, from time
to time, goes back up to a field to make a change before transmitting. The
user then transmits from the middle of the screen. Only the data preceding
the cursor is sent. How can the run designer ensure that the entire screen will
be considered?
Solution
Utilize forced transmit capability of the @OUT statement
8-33
Forced Transmit Example

• RCR to process
Una,' 1 Rolla*g
i gt 1E1
.DATE 81 OCT 98 12:22:7 RID 1E el OCT 90 CRAIG
.test
@BRE .
ENTER YOUR FIRST NAME a
FAVORITE GAME
FAVORITE FOOD a
FAVORITE SHOW S
FAVORITE SONG
EMIT FROM HERE ,
,(GANDA16,<FOONA16,(SHOWA16,(SONOA16
(NAMEWOME>,(FOOD),(HOWASONO
YOUR FAVORITES ARE: (GANE),(F000,(SHOW), and (SONG}
MX
• User enters input
ENTER YOUR FIRST NAME wilber

FAVORITE GAME old maid
FAVORITE FOOD oatmeal
FAVORITE SHOW that girl
FAVORITE SONG born free
WIT FROM HERE ,
• Before transmitting, user decides to change one of the entries - then

transmits from end of entry
ENTER YOUR FIRST NAME wilber

FAVORITE GAME el% e 111
FAVORITE FOOD natNeAl
XMIT FROM HERE ,
8-34
Forced Transmit Example

• @IF statement detects that cursor was not in correct position when the
user transmitted
• Second @OUT statement forces cursor to the bottom of screen and
re-sends the input screen for processing
ENTER YOUR FIRST NAME Wilber

FAVORITE GAME crazy 8s
FAVORITE FOOD oatmeal
XMIT FROM HERE I
Output result is displayed
YOUR FAVORITES ARE: crazy 8s,oatmeal,that girl, and born free .
8-35
Handling Spaces
@OUT,c,d,r,l,q,ssl,tp,se,id,pdcbprotect?,fxmt?,outsp?,blink?,sn,lab
• Offers greater control over output

containing spaces
• Utilize the thirteenth subfield of the
@OUT statement
Options:
N or blank (default) Nonspace data is sent to the screen as is. Spaces

are handled as follows:
If 5 or less spaces exist between characters,
spaces are sent.
If more than 5 characters exist between
characters, spaces are not sent. CulTent screen
characters remain.
A Lines are sent exactly as is, including any and all
spaces.
B No spaces are sent. Non space data is blended
with current screen characters.
8-36
Handling Spaces - N Option
• RCR to process
LI NEM` 1 FMTO RD. SHFT HLD CHRSO HLD LNC UNDOIP. iLteri
. DATE It OCT 99 12:49: ID 1E It OCT 98 CRAIG
.test BY : CEX
727272Z722.772Z7272ZZEZZZ2712273ZZ27222Z2Z22272Z2Z272.7722712
@BB OUT, -8 3 1,1
HD THIS OVER THE 2" S
- .*
..... END REPORT
• First result is displayed
ZE272Z2712222272227,222222=122272,727222=222222222222
• Second result is displayed

• Spaces are only sent if there are less than 6 between words
I AM GOING TO SEND THISZZ72220UER22222222THE 2'S
8-37
Handling Spaces - A Option

• RCR to process
Lit1 FNTO. RIA* HLD CHRSO. HLD RSP 1E188 10

.DATE el OCT 99 12:58:r ID 1E 81 OCT 98 CRAIG
. test
- BY: ax
72n7V272W4Z2=ZZZZZZ72Z272=711Z2ZZZZZ2721/222MZZZZZ2Z!ZZZ
KIRK OUT , -0 3 1,1
THIS OVER THE 2"S
... END REPORT
=272Z2Z7Z2Z722ZZEZZ22ZZZEZ7272712Z2=2=Z2Z2

• All spaces are sent
I AN GOING TO SEND THIS OVER THE 2'S
8-38
Handling Spaces - B Option

• RCR to process
LIND 1 FMTO 11140 001SHFTO HLD CHM HLD LPW UNDO. 1E188 0
DATE 81 OCT 98 12:51:18 ID lE 81 OCT 98 CRAIG
,test BY: CEX
ZZZ2ZZZZZEZZZ2ZZZEZZZZ2ZZZ2Z2Z2Z2Z22222Z2ZZZ2Z2Z2Z2Z2Z2Z2
HRH OUT,-8 3 1,1
THIS OVER THE Z"S
..... END REPORT
Z2Z2Z2=Z2Z7272222Z2227,27272727aZZZZEZEZ222Z2Z2E22T22222

• No spaces are sent
IMPOZGOING722TOTB2SEND22222THISMMOVERM2222ZTHEZZ'S
8-39
Exercise
1. Write a run that solicits user input. Use the ITV statement to caoture the
entries into variables. Also utilize OUV to verify the contents of the
variables. The run must also contain routines that re-define normal
function and transmit key processing.
2. Write a run that displays several 'like' reports to the user. Allow the user
to alter the display of the first report by shifting /holding characters or by
using the VIEW command. Display the following reports in the new
(temporary) format.
8-41
9
Screen
Control
Module 9
Screen Control
Objectives
1. Use the Screen Control (SC) statement, alone with selected screen
commands, to create display screen for use within a run.
2. Utilize the SCGEN run to build screens.
9-1
Screen Control
Screen Control
• Use Screen control to

— Create menus
— Create input screens
— Create screen overlays
— Edit existing displays
• @SC run statement interprets screen

commands
— Two formats available
Alternative to 4 to 1 and 5 to I screen

design methods
— More efficient
— Code is easier to write and maintain
— Provides full screen and field control instead of
character by character control
— Function bar can be redesigned
Can provide context sensitive help for

input fields
9-2
Screen Control
Screen Control vs 5 To
= = =*NO WIMP +=111 EM. ONO 41111. = == = = ====
L
C
G
`11. -16.
L L L L
S C S C
0 a
Search Report Data
L L L L
C SC
0 G
L N I N
LL
S C B C sC
I C G
0
I SUSS$$$$$$$$$$ 1 G
!
Report or Drawer
L N 1N L L
S C BC SC
I C G 0 1G
! SS I
Format
L L L
S c S C
1 G
L
S
versus
* = = =
prep
fld,3,19,6,43,11,(pr,rv,whi/b110
fld,4,21,4,39„(11,pr,yelibla)
fld,3,28„24,1,(pr,whlired)„' Search Report Data
pc,+2,24;'Report or Drawer 1,fld„”16,u,(ts,a1)
pc,+1,24;' Format ';fld,„,2,u,(ts,no)
9-3
Screen Control
@SC Statement Format One
@SC[„„tabpIsn,lab] O scmnd
tabp Tab position to place the cursor on the screen

sn Station number where output is to be displayed
lab Label to go to if station number does not exist
SC options
scmnd Screen command(s) to be executed
Use to directly specify screen

commands
• Typically used to modify an existing
screen
Send messages to the screen
94
Screen Control
Format One Example
• Run containing @SC statement format one

" D
lR E
.TEST
IrS6F197 1851:88 RIFIFT 681 IlLf1cgr92 1Clitr
BY: Sam Cooke
6811
1828812
11. \
@DSP, 8 )3 98,,,, 9
7421:.
• '450000' inserted
LIND I FMT). RLQ SH1711. HLD CHRS HLD LNO. 98B8

.DATE 18: :53 RID 98B 11 OCT 90 CRAIG
.@ Production Status Report Corporate Production B8882
*St.Status.By. Product .Seria1.Proauc.Order.Cust.Proauc.Produc. Ship .Ship .Spc.
. Date .In. Type .Number. Cost .Nambr.Code. Plan Actual. Date .Order. Cod.
41= Will/O/D011/
IP 831224 LS BLACKBOXI 436767 4389 AMCO 831223 831224

IP 831225 LS BLACXBOX1 436768 84398 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637971 84353 INTR 831218 831219
OR 848112 LS BLACXBOX4 94754 ARCO
SC 848112 LS KAMM 675281 97441 FEDS Hein
IP 831222 LS BLACKBOX5 737582 84848 AMCO 831222 831222
SH 831283 LS BLACKBOXO 74632? 54237 FEDS 831201 831282 831283 S8738
SN 831282 LS BLACXBOX6 368861 54438 FEDS 831201 831281 831282 S693?
SH 831289 LS BLACKBOX6 777324 54232 DICO 831207 831288 831209 S8538
SN 831283 LS BLACKBOX6 78536? 52833 ARCO 831281 831282 831283 58934
IP 831216 LS BLACXBOX6 926581 89381 INTR 831215 831216
OR 831210 LS BLACXBOX7 99842 FEDS
OR 83122? LS BLACKBOX7 99725 INTR
SC 8481 LS BLACKBOX? 665481 97541 FEDS 848122
IP 831227 LS BLACKBOX? 733597 84351 AMCO 83122? 831227
SH 831282 LS BLACXBOX? 744627 44232INTR 831281 831281 831292 S8531
11) !ilia RUM 933581 84381 FEDS 831215 831215
9-5
Screen Control
@SC Statement Format Two
6SC cyclA,Ilcbtabpysn,lab] o fidtxt .
c,d,r Report containing screen commands

1 Line number of report to start reading screen
commands (default = 2)
q Number of lines to read (default = all)
tabp Tab position at which to place the cursor
sn Station number where output is to be displayed
lab Label to go to if station doesn't exist
O Options
fldtxt Field Text - text to be inserted into an

unprotected field. (*Must specify T option to
ublize)
Use to access a report or result

containing screen commands
9-6
Screen Control
Format Two Example

• Run containing @SC statement that accesses commands in 65E100
Lin0 1 Roll 59E188

.DATE 11 OCT 98 18:51: 59E 38 MAY 98 CRAIG
IRON FUNCTION DATA: BY: CRAIG H.
.. .
Control is returned to the calling run when user transmits from menu
@command
@command
@etc.
..... END REPORT
Report containing @SC commands

Linelo. 1 Rolllik - inlet ,
.DATE 11 OCT 9th 19152t56 RID 65E........36111ATI8. CRAIG
.@ :..1411t:t0D1:-.:IV:i3E:.:ACCESSIM..:11t. T.111:TES.I.:::Riltt:i::: BY: CRAIG X.
itiiia ii
PREFIPC,4,15" IN PURSUIT OF TRIVIA'

PC,6,1;1 GE0GRAPHY' 6L24„10E; FLD, 6, _26,1,1„ MAI), (PR)
PC,81.1;" ENTERTAINMENT' IFC,8„24;SOE;FLD„8 26,1,1„ (TS, AI) ,(PR)
PC, le, i; HISTORY' 'PC,.1_, e 24,_ '50ELFLD,16063,1, i„ Cis, AI ), CPR)
PC,12,1;' ARTS AND'LITERATURE:1 Ls mlz,241S0ELFLD,12,26,i,1„(TS,AI),(PR)
PC,14,1;'SCIENCE AND NATURE'LFC,14,24;SOL'ILD,14,26,1,1, CTS,AI),(PR)
PC, 16,1; SPORTS AND LITERATURE' ;PC,16,24;SOZILD,16,26,1:1„ (MN), CPR)
PC,18,1;'Emir:PC,18,?4,'SOE_IFLD,18,26„1„1„CTLAIMPR)
PC, 88,1;' To THE CATEGORY OF YOUR cHoIcE AND PRESS 5041111 ;TAB,2
END WORT
• Menu produced
IN PURSUIT OF TRIVIA
GEOGRAPHY
ENTERTAINMENT
HISTORY
ARTS AND LITERATURE 0
SCIENCE AND NATURE M.
SPORTS AND LITERATURE
EXIT
TAB TO THE CATEGORY OF YOUR CHOICE AB PRESS XMIT
9-7
Screen Control
@SC run statement options
Blink. < and > signs become blink characters.
C Center. Allows a menu designed to be centered

on an 80 character screen to be centered on
terminals of other widths.
H Home Qirsor Bypass. Bypass the initial 'home

cursor' command performed by @SC statements.
Output is treated as an interim display.
Key Mapping. Output display will not disable

current function bar definitions.
Line Control. Allows you to regain line control

of the previous display by using the PAINT key.
Mask. Sends the data not the spaces.
Overlay Menu. Reprocesses screen commands,

but only repaints text. Efficiently repaints or
places new data onto an existing menu.
Quick Output. Resumes the run automatically

when the output is displayed. Similar to the I
option (slightly less efficient but faster).
Send the data including all spaces.
Field Text. Inserts text supplied in the fleitxt field

into unprotected screen fields created with the
FLD screen command.
U Update Control. Overlays a report with data, but

allows manual updating of the report afterward.
Causes a screen to be transmitted as it is

displayed, just as if the user transmitted.
9-8
Screen Control
Screen Commands
• Six types of screen commands

— Cursor control commands
— Screen editing commands
— Field and attribute commands
— Text handling commands
— Screen printing and setup commands
• Screen commands are executed in the

order that they are stated
• Use semicolon to separate commands
• When specifying screen coordinates
— Line and column numbering begins at home
position (1,1)
— if a value is omitted, the current cursor position
is used
— if a value is specified (i.e. +3 or -10), it is
relative to the current cursor position
• Any data that is not a valid screen

command is interpreted as literal text
— literal text containing spaces must be enclosed
in single quotes
• Not all screen commands work on all

types of display terminals
• Screen commands must begin in
column one
9-9
Screen Control
Cursor Control Commands

HC Home Cursor.
PC,r,c Position Cursor. Moves the cursor to a specified

row (r) and column (c). Positive and negative
numbers can be used m place of line and column
numbers. These are position specifications
relative to the current cursor position.
CR,n Performs a carriage return (n) times. Default =
TAB,n Tab the cursor + or - (n) positions. Default = I
• RCR to process
LI HEMI RD, RLO StIFTO, HLD CHRO. HLD 68F8 01:)

.DATE 98 11:82:34 RID 68F 11 OCT 98 CRAIG
.TEST BY: Sam Cooke NW, tit2
OSP 2,1192
END REPORT
9-10
Screen Control
Cursor Control Command Example
• Output is displayed
RD CHRSO HLD LW 0. 98 0
VATi 1 FM1) 18:88:53SHFTO
RID 98E11 OCT 98 CRAIG
.01 Production Status Report Corporate Production 82
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost NumBr.Code. Plan .Actual. Date .0rder.Cod.
41= . . .
IP 831224 LS 436767 84389 MO 031223 831224
1414n 436768
IP 83/225 LS 44€4, 84398 AMC* 01223 831225
IP 831219 LS : . 4: s' 63701 84353 INTR 831218 831219
OR 848110 LS BLACKBOX4 94754 ARCO
SC 848110 LS BLACXBOX5 675281 97441 FEDS 848131
IP 831222 LS BLACXBOX5 737582 84848 AMC° 831222 831222
SN 831283 LS BLACKBOXO 746327 54237 FEDS 831281 831282 831203 S8738
SH 831282 LS BLACXBOX6 368861 54438 FEDS 831281 831201 831202 56937
SH 831289 LS BLACXBOX6 777324 54232 NCO 831287 83.1.2',,: 831289 58538
SH 831283 LS BLACXBOX6 78536? 52833 ARCO 831281 831282 831223 S8934
OR 831218 LS BLAUBOX7 99842 FEDS
OR 83122? LS BLACKBOX? 99725 INTR
‘ S.0 0404:': I4 BACON? 665481 97541 FEDS 849122
Explanation
Report 98B is placed on the screen as an interim via the DSP command. The
PC command positions the cursor to the sixth line of the report at the
Product Cost field. The data '450000' is placed at the current cursor position.
The TAB command places the cursor on the seventh line of the report in the
Product Type field. The data Tizzaboxr is placed at the current cursor
position. The HC command puts the cursor in the 'home position.'
9-11
Screen Control
Screen Editing Commands

.
CS Clear Screen. Erases the entire display and
moves the cursor to the home position
ED Erase Display. Erase the display from the

current cursor position to the end of the screen.
EUD Erase Unprotected Display. Erases the

unprotected portion of the display from the
current cursor position to the end of the screen.
PD Protect Display. Display is protected beginning

at the cursor position and continuing to the end
of the display. Does not alter the text and
attributes that you are about to display. Typically
used to prepare the screen for an overlay.
DIL[,n] Delete in Line n times. (Default = 1)
DID[,n} Delete in Display n tinges, (Default = 1)
111[,n] Insert in Line n firm. (Default = 1)
D1)[,n} Insert in Display n times. (Default = 1)
DL[,n] Delete Line. Deletes line cursor is located on,

moving the remaining lines up. Repeat n times.
(Default = 1)
11.[,n] Insert Blank Line at the current cursor position n

times. (Default = 1)
DUP[,n] Duplicate Line n tirnes (Default = 1)
EEL Erase to the End of Line. Erases from the

current cursor position to the end of the line or
field, whichever occurs first. Attributes and
protected fields are not erased.
9-13
Screen Control
Screen Editing Commands Example

• RCE to process
LIND lett FM TO )11, SHTTO NLD CHM NLD O. WO 0
.TEST ..... BY: San Cooke 7808012
--
--_---_---------------_-----
iltelOMMOOMMODM410410
------------------------------
60M41.40110
- - -
011.110MOWOOMD ...
........ . ...
RUA h,98
@SC " ,pc,7ji21
A AAAAAAAAAAAAAAAAAAAAA
iso " BBBEBBOBBUBBUBBBB
Report 98B is displayed

LIMO. 1 11411 R1,1 SHIND. NLD CHRSO NLD LW 0 98 0,
.DATE 19: - :53 RID 98B li OCT 99 CRAIG
.8 Production Status Report Corporate Production13688202
gl .Status.Bg. Product .Serial.Produc. Order.Cust.Produc.Produc. Ship .Ship .Spc.
Date .In. Type
*taw smulows emus
*Humber. Cost Numbr.Coae. Plan .Actual. Date .Order.Cod.
11.01.11MMODOWMO 40MOOMMOM M341.41M #1.041106111 M.1.11.110.11041. 4104.1.10W01.4.0 4111.0.11100001,4111, .11.10111011000 4100IDSS

IP 831225 LS BLACXBOXI 436768 84390 AMCO 831223 831225
IP 831222 LS BLACKBOX5 737582 84848 NCO 831222 831222
SN 831283 LS BLAMBOX9 746327 54237 FEDS 831201 931292 831203 S8?38
SN 831282 LS BLACXBOX6 368861 54438 FEDS 831281 831291 831202 86937
SN 831289 LS BLACXBOX6 777324 54232 DI CO 831207 8312 831289 58538
SN 831283 LS BLACOOM 785367 52833 ARCO 831281 831282 831283 88934
OR 831210 LS BLACXBOX? 99842 FEDS
OR 831227 LS BLACKBOX7 99725 MR
IP 831227 LS BLACKBOX7 733597 84351 AMCO 83122? 831227
SN 831282 LS BLACXBOX7 74462? 44232 INTR 831201 831281 831202 S8531
IP 831215 LS BLACKBOX7 933581 84381 FEDS 831215 831215
9-14
Screen Control
Screen Editing Commands Example

• AAAAA's are inserted
LIND 1 FMTO RIS SHFTh HLD CHRSO HLD LW 0 98 0

.DATE 19: :53 RID
f ‘•
IN
98B 11 OCT 90 CRAIG
.@ Production Status Report Corporate Production B !,A2
*St.Statusay. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*ca. Date .In. Type .Number. Cost .Nuar.Code. Plan .Actual. Date .Order.Cod.
ie- ---- - - -- -- --- -- ----- - istwiiii,s1-- - -- --;- s----- ------ - ---- - --- F:F.2
IP 831224 LS BLACKBOYI 436767'mmenflAAAARAIOARAAA; 84389 AMCO 831223 8312
831225 LS BLACOOM1 436768 8439w co 6111. 3 831225
OR 840110 LS RACOON 94754 ARCO
SC 840110 LS BLACHBOY5 675281 97441 FEDS 848131
IP 831222 LS BLACOOM 737582 84640 NCO 831222 831222
SH 831283 LS MAUNA 746327 54237 FEDS 831281 831282 831293 S8?38
SH 831282 LS BLACKBOX6 368861 54438 FEDS 831281 831201 831202 5693?
SH 831289 LS BLAUBOY6 777324 54232 DICO 83128? 8312 831209 58538
SH 831283 LS BLACKBOY6 78536? 52833 ARCO 831281 831282 831283 S8934
IP 831216 LS BLACOOM 926581 89381 INTR 831215 831216
OR 831210 LS BLACKBOY7 99842 FEDS
OR 83122? LS BLACXBOX? 99725 INTR
TP 1121227 LS RLACYROV7 722597 84251 AMNI R21227 821227
BBBB's are inserted

I
LIND 1 FRO RD, MIFTO HLD CUD HLD LNC 98
.DATE le: :53 RID 988 11 OCT 90 CRAIG
.@ Production Status Report Corporate Production BOO 02
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship . Spc.
*ca. Date .1n. Type .Nutter. Cost .NumBr.Code. Plan .Actual. Date Order. Cod.
-- - -- --- ------- -
• --- ---
IP 831224 LS BLACDOX1 436767 AAAAAAAAAAAAAAAAAAAAAA 84389 AMCO 831223 8312
IP 831225 LS BLACUOYI 436768 84398 AMCO 831223 831225
IP 831219 LS BLACKBOY2 637871 831219
OR 840110 LS BLACKBOX4
Explanation
Report 98B is displayed. First SC statement positions the cursor to row 7

column 32, inserts-in-line 20 spaces, places AAA data in the current cursor
position. The second SC statement positions the cursor to row 10,column 32,
erases the screen from the current cursor position, and places BBB data at
the current cursor position.
9-15
Screen Control
Attribute Parameters
Input Control Parameters
Al Any input allowed (default).
AO Alphabetic input only.
CO Cursor Only
NO Numeric input only.
PR Protected - cursor can not be placed in field.
Intensity Parameters
BL Blinking.
LT Low Intensity.
NI Normal Intensity (default).
RV Reverse Video.
VO Video Off.
Other Parameters
Unprotected Emphasis. Causes the emphasis to

be destroyed if the data at that location is erased.
RJ Right-justify data entered by the user.
TS Tab Stop. Unlike a tab character, an attribute tab

stop does not require a screen location. The
cursor stops at the attribute position rather than
immediately after it.
-16
Screen Control
Attribute Parameters
Color Paiameters
BLA Black
BLU Blue
CYA Cyan
GRE Green
MAG Magenta
RED Red
WHI White
YEL Yellow
Color parameters are always specifies in pairs. The forward slash character ( lJ
is used to separate them. For example, WHI/RED =white characters on
a red background.
Terminal Defined Color Parameters
BAC Background color.
BOC Border color.
TC Title color.
MC Menu color.
FC Field color. Use with 'input edit' parameters.
RC Report color. Selects color based on current -O.
9-17
Screen Control
Field and Attribute Commands
Attribute (ATT)
Define Attribute (DEF)
Field (FLD)
Message (MSG)
Prepare Screen for Painting (PREP)
Define Field (DFLD) and AREA

Screen Control
Attribute Command
ATT,attr[,r,c]
attr Attribute to be output.

r,c Cursor position where attribute begins.
• Output an attribute at the current or

designated cursor position
• Specify attribute parameters directly
— or
Request a numbered attribute

previously defined by a DEF command
(next page)
Example
att5(proNhi/blu),251
This example positions the cursor to row 2, column 1, and creates an attribute
that has protected input and is white on blue.
9-19
Screen Control
Define Command
DEF,n [,aar]
n Number which to identify the attribute (1-20)

attr Attribute(s) to define
Define a numbered attribute for

subsequent use in other screen
commands
• Once defined, use the numbered
attribute anywhere an attribute is
needed
Example
DEF,1 ,(PR,WHI/BLU)
This example defines attribute number one as having protected input and
colors of white on blue.
9-20
Screen Control
Field Command
FLD[,r,c,rsiz,csiz,o,attr,end-attr,text]
r,c Cursor position of the upper left corner of the

field.
rsiz Vertical field size in rows (lines). Default = 1.
csiz Horizontal field size in columns (characters).
Default = 1.
o Options. (see next page for complete list)
attr Attribute that defines the characteristics of the
field.
end-attr Attribute that terminates the field. This
parameter is not required.
Text Literal text to be inserted into the field. If T
option of SC run statement is used, 'text' in the
FLD command will be ignored.
9-21
Screen Control
Field Command Options
Border options
A Attributes. Outputs field attributes even if the
field is being boxed.
B Box. Draws a box around the field if the
terminal supports box drawing characters. The
box is drawn inside the perimeter of the field
reducing the effective size of the field by two
rows and columns.
F Frame. Frames the field with emphasis. This
option is terminal dependant.
S Sides. Draws lines on the left and right sides
using emphasis. This option is terminal
dependant.
T Top. Draws a line at the top of the field using
emphasis. This option is terminal dependant.
U Underline. Draws a line under the field using
emphasis. This option is terminal dependant.
Justification Options
C Center the text in the field.

L Left-justifies the text in a field.
R Right-justifies the text in a field.
Miscellaneous Options
E Empty. If the field is empty (no text), do not

display it. Use when you need to display status
fields that should only be displayed if relevant.
P Protect. Two conditions apply:
1.If a field is not defined with the PR parameter
and is empty when placed on the screen, protect
it from the user.
2. If a field is defined with the PR parameter,
allow data that is supplied in the SC run
statement via the statement T option.
9-22
Screen Control
Example
RCR to process
c
Line I Roll,* ittS: 'ii 68P8
.DATE ii. OCT 98 13:19:48 ID 68F 11 OCT 98 CRAIG
.TEST BY: Sam Cooke 12
se
@brk
cs;att, r;p94.6,18;"Nelcome to wiOt wonderland!"
fig...A.T...silnrfr quantity
I east enter your name"
s;,-0 "
tiohg input$ (qty)i6,<who)a18
• Menu is displayed, fields are filled
Welcome to wigit wonderland!

Please enter quantity
Please enter your name
Explanation
Two field commands were requested. The second field used a numbered
attribute which was defined by the DEF command.
9-23
Screen Control
Message Command
MSG,r,o,aftr,tmd
r Row (line) on which to display the message.

o Options:
Blank - Displays the message text as given.
B - Blink. Allows blink characters to be used on
non error messages.
E - Presents the text in system message format.
(centers the message text on the line and
translate the < and > characters to left and
right blink characters.
L - Left-justifies the message text.
R Right-justifies the message text.
C - Centers the message text on the line.
attr Attribute to be used on the message line.
(Default attribute = reverse video and white on
red colors)
text Literal text for the message (up to 79 characters).
N,
• Displays messages on the screen
9-24
Screen Control
Message Command Example

•'RCR to process
Line0. fiff Roll 68F8

.DATE 98 13:36:49 RID 68F OCT 98 CRAIG
8brk .
cs to.wiFit wonderland?"
c 3411,6 plus:orter quantity
fl
RcaW ,latieasi enter your name'"
dei ,1,(ts,ao,red/whi)
tic +1,1,19" 1
tab,'
Mak *c,-0 "
@sc-i
18 .
Swat 5
• Menu is displayed. Fields are filled in.
Welcome to wigit wonderland?

Please enter quantity
Please enter your name
• Message is displayed for five seconds

Please enter quantity 58
Please enter your name Bert
9-25
Screen Control
Prepare Screen for Painting
PREP[,attr]
attr Attribute to use in place of default.
Prepares the screen for painting an

input menu
PREP clears the screen and outputs
an attribute on row 2 column I.
Default attributes = (PR WHI/BLA)
Screen Control
Define Field Command
• Defines field characteristics for later

use by the AREA command
• Supplies all of the information
necessary to output a field
— Screen location and field size is supplied by
the AREA command
Define up to 40 named and 40

unnamed fields
Screen Control
Define Field Command
DFLD[,narneyoptyaftr,text]
name The name of the field to define

opt Options (listed below)
attr Attribute that defines the characters of the field.
text Literal text to be inserted into the field. Literal

text to be inserted into the field. If T option of
SC run statement is used, 'text' in the FLD
command will be ignored.
Border Options
F - Frame. Frames the field with emphasis.

S - Sides. Draws lines on the left and right sides using emphasis.
T - Top. Draws a line at the top of the field using emphasis.
U - Underline. Underlines the field using emphasis.
Justification Options
C - Centers the data in the field.

L Left-justifies the data in the field.
R - Right-justifies the data in the field.
V - Varies the size of the field to fit the text supplied.
E - Empty. If the field is empty (no text), do not display it.

P - Protect. Two condition:
1. If a field is not defined with the PR parameter and is empty when placed
on the screen, protect it from the user.
2. If a field is defined with the PR parameter, allow data that is supplied in
the SC statement via the statement T option.
9-29
Screen Control
Area Command
• • Lays out an entire region (area) of the

screen including both its text and fields
• Data defining contents of the area
begins in column I of the line
following the AREA command
• Field locations and sizes are indicated
by underline characters U
• AREA command recognizes reserved
words and literal delimiter in its data
• Only valid if screen commands are
being read from a report (SC format 2)
• Field characteristics Indicated with the
AREA command must be previously
defined with DFLD commands
• All field definitions are dis6arded after
the AREA command is processed
Screen Control
Area Command
AREA[,name,r,c,rsiz,csiz,opt,attr]
name Name of the area to define. Maximum of 12

characters. MAPPER system stores up to 10
names in memory. (for further information on
area names see Appendix C)
r,c Cursor position coordinates for the upper left

corner of the area.
rsiz Vertical area in rows (lines). Default = 1.
csiz Horizontal area size in columns (characters).
Default = 1.
opt Options. (listed below)
attr Attribute that defines the background characters
of the area.
Border options
A - Attnlutes. Displays the background attributes of the area even if the area
is being boxed.
B - Box. Draws a box within the outer edge of the area if the terminal
supports box drawing characters.
F - Frame. Frames the area with emphasis. This option is terminal dependent.
U - Underline. Underlines the area using emphasis. This option is terminal
dependant.
D - Delimiter. Marks fields with a field character only. Named fields are not
recognized. Allows you to place text immediately following a field.
9-31
Screen Control
DFLD and AREA Example
• RCR to process
Line0. 1 Roll). test 50F0

.DATE 11 OCT 98 14: r:44 RID 50P 11 OCT 90 CRAIG
test
11=4MOOMDMOMAMMOSS OM41. .. . 4.00.00,0040MOW OOM.04
BY: 40.041.
41W 004.M
F88''12
40 ..... IMOMMEOrnaW.Mmes....
0111WOOMOMOMOOMMOIPM00 0104W ..... MOOMWMOIMOM ........... 4WWOOOMNIO
brk sc -td''
ts (what)0,(who)ale
ithg inpu
• Menu is displayed. Fields are filled in.
Welcome to win t wonderland

14:02:57
Please enter the (want' t
Please enter your name •
Explanation
This example is basically the same as the previous - only this time DFLD and
AREA are used instead of FLD commands.
9-32
Screen Control
DFLD and AREA Commands
How field definitions work
If a named field is indicated in the area data, the characteristics of the field
come from the DFLD command specifying the same field name. A named
field definition may be referenced more than once.
The characteristics of unnamed fields in the area are supplied by DFLD
commands that specify no field name. The first unnamed field indicated in
the area uses the first unnamed definition; the second unnamed field uses the
second unnamed definition, and so on. If there are more unnamed fields
indicated than there are unnamed definitions, the last unnamed definition is
used to satisfy the remaining fields.
After the AREA command is performed, all field definitions are discarded.
9-33
Screen Control
Text Handling Commands
•• Place literal text to the screen

• Use to substitute characters
SOE[Ic J ,n]
• Places a start-of-entry (SOE) character at the current cursor position.

c special character used to redefine the SOE character.
- n = number of SOE's to display (default = 1).
LB[,c 1, ni
• Places a left blink character at the current cursor position. Default = 1.

c = special character used to represent the left blink character.
n = number of left blinks to display.
RB[,c ,n]
• Places a right blink character at the current cursor position. Default = 1.

- c = special character used to represent the right blink character.
— n = number of right blinks to display.
TIC[,c ,n]
Places a delimiter character at the current cursor position. Default = 1.

- c = redefined literal delimeter character .
— n = number of delimeter characters you wish to have at the current
cursor position.
9-34
Screen Control
Example
• 'RCR to process
Line Rolf, 68F0

.TEST BY: Saw Cooke F8 :'12
@brk 1
ccatt,prq li " Welcome to wigi, wonderland! "0113,
ease enter quantity'
111:2411;
Ettiti
,i no) .
ediwg!ase enter your name"
ria, 41,1,18„1
tab . a
RN( sc,-13 ” 1
chg input$ (qty}i6,(who)ale
lin i pts,154„Thankst .
Swat 5880 .
Menu is displayed

]Please enter quantity 58
lease enter your nape Oscar
Explanation
SOE, LB, and RB commands were added to the run. NOTE: the LB and RB
characters did appear on the screen, however could not be shown in this
screen example.
9-35
Screen Control
Methods for Handling Text
Example One
SC Format One / One Word Message
@SC " CS;PC,I2,29; < ERROR > ;HC .
This sends the message < ERROR > out to screen position 12,29....
You can also place single or double quotes around a message.
Example Two
SC Format One / String Message
@SC " CS;PC,12,29;TIC,$;$'11is is my string message.* .
In this example, you need to utilize the TIC command along with single quote
marks. The TIC command character ($), and the quote marks can be in any
order. Also: Using two sets of single quotes on each side of the message will
result in error. Using two $ signs on each side will only give you the first word
of the message.
Example Three
SC Format One / String Message (with embedded quotes)
@CHG V1A1 TIC$ .
@SC " CS;PC,12,29;TICA;IThis is my 'Vl'string'Vl' message.$'
This one is tricky! To put a message with embedded quotes out to the screen,
you must use quotes, the TIC command, and also a variable representing
C$. In this example, you will get 1 quote around the word 'string.' If you
want to get two quotes around the word (string), you would need to put
'VIVI' on each side of it.
9-36
Screen Control
Methods for Handling Text
Example Four
SC Format Two I One Word Message
PREP;PC,12,20; < ERROR >

@BRIC SC,-0 " .
This is putting < ERROR > out to the screen at position 12,20. You could
also place single quotes around the message.
Example Five
SC Format Two / String Message
PREP;PC,12,20;"Hi, how are you today?"

@BRK SC,-0 " .
Notice that with format two, you can send a string message to the screen
without using the TIC command. However, you can use the TIC command.
You would then have to use just one designated character on each side.
Example Six
SC Format Two / String Message (with embedded quotes)
PREP;TIC,$;PC,12,20;$Hi, how"s it going today?$

@BRK. SC,-0 " .
Notice that to put the message out this time, you don't need to use the
reserved word TIC$. You can simply use the TIC command and supply the
character on each side of the message. Then, place (in the message itself),
two quotes for each one that you want to go to the screen.
NOTE.• All of the examples cavy the same rules ifyou're using the stand alone
message technique, or using MSG or ED commands.
9-37
Screen Control
Emphasis Command
Emnp5p,....AN
p Emphasis pararaeter(s)
Blank -Turns off emphasis
C or I - Separates columns
U or - Underscores
(-) -Strike through
• Highlight or emphasize text on the

screen
• Place emphasis anywhere on the
screen
Examples:
emp,...; 'This text is underscored'

emp; 'This text has no emphasis'
9-39
Screen Control
Data Command
• DATALrArsiz,csiz pn,o]
r,c Cursor position at which to start displaying text.
rsiz Number of rows on the screen for the displayed

text.
csiz Number of columns on the screen for the

displayed text.
Page number (discussed in Appendix D).
0 W option. Interprets reserved words, and literal

delimiters in DATA text
Displays a number of lines of text data

starting at a specific screen position
Text data begins in column di of report
line immediately following the DATA
command
• Text is displayed exactly as it appears
— Spaces or commas within data do not terminate
the scan
9-40
Screen Control
Data Command Example
*RCR to process
/-
JAW,. 1 Roll0 6818
.DATE 11 OCT 98 14:32: ID 68F 11 OCT 96 CRAIG
•igi" ' • **
pc,6, 2,1; " icor* to wiglitneVriandi

-7711171
,
Pcnalb;SOLI:" Please enter quantity"
fid,i+1,1,61.,(tsi no)
pcLn,16;50E,1;" Please enter your name"
def,1,(ts,ao,red/whi)
fid, +1,1,113„1
+1,1,18„
tabiz
Uri( sc,-O "
@chg inPut$ (qty)i6,(who>ale
Ittistag,1.5,c„Thankst
Menu is displayed with DATA line. Fields are filled in.
'IOCTOBJNALL;1.4991t.:::::.

0 Please enter quantity 58
Please enter your name Bob
9-41
Screen Control
Screen Printing Commands
PRT
• Sends protected and unprotected data to the attached printing device.
• Sends all data from home position to current cursor position.
• Station number must exist in MAPPER configuration report.
PRF
• Sends unprotected data to attached printing device.
LF[,n]
• Places n line feed characters at the current cursor position.
• Default = 1.
• Use with PRT and PRF commands
FF
• Places a form feed character at the current cursor position.
• Use with PRT and PRF commands
Screen Control
Setup Commands
BEEP
• Causes terminal beeper to sound at once
• Used to signal user an error or other special condition has occurred
• After BEEP is executed, cursor is placed in home position
• Only one BEEP command allowed per SC statement
CP[ p]
• Alters the terminal setup (control page)
• CP command accesses the terminal setup and inserts the text strin
• See terminal documentation before using this command
END
• Stops the scan for screen commands
• Displays terminal output
9-43
Screen Control
FKEY Command
• FKEY,n,title,action
n Function key number (0 = transmit)
title Text to display on the function bar
action Action to take when the function key is pressed.
Action can be any valid command or run name
• Function key mapping command

• Map function keys 1-10 and transmit
key
• Specify an action to be performed
when user presses a function or
transmit key
• Allows designing and redesigning of
function bar
— Mapping is temporary
• Several other FKEY commands

available
— Use DSPHELP command to create context
sensitive help for menu displays
— Remaining commands covered in Appendix C
9-44
Screen Control
FKEY Example
• RR to process
LI NEO. FMTO MAO SHFTO HLD CHRS HLD 68F8
.TEST BY: Sam Cooke F 0812
8117.7e,
CS;
date?$
PCALI LB 3;' Welcome to wigit wonaerlana! ';RB,3
on.41.74.1 !URA Pleaca on anon
• Menu is displayed, press Fl
OCTOBER 11, 1999
Welcome to wigit wonderland?

► Please enter quantity"
). Please enter your name
2Exi t 7 9 10
• Games menu is displayed

TAB TO THE DESIRED PLAYGROUND AHD PRESS TRANSMIT.
HANGMAN 0 EIGHTMEN
FIUE-LETTER WORD GAME 1. TICTACTOE 0
RACE O. BLACEJACM 0
COFFEE BUY GAME 0. CHEMISTRY QUIZ 0
GUESS A NUMBER O. LUNARLANDER 0
TAME AWAY GAME 0) MASTERMIND 0
PAINT CHRISTMAS TREE BOMB THE SHIP M.
BATTLESHIP 0, 3-MONTH BIORHYTHMS 11
MASTERMIND-2 SOLITAIRE 0
CONCENTRATION 0 ONE-DAY BIORHYTHMS 0
ADVENTURE EXIT 0
9-45
Screen Contro
Context Sensitive Help
DSPHELP
• Displays context sensitive help for a

screen field
• Preceded the HELP identifier
Help text must be in the same report
as the FKEY command
HELP,f1d1...fid row
fid Field number for which the following
context-sensitive help refers
row Row (screen line) where help text should start
Identifies help text in screen command

reports
• Determines where context-sensitive
help should be placed on the screen
9-47
Screen Control
Context Sensitive Help Example
• RCR to process
Line 68F8
. DATE 98 14:54:36 RID 68F 11 OCT 98 CRAIG
.TEST BY: Sam Cooke F888812
ie
.
Ga' '-game
REV 1 ' Games A s
nay ' •
daten
mtillisioU,Ncome to wigit wonderland? ";RBI 3
Please enter quantity' ;fla„+1,1,6„(ts,no)
Im1+2,16;SOE,1;" Please enter your name'
def,1,(ts,ao,red/whi);f14,44,1,113„1;tab,1
004,
Lichg input$ {qty}i6,(who)a18
k, 1 2Paint 3 4Return 6Tasks ?View elfelp Mao inait
• Menu is displayed, press F8 with cursor in first field
*****K************************ OCTOBER 11, 1998

0 Please enter quantity"
O. Please enter your name
'Games 2Exit 3 5 aBe 18
9-48
Screen Control
Context Sensitive Help Example

• pontext help message is displayed
• Select F8 again with cursor in second field
OCTOBER 11, 1998

0. Please enter quantity
I► Please enter your name II
1Gaies 2Exit 6 8Helpft 9 18
• Second context help message is displayed
OCTOBER 11, 1998

Please enter quantity 78
OP Please enter your name,
1Gaies 2Exit 4 5 6 7 8HelpYu 9 18
9.49
Screen Control
Working With Forms
*. A form is a MAPPER report which

contains SC code
NOTE.• See Appendix C for complete information on working with forms
• The following is an example of how to access a form
• RCR
1
Line0. 1 Roll' - 59E196
.DATE 11 OCT 98 15:19:47 RID 38 MAY 98 CRAIG
.RUN FUNCTION DATA:
-- - _ - _ - ----- --_---_--- ------------ _ -- BY: CRAIG E.
•
•
Control is returned to the calling run when user transmits from menu
@command
@command
@etc.
..... END REPORT
Mint 3 4Return 5 flasks Mew Help 9llndo Mat
9-50
Screen Control
Working with Forms Example

• Receiving RCR (Form)
LineO 1 Roll0 - .:,...:.,..::::: 65E108

.DATE 11 OCT 98 18:52:56 RID :::. :.; 38 MAY 98 CRAIG
.0i RUN CODE TO BE ACCESSED-ET-THE TEST RUN BY: CRAIG X.
le
PRIP;PCI L141'IN PURSUIT OF TRIUIA'
PC, 6,1; uoGRAPHrinf 6L241SOE;FLD4101 11 1, 4 (TS,AI),(PR)
PC4LWENTERTAINNuivirC0,2430Emplu z6i i,IL (TSI AIM PR)
PC,Iu WHISTORT;PC,4240Enklea14„Cs,AI),(11 : )
:
PC,121VARTS AND LIEHATURVrciI lk2cSMU 1 121 261 11 1, 4y/S AI) (PR)
PC,14,1VSCIENCE AND NATURE' IN,i4,a;s0Ey0,15,z6,1,1„(TSLAI),(PR)
PC,16,WSPORTS AND LITERATU V;PC,16,24;s0Egui16,261,1„TS,), (P (PR)
PC,18,1VEXIT'nzlealSOLFLD,18426,14CIRIAI)PR)
i
PC,20,1VTAB To THE cHT GOHy OF YOuR COI CE AND PRESS XMIT';TAB,2
• Menu is displayed
IN PURSUIT OF TRIUIA
GEOGRAPHY 0
ENTERTAINMENT
HISTORY
ARTS AND LITERATURE 0,
SCIENCE AND NATURE 0
SPORTS AND LITERATURE 0
EXIT
TAB TO THE CATEGORY OF YOUR CHOICE AHD PRESS MIT
9-51
Screen Control
SCGEN Run
• • Creates or modifies screens for use in

a run
• User builds the screen on a
scratch-pad
• Screen can be viewed and changed
• Run generates MAPPER SC
commands
• Run accesses commands via the @SC
statement
• See Appendix D for more information
Screen Control
Exercise
1. Display a report with the DSP command. Alter the report on display by
experimenting with several 'cursor position' and 'screen edit' commands.
Use SC format one for this exercise.
2. Write a run that solicits user input. Utilize a combination of screen
commands to build the input screen. Screen commands and SC statement
will be contained in the same RCR. Use SC format two for this exercise.
3. Add a new RCR to the system (AR function). Copy only the screen
commands from the exercise number two to the new report. Delete the
screen commands from the original RCR. Use SC format two to call this
external form (report containing screen commands).
9-53
10
Importing
and
Exporting
Data
Module 10
Importing and Exporting Data
Objectives
Upon completion of this module you should be able to:
1. Transport MAPPER data to and from MAPPER and the OS 1100
environment.
2. Start a job on any MAPPER host system.
3. Start a MAPPER run from a file on any host system.
4. Identify the purpose of a MAPPER External file.
10-1
Overview
• Transport data between MAPPER environment and the host environment

• Speed up MAPPER - Less reports consprning space
1100 File Structure

• Two types of files supported on 1100
— Program files which contain elements
— SDF (System Data Format) files which contain raw data
• Naming convention for 1100 Program files
Qualffier*Filename(Cycle).ElementnameNersion
Qualifier Identifies a group of files
Filename Identifies specific filename
Cycle Identifies the cycle number of this file. Enter + 1

for a new cycle. (Optional)
Elementname Identifies element to be created or existing file
Version Identifies more specifically which element is to

be created (There can be several elements with
the same name) (Optional)
• Naming convention for SDF file

— Omits elementname and version because it is dealing with a file that is
continuous data:
Qualifier*Filename(Cycle).
10-3
ELT and RET P

• ELT function or @ELT run statement copies a report to a file or element
on the OS 1100 (only) operating system
• RET P function or @RET run statement retrieves data from the OS 1100
operating system to the MAPPER environment
— Report is brought back into MAPPER as a result
Must be duplicated or replaced into a permanent report
Mapper 1100
Elt
Ret P
10-4
ELT
• Enter 'ELT' on line 0
ELT
Create File or Element
lifier nip name Cycle Element Uersion
MAPPER format?
Include headings?
Character set
Shared Directory?
Report
$INCL$ access: Cabinet Password
Cabinet Password
Cabinet Password
Cabinet Password
Menu Selections
Qualifier, File name, Element and/or file name to copy to the 1100
Cycle, Element, system
Version
MAPPER format? Enter 'Y' to create the file in MAPPER format
Include headings? Enter 'Y' to include MAPPER headings in the
copied file
Character set Enter character set choice. Press F8 (Help) to
receive choices
Shared Directory? Is this file in a shared directory? Leave blank for
system default
Report Number, drawer, and optional cabinet identifier
of report to be copied
@ELT,c,d,r[,lab] qual,fn[,cyc,elt,ver,mf?,hdg?,charsetnewcycn . All fields

of the run statement are the same as the menu prompts except:
lab Label to go to upon error
newcyc? Enter 'Y' to create a new cycle ( + 1) for the file
10-5
MAPPER Format or Not?
MAPPER format
• Retains control word at end of each line
• Translate line zero into control characters
• Translate tabs (usually left brackets in fieldata)
• Translate carriage returns (usually right brackets in fieldata)
• Insert internal line numbering at beginning of each line
• Send END REPORT line
• Forms a box around data
• Translated control characters form our control words
One control word = Line numbers
- One control word = Carriage returns
- One control word = Control characters necessary to system. 'This
word is transparent to us
Not MAPPER format:

• Strips all control characters; leave just data
• Line Zero and END REPORT not sent
• Translates tabs to spaces (default)
ASCII report copied to 1100 in MAPPER format

• Coded in same manner as fieldata reports
• Exception
Four control characters precede each line vs. six in fieldata
Copying ASCII report not in MAPPER format

• Strips tabs, carriage returns, internal line numbers, line zero and END
REPORT
10-6
MAPPER Format or Not?
• Report exported in MAPPER format shown on top and not MAPPER

format on bottom
000.00Clasis @@@@@@@]]@@=@IK@@@@[ @@@@@]@ • • •nn

®6054( . Date 07 Sep 84 17:09:25 Rid 36B 07 Sep 84 ...]]]P:
0400@@] • Corporate Status Report B0202
@@@@@#* St Status By Product Serial Produc Order Cust Produc :: •Till
000000 ''' *Cd Date in Type Number Cost Number Code Plan • • •11]]
f)@@)@@ *=:::::,==============—.---...--=--=---.—=....—..—...—== •• • Mi
40@@@@AE ip [881224 [ Ls [ Blackboxl 1 436767 [ [ 84389 E amco I 881223 .. j]]]
@@@@@B[ ip [881219 [ Ls [ Blackbort [ 436768 1 [ 84390 E amco [ 881223 ...nil
flage@CI Ip [881225 [ Ls i Blackbox2 [ 637071 1 [ 84353 I Intr [ 881218 _]]B
@@@@@D[ Or [870110 [ Ls I Blackbox4 [ 1 [ 94754 [ arco [ • • •111]
Date 07 Sep 84 17:09:25

Rid 36B 07 Sep 84
Corporate Status Report 60202
* St Status By Product Serial Produc Order Cust Produc
*Cd Date in Type Number Cost Number Code Plan
•sus- = •••• = = 4.11. MO. 11.6 4•111, .1.10 .11111. .00 .10 = =
ip 881224 Ls Blackboxl 436767 84389 amco 881223

ip 881219 La Blacicbox1 436768 84390 amco 881223
ip 881225 Ls Blackbox2 637071 84353 intr 881218
Or 870110 Ls Blackbox4 94754 arco
10-7
Data Control Commands
• Compaands which permit manipulation of MAPPER data before it is

exported
• Place each command at the appropriate point in the report
• They take effect from that point on but are not included in the output
Command Action
Include asterisk type lines

$DCML$ Do not include asterisk type lines
SIF'FL$ Include period type lines

$DFFL$ Do not include period type lines
$INCL$ Dnnnn Rn Include MAPPER data where Dnnnn is the

numeric drawer designator and Rn is the report
number
$TABC$ nn (1100 Translate tabs to fieldata character with a

only) numeric code of nn
STABAS 'y' Translate tabs to ASCII character 'y'
STRANS x,nn (1100 Translate fieldata character x to the character

only) represented by numeric code yy
STRNAS x,'y' Translate ASCII characters x to 'y'
$DATA$ Stop data translation

$CLRTS Stop data and tab translation
1043
Data Contro Commands

• Report to be copied
Line,' I Rol Din 9G0

.DATE 8,5 NOV 98 14:35:46 RID 9G 95 NO 98 CCM
.SINCL$ Exaptple
*S t S tatus By . Product . Seri al.Produc.Oraer.Cust.Produc.
*Ca. Date .In. Type .Nuiber. Cost .Numbr.Code. Plan .
- - --1 — 1 -- -------. ------WWWWWW WWWWW WWWW - ----
IP 831224 LS BLACXBOXI. 436767 84389 AMCO 831223

—1,2,431225-LS-BLACXBOX1 436768 84398 AMCO 831223
-1?-831119-11-31ACKBOX2 637871 84353 INTR 831218
END REPORT .....
• Report included via $INCL$ data control command
/-
Line0. 1 Roll0 - 19G8
.DATE 85 NOU 98 14:19:22 RID 85 NOV 98 CCM
.Included Report
*St.Status..
By Product .Serial.Produc.Order.Cust.Produc.
*Cd. Date .In. ----
Type .Number. Cost .. Numbr.Code. Plan .
OR 848110 LS BLACON4 94754 ARCO
SC 848110 LS BLACON5 675281 97441 FEDS 842131
END REPORT
Exported and re-imported report result
Line'. 1 Roll -
.DATE 05 NOU 98 14:40:12 RID
MN= Example
*St.Statusilly. Product .Serial.
Ka. Date .In. Type .Number.
41=
AMCO 831223
03122.3
10-9
importing and Exporting Data
RET P
• Retrieve file or element exported to the OS 1100 environment
• Enter 'RET P' on line 0
RET P
Retrieve Program File Element
if ier name Cycle Element Version
Start line
Locate string
Number of lines
MAPPER format?
Include headings?
Shared Directory?
Drawer
Menu Selections
Qualifier, File name, Element and/or file name to retrieve from the
Cycle, Element, 1100 system
Version
Start line Line number from which to start retrieval or
start search for 'Locate string'. Default = First
line
Locate string Locate this string and start retrieval at that line.
12 character maximum.
Number of lines Number of lines to retrieve. Use for greater
efficiency with larger (over 500 lines) files.
MAPPER format? Enter 'Y' to retrieve a file in MAPPER format
Include headings? Enter 'Y' to add headings from report 0 of the
receiving drawer
Shared Directory? Is this file in a shared directory? Leave blank for
system default.
Drawer Receiving drawer for result
@RET,c,d[,lab] [qual],fa[,cyc,elt,ver,mf?,hdg?,1,1ocstr,q] . All fields of the

run statement are the same as the menu fields
10-10
Efficiency Hints
• Retrieve function
— Assigns area in MAPERO large enough for 500 lines
— Retrieves data until area is full
— Retrieving Large Files (500 + lines)
O Allocates another 5000 lines
O Retrieved data copied to 5000 lines
O Continues adding at 5000 lines until all data retrieved
— Specify number of lines to retrieve

O Assigns area large enough for entire result
• Reduces internal copying of data
— Recommendation for retrieving large amounts of data that will be
split into many reports
O Use the RDC statement which will break data into multiple
reports in one pass of result
Mapper 1100
MaperO Program File
\z/lines
77 lines
10-11
FILE
• Copies a report to any host environment (1100, U series, A Series, PC)

• Creates new file or overwrites existing file
• Create file with headings to retain report number and date report was last
updated when retrieved
• File created in non-MAPPER format will have tabs translated to spaces
• Enter data control commands in the report to control the format of the
output. Enter 'FILE' on line 0 and receive Create File menu.
FILE
Create File
File name
MAPPER format?
Include headings?
Character set
Report
SINUS access: Cabinet Password
Cabinet Password
Cabinet Password
Cabinet Password
Menu Selections
File name Syntactically appropriate file name for the
operating system to which the file is being copied
MAPPER Format? Enter 'Y' to copy report in MAPPER format
Include headings? Enter 'Y' to include headings in copied report
Character set Enter character set desired
Report Enter number, drawer, and cabinet of report to
be copied
SINCL$ access If a SINCL$ data control command is included in
the copied report, enter any cabinet number and
password referenced by this command if outside
your current cabinet
@FIL,c,d,r[,mf?,hdg?,lab) fn All fields are the same as on the menu
10-12
RET
• Retrieve file or element exported on any host environment
• Reports exported via FILE in one format should be retrieved in same
format
• Enter 'RET' on line 0 to receive Retrieve File menu
Menu Selections
File name File name to retrieve from the host operating
system
Start line Line number from which to start retrieval or
start search for 'Locate string'. Default = First
line
Locate string Locate this string and start retrieval at that line.
12 character maximum.
•
Number of lines Number of Imes to retrieve. Use for greater
efficiency with larger (over 500 lines) files.
MAPPER format? Enter 'Y' to retrieve a file in MAPPER format
Include headings? Enter 'Y' to add headings from report 0 of the
receiving drawer
Drawer Receiving drawer for result
@RET,c,d[,lab] [qual],fa[,cyc,elt,ver,ruf?,hdg?,1,ststr,q1 . All fields are the

same as on the menu
10-13
Batch Start and Batch Port

• Batch Start
— Starts job on any host environment via a MAPPER report
— 1100 Executive Control Statements (ECL) statements will be used in
examples
O Cormands to the 1100 operating system
O Begin with an @ sign.
O MAPPER report is exported to the 1100 environment via START
function or @STR run statement and processed as a batch run
• Batch Port
- BPRUN$ command
O Starts a MAPPER run and optionally retrieves data from the host
to MAPPER through the batch port
O BPRUN$ command and data to be sent are placed in host system
file (1100 data file will be used in the examples)
O @SYM ECL statement (on the 1100) used to begin process of
sending data file to MAPPER
Mapper OS 1100
10-14
Starting a Job
• Enter 'START' on line zero and receive prompt menu
• Following activities performed when runstream. is STARTed
— MAPPER signs on to a Batch Port
— MAPPER creates result from report containing job commands
— Report placed on queue in 1100 for execution
• Report containing 1100 ECL runstream to be executed

(Line0. 1 Roll0 - 185A
DATE 13 NOU 98 12:17:86 RID 185A 13 NOB 913 CCM
.bstart By: 8901
@run ccm,eatc85,ccm
librkpt print$,print.
@prt,i
ilbrkpt printS
Lasmu print.„pr9389
@fin
END REPORT
• Enter 'START on line 0 to receive the Start Batch Run menu

START
Start Batch Run
Report
Run-id
Account
SIN= access: Cabinet Password
Cabinet Password
Cabinet Password
Cabinet Password
Menu Selections
Report Report containing job commands to be executed
in the host environment
Run-id Enter run-id to replace run-id on @RUN
statement (optional)
Account Enter account number to replace the one on the
@RUN statement (optional
• @STR,c,d,r{,run-id,acct} .Run statement equivalent
10-15
Including MAPPER Data in a Job

Line I - 186A
.DATE 13 NOU 98 12:15:39 RID 186A 13 NOU 98 CCM
.Including MAPPER data in an ecl runstream EY: ABB8281
41:
@run ccm,eata5,ccm
libk1
flacoh,s f.s,f.r
LiMa ,s ,f.a
in i.r
end
ext
@fin
END REPORT
Example Explanation
• ECL runstream must begin with @RUN statement and end with a @FIN
• @RUN identifies run-id, account number to be charged, and project-id of
user
• @ACOB does a COBOL compile of the symbolic element S in the file F
and produces a relocatable element named R in F
• @MAP collects R with system relocatables to produce an absolute
element named A in F
• @XQT executes the absolute element A
• $INCL$ specifies report 6B of cabinet 0 as the data to be used by the
executing element
• @EOF signifies the end of data being supplied to the executing element
• @FIN finishes the ECL runstream
Advantages to updating MAPPER database outside of MAPPER

• Processing is not directly MAPPER resident. Cuts down on usage of
MAPPER disk space, logging and purge overhead, and I/O volume to
load data
• More efficient disk utilization is achieved if MAPPER data is archived on
the host environment
Disadvantage
• Job is executed at a lower priority which means slower processing and loss
of interaction
10-17
Batch Port Data Retrieval
• Another method of retrieving data from the host environment to

MAPPER
• BPRUN$ and ENDRD$ commands are placed in a file on the host

environment
• BPRUN$ command signifies the start of data to be retrieved and the

MAPPER run to be started after data is retrieved
• Both commands placed in column one of the file
• ENDRD$, the end of the file, or the next BPRUN$ command signifies
the end of the data to be sent by the previous BPRUN$ command
• Multiple BPRUN$ commands may be placed in a file
• Data, MAPPER run statements, or data control commands ($INCL$,

etc.) may be placed between the two commands
• Send the file containing the commands to MAPPER via the appropriate
host command. @SYM ECL statement for the 1100, 'mapper' command
for the U Series and the 'run' command for the A Series. Check the
MAPPER Manual Functions Reference in the START manual function
area for further information.
• 1100 environment will be used in the example
10-18
Batch Port Data Retrieval Setup

• MAPPER must be configured as a symbiont (printer) in the configuration
report
• Auto Parameters
— Found in IILDMAP.MAPPER/PARAMETERS on the 1100
— BPORT must equal one to enable the batch port
— SYMNAM must match the MAPPER symbiont configuration name
• BPRUN$ syntax
BPRUN$[,cont] run[,data] user,dept,pw [c,cpw,d,f,ltyp,isp? BPERR,edata] .
cont Continuation character for the command itself.

Use any character that does not appear in the
command
Name of the MAPPER run to start after data is
retrieved
data Extra data passed to MAPPER picked up by
INPUT$. Separate multiple items with commas
and do not include spaces.
user,dept,pw MAPPER userid, department, and password
under which to start the run and receive the data
result
c,cpw,d,f Cabinet, cabinet password, drawer and format to
receive the result. Default = A.
ltyp Enter 'Y' to have spaces converted to tabs where
tabs are defined in the edit code line in report 0
lsp? Enter 'Y' to retain blank lines in the file.
Default = N.
BPERR Name of the run to execute upon error
edata Data passed to the BPERR run and picked up by
INPUTS
• Run must be written to handle the retrieved result
10-19
BPRUN$ Example
Example Explanation
• Data is sent back to MAPPER from 1100
• @ASG creates and assigns a data file named JLD
• @ED,I is a line editor used to create the lines within the file JLD
• BPRUN$ indicates to 1100 that batch porting of data is to occur
- CRUN is the MAPPER run to start after data retrieval is complete
- ILD,1 is the MAPPER userid and department under which the result
will be created and the run started
0,0pen,A is the cabinet, cabinet password, and drawer to capture the
result created from the data retrieved
• CRUN contains
— @REP to replace the retrieved result into a permanent report
• ENDRD$ signifies the end of significant data to be sent by the previous
BPRUN$ command
• @FREE frees the file JLD so that it may be sent to MAPPER via the
@SYM statement
• MAPPER is configured as a printer named MAPPER and the auto
parameter SYMNAM also contains this name
• @SYM sends the file JLD to the destination symbiont called MAPPER
Note: To import large files, it is more efficient to fragment file with multiple
BPRUNVENDRD$ statements to limit number of lines to be imported at
one time,
1 0-20
BPRUN$ Example
Mapper 1100
@Asg,up JLD.
@Ed,l JLD.
11:> BPRUN$ Crun JLD,1 0,Open,A
21:› *====sr.r...=======r...=
31:> These lines of data will be passed to
41:> Mapper as a current result. This data
51:> could be Mapper data previously exported
*===—===== 61:> or output of a program executed on the 1100
@Rep,0,1 9,A 71:> ENDRDS
81:> This data will not be sent to Mapper because
91:> It follows endrd
01:> @Edit Exi
End Editor
@Free JLD.
@Sym,u JLD,Mapper
19A
* =
These lines of data will
be passed to Mapper as
a current result. This data
could be Mapper data
previously exported or
output of a program
executed on the 1 100
10-21
Batch Port Efficiency Hints
• There are 32 batch ports on MAPPER

• Each batch port processes one job at a time
• When using a batch port, the port is tied up until the job is complete
• Passing large volumes of data during high use time periods should be
avoided
• Batch port is activated through use of a BPRUN$ image
— Remains active until the run has completed
• In order to free the batch port as soon as possible
— Port should pass data to the run in the form of variables
— Run should send a message before it terminates
Rule of Thumb:
• Use the RET function to bring data into MAPPER vs. batch port
- RET reads large buffers
— Batch port reads only one line at a time
• Retrieve function may import data ten to twenty times faster than data
imported through batch port
10-22
External Files
• EXFFILE Auto Parameter
• Not written to Recovery Tape
• Reduces I/0s
• Impractical where data must frequently be accessed and updated
• Intended to store archival or read only data apart from MAPPER's
database files to save space
• Operator keyin necessary to load file
If not loaded user who tries to access report will receive message that
report or form type doesn't exist
— If loaded the Rid and Type tables are updated and updates can be
performed to reports in file
• Updates reside in MAPERO
• Requires a special purge
— Not performed
• All External File updates lost
Purged
• Merged with reports
— File is freed and deleted from MAPPER
— No longer recognized by MAPPER as a MAPPER file
• File would have to be loaded again to be accessed
• Storing data in External Files is more efficient than keeping it in
MAPPER
10-23
Exercise
WR UTi EN:
1. Suppose a large number of reports were to be sorted and a Cobol
program on the 1100 would perform the sort. Describe the steps taken to
accomplish this goal.
LAB:
1. Use the FILE function to export a report from the demonstration
database in MAPPER format from MAPPER to the 1100. Repeat the
process, exporting the report not in MAPPER format. Also, try changing
the character set of the exported report.
2. Use the RET function to import the exported report back into MAPPER.
Again, use the various retrieval possibilities, such as MAPPER format vs.
not MAPPER format, etc. Note the effect each combination has on
retrieved data, based on how the data was originally exported to the 1100.
10-25
11
Data
Organization
and Index
Schemes
Module 11
Data Organization and Index Schemes
•
Objectives
1. Recognize and apply various data indexing schemes.

Binary Find Reviewed
• Finds first occurrence of a character

string in a large report result, range of
reports, or an entire drawer
• More efficient than a Search or Find
function when processing reports of
400 lines or greater
• Assumes data is sorted in ascending
order
Optionally builds an index for greater
efficiency
Opens report for data insertion on
no-find situations
Binary Find Reviewed
Line 1
REPORT
Line 500
TARGET = 625
Line 1000
Line 500
Line 750
Line 1000
TARGET = 625
11-3
Binary Find Index Report
• Used to accelerate the find process

• Only efficient when searching a range
of reports
• Built by utilizing B option
— Result is generated
— Use REP to make permanent
• Report preceding range must be

available
— Used as index
— Contains first data line from each report in
range
• Use I option to utilize index report

Binary Find Index Report
Index Data
Report Report
Data
Report
Data
Report
11-5
Data Organization and index Schemes
Binary Find Indexing
Scenario
A run designer is responsible for designing and maintaining an application

which contains a data set of thousands of records. The primary concern of the
designer is to be able to quickly find a specific serial number. The designer is
also restricted to using reports of 500 lines or less.
Solution
• Sort the entire data set by Serial Number

• Spread data over several consecutive reports
• Create index report by using Binary Find options
• Perform Binary Finds on index report to actually 'find' specific serial
numbers
• Index will expedite find process
11-6
Binary Find Indexing Example

• Data set to process
8000002
• ~s~s•
100000
100001
100002
.DATE 10 JUL 90 12:2620 RID 728 20 FEB 90 ACAS

.0991231 Production Status Report Cotpotal4 Production 8000002
:.SERIAL.
::.NUMBER .
100495
100496
100497
DATE 10 JUL 90 1226:20 RID 738 26 FEB 90 ACAS

.6991231ProductIon Status Report Corporate Production 8000002
'
.NUMBEII
111111.1111111111.11,11.
100990
100991
100992
101484
111
11-7
Using an Index
• RCR to process
• First Binary Find will create an index result in 70B for reports 71-80
• Replace 70B with index result
Lined . ROD 4GEB
.DATE 98 14:87:4
7 RID 48E 30 AUG 96 CRAIG
.TEST1 BY: T.E. STING EN 10
@BFNAB„, A >I2,(LINE)I3 .
YOUR SERIAL NUMBER (192487) WAS FOUND.
IT EXISTS IN REPORT (REPORT> ON LIE (LINE>.
@BRX OUT,-0,3,4
@GTO END .
029 . 'NO FIND' ROUTINE HERE - COUERED IN NEXT EXAMPLE...-.

010 .
THERE IS A PROBLEM WITH YOUR BFN STATEMENT. CONTACT THE RUN DESIGNER
@BRX DSP,-8
\ @GTO END .
• Index report
.88495
X8998
181485
10089
182475
182978
183465
163968
184455
..... END REPORT
11-8
Using an Index
• Second Binary Find searches index report for serial number 102487
(
LineO testa Ro1l0 48E8
.DATE 14 SEP 98 14:87:47 RID 46E 38 AUG 98 CRAIG
.TEST1 BY: T.E. STING 18
ie
@BFH,O,B, 18 BR?1-88 2-2 'SERIAL'

IT EXISTS IN REPORT (REPORT) ON LINE (LINE).
@BRE 0117,-8,3,4 .
@GTO END
@26 . 'NO FIND' ROUTINE HERE - COUERED IN NEXT EXAMPLE.......

@18
THERE IS A PROBLEM WITH YOUR BFN STATEMENT. CONTACT THE RUN DESIGNER
@BRE DSP,-6 .
@GTO END .
• Output result verifies item location

IT EXISTS IN REPORT 76 s,, ON LINE 18.
• Report 76B - line 18
e b $:
SC 8401 LS BLACXBOX? 102488 9? 41 FEDS '40122
IP 83122? LS BLACXBOXI 182489 84351 AMCO 831227 831227
SC 848110 LS BLACXBOXI 182491 97441 FEDS 842131
IP 831224 LS BLACXBOXB 182492 84389 AMCO 831223 831224
SC 848118 LS BLACXBOXI 182495 97441 FEDS 840131
IP 831224 LS KAMM 102497 84389 AMCO 831223 831224
*: ' • " • o:... .4
el
$
11-9
Using Index to Insert Data
Scenario
The record containing serial number 103000 was taken out of production
because of an engineering problem. The problem was resolved and the
designer now needs to place the record back into the data set. What would be
the fastest and easiest way to find the appropriate place for entry?
Suggested Solution
• Perform a Binary Find on index report

• Use serial number 'to add' as find target
• A find will not be made
— Verify the 'no-find' situation by checking the contents of STAT1$
STAT1$ should be equal to I
• A report will be 'opened' at the place where the entry should exist
• Capture line and report numbers into variables
— Line number will be the line preceding where new entry will go
• Record containing new serial number can then be easily added
11-10
Using Index to insert Data
• RCR to process
I-
LINES tifr RLQ SHFT0 HLD CHM,. HLD LN0 UNDO 48E8 0
.DATE 98 88:34:24 RID 48E 14 SEP 98 CRAIG
.TEST1 BY: T.S. STING E88 18
ift
isliFNAB„,211 178 'SERIAL' LIMON <REPORT)I2,(LIMI3 .
6120:IF STAT1$ NE 1 GTO 99 ; MAKE SURE THAT THIS IS A NO-FIND SITUATION!
@LOH,O,B,(REPORT)
@LN+,8J BISREPORD,ILIND,1 .
@INC <On)
@WRL,_ {REPORT M LINE) 2-2,5-6,12-2,15-9,'SERIAL1 ,39-5,45-4 LIP,831224,\
B m
8,_„„
LS ELAciX1,183eN,84389,AMO .
@ULX
@DSP01,13,<REPORT),(LINE),„,/ HIT Fl TO CONTINUE WITH THE RUM' .
EiGTO END
L199
ALTERNATE
ERROR
ROUTINE............
• Report searched is displayed with new entry

;
tie f . t1", i
8312Z4 L SLRCIUJOXI AMU 1/43e9 WV 223 831224
IP 831224 LS BLACKBOXI 183882 84389 AMCO 831223 831224
IF 831225 LS BLACXBOX1 183884 84398 AMCO 831223 831225
OR 848118 LS BLACKBOX4 183086 94754 ARCO
SC 848118 LS BLACKBOX5 18388? 97441 FEDS 848131
IP 831222 LS BLACHBOX5 183888 84848 AMCO 831222 831222
SH 831283 LS BLACRBOX6 183889 54237 FEDS 831201 831282 831263 58738
SH 831282 LS BLACXBOX6 123010 54438 FEDS 831281 831261 831282 S6937
SH 831289 LS BLACXBOX6 183811 54232 DICO 831207 8312r: 831289 S8538
SH 831283 LS BLACXBOX6 183812 52833 ARCO 831281 831282 831283 S8934
IF 831216 LS BLACXBOX6 163613 89381 INTR 831215 831216
OR 831218 LS BLACXBOX7 193014 99842 FEDS
AD 411091 Le DT.itrifikAV7 112101‘ 4Q/OR TWTV
Explanation:
• BFN statement looks for serial number 103000 in index report

• If find is not made, report and line number where find should have been
made are captured into variable
• IF statement verifies no-find situation by checking contents of STAT1$
• Record is then written to report at appropriate location
Multiple Access Paths
Scenario
A police department in Texas has the need to work with thousands of items
spread over many reports. A run designer needs to provide users fast access
to the data. They also need the capability of several sorted keys so they can:
• Trace the owner of an abandoned car whose plates had been stripped -
Vehicle ID number as key
• List all 17 year old drivers to generate a memo reminding them of the
new photo license law - Driver's license number as key
• Trace the cause of hit and run accident based on the knowledge of a
license plate number - License plate number as key
Solution
Choose unique fields to provide alternate access paths to the same set of data.
Each new key will have its own Binary Find Index which in turn points to the
Main Index Report based on case number.
Math Index will point to actual data reports which weregrouped and sorted
by case number.
Disadvantage
Duplication of data is necessary which uses a large quantity of mass storage

space.
In this case, the police were more concerned with access speed to the database
rather than mass storage utilization.
1112
Data Organization and index Schemes
Multiple Access Paths
Binary Find indices Data

Report
Drivers Case
License
Main index
Report Data
Report
Dr!Vers Case
Name Sorted on
Case
Data
Report
License Case
Plate
Data
Report
Vehicle Case
Number
Data
Report
11-13
Direct Access Indexing
• Method of breaking data down into

meaningful parts
• These parts can point to a particular
report and a specific line in the report.
Scenario Number One
A designer has the task of organizing and maintaining an 'on-line' phone

directory. Users must be able to quickly find a particular item - either
manually or with a run.
Solution
Use the telephone number to index the data.

The first three digits (prefix) represent the report number and the last four
digits (exchange) represent the line number in the report.
Trade-off
Large reports are required to provides direct access to the data.

• 999 Reports per drawer and 9999 lines per Report are needed
11-14
Telephone Application
Telephone Number = 275-1938
11-15
Direct Access Indexing
Scenario Number two
Quite often users and run designers are required to keep report sizes to 500
lines or less. Remember: MAPPER processes smaller reports much faster
than large reports. In this scenario, a run designer is working with thousands
of serial number items. How does the designer efficiently access this large
data set and yet comply with report size restrictions?
Solution
• Use a 'modified' direct access scheme

• Scheme will utilize an algorithm based on a 5 digit serial number to
determine the report number of the data.
ALGORITHM: (Serial Number / 500) + 1 = Report Number
• Report numbers can be integers only

• When the division occurs, the remainder is dropped and 1 is added
Disadvantage
More mass storage space is necessary.
11-16
Inventory Application
If a tool with serial # = 00001
.002 + 1
500 5636-7-
1.00
it resides in Report 1
If a tool with serial # = 99999
199 + 1 — 200
500 99999
it resides in Report 200
11-17
Number Generator
@HSH v=vld,min-max
or
@LDV,N v=vid,min-max
v Variable to receive the hash value.
vld Data to which the system assigns a hash number.

Data can be a variable, constant, reserved word,
literal, or any combination.
min-max Range within which the system assigns a hash

number. Min = the lowest number in the range.
Max = the highest number in the range.
Tool for even data distribution

Also use to process evenly distributed
data
Produce a random number within a
specified range for a data item
If specified range remains the same,
data item always receives same
number
11-18
Random Number Generating
Scenario
A run designer has the need to write a data entry routine involving many
items. In this scenario, the designer's primary concern is to have all entries
evenly distributed across 3 consecutive reports. How does the designer
randomly distribute the data and then access the data without knowing in
what report each will be placed?
Solution
Use @HSH to randomly generate a report for each entry item.

• Specify report range in the @HSH statement.
Use an @WRL routine to place each entry in a report.
The same item always produces the same number
• Run designer doesn't need to know the location.
Tradeoffs
Report range must stay the same

Manual searches are difficult to perform
• Data has no sensible order
11-19

• RCR to process
Lined 40E8
.DATE 98 14:56:23 RID 48E 14 SEP 98 CRAIG
JESTI ..... _ . . . ----------__ BY: H.A. SHERS E880010
13:BRE LDUA (SODH1.7400 t
ADD NEW DATA iSODE
FIND OLD DATA (SOEX
IBM OUTA-L2A2,111,V,N
@LDUA (NOWIAUSQvus .
SICK INPUTS (MAMMA
CISH (REPORTM3=(NAND,163-165 .
(SOEU>
1981:14X,8AAREPORT) 110L0101(REPORT)1,3,1
84418,AMEroRTIA 2-18 Li mn) GTO 3 .
02:17O,O,ALOYOR014,19 ' 2-6 t, {NAME} ,(LINE)I4 .
USPAAMLITRT),(LINE),4
@GTO
@99 .
DATANOT FOUND...........
@BRE OUT,-11,2,1,1,1,YA
@GTO 3
END REPORT .....
• Add new data - 'Richards'
ADD NEW DATA O. iricharis

FIND OLD DATA
• 164A is randomly selected to receive 'Richards'
Line0. 1 Roll - 164A

.DATE 14 SEP 98 14:59:16 RID 11 SEP 90 CRAIG
.MAPPER FREE FORM: BY. A880081
11-20

• Menu is displayed a second time
• Find new data - 'Anderson'
ADD NEN DATA O.

FIND OLD DATA
165A is randomly selected to receive 'Anderson'
Linelo. 1 Ro110. — 165A

.DATE 14 SEP 98 15:28:19 RID 11 SEP 98 CRAIG
SNAPPER FREE FORM: ri: A828281
•.•.
• Find old data - 'Richards'
ADD NEN DATA O.

FIND OLD DATA
• Report containing 'Richards' is displayed
Linpi. 4 Ro11F 164A

END REPORT .....
11-21
Parallel Drawers
• Data organization method used when

a record requires more character
space than is available
Several drawers are utilized
Scenario
A run designer has the need to design reports which exceed 256 characters in
width.
Solution
Orgathze the data into 'parallel drawers'

The line number for a record in the first report corresponds to the line
number in each of the consecutive drawers
Method applicable for manual users as well as run designers
• Manual users can cut and paste portions of each report by using Reformat
or Match
Tradeoff
Difficult run maintenance is traded off for width capabilities.
1 1 -22
Parallel Drawers
lb 1c ld
* 11,111.1 MIND ONO MI= MOO OWN MOND
Record A Record A Record A

Record B Record B Record B
Record C Record C Record C
1 1 -23
Multiple Line Types
• Data organization method used when

a record requires more character
space than is available
• Only one report is utilized
ip 871224 Is blackboxl 200000

A boxed denver
B 111 billed
sc 870310 Is greenbox8 999999
A envel Chicago
B 222 credit
ip 880918 is blackbox2 200006
A boxed trenton
B 333 paid
ip 881010 Is blackbox5 222888
A boxed yonkers
B 444 credit
1 1 -24
Exercise
1. Discuss the advantages and disadvantages of each of the following data

indexing schemes, and provide an example of an appropriate application
for each.
a. Binary Find Index
b. Direct Access
c. Random Number generation
d. Parallel Types
e. Multiple line types within a report
1 1 -25
A
Run Debug
1100
Run Debug 1100 Review
Appendix A
Run Debug 1100
Objectives
Upon completion of this module, you will be able to:
1. Monitor the activity of a run with RDB.

2. Utilize RDB to assist in locating and correcting run errors by:
a. Displaying the contents of reserved words, variables, and results.
b. Inserting and processing temporary run statements with RDB.
3. Utilize RDB interactively as well as a run statement.
A-1
Run Debug - RDB Run
• Interactive tool used for analyzing a

run
• RCR code displayed before it is
processed
• RDB allows you to:
— Display or change the value of any variable
— Display the value of a reserved word
— Display intermediate results
— Correct syntax errors in statements
— Correct errors in run design logic
— Correct typographical errors
• May be used interactively

— Enter 'RDB Runname' on line zero
— Run code is processed starting at line three of
RCR
• May also be used as a run statement

— Enter @RDB into your RCR via SOE update
— Code analysis begins at the point where @RDB
is read.
• in order to use RDB:

— User must be registered for RDB function
— User must have update control of the RCR
A-2
Run Debug Screen
RDBP►
1MTEST REPORT:7EG
3 it-
RDB Screen consists of four lines
Line 1 Run Debug prompt line. RDB commands are

entered on this line.
Line 2 Run Debug status line. Run name, report
number, drawer letter, and cabinet number
displayed.
Line 3 Blank line.
Line 4 Line in RCR. to be executed.
A-3
Run Debug Functions
• Help
• Exit
• Throttle
• Display
• Breakpoint
• Monitor
Execute
• Error
Function Definitions:
Function Command Definition
Help Display the summary of RDB

commands (Fl resumes RDB)
Exit Exit from the RDB run. Active logo

is displayed. It is the only way to exit
RDB
A-4
Help Function
• Enter a question mark to receive the RDB help screen.
RHO.
Rift REPORT:7EG
3 I•
• RDB Help screen is displayed.
RDB Commands
Throttle Breakpoint
F1 ..... Line step B n ....... Line number n
F2 Command step B Ln Label number n
F3 . ISIS Normal speed (start/stop) Un SOOSOS Variable number n
14 ...SS Stream (start/stop) B (name) .. Variable name "name"
B @cmd .... Statement "cmd"
Display B Clear breakpoint
R Run control report Monitor
-n ...... Rename number n
Un ..... Variable number n N Un SI Variable number n
(name) .. Uariable name "name" M <name> Variable name "name"
rsw$ Reserved word N rsw$ Reserved word
MSWISS SI Clear monitor
Other
@cmd .... Execute statement "cmd" A MOM II Quit run
........
A-5
Throttle Commands
• Use function keys to execute the run

statements:
Fl Line step - execute 1 line of logic (includes multiple statements

per line)
Command step - executes one run statement
Normal speed processing - pressing F3 a second time halts the

execution
F4 Stream continuously, similar to F3 except commands are echoed

as they are executed - pressing F4 a second time halts the execution
The examples shown assume RDB was initiated manually. Results would be the
same if @RDB were entered as the first line of the RCR.
Throttle Example
• The following pictures are the result of consecutive Fl (line step)
requests. The line following the last SOE character is what will be
processed with the next Fl request.
RDBO
RUN TEST REPORT:7E0
3 O. *-
RDBO
RUN=TEST REPORTene
4 0 @LDU,11 (USER)A841SERS,(TIME)A8=TIME$ LDU,P (USER) .
RDBO.
RUNTEST REPORT=7E2
30 ift
4 0 RDU,11 (USERA8=USERSL(TIMMMES TI LDU,P (USER) .
5 NORAB,2 'PRODUCT TYPE' ,1
RDBO.
RUN TEST REPORTeng
3 0' ie
4 0. RNA (USER)A8=USERS,(TIME)A8=TINE$ !VLF (USER)
5 0. MOR,81 11,2 " 'PRODUCT TYPE' A.
). WM -1 .
A-7
Display Functions
• Display a variable, reserved word,

result, or the RCR itself
Vn Displays contents of variable number (n)
<Name > Displays contents of variable name
R Displays the RCR at current execution line

therefore, permitting all Line Zero capabilifies;
Fl to resume RDB.
-n Displays result number (-n); press Fl to resume

RDB
Displays contents of a reserved word xxx.$
A-8
Display Example
• Display the value of the variable <user > .
I
RDI* RT:7E0
RUN:11 10
3
4 IP @LD1.1,11 (USql?Afil:USERSALL(TIME)A8::TIPIES LIV,P (USER) .
5 0 @SOL 8 B, 2 ' PRODUri TYPE' , i
01. @RNM .
• The value of <user > is displayed

• Press Fl to resume RDB
DD.
RU TEST REPORT:7E8
3 Ilk
4 OP @LD1.1,11 (11SEF/AMSERSL(TIME)A8::TIMES LDV,P (USER) .
5 NORA B,2 'PRODUCT TYPE' ,1
6 Of @RPM -1
mum
A-9
Display Example
• Enter '-0' to display the current result.
(
RD, al
RIMEST REPORT=718
3 O. 411
4 RNA (USERABISEEMTINDAMINIS LICP (USED .
5 ' MOR,B13,2 'PROM ,1
-1 .
(USEDACASER/
• The @SOR result (-0) is displayed

• Press Fl to resume RDB
(
linO 1 NO rl shf0 hld chrs hid ino,
.DATE MAR 98 11:11:17 RID 23 26 FEB 98 MAPPER
.@991231 Production Status Refort Corporate Production B 8882
*St.Status.By. Product .Serra .ftoduc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. ______ __ Type .Number. Cost .Numhr.Code. Plan .Actual.
Date An. __ . _Order.
______ _ .Date _____ Cod.
___
. . . .
SH 831283 LS BLACKBOXO 746327 54237 FEDS 831281 831282 831203 58738
IP 831224 LS BLACKBOXI 436767 84389 ANCO 831223 831224
SC 848118 LS KAMM 675281 97441 FEDS 848131
SH 831202 LS BLACKBOX6 368661 54438 FEDS 831281 831281 831202 56937
SH 831289 LS BLACXBOX6 777324 54232 DICO 831227 8312 831209 S8538
SH 831283 LS BLACKBOX6 785367 52833 ARCO 831201 831282 831283 S8934
OR 831218 LS BLACK:NV 99842 FEDS
OR 83122? LS BLACXBOX? 99725 INTR
SC 8481 LS BLACKBOX? 665481 97541 FEDS 848122
IP 83122? LS BLACXBOX? 733597 84351 AMCO 831227 83122?
SH 831282 LS BLACXBOX? 744627 44232 INTR 831281 831281 831202 S8531
IP 831215 LS BLACKBOX7 933581 84381 FEDS 831215 831215
OR 831239 LS BLACUOM8 92788 FEDS
A-10
Display Example
• Enter 'R' to display the RCR
( RDS
RftitalT REPORT:7EO
0. @MI -1 .
• RCR is displayed beginning at line currently pointed to by RDB
LIND 6 FMTO RLQ - SHFT HLD CHRS HLD LNC'. 7E8

NM -1 $
1 " 'PRODUCT TYPE(1-5)' ,BLACK ,
ITSP,-11,1 I AUSERY, PLEASE HIT Fi TO CONTINUE WITH THE RUN.' 1
@CAL,-8 '''RETAIL','WHOLE'/DEMO RESULTS ,A,B,C+ C=A-B <TOTALM8
@RNM -2 .
ETSP,-2
..... END REPORT
A-I I
Breakpoint Functions
• Used to halt run at a specific point

• Only one breakpoint active at one time
• Active breakpoint displayed on Status
line of RDB screen
B# Halt the run at Line #
B L# Halt the run at Label #
B V# Halt the run after Variable # is encountered
B <Name > Halt the run after Variable name is encountered
B @xxx Halt the run after run statement xxx
B Clears any of the above breakpoints
The following example illustrates the use of breakpointing to halt the run at a
specified point, providing the ability to check the status of variables or
reserved words at any desired point in run execution.
A-12
Breakpoint Example
• Enter 'b 10' and transmit to set up a breakpoint at line 10.
RDI31
Rift REPORD:7E2
3 if=
• Breakpoint is displayed; press F3 (normal execution) to execute the run
RDB
RUtTEST REPORT-?E8
3 4
• RDB halts the run before line 10 is processed
RDBO.
MTEST REPORT:7E9 BREAKPOINT 18
L -0 " 'RETAIL' /WHOLE' /DEMO RESULTS' ,A,B,C+ C=A-B (TOTALMO .
-2
A-13
Breakpoint Example
• With the run breakpointed, check the contents of the variable < total >
before continuing
RT::71C0 BREAKPOINT:18
9 10. " 'RETAIL' 'WHOLE' DENO RESULTS' ,A,B,C+ C4A-B <TOTAL)I8 .
BREAEPOINT
19 O. @RNM -2
• <TOTAL> value is displayed
RBBB
Rift TEST REPORT:7E8 BREAKPOINT:10
9 0. @CAL,-0 " 'RETAIL' 'WHOLE','DEMO RESULTS' ,A,B,C+ C=A-B (TOTAL)I8
BREAXPOINT
14 -2
A-15
Monitor Functions
• Display the contents of a variable or

reserved word
— Prior to each line if executing via Fl or F4
— Prior to each statement if executing via F2
M V# Monitor Variable #
M < Name > Monitor Variable name
M xxx$ Monitor reserved word xxx$
M Clear any of the above functions
A-16
Monitor Example
• Enter 'm time$ ' to monitor the value of the reserved word 'TIMM'
• Each of the following displays is the result of execution via Fl (line step).
RiltiTEST REPOIr1=7E0
3 3E:
Ting-M:56: 311
USEDA8:USERS,(TINDA8=TIME$ LDU,P (USER)
RDBO,
ItiftTEST REPORT:77E9
3 Op *-
TIMM/1M 56 :31/
TINES:118:56 :45/
USER)48:USERS,(TIME)A8=TIME$ LDU,P (USER)
11107.116:5
,P. VORA " 'PRODUCT TYPE' ,1
A-17
Execute Functions
• RDB allows dynamic execution of run

statements
• Statements are entered on line one of
RDB screen
• Statements can be inserted at any
time while under RDB
• Inserted run statement(s)
— may affect any following statements
— are temporary for current execution of RDB
— are NOT placed in permanent RCR
A-18
Execute Example
• Insert an @LDV statement before the first line of code in the RCI is
processed.
•• • : : :• ..• : : : :•:
• Inserted line is displayed
RDB
RiltTEST REPORT:7E8
NSEIT4 SiZtti::iitOUNTER, 12*

3
Display the value of the inserted variable

RDB
30 *
INSERT4 @LD1.1 (COUNTEDI2:11
3 ife-
• Variable value is displayed

RDB
RftTEST REPORT:7E0
3 I.
INSERT-► @LIN) (COUN'TER)I2::13
...................
A19
Error Mode
• Available when a run errors while

processing under RDB
— As with normal run execution, the RCR is
displayed when an error is detected
• To activate, press Fl or enter RSM

▪ RDB screen reappears
- RDB functions are restricted in error mode
Once in Error mode, use 'display'

functions to examine:
— variables
— reserved words
— results as they existed when the run errored
• To correct syntax errors:

— display the RCR via the R function
— type in the correction
— transmit
• To resume Error mode:

— press the Fl key or enter RSM
• To verify correction:
— Exit RDB
— Re-execute the run under RDB
A-20
Exercise
1. Copy the 'MARK' run (3E0) into your RCR. Execute the run manually
under RDB. What appears on the screen?
a. Line step the run five times. What line will be processed next?
b. Display the variable RETAIL. What are the contents?
c. Change the value of RETAIL to 400000.
d. Display the variable again. Has it changed?
e. Command step the run. What line will be processed next ?
f. Display the renamed result -1.
g. Return to the Run Debug prompt screen.
h. Stream step the run.
i. Continue RDB from the displayed result.
j. Exit the RDB utility.
2. Again, execute the run manually under RDB.
a. Monitor the variable named RETAIL. What changed on line 2 of the
display?
b. Set a breakpoint for line number 10. What changed on line 2 of the
display?
c. Stream step the run. What is the value of the variable < RETAIL>
when the run halts?
d. Exit the RDB utility.
3. Remove the parentheses from the @SUB statement option field. Insert
the RDB statement as the first statement of the RCR.
a. Execute the run
b. Step the run (F1) until there is an error.
c. After the run halts in error, enter RDB Error mode.
d. Display the renamed result 4. Can the result be shifted?
e. Return to the 'error mode' prompt screen.
f. Display the value of variable RETAIL.
g. Display the RCR. What steps are necessary to correct the error and
execute the run successfully?
A-21
B
Four-to-One
and
Five-to-One
Screens
Appendix Name
Appendix B
Four-to-One and Five-to-One Screens
Appendix Name
Four-to-One Output Screen
• Four lines of input produce one line of

output on terminal screen
— 3 Edit code lines
— 1 Data line
• Allows character-by-character screen

control
• Specify 4 in eleventh subfield of
@OUT statement
Replaces need for P and 1 options of
@OUT statement
• Terminal type dependent
- FCC$ identifies whether or not terminal has
screen protect capabilities
B-3
Appendix Name
FCC Characters
M Characters Emphasis
Tab Stop Protect Characters
No B RF V
Yes
Yesbr f v
Low
No j Z
Ei A
No
On Yes I z n
No @ p 0 T
Norm Yes ' P '4...:,. t
Yes
No H X L \
No Yes h x I <
No CS GW
Yes Yes c s g w .
Low
No , K [ 0 -
No
Yes k { 0 >
Oft ,.
No AG EU
Norm Yes
Yes
No I Y M I
No
Yes I Y m }
N Characters Stink Chat
No 0
Normal
Yes ii
Lett
No P
Reverse Yes X
No Editing
No 0
Normal
Right Yes L
No T
Reverse Yes \
Normal
No .121J.::
,
Y es , I
Left
No 0
Reverse
Alphabetic Only , Yes Y
No E ,
Right Normal
Yes M
NoU p,
Reverse Yes
No 8
Normal Yes j
Left
No , R ,
Numeric Only Reverse Yes
No F
Noma!
Right Yrs , N
No V ,
ROMIG Yes ..
No , c
Normal Yes, K
Loft
No lt,:
Protected Reverse Yes
No a
Normal Yes 0
Right No w
Reverse Yes --
B-4
Appendix Name
4-tot Example
@brk
M line N d
N line S
Emphasis
Data State: $$
@brk out,-0,2,1,1,1,y„,4 .
Actual starting line How many lines, based on

groups of four lines each
• M Character - Controls intensity, tab

positioning, etc.
• N Character - Controls editing,
justification, etc.
• Emphasis Character - Additional
characters on screen to emphasis
specific data
• Must be 4 successive lines of source
code
Emphasis Code Strike Through Underscore Column
Separator
NO NO NO
! NO NO YES
,..... - :._..
-..-
NO .........
:.. YES
:.........
...*.".:11
,....... NO
NO YES YES
( YES NO NO
) YES NO YES
' YES YES NO
- YES YES YES
B-5
Appendix Name
4-to-1 Example
• Run statements
LIND. 1 FMTI0 RLQ SHFTO. HLD CHM HLD LNO, 66F8

.DATE 19 OCT 98 14:35:15 RID 66F le OCT 90 HEWN
.RUN FUNCTION DATA:l~ sa BY: F
itz____-__ __ _ __ ____-_ _ -__ ______ -_____ _ .......... _ . __-__-
iii
00iii.g 00M0000!0000040 .. .... 00
Wok .
N a N
S @ s
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
NAME...:Ule
a N
@ s
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
STREET.:Ull
@a N
S
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
CITY...U12
dN BN a Nd Na N
AS BS B SB SB S
$$ $$$$$ 55$ 55$ 555$
STATE..:U13 ZIP:U14 PHONE:(v15)v16-y17
Mok out, -9,2,4,1,1,y„,4
1 Row:1 Co1:7 98/OCT/10 14:34 000
• Output
I
NAME .:U18
STREET.:Uli
STATE..:U13 MP:1114 PHONE:(v15)v16 v17
B-6
Appendix Name
5-to-I
• 5 lines of input produce one line of

code on screen
— 4 -Edit code lines
— 1 - Data line
• Additional line between N character

line and emphasis character line to
specify color
• Specify 5 in eleventh subfield of
@OUT statement
• Available only to UTS 60 terminals and
PCs that emulate the UTS60
Background Colors
. .
Blk Red Gm Ylw Blu Mgt Cyn Wht
L H P X h p x
Black
t A :()Ytt I q y
Red
t
e 13 X b j r z
Green
r
Yellow C K S c k s {
C
Blue D L T I t I
0 Magenta E M U 1 e u }
r
S
F N V ,, f n y 0,
Cyan
White G 0 W ._ g o w
Note that shaded boxes indicate "invisible character" choices, with

background color the same as character color.
8-7
C
Working With
MAPPER
Forms
Working with MAPPER Forms
Appendix C
Working With MAPPER Forms
c-i
What is a Form?
• Report containing screen commands

• Use screen control commands to
— Create and edit screens
— Map function keys
o Process of assigning a specific action to a specific
function key
— Provide context-sensitive help for screen fields

o Display online documentation for each field
displayed on that screen.
C-2
Form Example
♦ This form creates the Line Zero (LZ) manual function menu. The three
basic parts for the form are function key mapping, screen image
commands, and context-sensitive help.
Line,. 1 14H286
.DATE 27 MAY 98 94:23:59 RID 14H 24 NAY 98 THALHUBER
.Line Zero Information (LZ) Function Forms Version: 35R1
PREP,(pr,hac)
FREY,1,Re*ume,rsm
FEEY,2,Paant,pnt
FHEY,4,Return,formret,7
FREY,8,Help,asphelpil
FREY,111,Quit,A
PC,1,6111 12"
FLD 3,24,5,35,an,(PR,boc)
F1,10,24„35,ov,(FR,tc), ' Line Zero Information
DFLD ,u,(ts,aijc);DFLD,',(ts,co,fc)
AREA:,4,25,3,33„(pr,mc)'
Report
END
DSPFORML242E,1,1
HELP,1 a
Report
2Paint 4Return 6Tasks Mew 1BEdit
C-3
Form Example
• LZ menu. Select F8 for context help
Line Zero Information

Report ■
4Return 10Qui t_ _
• Context help is displayed
Line Zero Information

I Report
4Re turn 8Help 9 19Qui t

Displaying a Form
2 Commands used to display a form

DSPFORM
o From a run
— @SC (format 2)
o From another form
C-5
FKEY Command
Used to build function key bar at

bottom of screen when a form is
displayed
— Assigns an action to a specific function key
FKEYIkynAitlelaction
FKEY command identifies
— what function key it is mapping
— What label should appear on what function key
bar (up to 6 characters)
— What action should be taken if that key is
pressed by the used.
C6
FKEY Action
• Can be any valid command line input

— Manual functions
— Runs
• Action is linked to specified function

key
• Special FKEY commands
- DSPFORM
- DSPHELP
FORMRET
— PAGE
— SELECT
— KEY
• Special commands are

— Used only by FKEY
— Not executable from control line
C-7
Function Form - Search
• Below is the run code for the Search manual function menu.
— If Fl key is pressed, RSM (resume) is performed.

— If F2 key is pressed, PNT (paint) is performed.
— If F4 key is pressed, FORNMET,7 (redisplay the current form or
report) is displayed.
— If F8 key is pressed, DSPHELP,1 (context-sensitive help) is
preformed.
— If F10 key is pressed, a ^ (release) is performed.
I
Line). 1 Ro1100 5H286
.DATE 27 MAY 98 84:23:58 RID 511 24 MAY 96 THALHUBER
.Search CS) Function Forms Version: 35111
PREP, (pr bac)
nian14
FRENtiti,
FREY*
FNMA
PC 1
3,19,6L43,afb,(PR,Loci
FLP;3,I9, 43,c1.04(FR,tc )„ Search Report Data '
DELD,ai u:(tst#1,fc);DFLD,n,u,(ts,no,fc);DFLD„,(ts,co,fc)
AREA,4:26,4,41„(pr,mc)
Report or drawer __Ai
Format number _p
END
DSPFORM,265E,1,1
HELP,1 9
Report or drawer
_ 2Paint 4Return asks C 'M ew H elp 9 18Edit
0-9
KEY FKEY Action
Similar to @KEY run statement

Must be uppercase
When a function key is pressed (that
has a designated action of 'KEY')
— Control returns to the Run Control Report at
line following @SC statement that produced
the form
— Reserved word FKEY$ will contain the number
of the key that was pressed
C-10
KEY FKEY Action

• Calendar run display
OCT SUN NON TUE WED THU FRI SAT NOV SUN NON TUE WED THU FRI SAT
1998 1 2 34 5 6 1998 1 2 3
7 8 9 18 11 12 13 4 5 6 7 8 9 18
14 15 16 1? 18 19 28 11 12 13 14 15 16 1?
21 22 23 24 25 26 27 18 19 29 21 22 23 24
28 29 38 31 25 26 2? 28 29 38
DEC SUN NON TUE WED THU FRI SAT JAN SUN NON TUE WED THU FRI SAT
1998 1991 i 2 3 4 5
2 3 4 5 6 7 8 6 7 8 9 18 11 12
9 18 11 12 13 14 15 13 14 15 16 1? 18 19
16 17 18 19 28 21 22 28 21 22 23 24 25 26
23 24 25 26 27 28 29 27 28 29 38 31
30 31
FEE SUN NON TUE WED THU FRI SAT NAR SON NON TUE WED THU FRI SAT
1991 1 2 1991 1 2
3 4 5 6 7 8 9 3 4 5 6 7 8 9
le 11 12 13 14 15 16 18 11 12 13 14 15 16
1? 18 19 28 21 22 23 17 le 19 28 21 22 23
24 25 26 2? 28 24 25 26 2? 28 29 30
31
JAhead 2Back 3YrA4 !MLR_ 5 6 7 Hell) 9 Mit
C-11
FKEY KEY Action Example
This portion of calendar run shows:

• Use of KEY action of FKEY command
• Maps F1, F2, F6, and F7 to KEY action
• Each function key has a different label
— Fl key label - 'Ahead'
— F2 key label - 'Back'
— F3 key label- 'Yr .Ahd'
F4 key label - 'Yr Bk'
• When form is displayed and user presses one of the above keys, control
will return to the line following the SC statement that displayed the form.
• The run then checks contents of FICEYS to determine which key was
selected, and consequently what to do from that point.
r. DATE 28 MAR 90 15:22:45 RID 118E 18 MAR 98 MAPCOORD
FKEY Example Demonstration Runs Ellen
',I :14/fIL: 'of 4 1142 MIN t,7
FREysie It A p,calenaar
PC,(row5,g," i <M1)(1-3)";PC,,+37,___
"'(142)(1-3)"'
PC,+1,3; (141)(0-4)" PC„ +36; " 012)(8-4)" ;
DATA,<row),1,7L
SUN MON TUE WED THU FRI SAT SUN MON ITE WED THU FRI SAT
RDL,-2,<L) <C1>-28 011)s INC,6 (IX RLN,<L) (CV-28 012)s DEC,5 (L)
OU> (K2)
PIF (L) LT 8, (lin-2) ,
FID,0014),89,1,29,u,(MICl/GRE);FLD,+1,89,6,29,F,R1),WHI/BLID;
F11,0011>,49,1,29,u,(RIMOU/GRE);FLD,+1,49,6,29,f,(RU,WHI/BLU);
COIF (N) EQ 0,(1100)
881'8: BRK SC, -8„ ,1

Fdy
C DUD1(011)81)+31 (X)h18 GTO 8130 .

C D7.:D1((VMH11)+31-.365 (X)h18 GTO 8130 .
C D7::D2(' el ' (14)" (Y)+366 (01118 GTO 0130 .
C DUD2('131 '01)"(Y)-365 (x)h18 .
88131ELDU,p (x) LDV (M)h.3::(x)(1-3),(9)i4::(x)(8-4)
@0148:LDU trnamM12:11UNS (max) .
Chun (rnam),(m),(y)
11(31513:BRK SC,-(3 q
C-12
SELECT FKEY Action
• Associates an action with a specific

field on display
• Must be uppercase
• SELECT action allows
— Run to determine the field position of a user
when the transmit key is pressed
o Each field must begin with a tab
Lines immediately following FKEY

command specify the SELECT action in
— These lines must contain
o List of field numbers
o Action to take
• Field numbers are counted from left to

right, top to bottom
C-13
SELECT FKEY Example
'0' in key number subfield position associates this action to transmit key,
whatever it is for the particular terminal in use.
• Lines beneath SELECT action line
— What action to take if user transmits from fields 1-6
• Six fields are designated in the AREA section of this form by the
underscore (-) character.
— Field 1- Run called BIO will be executed
— Field 2 - Run called BIOC will be executed
— Field 3,4,5,6 all runs executed
• Also acceptable to execute any manual function based on the user's field
position
LIHE0 1 FMT RLO SHFT HLD CHM HLD LN0 UMW 5E8 0
.DATE 16 OCT 90 10:34:42 RID 5E 25 SEP 87 WEBMJG
.SELECT EXAMPLE DEMONSTRATION RUNS ENNA
PREP
FREY, 4, RETURN FORMRET, 4
FREY e„SELEd
1,1d0
2,BIOC
3,MATH
4,DEBT`
5,MONTHCAL
ALMEARCAL
MY 18 QUIT (P
FLD,3,16,18 tO4FBIORLBOC)
FLD,3,18, 14(rR,TO„' DEMONSTRATION RUNS '
DFLD„,(T Co Fc)
„
area 4,1 7 8„(PR,MC)
e
BIORHYTHM GENERATOR 1111111,
BIORHYTHM COMPATIBILITY 4WD
MATH QUIZ ONO
MORTGAGE PAYMENT CALCULATOR

MONTHLY CALENDAR
1 Row:24 Cal:64 98/OCT/16 19:24
OMR
• OD Poll
C-14
Select Fkey Example
Demonstration Runs
Biorhythm Generator
Biorhythm Compatibility
Math quiz
Mortgage Payment Calculator
Monthly Calendar
Two-Year Calendar with Picture
1 2 3 4Return 3 6 leQuit
1 Row:6 Co1:27 WOCT/16 16:41
C-15
DSPHELP FKEY Action
• Calls context-sensitive help

• Paired with HELP identifier
• DSPHELP command is included in
FKEY screen control command
• Triggers "context-sensitive" help for
screen fields
When DSPHELP action encountered
— Screen control automatically remembers the
current field position of user
— Action will look for another command (HELP)
and pair up appropriate HELP text with current
field position
C-16
HELP Identifier
• Contains help text for a screen field

• Specifies screen line position of help text
• Specifies help text width by bar (I) character
• BELP,1 18 I
• Not case sensitive
• Follows an END command
• Preceding line identifies form to display if more help is requested
• Called by DSPHELP action on FKEY command
— Pairs the appropriate HELP text with each screen field
o Fields are identified by tab character attributes and are counted
form left to right, top-down
• Field numbers can be strung together on same HELP identifier,
separated by commands
• Specifies where to display the HELP text on screen, must specify
— Screen starting line
— Width of text
O Specified by placing a bar character ( I ) at the end of desired width
— Text will automatically be centered on screen, no starting character
position needed
• DSPFORM immediately preceding HELP identifier specifies what form
to display if user (after having requested context-sensitive help), wants
more help
• Press F8 (HELP) key again.
— Only one DSPFORM for this purpose, all "second HELP's" must
display the same form for one particular screen
C-17
Function Form AR
• FKEY command for key number 8 shows
— Key label says 'Help'
— Context-sensitive help is requested (DSPHELP)
— Form is immediately directed to line 21 (the first HELP identifier)
— Help text shown for field number one
• Start printing on line 8 of terminal screen
• Vertical bar character (f) on far right of line specifies width of text
• All lines immediately following this HELP identifier, and until next
HELP identifier, will be displayed as context-sensitive help
ELM> 1 FM TO Rid SHFTO HLD CHIMP HLD LW OP 2H286 O'N

.DATE 82 JUN 90 01:23:27 RID 2H 24 MAY 90 THALHUBER
Ada a Report (AR) Function Forms Version: 3511
PF1f,5;igii
FIGY,I,Revumea rsm
FEY, 2, Pun t , pnt
ul
M1,6141 AW
Fla z,5,6,71,afkgR,Loc)
F14;215,,714cy,(FRa tc),Z_Ada Report '
DFLD,inpLua(ts,aisic);DFLD„,(ts,co,tc)
AREA ,,' ,?,4,6?,,
Report or drawer inp
Title linp
C-18
Function Form - AR
• Select Help (F8).

• Context help is displayed
• If F8 would be requested again, control transfers to 283E
C-19
Paging Within Forms
• Moving forward and backward within

textual data
• Allows "forms within forms"
• Can contain any screen control
command
Begins with the DATA command
- DATA,„0,1
o Zero (0) Identifies that there are really no text lines
following this DATA command
O 1 - specifies that when this form Is called, it Is to
start with page 1
• Screen control 'PAGE'

— Group of screen control commands that may or
may not compose a complete form
— Typically, a single report may contain many

'pages'
o Allowing one report to contain multiple forms.
• Widely used in online documentation

system
• Provide easy mechanism of moving
forward and backward between forms
0-20
Referencing Form Pages
• Two kinds of pages

Numbered pages
— Non-numbered pages
• Numbered pages
— Can be called externally by using DSPFORM
— Can be called internally by Using 'PAGE' action
on FKEY
• Non-Numbered pages
— Referenced only from within same form by
PAGE FKEY action
C-21
#PAGE,[n]
• Marks beginning and end of a page

• # must be in column al of line
• Must be uppercase
• Number following #PAGE
- Is a numbered page
— Can be referenced from another form
— Only numbered pages can be referenced
externally
C-22
PAGE FKEY Action
• Used to page backward and forward

within a form
• FKEY9kynytitle,page
• FKEY,kyn,titiemage5-
• Active options and key-mapping
remain in effect unless disabled
C-23
Working with . MAPPER Forms
Disabling Function Keys
• Use FKEY command to turn off an

action assigned to a key
— Specify a blank FKEY label and action
• Used with PAGE data

• Title and action fields are empty
FKEY,1
- FKEY,1,
— FKEY,1,'
o All three examples map function key number 1 to
no action and put no label on the function key bar
o First one most efficient - Less characters to interpret
C-25
Non-Numbered PAGE Example

• Line 5 contains the DATA command
— The '0' in 4th subfield specifies there is no text following command
— The '1' in the 5th subfield specifies that this form uses PAGE'd data
and that the default initial page is 1.
• At page one (#PAGE,1)
— Key mapping for functions 2 and 3
o Function key 2 is mapped to go to the next page
o Function key 3 is disabled
— When this page is first displayed, there would automatically be no
mapping for function key 3
• 'Disabling' used later, when user is coming from the next page,
which has function key 3 mapped
• No previous page to page 1
The key mapped to go 'backward' is disabled.
• Same procedure is used for function key 2 on the third non-numbered
page
LinO 1 Rol10 188E8

.DATE 27 MAR 98 07:28:48 RID 4E 27 MAR 98 MAPCOORD
.Non-Numberea PAGE Example Demonstration Runs E8818
opts,s
data, 11,1
#PAGC1
Fr4,2,Rollfw,page,
fkey,3
fksy 18 Quit A
fla,4,161126i8tafb,(?r,hoc)
area,,5,,l,w,2u„(pr)
1
This is page one. You
cannot page b#ckward
because this is the
first page. You can
page forward by press-
ing f2$.
Pc i 1
Mint 3 4.Return_5 _Vasks ?View 8Help 9 10Edit_i
C-26

RCR continued
Linel, 23 Rol l
FCP9,2,RollFw,page,4
fkeyk10,1uit,_A
fla,7,213,12,28tan,(pra boc)
area„8,21,6,26„(pr,mc)
2
This is page two. From
here, you can page
forward or backward by
pressing f2$ or f3$.
pc 1
4PAGi
prep
fkey,2
fkey,3,_RollBw,page,-
(key, 10z Qui t,
Lid, Ai 304121.281,afb, (pr, boc)
area, ,41,41,7,20, (Prim)
1Resume Mint 3 4Return 5 6Tasks ?View SHOT 9linio Mat
• RCR continued
Line 45
This is the third (and
last) page of this
example. The RollFw
has been disabled
because there are no
more pages. Press (3$
to page backward.
pc,I,1
• II • • • • • END REPORT . • IP • • •
.IBesum aPgint 6Tasks Mew 8Help 9Undo Mat._
C-27

1
cannot page backward
because this is the
first page. You can
page foward by press-
ing F2.
1 2RollFw 3 4 5 6 7 8 9 10Quit
1
2
here, you can page
foward or backward by
pressing F2 or F3
2RoliFw 3RollBw 4 5 6 7 10Quit

last) page of this
example. The RoliFw
has been disabled
more pages. Press F3
to page backward.
1 2 3RoilBw 4 5 6 7 8 9 Vault
C-28
Numbered PAGE Example
• Each page can be referenced externally

• Key mapping for page 1
— Function key 2 mapped to display the form in report 4E, at page 2
— Function key 3 does not have to be 'disabled' (as in previous example)
Key mapping is not retained 1?etween pages that are referenced
externally (also known as initial pages)
Linello 1 Roll ► 188E8

.DATE 27 MAR 98 87:28:48 RID 4E 27 MAR 98 MAPCOORD
.Non-Numbered PAGE Example Demonstration Runs MA
opts,s
data , ,8,1
#PAGE,1
Fin, 2, Rol 1 fw, page ,
fkeY,3
fksy ,10,Qui t LA
fla,dble,12,z8ian,(pri koc)
area,5,11,13,26„(pr)

cannot page backward
because this is the
first page. You can
page forward by press-
ing £2$.
PC 1
#PAGE
1Resume 2Paint 3 4Return 5 6Tasks 7Uiew Help 9 Mat
C-29
Numbered PAGE Example

RCR continued
Line0. 23 Rol l
rep
eg 2 RollFw +
fkey,3,1tollftitage,
fld,7,20412A214ailiti :goc)
area„11,a,0,20„%lar!
2
here, you can page
forward or Backward By
pressing f2$ or f3$.
11
prep
fkey,2
fkey, 3,Rol I Bw, page,
fkey let Quit,
fla,10,38,12,28,afb,(mboc
area,,11,31,9,26,,(prame)
1Resume 2Paint 3 4Return 5 6Tasks Mew 8Help Mao 18Ed t
• RCR continued
Line0. 45 Rol l
last) page of this
example. The RollFw
has been disaLled
'ore pages. Press f3$
to page backward.
pc,1,1
END REPORT
.1Resume ?Paint 3_____41.1eturn_5 6Tasks Thew 8Help 9Undo Mat__
C-30
DSPFORM FKEY Action
Displays a form
Calls and interprets a set of screen
control commands
• Similar to the @SC run command
• Allows you to specify which PAGE to
start at (initial page) in the form
*discussed later
— @SC does not
• Manipulates the Form Return Stack

- @SC does not

• Dspform,rd[c,pgn,tab,opt]
— Report/drawer/cabinet containing the form
— Tab position at which to place cursor when
form displayed
— Stack option to use
C-31
FORMRET FKEY Action
• Returns to a form and displays it

• Specifies point on Form Return Stack
to return to when particular function
key pressed
• Format of action has only one subfield
• Subfield contains an option (number)
which identifies the return point on
stack
Not case sensitive
Formret[,opt]
C•32
DSPFORM - FORMRET Example
• Basic example shows use of DSPFORM and FORMRET FKEY actions

• Function key I of page 1
— Mapped to display form in 111e, beginning at page 2
• Function key 4 of page 2
— Mapped to return to that form
I
.DATE 2? MAR 99 97:29:40 RID il1E 2? MAR 90 MAPCOORD
.DSPFORM, FORMRET Example Demonstration Runs
opts,sl
data „9,1
ey ii8Quit„
fla,Z,140,3Z„afh,(pr,whifoga)
area„3,15,5,38„Cpr,m0
This is form A.
AGE
key, „Quit,.
fla,4,18,7,3z„afb,(pr,whi/gel)
area„5,19,5,38„(pr,mc)
This is form B.
1Resume 2Paint 3 4Return 5 Vasks ?View 8Help 9llndo 19Edit J
C-33
DSPFORKFORIVIRET Example
This is form A
114IxtFrm 2 5 7 8 9 1000
This is form A.
1NxtFrm 2 3 4 5 6 7 8 9 10Quit
C-34
Form Return Stack
Contains a set of return forms for

FORMRET command
• Maximum of 10 forms on stack at one
time
• Built by DSPFORM command
according to the option used
• Cleared with every release
C-35
DSPFORM Stack Options
• Specifies placement of form on stack

• Options
- 0 Put this form on top
1 Clear all other entries
Put this form on top

—2 Put this on top and mark it
—3 Save exact screen display on stack
NOTE: Option 3 is Not available on 1100

—4 Do not put this on stack
—5 Overwrite current top entry with this form
• No option specified - option 0 used
C-36
DSPFORM Example
• DSPFORM,rd[c,pgn,tab,0]
• 0 option = Default
• Places this form on the top of the stack
• In this example, no other forms were on the stack
• If other forms were on the stack, this form would be placed on top
STACK
Form A
• DSPFORM,rd[cipgn,tab,l]
• Option 1, clears all current entries on stack
• Put this form on stack
Assuming stack currently looked like previous example (FORM A}, this
option would remove that form and put this form (B) on.
STACK
Form B
C•37'
DSPFORM Example
• Option 2 - Put this form on top and mark current from for return
It marks current form on display for return from a FORMRET,2 action. This
means, there is a FKEY action called FORMRET which returns to a specific
form on the stack, and if that FORMRET uses a 2 option, the current form
will be displayed.
STACK
Form C
Form 13
REMEMBER: Option 3 is not available on 1100 series
• Option 3 - Adds form specified on this DSPFORM action to top of the
stack
• First it saves the current screen (exactly as the screen currently exists).
• If FORMRET,3 action is encountered, it will re-display current screen
exactly as it exists (including a report, if one is on display)
STACK
Form D
Form C $
Form B m
C-38
DSPFORM Example
• Do not put the specified form on the stack
Form will be displayed, but the stack will not be changed and you will never
be able to use the FORMRET action to return to this form.
STACK
Form D
Form C S
Form B m
• Option 5 - Overwrite the current top entry with this form
STACK
Form F
Form C S
Form B m
C-39
FORMRET Stack Options
• Allows you to return to a previously

displayed form or report
• Return point based on what currently
exists on the stack, as welt as the
return option specified
Options
- 0 Previous entry
— 1 Bottom entry
— 2 Marked entry
— 3 Saved entry
Not available on 1100 series
— 4 Top entry
— 5 Redisplay report
+ Previous entry
or Previous entry
or Top entry
C-40
FORMRET Example
• Stack has eight forms on it (Forms A through H)
This is form H
2Ret0 3Ret1 4Ret2 5 6Ret3 7Ret4 8Ret5 9Ret6 10Ret7
C-41
FORMRET Example
FORMRET[,O]
• Option 0 - Default option
• Return to previous entry (previous form on the stack)
Assuming that FORM H was the last form displayed, a FORMRET,O from
that form will redisplay FORM G.
STACK
Form H
Form G
Form F
Form E
Form D
Form C
Form B
Form A
This Is form G
1Fwd 2Ret0 3Ret1 4Ret2 5 6Ret3 7Ret4 8Ret5 9Ret6 10Ret7
C-42
FORMRET[,1]
• Option 1- Returns to form that is on the bottom of the stack
STACK
Form H
Form G
Form F
Form E
Form D
Form C
Form B
Form A
This is form A.
This is form H.
Fwd 2Ret0 3Ret1 4Ret2 5 6 Ret3 7fiet4 8Bet5 9Ret6 10Ret7
C-43
FORMRET [,2]
• Option 2 - Returns to form that was marked with a 2 option on the

DSPFORM command
— If none exists - Returns to saved form ( 3 option on DSPFORM
command will return to that form)
— Neither exists - Will return to the logo and clear the entire stack
STACK
Form H
Form G
Form F
Form E
Form D
Form C
Form B
Form A
M
This Is form B
S
This is form H
1Fvni 2Ret0 3Ret1 4Ret2 5 6Ret3 7Ret4 8Ret5 9Ret6 10Ret7
C-44
FORMRET[,3]
• NOTE: Option 3 is not available on 1100; it has been shown to inform you
that this option is available on other systems.
• Returns to the form that was save with a 3 option on the DSPFORM
command
• If no save, return to logo
• Current screen is saved exactly as it exists
If at a particular time, there are 3 forms and a report on display (as in a
'form-overlay' situation), all of them are saved in one entry on the stack.
STACK
Form H 1
Form G
Form F
Form E
Form D
Form C S
Form B m
Form A
S
This is form C
C-45
FORMRET[ 4]
• Returns to top entry of stack
• Typically used when current DSPFORM does not put entry on stack
(dspform,option 4)
STACK
Form H
Form G
Form F
Form E
Form D
Form C
Form B m
Form A
This is form H
1 2Ret0 3Ret1 4Ret2 5 6Ret3 7Ret4 8Ret5 9Ret6 10Ret7
C-47
FORMRET[,5]
• Redisplays report currently on display (if there is one) and re-displays the
form from the previous entry on the stack
• For options 5,6,7 of FORNMET, must have 'L' option in screen control
Tells the form to remember that a report was actively on display at the
time that form was displayed and to 'remember' that report
— If 'L' option is not active when a form is displayed (DSPFORM), the
report will not be 'remembered' and will not be accessible upon
retuniing to that form
STACK
Form H
Form G report
Form F
Form E
Form D
Form C
Form B
Form A
This is form G
C-48
FORMRET[,5]
Line ) 1 Roll) 2B8

.DATE 10 JUL 98 12:26:28 RID 2B 26 FEB 90 ACAS
.(P991231 Production Status Report Corporate Production BWF02
*St.Status.By. Product .Seriai.Produc.Order.Cust .Produc.Produc. Ship .Ship ,Spc.
*Cd. Date
1
==iii !- .In.---
! ----.Mumber.
T i! Cost .Numbr.Code
_ - .____-- - --. Plan .Actual. Date .Order.Cod.
----
SC 840110 LS BLACHBOX5 675281 97441 FEDS 840131
IP 831222 LS BLACXBOX5 7382 84848 NCO 831222 831222
SH 831203 LS BLACKBOXB 746 1282 831283 58738
SN 831202 LS BLACXBOX6 368 :1201 831282 56937
SH 831289 LS BLACOX6
XB 77? 11.2 4.: 831289 58538
IP II MEI 7
Sti 831283
OR 831218 LS BLACXBOX?
912
This is form G :1282 831283 58934
1216
OR 831227 LS BLACXBOX?
SC 848188 LS BLACXBOX? 665401 9i541 FEDS 848122
IP 83122? LS BLACXBOX? 733597 84351 AMCO 831227 831227
SH 831282 LS BLACK:1)0X? 744627 44232 INTR 831261 831281 831292 S8531
IP 831215 LS BLACXBOX? 933581 84381 FEDS 831213 831215
iResume Mint 3 4Return 5 6Tasks Mew 8Help 9 10Edit
1 Row:2 Co1:2 98lOCT/16 .11:58 ... Poll
C-49
FORNIRE1[,6]
• Does one of two things

• If report was on display when form was displayed, it will repaint the report
• If no report is on display, it will re-display the form from the previous
entry on the stack
• Similar to FORMET,5 exception - Does not display both a report and a
form
STACK
If no report If report
Form H
Form G report
Form F
Form E
Form D
Form C
Form B
Form A
1MMM1.11.NIMII
This is form G
1Fwd 2RetO 3Ret1 4Ret2 5 6Ret3 7Ret4 8Ret5 9Ret6 10Ret7
C-50
FORMRET[6]
I
Lined 1 Rall
.DATE 12 JUL 911 12:26:20 RID 2B 26 FEB 96 ACAS 2Be
.@991231 Production Status Report Corporate ProductionB
*St.Status.By. Product .Seria1.Proauc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. _ -- .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Coa.
m=4_--Date
SH 831283 LS BLACXBOXO 746327 54237 FEDS 831261 831282 831283 S8738
58 831282 LS BLACKBOX6 368061 54438 FEDS 831221 831281 831202 $6937
SH 831209 LS BLACKBOX6 777324 54232 DICO 83128? 8312 831299 s8538
SH 831283 LS BLACXBOX6 785367 52833 ARCO 831201 831282 831223 $8934
OR 831227 LS RACISM 99725 INTR
SC 8481: LS BLACXBOX7 665481 97541 FEDS 840122
IP 831227 LS BLACXBOX7 73359? 84351 AMCO 83122? 831227
SH 831292 LS BLACKBOX7 744627 44232 INTR 831201 831281 831202 88531
IP 831215 LS BLACXBOX7 933581 84381 FEDS 831215 831215
1Besume Mint 3 4Return 5 6Tasks ?View BHelp 9 Mat
1 Row:1 Col:24 90/4CT/16 11:59
C-51
FORMRET[,7]
• Does one of two things

• If report was actively on display when form was displayed, it will repaint
the report
• If no report was on display, it will redisplay the current from
if no report If report
STACK
Form H report
Form F
Form E
Form D
Form C
Form B
Form A
This is form H
2RetO 3Ret1 4Ret2 5 6Ret3 7Ret4 6Ret5 9Ret6 10Ret7

FORMRET[,7]
(
Line 1 Rol D, 2
.0991231 Production Status Report Corporate Production 11068862
*St.Status.By. Product .Seriai.Proauc. Order.Cust.Produc.Produc. Ship .Ship .Spc.
*ca. Date .In. Type .Number. Cost Numbr.Code. Plan .Actual. Date .Order.Cod.
--- ---- - - OMMIDOOP
IP 831224 LS BLACKBOY1 436767 84389 AMCO 831223 831224

IP 831225 LS BLACHBOX1 436768 84398 AMCO 831223 831225
OR 848118 LS BLACKBOY4 94754 ARCO
SC 840110 LS BLACKBOY5 675281 97441 FEDS 840131
IP 831222 LS BLACKBOY5 737582 84840 AMCO 831222 831222
SR 831283 LS BLACKBON 746327 5423? FEDS 831281 831282 831203 58738
SH 831282 LS BLACKBOY6 368861 54438 FEDS 831281 831281 831282 $6937
SH 831289 LS BLACKBOM6 777324 54232 DICO 831207 8312 831289 58538
SH 831283 LS BLACXBOX6 785367 52833 ARCO 831281 831282 831283 S8934
IP 831216 LS 'LAMM 926581 89381 INTR 831215 831216
OR 831218 LS BLACXBOX? 99842 FEDS
OR 83122? LS BLACKBOX7 99725 INTR
SC 8481 LS BLACKBOX7 665481 97541 FEDS 848122
IP 831227 LS BLACKBOM7 733597 84351 AMCO 83122? 831227
SR 831282 LS BLACXBOY7 744627 44232 INTR 631291 831201 831202 $8531
IP 831215 LS BLACKEN? 933581 84381 FEDS 831215 831215
1Resume 2Paint 3 4Return 6Tasks ?View 8Help 9 10Eait
1 Row:1 Co1:24 98/OCT/16 11:59 •••
C-53
Retaining Function Keys

• Page to gap, using non-numbered pages, actions of function keys are
automats y retained
• Form to form (or page to page) using DSPFORM command, function
keys are not retained
0 Must be re-mapped with each form
• K - option allows function keys to be retained when using DSPFORM
command, or @SC command, to display a form
Function key bar normally displayed with a report is set to these values
Function Key Action
1 Resume (rsm, if it applies)

2 Paint (pnt, if it applies
3 SOE ( character)
4 Return (formret,7)
6 Tasks (display appropriate task menu)
7 View (display 'change view' menu)
8 Help (dspform,2e6,1 - help menu)
9 Undo (undo, if it applies)
10 Quit (edit - switch to edit mode)
This key ma ing is done internally in the code and can only be changed by
using the @: Y run command.
C-55
Displaying A Form and Returning

Control to the Run
• Displays a report containing screen

commands (form) from within a run
• Can use instead of SC statement to
display a form starting at a particular
page number
• @DSF,c,d,r,pn,tabp,opt
— Subfields are the same as the DSPFORM action
except that c,d,r = cabinet, drawer, and
report containing the form
C-56
@FKY Command
• Allows run designer to set function key mapping
• Applies to @DSP, @DSX,@DSM,@OUM run commands
• Desired key mapping (FKEY commands) must exist in a report (or result)
• @FKEY associates them with specific report (or result) being displayed
• Specified function key mapping will remain in effect until the run
terminates
• If run does an @LNK to another run, another @FKY command
establishes new function key mapping, or it is 'turned off by specifying
@FKY with no report or result
Line,. 1 Ro110 - 118E

.DATE 16 OCT 98 12:14:17 RID 118E 16 OCT 98 WEBNJG
MEV EXAMPLE BY:
liBRX
REY,I,Resumea rsm
REY,2,Searchss 2b8
REY,3,Sort,sort
FREY,4,Return,formret,7
REY,8,Help,dspform.2e,1
FREV,9,Undoi undo
FMEY,10,Quit,A
@brk rni -1 .
0dsP,8,b,2 .
@fky
8asp,9,13,2 .
Line,. 1 Rall 2B0

.@991231 Production Status Report Corporate ProductionB8062
p .Spc.
St.Status.By. Product .Serial.Proauc.Order.Cust.Produc.Produc. Ship .Shi 00
*Cd. Date .In. Type .Number. Cost .Numkr. Code. Plan .Actual. Date .Order.Cod.
SC 848110 LS BLACHBOX5 675281 97441 FEDS 849131
SH 831283 LS BLACKBOX8 74632? 54237 FEDS 831281 831282 831283 $8738
SH 831282 LS BLACKBOX6 368861 54438 FEDS 831201 831281 831202 56937
SH 831289 LS BLACKBOX6 777324 54232 DICO 831207 831288 831209 S8538
SH 831283 LS BLACKBOX6 785367 52833 ARCO 831281 831282 831283 S8934
OR 831218 LS BLACRBOX? 99842 FEDS
OR 83122? LS BLACXBOX7 99725 INTR
IP 831227 LS BUXOM 733597 84351 AMCO 83122? 83122?
SH 831282 LS BLACKBOX7 744627 44232 INTR 831281 831281 831202 58531
IP 831215 LS BLACXBOX7 933581 84381 FEDS 831215 831215
1Resume1..011A
Mint 3On/APT/ft
4Return 6Tasks Mew BHelp 9 10Edit
\! 11.CO
C-57
Named Area
Areas that have had a name specified

in the 'name' subfield of the AREA
command
• Once area has been given a specific
name, it takes on a different
characteristic from an unnamed area
• When named area is on display, any
other areas currently on display are
ignored
• All input from that entire area is sent
upon transmit, regardless of user's
current cursor position
• AREA,name,r,c,rsz,csz,o,att
• Cursor positioning and input reserved
words apply only to current area
- CURV$,CURH$
FIELD$
o Contains field number that the user was in when
transmit key pressed
- 1NPUT$,INVAR$
o Only pick up Input from the current names area
• AREA$ reserved word contains name

of current area
— Can be used by the run as a reference point
C-59
Named Areas
• 2 named areas in the form in the run
— First named area is called 'fruit'
— Second named area is called 'pet'
• Both areas appear on the same screen display
• Only the information from one area will returned to the run
— The area that the cursor is currently in when the user presses transmit
• Name of that area will be contained in AREAS
• Field selection will be in MELDS
• Based on these two reserved words, logic of run will produce correct
output message at label 020
Linel 1 - 185E8
.DATE 16 MAR 98 12:14:17 RID 105E 16 MAR 99 WIPCOORD
.Names Area Example BY:
118901:brk .
prep;optsi sme,r514
ikey,4LReturniformret
fkegLikiluita A
flat3,i8,9,26,an,(pr,whiloya)
ifld ,(ts,ai)
area:fruit,6,11,7,24„(pr,mc)
Select Your Favorite
Apple
Orange
Pear
42,9,26, afb, (pr, whi/cya)
and,,ts, ai )
area, pet,11,43,7,24„ (mow)
S'el'ect 96itzt
Cat
Dog
Mouse NMI
fibrk sc,-8,2„1 "

@ifarea$ = petgto
@if fiela = 1 ldv,p vlba=apple gto 828 .
@if field$ = 2 lav,p val2=orange gto 828
@if field$ = 3 lav,p v1h12=pgar gto ,
@818: of field$ lava.v1h12=cat gto GU
@if field$ = 2 lav ,p gto .
@if field? = 3 lav,p vlba=mouse !
ti020:se msg,1,c„tic$449 favorite sarea$' is the svii.stic$
\ IResume Mint 2 4Raturn 5 6Tasks 7Uiew noir Undo Indit j
C-60
Named Areas
Menu is displayed containing both areas

Apple
Orange Select Your Favorite
Pear
Cat
Dogll
Mousy
Ore turn t
Message is displayed

Apple
Orange Select Your Favorite
Pear
Cat
Dog
Mouse
\i‘ 1_ _. ...__ Are ttirn _5 6 9 113Qui t _ _
C-61
SCGEN Run
APPENDIX D
SCGEN Run
OBJECTIVES
Upon completion of this module, you will be able to:
1. Use the SCGEN run to build output screens and generate @SC code.
D-1
SCGEN Run
SCGEN Run
• Creates or modifies screens for use in

a run
• User builds the screen on a
scratch-pad
• Screen can be viewed and changed
• Run generates MAPPER SC
commands
SC commands saved in an 'A' report
Run accesses commands via the @SC
statement
SCGEN Run
Creating a Screen with SCGEN
• Enter 'SCGEN' on line 0

• Transmit from 'Create new screen'
Screen Control Generator

Tai to selection and transmit
Create new screen a
Modify existing screen
• Scratch-pad is displayed
• Position cursor, enter text and transmit
Screen Control Screen Generator
D•3
SCGEN Run
Entering Screen Text
• After entering text, transmit to make

permanent in scratch-pad
• Reserved words may be entered
directly without loading into variables
• Do not use underscores, quotation
marks, or vertical bars
• Enter more text and transmit

• Press 'View' (F3) to display screen as it will be seen by user
Screen Can Screen Generator
Please enter your first name
1Fiela 2FraMe Guild 5 6Change 7 Help 9Misc 1 Quit

iY
D-4
SCGEN Run
Entering Screen Text
• Receive screen as user will see it

• Press Fl to return to the scratch-pad
• Scratch-pad is redisplayed
• Position cursor to where user input field is to begin and select 'Field' (F1)
date7$
time$
Please enter your first name 11
2Frame 3View Guild 5 Mange 7 Help 9Misc 10Quit ,)
D-5
SCGEN Run
Defining User Input Fields
• Position cursor to where field is to

begin
• Select 'Field' (F1) to begin input field
definition
• Fill out field Definition menu
— Default values will appear In menu
— Select 'Help' (F8) to receive help for the menu
selection where the cursor is positioned
• Receive Field Definition menu and fill in as needed

Field Definition
To select a field fr the data dictionary t tracsm:t here --)
Field length Type input
Tab stop? Reverse video?
Character color Background color
Low intensity? Blinking?
Ri ht justify? Center text? 11
e Color? Underline?
Text
Transmit here
1 2 3 4Return 5 6 8Help 9 le
D-6
SCGEN Run
Field Definition Menu Selections
Field length Define the input field size

Type input Input field edit type. AO = Alpha Only, AI = Any
In_put, NO =Numeric Only, CO = Cursor Only,
PR Protected-no input.
=
Tab stop? Should user be allowed to tab to this position?

Reverse video? Should input be in reverse video?
Character and Blank for default, F8 for help
Background colors
Low intensity? Should input be low intensity?
Blinking? Should input blink?
Right justify? Right justify input?
Center text? Center input?
Title color? F8 for help
Underline? Should field be underlined?
Text Default text to appear in field when displayed
• Receive scratch-pad
• Select 'View' (F3) to see how screen would appear to user
date7$
tine$
1Field 2FraMe Guild 5 Rhange 7 8Help 9Misc 18Quit

•
D-7
SCG EN Run
Defining User Input Fields
• Receive screen as user would see it

• Press Fl to return to scratch-pad
. • ... ..

41a...:111X,Ihrtariarldr.
• Receive scratch-pad
• Position cursor to upper left corner of optional frame to be placed around
text and select 'Frame' (F2)
daten
tines
1Fiela 3Uiew 4Build 5 6Change 7 Help 9Kisc Inuit
D-8
SCGEN Run
Building Frames
Creates a frame around a specific area

of the screen
• May specify frame border and interior
attributes
• Procedure
— With scratch-pad on display:
— Position cursor to upper left corner of frame
and transmit
— Select 'Frame' (F2)
— Position cursor to lower right corner of frame
and transmit
— Fill out Frame Definition menu
— Press 'View' (F3) to see frame created as user
would see it
• Next step is to position cursor to lower right corner of frame and transmit
date7$
tineS
D-9
SCGEN Run
Adding a Frame
• Receive and fill out Frame Definition menu

Frame Definition
Border inputs Fill area inputs
Border color Area color
Character color
Protect? Protect? ti
Line border?
Transmit here
3 EIRe turn 5 Help 3 le

OS*
Border inputs:
Border color Enter color of frame border
Protect? Should user be prevented from placing cursor on
border?
Line border? Y = Fine line border, N = Broad line border
Fill area inputs:

Area color Background color within frame
Character color Text color within frame
Protect? Should user be prevented from placing cursor
inside border? (except in unprotected areas)
D-10
SCGEN Run
Adding a Frame
• Receive scratch-pad reflecting added border
• Select 'View' (F3) to display screen as it will appear to user
1Field 2Frame 4Bui 1 d 5 6Change 7 Bile 1p 9Misc 18Qui t
• Press Fl to return to scratch pad
......
. .. .
.. ... .. .
_•:•••••••:,
D-1 1
SCGEN Run
Selecting Initial Cursor Placement

• With scratch-pad on display, select ,Misc' (F9)
elistemsellsoussolsossosststessessessisisseesseassises
11184111148111111111111111811111111111111111111111111911$11881
date7$
timeS

15181151111111111111111111111155115111111111 1 111111111111111551111111111111111111
111111211111111.11111111.11.111111111111111111•111111 a 1111111. 1 /1 11161111111111181.11115.5
IField 2Frase Mew 4Build 5 6Change 7 8Help 113Qui t

000
9
• Transmit from 'Select cursor placement'

Tab to selection and transmit
Specify application
Prep screen colors
REY mapping
Select cursor placement'.
Context help
• Specify tab number after which cursor is to appear

Select Cursor Placement
Use one of the following
Cursor to home
tab quantity
Note: This selection is WALD if
Note:
you specify FHEY mapping.
D-13
SCGEN Run
Generating the SC Commands
• SCGEN processes the scratch-pad

• MAPPER SC commands are generated
• Commands are placed in an 'A' report
• Report may be accessed in your run
via @SC statement
• DO NOT manually update the report
Procedure:
— With scratch-pad on display, select 'Build' (F4)
— Enter the title for the 'A' report on the Title
Select screen
— 'A' report appears
Receive scratch-pad, select 'Build' (F4) to begin generation of SC commands
111111111111111111111111111111111111111111111111111111111
111111111111111111111111111111111111111111111111111111111
1
aate7$
time$

a
111181111181111111111111111111111181111111111111181111111
111111111111111111111111111111111111111111111111181111111
1Fiela 2Frame 3Uiew 5 6Change 8Help 9Misc

ONO
D-14
SCGEN Run
Generating SC Commands
• Fill out Title Select screen for 'A' report title

Title Select
Enter title and transmit
Title ORE
Transmit hereigl
Note: The screen will Be added in Cabinet Oh
4Return 5 SHeip 9 18
• 'A' report is generated with SC commands
JUN 98 CCM
Freeform Reports
D-15
SCGEN Run
Accessing the Screen Report

• Access the screen report from your run with the @SC run statement
• Syntax = @SC,c,d,r opt
• c,d,r = Report containing SC commands built from SCGEN run
• opt = @SC options
• Execute your run containing the @SC statement and screen will appear
Roll.L7 48E8
JUN 98 12:8e:56 RID 48E 38 MAY 98 CCM
chg inputS vi 2
Y1
..... END REPORT
• SCGEN screen appears
JUNE?,_,1998
12:24:67
• Name input by user is captured via @CHG 1NPUT$ and placed in the
output area for display upon run termination
l RESULT
r.
ineft 1 87 JUN 981114:37
Ro - REPORT GENERATION Cal
..... END REPORT ....a
D-16

Mapper 35R1 Advanced Vol2

Uploaded by

Copyright:

Available Formats

You might also like

Mapper 35R1 Advanced Vol2

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Mapper 35R1 Advanced Vol2

Uploaded by

Copyright:

Available Formats

UNISYS 1100/2200 MAPPER®

Advanced Run Design

Copyright:" 1991 Unisys Corporation.

Level 35R1 October 1991

Screen Input Reserved Words

• Use one of four reserved words

• Allow you to capture user input from

Enter the appropriate information and transmit.

Place cursor here.> , and transmit .

• Used to capture input from terminal

Last name 0 smith

• Same as INPUT$ except:

Last name 0 smith

@Chg Invar$ v5h20,v6h100,716

• Same as INVAR$ except:

Last name 0 smith First name 0 joe

©Chg invri $ v5s80,v616

• Used to capture a full line of input per

End of line terminates input for each

6Text line 10 Sub 1

@Chg lnstr$ vl s110,v2s80,v3s110

Output Variable Statement

scl Screen line number on which to begin display.

col Column position at which to begin display.

vld Data to display. Data can be a variable, constant,

Quickly displays data to the screen

Use as a debug tool to display

If @ITV immediately follows, interim

Input Variable Statement

lab Label to go toff the user presses a function key.

Variables in which to capture input (max = 40).

• Captures input values from screen

• -0 result is not altered

• Takes control of function key

• Stalls @OUV or @OUT (with an interim

Use the @BRK I OUT combination to re-display the input screen.

Use the @OLTV / ITV combination

@OLN / @ITV Example I

LIt4D '112FMTO PLO SH110 HLD CHRS0 HLD 0 1E188 0

Please enter your value: valuell

• Input screen is displayed the second time

Please enter your value: Puel

@OUV gnv Example I

Please enter your value:

• Balance of screen entries are made

LIND 1 FMTO, RI) - SHM HLD CHRS HLD 11, 2E108

grry @OUV Example 2

Line Rani. - 1E1

•Jou ace". -a• v. res e. a tuto tan gt ease again.. t

• Menu is displayed. User presses a function key

• Error message is displayed for 2 seconds

Command Handler Statement

@CHD [c,d,r,rern lab .

rel? Y = Ignore release ( " ) command, do not allow

lab Label where command handler routine begins.

• Takes control of line zero executions

• Takes control of function key

• Handler routines can be internal or

WM BLUE BELL EDNET SYSTEM *****