Program definitions - Public: Resource statistics
You can retrieve statistics for public program definitions by using the EXEC CICS EXTRACT STATISTICS PROGRAMDEF system command. They are mapped by the DFHPGDDS DSECT.
Statistics for public program definitions are mapped by the DFHPGDDS DSECT. For private program definitions for applications that are deployed on platforms, these statistics are mapped by the DFHPGEDS DSECT, which has information about the application for which the program was defined. For details of the DSECT and DFHSTUP report for private program definitions, see Program definitions - Private: Resource statistics.
Programs that are defined as application entry points are identified by the PGD_PROGRAM_ENTRYPOINT field. Both public and private statistics records are written for these programs, mapped once by each DSECT.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Program Name | PGD_PROGRAM_NAME | The name of the program. Reset characteristic: not reset
|
| Type | PGD_PROGRAM_TYPE | The type of module. Reset characteristic: not reset
|
| EXEC key | PGD_PROGRAM_EXEC_KEY | The access key in which the program will run. Reset characteristic: not reset
|
| Data loc | PGD_PROGRAM_DATA_LOC | The storage location that the program can
accept. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_EXECUTION_SET | Whether the module is restricted to the distributed
program link subset of the CICS API. EXECUTIONSET applies only to executable programs, and governs
the API only when a program is invoked locally. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_LANG_DEDUCED | The language of the module. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_LANGUAGE | The program language as defined in the LANGUAGE attribute of the
program definition. Reset characteristic: not reset
|
| Runtime | PGD_PROGRAM_RUNTIME_ENV | The runtime environment of the program. Reset characteristic: not reset
|
| Concurrency | PGD_PROGRAM_CONCURRENCY | The concurrency attribute (QUASIRENT, THREADSAFE, or
REQUIRED) of the installed program definition. Reset characteristic: not reset
|
| API | PGD_PROGRAM_API | The API attribute (CICS or OPEN) of the installed
program definition Reset characteristic: not reset
|
| Remote | PGD_PROGRAM_REMOTE | Whether, if the program is the subject of a program-link
request, it can be statically routed. Reset characteristic: not reset
|
| Dynamic | PGD_PROGRAM_DYNAMIC | Whether, if the program is the subject of a program-link
request, it can be dynamically routed. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_JVM | Whether the program is a Java program that must run in a
JVM server. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_ENTRYPOINT | Whether the program is defined as an application entry point for an application
deployed on a platform. Reset characteristic: not reset
|
| Remote Name | PGD_PROGRAM_REMOTE_NAME | For programs only, the name by which the module is known
in the CICS region named in the Remote System field, and only to those defined to be
remote. Reset characteristic: not reset
|
| Remote Tran | PGD_PROGRAM_TRAN_ID | For programs only, the name of the transaction under
which this module, which must be a program, runs remotely; that is, the transaction identifier that
the remote region assigns to the task created there to execute it when a task in the local region
LINKs to it. Reset characteristic: not reset
|
| Remote System | PGD_PROGRAM_REMOTE_SYSID | For programs only, the name of the CICS region in which
the module is defined. It applies only to programs, and only to those defined to be
remote. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_JVMSERVER | For a Java program, the name of the JVM server in which
this Java program runs. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_DEFINE_SOURCE | The source of the resource definition. Its value depends
on the change agent. For more information, see Summary of the resource signature field values. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_CHANGE_TIME | The time stamp (STCK) in local time of CSD record
change. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_CHANGE_USERID | The user ID that ran the CHANGEAGENT. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_CHANGE_AGENT | The agent that made the last change. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_INSTALL_AGENT | The agent that installed the resource. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_INSTALL_TIME | The time stamp (STCK) in local time when the resource
was installed. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGD_PROGRAM_INSTALL_USERID | The user ID that installed the resource. Reset characteristic: not reset
|
The resource statistics fields for the resource signature
The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.