Table of Contents
Advertisement
EXCEPTIONAL RETURN CONDITION CODES
Control is always returned to the instruction that follows the LOCATE, INDEX, CATALOG, OBTAIN, SCRATCH, or RENAME macro-instr'lJ;ction.
If the function has
been performed successfully.
register 15 contains zeros.
Oth€rwise.register 15
contains a condition code
that indicates
the reason for the failure.
The condition codes for the macro-instructions are as follows:
r----------------------------------------------------,
i
LOCATE Macro-Instruction
I
~----------------------------------------------------1
L
I
I
i
I
I
I
I
I
I
I
I
Code
Interpretation
4
Either the required control volume was not
mounted
or
the specified volume does not
contain a catalog data set (SYSCTLG).
The
volume serial number of the required
vol-
ume
is
contained in bytes 260-265 of the
work area.
8
One of the names of the qualified name was
not found.
Register 0 contains the number
of the last valid name
in
the
qualified
name.
For example, if the qualified name
A.B.C.D were specified, but name C did not
exist at the level specified,
register
0
~ould
contain the binary code 2.
The work
area contains the first index block of the
last
valid
index name, the serial number
of the volume
containing
the
index
(in
bytes
260-265),
and
the
relative track
address
(in bytes
257-259)
of
the
next
index block.
12
Either
an
index,
an alias, or a control
volume pointer was found when the list
of
qualified names was exhausted.
16
20
24
A
data set resides at some level of index
other than the lowest index
level
speci-
fied.
Register
0 contains toe number of
simple names referred to before
the
data
set was found.
For example, if the quali-
fied
name
A.B.C.D
were specified, and a
data set were found
cataloged
at
A.B.C,
register
0
would contain the binary code
3.
A syntax error exists in the
name
(e.g.,
nine characters, a double delimiter, blank
name field, etc.).
A
permanent
I/O
error
processing the catalog.
was
found
when
If the LOCATE macro-instruction fails to
perfo~m
its function for any of
the
reasons
indicated
above, register 0 contains the number of indexes
I
searched before the failure was encountered.
L ___________________________________________________ _
r-----------------------------·-----------------------,
I
OBTAIN Macro-Instruction
I
~----------------------------------------------------~
I
Code
Interpretation
I
I
J
I
4
The required volume was not mounted.
I
I
I
I
8
The DSCB was not found in the VTOC of
the
J
I
specified voIume.
I
I
I
I
12
A
permanent
1,0
error
was
found
when
I
I
processing the specified volume.
I
L ____________________________________________________
J
24
r----------------------------------------~-----------,
I
INDEX Macro-Instruction
!
~----------------------------------------------------i
Code
Interpretation
4
Either the required control volume was not
mounted,
or the specified volume does not
contain a catalog data set (SYSCTLG).
8
The existing catalog structure
is
incon-
sistent
with
the
operation
performed.
Because
the
INDEX macro-instruction uses
the search routine of
the
LOCATE
macro-
instruction,
register
1
contains
the
condition
code that would be given by the
LOCATE macro-instruction, and
register
0
contains
the
number
of
index
levels
referred to during the search.
12
An
attempt was made to delete an index or
generation index that has an alias or
has
indexes
or
data sets cataloged under it.
The index is unchanged.
16
The qualified name specified when building
an index or generation
index
implies
an
index
structure
that does not exist: the
high level index, specified when
connect-
ing control volumes, does not exist.
20
Space
is
not
available .on the specified
control volume.
24
Not used with the INDEX macro-instruction.
t
I
28
A
permanent
I/O
error
was
found
when
I
I
processing the catalog.
I
L _________________ - __________________________________
J
r----------------------------------------------------,
t
SCRATCH Macro-Instruction
I
~----------------------------------------------------i
Code
Interpretat ion
I
4
8
No volumes containing any part of the data
set were mounted, nor was
a
UCB
address
contained in register
o.
)
i
I
I
I
An
unusual
condition
was encountered on
I
one or more volumes.
I
After the SCRATCH macro-instruction is executed,
the last byte of each 12-byte volume pointer
in
the
volume
list indicates the following condi-
tions in binary code:
I
I
I
I
,
o
1
3
4
5
6
Interpretation
The DSCB
for
the data set has been deleted
from the VTOC on the volume pointed to.
i
I
I
I
I
The VTOC of this volume does
not
contain
I
the DSCB to be de leted.
I
The
DSCB
was
not deleted because either
the OVRD option was not specified
or
the
retention cycle has not expired.
I
I
I
I
I
A
permanent
I/O
error
was
found
when
I
processing this volume.
I
I
A device
for
mounting
this
volume
was
I
unavailable.
I
I
The
operator
was
unable
to
mount this
I
volume.
I
____________________________________________________ J
r----------------------------------------------------l
(
CATALOG Macro-Instruction
i
~----------------------------------------------------~
Code
Interpretation
I
4
8
12
Either the required control volume was not
mounted,
or the specified volume does not
contain a catalog data set (SYSCTLG).
The existing catalog structure
is
incon-
sistent
with
the
operation
performed.
Because
the
INDEX macro-instruction uses
the search routine of
the
LOCATE
macro-
instruction,
register
1
contains
the
condition
code that would be given by the
LOCATE macro-instruction, and
register
0
contains
the
number
of
index
levels
referred to during the search.
Not
used
with
instruction.
the
CATALOG
macro-
16
The
index
structure necessary to catalog
the data set does not exist.
20
Space is not available
on
the
specified
control volume.
24
An
attempt
was
made
to
catalog
improperly named generation data set.
an
28
A
permanent
I/O
error
was
found
when
processing the catalog.
I
I
I
I
I
I
I
I
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -______________ J
r----------------------------------------------------,
I
RENAME Macro-Instruction
I
~----------------------------------------------------~
Code
Interpretation
4
No volumes containing any part of the data
set were mounted, nor was
a
UCE
address
contained in register
o.
8
An
unusuaL
condition
was encountered on
one or more volumes.
After the RENAME macro-instruction is
executed,
the
last byte of each 12-byte volume pointer in
toe volume list indicates the
following
condi-
tions in binary code:
Code
Interpretation
o
The DSCB for the data set has been renamed
in the VTOC on the volume pointed to.
1
The
VTOC
of this volume does not contain
the DSCB to be renamed.
3
A DSCB containing
the
new
name
already
exists in the VTOC
of
this volume.
4
A
permanent
I/O
error
processing this volume.
was
found
when
I
I
5
A device
for
mounting
this
volume
was
I
unavailable.
I
i
6
The
operator
was
unable
to
mount this
I
I
volume.
I
L __________________________________________________
J
Advertisement
Table of Contents
