MPE/iX Commands Reference Manual (32650-90877)
462 Chapter12
Command List X
Commands SAVE thru SHUTQ
Commands SAVE thru SHUTQ
SAVE
Saves a file in the permanent system file domain.
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.
newfile-reference
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.
tempfile- reference
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 Notes
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 file name. If there is a file in the temporary domain with the same name
specified by
newfilereference
, MPE/iX attempts to save $OLDPASS by creating a new
temporary file. This temporary file name, created by SAVE, starts with S and is followed by
seven digits: S
dddhhmm
, 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 is then saved under the file name specified by
newfilereference
, and is deleted from the temporary domain. If both temporary and
permanent files exist under the same name specified by
newfilereference
, the
temporary SAVE file is saved as a permanent file. In this case, a printed error message
states the file name for the new SAVE file. It can be renamed later using the RENAME
command.