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

Page 367

Advertising
background image

and the DFHPGAQX calls:

INQUIRE_AUTOINSTALL

SET_AUTOINSTALL.

Used with the Loader functions DEFINE_PROGRAM, ACQUIRE_PROGRAM,
RELEASE_PROGRAM, and DELETE_PROGRAM, these calls give you a
comprehensive set of tools for manipulating programs. (Note, however, that the
tokens returned in the NEW_PROGRAM_TOKEN fields of DFHPGISX calls are
different from those returned by DFHLDLDX Loader calls. You should not use a
token obtained from a DFHPGISX call in a DFHLDLDX call, or vice versa.)

The INQUIRE_PROGRAM call

INQUIRE_PROGRAM returns information about the attributes of a specified
program.

INQUIRE_PROGRAM

DFHPGISX [CALL,]

[CLEAR,]

[IN,

FUNCTION(INQUIRE_PROGRAM),

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

PROGRAM_TOKEN(name4)},]

[OUT,

[ACCESS(CICS|NONE|READ_ONLY|USER),]

[AVAIL_STATUS(DISABLED|ENABLED),]

[CEDF_STATUS(CEDF|NOCEDF|NOT_APPLIC),]

[DATA_LOCATION(ANY|BELOW|NOT_APPLIC),]

[DYNAMIC_STATUS(DYNAMIC|NOT_DYNAMIC),]

[ENTRY_POINT(name4),]

[EXECUTION_KEY(CICS|NOT_APPLIC|USER),]

[EXECUTION_SET(DPLSUBSET|FULLAPI|NOT_APPLIC),]

[HOLD_STATUS(CICS_LIFE|NOT_APPLIC|TASK_LIFE),]

[INSTALL_TYPE(AUTO|CATALOG|GROUPLIST|MANUAL|RDO|SYSAUTO),]

[LANGUAGE_DEDUCED(ASSEMBLER|C370|COBOL|

COBOL2|LE370|NOT_APPLIC|NOT_DEDUCED|PLI),]

[LANGUAGE_DEFINED(ASSEMBLER|C370|COBOL|

LE370|NOT_APPLIC|NOT_DEFINED|PLI),]

[LOAD_POINT(name4),]

[LOAD_STATUS(LOADABLE|NOT_APPLIC|NOT_LOADABLE|NOT_LOADED),]

[LOCATION(CDSA|ECDSA|ELPA|ERDSA|ESDSA|LPA|NONE|RDSA|SDSA),]

[MODULE_TYPE(MAPSET|PARTITIONSET|PROGRAM),]

[NEW_PROGRAM_TOKEN(name4),]

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

[PROGRAM_LENGTH(name4),]

[PROGRAM_TYPE(NOT_APPLIC|PRIVATE|SHARED|TYPE_ANY),]

[PROGRAM_USAGE(APPLICATION|NUCLEUS),]

[PROGRAM_USE_COUNT(name4),]

[PROGRAM_USER_COUNT(name4),]

[REMOTE_DEFINITION(LOCAL|REMOTE),]

[REMOTE_PROGID(name8),]

[REMOTE_SYSID(name4),]

[REMOTE_TRANID(name4),]

[SPECIFIED_AMODE(24|31|AMODE_ANY|AMODE_NOT_SPECIFIED),]

[SPECIFIED_RMODE(24|RMODE_ANY|RMODE_NOT_SPECIFIED),]

RESPONSE(name1 | *),

REASON(name1 | *)]

ACCESS(CICS|NONE|READ_ONLY|USER)

returns a value indicating the type of storage into which the program has been
loaded.

program management functions

Chapter 3. The user exit programming interface (XPI)

335

|

Advertising