4. If the continuation handle field in the receiver variable is not set to blanks, do
the following steps until the continuation handle equals blanks:
a. Copy the continuation handle from the receiver variable to the continuation
handle parameter.
b. Call the API again by using the continuation handle that is returned. Keep
all other parameters the same as the original API call.
For a program example that uses a continuation handle, see “Retrieve Exit Point
and Exit Program Information—ILE C Example” on page 4-13.
Domain Concepts
All objects are assigned a domain attribute when they are created. A domain is a
characteristic of an object that controls how programs can access the object. Once
set, the domain remains in effect for the life of the object. The two possible attri-
butes are
system
and
user
.
Most object types on the system are created in system domain. When you run
your system at security level 40 or 50, system domain objects can be accessed
only by using the commands and callable APIs provided.
These object types can be either system or user domain. The list includes the
symbolic object type.
User space (*USRSPC)
User index (*USRIDX)
User queue (*USRQ)
Objects of the type *USRSPC, *USRIDX, and *USRQ in the user domain can be
manipulated directly by MI instructions without using the system-provided APIs and
commands.
Note: Objects of the type *PGM, *SRVPGM, and *SQLPKG also can be in the
user domain. Their contents cannot be manipulated directly by MI
instructions.
Prior to Version 2 Release 3 Modification 0, all user objects were created into the
user domain. Starting in Version 2 Release 3 Modification 0, user objects can exist
in either the user domain or the system domain. The allow user domain
(QALWUSRDMN) system value determines which libraries can contain user-domain
user objects. The default QALWUSRDMN system value is set to *ALL, but can be
changed by system administrators on individual machines to be one library or a list
of libraries. If your application requires direct pointer access to user-domain user
objects in a library that is not specified in the QALWUSRDMN value, your system
administrator can add the library to the system value.
The ability to create user domain objects on a system with a security level 40 or 50
is controlled by the allow user domain (QALWUSRDMN) system value. See the
table in the description of the Create User Queue (QUSCRTUQ) API in the
System
API Reference
for more information.
2-26 System API Programming V4R1