HP 3000 Manuals HP 3000 Manuals
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: 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 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.
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.
Use the SAVE command to save KSAM XL files. Since the KSAMUTIL utility
is not supported for KSAM XL, the SAVE command is the only method of
doing so.
Use
This command may be issued from a session, job, program, or in BREAK.
Pressing Break has no effect on this command.
Examples
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 are searched, for example:
SAVE DATAFILE
RENAME DATAFILE,DATABASE
Related Information
Commands PURGE, LISTFILE, LISTFTEMP, RENAME
Manuals None