PROGRAM Resource Table
A CICS® Resource that describes a program in an active CICS system being managed by CICSPlex® SM.
The Primary key field for this resource class is PROGRAM.
The following
actions are supported:
- DISABLE
- Disable the program.
- DISCARD
- Remove the installed program.
- ENABLE
- Enable the program.
- NEWCOPY
- Load a new copy of the program.
CICS loads the new version from the DFHRPL or dynamic LIBRARY concatenation, or uses an LPA resident version, depending on the PRIVATE or SHARED options. PRIVATE is the default setting.
- PHASEIN
- CICS will use a new copy of the program for all new transaction requests. CICS continues to use the old copy for all currently running transactions until they have finished, and have a RESCOUNT value of zero. CICS loads the new version from the DFHRPL or dynamic LIBRARY concatenation. or uses an LPA resident version, depending on the PRIVATE or SHARED options. PRIVATE is the default setting.
- RELEASE
- Release a program that is previously loaded by a LOAD command. Therefore, the issuing task can no longer use the resource unless another LOAD is issued.
Note:
- The PLATFORM, APPLICATION, APPLMAJORVER, APPLMINORVER, and APPLMICROVER parameters are all required when the GET operation is in the context of an application that is deployed on a platform.
- The CVDA value returned by CICS for the attribute APIST(CICSAPI) conflicts with an existing CVDA value. In order to retain the attribute's uniqueness, CICSPlex SM adds 8000 to the value returned by CICS. For more information about translating CVDA values, see TRANSLATE command.
- External resource name(CMCI)
- CICSProgram
- Object type
- CICS Resource
- Length
- 800
- Usage
- API, WUI, CICS Management Client Interface(CMCI), EVALDEF
- API view
- Yes
- CMAS context
- No
- SCOPE applies
- Yes
- Only query CMASs in workload
- No
- Copybook identifier
- EYUt0017
- Security Class
- OPERATE.PROGRAM
Operations | Actions | Parameters | Required |
---|---|---|---|
GET | APPLICATION(value) | No | |
APPLMAJORVER(value) | No | ||
APPLMICROVER(value) | No | ||
APPLMINORVER(value) | No | ||
PLATFORM(value) | No | ||
SET | None | N/A | |
PERFORM SET | DISABLE | None | N/A |
DISCARD | None | N/A | |
ENABLE | None | N/A | |
NEWCOPY | None | N/A | |
PHASEIN | None | N/A | |
RELEASE | None | N/A |
Value | Code | Description |
---|---|---|
1 | PROGRAM_INCOMP_APPLCON | Incomplete application qualifier |
Name | Datatype | Source | CICS Source | CICS Field | Len | Sum | Set | Description | Default | Get Invalid | Set Invalid | Offset |
---|---|---|---|---|---|---|---|---|---|---|---|---|
EYU_CICSNAME | CHAR | CPSM | 8 | DIFF | No | CICS System Name | 0 | |||||
EYU_CICSREL | CHAR | CPSM | 4 | DIFF | No | CICS Release | 8 | |||||
EYU_RESERVED | CHAR | CPSM | 4 | N/A | No | Reserved | 12 | |||||
PROGRAM-1 | CHAR | INQ | 8 | DIFF | No | Program name | 16 | |||||
ALOADTIME | INT16US | CPSM | 4 | AVG | No | Average load time | 420 | |||||
APIST | CVDAS | INQ | PROGRAM | APIST | 4 | LIKE | No | API status | 460 | |||
APIST Output valid values |
|
|||||||||||
APPLICATION | CHAR | INQ | PROGRAM | APPLICATION | 64 | DIFF | No | Application Name | E640 E650 E660 E670 | 585 | ||
APPLMAJORVER | BINARY | INQ | PROGRAM | APPLMAJORVER | 4 | MAX | No | Major Version | E640 E650 E660 E670 | 780 | ||
APPLMICROVER | BINARY | INQ | PROGRAM | APPLMICROVER | 4 | MAX | No | Micro Version | E640 E650 E660 E670 | 788 | ||
APPLMINORVER | BINARY | INQ | PROGRAM | APPLMINORVER | 4 | MAX | No | Minor Version | E640 E650 E660 E670 | 784 | ||
BASDEFINEVER | BINARY | CPSM | 1 | AVG | No | BAS resource definition version | 0 | E640 E650 | 576 | |||
CEDFSTATUS | CVDAS | INQ | PROGRAM | CEDFSTATUS | 4 | LIKE | Yes | CEDF status | 72 | |||
CEDFSTATUS Input/output valid values |
|
|||||||||||
CEDFSTATUS Output valid values |
|
|||||||||||
CHANGEAGENT | CVDAS | INQ | PROGRAM | CHANGEAGENT | 4 | LIKE | No | Last modification agent | E640 E650 | 524 | ||
CHANGEAGENT Input/output valid values |
|
|||||||||||
CHANGEAGREL | CHAR | INQ | PROGRAM | CHANGEAGREL | 4 | DIFF | No | Last modification agent release | E640 E650 | 528 | ||
CHANGETIME | DATETIME | INQ | PROGRAM | CHANGETIME | 8 | MAX | No | Last modification time | E640 E650 | 536 | ||
CHANGEUSRID | CHAR | INQ | PROGRAM | CHANGEUSRID | 8 | DIFF | No | Last modification user ID | E640 E650 | 516 | ||
COBOLTYPE | CVDAS | INQ | PROGRAM | COBOLTYPE | 4 | LIKE | No | COBOL type | 108 | |||
COBOLTYPE Output valid values |
|
|||||||||||
CONCURRENCY | CVDAS | INQ | PROGRAM | CONCURRENCY | 4 | LIKE | No | Concurrency option | 140 | |||
CONCURRENCY Output valid values |
|
|||||||||||
COPY | CVDAS | INQ | PROGRAM | COPY | 4 | LIKE | Yes | Newcopy required status | 132 | |||
COPY Input valid values |
|
|||||||||||
COPY Output valid values |
|
|||||||||||
CURRENTLOC | EYUDA | STAT | DFHLDRDS | LDRLOCN | 4 | LIKE | No | CICS DSA in which current copy is located | 128 | |||
CURRENTLOC Output valid values |
|
|||||||||||
DATALOCATION | CVDAS | INQ | PROGRAM | DATALOCATION | 4 | LIKE | No | Data location | 80 | |||
DATALOCATION Output valid values |
|
|||||||||||
DEFINESOURCE | CHAR | INQ | PROGRAM | DEFINESOURCE | 8 | DIFF | No | Source of the resource definition | E640 E650 | 544 | ||
DEFINETIME | DATETIME | INQ | PROGRAM | DEFINETIME | 8 | MAX | No | Creation time | E640 E650 | 552 | ||
DYNAMSTATUS | CVDAS | INQ | PROGRAM | DYNAMSTATUS | 4 | LIKE | No | Dynamic routing type | 136 | |||
DYNAMSTATUS Output valid values |
|
|||||||||||
ENTRYPOINT | ADDRESS | INQ | PROGRAM | ENTRYPOINT | 4 | MAX | No | Program entry point | 100 | |||
EXECKEY | CVDAS | INQ | PROGRAM | EXECKEY | 4 | LIKE | No | Program execution key | 92 | |||
EXECKEY Output valid values |
|
|||||||||||
EXECUTIONSET | CVDAS | INQ | PROGRAM | EXECUTIONSET | 4 | LIKE | Yes | API subset restriction type | 96 | |||
EXECUTIONSET Input/output valid values |
|
|||||||||||
EXECUTIONSET Output valid values |
|
|||||||||||
FETCHCNT | BINARY | STAT | DFHLDRDS | LDRFC | 4 | AVG | No | Number of times program loaded into storage | 44 | |||
FETCHTIME | INT16US | STAT | DFHLDRDS | LDRFT | 4 | MAX | No | Total time for all program fetches | 84 | |||
HOLDSTATUS | CVDAS | INQ | PROGRAM | HOLDSTATUS | 4 | LIKE | No | Hold status | 52 | |||
HOLDSTATUS Output valid values |
|
|||||||||||
HOTPOOLING | CVDAS | INQ | PROGRAM | HOTPOOLING | 4 | LIKE | Yes | Hot pooling status | E640+ | E640+ | 408 | |
HOTPOOLING Input/output valid values |
|
|||||||||||
HOTPOOLING Output valid values |
|
|||||||||||
INSTALLAGENT | CVDAS | INQ | PROGRAM | INSTALLAGENT | 4 | LIKE | No | Installation agent | E640 E650 | 532 | ||
INSTALLAGENT Input/output valid values |
|
|||||||||||
INSTALLTIME | DATETIME | INQ | PROGRAM | INSTALLTIME | 8 | MAX | No | Installation time | E640 E650 | 568 | ||
INSTALLUSRID | CHAR | INQ | PROGRAM | INSTALLUSRID | 8 | DIFF | No | Installation user ID | E640 E650 | 560 | ||
JVMCLASS | CHAR | INQ | PROGRAM | JVMCLASS | 255 | DIFF | Yes | Java virtual machine class | 152 | |||
JVMDEBUG | CVDAS | INQ | PROGRAM | JVMDEBUG | 4 | LIKE | Yes | Java virtual machine (JVM) debug status | E610+ | 148 | ||
JVMDEBUG Input/output valid values |
|
|||||||||||
JVMPROFILE | CHAR | INQ | PROGRAM | JVMPROFILE | 8 | DIFF | Yes | Java virtual machine (JVM) profile name | DFHJVMPR | E680+ | 412 | |
JVMSERVER | CHAR | INQ | PROGRAM | JVMSERVER | 8 | DIFF | No | Java virtual machine (JVM) server | E640 E650 E660 | 577 | ||
LANGUAGE | CVDAS | INQ | PROGRAM | LANGDEDUCED | 4 | LIKE | No | Language | 24 | |||
LANGUAGE Output valid values |
|
|||||||||||
LENGTH | CNUMERIC | INQ | PROGRAM | LENGTH | 4 | MAX | No | Program length | 60 | |||
LIBRARY | CHAR | INQ | PROGRAM | LIBRARY | 8 | DIFF | No | LIBRARY name | E640 | 464 | ||
LIBRARYDSN | CHAR | INQ | PROGRAM | LIBRARYDSN | 44 | DIFF | No | Load data set name | E640 | 472 | ||
LOADPOINT | ADDRESS | INQ | PROGRAM | LOADPOINT | 4 | MAX | No | Program load point | 104 | |||
LPASTAT | CVDAS | INQ | PROGRAM | LPASTATUS | 4 | LIKE | No | Link pack area (LPA) status | 68 | |||
LPASTAT Output valid values |
|
|||||||||||
NEWCOPYCNT | BINARY | STAT | DFHLDRDS | LDRTN | 4 | AVG | No | Number of NEWCOPY requests issued | 28 | |||
OPERATION | CHAR | INQ | PROGRAM | OPERATION | 64 | DIFF | Yes | Operation Name | E640 E650 E660 E670 | 713 | ||
PGRJUSECOUNT | BINARY | STAT | DFHPGRDS | PGR_JVMPROGRAM_USECOUNT | 4 | AVG | No | Number of times JVM program used since last reset | 456 | |||
PLATFORM | CHAR | INQ | PROGRAM | PLATFORM | 64 | DIFF | No | Platform Name | E640 E650 E660 E670 | 649 | ||
PROGTYPE | CVDAS | INQ | PROGRAM | PROGTYPE | 4 | LIKE | No | Program type | 76 | |||
PROGTYPE Output valid values |
|
|||||||||||
REMOTENAME | CHAR | INQ | PROGRAM | REMOTENAME | 8 | DIFF | No | Program name in remote system | 112 | |||
REMOTESYSTEM | CHAR | INQ | PROGRAM | REMOTESYSTEM | 4 | DIFF | No | Remote system name | 120 | |||
REMOVECNT | BINARY | STAT | DFHLDRDS | LDRRPC | 4 | AVG | No | Number of times removed by program compression | 88 | |||
RESCOUNT | CNUMERIC | INQ | PROGRAM | RESCOUNT | 4 | SUM | No | Number of times program currently accessed | 40 | |||
RESIDENCY | CVDAS | INQ | PROGRAM | RESIDENCY | 4 | MAX | No | Program residency | E640 E650 E660 E670 E680 | 792 | ||
RESIDENCY Output valid values |
|
|||||||||||
RLOADING | RATE3 | CPSM | 8 | AVG | No | Rate of program loading | 432 | |||||
RPLID | BINARY | STAT | DFHLDRDS | LDRRPLO | 4 | AVG | No | Data set offset number | 64 | |||
RREMOVAL | RATE3 | CPSM | 8 | AVG | No | Rate of program removal | 440 | |||||
RUNTIME | CVDAS | INQ | PROGRAM | RUNTIME | 4 | LIKE | Yes | Runtime environment information | 144 | |||
RUNTIME Input/output valid values |
|
|||||||||||
RUNTIME Input valid values |
|
|||||||||||
RUNTIME Output valid values |
|
|||||||||||
RUSE | RATE3 | CPSM | 8 | AVG | No | Rate of program use | 448 | |||||
SHARESTATUS | CVDAS | INQ | PROGRAM | SHARESTATUS | 4 | LIKE | Yes | Share status | 56 | |||
SHARESTATUS Input/output valid values |
|
|||||||||||
SHARESTATUS Output valid values |
|
|||||||||||
STATUS | CVDAS | INQ | PROGRAM | STATUS | 4 | LIKE | Yes | Enabled status | 48 | |||
STATUS Input/output valid values |
|
|||||||||||
TRANSID | CHAR | INQ | PROGRAM | TRANSID | 4 | DIFF | No | Mirror transaction name for remote attach | 124 | |||
USEAGELSTAT | BINARY | STAT | DFHLDRDS | LDRTU | 4 | AVG | No | Number of times program was used since last reset | 36 | |||
USECOUNT | CNUMERIC | INQ | PROGRAM | USECOUNT | 4 | SUM | No | Total number of times program was executed | 32 | |||
USEFETCH | AVERAGE3 | CPSM | 8 | AVG | No | Average number of program uses per fetch | 424 |