4. If

the continuation handle field in the

receiver variable is not

the

following steps until the continuation

handle equals blanks:

a. Copy the continuation handle from the receiver variable to the c handle parameter.

 

b. Call

the

API again by

using

the continuation handle

that is retur

 

all

other

parameters

the

same

as

the

original API

call.

For

a program

example that

uses

a continuation handle, see “Retrieve Ex

and

Exit

Program Information—ILE

C

Example”

on

page 4-13.

 

Domain Concepts

All objects are assigned a domain attribute when domainthey areis acreated. A characteristic of an object that controls how programs can access the set, the domain remains in effect for the life of the object. The butes aresystem anduser.

Most object types on the

system

are

created

in system domain. When y

your

system

at security

level

40

or

50, system

domain objects can be

only

by using

the commands

and

callable

APIs provided.

These object types can be either system or user domain. The list inc symbolic object type.

Ÿ User space (*USRSPC)

ŸUser index (*USRIDX)

ŸUser queue (*USRQ)

Objects of the type *USRSPC, *USRIDX, and *USRQ in the user domain ca manipulated directly by MI instructions without using the system-provided 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 c

user

domain. Starting in

Version 2

Release

3

Modification 0, user

objec

in either the user domain or the system domain. The allow user domain (QALWUSRDMN) system value determines which libraries can contain user-domai user objects. The default QALWUSRDMN system value is set to *ALL, but c changed by system administrators on individual machines to be one libra of libraries. If your application requires direct pointer access to objects in a library that is not specified in the QALWUSRDMN value, y

administrator

can

add the library to the system value.

 

 

The

ability

to

create user

domain objects on

a

system

with a

securi

is

controlled

by the allow user domain (QALWUSRDMN)

system

value. See the

table in the

description of

the Create User

Queue (QUSCRTUQ)System

API in

API

Referencefor

more information.

 

 

 

 

2-26System API Programming V4R1

Page 46
Image 46
IBM Version 4 manual Domain Concepts, Api, More information