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