The FILE.SAVE command creates a Pick style FILE-SAVE tape.
Format
FILE.SAVE {account.list} {options}
where
account.list | is a list of the names of the accounts to be saved. If omitted and the default select list is active, this list is used to determine the accounts to be saved. Otherwise, all accounts referenced in the QMSYS ACCOUNTS file are saved. |
options | specifies options processing features: |
BINARY | suppresses translation of newlines to field marks when saving directory files. Use this option when saving binary data. |
DET.SUP | suppresses display of the names of files saved. |
EXCLUDE.REMOTE | causes remote files to be omitted as described below. |
INCLUDE.REMOTE | causes remote files to be saved as described below. |
NO.QUERY | suppresses the confirmation prompt when using a select list.. |
The FILE.SAVE command creates a Pick style "compatible mode" tape and saves one or more QM accounts to it.
The tape to be created must first be opened to the process using the SET.DEVICE command.
The command reports its progress by displaying the name of each file as it is saved unless the DET.SUP option is used.
FILE.SAVE normally saves all files referenced by F-type records in the VOC of the account being saved. There is a three level mechanism by which files can be excluded:
1. | Field 5 of the F-type VOC entry can contain |
D | Save the dictionary but omit the data element |
E | Exclude this file from an ACCOUNT.SAVE or FILE.SAVE |
I | Include this file in an ACCOUNT.SAVE or FILE.SAVE |
2. | If field 5 of the VOC record does not specify any of the above flags, the EXCLUDE.REMOTE and INCLUDE.REMOTE options are used to determine whether remote files (those with a directory delimiter in their pathnames) are to be saved. |
3. | If neither of the above methods of file selection is used, the value of the EXCLREM configuration parameter is used to determine whether remote files are to be saved. |
By use of a combination of the above methods, it should be possible to achieve total control of what is included in a save.
See also:
ACCOUNT.RESTORE, ACCOUNT.SAVE, FIND.ACCOUNT, RESTORE.ACCOUNTS, SEL.RESTORE, SET.DEVICE, T.ATT, T.DUMP, T.LOAD, T.xxx
|