SAVE


SAVE

     Saves file in permanent system file domain.  (CM)

SYNTAX


SAVE {$OLDPASS,newfilereference}
{tempfilereference }


PARAMETERS


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


OPERATION


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.


EXAMPLE(S)

     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

ADDITIONAL INFORMATION

Commands:   PURGE