IBM SC33-1683-02 User Manual

Page 369

Advertising
background image

ENTRY_POINT(name4)

returns the program’s entry point address, as it would be returned by a Loader
domain ACQUIRE_PROGRAM call.

EXECUTION_KEY(CICS|NOT_APPLIC|USER)

returns the key in which CICS gives control to the program, which determines
whether the program can modify CICS-key storage.

CICS

CICS gives control to the program in CICS key. The program is loaded
into a CICS dynamic storage area (DSA), above or below the 16MB
line; that is, the CDSA or ECDSA, depending on its residency mode
(RMODE) attribute as defined to the linkage-editor.

NOT_APPLIC

Not applicable. This is a mapset, partitionset, or a remote program.

USER CICS gives control to the program in user key. The program is loaded

into a user DSA, above or below the 16MB line; that is, the UDSA or
EUDSA, depending on its residency mode (RMODE) attribute as
defined to the linkage-editor.

EXECUTION_SET(DPLSUBSET|FULLAPI|NOT_APPLIC)

returns a value indicating whether CICS links to and runs the program as if it
were running in a remote CICS region.

DPLSUBSET

CICS links to and runs the program with the API restrictions of a remote
DPL program. The program can use only a subset of the CICS API.

FULLAPI

CICS links to and runs the program without the API restrictions of a
remote DPL program. The program can use the full CICS API.

NOT_APPLIC

Not applicable. This is a mapset, partitionset, or a remote program.
(The EXECUTIONSET option of DEFINE PROGRAM applies only to
local program definitions. Its purpose is to test programs in a local CICS
environment as if they were running as DPL programs.)

HOLD_STATUS(CICS_LIFE|NOT_APPLIC|TASK_LIFE)

returns a value indicating how long the program is to remain loaded.

CICS_LIFE

The program remains loaded until CICS is shut down.

NOT_APPLIC

Not applicable. The program is not loaded, or is remote.

TASK_LIFE

The program remains loaded for the lifetime of the task.

INSTALL_TYPE(AUTO|CATALOG|GROUPLIST|MANUAL|RDO|SYSAUTO)

returns the method that was used to install the PROGRAM resource definition.

AUTO Autoinstall.

CATALOG

The CICS global catalog, after a restart.

GROUPLIST

The CICS startup grouplist.

program management functions

Chapter 3. The user exit programming interface (XPI)

337

Advertising