Google
 

Trailing-Edge - PDP-10 Archives - decuslib20-04 - decus/20-0109/adres.hlp
There are 2 other files named adres.hlp in the archive. Click here to see a list.
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.
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.
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.
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 .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.
INPUTTING OR OUTPUTTING FILES TO OTHER PROGRAMS

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".

[Help on /SELECT continues on the next page]
COMMAND SWITCH:  /SELECT CONTINUED

Priority of operator characters:
1) "(" and ")"
2) -
3) &
4) +

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).
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.

More information is given in ADRES.MAN.