The set_program call – IBM SC33-1683-02 User Manual

Page 375

Advertising
background image

RESPONSE and REASON values for
INQUIRE_CURRENT_PROGRAM:

RESPONSE

REASON

OK

None

EXCEPTION

NO_CURRENT_PROGRAM

DISASTER

LOCK_ERROR
ABEND

INVALID

None

KERNERROR

None

PURGED

None

The SET_PROGRAM call

SET_PROGRAM allows you to set selected attributes in the definition of a specified
program.

SET_PROGRAM

DFHPGISX [CALL,]

[CLEAR,]

[IN,

FUNCTION(SET_PROGRAM),

{PROGRAM_NAME(name8 | string | 'string')|

PROGRAM_TOKEN(name4)},]

[AVAIL_STATUS(DISABLED|ENABLED),]

[CEDF_STATUS(CEDF|NOCEDF),]

[EXECUTION_KEY(CICS|USER),]

[EXECUTION_SET(DPLSUBSET|FULLAPI),]

[PROGRAM_ATTRIBUTE(RELOAD|RESIDENT|REUSABLE|TRANSIENT),]

[PROGRAM_TYPE(PRIVATE|SHARED|TYPE_ANY),]

[PROGRAM_USAGE(APPLICATION|NUCLEUS),]

[REQUIRED_AMODE(24|31|AMODE_ANY),]

[REQUIRED_RMODE(24|RMODE_ANY),]]

[OUT,

RESPONSE(name1 | *),

REASON(name1 | *)]

AVAIL_STATUS(DISABLED|ENABLED)

specifies whether the program can be used—that is, whether or not it is
enabled.

CEDF_STATUS(CEDF|NOCEDF)

specifies whether, when the program is running under the control of the CICS
execution diagnostic facility (EDF), EDF diagnostic screens are displayed.

EXECUTION_KEY(CICS|USER)

specifies the key in which CICS is to give control to the program. The key
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.

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.

program management functions

Chapter 3. The user exit programming interface (XPI)

343

Advertising