HP 3000 Manuals HP 3000 Manuals
3-7. COMMAND DESCRIPTIONS
To help clarify the command descriptions presented in this manual, the
following rules are observed:
* Optional command spelling and parameters in the form shown for a
command are denoted by being enclosed in brackets [ ].
* Required parameters for a command are shown enclosed in braces { }.
If two or more parameters are enclosed within the same set of braces,
as, for example,
{oldstring}
CHANGE{ colnum }
then one (and only one) of the parameters must be specified.
The following common items apply to all EDIT/3000 commands:
* Command names may be entered using uppercase or lowercase letters.
For example, the ADD command can be entered as add.
* The first letter of a command name may be used instead of the
complete command name, except in the case of the COPY command, which
requires CO to prevent conflict with C[HANGE]. For example, you may
use A (or a) for ADD, L (or L) for LIST. Command parameters, however,
must be spelled out in full, unless specified otherwise in th 'e
command description. For example, you can use A, HOLD, NOW to
abbreviate the ADD command, but you may not use A, H, N, because
those parameters may not be abbreviated.
* Blank characters are denoted by the letter b where necessary for
clarity.
* An asterisk (*) can be used with some commands to signify the current
location of the EDIT/3000 pointer. (This pointer is set and
incremented by EDIT/3000 to monitor the edit cycle and to show where
in the WORK file any change requested at this time will begin.) For
example, a LIST* command immediately following an ADD command will
list the last record entered with the ADD command.
* The letter Q (to specify QUIET, or no prompting) may not be separated
from the command name with a blank.
Command descriptions are presented in alphabetical order. The advanced
commands BEGIN, NOT, OR, PROCEDURE, WHILE, and YES are not included in
this section. See Section IV for these commands.
Parameters used in the command descriptions have the same meanings
wherever they appear. These mean- ings are described in the following
paragraphs.
NOTE For ease of reference (and so that you do not have to keep turning
back to these pages), abbreviated parameter descriptions are
provided at the end of this section.
colnum any integer from column number 1 through the column
number established by the SET RIGHT and SET LENGTH =
colnum options in effect.
filename the MPE/3000 file name of any file that you can access.
See the MPE Commands Reference Manual for a discussion
of files. A file equation may be back-referenced by
placing an asterisk in front of the file designator.
increment the value by which line numbers are incremented. The
value is from .001 through 99999.999 when SET FORMAT =
DEFAULT or from .001 through 999.999 when SET FORMAT =
COBOL. How- ever, the line 99999.999 cannot contain any
text when FORMAT = DEFAULT is in effect and the line
999.999 cannot contain text if FORMAT = COBOL.
integer an integer in the range from 1 through 99999 when SET
FORMAT = DEFAULT or from 1 through 999 when SET FORMAT =
COBOL.
limit an integer from 1 through 9999.
linenumber the value assigned to line numbers. The value is from
.001 through 99999.999 when SET FORMAT = DEFAULT or from
.001 through 999.999 when SET FORMAT = COBOL. As noted
above, the line 99999.999 or 999.999, as applicable,
cannot contain any text.
newstring a character string that replaces oldstring.
oldstring a character string to be replaced in the WORK file.
position position is specified in an EDIT/3000 command as
follows:
36 line 36.
36(10) column number 10 in line 36. This
represents the absolute column num- ber
10. Absolute column numbers are
enclosed in parentheses and do not
include a sign.
36(+10) the 11th (not 10th) non-blank character
in line 36. This represents the 10th
non-blank position after column 1, or
the relative column number 10 which is
the 11th non-blank column in line 36.
Relative column numbers are enclosed in
parentheses and include a sign.
36+10 the 10th line after line 36.
36 -10 the 10th line before line 36.
36 (FIRST) the first non-blank character in line
36.
36(FIRST +6) the sixth character in line 36,
starting with the first non-blank
character in line 36.
36(LAST) the last non-blank character in line
36.
36(LAST -6) the sixth to last character in line 36,
starting with the last non-blank
character in line 36.
36(RIGHT -2) the position in line 36 which is two
columns before the right margin.
FIRST first line.
LAST last line.
FIRST +10 the 10th line after the first line.
LAST -10 the 10th line before the last line.
"ARRAY" (+5) the 15th non-blank character after the
first character in ARRAY.
*(LAST) the last non-blank character in the
current line.
LAST(LAST -5) the fifth to last non-blank character
in the last line.
"AND" (2) column number 2 of the next line that
contains the string "AND."
range range may reference: 1) a single position in a record,
2) a continuous string of positions, 3) a single record
(line), 4) a continuous string of records, 5) a
character, or 6) a string of characters. For example,
36(10) a range of column 10 in line 36 only.
36/45 lines 36 through 45.
36(10)/45(9) a range from column 10 in line 36
through column 9 in line 45.
36(+10)/45(9) a range from the llth non-blank
character in line 36 through the 9th
column in line 45.
36+10/65 -9 a range from the 10th line after line
36 through the 9th line before line 65.
5+3(15)/23 a range from column 15 of the 3rd line
-6(45) after line 5 through column 45 of the
6th line before line 23.
16 a range of line 16 only.
ALL all lines in the WORK file.
"A" a range of the character A only.
"ALL" a range of the string ALL only.
"ARE" a range of the string ARE only.
"ARE" a range from the first character of the
/"POSSIBLE" next appearance in the WORK file of the
string ARE through the last character
of the next appear- ance of the string
POSSIBLE. Note that if the last
position in a range is a string, range
includes the last character of that
string.
rangelist one or more ranges. For example, 10/20,23/46 signifies
two ranges, one consisting of lines 10 through 20 and
one consisting of lines 23 through 46; "WRITE" /"READ"
,"KEY" /"NOW" signifies two ranges, one starting with
the first character of WRITE and extending through the
next appearance of READ and one starting with the first
character of KEY and extending through the next
appearance of NOW.
recnum a logical record number contained in a file referenced
by filename. The first record is number 0. See the MPE
Commands Reference Manual for a discussion of logical
record numbers.
startcolumn the starting column number of a portion of a record.
This may be any number within the LEFT- RIGHT margins
(see the SET command, paragraph 3-92) or an expression
of the form FIRST +/- n, LAST +/- n, LEFT +n, or RIGHT
-n, whose value is within these margins.
startline the first line of a group of lines.
stopcolumn the ending column number of a portion of a record. This
may be any number as described above for startcolumn.
stopline the last line of a group of lines.
string a group of characters written exactly as it appears or
is to appear. A string must be delimited by (enclosed
in) any special (non-alphanumeric) characters except:
apostrophes, commas, semicolons, periods, parentheses,
asterisks, slashes. As noted in paragraph 3-6, #, +, -,
and = should not be used as delimiters when advanced
commands are also used. For example,
"THIS IS A STRING"
#THIS IS A STRING#
Nonprinting characters can appear outside the string, if represented by
their decimal numeric equiv- alent (in ASCII code--see Appendix A) and
preceded by apostrophes ('). For example,
'13"ABC""DEF"'13