IBM System/360 - Page 23

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