UNISYS 1100/2200 MAPPER®

35R1 New Features

and Migration
Student Guide

Copyright° 1990 Unisys Corporation

Unisys is a registered trademark of Unisys Corporation.
MAPPER is a registered trademark of Unisys Corporation.

September 1990

Printed in U S America
AL 2816 UE 8537
The names, places, and/or events used in this publication are purely fictitious and are not intended to
correspond to any real individual, group, company, or event. Any similarity or likeness to any real
individual, group, company, or event is purely coincidental and unintentional.

NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THE DOCUMENT. Any product and related
material disclosed herein are only furnished pursuant and subject to the terms and conditions of a
duly executed license or agreement to purchase or lease equipment. The only warranties made by
Unisys, if any, with respect to the products described in this document are set forth in such license or
agreement. Unisys cannot accept any financial or other responsibility that may be the result of your
use of the information in this document or software material, including direct, indirect, special or
consequential damages.

You should be very careful to ensure that the use of this information and/or software material
complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used.

The information contained herein is subject to change without notice. Revisions may be issued to
advise of such changes and/or additions.

Correspondence regarding this publication should be forwarded to Unisys Corporation, Education

Publications, P.O. Box 1110, Princeton, NJ 08543 U.S.A.
MAPPER 3581 Differences and Migration

Module

1 Introduction to Level 35R1

2 Manual Functions

3 Run Design

4 Screen Control

5 Coordination

6 Installation and Configuration

7 Networking

8 MAPPER Relational Interface

AL2816 MAPPER 35RI Differences & Migration
Audience
Experienced MAPPER users who are considering or planning
the migration to 1100/2200 MAPPER Level 35.
Objectives.
Upon successful completion of this course, the student
should be able to:
o List the steps required for an orderly migration to
level 35 MAPPER.
o List and describe the new level 35 start parameters
o Implement and use the new look screens feature of
MAPPER 35R1
o Modify existing MAPPER runs to incorporate the new
look screen and context Help features.
o Use new functions and utilities, including COUNT and
Report Writer.
o Describe new networking features, such as the @NET
run function and the enhanced Relational Database
Interface
o List and identify MAPPER 35R1 performance
enhancements.
Description
Through lecture, demonstrations and hands-on activities,
you will see and use the new features & capabilities
available in MAPPER Level 35. We will follow the steps
required to implement Level 35 MAPPER, from the
installation of the software through converting
application runs. The new features in all areas of the
MAPPER level 35 system (Manual,Run design, Coordination
and Installation) are included, except APT functions
which are covered in AL2814.
Topics
Start Parameters
Installation procedures
MAPPER New Look screens
256 character line conversion considerations
Performance enhancements
New Screen Control commands
New Help run
New utility runs
New manual and run functions
The New recovery
Report Writer
New Relational Database interface
Duration
3 full days

Prerequisites
MAPPER run design and/or coordination and operations
experience.
ii
MODULE 1

Introduction
To MAPPER
Level 35
Module I Level 35 Introduction

Module Objectives

Upon completion of this module, you will be able to:

- Sign on to MAPPER Level 35

- Use the Level 35 new look menus

- Use the Level 35 HELP run

 New Signon screen

Unisys MAPPER System 35R1

EA10 MAPPER 35R1
Station: 13746 System: 3

Please enter the following information,

or press SignOn to sign on as a new user.

User-id
Dept #
Password

Press XMIT when complete.

Si • nO 2KeYhlci 3 Fl 5 '6Reactiel 7 3HelP 11,0Exit

- Function Key Bar

Most screens that MAPPER paints will have a Function Key bar on line 24. The
function key choices depend upon the screen contents and the function that
displayed the screen. In runs, the @SC function can also paint a function bar.

Signon screen Function Key Bar

Function 1 will sign you on as "NEWUSER", with access to cabinet 0.

Function 2 displays a keyboard map.
Function 6 replaces HELP/NEW
You can now call the HELP run (F8) before signing on to MAPPER.
Function 10 disconnects the terminal device from MAPPER

LOOKSWITCH

The LOOKSWITCH function allows you to toggle between the old MAPPER screen
format and the new look.
 Logo screen

Unisys MAPPER System

EA10 MAPPER 35R1
Station: 13746 System: 3
User-id: NEWUSER
Cabinet: 0

1Report 12Keyhlp, I3Runs 4 5 STasks ?Remote pHelp [LOSgnOft

- Function key bar

F1[Report] will list all drawers available to the user-id.

F3[Runs] lists all runs available to the user-id.

F6[Tasks] lists report processing functions

F7[Remote] lists available remote MAPPER systems

F8[Help] calls the on-line HELP run

FlO[Sgnoff] signs the user-id off MAPPER

 1Reports

Drawer Selection

Fl[Reportsj lists all registered drawers available to your user-id. To switch

to a drawer, you can tab to the drawer name and transmit.

Drawer Select
Locate:
Free Form AO W
Production Status BO R
Factor Base CO R
Order Status DO R
Demo Run Functions LCS EO R
Demo Run Functions FCS FO R
Demo Free Form Data GO R
Word Processing Reports HO R
Experimental Reports I0 R

?RollFA 3R011131C 4Returri pTasks 10Quit

F2 and F3 allow you to scroll through the list of drawers that you have
permission to access.

F4 returns you to the previous screen. MAPPER can nest up to 10 screens for
returns.

FlO[Quit] returns you to the logo screen (release function).

 3Runs

Available Runs

This function lists runs that your user-id can execute.

To execute a run, position the cursor at the run name and transmit

Select Application
Locate:
AC AL APT
BVT CALENDAR CC
CHART CLOCK CONFIGURE
COP DDP DLC
EXAM FCC FORM
GAMES HELP HELP*
IBFN ICAL ICNT
IDAT IFND ISOR
ISRH ITOT LIMITS
MARS NAME NAMES

2RollFw 3RollBk 4Return 10Quit

 E6Taska

Tasks Selection

To select a task, position the cursor to the task name and transmit. If
there is more than one MAPPER function within the task description, a second
menu will be displayed.

Unisys MAPPER System

EA10 MAPPER 35R1
Select Task

Create a report 1.11.1111.

Move data
Compare reports Perform math operations
Delete a report Print
Display a report Send and receive
Find data Use utilities
Modify a report Use security features

I 2 3 Retu BHelp lOQuit

 This is the menu displayed when "Find data" is selected from the Tasks menu.
Note that the direct command is displayed within the menu.

Unisys MAPPER System

EA1O MAPPER 35R1
Select Task

Create a report Find Data

Compare reports
Delete a report Find (F)
Display a report Locate (LOC)
Find data Perform a binary find (BF)
Modify a report Search (S)
Search and update (SU)
Use the IBFN run (IBFN)
Use the IFND run (IFND)
Use the ISRH run (ISRH)

Display drawer index (1)

Display drawer index by user (IU)

1 2 3 4Returni 6 7 tiOQuit
 NEW LOOK REPORT DISPLAY

Line 0 has been simplified. Only the Line and Roll functions remain. The
other display functions (Shift, Hold characters, Hold lines) are now functions
that can be selected via the VIEW function key (F7) or from line 0 with the
function call (eg. S12 to shift 12 characters ).

You can add or delete lines from the headers.

You no longer have to precede any updates with the SOE character.

After performing any function, you have the option to cancel the result with
the UNDO function (F9).

Line>l Roll> 230

,.DATE 18 JUN 90 13:35:33 RID 2B 18 JUN 90 NEWUSER
.@ Production Status Report Corporate Production B00000Z
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type *Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.
*—
IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224
IP 831225 LS BLACKBOX1 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
IP 831222 LS BLACKBOX5 737582 84040 AMCO 831222 831222
SH 831203 LS BLACKBOXO 746327 54237 FEDS 831201 831202 831203 S8738
SH 831202 LS BLACKBOX6 368061 -54438 FEDS 831201 831201 831202 56937
SH 831209 LS BLACKBOX6 777324 54232 DICO 831207 831208 831209 S8538
SH 831203 LS BLACKBOX6 785367 52833 ARCO 831201 831202 831203 S8934
IP 831216 LS BLACKBOX6 926581 89381 INTR 831215 831216
OR 831210 LS BLACKBOX7 99842 FEDS
OR 831227 LS BLACKBOX7 99725 INTR
SC 840108 LS BLACKBOX7 665481 97541 FEDS 840122
IP 831227 LS BLACKBOX7 733597 84351 AMCO 831227 831227
SH 831202 LS BLACKBOX7 744627 44232 INTR 831201 831201 831202 S8531
IP 831215 LS BLACKBOX7 933581 84381 FEDS 831215 831215
Resu aint lute tnnl[Tasks 1 J7View :Help
 F7VieTer

To use the View menu:

1. Position the cursor to the appropriate line within the report.

2. Depress the F7 key
3. Tab to the desired command on the menu
4. Enter a numeric value and transmit.

Line 1. Roll 2B0

.DATE 18 JUN 90 13:35:33 RID 2B 18 JUN 90 NEWUSER
.@ Production Status Report Corporate Production B000002
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Coade. Plan .Actual. Date .Order.Cod.
IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224
IP 831225 LS BLACKBOXI 436768 84390 AMO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
IP 831222 LS BLACKBOX5 737582 Change View
SH 831203 LS BLACKBOXO 746327
SH 831202 LS BLACKBOX6 368061 OM.
Create temporary format (VIEW)
SH 831209 LS BLACKBOX6 777324
SH 831203 LS BLACKBOX6 785367 Display alternate format (Fn)
IP 831216 LS BLACKBOX6 926581 Display and hold headings (DH)
OR 831210 LS BLACKBOX7 Hold lines on screen (Hn)
OR 831227 LS BLACKBOX7 Shift display (Sn)
Sc 840108 LS BLACKBOX7 665481
IP 831227 LS BLACKBOX7 733597
SH 831202 LS BLACKBOX7 744627 - 44232 INTR 831201 831201 831202 5831.
IP 831215 LS BLACKBOX7 933581 84381 FEDS 831215 831215
Paint 3 14R turn] 13Hel.r) 10Qui.t
 10Edit'

The Edit menu is used to add, delete or move lines in a report.

.DATE 08 MAR 90 11:11:17 RID 2B 26 FEB 90 MAPPER

.@991231 Production Status Report Corporate Production 8000002
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date Order Cod
*

IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224

IP 831225 LS BLACKBOXI 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 Line Change
SC 840110 LS BLACKBOX5 675281 9
IP 831222 LS BLACKBOX5 737582 8 Add lines
SH 831203 LS BLACKBOXO 746327 5 Delete lines
SH 831202 LS BLACKBOX6 368061 .011MismaiuMNSO
Duplicate line
SH 831209 LS BLACKBOX6 777324 1111101.11,11M11111.11111111101.
Duplicate multiple lines
SH 831203 LS BLACKBOX6 785367 5 001011.101111111MUM
Yank lines
IP 831216 LS BLACKBOX6 926581 01111111111.11111111111111D
Put lines
OR 831210 LS BLACKBOX7 9
OR 831227 LS BLACKBOX7 9'9725 INTR
SC 840108 LS BLACKBOX7 665481 97541 FEDS 840122
IP 831227 LS BLACKBOX7 7333597 84351 AMCO 831227 831227
SH 831202 LS BLACKBOX7 744627 44232 INTR 831201 831201 831202 S8531
IP 831215 LS BLACKBOX7 933581 84381 FEDS 831215 831215
Li paint aReturri 6 7 10Quit

Yank and Put

The Yank, Append and Put functions replace the Move and Insert line commands.
With these commands, you can collect lines from multiple reports and insert them
into 1 or more reports. You can create any number of buffers, as long as you do
not exceed the maximum result report size (256,000 lines).

o Yank - This command creates a buffer and moves 1 or more lines into the
buffer. The direct command is ]qYb ( crquantitylb=buffer )
o Append - The Append command adds 1 or more lines to an existing Yank
buffer. The direct comand is RAID
o Put - Put inserts the contents of a yank buffer into a report, starting
at the line below the cursor position. The direct command is ]Pb
 On-Line Help Menu

f8Helq

MAPPER Online Documentation Screen 1

I Move cursor to desired topic and press XMIT Crransmit key)-.

Manual Functions Topic

Names Menu (functions alphabetized by name) FUNCT-NAMES
Calls Menu (functions alphabetized by call) MANUAL
Run Statements
Names Menu (statements alphabetized by name) STMT-NAMES
Calls Menu (statements alphabetized by call) RUN
Reserved Words RESERVED-WRD
I General
Topics (list of all help topics alphabetized by title) TOPICS
Using the Online Help System HELP
Updates to Release Information README
New Features of This Release of MAPPER Software NEW
Orientation to OS 1100 MAPPER Level 35RI LEVEL-35R1
Key Assignments for Documentation Key Names KEY
Documents in the MAPPER Library DOC
Copyright (C) 1990 Unisys Corporation. All rights reserved.

For help using online hel ressthe Help function key. MENU: MAIN
1Locate 10Quit
 Manual command Help Menu

Help Menu: Manual Function Names Screen 5)

Move cursor to desired topic and press XMIT (Transmit key).

NAME CALL NAME CALL
Abort (key) Calendar CALENDAR
Acknowledge Message OK Call CALL
Add Line SOE]q+ Change CHG
Add On ADON Comm. Output Printer COP
Add Report AR Compare Data CMP
Add To ADTO Copy COPY
Alarm AL Count CNT
Append Line SOEJA Create File FILE
Applic. Power Tools APT Create Result Copy RSLT
Arithmetic A Create Temp. Format VIEW
Auxiliary AUX Date DATE
Background Run BR Decode Report DECODE
Binary Find BF Delete DEL
Cabinet Switch Func. C Delete Line SOE]q-
Cabinet Switch Run CS Delete Report DR
Calculate CAL Device DEV
Calculate Update CALU Diskette DISK

For help using online help, press the Hel function key. MENU: FUNCT-NAMES
1Locate. 12RollFw 4Return ..suit
 with a function Mask on Display

SORT
11111111000111111111.1b

.@991231 Production Status Report Corporate Production B000002

*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan Actual. Date .Order.Cod.

** ****** ** ********* ****** ****** ***** **** ****** ****** ****** ***** ***

Options Parameters
A Process all line types to Fields (levels) to sort
C(x Perform case-sensitive sort D Descending order
X+ Use OS 1100 Sort/Merge N Numeric sort
X- Use normal MAPPER sort process

RPaint 4Return r7View 3HelP ).0Quit

 Context Help

r8Help when cursor is positioned at an input field

PR
Print Report
Print site Banner ID
Number of copies 1 Line spacing 1
Delete line numbers? Y Forms ID
Headings? Y Print entire drawer? N
Format number Report or drawer -

Print site

Type the device name or number of any local or remote printer

available to the system.

Blank = Default printer.

a 2 13 6 lOQuit
MODULE 2

Manual
Functions
Module 2 Manual functions

Upon completion of this module, you will be able to:

- Use the new manual functions available in level 35 MAPPER

- Use new function options

- Use automatic SORT/MERGE access

- Create a print report using Report Writer

SORT

The SORT function now has the capability of calling the external SORT-MERGE
process. A new start parameter EXTSRT determines the threshold value that causes
MAPPER to call SORT-MERGE instead of using it's internal sort.
The external sort can be forced by using the "X" option on a SORT.

SORTR

A new function, Sort Replace (SORTR) automatically does a replace after

sorting a report. A result report is not created.

CMP

A new function, Compare (CMP) performs a line by line match between two
reports. When used manually, if there is a discrepency,the receiving report is
displayed at the first no-match line. In a run RCMP), the line number is
returned in a resulting variable.

TOT
The TOTALIZE function can now do hierdchal subtotaling. Use the parameters
Si thru S5 to identify key sequence. Concatenated keys are also allowed.

DR

The Delete Report function now allows you to use fast access. With the report
to be deleted on display, you can enter DR rb.

Line Roll DR 10B 10B0

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90 MAPCOORD
.abc box factory Corporate. Production B000002
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
`*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.

IP 831224 LS BLACKBOXI 436767 84389 AMCO 831223 831224

IP 831225 LS BLACKBOX1 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOXS 675281 97441 FEDS 840131
END REPORT
Report Titles

When manually creating a new report, with AR or XR, MAPPER now requires a
report title. The title is placed on line 2.

Direct access - To duplicate report 2B in drawer B and call the new report "MY
REPORT".
XR 23,B,MY REPORT

Function request screen -

Duplicate Report

Report 23
Into drawer
Title MY REPORT

Save Report Version (SV)

With the SV function, you can manually save up to 4 reports. When you have
reports saved, they are retrieved using the Fl -F4 keys. Reports are saved until
you call a report processing function or execute a run.

With this function, you can copy reports to another cabinet by saving the
report, using the C function to switch cabinets (not CS, it's a run!), and then
depressing the Fl key to display the saved report. XR or REP would be used to
assign a report ID.
 SV Function

- With report on display, enter SV on the control line

Line SV Roll - 10130

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90 MAPCOORD
.abc box factory Corporate Production 8000002
'*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.

IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224

IP 831225 LS BLACKS= 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKS= 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
..... END REPORT .....

pPaint ilReturri 5 6Tasks 7V iew lOEdit

The report is redisplayed. Note the function key bar. The saved report is now
assigned to Fl.

ine 1 Roll - 1080

.DATE 18 JUL 90 08:07:53 RID lOB 18 JUL 90 MAPCOORD
.abc box factory Corporate Production B000002
t. Status. By. Product . Serial . P roduc . Order . Cust sProduc.Produc . Ship .Ship . Spc .
`*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan *Actual. Date .Order.Cod.
=====. === •
IP 831224 LS BLACKBOX1 436767 84389 AMOD 831223 831224
IP 831225 LS BLACKBOX1 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
..... END REPORT .....

[I. lOB 2 Open 13, Open f4 Open Helpi 10 Quit

 Count function (CNT)

CNT function is a powerful new function with the following features:

- Compute subtotals

- Compute averages

- Compute percentages

- Process accross multiple reports

- no pre-sorting necessary

- Display only specified fields in the result

- Use field rounding parameters

 Compute percentages with Count

Line cnt Roll - 10B0

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90 MAPCOORD
.ABC box factory Corporate Production B000002
*St.Status.By. Product .Serial.Produc.Order.Cust.Produe.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.

IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224

IP 831225 LS BLACKBOX1 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO

..... END REPORT .....

1Resume Finn F-7 FgE2--1 Tasks view . Hel. OEdit

COUNT

Corporate Production

4eSt.Status.By.Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.

*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.
*

** ****** ** ********* ****** ****** ***** **** ****** ****** ****** ***** ***

1
Options Operators/Parameters
A All line types 1-9 Keys A -Z Labels
P Pack result fields Entry Count % Percentage
Rx-y/z Range of reports 4- Subtotal +% Subtotal %
Sn(intv[iminfmax]) Scaling (numeric) x+ Cumuiative x (=4.,%+,++,+%+)
Grand totals / Average <,› Min ,Max
Others: B CID,E F H,IINIO,U,V,WIZ,* I- Std. Dev. !! - Variance
Resu &Int Retur F- 1 7View Help OQuit

Line 1 Roll .RESULT.

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90 MAPCOORD
.ABC box factory Corporate Production
*St.Status.By. Product .Serial.Produc.Order.Cust.Produe.Produe. Ship .Ship .Spc.
'*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Aetual. Date .Order.Cod.
• . ===.1.,= •

AMCO 40.00
ARCO 20.00
FEDS 20.00
INTR 20.00
..... END REPORT .....

Resu ~2Paint p.-- FriFiq

11 5 pTasks 1 t7View Help Undo 10Edit
 Entry counting with CNT

Line cnt Roll - IOW

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90 MAPODORD
.abc box factory Corporate Production B000002
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
mCd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.

IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224

IP 831225 LS BLACKBOX1 436768 84390 AMC) 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
..... END REPORT .....

Resu Paint Tasks View :Hel OEdit

COUNT

,.abc box factory Corporate Production B000002

'*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date ,In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.
*=-..=====-.....,=,=======.====.=====.-,=====,====,======.=_==.=====,=====,==,
** ****** ** ********* ****** ****** ***** **** ****** ****** ****** ***** ***
1

Options Operators/Parameters
A All line types 1-9 Keys A-Z Labels
P Pack result fields Entry Count % Percentage
Rx-yl z Range of reports + Subtotal +% Subtotal %
Sn(intv[/min/max]) Scaling (numeric) x+ Cumulative x (=+,%+,++,+%+)
T Grand totals / Average <,> Min,Max
Others: B CI D,E F Z,* !- Std. Dev. !!- Variance
Resu aint p iRetu View p L0Quit

Line 1 Roll- *RESULT.

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90
.ABC box factory Corporate Production
'*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.
*==,=====.,= ==...==
-- ==.=====.====.======.======.==========.===.

AMCO 2
ARCO 1
FEDS 1
INTR 1
..... END REPORT •••••

•
1Resumel paint Retu View =Help Undo 10Edit
 Send to User function (SNU)

The SNU function allows you to send a report to a user instead of station.

Line SNU Roll - 10B0

.DATE 18 JUL 90 08:07:53 RID 10B 18 JUL 90 MAPCOORD
.abc box factory Corporate Production B000002.
*St.Status.By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.
*-.
IP 831224 LS BLACKBOX1 436767 84389 AMCO 831223 831224
IP 831225 LS BLACKS.= 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
..... END REPORT

iResurmi 2Paint 4Return Tasks iView Heli ,10Edit

SNU Request screen

SNU
Send User
Send to user-id JIMD
Department number 10
Request acknowledgment? N
 New Options

BF F Specifies order of sorted fields

MA E - Do not move blanks from issuing report

Q - Similar to PI but does not even check for sorted status

SS C - Clears the screen

TOT C - Case sensitive on subtotal operation

N - Used with S, Displays 3 blank lines between subtotals and

eliminates grand totals

Fast access now permitted

CAL New commands:

SKIP - Processing on current line terminate

EXIT - Ends calculations. Result contains all lines up to

but not including the data line where the EXIT
condition occurred.
 Report Writer (RPW)

The RPW run is a part of the Application Power Tools (APT) available in
MAPPER Level 35. This run allows a user to interactively create a finished,
professional looking report without any knowledge of run design.

To use RPW, first display the input report.

tine RPW Roll 2B0

.DATE 10 JUL 90 12:26:20 RID 2B 26 FEB 90 ACAS
.@991231 Production Status Report Corporate Production B000002
St S tatus By. Product .Serial.Produc.Order.Cust.Produc.Produc. Ship .Ship .Spc.
*Cd. Date .In. Type .Number. Cost .Numbr.Code. Plan .Actual. Date .Order.Cod.
IP 831224 LS BLACK130X1 436767 84389 AMCO 831223 831224
IP 831225 LS BLACKBOX1 436768 84390 AMCO 831223 831225
IP 831219 LS BLACKBOX2 637071 84353 INTR 831218 831219
OR 840110 LS BLACKBOX4 94754 ARCO
SC 840110 LS BLACKBOX5 675281 97441 FEDS 840131
IP 831222 LS BLACKBOX5 737582 84040 AMC:0 831222 831222
SH 831203 LS BLACKBOXO 746327 54237 FEDS 831201 831202 831203 S8738
SH 831202 LS BLACKBOX6 368061 54438 FEDS 831201 831201 831202 S6937
SH 831209 LS BLACKBOX6 777324 54232 DICO 831207 831208 831209 S8538
SH 831203 LS BLACKBOX6 785367 52833 ARCO 831201 831202 831203 S8934
IP 831216 LS BLACKBOX6 926581 89381 INTR 831215 831216
OR 831210 LS BLACKBOX7 99842 FEDS
OR 831227 LS BLACKBOX7 99725 INTR
SC 840108 LS BLACKBOX7 665481 97541 FEDS '840122
IP 831227 LS BLACKBOX7 733597 84351 AMCO 831227 831227
SH 831202 LS BLACKBOX7 744627 44232 INTR 831201 831201 831202 S8531
IP 831215 LS BLACKBOX7 933581 84381 FEDS 831215 831215
aResumel 12P aint 3 4Return 5 Tasks 17View M1011 .I 10Edit
 The RPW Main menu is displayed

A template is a set of parameters for printing a formatted report. You have

three basic options:

1.Default to the fields and headers from the input report.

2.Enter (create) a new set of parameters

3.Use a stored set of parameters

RPW/Report Writer
RPW Main Menu
The MAPPER Report Writer creates or uses a template
containing the specifications for a formal report.
Select an action below.

Use default template >

Create new template >

Use APT template >RPW-

in application >

Use template report >

2 3 4 7LstAPT Help ;10Quit

 Enter Report Heading

RPW/Report Writer
Report Header
Enter a header for all pages in the report.

Header Text
min .1.A4M1 010400 .111.1 .10

-my report

Header position >c

Underline header? >y.

Transmit >

4Return 5

Report Formatting options

RPW/Report Writer
Page Specifications
Enter values applying to all pages in the report.

Page length >60 Page width >80

Page numbers? >y, Page number position >r

Date format >8 Date position >1
Time? >n
MOM

Transmit >

13Help
 Identify the fields to be printed

RPW Report Writer

Field Selection
Enter a y before fields to be included in the report.
Yes Field Name Yes Field Name
ambei MOIMI011011M!ftWOMP.0. ... 411111.1.111. ONO E.O.faii Milibmlieropuggp

y St Cd Status Date
By In y Product Type
Serial Number Produc Cost
y Order Numbr y Cust Code
Produc Plan Produc Actual
Ship Date Ship Order
Spc Cod

Transmit >

4Returri Hel 10

You may create additional fields in the result to contain crossfooted totals

RPW/Report Writer
Field Addition
Enter name and size for each field you want to add to the report.
Additional Field Names Size
4100.1.110!..1.4=01.41.0400WIMOINWOMAiMMOMM.10111111.1.11.1.1110....

Total characters in the report

cannot exceed the page width
value.

Page Width ............ 80

Total characters ........ 25

Available characters .... 55

Transmit >

44Return lE3Help 10
 You can request the field order in the finished report

RPW/Report Writer
Field Sequence
Change sequence numbers as desired.

Field Name Seq Field Name Seq

St Cd 1 Product Type 2
Order Numbr 3 Cust Code 4

Transmit >

kiReturn, Help 10

RPW/Report Writer
Field Sequence
Change sequence numbers as desired.

Field Name Seq Field Name Seq

MIMEO WMWAD.....MWM.W.P.W .10400

St Cd 4 Product Type
Order Numbr Cust Code 2

Transmit >

14Return i3Help
 Enter field heading specifications

RPW/Report Writer
Field Headings Layout
Enter features of headings.

Lines in heading >2

Text alignment >c

Next line indicator >

Underline field headings? >y

Underline character >=

Underline start position >h

Transmit here >

I4Returni pHelp 10
 You can change the field headings

RPW/Report Writer
Field Heading Text
Enter text changes here. Next Line character is to n 41.111.

Chars/Line Lines Field Heading Text

015 2 Order Numbr

014 2 Cust Code
019 2 Product Type
012 2 St Cd

Transmit >

4Returm Help .10

RPW/Report Writer
Field Heading Text
Enter text changes here. Next Line character is " ".

Chars/Line Lines Field Heading Text

0110,401114M, mm......P.WAOIM!WIONAMWiMMPWWOWMMOW.W.W.WNWO.WMWOAMOOWNIWWM...WWW.M.W.W.M.o.bwlmPOM.m.OAWOOm

015 2 Order Number

014 2 Customer code
019 2 Product TYpe
012 2 St Cd

Transmit >

4Returri Bile1p
 You can sort the report lines by up to 5 fields

RPW/Report Writer
Sort Sequence
Enter a sort order number and parameter where desired.

Field Name Sort Field Name Sort

...M.IMWIWWIPIWMWXIW..A4WWIII.M.W.WOWWW.W.W.PWIN!..IWWWWIOWWIWMMI,MWOWIPAOWIIWWIWXOI.MW .1011.01M.11. ......n.............W.w.u.VOMPA.W.M.WAWWII.m.m.gWMWmwwdrmpaftoiMmgiftomilmmomaombmgrAIWWImmww

Order Numbr Cust Code

Product Type St Cd

Transmit >

4Return Help 10

RPW/Report, Writer
Sort Sequence
Enter a sort order number and parameter where desired.

Field Name Sort Field Name Sort

.....0.110.0.1.0.11111.11.1111011041.1.011041111111.1.0.1.1.0.411111.11.41011.1.1.i

Order Numbr Cust Code 1

Product Type St Cd

Transmit >

4Returry pHelp
 You can request subtotaling of any field(s)

RPW/Report Writer
Subtotals
Codes are: k = key field, v = values field.
Justification > (c/l/r/x/z Rounding > (e.g. .01, 1, 100)
Field Name Code Field Name Code
MINIMMEMOMM.0 000

Order Numbr Cust Code

Product Type St Cd

Repeat this function? >n Transmit >

You can request a new page if the contents of a field changes

RPW/Report Writer
Print Breaks
Enter break code for each field as wanted. b/f/p/s)
Field Name Code Field Name Code
4011m is.01,11,004 amomm.00.nem Il04 6.4104 1mm •••1..• iir

Order Numbr Cust Code

Product Type St Cd

Transmit >

4Returri ellelP

2-17
 You can create grand totals or averages of any field(s)

RPW/Report Writer
Grand Totals
Codes are: g = grand, a = average, 1 = lowest, h = highest.
Justification > (c/l/r/x/z) Rounding > (e.g. .01, 1, 100)
Field Name Code Field Name Code
.m.0011100 0.110.111.14010.0110411W.WW11.10.4,00.0400.110.11,01M4MO

Order Numbr Cust Code

Product Type St Cd

Line count? >n Repeat this function? >n Transmit >

4Returri 10
You can generate the completed report as a result, or save your parameters
(template) for future use. The template could also be registered in the APT data
dictionary.

RPW/Report Writer
Template Control
Tab to action and transmit.

Generate the formal report

Change the report definitions 01111M

Save the template

Register the template in APT >

Return to Main Menu >

BHel.p ,10Quit
 This is the result when you select "Generate the finished report".

This is the formal report. Use a function key to print

.EJECT
JULY 23/ 1990 Page 1
my report
gopiiMeribasarm.r...roomor

Order Customer Product St

Nurrber code Type Cd
===========

84389 AMCO BLACKBOX1 IP

84390 AMCO BLACKBOX1 IP
54682 AMCO GREENBOX7 SH
64231 AMCO BLACKBOX9 SH
84351 AMCO BLACKBOX7 IP
84040 AMCO BLACKBOX5 IP
99943 AMCO GREENBOXS SC
99951 AMCO GREENBOX9 OR
98755 AMCO BLACKBOX9 OR
52833 ARCO BLACKBOX6 SH
94754 ARCO BLACKBOX4 OR
96652 ARCO GREENBOX4 OR
99753 DICO GREENBOX5 OR
1Resumei 12.Paint 4Returni 5PrtSys 7PrtAux BHelP ).0Quit
MODULE 3

Run Design
Module 3 Run functions

Upon completion of this module, you will be able to:

Use the :Define and :Include statements

- Access new reserved words in MAPPER runs

Use the Call and Return statements

Use run variables as arrays

3-0
 New Reserved Words

Name Size Description

AREA$ Al2 Named area

ASPECT$ Al2 Aspect ratio (used with graphics)

AXDRW$ H1 Alphabetic drawer of the erring run

CERR$ 16 System message number of the previous error, same as XERR$

COLOR$ • Il Color terminal flag, nonzero - has color display

FCAB$ 14 Cabinet number of the Screen Control form on display

FDRW$ 16 Drawer number of the Screen Control form on display

FIELD$ 14 Relative input field number in which the cursor is located

FRPT$ 14 Report number of the Screen Control form on display

GRAPH$ I1 Graphics terminal flag, if not 0 - can not display graphics

HLINES$ 12 Number of held lines

LNKDRW$ 16 Drawer of the run that issued the LNK statement

LNKRPT$ 14 Report number of the run that issued the LNK statement

LCAB$ 14 Cabinet number of user's currently selected language

MAXCAB$ 14 Maximum cabinet number on your MAPPER system

MAXRPT$ 14 Maximum report number on your MAPPER system

SYSNAM$ h5 Port identification name (for example,

MAPPER 1100 = M1100, U Series 6050 = U6050)
 Changes to L34 functions

- String variable size & access

The maximum size of a string variable has been increased to 256

characters

String variables can be used in an @IF statement without sub-

referencing.

- start in any column

The @WRL statement can now start in any column.

-• DFU 10 reports

You can now lock up to 10 reports for deferred updating.

 New Run Statements

CALL Subroutine call

RETURN Return from a called subroutine

DSX Display report and exit

FISH Number generator

ITV Input variable

LDA Load array variable

OUV Output variable to terminal

:DEFINE Define constant

:INCLUDE Include constant

@CALL

The @CALL function executes an internal or external subroutine, starting

at the specified label. The only parameters (variables or literals) passed to
the subroutine are those listed on the function statement. The current result is
automatically passed, but renamed results are not passed. Renamed results will
be intact on return.

@LDVV1I2=1,V10I3=100.
@CALL,48,E,11 01 (vi) .
@SRH,O,B,2 D 2-2 ,SH .

In the subroutine, the passed parameters are loaded into the variables
identified on the label statement. If the parameter is a variable, the
corresponding variable will be initialized to agree with the passed variable.

* SUBROUTINE FOR AL2816

€101.(15)
@INC f lO V5 .
@LIN V.10H3=ABC .
@RETURN .

@RETURN
The @RETURN statement passes control back to the calling run. In the
example above, Vi was passed to the subroutine and picked up as VS. After
executing the @RETURN, Vi was reinitialized to the contents of V5. Any renamed
results or variables created in the subroutine will not be passed back. The
current result is always passed.

3-4
 Display report and exit (DSX)

The @DSX function displays a report and automatically exits the run.

- Load Variable Array (LDA)

The @LDA function defines a variable as an array and loads data into the
array. The RCR must be full character set (F-Se or FCSU). An array cannot be
redefined. Pcs
@LDA[10] nametypesize[n]=v1d[,v1d,...,vid]

LDA Options

C Centers data within each variable.

L Left-justifies the data within each variable.
P Packs data into each variable
R Right-justifies the data within each variable.
U Converts all lowercase alphabetic characters to
uppercase
W Loads variables with the values of reserved words.
Z Zero fills each variable after the data is loaded.

* RUNID-AL2816

@LDV V10H3=ABC .
@LDA V1H3[3]=V10,DEF,GHI
@GTO END .

The following run sets up a 2 member variable.

The user executes the run be entering AL2816,ABC,SH

* RUNID=AL2816 * 48,e,11

Alda v1h3[2] @Ol (V5 ) .

Ochg input$ v1[1],v1[2] . @SRH,4,B,2 2-2 ,V5 .
@IF V1[1] = ABC CALL148,E,11 01 (V1[2]) . @RETURN
ODSX,-0 .
- Hash (HSH)

The @HSH function is similar to @LDV,N. The function was included in Level 35
to conform with the C MAPPER on other systems.

@HSH v=vld, min-max

- Output Variable (OUV)

The @OUV statement displays literal data or the contents of a

variable, constant, or reserved word at a specific location on the screen.

@OUV[isclicol] vld

Input Variable (ITV)

The @ITV statement captures input from an OUV or interim OUT

display. The data to be loaded must be delimited by tab characters in the OUV
display. The length of each data input is determined by the tab delimiter, the
length of the variable, or the width of the run user's terminal.

@IT\T[ lab] v[,v,...,v] .

This example captures input from an OUT statement:

*_
@BRK .
PRODUCT:I
DESCRIPTION:I
@BRK OUT,-0,2,3,1,11 Y,Y
@1TV,010 <PRODUCT>S10,<DESC>S10

(OTHER PROCESSING)

. RESPOND TO FUNCTION KEY

@IF FKEY$ = 1,(020),4030) .

This example captures input from an OUV display:

*____________
@OUV,1,15 'WHAT IS THE PASSWORD?'1
@ITV <PASSWORD>S6 .

3-6
- DEFINE

The Define Constant (:DEFINE) statement is used to define values for any of
the fields and subfields in a run statement, including items such as the
following:

- Labels (for example, @0100

- Run function calls (for example, SRH)
- Location of the database (c,d,r)
- Fields to process (cc)
- Function parameters (p)
- Output area data
- Variable names

:DEFINE constant value

48,E,3

:DEFINE STATOODE V1132

@CHG INPUTS STATCODE
@SRH,O,B,2 D 2-2 (,STATOODE .
@DSX,-0 .

Rules for using :DEFINE .

- One constant per :DEFINE statement

- All :DEFINE statements must be at the beginning
of the RCR
- Use the BLT function before putting the run into
production. BLT converts the defined constants for
more efficient processing

- INCLUDE
The Include Report (:INCLUDE) statement adds all defined constants from
another report to your current run.

:INCLUDE,c,d[,r] .

:INCLUDE,48,E,3 .
091DR,110,B,2 " E,STATCODE
.

3-7
MODULE 4

Screen
Control
Module 4 Screen control

Upon completion of this module, you will be able to:

- Use the level 35 forms coding

- Code function key bars for run displays

- Write context help text

- Use the AREA & DFLD commands in SC

4-0
Forms

A form is a set of SC commands stored in a separate report. With a form, you

can use the DFLD, AREA, DSPFORM and FKEY commands in Screen Control.

Define field (DFLD) command

The DFLD command defines field characteristics for later use by the AREA
command, except screen location and field size. A maximum of 40 named and 40
unnamed fields can be defined. Field definitions may be referenced multiple
times in an area. After processing the AREA command, all definitions are
discarded.

DFLD[inamelopt,attr,text]

AREA command

The AREA command describes an entire region (AREA) of a screen, including

both text and fields. Like the DATA command, the contents of the area is defined
immediately following the AREA command.

AREA[name,row,col,rsiz i csiz,opt attr]

This example shows report 11E, which contains SC commands to display a screen
that asks for a customer code. The RCR report uses Input$ to get VI and use it
as a search parameter.

Report 48,E,11 RCR

PREP, CPR) @SC,48,E111,,,1 "

DFLD CaCEIG INPUT$
AREA, (PR) MB 0,13,2 D 45-4 # 11K1 DSX -0 .

CUSTOMER CODE
TRANSMIT
 Function Key programming

The FKEY command in @SC lets you define a function key bar at the bottom of a
screen.

FKEY n , title / action

This example defines F9 as the EXIT key:

FKEY/9,EXIT,

Here we have the same run from the previous page with function key
definitions included.

PREP , (PR ) 019Cr48,E#11,,,1 •' .

FEY, 2, RESUME, RSM. @CHG INPUTS V1H4
Fpr ,10,E CTIT RII 0 B 2 D 45-4 ,V1 DSX
DFLD , (TS )
MA, '10,20,4,30, (PR)

CUSTOMER CODE 41M1111111111111111.MINNIMP

TRANSMIT
 Context Help

SC has 2 new commands that allow you to code HELP displays for individual
input fields on a screen. It is utilized on all the function request screens in
level 35.

HELP

DSPFORM

HELP

To code HELP for an individual field, after the END command, use the HELP
command to identify the referenced field and the screen row where the text that
follows the HELP is to be displayed. The I character on the first HELP command
determines the width of the HELP window.

PREP;
?KEY , 3 , EXIT , "
F'KEY ,1, RESUME RSM
MY 16 'QUIT X
PREY, 8 'HELP DSPRELP
DFLD (TS ,AI
AREA, 40,20,4,30, , (PR)

CUSTOMER CODE
TRANSMIT

END
HELP,1 15
Enter the customer code
that you're looking for

ELP,2 15
Depress the TRANSMIT key
 Displaying forms

The @DSF function can be used in a run to display a form.

@DSF,c,d,r,pn,tabp,opt .

Use the DSPFORM command to display a different SC form when a function key
is depressed.

DSPFORMI r CDC pn tabp , opt

4E

PREP
FKEY , 2 , RETURN , DSPFORM , 11
eKEY,10,QUIT,
'AREA, ,3 ,3 ,9, 80,, (PR)

.111mmilk 0111.1.11.11110 0111.010411111.1•411110 11.11m011.10111.0001.00.10.011.1.60.00.01,

THIS RUN DISPLAYS ALL THE OPEN ORDERS

FOR A SPECIFIED CUSTOMER

wimmovammimm.w omarilmomp orm.m 0111.m. .oOwwmomwi.rmomsmsepiwombmmed kf iam..rommo

END

m SUBROUTINE FOR AL2816 lIE

PREP
FKEY , 3 , EXIT , A
FKEY , 4 , INFO , DSPFORM 1 4
FKEY ,1, RESUME RSM
FKEY , 6 ,QUIT , X
FKEY , 8 , HELP , DSPHELP
(TS AI )
AREA, ,10, 20 ,4 1 30, (PR)

CUSTOMER CODE emassormins.sat

TRANSMIT

END
iELP,1 15
ENTER THE CUSTOMER CODE
THAT YOU "RE LOOKING FOR
 CUSTOMER CODE
TRANSMIT

ENTER TELE 03STOMER amE

THAT YOURE LOOKING FOR

ilt1:4„N lo:, 3EXIT la, ;on NUIT

4-5
 Forms Return Stack

When you use the DSPFORM command, a stack of forms is built in the order in
which they are displayed. A stack can hold up to 20 forms.

The opt subfield on DSPFORM allows you to mark the form for any future
FORMRET action.

OPT

- Puts the form on top of the stack

1 - Clears the stack, and puts this form on the bottom

2 - Marks the stack, and puts this form on top

4 - Do not put this form on the stack

5 - Overwrites the current entry on the stack

To retrieve a form from the stack, use the FORMRET command

FORMRET,command

commands

0 - Returns to the previous display

1 - Returns to the start of the stack and clears the stack

2 - Returns to a mark previously set by a DSPFORM using

option 2.
4 - Returns to the top entry on the stack

5 - If there is a report on display, repaints the report

before displaying retrieved form
MODULE 5

Coordination
Module 5 Coordination features

Upon completion of this module, you will be able to:

- Register a user for level 35 features

- Register a mapper run using new look features

- Implement new cabinet security features

- Use new coordination functions and runs

5-0
 COORDINATION CABINETS

----------- FILE CABINET - MODE 0/1 DRAWER - TYPE

.F. FORM TYPE . FORM .F. FORM TYPE FORM .
.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .

B PRODUCTION STATUS 000002 F DEMO RUN FUNCTIONS FCS 000012

C FACTOR BASE 000004 G DEMO FREE FORM DATA 000014
D ORDER STATUS 000006 H WORD PROCESSING REPORTS 000016
E DEMO RUN FUNCTIONS LCS 000010 I EXPERIMENTAL REPORTS 000020

----- FILE CABINET - MODE 202/203 DRAWER - TYPE

FORM TYPE FORM .F. FORM TYPE . FORM .
.D . DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
.r . •

B OPEN 003122 F OPEN 003132

C NETWORK CONFIGURATION 003124 G DRAWER PERMISSIONS 003134
D OPEN 003126 H OPEN 003136
E OPEN 003130 I OPEN 003140

FILE CABINET - MODE 204/205 DRAWER - TYPE

.F. FORM TYPE FORM .F. FORM TYPE . FORM .
.D. DESCRIPTION . TYPE .D. DESCRIPTION • TYPE .
•
B OPEN 003142 F GRAPHICS DLL CODE 003152
C OPEN 003144 G GRAPHICS EXAMPLES 003154
D OPEN 003146 H GRAPHICS HELP 003156
E OPEN 003150 I GRAPHICS RUNS 003160

011.0.01111.116•1111
FILE CABINET - MODE 206/207 DRAWER - TYPE
.F. FORM TYPE FORM .F. FORM TYPE .FORM .
.D. DESCRIPTION TYPE .D. DESCRIPTION .TYPE .
MO
•

B OPEN 003162 F CHARACTER/TRANSLATIONS 003172

C OPEN 003164 G OPEN 003174
D ERROR MESSAGE HELP 003166 H FUNCTION REQUEST MESSAGE 003176
E ONLINE DOC FOR 35R1 003170 I OPEN 003200

----------- FILE CABINET - MODE 208/209 DRAWER - TYPE

.F. FORM TYPE . FORM .F. FORM TYPE . FORM .
.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE •
OMMUMMMO.MMO MIMO.M.M...OWMMMOMWOMOMOAO.00MMOMMWMUMMOMOWIO==== ======
= 0 • • 0 0

B BPORT/BACKGROUND LOG 003202 F RUNLOG RUNS/RUNSTREAMS 003212

C RETRID/CPYRID DATA 003204 G MODE SWITCH REGISTRATION 003214
D RUNLOG DATA 003206 H RUNLOGSUM DATA 003216
E PRIMER/KILLER DATA 003210 I MAPSTAT INFORMATION 003220

5-1
 FILE CABINET - MODE 212/213 DRAWER - TYPE -----------
.F. FORM TYPE . FORM .F. FORM TYPE . FORM
.D. DESCRIPTION . TYPE .D. DESCRIPTION • TYPE .
• •

B SEND-USER REPORT QUEUE 003242 F OPEN 003252

C OPEN 003244 G OPEN 003254
D OPEN 003246 H OPEN 003256
E OPEN 003250 I OPEN 003260

----------- FILE CABINET - MODE 214/215 DRAWER - TYPE 011110011100110.001011114M011....WWWAVIWIMP

.F. FORM TYPE . FORM .F. FORM TYPE . FORM

.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
.r• • . • ---====.======.
B APT DATA DICTIONARY 003262 F OPEN 003272
C APT APPLICATION DIRECTOR 003264 G RPW MAPPER REPORT WRITER 003274
D APT RUNS 003266 H RDI ADMINISTRATION REPOR 003276
E APT DOCUMENTATION 003270 I RDI RUN CONTROL REPORTS 003300

FILE CABINET - MODE 216/217 DRAWER - TYPE

ammotompammoommoomberommem....

.F. FORM TYPE . FORM .F. FORM TYPE .FORM .

.D. DESCRIPTION . TYPE .D. DESCRIPTION TYPE
=======
• ==== • =
•
==1
00.1.01.1,01.00111.011.1mi
. 41011.00.1104110,.....=

B COMMUNICATION ERROR LIST 003302 F RUN REGISTRATION 003312

C CONFIGURATION 003304 G OPEN 003314
D CURRENT SYSTEM STATUS 003306 H OPEN 003316
E LOG LIST 003310 I OPEN 003320

----------- FILE CABINET - MODE 218/219 DRAWER - TYPE .11110011•41.10.11P .11P.1111.1.10 .1111.1111.

.F. FORM TYPE . FORM *F. FORM TYPE .FORM .

.D. DESCRIPTION . TYPE .D. DESCRIPTION .TYPE .
==iro 401 0 rid P....

B SYSTEM CONFIGURATION 003322 F USER REGISTRATION 003332

C ALARM MESSAGE QUEUE 003324 G OPEN 003334
D STATION MESSAGE QUEUE 003326 H SYSTEM PURGE INDEX 003336
E RUN REGISTRATION 003330 I AUX DEVICE QUEUE 003340

FILE CABINET - MODE 220/221 DRAWER TYPE

.F. FORM TYPE . FORM .F. FORM TYPE . FORM .
.D. DESCRIPTION •TYPE .D. DESCRIPTION . TYPE .
• "".. . • .
B COMM CURRENT STATUS 003342 F OPEN 003352
C OPEN 003344 G LOG SUMMARY 003354
D COMM ERROR LIST 003346 H LOG LIST 003356
E PRE-DEFINED PRINT FORMS 003350 I COMM ERROR SUMMARY 003360
 FILE CABINET — MODE 222/223 DRAWER — TYPE
allIMIN.1111/.1111i .
1.111.10.11•11..011.111011,

.F. FORM TYPE . FORM .F. FORM TYPE . FORM .

.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
. = . ----- ---------=== a .—.-7-.-......==— a — a ---...— --====a =-
----=a
B OPEN 003362 F OPEN 003372
C OPEN 003364 G OPEN 003374
D AUDIT TRAIL CONFIG 003366 H OPEN 003376
E DTM INTERFACE CONFIG 003370 I OPEN 003400

----- FILE CABINET — MODE 224/225 DRAWER — TYPE

.F. FORM TYPE . FORM .F. FORM TYPE . FORM
.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
B OPEN 003402 F OPEN 003412
C OPEN 003404 G OPEN 003414
D OPEN 003406 H OPEN 003416
E MAPPER RELEASE INDEX 003410 I OPEN 003420

41•11.110111111.1•11.11111111.11.....
FILE CABINET — MODE 226/227 DRAWER — TYPE ------—
.F. FORM TYPE . FORM .F. FORM TYPE . FORM
D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
a =a ------------------------a ======.=a ========================.======.
B USER UTILITIES 003422 F DTM UTILITIES 003432
C COORDINATION UTILITIES 003424 G OPEN 003434
D EXAMPLE UTILITIES 003426 H OPEN 003436
E SYSTEM UTILITIES 003430 I OPEN 003440

on1111 411.111.0.411111111MINMAINIP
--- FILE CABINET — MODE 228/229 DRAWER — TYPE 41■11.1.11.11M.I.1141M0.10141.1110.!

.F. FORM TYPE . FORM .F. FORM TYPE FORM .

.D. DESCRIPTION a TYPE .D. DESCRIPTION . TYPE .

B OPEN 003442 F RUN FUNCTION DATA 003452

C OPEN 003444 G QUESTIONS & ANSWERS 003454
D OPEN 003446 H EXAM RUN LOG 003456
E OPEN 003450 I EXAM ASSIGNMENTS 003460

------- FILE CABINET — MODE 230/231 DRAWER — TYPE -----------

.F. FORM TYPE . FORM .F. FORM TYPE . FORM .
.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
.=.--------7-----
B OPEN 003462 F OPEN 003472
C TYPE ANALYSIS 003464 G OPEN 003474
D OPEN 003466 H OPEN 003476
E OPEN 003470 I OPEN 003500
 FILE CABINET - MODE 232/233 DRAWER - TYPE .1110.111111.M.W!...001WOMPOIMOM.1111

.F. FORM TYPE . FORM FORM TYPE .FORM .

.D. DESCRIPTION . TYPE .D. DESCRIPTION .TYPE .
===== === = •

B ONLINE HELP AND RUNWARE 003502 F OPEN 003512

C OPEN 003504 G OPEN 003514
D OPEN 003506 H OPEN 003516
E OPEN 003510 I OPEN 003520

FILE CABINET - MODE 234/235 DRAWER - TYPE #11.0i4M0.11.0110.11.0111.1110.01.010411110

.F. FORM TYPE . FORM .F. FORM TYPE . FORM .

.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
.
B OPEN 003522 F OPEN 003532
C RPG STATISTICS LOG 003524 G OPEN 003534
D OPEN 003526 H OPEN 003536
E OPEN 003530 I OPEN 003540

FILE CABINET - MODE 240/241 DRAWER - TYPE aillim.10.1M0111.11110.10104.1=4100.0.0.0.110

.F. FORM TYPE FORM .F. FORM TYPE .FORM

.D. DESCRIPTION TYPE .D. DESCRIPTION .TYPE .
.0.6.1.001100.141010.110.1110....0 010=====
wrr

B SYSTEM MESSAGES - 34RI 003602 F OPEN 003612

C OPEN 003604 G OPEN 003614
D OPEN 003606 H OPEN 003616
E OPEN 003610 I OPEN 003620

FILE CABINET - MODE 244/245 DRAWER - TYPE 01111111.11111.4110116

.F. FORM TYPE . FORM .F. FORM TYPE . FORM .

.D. DESCRIPTION . TYPE .D. DESCRIPTION . TYPE .
--.======.
B SYSTEM MESSAGES - 35R1 003642 F OPEN 003652
C OPEN 003644 G OPEN 003654
D OPEN 003646 H OPEN 003656
E OPEN 003650 I OPEN 003660
 User registration

New columns utilized in the user registration report

---------------------USER RESTRICrIONS--
MSSDUDPPCDADRITSADFCCPPSSSEAXSOMMVRRRCACCLLBEDAALCSSORRSCC DTR UDC W LEA.
.0RUEPSRCAPDLENORQSNOERtTrYTABXXPCUEEPPLUMNGGFNADDOHETKUNQEEWCSSLPPZLL.
.INDLDPTHLRRRPOrTMCDRNGRASRBTXXRHDRTMWLXPTSLNCTOTCGNSMNEQSL NSI OLY R E.
X II Keyins from MAPPER
X Compare function
X Count function

Run registration

There are additional columns added to the end of the run registration line
for level 35 New Look.

MODES . ACT RESPONSIBLE.M.Sr. RES .1MDW.

reserved for future use XXXXX XX

Should control lines be displayed like 34R1? X Y=Yes (Default)
N=NO
MMAYBE
Should run be accessible from RUNS menu? Y=YES
N=NO (Default)
Does this report contain only @SC Commands? X Y=Yes
N=NO (Default)

FKEY usage in Screen Control is the key for old/new look registration.
Creating a Run Registration Report

continued

Field Description

D Y, N, or M (mode). Default = Y. Enter N if the run control

report contains the Screen Control run commands of level
35R1 and above (FKEY, PD, named areas, AREAS, or FIELDS).
Enter Y or M only if the run control report does not contain the
Screen Control run commands of level 35R1 and above. Enter
M to make the run adapt itself to the current mode of the user.
For users using the user interface of 35R1 and above, entering
M displays the system default function key bar with every
display function.

N Y or N. Default = N. Enter Y if you want the run accessible

from the Runs function key. Entering a Y implies that the run
does not need input on a run call or a report on display when
executed.

F Y or N. Default = N. Enter a Y if this is a report containing only

Screen Control commands and you want to register it like a
run.

Minimum Field The minimum fields requiring input for registering a run are the
Requirements Runid, the Type, and the Rid fields.

4-12 7831 9415-000

 Security

The MS (Mode Switch) run is now also available as CS (Cabinet Switch). Report
2G in cabinet 208 is still the controlling report for both runs. In 2G, you may
now list a range of cabinets (eg. 2-4 instead of 2,3,4)

With the signon screen displayed, a user can depress Fl(REPORTS) to list
those Drawers that can be accessed. In order for a Drawer to appear in that
list, it must be registered in report 11G of Cabinet 202.

When access rights have been granted to a department with registration in

11G, a user can access a report without switching to the report's cabinet.

fine 1 Roll 2
.DATE 19 JUL 90 09:30:57 RID IIG 20 APR 90
-.Drawer Permissions registration (RELEASE) Cabinet/Drawer Permissions G003134
* . DRAWER . RESERVED .000000000000000000000000
. AND • FOR .000000000111111111122222
Arun. DRAWER NAME . CABINET . FUTURE USE .123456789012345678901234
•
Free Form AO W w
Production Status BO R w
Factor Base CO
Order Status DO
Demo Run Functions LCS EO
Demo Run Functions FCS FO
Demo Free Form Data GO R w
Word Processing Reports HO
Experimental Reports IO
..... END REPORT .....

User departments are listed, starting in column 57:

o Blank - No list or non-switch access
oW - List and non-switch write capability
oR - List, but only read on non-switch access

5-6
 SYSTEM function

The SYSTEM function displays active stations and users.

Line 1 Roll- .RESULT„.

.DATE
.CURRENT SYSTEM STATISTICS
• USER .DEPT. MAPPER . STA START . RUN
TYPE • ID . NO . FUNCTION . NUM TIME .NAME
ACTIVE USER OPERATOR 0 II-OPERATOR 99999 00:00:00
INACTIVE USER 7 NEW-LOOK 13770 07:12:55
ACTIVE USER WEPRWR 100 NEW-LOOK 13274 09:06:46
INACTIVE USER 7 NEW-LOOK 11400 09:28:25
INACTIVE USER 7 NEW-LOOK 11637 09:26:25
ACTIVE USER * MAPCOORD 104 SYS-STATUS 13746 10:01:23
ACTIVE USER WEPRWR 100 DISPLAY 13772 10:01:15
..... END REPORT .....

KILL run
The KILL run is the level 35 equivalent of STOP. Use the SYSTEM function to
locate the run name and station number of the run you want to terminate.

Kill Run or Function

Run name
Station
User-id
Dept #
 DISPATCHER Activity Log Report

Report 73 in cabinet 208 records all runs scheduled by DISPATCHER. If a run

is scheduled for multiple executions by minutes, then only 1 entry is written
and updated with every execution.

Line]. Roll- 73208

p. DATE 10:15:01 RID 73 24 JUL 90 MAPPER
.SCHEDULED RUN LOGGING: 'DISPATCHER 3003202
. SCH . . START.STRT. END .END .ACTIVE . ERROR.
nk RUN NAME USER .DEPN. STA .INTV. DATE .TIME. DATE .TIME.MINUTES. CODE .
ALARMCHECK MAPPER 104 1 5 900724 1015
RPG DARV 1 10400 D 900713 0020 900713 0021 0
RPG DARV 1 10400 D 900712 1348 900712 1349
..... END REPORT .....
 INITIALIZE Run

The INITIALIZE run records system Initialization activity. There are two
registrations of this run.

Background. Schedule INITIALIZE to be executed when the MAPPER

system is initialized. This will cause the operator to be asked at MAPPER
system start-up for a reason for the start-up. The operator's response is logged
in report 9B in cabinet 208, along with the date and time.

- Foreground. Displays the initialization log (9B208) at the

terminal. Used to look at the log.

cine 1 Roll - 913208

.DATE 15:54:37 RID 9B 22 JUN 90 DARV
*MAPPER INITIALIZATION LOGGING: 'INITIALIZE' B003202

'* DATE . TIME . LEVEL REASON FROM OPERATOR

•

900720 07:54:26 35.1.0 PURGE

..... END REPORT

 QUEKILL Run

The QUEKILL run will analyze your Message and AUX Queue for Reports that are
at least 20 days old. These RIDs will be scheduled for deletion when they are
21 days old.

QUEKILL should be registered as a scheduled background run to execute shortly

after midnight everyday. You should also make sure that the START Parameter
"TYPPRG" does not have an entry for either the MESSAGE type (003326) or AUX type
(003340).

QUEKILL result

Line 1 Roll - ,.RESULT„

.DATE 24 JUL 90 10:33:45 REPORT GENERATION MAPCOORD
. .mompompaimmompow.m.sormsrumormilimmwelmomemammiMbom......Dommimommwmol.M.M.M0111.0.m..01.10.111.0 011001041011.0.....mo.00010414M.mwrimimporammipm040.00.1.40,41.0.00.0.0.

• Summary of MESSAGE RIDs Scheduled for Deletion •

• mmpadommm....m.mmpomoam0.0s..POI. .IIMWMmWm. 10opmmummllWuimmdmowmiwmip.W.swOWWA.W.slmodmpmmapmmmmmomoomdnwamprwm.ug'a...amrm..........m...muwamomb .

• . • . SEND . FROM .FROM. TO .DAYS. DELETION .

*QUE. RID. LINES. DATE . USER .STAT. STAT. OLD. DATE .
a === a a ...a.=a ========= a ==== a =r,

MSG 1 70 28 JUN 90 CCM 11409 605 26 20 JUL 90

MSG 6 159 11 JUL 90 SUE 10774 605 13 02 AUG 90
MSG 9 13 12 JUL 90 MAPPER 99996 605 12 03 AUG 90
MSG 12 20 12 JUL 90 DARV 99997 605 12 03 AUG 90
MSG 14 53 24 JUL 90 MAPCOORD 13746 605 0 15 AUG 90
.ftwmWm.dmmm.pmbmwpmwesmwmpowrammmpimpm*mmoOoWemmilmwmwrmw.auimmuwowprmwoommmmamomwomwmwmwomosmwwmmmmrwo.wmwmowuo.mpwwwowmmrs..wmmmmwimmmmm.mmowm.o.mwmmmmsmop 4.04.1.011111.41.01M.

• Summary of AUX RIDs Scheduled for Deletion •

.
41106.1.041100111.000.01.4110....110.1111411....41.0111.11104.111.11W

* . . SEND FROM . FROM. TO .DAYS. DELETION .

*211E. RID. LINES. DATE . USER . STAT. STAT. OLD. DATE .
*.111.010,110...0 a a a 411111110.1.11.111...IIM.0011.1.1..01.Thi
=====.=====.===.======

AUX 1 143 01 JUL 90 MARK 505 505 22 23 JUL 90

..... END REPORT

MODULE 6

Configuration
and
Installation
Module 6 Installation and Configuration

Module Objectives

Upon completion of this module,you will be able to:

- Configure L35 start parameters

- Configure and new recovery environment.

- Run database conversion utilities

6-0
 New files

TRMFIL - Mass storage file used to save station tables.

- Station table save (includes AtJX device)

- Forms stack

- Mode registration

- Type access permissions

- Screen attribute table

- Configured with TPOS parameter

AUDHST - Audit History file.

- Mass storage file used to control the recovery function.

- Configured with MAPFIL parameter

- Should be duplexed

MAPPER will keep a history of audit trail files in a history log. This mass
storage file should be assigned with the MAPFIL AUDHST parameter, and be unique
for each MAPPER if there are multiple MAPPERS on your system. This file is used
when the MAPPER system has to be recovered from the Audit Trail file(s). With
this file, the operator is told which tape to mount next. If Disk files are
interleaved with tape, the history log file controls the proper sequence for
reloading. If a history log file is not assigned, MAPPER will use INDFIL or
MAPERO, but these files are susceptible to destruction at PURGE time. It is
suggested that this file be placed on removeables, preferably not cached and
duplexed for security.
 New Banks

DPOOL - Inactive D-Bank storage

-Optional
-Stores suspended function D-banks instead of writing
them to mass storage.
-Dynamically acquires banks with fixed block sizes
- Configured as DPOOL
-0 disables caching
-1 automatic sizing (1500 words per active station)
-50K to 4M words
-Start with 100K, adjust for 2-5% queing
-Monitor with CSS function

RIDTABLES - RID tables

-Moved from Common memory pool (FPOOL)
-Configured as RPOOL (13.5K to 200K words)
-Start with 20K, then monitor
- Monitor with CSS or RP functions

CSSIC

Line 1 Roll - ARESULT.

.DATE 14:09:21 RID 25 JUL 90 MAPCOORD
.CURRENT SYSTEM STATISTICS: 14:09:21 PERIOD: 14:05:00 TERM 02:22:48
PRD PRD PRD . PRD .TERM .TERM TERM .TERM .
• TYPE SIZE . CUR . AVG . MAX . RATE . QUE . AVG . MAX . RATE . QUE
* ======= ==== ==== === = =IS = ==== =`..
..= •

PCT-ACTIVE 18432 29.19 28.62 29.19 28.62 31.97

CPOOL -ACTIVE 60000 0.00 0.01 3.34 0.03 8.54
MPOOL -ACTIVE 136440 0.00 0.10 17.39 0.11 26.74
MBANK-ACTIVE 4 25.00 27.83 50.00 28.28 50.00
CORE-REQUEST 0.6820 1.12 0.7531 0.96
RPOOL-ACTIVE 20000 90.16 90.16 90.16 0.0000 0.00 90.81 98.83 0.0097 0.00
DPOOL-ACTIVE 0 0.00 0.00 0.00 0.0000 0.00 0.00 0.00 0.0000 0.00
END REPORT ... .
 New Banks

TABLES - Pre-run tables

-50 tables, 31 words per table

- Contains pre-run tables
-Used only if run registration report is sorted
- Can be monitored with PT function

Line 1 Roll- -.RESULT.

.DATE 14:21:04 RID 25 JUL 90 MAPCOORD
. PRE-RUN TABLE INFORMATION
* . RID . RID . NON-USE .
*DEPN. DATE . TIME . COUNT .
104 23 JUL 90 11:14:44 1
100 20 JUL 90 09:58:31 210
19 23 JUL 90 12:11:06 276
21 24 JUL 90 09:11:59 69
7 21 MAY 90 14:50:16 113
0.0* END REPORT
 SORT

MAPPER level 35 has an interface to the 051100 Sort/Merge software package

which allows the MAPPER Sort function and the Sort/Merge package to exchange
data in a virtually seamless operation.

The time required to sort a MAPPER report becomes significent with as few as
1000 lines.

Configuring the interface to Sort/Merge requires two start parameters:

SRTBDI BDI for sort/merge. Setting this to 0 disables the

external sort.

EX'TSRT Default = 750. External sort threshold value. Setting to

0 disables automatic activation of external sort. If
this is 0, you must use the X+ option to use the
external sort/merge. Guideline is small
(1100/7012200/200) systems use value between 500-750.
LArge systems (1100/90/2200/600) set to value between
750-1500.

If using external sort - configure at least 4 MMP banks. Sort/merge and the
interface use a minimum of IOK words, and could use an entire MMP bank. MMP
banks must be at least 30k, and closer to 50k is preferable. Beware of deadlocks
if banks are not large enough.

6-4
 Level 35 Recovery Environment

There have been significent changes to MAPPER's recovery environment. New

features include:

- Recovery file now called "Audit Trail"

Recovery to Tape or Disk or both

Recovery environment configurable

History Log (AUDHST)

Audit Trail

The Audit trail file may be assigned to reel or cartridge tape, or disk. In
the configuration-, the preferred medium is designated, and the alternative is
used only if the preferred is not available.

Each volume has a unique volume identifier (VID). This VID is placed in every
block of a new format tape, but only in the 1st block of an old-format tape
(CV34). When you bring Level 35 up for the first time, MAPPER requests an
initial VID assignment. The operator should respond with "AA". MAPPER will then
take over the sequencing of the VIDs.

The MAPPER recovery environment is configured in two parts:

Start Parameters

Audit trail configuration

 Start Parameters

COMP34 Determines format written to audit trail tape.

1 - Can be recovered on level 34.

•- All features of level 35 enabled, not recoverable on
level 34.

ATCADD Name of symbolic element of a program file outside of

the MAPPER system that contains the audit trail
configuration

ATCTYP If ATCADD NONE, drawer containing the audit trail

configuration

ATCRID If ATCADD NONE, report number of audit trail

configuration

MAPFIL Configure AUDTRL disk file

RCSDEV The sector-formatted mass storage assign mneumonic for

the temporary scratch file used in a long recovery.

RCTAPO et, opt

RCTAPI eqpt - equipment code (eg. U9)
RCTAP2 opt - assignment option(s) (eg. J)
These 3 parameters are a combination of TAPCAD and
TAPLAB.

RECBUF Always enabled. Size of recovery tape buffer pool.

Default is 10000
•

RECOVR Directs MAPPER initialization sequence.

A - Quick recovery, if fails, sends console message.

I - NO-REC sequence
M - Long recovery with manual reel entry.
N Quick recovery, if fails, does NO-REC
Q- Asks operator if it should do a quick recovery
Sxx - Where xx is the starting DB cycle. Does a long
recovery from this point.
Y - Long recovery using most recent audit trail cycle
only.

6-6
 Configuration report

The audit trail configuration may be stored in a MAPPER report or a symbolic

element of a program file.

The default configuration comes on the release, tape stored in cabinet 222,
report 2D.

.MAPPER Audit Trail DEFAULT Configuration

Audit trail AUDI
Audit file check 10
Audit tape retention
Audit file retention
Data tape retention 0
Audit tape reject days 3
Audit tape reject cycles 2
Audit tape label ignore file name
Audit file v option
Audi Clise-'source BLNK
Data list source BLANK
Secure normal
Pack pack to tape only

Tape equipment T36

Equipment compatibility RCT'APO
Disc equipment D80
Word addressable mnemonic D
Initial reserve tracks 10000
Incremental tracks 0
Maximum tracks allowed 10000
Configuration CNFG
Tape reference T36
Disc reference D80
Alli audits off
Pref4iied initialization PACK
Interim disc timeout 120s
Permanent disc timeout
411/0b 4111110.
60m
Normal schedule time 0600
Normal schedule day MTWHF
Preferred mode TAPE
Configuration reference CNFG
 Configuring the Audit trail

Audit trail
.1111111
AUDI

This defines the start of the audit trail configuration. AUDI. is a specific
keyword which is always required. A future level may have different
requirements for this parameter.

Audit file retention 2

The number of days that MAPPER will protect a mass- storage audit trail
volume. At the end of each CYCLE or NO-RECOVERY operation, MAPPER will delete
old mass-storage volumes automatically. The choice of volumes will be based on
the same criteria which restrict the re-use of tapes -- except that
audit file retention will supersede audit tape retention for that purpose. To
disable the mass-storage delete altogether, configure a value here which exceeds
Audit file check, below.
AMMO Mai*

Audit tape retention 0

This is the value that will be used as retention period when assigning audit
trail tape files. To avoid unnecessary tape mounts and labelling errors when
the system standard value is used, enter it here, explicitly. MAPPER will not
attempt to re-use tape volumes within the specified number of days (up
Audit file check days, see below), regardless of whether the tapes are labelled
or not. Default is system standard, but treated as zero.

Data tape retention

.01.11P 01111111.
3

This value is used in the same manner as Audit tape retention, above, but it
applies to data tapes only.

Audit file check 10

This value is the number of days of history that MAPPER will check to see if
it can use a particular tape reel. This value must not exceed 63. If
unspecified or specified as zero, MAPPER will assume 1. Read-only, labelled
tapes with a retention period in excess of this value are protected only by
system tape labelling.

Audit tape reject days 3

This is the number of days during which MAPPER will treat a "required" tape
volume as read-only. A required volume is one which is a member of the last
"complete" audit trail cycle which applies to a particular database cycle, or a
data tape for that cycle. This value is meaningless if it is less than the
audit tape retention value. Default is, zero.

6-8
Audit tape reject cycles 3

The number of database cycles which MAPPER will preserve a "required" volume.

Audit tape label ignore file name

1=MM.

The value MAPPER will request for the accessibility field of the HDR1 label.
MAPPER makes no attempt to alter any other field. There are two legal values for
this parameter: ignore file name and tapes are not read only. The first has
the effect of assigning the tape with the F-option, the second without the R-
option.

Audit file ucde v option

Keywords are V OPTION, PRIVATE, G OPTION, and STORE THRU. Each refers to an
option letter applied to the cataloguing of a mass storage audit trail volume.
Mulitple keywords may be specified by separating them with commas

Audit list source CANNED LIST

Data list source
WOW. .11111/0
CATALOUCIE

The source of tape volume lists for MAPPER. All are available for audit trail
tapes or data tapes.
BLANK Request BLANK tapes only.
CANNED LIST Use volumes named in the "canned" lists defined in the
LISTS section.
CATALOGUE Use tape volumes associated with the catalogued tape file
named as the duplex file on the MAPFIL directive.
RUN Invoke the run defined as AUDIT LIST RUN. It will prepare
a list for MAPPER's use.

Audit list mode break on cycle

When (and if) MAPPER is to start a new list.

CONTINUOUS or NO BREAK don't acquire a new list at NO-REC, ignore any

other break parameters.
BREAK ON CYCLE acquire new list at time of a NO-REC or CYCLE
BREAK ON PACK acquire new list at NO-REC, CYCLE, or PACK
WRAP AROUND
.11111.•
attempt to restart the current list when it
becomes exhausted instead of using BLANKs.
If there is no list break configured and dual tapes are in use, MAPPER
will commandeer the "spare" tape for a PACK or CYCLE. If there is a
list break, MAPPER will not use the spare tape, even if BLANKs are
requested. Lists for data tapes (MAPDAT) are always "new" (broken) at
the start of a PURGE or SECURE.
Audit list run
4111=11,
list-run-name
The name of the run which will provide the volume list. See audit list source, _
above. The run may also be used for data tapes.

Audit list run department

411•11,
104

The department where the audit list run is registered.

Audit status interval 0

The interval, in minutes, between audit trail status messages. Zero disables
the feature. Status messages are triggered by updates.

Online start timeout 2m

The time, in minutes, which MAPPER will wait in an attempt to acquire a tape
servo for an on-line PACK or CYCLE. When time expires, MAPPER will initate
update suspense, etc, proceeding with the function. Interim disc timeouts and
such start counting at the time this timeout expires. This timeout has no effect
at all on an initial startup of any kind. 0 - 63 min.

Secure normal

NORMAL Execute the SECURE process immediately following

the completion of a MERGE.
EXTERNAL Do not execute SECURE after the MERGE process.
NOT VERIFIED PURGE and SECURE assume a positive response to
console message #2667, and proceed regardless of
the readability of the output tapes.
ALLOW CYCLE WITHOUT SECURE If EXTERNAL is specified and a subsequent
SECURE is not contemplated, configure this value
to allow a subsequent CYCLE.

Pack pack to tape only

The alternate value is ALLOW PACK TO DISC, which will be ignored if the COMP34
start parameter is set.

Audit sanity checkl 30m

Audiisaniticheck2 180m

These parameters effect recovery only, for determining the validity of the
"last update time", etc. The above values are the defaults.

Auto cycleyercent full

When the update file reaches the configured percent of its capacity, MAPPER
does a CYCMRG automatically. Configure zero to disable this feature.
 Auto cycle reject size
When the smallest rejected request for update file space falls below this size
(in tracks) MAPPER will do a CYCMRG automatically. Configure zero to disable
this feature. MAPPER will use reject size or percent full, whichever it
encounters first.
mismmimmommimmirmimmilimmiliimummwawm.rm.modmamo+ftwalmo.m.mmoirmi.04simaimminommiwirommimmomm....b

Section 2 --- Tape equipment

Tape equipment T36

This specifies the start of a tape equipment section. It can be any

combination of up to six non-space, non-tab characters.

Equipment compatibility RCTAPO

This specifies the compatible equipment type. RCTAPO thru RCTAP2 are keywords
referring to the start parameters of the same name. (RCTAPO redefines the
TAPCD/TAPLAB parameters.)

Equipment mnemonic 361

This overrides the RCTAPn start parameter.

Equipment features equipment requires unlabelled

Defines specific, generic features of the tape hardware. Allowable values are
EQUIPMENT REQUIRES UNLABELLED and BUFFERED.

Specifying BUFFERED enables BUFFERED TAPE OPTIONS q.v. in the CONFIGURATION

section.
. lab OM WM

Repeat the entire tape equipment section as many times as desired, using
a different name each time.
411004.1.4121WWPOOD.WOMNIMP.1.11111111

Section 3 - Disc equipment

In the interest of data integrity, disc audit trail files should be

protected from any site procedures which delete files automatically,
at least until they have had a chance to age somewhat.

Disc equipment D80

As with tape equipment, D80 is a name, not a keyword.

6-11
Word addressable menmonic

This is the appropriate assign mnemonic for word-addressable mass storage as -

known to the operating system, e.g. D70M, D8OC, etc. If removable disc is to be
used, these must always be correct.

Initial reserve tracks 10000

Incremental tracks
Maximum tracks allowed 10000

The above parameters affect the size of any disc volumes created by MAPPER.

Renmable_packs pARID1 ,PAKID21 .PAKIDn

Specifies removable disc pack IDs which MAPPER should use for disc audit trail
volumes.

Repeat the entire disc equipment section as many times as desired, using a
different name each time.

MIUMWM100410.004.116.0 0.0 ...00.121000.0 40•000.10.041.0.0.0.0.0

Section 4 - Configuration

Configuration CNFG

As with tape and disc equipment, CNFG is a name. A configuration defines

several preferences and equipment combinations which might be preferred.

Tape reference
4.10.
T36

This parameter refers to a previously-defined TAPE EQUIPMENT item.

Disc reference D80

This parameter refers to a previously-defined DISC EQUIPMENT item.

Allow audits off

Whether or not MAPPER may run with audit trail turned off.

Preferred initialization 4110101.

PACK

How MAPPER will start. Valid keywords are ?ACK, HOT START, SLOW PACK,
DEFAULT. DEFAULT will select PACK if the audit trail mode is tape, HOT START if
disc. DEFAULT is the default if the parameter is not specified.
Interim disc timeout 120s

This parameter specifies a 'tape mount timeout' in seconds. After waiting for
a tape mount for the specified time, MAPPER will initiate 'interim disc' audit
trail logging. When the tape does get mounted, MAPPER will copy the contents of
the interim disc to the tape, then discard the disc file. Specify zero to
disable the feature. Avoid values of less than 5s (except zero) or greater than
511s -- a period in excess of eight minutes. PACK will not write to an interim
disc file.

Permanent disc timeout

OMMINI, NUM
60m

This parameter specifies a time, in minutes, after which MAPPER will initiate
a permanent disc audit trail. If an interim disc is use, it will become
permanent -- MAPPER will not attempt to copy it to tape. Otherwise, this is
completely independent of the interim disc timeout. Specify zero to disable the
feature. Values less than the interim disc timeout will override that feature.
Values in excess of 511m may not produce the expected results (but that's over
eight hours!) Do not be too optimistic when specifying this parameter, or there
may be an excessive number of permanent disc audit trail volumes.

Buffered tape option FLUSH BUFFER

This parameter specifies the method used to safeguard updates written to

buffered tape devices. It is operational only if the tape equipment referenced
specifies buffered on the equipment features statement. Flush buffer is the
default.

none MAPPER takes no special action

flush buffer MAPPER will force the buffered device to flush its buffer
each time it perfoms an IO to the device.
backup disc MAPPER will maintain a disc file in parallel with the tape.
When the disc file reaches its configured wrap around point
(or its initial size), MAPPER will force the tape unit to
flush its buffer, then restart the disc file. When the tape
is successfully closed, without error, MAPPER will delete
the disc file. Not applicable when QDMP34 is set.

Backup wrap tracks size

If backup disc is configured, this parameter defines the wrap-around point of

the backup disc file. Note: MAPPER does not treat this limit as absolute,it may
exceed it, but only with one IC.
 Section 5 - Lists

Audit tape list MWF

The value is a name, 1-6 characters, to be referenced later.

List compatibility }terApo

See equipment compatibility, above.

Tape volumes MWF1,14111F2,191F3,...,?1

Tape volumes MWF11,14WF12,MWF13,...,MWFln

As many reel numbers (VSNs, VOLSER numbers whatever) as will fit, separated
by commas. Multiple images are fine.

An entire list, as an example:

Audit tape list THWE

List compatibility RCTAPO
Tape volumes THWE1 THWE2 THWE3 ,THWEn
Tapevolumes THWE 1l ,THWE12,THWE13 ,THWEn

Data tape lists are identical to the audit tape lists, but the initial
parameter name is DATA TAPE LIST

Specify as many lists as desired, insuring that each has a unique name.
4111•10.11.1•111.1110 01111.1110 .1.1.0110.111111.4111111.1110

Section 6 - Schedules

All schedule items start off by specifying a time and days or date, with two,
separate statements.

All schedule items are in effect until superseded by another. Each may span
many days, if desired. Results may be unpredictable if two items come into
effect at the same, exact time. Special schedule items override normal schedule
items.

Normal Schedules

Normal schedule time

Normaischedule day

Schedule times are in the format shown (HHMM) , 24-hour time from 0000 - 2359.
2400 is ambiguous and will cause an error.

Schedule days are days- of the week, each represented by a single letter with
Monday, Tuesday, Wednesday, tHursday, Friday, sAturday, and OUnday represented
by M, T, W, H, F, A, and U, respectively. This example shows Monday, Wednesday,
and Friday.
Preferred mode DUAL TAPE

This specifies the preferred mode during the specified schedule period. Valid
keywords are DUAL TAPE, TAPE, DISC, and NONE.

Configuration reference CtiloG

Specifies the name of a previously-defined configuration parameter. That, in
turn, will define the equipment available, etc.

Schedule name DAYS

This parameter, if present, names the schedule item in use. Its only function
is to identify the schedule item to the operator. If absent, no identification
message will be generated.

Lookahead time 30m

This parameter specifies the time MAPPER should look ahead for schedule
changes. Operator notification only

Auto start PACK

Functions to be started automatically at the start of the scheduled time

period. These may be PACK, CYCLE ONLY, PINDEX, CYCLE, MERGE, SECURE, or combine
the last three with CYCMRG.

List reference
Specifies the list to be used, named on a previous AUDIT TAPE LIST parameter,
only if AUDIT LIST SOURCE is a CANNED LIST. The corresponding parameter for data
tapes is DATA LIST REFERENCE, which must refer to a list named on a
DATA TAPE LIST parameter.
MOW OM.

Normal schedule examples:

Normal schedule time 0600

Normalscheduledays TH
Schedule name DAYS
Configuration reference CMFG
Preferred mode DUAL TAPE
List ref4Fence THWE
Autdstart PACK

This schedule is identical to the first one, but it takes effect at

0600 on Tuesdays and Thursdays.

6-15
Normal schedule time 1930
Normal schedule days MWF
Schedule name EVENING
Preferre3 mode TAPE
Configuration reference CNFG
List referen6e.
.11•111W
THWE

This will allow MAPPER to release the second tape drive at the first tape
swap after 19:30 (7:30 PM), until 06:00 when another item specifies the second
servo. This schedule item will be in effect from 1930 Friday until 1800 Sunday.

Normal schedule time 1800

Normal schedule days U
Normal schedule days SUN-NIGHT
Configuration reference CNFG
Preferred mode DISC
List reference MWF

This set of schedules would accomodate a daily CYCLE, Monday thru Friday,
sometime between 1930 and 0600 the next morning, and a weekly PURGE on
Sunday, sometime after 1800.

Special schedules

Special schedule items are intended for holidays, etc.

Special schedule time 1500

Special schedule date 1990 Jun 30
Preferred mode TAPE
Configuration reference CNFG
Schedule name JULY4TH!
Special schedule time 0300
Special schedule date 1990 Jul 05

Special schedules accept dates, rather than days of the week. Omit the
configuration reference to indicate the end of a special schedule item.

This example might cover the 4th of July holiday (1990) if Monday and Tuesday
are also taken as holidays. All normal schedule activity will be ignored from
3:00PM on Sat, Jun 30, until 3:00AM on Thursday, Jul 05.

If anything happens during this period which requires a new list, MAPPER will
ask for BLANKs since there is no list reference.
 Operations

MAPPER now uses the terms "Quick recovery" and "Long recovery".

Quick recovery The standard start-up procedure. Two options are given,
HOT-START and PACK. The HOT-START does not write the
updates to the audit trail, or start a new audit trail
cycle.

Long recovery Reads the updates in the audit trail volumes and
applies them to the update file.

Operator Commands

II MAPPER ATDISC Switches the audit trail to disk

II MAPPER ATDISK Same as ATDISC

II MAPPER ATDROP Drops the audit trail switches to NO-MODE.

II MAPPER ATSPUP Temporary dual-tape mode effective until the next

tape swap. At swap, MAPPER goes to the spare and
releases the original.
II MAPPER ATSPDN Reverses the effect of an ATSPUP.

II MAPPER ATSWAP Swaps to the next audit trail volume, disk or tape.

II MAPPER ATTAPE Changes audit trail to single-tape mode.

II MAPPER ATTAP1 Same as ATTAPE.

II MAPPER ATTAP2 Switches the audit trail to dual-tape mode.

 Hot Standby

MAPPER can be configured to use the Multi-Host File Sharing (MHFS) and
Automatic Recovery of Components (ARC) features. When configured for Hot-
standby, MAPPER registers with ARC and maintains a periodic heartbeat to show
it's continued operation.

Hot-Standby will restart MAPPER under three conditions:

- MAPPER component failure.

- If MAPPER detects a failure with a program contingency,

MAPPER will de-register itself with the ARC, do a
controlled termination, then restart.

- If MAPPER did not detect the termination (heartbeat

terminated), then the ARC terminates and restarts MAPPER.

- Operating failure with no standby system.

- The ARC will restart MAPPER after restarting the OS1100.

- Operating system failure with a standby system.

Only if COMP34 is set to 0.

- Only if MAPPER has been configured to use shared files.
- The ARC will restart MAPPER on the standby system
 Configuration Parameters

HBTBDI 0402105 The BDI for the Application Interface common bank (AIB).
This is the interface for Hot-Standby.

HBTTIM 0 Minimum time lapse, in seconds between heartbeats.

0 disables Hot-standby. Values are 0-30.

HBTTRM 1 Should MAPPER terminiate when two consecutive heartbeats

are undetected. 0 = no.

HBTCMP NONE The runstream to be used to restart MAPPER on the same

computer, if a MAPPER component failed.

HBTENT 01000 Entry point for AIB.

HBTLOC NONE The runstream to be used to restart MAPPER on the same

computer if the operate system fails.

HBTSHR NONE The runstream to be started on the standby system

if the same computer is unavailable.

MAPDIR BLANK The directory name for file sharing.

- STD = Standard file names.

- SHARED = Shared files.

Operator commands

II MAPPER HBTON Turn on the Hot-Standby interface.

II MAPPER HBTOFF Turn off the Hot-Standby Interface.

II MAPPER PARAMS On-line change to these parameters

HBTCMP
HBTLOC
HBTSHR

6-19
 Other new Configuration Parameters

CDPTYP 003134 Cabinet/drawer permission report type

CDPRID 11 Cabinet/drawer permission report number

LOOKSW 7 Enable/disable global New Look. Bit code 0-7.

Bit 0 - 1, LOOKSW command enabled.

Bit 1 - 1, Menu interface is default.

Bit 2 - 1, Runs using menu are allowed.

MXDEPN 999 Maximum department number allowed. 1-999

SECMSG 0 1, Echo usersign on errors to the console

SSSTYP 000001 Drawer for messages if no RID on display

TIPBAT TIP priority of runs to execute at batch priority.

If a run is configured to execute at a tip priority
higher than the TIPLVL, the run will execute at
batch priority. 0-100.

MAXACT The maximum number of stations that can concurrently

be using MAPPER.
 ADJUST run

The ADJUST run is used to update portions of your database affected by

level 35. You must execute the "GEN 256 Character drawers" to use APT. Once you
have allowed 256 character drawers, you must also change the COMP34 parameter to
0.

MAPPER 35R1 ADJUSTMENTS

REQUIRED Adjustments
4.110011M4.0

RUN Registration Fields 41011016

USER Registration Fields

IDLE Logo Function Keys
TYPE Function Data Report
GEN 256 Character Drawers
OPTIONAL Adjustments
war mswmiwamamprmmmmpmmomamhdMomwo.moilrrmirmmowwoorwaWmMp...pep.p..mgmpwr

Run Scheduling Options

RUN Registration Changes
34R1 Previous Adjustments
MODULE 7

Networking
Module 7 Networking

Module Objectives

Upon completion of this module, you will be able to:

- Configure connectivity to other MAPPER systems

- Use the new run networking statements

 MAPPER Networking

MAPPER networking gives you on-line connectivity to other MAPPER systems,

either on the same host or different hosts. With networking, you can:

- Transfer reports between MAPPERS

- Execute Run statements on another MAPPER

- Pass -thru to another MAPPER

On the 1100 and 2200 systems, MAPPER uses IMP-1100 for networking. Start
parameters for networking are:

NETNAME - Cannot be same as MAPNAM)

NETRMR - (turns on interface)

NETT YP Cabinet/Drawer of network configuration report

NETRID Report number of network configuration report

HSTID - Host name

 Network Configuration Report

Default = Cabinet 206, Drawer C

Line 1 Roll - 1C202

.DATE 25 JUL 90 17:39:32 RID 1C 12 JUL 90 MAPCOORD
.Network Configuration Report System Configurations C003124
* .S. .S.COM . HOST
• NETWORK NAME .L.NETWORK PATH NAME .L.TYPE. NAME

SYSTEMI A MAPPER DDP HST1

SYSTEM2 B MAPPER DDP HST2
SYSTEM3 C MAPPER DDP HST3
SYSTEM4 D MAPPER DDP HST4
..... END REPORT .....

When the logo screen is on display, the user depresses F7REMOTE to display
possible system connections. For pass -thru tab to the desired system name and
transmit.

System Select
Current System: 3 Locate:
NAME SITE
SYSTEM1 A
SYSTEM2
SYSTEM3
SYSTEM4
 Networking Run Statements

Networking run statements allow a user, within a run to access another MAPPER
site. The user must be registered to execute the INTER-RUN run (supplied).

@NET - The NET command signs on to a remote MAPPER.

@NET , net-id, site[ rmu rrrEl rmp, trn, mtr, lab]

net-id - Name of remote MAPPER system

site - Site-letter
rmu - Remote user-id
rmd - Remote department
rmp - Remote password
trn - Translation report number
mtr - Monitor
lab - Label on no-connect
Note: The user ,dept password defaults to the current

@NOF - The NOF command signs the user off the remote MAPPER and closes the
communication connection with the remote system.

@NOF

@NRD - The NRD command allows a user, who is signed on to a remote system, to
read and return a report to the local MAPPER system.
vmsg

Note: the receiving report defaults to -0

@NRM - The NRM command executes runs and manual commands on the remote MAPPER
system. The run remains active while the command is executing at the remote
site. If the NRM statement starts a run, the run itself can return to the local
site with a @NRT command.
@NRM "command"
@NRT ["coninand"]
@NRN - The Network Run (NRN) command allows a user to pass run statements to a
remote system. To process the result, you must rename the result first. To avoid
conflicts with the INTER-RUN run, do not use V1-V15 in the NRN statement.
@NRN,lab 'run statements" vmsg

@NWR - The Network Write (NIR) statement allows a user to send a report or
result to a remote MAPPER system.

vmsg

Example: Sign-on to. SYSTEM1, site A as JDOE,16,CUBS. Send report 23 in cabinet 0

into cabinet 14, drawer D. Execute a run called LOOKUP. Transfer report 45D in
cabinet 14 back to the local system and sign-off SYSTEM1.

WET,SYSTEM1,ApJDOE,16,CUBS, ,10 •
@NWR,10,B,2i10,14,,99 V21S80 .
@NRM LOOKUP .
WRD,14,1Dr45,,,,99 V21S80
@NOF .
...PROCESSING....
@99 : . ERROR PROCESSING .

7-4
MODULE 8

MAPPER
Relational
Interface
Module 8 Relational Interface

Module Objectives

Upon completion of this module, you will be able to:

- Describe how MAPPER level 35R1 interface to relational

databases

- Identify the steps necessary to set-up the MRI Interface

- Describe the purpose of the MRIDBA and RDI runs.

 MAPPER Relational Database Interface (MRI)

With the MAPPER Relational Database Interface installed on your system, you
have the ability to access a relational database on your local host system or
another host.

MRI installs a common bank MRI. A batch run, called a MIRIM run has to be
started. This batch run executes an absolute called SERVER, which reads a card
image configuration element called *MRI/PARAMATERS. These parameters identify a
BDI of an RSA common bank and a UDS application name. SERVER then generates a
"Begin Thread" for the application (if SERVER has any problems, The MRIM run
aborts). SERVER then connects to the MRI common bank.

In MAPPER, the MRI function is responsible for interfacing with the MRI
common bank. The RDI run will pass requests to MRI for manual access. There are
also new Run statements to access MRI within a user-written MAPPER run.
Databases and applications are registered with the MRIDBA run. This run can also
register user restrictions on a database level.

MAPPER

MRI MRI MRIM RSA

Common run Common
Bank Bank

Application
 MRIDBA Run

The MRIDBA run registers databases and user restrictions.

Databases are registered in cabinet 202, report 1C.

.DATE 20 AUG 90 16:00:03 RID 1C 27 JUL 90 CCM

.Network Configuration Report System Configurations 0003124
* .S. .S.COM .MRI. .Thr .
NETWORK NAME .L.NETWORK PATH NAME .L.TYPE. . ID.DBMSType.ent .
."' 41010

system2 dir 1 mits4 5

system]. dir 2 rdifs4 5
monica dir 3 rdis4 5
..... END REPORT .....
 Instructions for setting up your MRI System.

1. Run MRIDBA. Choose Register database names. On the first menu

enter a name for your database. On the second menu, enter the
database type (RDMS4, DB2v1, or DB2v2) of your database,
Max threads (as desired), Communication type DIR for RDMS or
6.2 for DB2, leave Network path blank, MRIM ID which corresponds
to the MRIMID parameter, and Application group name (if the
data manager is RDMS). Press Transmit to register the database
name. Then press Return (F4) twice to return to the MRIDBA menu.
***
If you are not using RDMS 1100, skip to step 3 ***
2. On the MRIDBA menu, choose Application Group Set-up to set up the
necessary parameters and tables for your application group.
A. Choose set up parameters. These Parameters will be used for
batch runs. Update the parameters with the values applicable
for your site.
B. Choose Create Storage areas. This is a batch job that will
create storage areas required by RDI. The batch run stream
will be displayed. Press the Start key (F1) to start the job.
Your terminal will "beep" when this is done. (Press MSG
Wait).
C. Run MRIDBA, Choose Application Group set-up and then choose
Create MRI.TABLES. This is a batch job that will create an
RDMS table containing a list of tables in your database. Your
terminal will "beep" when this is done.
D. Run MRIDBA, Choose Application Group set-up, then choose
CREATE MRI.TABAUTH. You may be required to use a different
userid, because MRI.TABAUTH is a view
based

E. Run MRIDBA, Choose APplication Group set-up, then choose

Create demo tables. This will link to RDI,RESTORE to create
the demo tables, and present you with a menu when the process
is finished. When you transmit, the TABLES run will be
executed to update MRI.TABLES.

3. Use MRIDBA to set your system default names and RDI Security.
***
If you are not using RDMS 1100, execute the run RDI,RESTORE to create
the demo database. This completes your system setup. ***
5. If you add a different application group, use MRIDBA and follow the
steps under Application Group set-up.
*** Step 6 is only applicable for RDMS 1100 ***
6. Whenever you add or drop tables and views outside of RDI, execute
the TABLES run to update MRI.TABLES. You may wish to schedule the
TABLES run as a daily run. Parameters on TABLES are:
TABLES,station,database,application
8-3
 MRIDBA Menu

DBA Menu
Tab to your choice and press XMIT

System set-up ->

Register database names -> 411•1111011MP

Application Group set-up -> 41111.101.1.

Set system defaults -> 41111110111111.

Set RDI privileges ->

Set user defaults -> .1111011IMP

Register local subroutines ->

Clean up admin. reports ->
Update MRI.TABLES -> 410111111111.

Active Threads ->

Set up remote database file ->
Create storage space -> 4111.1..1.

Detailed help ->

..rommomorrommowirematirmoi at7q.
F4il rarommi
Help

8-4
 Database Registration

MRIDBA
4•11.111.11p

Database configuration
Enter the database name.
Database Name -> testmmg

Place cursor here and press XMIT ->

MRIDBA
Register a new database
Enter the following information.

Database Name -> testmmg

Database Type -> rdms
Max Threads -> 5
Communication type -> dir
Network Path ->
MRIM Id -> 1 Application Group -> UDSSRC

Place cursor here and press XMIT

 User Restrictions

Users may be assigned certain priviliges for each database.

Set RDI privile9es

Enter the MAPPER user-id, department number, and database name
MAPPER user-id -> WEWMSE
Department number -> 19
Database name -> MONICA
Place cursor here and press )MIT ->

Set RDI privileges

For user-id, WEWMSE in department 19, database MONICA
Answer y to set privileges.
All privileges? -> All privileges with DBA access -
Select -> Join -> Insert ->
Delete -> Update -> Create ->
Restrict -> Destroy -> Alter ->
SQL -> Create view -> Drop view ->
Maximum rows to retrieve ->
Access Special Options menu on Select, Join and SQL? ->y.
Explain -> Background run ->
Place cursor here and press XMIT ->

User privledges stored in cabinet 214, report 2H

.DATE 20 AUG 90 15:45:55 RID 4H 16 JUL 90 CCM
.@ RDI security report RDI Administration
.MRI 3R2 Rev. 0.00 891005 1100
. .Database .A .S .D .0 .J .0 .R .D .A .0 .D .D .S
-*Userid .Dept.Name .LL.EL.NS.EL.PD.OI.RE.ES.ES.LT.VI.VI.BA.QL.rows
CCM 1 SYSTEM1 y y
WEwmse 19 RDMS y y
WEBLRW 21 RDMS y y
LRC 108 RDMS y y
PUBLIC y y

8-6
 - Database Access - RDI Run

RDI
DBMS menu
Enter the database to access.
Database name -> systeml

Database user-id -> MAPCOORD

Database password ->

Place cursor here and press XMIT -> mom

RDI
RDI menu
Tab to your choice and press XMIT

Select
Join
Insert
Delete
Update
Create
SQL
Utilities menu
Detailed help

Rev. Level 3R2

UDS-1100 Support Workshop REFERENCE
RDMS-1100 Overview Module 4

R4-3. Economics of Relational Database Systems

For the database user, relational database systems provide:

o data independence

o conceptual simplicity

o table-at-a-time processing capability.

As a result, relational database users can expect tq realize

enhancement in:

o ease of use

o application development speed

o application structure flexibility

o application maintenance reduction

o application conversion speed.

For these benefits, database users accustomed to DMS-1100 will be

trading off:

o higher operational cost

o- more redundancy of data

o more internal complexity in support software

The bottom line in efficiency, however, needs to include the total

expenditure over the life of the product not just the milliseconds or
seconds spent on a given transaction.

UE-8167 4-11 SE1237 OS-1100

man * 1/25/85
UDS-1100 Support Workshop REFERENCE
RDMS-1100 Overview Module 4

R4-4. Rules for Tables

1. Each column needs a unique name within the table.

2. At intersection of row and column is a single value or

character string: there are no repeating groups.

3. All values in a given column are of the same kind; that is, in
the same set of possible values defined for that column.

4. Each row has a unique identifier: a column or group of columns

whose value occurs only once in the table. This identifier is
called the primary key.

5. The order of rows and columns within a table has no

significance.

UE-8167 4-13 SE1237 OS-1100

tan * 1/25/85
 RELATIONAL ALGEBRA

SELECT CONDITIONALLY CHOOSE ROWS FROM A TABLE

• PROJECT CHOOSE COLUMNS FROM A TABLE

JOIN COMBINE COLUMNS FROM TWO TABLES TO FORM

A THIRD TABLE

THE RESULT OF A RELATIONAL ALGEBRAIC OPERATION IS ALWAYS

ANOTHER TABLE•

RELATIONAL ALGEBRA IS THE BASIS OF ALL RELATIONAL DATABASE

MAN?PULATIONS• HOWEVER, RDMS-1100 PROVIDES THIS FUNCTIONALITY
USING ITS OWN SYNTAX. -

v4-10

4-14