PROGDEF Resource Table

A CICS® Definition that describes the control information for a program stored in the program library.

The First key field for this resource is NAME.

The Second key field for this resource is DEFVER.

The Third key field for this resource is CSDGROUP.

The following actions are supported:
ADDTOGRP
Add to resource group
The parameter data for the ADDTOGRP action is: 
   PARM('RESGROUP(resgroup).')

     where:

     resgroup = The name of a RESGROUP definition.
CSDCOPY
Copy the CICS CSD resource definition in a CSD group into an different CSD group.
The parameter data for the CSDCOPY action is described in Managing CICS definitions in the CSD.
CSDINSTALL
Install the CICS CSD resource definition in a CSD group into an active system.
The parameter data for the CSDINSTALL action is described in Managing CICS definitions in the CSD.
INSTALL
Install a Program Definition.

The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.

External resource name(CMCI)
CICSDefinitionProgram
Object type
CICS Definition
Length
504
Usage
API, Batch Utility, WUI, CICS Management Client Interface(CMCI)
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Copybook identifier
EYUt3809
Security Class
OPERATE.PROGRAM
CICS Commands subject to CICS Security
INQUIRE PROGRAM
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
CREATE   CSD No
    RESGROUP(value) No
GET   CICSGRP(value) No
    CICSSYS(value) No
    CSDGROUP(value) No
    RESGROUP(value) No
REMOVE   CSD No
UPDATE   CSD No
PERFORM SET, PERFORM OBJECT ADDTOGRP RESGROUP(value) Yes
  CSDCOPY AS_RESOURCE(value) No
    DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) No
    TO_CSDGROUP(value) No
  CSDINSTALL None N/A
  INSTALL FORCEINS(YES, NO) No
    MODE(AUTO) No
    NOTIFY(NO, INACTIVE, RELEASE, FULL) No
    OVERRIDE No
    OVERTYPE(TARGET, RELATED, BOTH, NONE) No
    RELATED(value) No
    STATECHK(YES, NO) No
    TARGET(value) Yes
    USAGE(LOCAL, REMOTE) Yes
Table 2. PROGDEF FEEDBACK error codes
Value Code Description
1 PROGDEF_INV_DATA Attribute data invalid
2 PROGDEF_REC_NOT_FOUND Requested resource not found
4 PROGDEF_REC_EXISTS Resource already exists
5 PROGDEF_REC_CHANGED Resource definition already changed
6 PROGDEF_INV_RESTYPE Invalid resource type
7 PROGDEF_INV_VER Invalid resource version
11 PROGDEF_NON_MP Maintenance point CMAS not available
12 PROGDEF_INV_CONTEXT Context not found
13 PROGDEF_INCONSISTENT_SET Inconsistent set condition
14 PROGDEF_INV_RESGROUP Resource group not found
21 PROGDEF_INV_ACTION Invalid action
22 PROGDEF_INV_RECADDR Invalid record address
23 PROGDEF_INV_RECLEN Invalid record length
24 PROGDEF_DIFF_VERSION Different version
25 PROGDEF_EARLY_NAMELIST_END Early name list end
26 PROGDEF_INV_NAMELIST Invalid name list
27 PROGDEF_INV_NAME Invalid name
28 PROGDEF_INV_MINNAME Invalid minor name
29 PROGDEF_NOTIFY Notify
30 PROGDEF_PARTIAL_INSTALL Partial install
31 PROGDEF_NOTHING_INSTALLED Nothing installed
32 PROGDEF_NO_TARGETS No targets
33 PROGDEF_NO_RELATED No related systems
34 PROGDEF_INV_TSCOPE Invalid target scope
35 PROGDEF_INV_RSCOPE Invalid related scope
36 PROGDEF_INV_USAGE Invalid usage
37 PROGDEF_INV_MODE Invalid mode
38 PROGDEF_INV_STATECHK Invalid state check
39 PROGDEF_INV_FORCEINS Invalid force install
40 PROGDEF_INV_NOTIFY Invalid notify
41 PROGDEF_INV_OVERTYPE Invalid overtype
42 PROGDEF_INV_OVRBLOCK Invalid override block
43 PROGDEF_INV_ORSTRING Invalid override string
44 PROGDEF_INV_STRNGTERM Invalid string term
45 PROGDEF_INV_EMBEDTERM Invalid embedded terminator
46 PROGDEF_INV_ATTRIBUTE Invalid attribute
47 PROGDEF_INV_LITERAL Invalid literal
48 PROGDEF_INV_ORSTGNA Invalid override string
49 PROGDEF_SCOPE_REQUIRED Scope required
50 PROGDEF_USAGE_CONFLICT Usage conflict
51 PROGDEF_NODEFS_SELECTED No definitions selected
52 PROGDEF_MORE_THAN_1_RELSYS More than one related system
53 PROGDEF_MISSING_RELSYSID Missing related system identifier
54 PROGDEF_SCOPE_CONFLICT Scope conflict
55 PROGDEF_INV_CSDGROUP Invalid CSD group
56 PROGDEF_REC_NOT_REMOVED Record not removed
57 PROGDEF_INV_RESOURCE Invalid resource
58 PROGDEF_INV_CICS_RESTYPE Invalid CICS restype
59 PROGDEF_PARTIAL_ACTION Partial action
60 PROGDEF_NOTHING_ACTIONED Nothing actioned
61 PROGDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62 PROGDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
63 PROGDEF_CSD_ERROR CSD access error
64 PROGDEF_JVM_CONFLICT JVMSERVER conflicts with JVMPROFILE
65 PROGDEF_JVM_MISSING Either JVMSERVER or JVMPROFILE is required
Table 3. PROGDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Get Invalid Offset
 NAME-1  CHAR CPSM 8 Yes DIFF Name       25
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15   24
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group       484
API EYUDA CPSM 4 Yes LIKE Application program interfaces CICSAPI     476
API Input/output valid values
  • CICSAPI
  • OPENAPI
CEDF EYUDA CPSM 4 Yes LIKE Display execution diagnostic facility (EDF) screens YES     36
CEDF Input/output valid values
  • YES
  • NO
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent       8
CHANGEAGENT Input/output valid values
  • CSDAPI
  • CSDBATCH
  • DREPAPI
  • N_A
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release       20
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification       0
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID       12
CONCURRENCY EYUDA CPSM 4 Yes LIKE Concurrency status QUASIRENT     200
CONCURRENCY Input/output valid values
  • N_A
  • QUASIRENT
  • THREADSAFE
  • REQUIRED
CREATETIME DATETIME CPSM 8 Yes MAX Time created       104
DATALOCATION CVDAS CPSM 4 Yes LIKE Data location ANY     40
DATALOCATION Input/output valid values
  • BELOW
  • ANY
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999   480
DESCRIPTION CHAR CPSM 58 No DIFF Description       136
DYNAMIC EYUDA CPSM 4 Yes LIKE Dynamic routing status NO     196
DYNAMIC Input/output valid values
  • YES
  • NO
EXECKEY CVDAS CPSM 4 Yes LIKE Program execution key USER     44
EXECKEY Input/output valid values
  • USER
  • CICS
EXECUTIONSET CVDAS CPSM 4 Yes LIKE API subset restriction type FULLAPI     48
EXECUTIONSET Input/output valid values
  • FULLAPI
  • DPLSUBSET
HOTPOOL EYUDA CPSM 4 Yes LIKE Hot pooling status NO   E640+ 464
HOTPOOL Input/output valid values
  • YES
  • NO
JVM EYUDA CPSM 4 Yes LIKE Java virtual machine (JVM) mode NO     204
JVM Input/output valid values
  • YES
  • NO
  • DEBUG
JVMCLASS CHAR CPSM 255 No DIFF Java virtual machine (JVM) class       208
JVMPROFILE CHAR CPSM 8 No DIFF Java virtual machine (JVM) profile     E680+ 468
JVMSERVER CHAR CPSM 8 No DIFF Java virtual machine (JVM) server       492
LANGUAGE EYUDA CPSM 4 Yes LIKE Language N_A     52
LANGUAGE Input/output valid values
  • ASSEMBLER
  • C
  • COBOL
  • LE370
  • LEVSE
  • PLI
  • RPG
  • N_A
RELOAD EYUDA CPSM 4 Yes LIKE Reload new copy NO     56
RELOAD Input/output valid values
  • YES
  • NO
REMOTENAME CHAR CPSM 8 No DIFF Program name in remote system       76
REMOTESYSTEM CHAR CPSM 4 No DIFF Remote system name       84
RESIDENT EYUDA CPSM 4 Yes LIKE Residence status NO     72
RESIDENT Input/output valid values
  • YES
  • NO
RSL CHAR CPSM 8 No DIFF Resource security value 0 0-24 E330+ 92
RSL Input/output valid values
  • PUBLIC
STATUS CVDAS CPSM 4 Yes LIKE Enabled status ENABLED     60
STATUS Input/output valid values
  • ENABLED
  • DISABLED
TRANSID CHAR CPSM 4 No DIFF Mirror transaction name for remote attach       88
USAGE EYUDA CPSM 4 Yes LIKE Program storage release NORMAL     68
USAGE Input/output valid values
  • NORMAL
  • TRANSIENT
USELPACOPY EYUDA CPSM 4 Yes LIKE Use program from the link pack area (LPA) NO     64
USELPACOPY Input/output valid values
  • YES
  • NO
USERDATA1 CHAR CPSM 8 No DIFF User data area 1       112
USERDATA2 CHAR CPSM 8 No DIFF User data area 2       120
USERDATA3 CHAR CPSM 8 No DIFF User data area 3       128