.tf CAL I 4/21/86
.sh "NAME"
cal \- change access level
.sh SYNOPSIS
cal
[pathname]
.sh "DESCRIPTION"
Change access level, cal, allows a user to create an environment at a
new security level, or to return to a previously interrupted
environment.  If the "pathname" argument is given, the level of the
environment will be that of the file specified by "pathname"; otherwise
cal will prompt for a new access level.  If an environment already
exists at the requested level, cal will revert to that environment;
otherwise a new environment will be created.
.s3
Like login, cal will create the new environment by spawning the
user/supervisor domain programs given for the user's login id in the
user access authentication database.  However, as an interim measure,
if there is no program specified in the database, cal will prompt for
the pathname of the supervisor domain program to be spawned.
.s3
Each user environment corresponds to a different terminal path.  There
are a fixed number of paths on which user environments can be created.
(This is specified in the Secure Server Process SSP(VIII)).  One of
these is used by login for the user's initial environment; the
remainder are available for allocation by cal.
.sh FILES
.lp 30 25
/sys/dataBases/user     user access authentication database
.lp 30 25
/sys/dataBases/group    group access authentication database
.lp 30 25
/sys/dataBases/terminal terminal profile database
.lp 30 25
/sys/dataBases/system   system profile database
.i0
.i7
.sh "SEE ALSO"
SSP(VIII),
login(I),
user(V),
group(V),
terminal(V),
system(V)
.sh DIAGNOSTICS
.lp 30 25
"object not found"      pathname does not exist
.lp 30 25
"no idle paths"         no idle terminal paths available
.lp 30 25
"you cannot change to that level"  do not have privilege to change to that level
.lp 30 25
"cannot get level of object" do not have access to that object 
.lp 30 25
"could not change paths" do not have access to that pathname
.i0
.sh NOTES
This command is implemented internal to the Secure Server Process,
SSP(VIII).
Failed level changes should be audited.
