Transferring Spool Files to and from Other Systems--the SPFXFER Utility [ Native Mode Spooler Reference Manual ] MPE/iX 5.0 Documentation
Native Mode Spooler Reference Manual
Transferring Spool Files to and from Other Systems--the SPFXFER Utility
The recommended method of transferring output spool files between systems
with native mode spooler is STORE and RESTORE as previously described in
this chapter. Nevertheless, spool files created on earlier versions of
MPE/iX not containing NMS or on a classic HP 3000 (MPE V/E based
operating system) have a somewhat different internal structure so they
must be converted or transported before they can be used in native mode.
Similarly, native mode spool files must be transported before being used
in compatibility mode or on a classic HP 3000. The SPFXFER utility
allows you to transport spool files back and forth between these
different system types.
NOTE The SPFXFER utility reads tapes created only by itself or the SPOOK
utility and writes tapes only in a format readable by SPOOK or
itself. SPOOK is a contraction of the words "spooler look" and is
a utility available on classic HP 3000's and on MPE/iX systems not
containing NMS. In these two environments, SPOOK is the only method
for transferring files to and from tape.
Transferring to native mode--the INPUT command
The INPUT command allows you to restore spool files that were transferred
to tape using SPOOK onto your system. It also restores spool files
previously stored with this utility. Restored spool files are placed
into the OUT.HPSPOOL group and account as linked spool files and are
assigned new SPOOLIDs.
To use the INPUT command, you must have SM or OP capability. Also, ND
capability is required to access the tape drive.
The general form of the INPUT command is:
INPUT [[username[.acctname]]] ;*tapefile
[[dfid [,...]] ]
The INPUT command requires a tape device back reference. So before
running the utility, set up a file equation for a tape such as:
FILE T;DEV=TAPE
To run the SPFXFER utility, enter:
SPFXFER
The prompt > appears. To see all commands available in SPFXFER, enter
HELP at the prompt.
Input by user and account name.
To input all spool files created under a specific user and account name,
enter:
INPUT USER.ACCT;*T
To input all spool files created by all users in a specific account,
enter:
INPUT @.ACCT;*T
To input all spool files created by a given user in your logon account,
enter:
INPUT USER;*T
To input all spool files created by a given user name in any account,
enter:
INPUT USER.@;*T
To input all spool files created by all users in all accounts, enter:
INPUT @.@;*T
The user name and account need not exist in the system directory nor does
this command create them.
Input by DFID.
The DFID is the identifier given to a spool file by MPE/iX systems not
containing NMS and on a classic HP 3000.
To input a single spool file by DFID, enter:
INPUT #O357;*T
You may also string several DFIDs and you may omit the #O as follows:
INPUT 357,375,458;*T
If username.acctname and DFID are omitted, all spool files belonging to
the logon user are input. For example:
INPUT ;*T
Transferring out of native mode--the OUTPUT command
The OUTPUT command enables you to store spool files from your native mode
environment onto a tape in SPOOK format for use on MPE/iX systems not
containing NMS or on a classic HP/3000.
To use the OUTPUT command, you must have SM or OP capability. Also ND
capability is required to access the tape drive.
The general form of the OUTPUT command is:
OUTPUT [[username[.acctname]]] ;*tapefile [;PURGE]
[[spoolid [,...]] ]
The OUTPUT command requires a backreference to a tape device . So before
running the utility, set up a file equation for a tape such as:
FILE T;DEV=TAPE
To run the SPFXFER utility, enter:
SPFXFER
NOTE Since native mode spool files can be much larger than those spool
files created on MPE/iX systems prior to version A.40.00 or spool
files created on MPE V/E systems, you may not be able to move NMS
spool files onto those systems.
Output by user and account name.
To output all spool files for a specific user and then purge them, enter:
OUTPUT USER.ACCT;*T;PURGE
The ;PURGE parameter is optional and causes files to be purged from your
system after being written to tape.
To output all spool files for all users in a specific account, enter:
OUTPUT @.ACCT;*T
To output all spool files created by a given user in your logon account,
enter:
OUTPUT USER;*T
To output all spool files created by a given user in any account, enter:
OUTPUT USER.@;*T
To output all spool files created by all users in all accounts, enter:
OUTPUT @.@;*T
Outputting by SPOOLID.
To output a single output spool file, enter:
OUTPUT 749822;*T
You also may output several spool files by stringing their SPOOLIDs. For
example:
OUTPUT 749822,37721,482943;*T
You may add ;PURGE to purge the spool files from your system as they are
written to tape.
If username.acctname and spoolid are omitted, all spool files belonging
to the logon user are output. For example:
OUTPUT ;*T
Obtaining help and terminating
To terminate the SPFXFER utility, enter:
EXIT
To obtain help (usage information), enter:
HELP
MPE/iX 5.0 Documentation