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.
PHASEIN
Phase in a new copy of the program.

These actions require no unique parameter data.

Notes:
  1. Start of change In a CICS TS environment 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.End of change
  2. In a CICS/VSE environment, the attribute values for:
    • LPASTAT(SVA)
    • LPASTAT(NOTSVA)
    do not match the CVDA values returned by CICS. The values returned by CICS conflict with CVDA values in other CICS environments. In order to retain the attributes' uniqueness, CICSPlex SM adds 9000 to the values returned by CICS.
Note:
Length
464
Usage
API or EVALDEF
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Object type
CICS Resource
Copybook identifier
EYUt0017 or PROGRAM
Valid API operations
GET SET and PERFORM

API Actions

DISABLE
Disable

Parameters: None

DISCARD
Discard

Parameters: None

ENABLE
Enable

Parameters: None

NEWCOPY
New copy

Parameters: None

PHASEIN
Phase in

Parameters: None

Table 381. PROGRAM resource table attributes
Name Datatype Source Len Sum Set Description Get Invalid Set Invalid Attr ID
EYU_CICSNAME CHAR CPSM 8 N/A CICS System Name
EYU_CICSREL CHAR CPSM 4 N/A CICS Release
EYU_RESERVED CHAR CPSM 4 N/A Reserved
 PROGRAM-1  CHAR INQ 8 DIF Program name 1
LANGUAGE CVDAS INQ 4 LIKE Language 2
LANGUAGE Output Valid Values COBOL C LE370 PLIPL1 ASSEMBLER NOTDEFINED NOTAPPLIC LEVSE
NEWCOPYCNT BINARY STAT 4 AVG Number of NEWCOPY requests issued 3
USECOUNT CODEDBIN INQ 4 N/A Total number of times program was executed 4
USEAGELSTAT BINARY STAT 4 AVG Number of times program was used since last reset 5
RESCOUNT CODEDBIN INQ 4 N/A Number of times program currently accessed 6
FETCHCNT BINARY STAT 4 AVG Number of times program loaded into storage 7
STATUS CVDAS INQ 4 LIKE yes Enabled status 8
STATUS Input/Output Valid Values ENABLED DISABLED
HOLDSTATUS CVDAS INQ 4 LIKE Hold status 9
HOLDSTATUS Output Valid Values HOLD NOHOLD NOTAPPLIC
SHARESTATUS CVDAS INQ 4 LIKE yes Share status 10
SHARESTATUS Input/Output Valid Values PRIVATE SHARED
SHARESTATUS Output Valid Values NOTAPPLIC
LENGTH CODEDBIN INQ 4 MAX Program length 11
RPLID BINARY STAT 4 AVG RPL data set number 12
LPASTAT CVDAS INQ 4 LIKE Link pack area (LPA) status 13
LPASTAT Output Valid Values LPA NOTLPA NOTAPPLIC SVA NOTSVA
CEDFSTATUS CVDAS INQ 4 LIKE yes CEDF status 14
CEDFSTATUS Input/Output Valid Values CEDF NOCEDF
CEDFSTATUS Output Valid Values NOTAPPLIC
PROGTYPE CVDAS INQ 4 LIKE Program type 15
PROGTYPE Output Valid Values PROGRAM MAP PARTITIONSET
DATALOCATION CVDAS INQ 4 LIKE Data location 16
DATALOCATION Output Valid Values BELOW ANY NOTAPPLIC
FETCHTIME INT16US STAT 4 MAX Total time for all program fetches 17
REMOVECNT BINARY STAT 4 AVG Number of times removed by program compression 18
EXECKEY CVDAS INQ 4 LIKE Program execution key 19
EXECKEY Output Valid Values CICSEXECKEY USEREXECKEY NOTAPPLIC
EXECUTIONSET CVDAS INQ 4 LIKE yes API subset restriction type 20
EXECUTIONSET Input/Output Valid Values DPLSUBSET FULLAPI
EXECUTIONSET Output Valid Values NOTAPPLIC
ENTRYPOINT ADDRESS INQ 4 MAX Program entry point 21
LOADPOINT ADDRESS INQ 4 MAX Program load point 22
COBOLTYPE CVDAS INQ 4 LIKE COBOL type 23
COBOLTYPE Output Valid Values COBOL COBOLII NOTINIT NOTAPPLIC
REMOTENAME CHAR INQ 8 DIF Program name in remote system 24
REMOTESYSTEM CHAR INQ 4 DIF Remote system name 25
TRANSID CHAR INQ 4 DIF Mirror transaction name for remote attach 26
CURRENTLOC EYUDA STAT 4 LIKE CICS DSA in which current copy is located 27
CURRENTLOC Output Valid Values NOCOPY DSA CDSA UDSA LPA EDSA ECDSA EUDSA ERDSA ELPA ESDSA RDSA SDSA
COPY CVDAS INQ 4 LIKE yes New-copy-required status 28
COPY Input Valid Values NEWCOPY PHASEIN
COPY Output Valid Values REQUIRED NOTREQUIRED
DYNAMSTATUS CVDAS INQ 4 LIKE Dynamic routing type 29
DYNAMSTATUS Output Valid Values DYNAMIC NOTDYNAMIC
CONCURRENCY CVDAS INQ 4 LIKE Threadsafe option 30
CONCURRENCY Output Valid Values THREADSAFE QUASIRENT
RUNTIME CVDAS INQ 4 LIKE yes Runtime environment information 31
RUNTIME Input/Output Valid Values JVM
RUNTIME Input Valid Values NOJVM
RUNTIME Output Valid Values UNKNOWN LE370 NONLE370 NOTAPPLIC XPLINK
JVMDEBUG CVDAS INQ 4 LIKE yes Java virtual machine (JVM) debug status 32
JVMDEBUG Input/Output Valid Values DEBUG NODEBUG
JVMCLASS CHAR INQ 255 DIF yes Java virtual machine class 33
HOTPOOLING CVDAS INQ 4 LIKE yes Hot pooling status E640 and higher E640 and higher 35
HOTPOOLING Input/Output Valid Values HOTPOOL NOTHOTPOOL
HOTPOOLING Output Valid Values NOTAPPLIC
JVMPROFILE CHAR INQ 8 DIF yes Java virtual machine (JVM) profile name E530 E530 and E620 36
ALOADTIME INT16US CPSM 4 AVG Average load time 37
USEFETCH AVERAGE3 CPSM 8 AVG Average number of program uses per fetch 38
RLOADING RATE3 CPSM 8 AVG Rate of program loading 39
RREMOVAL RATE3 CPSM 8 AVG Rate of program removal 40
RUSE RATE3 CPSM 8 AVG Rate of program use 41
PGRJUSECOUNT BINARY STAT 4 AVG Number of times JVM program used since last reset E530 and E620 44
APIST CVDAS INQ 4 LIKE API status E530, E620 and E630 45
APIST Output Valid Values CICSAPI OPENAPI
[[ Contents Previous Page | Next Page Index ]]