 |
» |
|
|
|
Controls the width and format of the displayed output of the LIST and FIND commands. Syntax | |
> M[ODE] {option [,option [,...] ] }
|
where {option} is
{ W[IDTH] = { [+
-] nnn
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 theLIST 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. 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:
|
|
