OOOK80002
-ill
Center
**'.-
-, V$'SA
-------
-------
PREFACE
This booklet describes the Triangle University Computation Center
(1UCC) EDIT Command and Subcommands, as well as pertinent Resource
Access Control Facility (RACF) Commands available at the WCC. For
each command, the syntax and a brief description of the function of
the command is provided. Prior knowledge of the commands is assumed.
This publication is intended for reference use at a terminal.
The HELP Command can be used to reference additional information on
QED Commands. The HELP Command provides function, syntax, and operand
information for each QED Command. hhen available, message identifier
^information is also supplied.
SYNTAX:
HELP 'command name'
where 'command name' is the name of a QED Command.
For further information, access the following datasets:
SYS3.QED.MANUAL
SYS3.RACF.MANUAL
Additional information is contained in the two IBM Manuals listed
below:
OS/VS2 ISO Terminal User's Guide GC28-0645
OS/VS2 TSO Command Language Reference GC28-0646
Mote: Users should be aware that the IBM EDIT Commands described in
the publications referenced above are not always identical in syntax
and operation to the QED Commands listed in this booklet.
-------
CONVENTIONS USED IN THIS BOOKLET
The TUCC Editor Subcommands are presented in alphabetical order. The
RACF Conmands are grouped according to usage.
The following information is provided for each command and subcommand:
The name
The syntax with annotations
The expected usage
A list of specifics to provide additional details of usage
KEY TO SYNTAX SYMBOLS
The following is a list of the syntax symbols usod in this booklet:
1. UPPERCASE, digits and special characters appear as shown.
2. lowercase information supplied by the user.
3. Item ... you may list more than once.
4. {} you must specify one item.
5. [] optional item; you may specify one.
6. KEYVvORD underlined item is the default if you do not
specify one.
7. (Data-set-list) can be either a data-set-name or a list
of data-set-names.
NOTE: Enclose a list or a multiple-listed parameter within
parentheses; the parentheses may be omitted if the list contains
only one entry.
9. Parameter list entries and multiple-listed parameters are separated
by standard delimiters. A standard delimiter is a comma, or one or more
blanks; both may be used interchangeably.
-------
TABLE OF CONTENTS
The EDIT Command 1
Characteristics Associated Kith Each Data Set Type 2
Subcommands for EDIT .4
ALTER Subcommand 6
BOTTOM Subcommand. 6
CHANGE Subcommand 6
COPY Subcommand 6
DELETE Subcommand 7
DOWN Subcommand 7
DSN Subcommand 7
END Subcommand .7
FIELD Subcommand 7
FIND Subcommand. .......7
HELP Subcommand. 7
INCLUDE Subcommand 7
INPUT Subcommand 7
INSERT Subcommand. 8
INSEKT/REPLACE/DELETE Function 8
LED IT Command. .............................8
LIST Subcommand. 9
MODIFY Subcommand 9
MOVE Subcommand 9
RENUM Subcommand 9
REPEAT Subcommand 9
RF Subcommand 9
RLN Subcommand 10
SAVE Subcommand 10
SCAN Subcommand. .10
TABSET Subcommand .10
TN Subcommand 10
TOP Subcommand 10
UNNUH Subcommand .10
UP Subcommand. .....10
VERIFY Subcommand 10
WHERE Subcommand 10
Non-standard Abbreviations for EDIT Subcommands 11
TSO Commands for EDIT 12
DLIM Command 12
GTAB Command 12
SCLR Command 12
SCREEN Command. 12
RACF Commands 13
PASSWORD Command 13
DISK Commands. 13
ADDSD Command. 13
ALTDSD Command ..13
DELDSD Command 13
PERMIT Command .13
TAPE Commands 14
RALTER Command 14
RDEFINE Command 14
RDELETE Command 14
UTILITIES 14
LISTDSD Command 14
LISTUSER Command 14
RLIST Command ........14
-------
EDIT COMMAND I
COMMAND
OPERANDS
EDIT
E
data-set-namo /password
OLD
NEVv
-> CHAR60
CHAR48
SCAN
NOSCAN
NUM
NONUM
[(integer)]
[BLOCK(integer)]
[BLKSIZE(integer)]
[LINE(integer)]
[LRECL(integer)]
CAPS
ASIS
EMODE
IMODE
BINARY
-1-
-------
CHARACTERISTICS ASSOCIATED WITH EACH DATASET TYPE
The following two tables indicate the default characteristics for the
various dataset types which can be specified in the EDIT Command.
Dataset Types Not Related to Language Processors
For each of these dataset types, the last level qualifier is the same as
the dataset type. Also, the sequence number field is assumed to occupy
the last eight positions of fixed length records and the first eight
positions of variable length records. The remaining defaults are
described
I
1
1-
Default |
Type I
1
CLIST I
I
1
CNTL I
1
|
DATA |
i
i
TEXT |
1
1
j
in the following table:
New
Default
RECFM
VB*
FB
FB
VB
Datasets
Default
LRECL
255*
80
8ti
255
Only
Default
BLKSIZE
4240
4240
4240
4240
Default
CAPS/ASIS
CAPS
CAPS
CAPS
ASIS
Default
Tab Settings
10, 2k) ,30, 40
50,60
10,20,30,40,
50,60
10, 20, 3k), 40
50,60
5,10,15,20,
30,40
Note that if no dataset type is specified, the defaults for the dataset
will be the same as those for the DATA dataset type.
*The default is VB/255; however, WCC procedures require FB/80 for
SYS1.CLIST concatenation with user CLIST when logging on.
-2-
-------
DATASET TYPES ASSOCIATED WITH SPECIFIC LANGUAGE PROCESSORS
For each of these dataset types, the sequence number field is assumed to
occupy the last eight positions of fixed length records and the first
eight positions of variable length records (with the exception of COBOL,
which has its sequence numbers in the first six positions of each
record) . Also, the value CAPS is defaulted for each of these types.
The remaining defaults are described in the following table:
Data-
set
Type
ASM
BASIC
COBOL
FORTG
FOFTG1
FORTH
GOPORT
IPLI
PLI
PLIF
1 1
New Datasets Only
Last
Level Default
Of DSN RECFM
(Lang)
ASM
BASIC
COBOL
FORT
FORT
FORT
FORT
IPLI
PLI
PLI
FB
FB
FB
FB
FB
FB
VB
FB
VB
FB
Default
LRECL
80
80
80
80
80
80
,255
120
104
80
Default
BLKSIZE
4240
1680
4240
4240
400
4240
1680
1680
4240
4240
Syntax
Checker
Available
No
No
Yes
No
Yes
No
No
No
NO
Yes
Default Tab
Settings
10,16,35,72
10,20,30,
40,50,60
8,12,72
7,72
7,72
7,72
7,72
5,10,15,20,
25,30,35,40,
45,50
5,10,15,20,
25,30,35,40,
45,50
5,10,15,20,
25,30,35,40,
45,50
-3-
-------
VALUES OF THE LINE POINTER AT COMPLETION OF SUBCOMMAND
EDIT Value of the Pointer at Completion of
SUBCOMMANDS Subcommand
I
IALTER
iBOTTOM
(CHANGE
(COPY
ICT
(DELETE
(DOWN n
I
IDSN
IEND
(FIELD
(FIND
I
I FT
I
I HELP
I INCLUDE
(INPUT
(INSERT
I Insert/Heplace/Delete
I
(LEDIT
(LIST
(MODIFY
(MOVE
IRENUM
I REPEAT
(RLN
I SAVE
(SCAN
(TABSET
ITN
(TOP
i
lUNNUM
(UP n
i
(VERIFY
(WHERE
Line altered
Last line of the data set
Last line changed
Last line copied to
Last line changed
Line preceding deleted line
n lines below the last position of the
pointer or the bottom of the data set
No change
No change
No change
Line containing specified string, if
any; else, no change
Line specified string, if
any; else, first line
No change
Last line included
Last line entered
Last line entered
Inserted line or replaced line or line
preceding the deleted line if any
Last line edited
Last line listed
No change
Last line moved to
Same relative line
No change
No change
No change
Last line scanned, if any
No change
Same as TOP
Zero value (one line "above" the first
line of the data set)
No change
n lines above the last position of the
pointer or the top of the data set
No change
Line examined
-4-
-------
I SUBCOMMANDS FOR EDIT I
I I
I Use the subcommands while in EDIT Mode to odit and manipulate |
I data. The table below contains a brief summary of each of them. |
IALTER
I BOTTOM
I CHANGE
I COPY
ICT
I DELETE
I DOWN
JDSN
JEND
I FIELD
I FIND
I FT
I HELP
iINCLUDE
I
i INPUT'
IINSERT
I Insert/
I Replace/
I Delete
ILEDIT
iLIST
I MERGE
I MODIFY
I MOVE
j REKUM
jREPEAT
IRF
IRLN
I
I SAVE
I SCAN
JTABSET
ITN
I
I TOP
IUNNUM
I UP
[VERIFY
I
I
I WHERE
Allows character by character replacement.
Moves the pointer to the last line.
Modifies text of a line or a range of lines.
Copies records within the data set.
Combines the functions of TN and CHANGE.
Removes lines.
Moves the pointer toward the end of the data set.
Displays data set name and attributes.
Terminates the EDIT Command.
Specify subfield of records for editing.
Locates a character string.
Combines the functions of TN and FIND.
Explains available subcommands.
Includes all or part of a data set into the
current EDIT work data set.
Prepares the system for data input.
Inserts records.
Inserts, replaces, or deletes a line.
Edit/modify the contents of specific lines of data.
Prints out specific lines of data.
Not available. INCLUDE provides same function.
Alters EDIT session characteristics.
Moves records within the data set.
Numbers or renumbers lines of data.
Repetitively executes EDIT Subcommands.
Replaces a fixed field in a record.
Prints the relative line number of the line at the
current line pointer.
Retains the data set.
Controls syntax checking.
Sets the tabs.
Sets pointer to top of data set but does not print
top line even if verify is on.
Sets the pointer to the top of the set.
Remove sequence numbers from records.
Moves the pointer toward the start of data set.
Causes the current line to be listed whenever the
current line pointer changes or the text of the
current line is modified.
Displays relative position in record of a
character string.
-5-
-------
I SUBCOMMANDS USED WITH THE EDIT COMMAND |
H +
I SUBCOMMAND |
OPERANDS
i I !
I ALTER | j^ i carriage-position-count |
I A | line-number-itline-number-2]| |
I | * [count] | carriage-position-string I
I I
i I iALLl
BOTTOM |
B I
COPY
CHANGE | ^ |
C | line-number-1 [line-number-2]i
I * [countl] |
stringl string2 special-delimiter I ALL I EVERY |
I i FIRST j
count2 |
LITERAL |
NOLITERALJ
iFIELD(pos-1 lpos-2|) I
I 1*1
INOFIELD |
linel [Iine2] |line3| [INCR(lines)]
'string' |count| |line4| [INCR(lines)] I
I 1
-6-
-------
I SUBCOMMAND I
OPERANDS
DELETE
DEL
DOWN
D
DSN
END
FIELD
FIND
F
HELP
H
INCLUDE
INC
i
I
1
i
1
I INPUT
I
i
1* i
iline-number-1 [line-number-2] |
j * [count] (
[count]
lATTRl
ISAVE 1
iNOSAVEi
I RESTART! (member-name) | |
Ipos-i |pos-2|| ION 1 ITRUNC 1 ILIST 1
i i * II iOFF| INOTRUNCI |NOLIST|
i FIELD (pos-lipos-2l} 1
string [position] [ALL] t 1*11
INOFIELD |
subcommand-name [FUNCTION] [SYNTAX] [OPERANDS! (list) ] ]
[ALL] [ISO]
Ilinel lin«?2| |line3|
data-set-name j ' search-string ' count 1 1 * 1
IINCR(lines) | (MJM i
I | INONUMI
1 line-number [increment]! |R| i PROMPT 1
|* 1 III INOPROMPT'I
-7-
-------
I SUBCOMMAND]
OPERANDS
1 INSERT
I IN
[insert-data]
INSERT/
REPLACE/
DELETE
1ine-numbe r str i ng
LEDIT
LED
* [count]
line-number-1 [line-number-2]
Editing Characters:
['string'(occurrence)]
! I
ISMJMl
I I
= Replace character with blank
> = Precede character with blank
< = Delete character
! = Blank remainder of line; copy characters
into rest of line
'' = Insert characters between quotes into line
All characters other than editing characters
will replace the characters directly above.
Note: o If no operands, or only SNUM is specified,
then the scope of the subcommand is top to
bottom.
o If a string is specified immediately after
a start-of-range, then the end-of-range is
implicitly bottom. For example:
LED * 'xyz'
means
LED * 99999999 'xyz'
Note: The LEDIT Command is a WCC enhancement.
-8-
-------
I SUBCOMMAND I
OPERANDS
I
LIST | Iline-number-1 [line-number-2]|
L i I * [count] I
I
I i lpos-2|
I INUM | |FiELD(pos-i I * I)
I JSNUMJ INOFIELD
I (count)
I
MODIFY
MOD
i
ICAPS I ISAVEDSN(data-set-nanw)|
|ASIS|
MOVE i linel [Iine2] |line3i [INCR(lines)]
I 1*1
'string' |count| |line4| [INCR(lines)]
* I 11*1
I 1 I
RENUM I [new-line-numoer [increment [old-line-number
REN I [ending-line-number]]]]
REPEAT
REP
Iloop-count I
i * I
RF
-
line-1 [line-2]I position-1 position-2
* [count ]i
r eplacemsnt-str i ng
-9-
-------
1 SUBCOMMAND
RLN
SAVE
S
SCAN
SC
TABSET
TAB
TN
TOP
UNNUM
UNN
UP
VERIFY
V
WHERE
W
OPERANDS I
[data-set-name ]
1 line-number-1 [line-nurober-2] \
1* [count] I
ION |
|OFF|
ION [(integer-list)] I
(OFF |
1 IMAGE |
[count]
ICN |
|OFF|
line-number i character-string
* 1
MM -I
-10-
-------
NON-STANDARD ABBREVIATIONS FOR EDIT SUBCOMMAND SEQUENCES
The following table describes abbreviations for commonly used
sequences of EDIT Subcommands:
EDIT Subcommand Sequence
Valid Abbreviation |
1
DOWN n
UP n
L * m
I
I DOWN n
1 L * m
I
I UP n
I L * m
i
I TN
I FIND find-parms
I
I TN
I C * n changc-parms
i
-n
/m
+n/m
-n/m
FT find-parms
CT change-parms
I
-11-
-------
TSO COMMANDS FOR TUCC EDIT
I COMMAND
OPERANDS
DLIM
GTAB
delimiter (character)
|ON(tl ,...)! |QOAL(ql ,...)! |TABC| i (tab ch.) I
I II i I I I(HT)|
I OFF |
SCLR
iSTRING(hex-character-string) |ON|
I OFF |
I IDLES(idles)| |NOW I
SCREEN
I ROWS(rows)I I COLS(cols)I ON|TRONCI
I
i (*) lOFFlNOTRUNCl
-12-
-------
RESOURCE ACCESS CONTROL FACILITY (RACF)
COMMAND
OPERANDS
PASSWORD
ADDSD
AD
ALTDSD
AID
DELDSD
DD
PERMIT
PE
PASSWORD ( Cur rent-password
new-password)
INTERVAL (Change-interval)
USER(userid)
Dataset-name (password)
UNIT (type)
VOLUME (volume-serial . . . )
OWNER(userid)
UACC (access .authority)
SET
NOSET
dataset-name (password)
CWNER(userid)
OACC (access-authority)
ADDVOL (volume-serial)
DELVOL (volume-serial )
VOLUME (volume-serial)
ALTVOL (old-volume-serial new-volume-serial )
UNIT (type)
SET
NOSET
dataset-name
VOLUME (volume-serial)
SET
NOSET
resource-name-l
CLASS (resource-name-1-class)
VOLUME (volume-serial)
ID (name...)
ACCESS (access-authority)
DELETE
FROM (resource-name-2)
FCLASS (resource-name-2-class)
FVOLUME (volume-serial)
-13-
-------
1 RESOURCE
1 COMMAND
1
1 RALTER
I RALT
1
1
1
1
1
1
1
i
1
1 RDEFINE
I RDEF |
1
1
1 1
1 1
1
i 1
1 RDELETE I
I RDEL |
1 1
1
I LISTDSD
I LD
1 1
1 1
1
1 1
1 1
1 1
1 LISTUSER
1 LU |
1 1
| ii ii
1 1
1 RLIST
1 RL
1
1
1
1
1
1
-I
> >T
ACCESS CONTROL FACILITY (RACF) |
OPERANDS 1
1
class-name
(resource-name . . . )
OWNER(userid) 1
UACC (access-authority) 1
LEVEL (nn)
ADDVUL (volume-serial ...)
DELVUL (volume-serial. . . )
ADDMEM (member...)
DELMEM (member...)
class-name
(resource-name. . .)
OttNER(userid)
UACC (access-authority)
LEVEL (nn)
ADDHEM (member . . . )
class-name
(resource-name . . . )
DATASET (dataset-name . . . )
ID (name...)
PREFIX (char...)
AUTHOSER
ALL
user id
class-name
(resource-name . . . )
STATISTICS
HISTORY
AUTHUSER
RESGROUP
ALL
i _ \-
-14-
-------
Notes:
-------
Notes:
-------
Notes:
-------
-------
------- |