Macro-Instructions
Required
to
Maintain
and
Modify
the
Catalog
and
VTOC
r----------------------------T---------------------------------------------------------------------~---------------------------------------------------T
I I
Macro-Instructions
Required
to
Perform
Function
I
I
Function
r------------------T--------------~--------------------------------------------------------------------------------------+
I I Name I
Operation
I
Operands
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------------------+
I
Read
a
block
from
the
I
[symbol]
!
LOCATE
!
list-addrx
1
I
I
catalog
-
by
name
I
[list-name)
I
CAMLST
I
NAME,dsname-relexp6,
[cvol-relexp7],area-relexp9
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------~===--------+
I
Read
a
block
from
the
I
[symbol]
I
LOCATE
I
list-addrx
1
.
I
I
catalog
-
by
location
I
[list-name]
I
CAMLST
I
BLOCK,ttr-relexp3,[cvol-relexp7],area-relexp9
I
~--------.
--------------------+------------------+---------------+--------------------------------------------------------------------------------------+
I
Build
an
index
I
[symbol]
I
INDEX
I
list-addrx
1
I
I I
[list-name]
I
CAMLST
I
BLDX,name-relexp2,
[cvol-relexp7]
I
~----------------------------+------------------+---------------t--------------------------------------------------------------------------------------+
I
Build
a
generation
I
[symbol]
I
INDEX
I
list-addrx
1
I
I
index
I
[list-name]
I
CAMLST
I
BLDG,name-relexp2,
[cvol-relexp7]"
[DELETE15],
[EMPTy16]
,n'.lmber-absexp17
I
~----------------------~-----+------------------+---------------+--------------------------------------------------------------------------------------+
I
Assign
an
alias
I
[symbol]
I
INDEX
I
list-addrx
1
I
I I
[list-name]
I
CAMLST
I
BLDA,index
name-relexp5,
[cvol-relexp7],alias
name-relexp10
I
~----------------------------+------------------+---------------t--------------------------------------------------------------------------------------+
,
Delete
an
index
I
[symbol]
I
INDEX
I
list-addrx
1
I
I I
[list-name]
I
CAMLST
I
DLTX,name-relexp2,
[cvol-relexp7]
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------------------+
I
Delete
an
alias
I
[symbol]
I
INDEX
I
list-addrx
1
I
I I
[list-name)
I
CAMLST
I DLTA,
index
name-relexp5,
[cvol-relexp7]
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------------------+
I
Connect
control
I
[symbol]
I
INDEX
I
list-addrx
1
I
I
volumes
I
[list-name)
I
CAMLST
I
LNKX,index
name-relexp5,[cvol-relexp7J,new
cvol-relexp12
I
~----------------------------+------------------+---------------+-----------------------------------~--------------------------------------------------+
I
Disconnect
control
I
[symbo~]
I
INDEX
i
list-addrx~
!
I
volumes
I
[list-name)
I
CAMLST
I
DRPX,index
name-relexp5,
[cvol-addrx
7
]
I
~----------------------------+-----------------~+--------------~--------------------------------------------------------------------------------------+
I
Catalog
a
data
set
I
[symbol]
I
CATALOG
I
list-addrx
1
I
I I
[list-name)
I
CAMLST
I
CAT,name-relexp2,[cvol-relexp7],vol
list-
r
e
le
xp13
I
~----------------------------+------------------+---------------+------------------------------------~-------------------------------------------------+
I
Remove
data
set
refer-
I
[symbol]
I
CATALOG
I
list-addrx
1
I
I
ences
from
the
catalog
I
[list-name]
I
CAMLST
I
UNCAT,name-relexp2,[cvol-relexp7]
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------------------+
I
Recatalog
a
data
set
I
[symbol]
I
CATALOG
I
list-addrx
1
I
I I
[list-name]
I
CP~LST
I
RECAT,name-relexp2,
[cvol-relexp7],vol
list-relexp13
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------------------+
I
Read
a
DSCB
from
the
I
[symbol]
I OBTAIN
llist-addrx
1
I
I
VTOC
-
by
name
I
[list-name]
I
CAMLST
I
SEARCH,dsname-relexp6,vol-relexpB,wk
area-relexp1~
I
~----------------------------+------------------+---------------t--------------------------------------------------------------------------------------1
I
Read
a
DSCB
from
the
I [sYKillol] I OBTAIN I
list-addrx
1
I
I
VTOC
-
by
location
I
[list-name]
I
CAMLST
I
SEEK,cchhr-relexp~,vol-relexpB,wk
area-relexp1~
I
~----------------------------+------------------+---------------f--------------------------------------------------------------------------------------1
I
Delete
a
data
set
I
[symbol]
I
SCRATCH
I
list-addrx
1
I
I I
[list-name]
I
CAMLST
I
SCRATCH,dsname-rele
xp
6"vollist-relexp13,,[OVRD1B]
I
~----------------------------+------------------+---------------+--------------------------------------------------------------------------------------1
I
Change
the
data
set
I
[symbol]
I
RENAME
I
list-addrx
1
I
I
name
in
a
DSCB
I
[list-name]
I
CAMLST
I
RENAME,dsname-relexp6,new
name-relexp11,vol
list-relexp13
I
~----------------------------L------------------~-----
__________
~-
_____________________________________________________________________________________
+
I
Note:
The
superscript
numbers
refer
to
the
enumerated
list
of
explanations
for
the
operands.
I
L
___
=====
_____________________________________________________________________________________________________________________________
.
_________________
~
1
list-addrx
points
to
the
list-name)
set
instruction.
2
name-rele:A-P
parameter
up
by
the
list
CAMLST
<labe
mac
specifies
the
main
storage
location
of
fully
qualified
name
of
a
data
set
or
in
level.
The
name
cannot
exceed
44
characte
If
the
name
is
less
than
44
characters.
must
be
followed
by
a
blank.
The
name
must
defined
by
a
C-type
Define
Constant
(
instruct~on.
3
ttr-relexp
specifies
the
main
s~orage
location
of
3-byte
relative
track
address
(TTR).
T
address
indicates
the
position.
relative
the
beginning
of
the
catalog
data
set,
of
track
containing
the
block
(TT),
and
the
bl
identification
on
that
track
(R).
"
cchhr-relexp
specifies
the
main
storage
location
of
5-byte
absolute
track
address
(CCHHR)
a
DSCB.
5
index
name-relexp
specifies
the
main
storage
location
of
name
of
a
high
level
index.
The
area
t
contains
the
name
must
be
eight
bytes
Ie
The
name
must
be
defined
by
a
c-type
Def
Constant
(DC)
instruction.
6
dsname-relexp
specifies
the
main
storage
location
of
a
f~
qualified
data
set
name.
The
area
t
contains
the
name
must
be
44
bytes
long.
name
must
be
defined
by
a
C-type
Def
Constant
(DC)
instruction.
7
cvol-relexp
specifies
the
main
storage
location
0:
6:byte
volume
serial
number
for
the
volum,
be
processed.
If
this
parameter
is
not
sp'
fied,
the
system
residence
volume
is
p:
essed.
B
vol-relexp
specifies
the
main
storage
location
of
6-byte
serial
number
of
the
volume
on
wi
the
required
DSCB
is
stored.
9
area-relexp
specifies
the
main
storage
location
0
26S-byte
work
area
that
you
must
define.
work
area
must
begin
On
a
double-word
bou
rYe
The
first
256
bytes
of
the
work
area
1
contain
the
block
that
is
read
from
catalog,
and
the
last
nine
bytes
of
the
area
will
contain
the
relative
track
adj
and
block
identification
(in
the
form
TTR
the
block
following
the
one
read
into
storage
and
the
serial
number
of
the
volum
which
the
block
was
found.
Maintaining