HP 3000 Manuals HP 3000 Manuals
Spool File Transfer Utility (SPFXFER)
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 chapters 3 and 7 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:
RUN SPFXFER.PUB.SYS
or if SPFXFER is in the search path defined by your HPPATH system
variable, enter:
SPFXFER
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:
SPFXFER
:LISTSPF
Listing the commands
The HELP command lists all SPFXFER commands and their syntax. The syntax
of the command is as follows:
HELP
It has no parameters. To use the command, enter:
SPFXFER
HELP
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
* the owner
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]]];*tapefile
[[spoolid[,spoolid]...] ]
Parameter definitons.
username The user name of the creator of the files or @ to
designate all users.
accountname The account name of the creator of the files or @
to designate all accounts.
spoolid The spool file device identification (in the format
[#O]nnnn where nnnn is a number) given by the
system that stored them. On CM and MPE V/E
systems, spoolid has a maximum value of 32,767.
__________________________________________________
NOTE If you omit both username.accountname and
spoolid, the system restores all files
belonging to the logon user.
__________________________________________________
tapefile The name of the file that denotes the tape device
that contains the spool files. A file equation
must exist for the tape device. You must
backreference tapefile with an asterisk (*) in the
form *tapefile.
To restore spool files #O100 and #O200 from a tape formally designated in
a file equation as T, mount the tape, put it online, and enter:
FILE T;DEV=TAPE
SPFXFER
INPUT #O100,#O200 ;*T
or
FILE T;DEV=TAPE
SPFXFER
INPUT 100,200 ;*T
A message like the following example appears on the console:
?10:41/#559/45/LDEV# FOR "T" ON TAPE (NUM)?
If you are the console user, respond with CTRL A. An "=" sign appears.
Enter:
REPLY 45,7
where 45 is the process identification number (PIN) and 7 is the LDEV for
the tape drive for this example.
NOTE NMS spool files can be up to 4 Gbytes long. Even a spool file
smaller than this may not fit on MPE systems not containing the NMS
if the spool file exceeds 32 extents of the size configured on the
target system.
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]]] ;*tapefile [;PURGE]
[[spoolid [,spoolid]...] ]
Parameter definitions.
username The user name of the creator of the files or @ to
designate all users.
accountname The account name of the creator of the files or @
to designate all accounts.
spoolid The spool file identification number in the form
[#O]nnnn of the spool files. It has a maximum
value of 9,999,999. If the spoolid of any spool
file being stored by using OUTPUT exceeds 32,767,
the system assigns a SPOOLID less than 32,767.
__________________________________________________
NOTE If username.accountname and spoolid are both
omitted, the system stores all files
belonging to the logon user.
__________________________________________________
tapefile The name of the file that denotes the tape device
which stores the spool files. A file equation must
exist for the tape device. You must backreference
tapefile with an asterisk in the form *tapefile.
PURGE This option tells the system to purge the spool
files after they are stored on tape.
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:
EXIT
It has no parameters. To use the command, enter:
EXIT
Chapter 3 of this manual contains more examples of SPFXFER.