RESTORE [ Native Mode Spooler Reference Manual ] MPE/iX 5.0 Documentation
Native Mode Spooler Reference Manual
RESTORE
Stored linked and unlinked spool files can be restored to become linked
or unlinked. Any spool file restored using RESTORE into OUT.HPSPOOL
becomes linked. If a spool file is restored elsewhere, it becomes
unlinked.
To avoid potential ID and name conflicts, spool files restored to
OUT.HPSPOOL (and, therefore, linked) are assigned new SPOOLIDs.
The restoring of files to OUT.HPSPOOL occurs in one of the following
three ways:
* By restoring files stored to tape from the OUT.HPSPOOL group. If
you have SM or OP capability, you can restore files created by any
user even if that user does not exist on the system. If you have
AM capability, you can restore files created by any user in your
account provided the user exits. If you are a general user, you
can restore files that you created.
* By specifying the GROUP=OUT ;ACCOUNT=HPSPOOL option with RESTORE.
You may be logged on anywhere, but you must have SM or OP
capability.
NOTE For the last method, RESTORE also restores files that are not spool
files in the selected file set. Therefore, this method is not
recommended.
If you have SM or OP capability and you restore files to OUT.HPSPOOL, you
must explicitly specify the CREATOR option with RESTORE to check that the
creating user exists on your system. Otherwise, RESTORE restores the
file even if the creating user and account do not exist.
NOTE The specified creating user must also have nonshareable device (ND)
capability whenever an SM or OP uses the ;CREATOR option.
If you have AM capability and you restore linked spool files created by
other users in your account, those users must have ND capability at the
time of the restore, or the restore fails for that file. You, the
restoring user, also must have ND capability or you cannot allocate the
tape drive to restore the files.
For spool files, the RESTORE options ;CREATE=GROUP and ;CREATE=ACCOUNT do
not create the HPSPOOL account or any groups in it if they do not exist.
You cannot restore any spool files to HPSPOOL if the account does not
exist. Since linked spool files are associated with the HPSPOOL account
and the creator's account, there is an ambiguity in ;CREATE=ACCOUNT.
Since you should never purge HPSPOOL, RESTORE resolves the ambiguity by
not restoring the spool file if HPSPOOL is missing.
Suppose OUT.HPSPOOL exists and you have SM or OP capability. If you
specify CREATE, RESTORE creates the spool file creator's account and user
if they do not exist. The file is restored to OUT.HPSPOOL.
If you specify ;CREATOR=newuser
;GROUP=OUT ;ACCOUNT=HPSPOOL, you change only the file's account not the
creator's account. Suppose that USER.ACCT originally created spool file
ABC and that ABC is stored from the ACCT account. Enter:
FILE TAPEFILE;DEV=TAPE
STORE ABC.USER.ACCT;*TAPEFILE
If you restore ABC using ;CREATOR=NEWUSER ;GROUP=OUT ;ACCOUNT=HPSPOOL,
the result is file SPOOLID.OUT.HPSPOOL and the creator is NEWUSER.ACCT.
Suppose that you restore ABC as described above. Enter:
FILE NEWTAPE;DEV=TAPE
RESTORE *NEWTAPE;ABC;CREATOR=NEWUSER;GROUP=OUT;ACCOUNT=HPSPOOL
Suppose O23 is the SPOOLID assigned to file ABC as it is restored. Then
ABC is created on the system as O23.OUT.HPSPOOL and the creator is
NEWUSER.ACCT.
If you restore a file to OUT.HPSPOOL and that file is destined for a
device or class not configured on the target system, the file is put in
the PROBLM state. The system links the file to the queue and creates the
queue if necessary.
The ;SHOW=LONG option of the RESTORE command displays both the original
SPOOLID and the new SPOOLID of spool files restored to OUT.HPSPOOL.
MPE/iX 5.0 Documentation