HP 3000 Manuals

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