CL Command Reference - CRTSAVF
CL Command List > CRTSAVF Reference
Description:
The Create Save File (CRTSAVF) command creates a save file.
A save file can be used with save and restore commands to contain data that would otherwise be written to tape or optical media. A save file can also be used like a database file to read or write records that contain save or restore information. A save file can also be used to send objects to another user on the Systems Network Architecture distribution services (SNADS) network.
Restrictions:
. An online save file should only be used for save/restore data. When restoring objects from the save file, the data in the file must have been produced by a save command. When records are written to a save file by using a high-level language program, the records must contain data produced by saving objects into the save file.
. The records retrieved from a save file contain sequencing checksum information that is validated by the system when records are inserted into a save file. An attempt to insert records that are either out of sequence or have been changed since retrieval from a save file are rejected.
. A save file can contain the output of only one save operation and one library, and all objects in the save file must have been saved from the same library. If the Send Network File (SNDNETF) command is used to send a save file, the maximum size of the save file is approximately 2 billion bytes. The number of objects saved in a save file is identical to the number of objects saved when saving to tape or optical media, as long as the file¡¯s maximum size is not exceeded. The exact number of objects saved into a save file depends on the object types and the object contents.
. You must have object operational (*OBJOPR) authority to the CRTSAVF command in order to create a duplicate save file object or to restore a save file object.
. You must have add (*ADD) and read (*READ) authority to the library in which the save file is to be created.
Examples:
CRTSAVF FILE(ONLINE) TEXT(¡¯Online save file¡¯)
This command creates an online save file named ONLINE in the current library. The save file is in the system ASP with no maximum number of records. The public has no authority to this file; only the object owner and users that have the object owner user profile as their group profile can use this save file.