 |
» |
|
|
|
Outputs one or more spool files to a tape in SPOOK5/SPFXFER format. Syntax |  |
> O[UTPUT]{spoolfileid [,spoolfileid [,...]]
username[.acctname]}; *tapefile
[;PURGE]
|
Parameters |  |
- spoolfileid
An existing spoolid to which the user has access. Specifies the source of the data to be output to tape. To be taken as a spoolid (instead of a username), this parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn, where the n's represent digits. If the # is used, the O must also be used. If the O is used without the #, the parameter is interpreted as a user name and will probably cause an error. - username
The name of a user on the system or @. This parameter, when used with the optional acctname, specifies the set of spool files to be output. Full wildcarding is not supported by SPFXFER. The SPIFF user must have access to files generated by username. Refer to “Security ”. - acctname
The name of an account on the system or @. Default: the logon account is assumed. This parameter, when used with the username, specifies the set of spool files to be output. Full wildcarding is not supported by SPFXFER. The SPIFF user must have access to files generated by users in acctname. Refer to “Security ”. - tapefile
The backreferenced name of a file (FILE) equation that specifies a tape device or class. - PURGE
If specified, spool files are deleted from the system after being output to tape.
Operation Notes |  |
Syntax checking is performed by SPIFF, but the command is executed by running SPFXFER.PUB.SYS as a child process. Any errors generated by SPFXFER are reported. SPIFF supports the OUTPUT command by invoking SPFXFER.PUB.SYS as a child process, passing the SPIFF command line to it in an internal termporary $STDIN file. This has several consequences: The tape interface format recognized by SPOOK5 and by SPFXFER requires a particular combination of values for the REC= parameter of a file equation. Do not specify a REC= paramater in your file equation. The wrong combination of values may cause SPFXFER to return an error without transferring your file(s). It is a good idea to limit your file equation to the form: SPFXFER does not support full wildcarding for either the username or the acctname parameters. The only wildcard permitted for either parameter is @. SPFXFER requires a space between the O[UTPUT] command and the source file specification. If you omit the space, as in > O@.@, SPFXFER reports an error. SPFXFER displays a prompt before reading the command from the temporary file. You cannot and need not respond to the prompt. If control does not return to you immediately, either SPFXFER is currently outputting the spool files to tape as requested, or (more likely) SPFXFER is waiting for a console reply — indicating that the desired tape has been mounted, enabling it to access the tape drive specified by *tapefile.
Example |  |
Assuming that spoolid #O6490 exists, and that the user has access to it:
OUTPUT 6490; *MYTAPE
Invoking SPFXFER.PUB.SYS. Ignore prompts until further notice. (SPMSG 185)
SPFXFER A.03.00 (C) HEWLETT-PACKARD CO., 1989
> Do not respond to this prompt
#FILE #JOB DEV/CL SECTORS OWNER
#O6490 #S2 LP 16 MYUSER.MYACCT
>
SPIFF has regained control from SPFXFER. (SPMSG 186)
|
|