 |
» |
|
|
|
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: To save the temporary file TEMPFL
as a permanent file with the same name, enter: To save the temporary file DATAFILE
in the group GROUPX,
enter: 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
|
