3C6

Explanation
An error occurred during IARSUBSP macro processing.

System action
The system fails the IARSUBSP request.

Programmer response
Take the action indicated by Programmer
Response in the reason code description.

Source
Real Storage Manager (RSM)
The reason code in
register 15 identifies the error. When an entry in the range list
(specified on the RANGLIST parameter) causes the abend, GPR 2 contains
the address of the range list element in error and GPR 3 contains
the address of the storage being processed. Code
Meaning
xx0108xx
IARSUBSP IDENTIFY failed. The value specified in the NUMRANGE
parameter must be greater than zero and not greater than 16. Programmer
Response: Correct the value on the NUMRANGE parameter.

xx0109xx
IARSUBSP IDENTIFY failed. The number of pages specified by the
second fullword of the range list entry must be greater than 0 and
a multiple of 256. Programmer Response: Correct the second
fullword of the range list entry to specify the correct amount of
storage and resubmit the job.

xx010Axx
IARSUBSP IDENTIFY failed. The address of the storage specified
by the first fullword of the range entry must be aligned on a segment
boundary. A segment is 1 megabyte (1,048,576 bytes) long. Programmer
Response: Correct the first fullword of the range list entry to
specify a storage address on a segment boundary, and resubmit the
job.

xx0112xx
IARSUBSP IDENTIFY failed. The storage specified by the range list
entry must be pageable and located in either high private or low private
storage, and must have been previously obtained using the STORAGE
or GETMAIN macro. Programmer Response: Correct the range
list entry to specify pageable, private storage, or change the subpool
from which the storage was obtained, and resubmit the job.

xx0113xx
IARSUBSP IDENTIFY failed. The storage specified by the range list
entry must be owned by one of the following: The calling task
The task that previously issued IARSUBSP IDENTIFY
A task higher in the task hierarchy than the calling task or the
task that previously issued IARSUBSP IDENTIFY.
Programmer Response: Correct the range list entry
to specify storage owned by one of the tasks listed in the error description.
 If the range list entry is correct, redesign the program so that
the task that issues the IARSUBSP IDENTIFY (or a task higher in the
task hierarchy) owns the storage and is the task that issued any previous
IARSUBSP IDENTIFY requests.

xx0116xx
Subspace identity failed. A segment in the storage range is part
of a shared segment. Programmer Response: Correct the storage
range list entry to specify a storage range that does not include
pages that are part of a shared segment.

xx0211xx
IARSUBSP CREATE failed.  The subspace name is incorrect.  The
name must not be blank, or begin with a numeric character.  The name
must be left-justified, padded to the right with blanks, and must
contain only alphanumeric characters and the characters @, $, and
#. Programmer Response: Correct the subspace name specified
on the NAME parameter, and resubmit the job.

xx0301xx
IARSUBSP ASSIGN failed. The caller's primary and home address
spaces must be the same. Programmer Response: Change the
cross memory mode so that the primary and home address spaces are
the same, and resubmit the job.

xx0302xx
IARSUBSP ASSIGN failed. The caller held a lock. Programmer
Response: Release all locks and resubmit the job.

xx0303xx
IARSUBSP ASSIGN failed. A protection exception occurred while
the caller was referencing the parameter list. Programmer Response: The
parameter list must be in storage that the caller can access. Make
sure the storage was obtained by the caller or passed to the caller
by a task higher in the task hierarchy.

xx0304xx
IARSUBSP ASSIGN failed. The caller issued a macro version that
is not valid. Programmer Response: Use the IARSUBSP macro
to generate the parameter list.

xx0308xx
IARSUBSP ASSIGN failed. The value specified in the NUMRANGE parameter
must be greater than zero and not greater than 16. Programmer
Response: Correct the value on the NUMRANGE parameter.

xx0309xx
IARSUBSP ASSIGN failed. The number of pages specified by the second
fullword of the range list entry must be greater than 0 and a multiple
of 256 for storage addresses above 16 megabytes. Programmer
Response: Correct the value specified in the second fullword of
the range list entry, and resubmit the job.

xx030Axx
IARSUBSP ASSIGN failed. The range entry must be aligned on a segment
boundary for storage addresses above 16 megabytes. A segment is 1
megabyte (1,048,576 bytes) long. Programmer Response: Correct
the first fullword of the range list entry to specify a storage address
on a segment boundary, and resubmit the job.

xx030Bxx
IARSUBSP ASSIGN failed. The range list entry must specify an address
that is aligned on a page boundary for storage addresses below 16
megabytes. Programmer Response: Correct the first fullword
of the range list entry to specify a storage address on a page boundary,
and resubmit the job.

xx030Cxx
IARSUBSP ASSIGN failed. The specified STOKEN does not represent
a valid subspace. Programmer Response: Correct the value
specified on the STOKEN parameter and resubmit the job.

xx0310xx
IARSUBSP ASSIGN failed. The range must have been specified on
a prior IARSUBSP IDENTIFY request before it can be specified on IARSUBSP
ASSIGN. Programmer Response: Ensure that you are supplying
the correct range list to IARSUBSP ASSIGN, and that the values in
the range list are correct.  If so, correct your program design to
issue IARSUBSP IDENTIFY before issuing IARSUBSP ASSIGN, and rerun
the program.

xx0311xx
IARSUBSP ASSIGN failed. The range already is assigned to another
subspace. Programmer Response: None necessary. However,
you might want to take some action depending on your program. If you
resubmit the job, specify a different range of storage that is eligible
to be assigned to a subspace but not yet assigned.

xx0312xx
IARSUBSP ASSIGN failed. The range cannot span across either the
16-megabyte boundary or the 2-gigabyte boundary. Programmer
Response: Change the second fullword of the range list entry to
specify a valid storage range, and resubmit the job.

xx0401xx
IARSUBSP UNASSIGN failed. The caller's primary and home address
spaces must be the same. Programmer Response: Change the
cross memory mode so that the primary and home address spaces are
the same, and resubmit the job.

xx0402xx
IARSUBSP UNASSIGN failed. The caller held a lock. Programmer
Response: Release all locks and resubmit the job.

xx0403xx
IARSUBSP UNASSIGN failed. A protection exception occurred while
the caller was referencing the parameter list. Programmer Response: The
parameter list must be in storage that can be read by the calling
program.

xx0404xx
IARSUBSP UNASSIGN failed. The caller issued a macro version that
is not valid. Programmer Response: Use the IARSUBSP macro
to generate the parameter list.

xx0408xx
IARSUBSP UNASSIGN failed. The value specified in the NUMRANGE
parameter must be greater than zero and not greater than 16. Programmer
Response: Correct the value on the NUMRANGE parameter.

xx0409xx
IARSUBSP UNASSIGN failed. The number of pages specified by the
second fullword of the range list entry must be greater than 0 and
a multiple of 256 for storage addresses above 16 megabytes. Programmer
Response: Correct the value specified in the second fullword of
the range list entry and resubmit the job.

xx040Axx
IARSUBSP UNASSIGN failed. The range entry must be aligned on a
segment boundary for storage addresses above 16 megabytes. A segment
is 1 megabyte (1,048,576 bytes) long. Programmer Response: Correct
the first fullword of the range list entry to specify a storage address
on a segment boundary, and resubmit the job.

xx040Bxx
IARSUBSP UNASSIGN failed. The range list entry must specify an
address that is aligned on a page boundary for storage addresses below
16 megabytes. Programmer Response: Correct the first fullword
of the range list entry to specify a storage address on a page boundary,
and resubmit the job.

xx040Cxx
IARSUBSP UNASSIGN failed. The specified STOKEN does not represent
a valid subspace. Programmer Response: Correct the value
specified on the STOKEN parameter and resubmit the job.

xx0412xx
IARSUBSP UNASSIGN failed. The range cannot span across either
the 16-megabyte boundary or the 2-gigabyte boundary. Programmer
Response: Change the second fullword of the range list entry to
specify a valid storage range, and resubmit the job.

xx050Cxx
IARSUBSP DELETE failed. The specified STOKEN does not represent
a valid subspace. Programmer Response: Correct the value
specified on the STOKEN parameter and resubmit the job.

xx0510xx
IARSUBSP DELETE failed. The caller is running in or is eligible
to run in the subspace that is to be deleted. Programmer Response: Correct
the STOKEN supplied on the STOKEN parameter.  If the STOKEN is correct,
change the program design to switch to full address space addressability
before attempting to delete the subspace.

xx0511xx
IARSUBSP DELETE failed. Another program is running in or is eligible
to run in the subspace that is to be deleted. Programmer Response: Correct
the STOKEN supplied on the STOKEN parameter.  If the STOKEN is correct,
change the program design to delete the subspace after the program
has finished processing.

xx0512xx
IARSUBSP DELETE failed. The caller does not own the subspace to
be deleted. Programmer Response: Correct the STOKEN supplied
on the STOKEN parameter.  If the STOKEN is correct, change the program
design so the task that created the subspace deletes it.

xx0608xx
IARSUBSP UNIDENTIFY failed. The value specified in the NUMRANGE
parameter must be greater than zero and not greater than 16. Programmer
Response: Correct the value on the NUMRANGE parameter.

xx0609xx
IARSUBSP UNIDENTIFY failed. The number of pages specified by the
second fullword of the range list entry must be greater than 0 and
a multiple of 256. Programmer Response: Correct the second
fullword of the range list entry to specify the correct amount of
storage and resubmit the job.

xx060Axx
IARSUBSP UNIDENTIFY failed. The address of the storage specified
by the first fullword of the range entry must be aligned on a segment
boundary. A segment is 1 megabyte (1,048,576 bytes) long. Programmer
Response: Correct the first fullword of the range list entry to
specify a storage address on a segment boundary, and resubmit the
job.

xxFF01xx
IARSUBSP failed.  The caller's primary, secondary, and home address
spaces are not the same (the caller is in cross memory mode.) Programmer
Response: Change the cross memory mode so that the primary, secondary,
and home address spaces are the same, and resubmit the job.

xxFF02xx
IARSUBSP failed. The caller held a lock. Programmer Response: Release
all locks and resubmit the job.

xxFF03xx
IARSUBSP failed. A protection exception occurred while the caller
was referencing the parameter list. Programmer Response: The
parameter list must be in storage that can be read by the calling
program. For a CREATE request, the parameter list must be in storage
that can also be modified by the calling program.

xxFF04xx
IARSUBSP failed. The caller issued a macro version that is not
valid. Programmer Response: Use the IARSUBSP macro to generate
the parameter list.

xxFF05xx
IARSUBSP failed. The reserved fields in caller's IARSUBSP parameter
list must be zeros. Programmer Response: Ensure that you
are running the program on the correct MVS™ release,
and that you use the IARSUBSP macro to generate the parameter list.

xxFF06xx
IARSUBSP failed. The caller requested a service that is not valid. Programmer
Response: Use the IARSUBSP macro to generate the parameter list.

xxFF07xx
IARSUBSP failed. The caller must be in 31-bit addressing mode
to use IARSUBSP. Programmer Response: Change to 31-bit addressing
mode by issuing the BASSM or BSM instruction, then resubmit the job.
 BASSM and BSM are described in Principles of Operation.

xxFF08xx
IARSUBSP failed; caller must not have virtual space above 2G. Programmer Response: In order to use subspaces,
the program must be running in an address space that has not previously
used virtual storage above 2 gigabyes. The programmer should either
run the program as a started task, or submit the program to run in
an initiator job class (set by the installation) that limits address
spaces to 2 gigabytes.

xxFF0Exx
IARSUBSP failed.  The caller must be in task mode. Programmer
Response: Change the program design to ensure that the IARSUBSP
macro is invoked in task mode, and resubmit the job.