.BG
.VE $Header: /usr3/s/current/s/.help/RCS/attach,v 1.2 83/12/30 19:24:25 rab Exp $
.FN attach
.TL
attach: Attach a New Data Directory
.CS
attach(file, pos)
.PP
.AG file
character string giving the name of a new data directory to be
accessed.  The name must be a correct UNIX file-system pathname,
such as "/usr/abc/swork".
.AG pos
position in data directory search list that `file' should occupy.
The data directories originally in position `pos' or beyond
are moved down the list after `file'.
Default, after all current data directories. If pos=1, `file' will
be attached as the working directory (you must have write permission).
.PP
When a user logs on, three data directories are attached: working, save, and
shared. See `detach' for removing a data directory from search list,
and `search' for the current list of attached data directories.
Data directories are attached only for the current invocation of S.
Only directories containing S datasets can be attached as S data directories;
ordinary ASCII data files should be read by means of `read'.
.EX
attach("/usr/joe/sdata")  # attach save directory belonging to joe
.KW basic*
.KW data management
.WR
