Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Saves file in permanent system file domain.
SAVE {$OLDPASS,newfilereference}
{tempfilereference }
$OLDPASS A system-defined temporary file. After this file is
saved, it can no longer be referenced by the name
$OLDPASS.
newfilereference New actual file designator assigned to $OLDPASS when
it is made permanent. Its format is
filename[/lockword][.groupname[.acctname]]
If groupname is used, it must indicate a group to
which you have SAVE access, as defined by your
account manager. If groupname is omitted, the logon
group is assigned.
tempfilereference Actual file designator of the temporary file to be
made a permanent file under the same designator.
The file is deleted from the job/session temporary
file domain and entered into the system file domain.
Its format is
filename[/lockword][.groupname[.acctname]]
If groupname is used, it must indicate a group to
which you have SAVE access, as defined by your
account manager. If groupname is omitted, the logon
group is assigned.
The SAVE command saves a temporary file by converting it to
a permanent file in the system file domain. This command is
necessary when the subsystem or program that created your
file does not allow you to save it while the program is
executing.
You must specify a new filename for $OLDPASS, because MPE/iX
does not allow $OLDPASS as a permanent filename. If there
is a file in the temporary domain with the same name
specified by newfilereference, MPE/iX will attempt to save
$OLDPASS by creating a new temporary file. This temporary
filename, created by SAVE, will start with S and be
followed by seven digits Sdddhhmm, where ddd is the Julian
day of the year, hh is the hour of the day, and mm is the
minute. The new temporary file will then be saved under the
filename specified by newfilereference, and be deleted from
the temporary domain. If both temporary and permanent files
exist under the same name specified by newfilereference, the
temporary SAVE file will be saved as a permanent file. In
this case, a printed error message will state the filename
for the new SAVE file. It can be renamed later using
RENAME.
This command applies only to temporary files on disk. It is
similar to opening a file with the FOPEN intrinsic, and then
closing it with the FCLOSE intrinsic, using a permanent file
disposition.
This command may be issued from a session or a job, in BREAK,
or from a program. Pressing [Break] has no effect on this
command.
To save the temporary file $OLDPASS, containing an object
program, to the program file PROGFILE, enter
SAVE $OLDPASS,PROGFILE
To save the temporary file TEMPFL as a permanent file with
the same name, enter
SAVE TEMPFL
To save the temporary file DATAFILE in the group GROUPX,
enter
SAVE DATAFILE.GROUPX
To save a temporary file (other than $OLDPASS) and change
its name, use the SAVE and RENAME commands. Only the
logon group and account directories in the current session
will be searched.
For example
SAVE DATAFILE
RENAME DATAFILE,DATABASE
Commands: PURGE Back to Main Index