Table of Contents
Advertisement
lintain and Modify the Catalog and VTOC
-----------------------------------------------------------------------------------------------------------------------T
Macro-Instructions Required to Perform Function
I
---------------T-------------.-----·---------------------------------,--------------------------------------------+
Name
1
Operation
I
Operands
I
--------------+---------------+-------------------------------------------------------------------------------------+
[symbol]
I
LOCATE
I
list-addrx 1
I
[list-name]
i
CAMLST
i
NAME,dsname-relexp6, [cvol-relexp7],area-relexpg
i
----------------+--------------~-------------------------------------------------------------------------------------+
[symbol]
i
LOCATE
i
list-addrx 1 .
I
[list-name]
I
CAMLST
I
BLOCK,ttr-relexp3,[cvol-relexp 7 1,area-relexp9
I
----------------+--------------+----------------------~---------------------------------------------------------------+
[symbol]
1
INDEX
I
list-addrx 1
I
[list-name]
I
CAMLST
1
BLDX,name-relexp2, [cvol-relexp7]
I
---------------+-------------t------------------------------------------------------------------------------------+
[symbol]
1
INDEX
1
list-addrx 1
I
[list-name]
1
CAMLST
1
BLDG,name-relexp2, [cvol-relexp 7 1" [DELETE.1:5], [EMPTy16] ,mlmber-absexp17
I
---------------+--------------+----------------------------------------------------------------------------------+
[symbol]
1
INDEX
1
list-addrx 1
I
[list-name]
1
CAMLST
1
BLDA,index name-relexps,[cvol-relexp7],alias name-relexp10
I
----------------+---------------t--------------------------------------------------------------------------------------+
[symbol]
1
INDEX
1
list-addrx 1
I
[list-name]
I
CAMLST
I
DLTX,name-relexp2, [cvol-relexp7]
I
---------------+--------------+------------------------------------------------------------------------------------+
[symbol]
I
INDEX
I
list-addrx 1
I
[list-name]
1
CAMLST
1
DLTA,index name-relexp5, [cvol-relexp7]
I
----------------+---------------+--------------------------------------------------------------------------------------+
[symbol]
1
INDEX
1
list-addrx 1
I
[list-name]
I
CAMLST
I
LNKx,index name-relexp5,[cvol-relexp7],new cvol-relexp12
I
---------------+---------------+--~---------------------------------------------------------------------------------+
[symbol]
!
INDEX
!
list-addrx 1
!
[list-name]
1
CAMLST
I
DRPX,index name-relexp5, [cvol-addrx 7 ]
I
--------------~+--------------+--------------------------------------------------------------------------------------+
[symbol]
1
CATALOG
I
list-addrx 1
1
[list-name]
1
CAMLST
I
CAT,name-relexp2,[cvol-relexp7],vol list-r elexp13
I
---------------+---------------+--------------------------------------------------------------------------------------+
[symbol]
1
CATALOG
1
list-addrx 1
I
[list-name]
I
CAMLST
I
UNCAT,name-relexp2,[cvol-relexp7]
I
--------------+---------------+--------------------------------------------------------------------------------------+
[symbol]
1
CATALOG
1
list-addrx 1
I
-[list-namel-
-I
Cl...MliST
I
RECAT,name-relexp2,
~cvol-relexp7]
,vol list-reiexp13
I
---------------+---------------+-------------------------------------------------------------------------------------+
[symbol]
1
OBTAIN
1
·list-addrx 1
I
[list-name]
I
CAMLST
1
SEARCH,dsname-relexp6,vol-relexpB,wk
area-relexp1~
I
----------------+---------------+-------------------------------------------------------------------------------------,
[symbol]
1
OBTAIN
I
list-addrx 1
1
[list-name]
I
CA¥LLST
I
SEEK
,cchhr-relexp~,
vol-relexpB, 'Ilk
area-relexp1.~
1
----------------+---------------f--------------------------------------------------------------------------------------,
[symbol]
1
SCRATCH
1
list-addrx 1
I
[list-name]
I
CAMLST
I
SCRATCH,dsname-relexp6"vol list-relexp13,,[OVRD1B]
I
----------------+---------------+-------------------------------------------------------------------------------------~
[symbol]
I
RENAME
I
list-addrx 1
.
I
[list-name]
I
CAMLST
I
RENAME,dsname-relexp6,new name-relexp11,vol list-relexp13
I
----------------~--------------~--------------------------------------------------------------------------------------+
rs refer to the enumerated list of explanations for the operands.
1
----------------------------------------------------------------------------------------------------_._----------------~
1 list-addrx
points
to
the
list-name)
set
instruction.
parameter
up
by
the
list
CAMLST
(labeled
macro-
.:2
_____
._,....1 .......... _
J..1Cl.1UC -..L CoL'C ......
!:'
specifies
the
main
storage
location of the
fully qualified name of a data
set
or
index
level.
The name cannot exceed 44 characters_
If the name is less
than
44
characters,
it
must be followed by a blank.
The name must be
defined
by
a
C-type
Define
Constant
(DC)
instruct~on.
3
ttr-relexp
specifies
the
main
storage
location
of
a
3-byte
relative
track
address
(TTR).
This
address indicates the
position,
relative
to
the
beginning of the catalog data set, of the
track containing the block (TT), and the block
identification on that track (R).
" cchhr-relexp
specifies the main
storage
location
of
5-byte
absolute
track
address
<CCHHR)
DSCB.
5
index name-relexp
the
-~
-
UL
a
specifies the main
storage
location
of
the
name
of
a
high
level index.
The area that
contains the name must be
eight
bytes
long.
The
name
must
be defined by a C-type Define
Constant (DC) instruction.
6
dsname-relexp
specifies the main storage location of a fully
qualified
data
set
name.
The
area
that
contains the name must be 44 bytes long.
The
name
must
be
defined
by
a
C-type
Define
Constant (DC) instruction.
'4f
7 cvol-relexp
specifies
the
main
storage
location
of
a
6-byte
volume serial number for the volume to
be processed.
If this parameter is not speci-
fied, the system
residence
volume
is
proc-
essed.
B vol-relexp
specifies
the
main
storage
location of the
6-byte serial number of the
volume
on
which
the required DSCB is stored_
9 area-relexp
specifies
the
main
storage
location
of
a
265-byte work ared that you must define.
The
work
area must begin on a double-word bounda-
ry_
The first 256 bytes of the work area will
contain
the
block
that
is
read
from
the
catalog,
and
the last nine bytes of the work
area will contain the relative
track
adjress
and
block identification (in the form
TT~)
of
the block following the
one
read
into
main
storage and the serial number of the volume on
which the block was found.
10 alias name-relexp
specifies
the
main
storage
location of the
name that is to be used as an alias for a high
level index.
The area that contains the
name
must
be
eight
bytes long.
The name must be
defined
ny
a
C-type
Define
Constant
(DC)
instruction.
11 new name-relexp
specifies the main storage location of a fully
qualified
data set name that is to be used to
rename a data set.
The area that contains the
name must be 44 bytes long.
The name must
be
defined
by
a
C-type
Define
Constant
(DC)
instruction.
1.2 new cvol-relexp
specifies the main
storage
location
of
the
6-byte
volume
serial
number
of the control
volume that is
to
be
connected
to
another
control volume.
13 vol list-relexp
specifies the main storage location of an area
that
contains
a
volume list.
The area must
begin on a half-word boundary.
1~
wk area-relexp
specifies
the
350-byte
work
work area must
ry.
main
storage
location
of
a
area that you must define.
The
begin on a double-word
bounda-
If a data set name was specified, the first 96
bytes
contain
the data portion of a format
1
DSCB, and the
next
five
bytes
contain
the
absolute
track address of the DSCB.
The rest
of the area is used as
a
work
area
by
the
OBTAIN routine.
If
an
absolute
track address was specified,
the first 140 bytes contain
the
key
portion
and data portion of the DSCB.
The rest of the
area
is
used
as
a
work area by the OBTAIN
routine.
1.5
DELETE
specifies that all data sets
dropped
from
a
generation data group are to be deleted, i.e.,
the
space allocated to the data sets is to be
made available for reallocation.
1.6 EMPTY
specifies that references to all data sets
in
a
generation
data
group
cataloged
in
thE
generation index are to be
removed
from
the
index
when the number of entries specified is
exceeded.
~7
number-absexp
specifies
the
number
of
data
sets
to
be
included
in
a
generation
data group.
This
number must be specified,
and
cannot
exceed
255.
1.8
OVRD
specifies that the expiration date in the DSCB
should be ignored_
Maintaining the Catalog and the Volume Table of Contents
23
Advertisement
Table of Contents
