Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Saves file in permanent system file domain. (CM)
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