IBM SC34-6814-04 User Manual

Page 393

Advertising
background image

MODULE_TYPE(MAPSET|PARTITIONSET|PROGRAM)

returns the kind of program resource.

NEW_PROGRAM_TOKEN(name4)

returns a token that can be used to identify the named program.

name4

The name of a location to receive a 4-byte token that identifies this
program.

If PROGRAM_NAME is specified on the request, NEW_PROGRAM_TOKEN is
set to a program token that can be used on subsequent requests for the same
program. If PROGRAM_TOKEN is specified on the request,
NEW_PROGRAM_TOKEN is set to the same value.

PROGRAM_ATTRIBUTE(RELOAD|RESIDENT|REUSABLE|TRANSIENT)

returns the residency status of the program—that is, when its storage is
released.

RELOAD

The program is not reusable, and therefore several copies may be
loaded. A copy is removed from storage when a RELEASE_PROGRAM
call (for that copy) is issued.

RESIDENT

There is a single copy of the program that is not removed from storage
unless deleted. RESIDENT programs must be at least quasireentrant.
Any program of PROGRAM_TYPE SHARED is RESIDENT by default.

REUSABLE

Similar to RESIDENT, except that a REUSABLE program that is not in
use can be removed from storage by CICS, for storage optimization
reasons.

TRANSIENT

Similar to RESIDENT, except that a TRANSIENT program is removed
from storage as soon as its user count drops to zero.

PROGRAM_LENGTH(name4)

returns the length of the program, in bytes, expressed in binary.

PROGRAM_NAME(name8 | string | 'string')

specifies the name of the program to be queried.

name8

The name of a location containing an 8-byte program name.

string A string of characters naming the program.

'string'

A string of characters in quotation marks. The string length is set to 8
by padding with blanks or truncating.

PROGRAM_TOKEN(name4)

specifies a token identifying the program to be queried.

name4

The name of a location containing a 4-byte token obtained from a
previous INQUIRE_PROGRAM call.

PROGRAM_TYPE(NOT_APPLIC|PRIVATE|SHARED|TYPE_ANY)

returns a value indicating where the next new copy of the program is to be
loaded from.

Chapter 3. The user exit programming interface (XPI)

371

Advertising