Retrieve information about a program, map set, or partition set.
INQUIRE PROGRAM >>-INQUIRE PROGRAM(data-value)----------------------------------> .-----------------------------. V | >----+-------------------------+-+----------------------------->< +-APIST(cvda)-------------+ +-CEDFSTATUS(cvda)--------+ +-COBOLTYPE(cvda)---------+ +-COPY(cvda)--------------+ +-CONCURRENCY(cvda)-------+ +-DATALOCATION(cvda)------+ +-DYNAMSTATUS(cvda)-------+ +-ENTRYPOINT(ptr-ref)-----+ +-EXECKEY(cvda)-----------+ +-EXECUTIONSET(cvda)------+ +-HOLDSTATUS(cvda)--------+ +-JVMCLASS(data-area)-----+ +-JVMDEBUG(cvda)----------+ +-JVMPROFILE(data-area)---+ +-LANGDEDUCED(cvda)-------+ +-LANGUAGE(cvda)----------+ +-LENGTH(data-area)-------+ +-LOADPOINT(ptr-ref)------+ +-LPASTATUS(cvda)---------+ +-PROGTYPE(cvda)----------+ +-REMOTENAME(data-area)---+ +-REMOTESYSTEM(data-area)-+ +-RESCOUNT(data-area)-----+ +-RUNTIME(cvda)-----------+ +-SHARESTATUS(cvda)-------+ +-STATUS(cvda)------------+ +-TRANSID(data-area)------+ '-USECOUNT(data-area)-----'
Conditions: END, ILLOGIC, NOTAUTH, PGMIDERR
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The INQUIRE PROGRAM command returns information about a particular program, map set, or partition set installed in your CICS system. All of these resources are load modules and, therefore, CICS uses the same INQUIRE command for all three. To avoid confusion, we use the word module to refer to the object of your inquiry, except in some cases where the option applies only to executable programs.
CICS determines the information you request from both the resource definition and, where applicable, the load module. Information from the module takes precedence over that in the definition if there is a conflict. However, CICS inspects a module only if it is already loaded and is the copy currently available for use. CICS does not do a load for an INQUIRE PROGRAM command, nor attempt to autoinstall a resource for which it has no definition.
You can also browse through the definitions of these three types of resources in your system by using the browse options (START, AT, NEXT, and END) on INQUIRE PROGRAM commands. In browse mode, the definitions are returned in alphabetical order, and you can specify a starting point with the AT option if you wish. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.
You cannot modify a program's concurrency attribute using the SPI--the
CONCURRENCY option is not supported on the EXEC CICS SET PROGRAM command.
You can only change the concurrency by redefining the program's CONCURRENCY
option in the CICS program resource definition, or in the program autoinstall
model, and then reinstalling the definition.
For a distributed program link (DPL) request, the server region on which the program is to execute must be specified explicitly on the REMOTESYSTEM option of the PROGRAM definition or on the SYSID option of the LINK command; otherwise it defaults to the local region.
For information about the dynamic routing of DPL requests, see the CICS Intercommunication Guide.