Program definitions - Private: Resource statistics
You can retrieve statistics for private program definitions for applications that are deployed on platforms by using the EXEC CICS EXTRACT STATISTICS PROGRAMDEF system command. They are mapped by the DFHPGEDS DSECT.
Statistics for private program definitions for applications that are deployed on platforms are mapped by the DFHPGEDS DSECT. For public program definitions, these statistics are mapped by the DFHPGDDS DSECT. For details of the DSECT and DFHSTUP report for public program definitions, see Program definitions - Public: Resource statistics.
Programs that are defined as application entry points are identified by an application operation being named in the PGE_PROGRAM_OPERATION_NAME field. Both public and private statistics records are written for these programs, mapped once by each DSECT.
The DFHSTUP report shows the private programs for each application that is deployed on a platform. For programs that are declared as application entry points, the report shows the application operation that is named for the application entry point.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Platform | PGE_PROGRAM_PLATFORM_NAME | The name of the platform where the application that uses
the private programs is deployed. Reset characteristic: not reset
|
| Application | PGE_PROGRAM_APPLICATION_NAME | The name of the application that uses the private
programs. Reset characteristic: not reset
|
| Major version | PGE_PROGRAM_APPL_MAJOR_VER | The major version number of the application that uses the
private programs. Reset characteristic: not reset
|
| Minor version | PGE_PROGRAM_APPL_MINOR_VER | The minor version number of the application that uses the
private programs. Reset characteristic: not reset
|
| Micro version | PGE_PROGRAM_APPL_MICRO_VER | The micro version number of the application that uses the
private programs. Reset characteristic: not reset
|
| Program Name | PGE_PROGRAM_NAME | The name of the private program. Reset characteristic: not reset
|
| Type | PGE_PROGRAM_MODULE_TYPE | The type of module. Reset characteristic: not reset
|
| EXEC key | PGE_PROGRAM_EXEC_KEY | The access key in which the program will run. Reset characteristic: not reset
|
| Data loc | PGE_PROGRAM_DATA_LOC | The storage location that the program can
accept. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_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
|
| Language Deduced | PGE_PROGRAM_LANG_DEDUCED | The language of the module. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_PROGRAM_LANGUAGE | The program language as defined in the LANGUAGE attribute of the
program definition. Reset characteristic: not reset
|
| Runtime | PGE_PROGRAM_RUNTIME_ENV | The runtime environment of the program. Reset characteristic: not reset
|
| Concurrency | PGE_PROGRAM_CONCURRENCY | The concurrency attribute (QUASIRENT, THREADSAFE, or
REQUIRED) of the installed program definition. Reset characteristic: not reset
|
| API | PGE_PROGRAM_API | The API attribute (CICS or OPEN) of the installed
program definition Reset characteristic: not reset
|
| Remote | PGE_PROGRAM_REMOTE | Whether, if the program is the subject of a program-link
request, it can be statically routed. Reset characteristic: not reset
|
| Dynamic | PGE_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 | PGE_PROGRAM_JVM | Whether the program is a Java program that must run in a
JVM server. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_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 | PGE_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 | PGE_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 | PGE_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 | PGE_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 | PGE_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 | PGE_PROGRAM_CHANGE_TIME | The time stamp (STCK) in local time of CSD record
change. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_PROGRAM_CHANGE_USERID | The user ID that ran the CHANGEAGENT. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_PROGRAM_CHANGE_AGENT | The agent that made the last change. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_PROGRAM_INSTALL_AGENT | The agent that installed the resource. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_PROGRAM_INSTALL_TIME | The time stamp (STCK) in local time when the resource
was installed. Reset characteristic: not reset
|
| Not in DFHSTUP report | PGE_PROGRAM_INSTALL_USERID | The user ID that installed the resource. Reset characteristic: not reset
|
| Operation | PGE_PROGRAM_OPERATION_NAME | For programs that are declared as application entry
points, the application operation that is named for the application entry point. 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.