HP 3000 Manuals HP 3000 Manuals
The Spoolfile Interface Facility (SPIFF) (Cont.)
SPIFF commands (Cont.)
LIST.
Lists a line range of the currently TEXTed spool file to $STDLIST.
Syntax.
> L[IST] [range]
where range is
[[recnumber[{+} offset]] [, count ]]
[[ [{-} ]] [/ recnumber[{+} offset]]]
[[ ] [ [{-} ]]]
[[* [{+} offset] ] [ ]]
[[ [{-} ] ] [/ * [{+} offset] ]]
[[ ] [ [{-} ] ]]
[[FIRST [{+} offset] ] [ ]]
[[ [{-} ] ] [/ FIRST [{+} offset] ]]
[[ ] [ [{-} ] ]]
[[LAST [{+} offset] ] [ ]]
[[ [{-} ] ] [/ LAST [{+} offset] ]]
[ [ [{-} ] ]]
[ ]
[ALL ]
Semantics.
The LIST command operates only on the currently TEXTed spool file. It is
an error if used when there is no current spool file.
Range expressions are limited to:
(first line number of file) <= expression <= (last line number of file).
Lines are numbered from 0 to N-1. No error is generated for exceeding
these limits; SPIFF simply limits the expression. For example, FIRST-2
evaluates to FIRST.
Specifying a first position range expression that evaluates to a greater
line number than that of the second position range expression is an
error.
NOTE The expression, not its components, is tested. A range of
LAST/FIRST is always an error, but a range of LAST-20/FIRST+40 is
valid for any file consisting of no more than 61 lines (numbered 0
to 60).
Parameters.
range The range of lines of the spool file to list. By default
(when the range parameter is omitted), only the current
record is listed; this is equivalent to LIST *. Any line
number specified that is outside the range of lines in the
spool file will be handled as though FIRST or LAST was
specified, as appropriate. If your range consists of two
expressions, the first expression must evaluate to a number
no larger than the second.
ALL Specifies that all of the records in the spool file should
be listed. No other range element is allowed if this
keyword is used.
FIRST The first record in the spool file.
LAST The last record in the spool file.
* The current record in the spool file.
recnumber An absolute record or line number of text in the spool
file. Records are numbered starting with 0.
offset A relative number of records before (-) or after (+) the
specified record.
count A numeric value, the number of lines to be listed,
including the starting record.
Operation Notes.
The LIST command (abbreviated L) lists a range of records of the current
spool file to $STDLIST. Omitting the range parameter is the same as
specifying LIST *. In either case, the current record pointer is left at
the record following the last record in range, or at LAST, whichever is
less.
It is an error to use the LIST command if you do not have a current spool
file.
NOTE The ouput of the LIST command does not pause at nominal screen
intervals the way that the output from HELP does. To list short
intervals of the spool file, enter a command such as > LIST */*+10
as many times as you need to view the portion(s) of the file that
you wish to see.
Examples.
EXAMPLES OF range:
*/*+20
*-20/*
ALL
FIRST/LAST
*/LAST
LAST-100/LAST
FIRST,20
100/200
5
EXAMPLE OF A COMMAND:
LIST FIRST/10
0
1
2 :JOB MYJOB,MYUSER.MYACCT.
3 PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS.
4 JOB NUMBER = #J624.
5 THU, DEC 19, 1991, 10:24 AM.
6 HP3000 RELEASE: B.30.00 USER VERSION: B.30.00
7 MPE XL HP31900 B.08.14 Copyright Hewlett-Packard 1987.
8 All Rights Reserved.
9 STREAMED BY MYUSER.MYACCT (#S385) ON LDEV# 43
10 STREAM DATE: THU, DEC 19, 1991, 10:24 AM
MODE.
Controls the width and format of the displayed output of the LIST and
FIND commands.
Syntax.
> M[ODE] {option [,option [,...]]}
where {option} is
{ {[+] nnn}}
{W[IDTH] = {[-] }}
{ { }}
{ {OFF }}
{ }
{C[ONTROLS] = {ON } }
{ {OFF} }
{ }
{@ = {ON } }
{ {OFF} }
{ }
{+ = {ON } }
{ {OFF} }
{ }
{^ = {ON } }
{ {OFF} }
{ }
{D[OTS] = {ON } }
{ {OFF} }
Parameters.
nnn An integer indicating the maximum number of characters to
be displayed per record by LIST and FIND. A positive value
indicates display width in MPE/iX halfwords (one halfword =
2 bytes), while a negative value indicates width in bytes.
The range of nnn is -32767 to +32767; however, operating
system limits are reached well before these limits.
WIDTH WIDTH=OFF (default) causes SPIFF to display records in
their entirety, except as limited by the width of the
$STDLIST output device.
WIDTH=[+/-]nnn limits the display width of records
displayed by the LIST and FIND commands. A negative number
indicates a width in bytes, and a positive number indicates
a width in 16-bit words (2 * nn bytes).
WIDTH=[+/-] nnn defines the maximum width of the displayed
record. The record includes a space for at least three
digits of line number and a separating blank. Beyond line
999, additional digits are added to the line number as
required, and the data is moved a corresponding number of
bytes to the right, truncating the same number of
additional bytes from the right end of the record.
With WIDTH=80 in effect, for example, as many as 76
characters of data per record are displayed for records
between 0 and 999. For records 1000/9999, as many as 75
characters of data per record are displayed.
Only the display width is affected. The FIND command can
successfully match a pattern even if the pattern lies
partly or entirely beyond that part of the record that is
displayed.
The + and - are optional. If either is used, there must be
no space between it and the number that follows.
CONTROLS CONTROLS=OFF (default) disables formatted display of I/O
control information.
CONTROLS=ON enables formatted display of I/O control
information. When CONTROLS=ON is in effect, the display is
the same as that used by the PRINTSPF utility.
@ @=OFF (default) causes the FIND command to match its
specified pattern only if the matching pattern begins at
the first character of a record.
@=ON allows FIND to match its pattern anywhere in a record.
+ +=OFF (default) causes the FIND command to stop at the
first matched pattern in its specified (or defaulted) line
range.
+=ON causses FIND to locate all matching patterns in the
range.
^ ^=OFF (default) causes the FIND command to match its
pattern only if the individual bytes in the candidate
record match those of the pattern in a case-sensitive
fashion. For example, "A" matches "A", but not "a".
^=ON results in a case-insensitive search.
DOTS DOTS=ON (default) results in a translation of all
non-printing characters (such as CtrlN and ESC) to dots
before being displayed by the LIST or FIND command.
DOTS=OFF disables such translation. Characters are sent to
the display device exactly as they occur in the file.
CAUTION Many display devices and communication links respond to escape
sequences and other non-printing characters. Similar sequences
may occur randomly in binary data. You should not set DOTS=OFF
if your communication link may be adversely affected. You
should set your terminal to "Display Functions" before
displaying any unknown data. This mode is intended primarily
for checking or debugging output data.
Operation Notes.
The MODE command (abbreviated M) controls the width and format of LIST
and FIND spool file record displays. Settings assigned with this command
remain in effect until changed by another MODE command.
MODE allows you to concatenate as many options as you wish, as long as
each is separated from the next by a comma. In case of duplication or
conflict, the rightmost option is used.
Examples.
Assume that the spool file used in the example for the LIST command is
also the currently TEXTed spool file here. Here is the same fragment of
display output:
LIST FIRST/10
0
1
2 :JOB MYJOB,MYUSER.MYACCT.
3 PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS.
4 JOB NUMBER = #J624.
5 THU, DEC 19, 1991, 10:24 AM.
6 HP3000 RELEASE: B.30.00 USER VERSION: B.30.00
7 MPE XL HP31900 B.08.14 Copyright Hewlett-Packard 1987.
8 All Rights Reserved.
9 STREAMED BY MYUSER.MYACCT (#S385) ON LDEV# 43
10 STREAM DATE: THU, DEC 19, 1991, 10:24 AM
> FIND + "STREAM", ALL
9 STREAMED BY MYUSER.MYACCT (#S385) ON LDEV# 43
The "STREAM" in line 10 is not matched because no @ is in effect.
> MODE @=ON, += ON
> FIND + "STREAM", ALL
9 STREAMED BY MYUSER.MYACCT (#S385) ON LDEV# 43
10 STREAM DATE: THU, DEC 19, 1991, 10:24 AM
The + is redundant here, but is not an error.
> FIND "copyright", ALL
The "Copyright" in line 7 is not matched because this is a case-sensitive
search. With the appropriate MODE setting:
> MODE ^=ON
> FIND "copyright", ALL
7 MPE XL HP31900 B.08.14 Copyright Hewlett-Packard 1987.
> MODE WIDTH=-40
> LIST 0/10
0
1
2 :JOB MYJOB,MYUSER.MYACCT.
3 PRIORITY = DS; INPRI = 8; TIME = UNL
4 JOB NUMBER = #J624.
5 THU, DEC 19, 1991, 10:24 AM.
6 HP3000 RELEASE: B.30.00 USER VERS
7 MPE XL HP31900 B.08.14 Copyright H
8 All Rights Reserved.
9 STREAMED BY MYUSER.MYACCT (#S385) ON
10 STREAM DATE: THU, DEC 19, 1991,
MODE WIDTH=-60,CONTROLS=ON
LIST 0/10
0 OP P1=$0000 P2=$0000
1 WR P1=$0001 P2=$0000 CC=%061
2 WR P1=$0001 P2=$0000 CC=%000 BUF/# 25= :JOB MYJOB,MYUSE
3 WR P1=$0001 P2=$0000 CC=%000 BUF/# 51= PRIORITY = DS; I
4 WR P1=$0001 P2=$0000 CC=%000 BUF/# 19= JOB NUMBER = #J6
5 WR P1=$0001 P2=$0000 CC=%000 BUF/# 28= THU, DEC 19, 199
6 WR P1=$0001 P2=$0000 CC=%000 BUF/# 48= HP3000 RELEASE:
7 WR P1=$0001 P2=$0000 CC=%000 BUF/# 56= MPE XL HP31900
8 WR P1=$0001 P2=$0000 CC=%000 BUF/# 20= All Rights Reser
9 WR P1=$0001 P2=$0000 CC=%000 BUF/# 40= STREAMED BY MYUS
10 WR P1=$0001 P2=$0000 CC=%000 BUF/# 45= STREAM DATE:
OUTPUT.
Outputs one or more spool files to a tape in SPOOK5/SPFXFER format.
Syntax.
> O[UTPUT] {spoolfileid [,spoolfileid [,...]]}; *tapefile [;PURGE]
{username[.acctname] }
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:
FILE MYTAPE;DEV=TAPE
* 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)