 |
» |
|
|
|
The spool file tape transfer utility (SPFXFER) transports spool files between MPE/iX systems containing the native mode spooler and MPE systems that do not. The SPFXFER utility is located in the PUB group of the SYS account. This utility can do the following: transfer NMS spool files to tape in a format that SPOOK and SPOOK5 (on MPE V/E releases G.02.B0 and later) can read read SPOOK tapes from any release of MPE/iX and MPE V/E
You can use SPFXFER to transport spool files between any two NMS systems, also. Generally, though, use STORE and RESTORE. Information about STORE and RESTORE is in chapter 2 of this manual. SPFXFER has four commands. They are: HELP, INPUT, OUTPUT, and EXIT. You may truncate each command at any point. For example, E, EX, EXI, and EXIT are all valid forms of the EXIT command. To run SPFXFER, enter: or if SPFXFER is in the search path defined by your HPPATH system variable, enter: Most MPE/iX commands and user defined commands (UDCs) may be executed at the SPFXFER prompt (>) by preceding the command with a colon (:). For example, to execute the MPE/iX command LISTSPF within SPFXFER, enter: Listing the commands |  |
The HELP command lists all SPFXFER commands and their syntax. The syntax of the command is as follows: It has no parameters. To use the command, enter: Restoring spool files onto the system disk |  |
The INPUT command reads output spool files from tape onto a system disk. The user and account of the owner need not exist in the system directory, nor does the INPUT command create them. The system places the spool files in the OUT.HPSPOOL account and assigns them new SPOOLIDs (spool file identification numbers). The spool files are linked to the spooling subsystem.  |  |  |  |  | NOTE: The system does not restore user labels because NMS spool files do not have them. |  |  |  |  |
For each restored spool file, SPFXFER displays: the old and the new spool file identifications new job or session number in the format #Jnnnn or #Snnnn (The single quote distinguishes these spool files from those originally created on this system.) the target device or class name
A restored spool file has the same output priority as it did before it was stored on tape. The syntax for INPUT is:
INPUT [ [username[.accountname]]
[spoolid[,spoolid] ...] ];*tapefile
|
Storing linked spool files onto tape |  |
The OUTPUT command stores linked output spool files from OUT.HPSPOOL to tape in a SPOOK-compatible format. Then you can restore the spool files to an MPE/iX system containing NMS using the SPFXFER INPUT command or to a MPE/iX system not containing NMS or an MPE V/E system using the SPOOK INPUT command.  |  |  |  |  | NOTE: Because NMS spool files do not have user labels the SPFXFER utility does not store spool file user labels on tape. |  |  |  |  |
For each stored spool file, SPFXFER displays the current spool file identification, the job or session number of the file's owner, the logical device class or name, the number of sectors in the file, and the owner's name and account. If the job or session number that MPE/iX assigns is larger than 16,383, the system assigns a number not to exceed 16,383. Also, the system reduces the number of copies to 127 if the total number of copies exceeds this. This change is due to backward compatibility requirements for tapes that the SPOOK utilities of MPE/iX systems not containing NMS and of MPE V/E systems create. The syntax for OUTPUT is:
OUTPUT [ [username [.accountname]]
[spoolid [,spoolid] ... ] ] ;*tapefile [;PURGE]
|
To store all linked spool files created by USER whose account is ACCOUNT on a magnetic tape formally designated as MYTAPE in a file equation and then to delete the spool files, enter:
FILE MYTAPE;DEV=TAPE
SPFXFER
OUTPUT USER.ACCOUNT ;*MYTAPE ;PURGE
|
Like the example for the INPUT command, the tape is mounted, the drive is online, and a reply must be given before the files are stored to tape. In addition, the tape must have a write ring. Additional information about the INPUT and OUTPUT commands. |  |
To use the INPUT and OUTPUT commands, you must have nonshareable devices (ND) capability to access the tape drive and system manager (SM) or system supervisor (OP) capability; otherwise, you can only use the HELP and EXIT commands. Before you use the INPUT and OUTPUT commands, set up a file equation as follows:
FILE formaldesig [=filereference] ;DEV = device
|
where formaldesig is the formal file designator and device is the device class name or the logical device number of a magnetic tape unit. For example, to restore all spool files from a tape named TAPEFILE mounted on a tape drive whose device class name is TAPE, enter:
FILE TAPEFILE; DEV=TAPE
SPFXFER
INPUT @ ;*TAPEFILE
|
If the system restores files from or stores files to multiple tape reels, the operator must respond to the following prompt:
CHANGE REELS ON LDEV nnn? (Y / N)
|
Entering N (for "no") aborts the operation. Entering any other key means "yes," and the operator must mount another tape. For the INPUT command, if the operator mounts a wrong reel, the following prompt appears:
INCORRECT REEL - TRY AGAIN? (Y / N)
|
The prompt is displayed until either the operator mounts a correct reel or enters N. If the response is N, the system aborts the INPUT operation. If I/O errors are encountered while reading from or writing to disk or tape, then SPFXFER displays the spool file identification, the SPFXFER error number, and the file system error number.
The SPFXVAR Variable |  |
The most recent SPFXFER error number is placed in the CI variable SPFXVAR. For example:
GATO
Invalid command syntax.
Native Mode Spooler Message 10755
:SHOWVAR SPFXVAR
SPFXVAR=-10755
|
Leaving SPFXFER |  |
The EXIT command terminates SPFXFER. The syntax for the command is as follows: It has no parameters. To use the command, enter: Chapter 2 of this manual contains more examples of SPFXFER.
|