Trailing-Edge
-
PDP-10 Archives
-
decuslib20-04
-
decus/20-0109/adres.man
There are 2 other files named adres.man in the archive. Click here to see a list.
Swedish National Defense Research Institute FOA 1 Report
Department of Planning and Operations Research D10009-M3(E5)
S-104 50 Stockholm 80 March 1976
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES
BY JACOB PALME
ABSTRACT:
The ADRES program is suitable for handling small address
registers with between 10 and 2000 addresses. The program
runs on a DECsystem-10 computer.
The program contains facilities for reformatting the
addresses to fit any kind of adhesive labels, with any
number of labels across the width of the form. Labels can
be printed on a line printer or on a typewriter terminal.
There are also facilities for selecting certain labels from
an address file using Boolean search conditions like
"SWEDEN+DENMARK&COPENHAGEN". There is a field in each
address for storing information which is not to be printed
on the labels, e.g. an interest profile to be used in the
selection.
Addresses can be sorted on any line in the address.
The program can easily, without reprogramming, be made to
fit a new task, e.g. a new way of selecting addresses for
distributions.
As an appendix is included an example of how you write to
the swedish DATAINSPEKTIONEN to apply for the right to use
an address register.
SEARCH KEY:
Computer, Digital Equipment, DECsystem-10, Address, Search,
Selection, Mailing, Label.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 2
SWEDISH ABSTRACT:
ADRES-programmet {r l{mpligt f`r hantering av sm}
adressregister p} mellan 10 och 2000 adresser. Programmet
k`rs p, en DEC-system-10 dator, men {r skrivet i SIMULA och
konverterbart till annan dator.
Programmet kan formattera om adresserna f`r att passa varje
typ av adressetiketter med en eller flera etiketter i bredd
p} etikettarken. Etiketterna kan skrivas ut p} radskrivare
eller skrivmaskinsterminal.
Programmet g`r det m`jligt att med Booleska s`kformler av
typen "SVERIGE+DANMARK&K@PENHAMN" v{lja vissa adresser.
Varje adress har ett f{lt av variabel l{ngd som inte skrivs
ut vid utskrift, och d{r t.ex. en intresseprofil kan
lagras.
Adresserna kan sorteras.
Programmet kan l{tt, utan omprogrammering, f}s att passa en
ny uppgift, t.ex. en ny metod att v{lja ut adresser.
Som appendix bifogas ett exempel p} hur man skriver till
datainspektionen om tillst}nd till ett adressregister.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 3
SUMMARY OF INPUT COMMAND FORMAT AND SWITCHES
outfil=infil/switch1/switch2...
SWITCH DEFAULT IN OUT-EXTENSIONS /MEANING
/NOLABEL LABEL .ADR .LAB Output for adhesive labels
/LIST NO .ADR .LST Output for TTY or LPT-listing
/FILE NO .ADR .ADR Output for .ADR file
/PRESORT NO .ADR .USR Output for sorting
/ASORT NO .SRT .ADR After sorting to .ADR file
/OUT1 NO .ADR ? Output line 1 as part of label
/SELECT NO .ADR ? Select only certain addresses
/NOCASESHIFT CASESHIFT Upper and lower case equal when
selecting
/LINES:N 5 Number of lines per label
/LABELS:N 3 Number of labels horizontally
/LEFT:N 0 Left margin
/WIDTH:N 36 Max number of chars in a line on one
label
/TAB:N 41 Horizontal spacing between labels
/LINE1:N 300 Max length of first line in input
address
/LINE2:N 80 Max length of other lines in input
address
/NOTABS TABS Set and use built-in tabs on GNT
terminal
/SINGLE NO LABELS:1/LEFT:1/WIDTH:48
FORMAT OF ADDRESS FILE
The input file to ADRES is normally an address file
consisting of one record for each address. The records are
separated by FORM FEED characters. Each address can contain
up to 16 lines, separated by CARRIAGE RETURN + LINE FEED.
IMPORTANT: The input records should not contain any TAB
characters.
The number of lines in an input record need n o t be the
same as the number of lines on the adhesive labels. The
ADRES program will automatically reformat the input
addresses to fit any kind of adhesive label.
The first line (immediately after the FORM FEED) in each
address can contain special information which you do not
want to print on the adhesive labels, e.g. an interest
profile or internal information.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 4
INSERTION, REMOVAL AND UPDATING OF ADDRESSES
The ADRES package contains no program to correct individual
addresses or to insert or delete addresses, since this kind
of updating is easy to do with a text editor such as TECO or
SOS or EDITS.
Example: You first find the adresses to be updated with a
search command across pages (such as the N command of TECO)
and then correct it or remove it (e.g. with the Y command of
TECO).
Do not forget to insert a FORM FEED in front of new
addresses added to the file.
At the QZ computing center in Stockholm, you can order forms
with adhesive labels in a format suitable for GNT, Terminet
and similar terminals, from the computer centre.
Example of a simple address file (<FF> means FORM FEED):
<FF>government research
F`rsvarets Forskningsanstalt
FACK
104 50 Stockholm 80
<FF>government computer centre IBM CDC DEC Digital
Stockholms Datamaskincentral
f`r h`gre utbildning och forskning
FACK
104 50 Stockholm 80
OUTPUT ON ADHESIVE LABELS
Unless you specify otherwise, the output from ADRES is
prepared in a format suitable for direct printing on
adhesive labels.
Each address is reformatted to fit into a given label size,
with given number of lines and given number of characters
per line.
You can choose the number of labels from left to right in
the output, and the spacing between the labels.
The algorithm for fitting an address into a label accepts
addresses with too many lines, too few lines, too long lines
or too short lines, and tries to get a neat label. This
works better if the input file has many short lines than few
long lines.
The input address is never shortened. If it is too large,
an error message is given on the terminal, and this address
is not output.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 5
INSERTING LABEL FORMS INTO A TERMINAL
When you have processed your address file with ADRES to get
a .LAB file, you can insert a form with adhesive labels into
a terminal (e.g. a GNT terminal). First type "TTY NO CRLF"
on the terminal and then move the paper so that you are on
the first line of a label. Then type "COPY TTY:= FILE.LAB"
where "FILE.LAB" is your label file, and push the RETURN key
on your terminal.
The labels will now be printed on your terminal.
You can also insert the label form into the GNT terminal
directly when running the ADRES program, and type the input
command "TTY:=filename" where filename is your address file,
to get the addresses printed directly from the ADRES program
to the label form.
COMMAND SWITCH: /LIST
Exactly the same output is produced as with ordinary label
output, except that:
1) The default extension of the output file is .LST instead
of .LAB.
2) The output file is divided into pages of suitable size.
COMMAND SWITCH: /FILE
The output file has the same format, with formfeed
characters between each address, as the input file. Usually
used in combination with /SELECT.
The default extension of the output file with /FILE is .ADR.
COMMAND SWITCH: /PRESORT
The output file is produced in a suitable format for
sorting. Each address becomes one long record, with
<CR><LF> instead of <FF> between records, and each line in
the input file is expanded with blanks to its maximum length
within this record. This means that the same input line
always gets the same position in the presort record.
You may often want to modify the input file slightly with
TECO or a simple program before and after sorting, to get
the sort field first in a line.
If you want to reduce the length of the sort records, then
carefully choose values for the input switches /LINE1:n and
/LINE2:n. The default values for these switches may often
give unneccesary long sort records.
The output file with /PRESORT has the default extension
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 6
.USR.
COMMAND SWITCH: /ASORT
The input file is in the format produced as output with the
switch /PRESORT.
The default extension of the input file with the switch
/ASORT is .SRT.
A typical sort operation involves:
1) Run ADRES with /PRESORT to convert a .ADR file to a .USR
file suitable for sorting.
2) Run SORT to produce a sorted file with extension .SRT
from the unsorted file with extension .USR.
3) Run ADRES again to convert the sorted file with extension
.SRT to a .ADR, .LAB or .LST file.
The switch /ASORT is useful to simplify input of files
produced in other programs, written in, e.g. COBOL, FORTRAN
or SIMULA. In the same way /PRESORT may simplify output of
data to programs in other languages.
COMMAND SWITCH: /OUT1
Normally the first line of each input address is not output
on labels or listings. This line is assumed to contain a
selection key or other internal information not to be
printed. With this switch however, you can get the whole
input record output on labels and listings.
When this switch is set, the maximum length of all lines is
set to the largest of the switch values /LINE1:n and
/LINE2:n.
COMMAND SWITCH: /SELECT
When this switch is set, you can use a Boolean condition to
select only certain addresses for output.
A typical such Boolean condition might be:
SWEDEN+(DENMARK+NORWAY)&-UNIVERSITY
meaning that you want to select all addresses containing the
word "SWEDEN" and also all addresses containing the words
"DENMARK" or "NORWAY" except those containing the word
"UNIVERSITY".
Priority of operator characters:
1) "(" and ")"
2) -
3) &
4) +
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 7
You will be asked for two Boolean conditions, one for the
first line in the address, one for the other lines. If you
input both conditions, only those lines will be output which
satisfy both conditions.
Selection is faster if you only input a Boolean condition
for the first line. You can also make selection faster with
the /NOCASESHIFT switch.
COMMAND SWITCH: /NOCASESHIFT
This switch is only meaningful combined with the /SELECT
switch. If this switch is not given, the word e.g. "SWEDEN"
or "sweden" in a Boolean condition are identical in meaning,
and will recognize any address containing "SWEDEN" or
"sweden" or "Sweden".
When the /NOCASESHIFT switch is set, the word "SWEDEN" in a
Boolean condition will only recognize exactly this text
without case shifts. This will make selection somewhat
faster.
COMMAND SWITCH: /LINES:N
This switch is used to tell the system the size of your
adhesive labels. Substitute for N the number of lines on a
label.
COMMAND SWITCH: /WIDTH:N
This switch inputs the number of characters on one line on
an adhesive label.
COMMAND SWITCH: /LABELS:N
Forms with adhesive labels often contain several labels in
the breadth. This switch input the number of labels in the
breadth.
COMMAND SWITCH: /LEFT:N
The number of characters in left margin before the first
label in the breadth.
COMMAND SWITCH: /TAB:N
The horizontal spacing between labels in the breadth
(including the label width).
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 8
COMMAND SWITCH: /LINE1:N
The maximum length of the first line in the input address.
If you try to input a larger address, an error will occur.
If such an error occurs, you can type proceed to continue
execution. You will then be allowed to conversationally
input a shorter line instead of the too long line.
COMMAND SWITCH: /LINE2:N
The maximum length for all input address lines except the
first line. See above.
COMMAND SWITCH: /NOTABS
If you have more than one label in the breadth of the output
form, the program will normally output one tab to skip from
one label to the next. With /NOTABS, a number of blanks
will be used instead.
Note that since only one tab is used to space between
labels, the tab settings on the terminal must be set to the
start of each label. Standard tab settings every eight
characters will not do. If your terminal has no tabs which
can easily be set, you can avoid this problem by using the
switch /NOTAB.
If you do not write /NOTABS, the output will also include
device control characters to set the tab settings according
to the standard used on GNT, Terminet etc. terminals.
COMMAND SWITCH: /SINGLE
This is just a shorter way of writing
/LABELS:1/LEFT:1/WIDTH:48, which is suitable for certain
forms with just one adhesive label across the breadth of the
form.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 9
FILES ON THE ADRES DISTRIBUTION TAPE
ADRES SIM 42 Main source program
ADRES RNM 32 Runoff file for ADRES.MAN and
ADRES.HLP(with /variant:help)
ADRES HLP 16 Help file, also used by the selective help
facility within the ADRES program
ADRES MAN 31 This manual
ADRES OVH 29 Overhead picture texts on ADRES, type with
/p
ADRES SAV 89 Executable core image of ADRES
SQHELP SIM 11 Source program of help facility module
SQHELP RNH 5 Runoff description of help facility module
DECOM SIM 9 Source program of command interpreter
DECOM HLP 13 Description of command interpreter
SELECT SIM 13 Source program of Boolean selection
facility (/SELECT)
SELECT RNH 13 Runoff description of SELECT
SIMR21 SHR 47 Simula run time system part 1. Must be
stored on SYS:
SIMR22 SHR 37 Simula run time system part 2. Must be
stored on SYS:
SIMDDT ABS 44 Simula debugging system. Must be stored on
SYS:
In addition to the files listed above, you need the SIMULA
compiler (DECUS ORDER NO 10-223A), if you want to recompile
modules within ADRES.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 10
APPENDIX A: AN EXAMPLE OF HOW TO WRITE TO DATAINSPEKTIONEN
APPENDIX A: AN EXAMPLE OF HOW TO WRITE TO DATAINSPEKTIONEN
Datainspektionen
Fack
103 60 Stockholm 3
ANS@KAN OM TILLST$ND
Registret avses tas i drift den 1.7.76.
Tidigare tillst}nd har ej meddelats.
Registeransvarig: Kungliga Myndigheten, Avdelning D,
111 11 Stockholm 11, tel 08-11 11 11.
Kontaktman: Sven Svensson.
Registrets ben{mning: KONTKT.ADR.
#ndam}let med registret: F`rteckning `ver vetenskapliga
kontakter vid Kungliga Myndigheten, Avdelning D. Uts{ndning
av forskningsrapporter. Personliga kontakter. Information
om myndighetens verksamhet. Adressering av brev.
Forts{ttning se bilaga 1.
Kungliga Myndigheten Avdelning D
Sven Svensson
Bilagor: 1-11
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 11
APPENDIX A: AN EXAMPLE OF HOW TO WRITE TO DATAINSPEKTIONEN
BILAGA 1
#NDAM$L
Registret upptar s}dana personer, f`retag och institutioner
som Kungliga Myndigheten, Avdelning D, har utbyte av
erfarenheter med.
Avdelning D handhar datorverksamheten inom Kungliga
Myndigheten.
Registret anv{nds i s}dana fall, d} avdelningen beh`ver
kontakt med personer med intresse f`r dess verksamhet.
Exempel:
1) Uts{ndning av vetenskapliga rapporter.
2) Kallelse till kurser och konferenser.
3) Meddelande om nya resultat eller f`rfr}gan om synpunkter.
4) F`rfr}gan om den kontaktade `nskar kvarst} i registret.
Man kan s{ga att registret p} m}nga s{tt anv{nds p} samma
s{tt som en s}dan adressbok, som m}nga m{nniskor har `ver
v{nner och bekanta.
UTBYTE AV INFORMATION MED UTLANDET
Delar av inneh}llet i adressregistret rapporteras till
Kungliga Myndighetens motsvarighet Kongelige Institutt i
Danmark. D{r anv{nds adresserna p} ett likartat s{tt som
hos oss i ett likartat datorregister.
UPPGIFTER SOM ING$R I DEN AUTOMATISKA DATABEHANDLINGEN
Varje post best}r av namn, adress och intresseprofil.
Intresseprofilen grundas p} uppgifter fr}n den registrerade
personen, och anger vilken del av Kungliga Myndighetens
verksamhet som personen {r intresserad av. Vid
datork`rningar kan vi d{rigenom selektera vilka som skall f}
viss information p} grundval av mottagarens intresseprofil.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 12
APPENDIX A: AN EXAMPLE OF HOW TO WRITE TO DATAINSPEKTIONEN
VEM SOM L#MNAR UPPGIFTERNA
Uppgifter till registret inf`res n{r en person tar kontakt
med Kungliga Myndigheten, vilket kan ske per telefon, per
brev eller via den blankett som bifogas som bilaga 1b.
SAMK@RNING MED ANDRA REGISTER
Ut`ver det informationsutbyte med Danmark som beskrivs ovan
sker ingen samk`rning med andra personregister.
BILAGA 2: BEARBETNING
Uts`kning av personer genom s`km`nster i form av Booleskt
uttryck.
Halvmanuellt urval av personer i dialog vid terminal.
Utskrift av namn och adress p} etiketter.
Utskrift av registret eller delar d{rav p} magnethband,
skivminne, h}lremsa, h}lkort eller lista.
BILAGA 3: UTDATA
a) Namn och adress.
b) Hela postens inneh}ll.
Eftersom registret utg`r offentlig handling, har varje
svensk medborgare r{tt att ta del av registrets inneh}ll.
BILAGA 4: TEKNISK UTRUSTNING
Dialogdator DECsystem-10 Vid Stockholms Datamaskincentral
f`r h`gre utbildning och forskning. Datorn har ett v{l
fungerande skyddssystem f`r att f`rebygga att obeh`riga tar
del av eller {ndrar register. Skyddsystemet {r godk{nt av
FOA f`r bearbetning av milit{rt hemliga data. Backup tas
varje dag som registrens inneh}ll har {ndrats.
ADRES - A PROGRAM FOR HANDLING ADDRESS FILES Page 13
APPENDIX A: AN EXAMPLE OF HOW TO WRITE TO DATAINSPEKTIONEN
BILAGA 5: UTTAG P$ BEG#RAN AV DEN REGISTRERADE
Om en s}dan f`rfr}gan inkommer, s} kommer den att besvaras
inom tv} veckor (undantag: semestertider).
BILAGA 6: R#TTELSE AV ORIKTIG UPPGIFT
S} fort meddelande inkommit om oriktig uppgifter, kommer
denna att r{ttas f`re n{sta datork`rning med registret.
BILAGA 7: GALLRING AV REGISTRET
Sm{rre gallring g`rs fortl`pande. St`rre gallring sker
genom brev till alla registrerade med f`rfr}gan om de vill
vara kvar i registret. I vissa fall sparas en backup av
registret f`re gallringen p} magnetband.
BILAGA 9: REKONSTRUKTIONSM@JLIGHETER
Backup tas p} s}dant s{tt, att registret alltid kan
}terst{llas till sitt utseende p} kv{llen n{rmast f`reg}ende
arbetsdag.
BILAGA 10: ANDRA S#KERHETS$TG#RDER
Vi tror att datainspektionen {r v{l medveten om de
datas{kerhets}tg{rder som vidtas vid Stockholms
Datamaskincentral f`r h`gre utbildning och forskning.
BILAGA 11: LOGGNING
Varje k`rning p} s}dant projektnummer, inom vilket datorns
operativsystem till}ter access till registret, loggas.
Varje montering av magnetband loggas.