Program definitions - PROGDEF
The Program definition (PROGDEF) views display information about the control information for a program that is stored in the program library and used to process a transaction.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| Program definitions EYUSTARTPROGDEF.ADDTOGRP |
Add one or more program definitions to a resource group. |
| Program definitions EYUSTARTPROGDEF.CREATE |
Create a program definition and add it to the data repository. |
| Program definitions EYUSTARTPROGDEF.DETAILED |
Detailed information about a selected program definition. |
| Program definitions EYUSTARTPROGDEF.INSTALL |
Install a program definition in an active system. |
| Program definitions EYUSTARTPROGDEF.REMOVE |
Remove a program definition from the data repository. |
| Program definitions EYUSTARTPROGDEF.TABULAR |
Tabular information about all program definitions for the current context. |
Actions
| Action | Description |
|---|---|
| ADDTOGRP | Add one or more program definitions to a resource group. |
| CREATE | Create a program definition and add it to the data repository. |
| CSDCOPY | Copy a CICS CSD resource definition. |
| CSDINSTALL | Install a CICS CSD resource definition into an active system. |
| INSTALL | Install a program definition in an active system. |
| REMOVE | Remove a program definition from the data repository. |
| UPDATE | Update a program definition in the data repository. |
Fields
| Field | Attribute name | Description |
|---|---|---|
| Application program interfaces | API | The API attribute of the installed program definition. The API attribute is used for application programs, PLT programs, user replaceable
modules and task related user exits. The API attribute is not used for global user exits. CVDA values are:
|
| Display execution diagnostic facility (EDF) screens | CEDF | Indicates whether EDF diagnostic screens are displayed. If the program was translated with the EDF option, all EDF screens are
displayed; if it was translated with NOEDF, only the program initiation and termination screens appear. CVDA values are:
|
| Last modification agent | CHANGEAGENT | The change agent identifier that made the last modification.
|
| Last modification agent release | CHANGEAGREL | The CICS release level of the agent that made the last modification. |
| Last modification | CHANGETIME | The local date and time when the definition was last changed. |
| Last modification user ID | CHANGEUSRID | The user ID that made the last modification. |
| Concurrency status | CONCURRENCY | The concurrency attribute of the installed program definition. The CVDA values are:
|
| Time created | CREATETIME | The local date and time when the definition was created. |
| CSD group | CSDGROUP | The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions. |
| Data location | DATALOCATION | Indicates whether this module can accept data addresses higher than 16MB. CVDA values are:
|
| Version | DEFVER | The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions. |
| Description code page | DESCCODEPAGE | The code page of the description field. This field is ignored for CICS CSD resource definitions. |
| Description | DESCRIPTION | A description of the program definition. |
| Dynamic routing status | DYNAMIC | Indicates whether, if the program is the subject of a program-link request, the request can be dynamically routed. CVDA values
are:
|
| Program execution key | EXECKEY | The key in which CICS gives control to the program, and determines whether the program can modify CICS-key storage.
|
| API subset restriction type | EXECUTIONSET | Specifies whether you want CICS to link to and run a program as if it were running in a remote CICS region. |
| Hot pooling status | HOTPOOL | The HOTPOOLING option is obsolete. |
| Java virtual machine (JVM) mode | JVM | Specifies whether or not the program is a Java program that has to operate under the control of a Java Virtual Machine (JVM). |
| Java virtual machine (JVM) class | JVMCLASS |
|
| Java virtual machine (JVM) profile | JVMPROFILE | This is obsolete from CICS TS Version 5 Release 1. The JVM profile name. The name can be up to eight characters in length. Do not use profile names beginning with DFH, because these characters are reserved for use by CICS. |
| Java virtual machine (JVM) server | JVMSERVER | The JVMSERVER resource to be used by this PROGRAM. The name can be up to eight characters in length. You must specify an EXECKEY of CICS and a Concurrency status of REQUIRED if the PROGRAM uses a JVMSERVER. |
| Language | LANGUAGE | The program language. Options are: ASSEMBLER, C, COBOL, LE370, PLI. Specify LE370 if the program exploits multi-language support, or if the program has been compiled by a Language Environment-conforming compiler. In most cases, you do not need to specify the LANGUAGE attribute, because the CICS program manager deduces the correct language and ignores the value you have specified. If the language is not specified, and CICS cannot deduce it, transactions that attempt to use the program will aband with code ALIG. |
| Name | NAME | The name of the program definition. |
| Reload new copy | RELOAD | Specifies whether a program control link, load, or XCTL request is to bring in a fresh copy of a program.
This attribute does not apply to JVM programs.
|
| Program name in remote system | REMOTENAME | (Optional.) Specifies, if the program resides on a remote system, the name by which the program is known in the remote CICS region. If you specify REMOTESYSTEM and omit REMOTENAME, this attribute defaults to the same name as the local name (that is, the program name on this resource definition). |
| Remote system name | REMOTESYSTEM | (Optional.) If you want CICS to ship a DPL request to another CICS system, specify the system ID of the
remote system. If REMOTENAME is specified then a value must be specified for REMOTESYSTEM. This value must be the name
of the connection definition (CONNDEF or IPCONDEF) for the link to the remote system. CICSPlex SM uses this system ID
only if the program is part of a resource group that is directly associated with a resource description (via RESINDSC).
If the program is being assigned by a resource assignment (RASGNDEF), CICSPlex SM sets the remote system according to the
rules, as follows:
|
| Residence status | RESIDENT | The residence status of the program. This attribute does not apply to JVM programs. |
| Resource security value | RSL | For systems running CICS/MVS 2.1.2, identifies the resource security value to be associated with the program:
|
| Enabled status | STATUS | Indicates whether the module is available for use. CVDA values are:
|
| Mirror transaction name for remote attach | TRANSID | If the program is dynamic, this is the default TRANSID used for the distributed program link (DPL) request. If the program is not dynamic, this specifies the name of the transaction you want the remote CICS to attach, and under which it is to run the remote program. If you do not specify a transaction name on the TRANSID attribute, the remote region executes the DPL program under one of the CICS-supplied default mirror transactions. |
| Program storage release | USAGE | Indicates when the storage for this program should be released:
|
| Use program from the link pack area (LPA) | USELPACOPY | Specifies whether the program is to be used from the link pack area (LPA). This attribute does not apply to
JVM programs.
|
| User data area 1 | USERDATA1 | Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions. |
| User data area 2 | USERDATA2 | Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions. |
| User data area 3 | USERDATA3 | Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions. |