AT&T UNIX User manual

@1985, 1986 AT&T
All Rights Reserved
Printed in USA
NOTICE
The information in this document is subject to change without notice. AT&T
assumes no responsibilityfor any errorsthat may appear in this document.

Important Information for Users of
UNIX PC 3.51 Software
This section contains important information for using
AT&T UNIX® PC version 3.51. Please review this
information before using the AT&T UNIX PC, and keep it
with your AT&T UNIX PC Owner's Manual. Page numbers below
refer to related information in this guide.
NEW FEATURES:
1 Pages 3-15, 3-99, 4-68, C-1: Expert users may
now
open two types of UNIX System windows from
the Office. Selecting I UNIX System I will open
a bordered window with your default shell
running. Selecting IFul1 Screen UNIXI will
open a 24 x 80 character window wi thout
borders. The default shell runs here also.
The Full Screen UNIX window is identified in
the Window Manager menu of open windows with
the label "Unknown Contents."
2 Page 3-20. When your hard disk is nearly full,
you will be notified by a message icon that
pops up on the status line. When this icon
appears, point to it with the mouse and press
<B1> or press <Msg> to see the warning message.
Whenever you get this message, it is a good
time to examine your files and delete those
that you no longer need.
3 Page 3-28. There is now a quick way to move
between windows by using the <Shift>-<Suspd>
and <Shift>-<Rsume> keys.
a To display the next window press:
<Shift>-<Suspd>
b To display the previous window press:
<shift>-<Rsume>
"Next" and "Previous" are defined by internal
system lists of windows.
1

AT&T UNIX PC 3.51 Important Information
2
4 Page 3-120. Floppy disks can now be formatted
with either 8 or 10 sectors per track. If you
want to make a backup copy of your UNIX PC
system software, you should first format your
floppy disk(s) to contain 10 sectors per track.
a Point to I Floppydiskl in the Office and
press <Enter>.
b Point to IFloppy Disk System Format (10
sectors) I and press <Enter>.
c Insert the blank floppy disk that is to
be formatted and follow the instructions
on the screen.
Note that the Floppydisk menu entry, IFloppy
Disk Regular Format (8 sectors) I, is identical
to the IFloppy Disk Format I function that was
used in version 3.5 and earlier versions.
In making backup copies of the system software,
note that the GSS Drivers and GSI VDI are
formatted 8 sectors per track.
For any application software where the format
of the disk is unknown, you can quickly
determine its format:
a Place the floppy disk in the drive.
b Flip the drive lever down.
c Open I UNIX System I from the Office window.
d Type: iv -t /dev/rfp020 <Return>
This will give you a complete description of
the disk. Look for "8" or "10" on the line
that identifies the number of physical sectors
per track.

AT&T UNIX PC 3.51 Important Information
5 Page 3-134. You may display the status of each
printer connected to the UNIX PC.
a Select I Printers I from the Office.
b Select I Printer Status I from the Printers
Menu.
The status of each printer will be displayed.
6 Pages 4-11, 4-15. The UNIX PC now supports
Hardware Flow Control on its serial ports.
Hardware Flow Control may be used to improve
communications between the UNIX PC and other
devices that also support hardware flow
control. AT&T Information System Network (ISN)
is such a network.
Hardware Flow Control is particularly useful
if it is the only flow control mechanism
available, because the typical software
(XONjXOFF) flow control is unavailable or
disabled by the application that uses full
8-bit character set across the serial link.
The UUCP program and the EMACS editor are two
such applications. Each serial port has a
separate Hardware Flow Control option that can
be configured independently. If Hardware Flow
Control is unavailable on the device to which
you are connected, it should not be enabled on
the UNIX PC.
To set up the Hardware Flow Control:
a Select I Administration I from the Office
window of install.
b Select I Hardware
<Return>.
Setup I
and press
c Select IRS232 Setup I or IRS232 Expansion
Setup I and press <Return>.
If you have chosen IRS232 Expansion
Setup I , select the port number.
3

AT&T UNIX PC 3.51 Important Information
4
d Point to the Enable Hardware Flow Control '?
field. Select <Yes> to enable Hardware
Flow Control. Select <No> to disable it.
7 Page 4-26. There are two IPC drivers listed
in the Loadable Device Driver Interface window:
standard sys V IPC (lipc)
and
Enhanced sys V IPC (nipc)
The standard IPC driver :viII be loaded by
default and should rema~n so under most
circumstances. The enhanced IPC driver is a
noncertified version containing fixes for
specific system problems. If when running a
particular software package you receive a
system message indicating:
kernel crash: rmfree panic
you should unload the standard IPC driver and
load the enhanced IPC driver. Follow the
directions in the Owner's Manual.
8 Page 4-39. The electronic mail names of other
computers may now have up to eight (8)
characters.

AT&T UNIX PC 3.51 Important Information
TECHNICAL TIPS:
1 Pages 3-20. Make sure you have closed all of
the windows that you have opened by pressing
the <Msg> key or pointing to the [I!] or [!]
icon. While one of these windows is open, the
date and time field cannot be updated and
system functions that are controlled by the
crontab file will not execute.
2 Pages 3-20, F-l. If you have not installed an
electronic mail package on your UNIX PC, you
can still receive electronic mail by opening a
UNIX
window and typing mail, by pointing the
mouse to the envelope icon and pressing <Bl>,
or by pressing the <Msg> key.
When you access mail by using the <Msg> key or
mouse and save the mail , the mail wili be stored
in the directory /etc/lddrv. If you access
mail from the shell, mail will be saved in the
current directory.
If you do not have an electronic mail package
installed, you should access mail from the
shell.
3 Page 3-88. The Security command will allow
you to change the owner of a file to several
logins including some system logins. Do not
change the owner of a file to any of the
following logins: root, uucp, uucpadm, adm,
daemon, nuucp, or Ip. You will not be allowed
to change the ownership back to the original
login if you do this.
4 Page 3-95. The disk heads on the model 3Bl do
not need to be parked using the Diagnostic
Disk. These disk heads are parked
automatically when the shutdown command is
used. Disk heads on model 7300 must be parked
with the Diagnostic Disk as described on page
3-95 in the this manual.
5

AT&T UNIX PC 3.51 Important Information
6
5 Page 3-114. Do not turn the lever or remove
the floppy disk while the red I ight on the disk
drive is lit. wait until the procedure that
is executing has completed, or until you have
closed the Floppydisk window.
6 Page 3-141. Do not open the Office of another
user using I Other Users I while you have a data
call in process. When you exit from the Office
of the other user, the data call will be
terminated. -
7 Page 4-36. When sending mail to a system which
is a part of a network such as ISN, long or
complicated send and receive strings may be
required. These entries must be set up via
the UNIX shell by editing the file
/usr/lib/uucp/L.Sys. The entries can not be
made using the Mail setup form in the
Administration menu. The entries should be
made according to the instructions supplied by
the person in charge of administering the
receiving computer on the network.
A typical "long" entry in /usr/1ib/uucp/L.sys
is described below. For more information about
the uucp system, see the UNIX Programmer I s
Manual, Volume 2; Holt, Rinehart, and Winston;
New York, 1983.
The example below shows how to dial up a remote
system via a switch. For lack of space, this
example is shown on two lines. The entry should
be typed on one line.
sys . Any J?hl 1200 1234567 1111 \d\r NAME? sys GO
\r 1n:--1n: nuucp word: P/W
Each field in this sample entry is described
below.
sys The name of the remote system.

AT&T UNIX PC 3.51 Important Information
Any This is the string which indicates
the days-of-the-week and times-of-
the-day when the system may be called
(e.g.MoTuTh0800-1730). The day
phI
1200
1234567
portion may be a I ist containing
these abbreviations:
SU Mo Tu We Th Fr Sa
or it may be Wk for any weekday or
Any for any day. The time should
should be a range of times (e.g. 0800-
1230) . If no time portion is
specified, any time of day is assumed
to be okay for the call.
This is the device to be used for
the call. The last part of the
special file name is used (e.g. phI
for phone line 2, phO for phone line
1, and ttyOOO, ttyOOl ... for serial
ports, etc.)
This is the line speed for the call
(e.g. 300, 1200, etc.)
The phone number. For serial ports,
the field contains the same string
as used for the device field (e.g.
ttyOOO. )
The rest of the fields:
The login information is given as a
series of fields and subfields in
the format:
expect send [ expect send] ...
where expect is the string expected
to be read and send is the string to
be sent after the expect string has
been received.
7

AT&T UNIX PC 3.51 Important Information
8
1111
\d\r
NAME?
sys
GO
\r
The expect field may be made up of
subfields in the form
expect[-send-expect] ...
where the -send is sent if the prior
expect is not successfully read and
the -expect following the send is the
next expected string.
There are two special names
available to be sent during the login
sequence. The string EOT will send
an EOT character and the string BREAK
will send a BREAK character. -----
expect nothing.
delay 2 seconds (\d) and
carriage return (\r).
interacting with the switch)
send a
(start
expect the string "NAME?" (the
switch prompts for system name)
send the string "sys." (answer the
prompt)
expect the string "GO." (the switch
indicates the requested system is
connected)
send a carriage return. (start
interacting with the system)
in:--in: expect the string "in." (actually
"login:"). If not received, send a
newl ine character and expect " in: "
again. (the system prompts for the
login id)
nuucp send the string "nuucp." (answer the
login prompt)
word: expect the string "word:".
(actually "Password:"). (the system
prompts for the password)

AT&T UNIX PC 3.51 Important Information
P IW send the string P IW . (answer the
password prompt)
8 Page 4-55. If you are installing a new version
of a software package that is already installed
on your UNIX PC, you should remove the old
version before you begin the installation
procedure. See page 4-59 for instructions.
9 Page 4-68, 4-70. You may calculate the disk
space that is used by each user by opening the
User Login Interface window and pressing the
[Compute Space] screen key. Disk usages will
be computed and displayed within 1-2 minutes.
If any users have been deleted from the system,
these values may be incorrect.
To display the correct value for each user,
highlight the user and press <Enter>. The form
that is displayed will contain the correct
values.
10 Page 4-68, item 6. The login name may consist
of one to eight characters. The first
character must be alphabetic. The remaining
characters may be letters or numbers. No
uppercase characters may be used.
11 Page 4-75. To change a password, you should
try a combination of alphabetic and numeric
characters. You should avoid using characters
such as @, backspace, ", #, etc.
12 Page 4-81. The national date for changing
daylight savings time has been changed. To
prevent your UNIX PC from automatically
changing to Daylight Saving Time on the wrong
date, you must set it up so that it will not
change the time automatically. You must
manually change the time on the appropriate
dates.
In the Set Date and Time form, point to the
field labeled Is Daylight Savings Time EVER
Used? and select NO.
9

AT&T UNIX PC 3.51 Important Information
10
13 Page 4-90. If your system receives messages
from other computers or if you have users whc
may log on from remote locations, disable all
communication ports before doing a systerr
backup. otherwise, some files may be changing
while the backup is taking place. Enable
communications once again after the backup is
complete.

Attention Persona1 Ca1endar Users!
If you have AT&T Personal Calendar software installed
on your system, or if you are about to install it, read
the attached documentation for information about the
new Personal Calendar features included in the 3.5
Foundation Set software. Note that this information is
not described in your AT&T UNIX® PC Personal Calendar
User's GUjde.
The following Personal Calendar enhancements are
included in the 3.5 Foundation Set software:
o You can use Personal Calendar from a remote
terminal.
o The EDIT KEYWORD and EDIT CALENDAR screen
keys correspond to the F3 function key
instead of Fl.
o An EXIT CALENDAR screen key, corresponding to
the Fl function key, exits Personal Calendar.
o A new Calendar Preferences entry, Ca1endar
defau1t disp1ay mode, lets you select which
calendar (Month, Week, or Day at a Time)
appears when you open Personal Calendar from
the Office.
o A To-Do List lets you keep track of things
you have to do for a particular month, week,
or day.
Refer to the AT&T UNIX ® PC Remote Access User's Guj de
for information about using a remote terminal. Refer
to the attached pages for detailed information about
the new location of the EDIT KEYWORD screen key and the
new EXIT CALENDAR screen key, the Calendar default
display mode, and the To-Do List.
1

The EDIT KEYWORD and EDIT CALENDAR Screen Keys
The location of the EDIT KEYWORD and EDIT CALENDAR
screen keys is changed from PI to P3. The following
screens are affected:
The Month at a Time calendar:
SEPTEMBER 1986
."..,...._-+:~_-+=:----I Su H Tu W Th F Sa
1 2 3 _ 5 6
-==---I::~---I=::-----i 7 8 9 10 11 12 13
1_ 15 16 17 18 19 20
~--+---+---+-_---JI----+---+------t ~~ g ~~ 2_ 25 26 27
--------
2

The Day at a Time calendar:
APPTS OF WEDNESDAY AUGUST 20,
7:00
TIME COMMENT I f-!T~IM::.::E,-:- __ .-:::.:CO~M~ME~N:.:...T ___ --1
12:1l1l
8:1l1l 1:01l
9:01l 2:01l
1(1:00
3:01l
11:01l 4:1l1l
.:::
:p:
Note:
--------
3

The EXIT CALENDAR Screen Key
The EXIT CALENDAR screen key, Fl, lets you leave
Personal Calendar. The following screens are affected:
The Month at a Time calendar:
1986
Tu 1/ Th r Sa
1 2 3 _ 5
F:"--~---,~'-----,':-=---,..!...:..!--,:'-----T::=---I 6 7 8 9 10 11 12
13
14 15 16 17 18 19
~--r.----,r.:----i-;----i:;---t::----t;:-----1 20 21 22 23 24 25 26
27 28 29 30 31
SEPTEMBER 1986
."...,...--+::-::----+.:..,,----1 Su H Tu 1/ Th r Sa
1 2 3 _ 5 6
-=-=----+::-=----I::c::----j 7 8 9 10 11 12 13
141516 17 18 19 20
f=---/----/-----if----ir----i---t-----i ~~ ~~ ~~ 24 25 26 27
--------
4

The Week at a Time calendar:
7: BBA I--_--f __ -+ __ -+ __ -+- __ +- __ +-_---1
8:
BBA
I--_-+ __ -+- __ +- __ +-_-+ __ -+-_--!
9:BBA
1B :
BBA
I-----I----+---+----+---4----4-------I
11 :BBAI--_--f __ -+ __ -+ __ -+- __ +- __ +-_---1
12:BBP 1-----1----+---+----+---4----4-------1
1:
BBP
I--_--f __ -+ __ -+ __ -+- __ +- __ +-_---1
2:BBPI-- ____ I-- ____ I-- __ ~I__--~~---4-----4-- __ ~
3:
BBP
I--_--f __ -+ __ -+ __ -+- __ +- __ +-_---1
4:BBP'----_-.l __ ---l. __ -1- __ ---'- __ -'-- __ ..L..-_-.l
---
-----
5

Setting Calendar Default pj~lay Hade
By default, you see this Month at a Time calendar when
you open Calendar:
SEPTEItER 1986
:::-:---+.:-::----+.:-:-----1 Su H Tu W Th F Sa
1 2 3 _ 5 6
::::-;:---t=----t::-:----\ ~_ ~5 ~6 ~~ ~: ~~ ~~
1=-_--\ __ -+ __ -+- __ -+- __ +- __ +-_----1 ~~ ~~ ~~ 2_ 25 26 27
____ III __ _
You can use the calendar with the preset monthly
display, or you can change the Calendar default display
mode field to show the Week at a Time or Day at a Time
calendar by default when you open Calendar.
To change the Calendar default display mode:
1 Select I Preferences I from the Office.
6

2 Select I Calendar I from the Preferences menu.
You see this Calendar Preferences form:
5J Pl'efel'ences I1Ji
Calendar default display .ode IItltmiW1nnma
Calendar display in 24 hour foraat Ito
Start hour for Calendar screen displays 7 : BB AM/PM AM
Auto delete appointments Ito
Auto delete appointment period (days)
Auto delete alarms Ito
Auto delete alarll period (days)
IIilII
7

3 Press <Mark> to select Day at a Time, Week at
a Time, or Month at a Time.
4 Press <Enter>.
Creating Editing and Printing a Things-To-Do List
You can use the Personal Calendar to help you manage
your time by creating a To-Do list.
Your To-Do list can be as long as you like. Once
you've created a To-Do List, you can display it, modify
it, delete it, or print it. You can save your To-Do
list in your Filecabinet.
Creating a To-Do List
You can create a To-Do List from the Month, Day, or
Week at a Time Calendar.
You have room for a total of 60 characters per line (or
item), and you can view 17 lines at a time. To view
the next set of 17 lines, press the Page key. To view
the previous 17 lines, press the Shift--Page key
combination.
To create a To-Do List:
1 Select I Calendar I from the Office.
2 Press [TO_DO LIST] .
The To-Do List form appears:
III
8