LIBDEF Resource Table

A CICS® Definition that describes a dynamic LIBRARY

The First key fields for this resource table are 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 LIBRARY definition.

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

External resource name(CMCI)
CICSDefinitionLIBRARY
Object type
CICS Definition
Length
856
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
EYUt3837
CICS Commands subject to CICS Security
INQUIRE LIBRARY
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(value) 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) Yes
Table 2. LIBDEF FEEDBACK error codes
Value Code Description
1 LIBDEF_INV_DATA Attribute data invalid
2 LIBDEF_REC_NOT_FOUND Requested resource not found
4 LIBDEF_REC_EXISTS Resource already exists
5 LIBDEF_REC_CHANGED Resource definition already changed
6 LIBDEF_INV_RESTYPE Invalid resource type
7 LIBDEF_INV_VER Invalid resource version
11 LIBDEF_NON_MP Maintenance point CMAS not available
12 LIBDEF_INV_CONTEXT Context not found
13 LIBDEF_INCONSISTENT_SET Inconsistent set condition
14 LIBDEF_INV_RESGROUP Resource group not found
21 LIBDEF_INV_ACTION Invalid action
22 LIBDEF_INV_RECADDR Invalid record address
23 LIBDEF_INV_RECLEN Invalid record length
24 LIBDEF_DIFF_VERSION Different version
25 LIBDEF_EARLY_NAMELIST_END Early name list end
26 LIBDEF_INV_NAMELIST Invalid name list
27 LIBDEF_INV_NAME Invalid name
28 LIBDEF_INV_MINNAME Invalid minor name
29 LIBDEF_NOTIFY Notify
30 LIBDEF_PARTIAL_INSTALL Partial install
31 LIBDEF_NOTHING_INSTALLED Nothing installed
32 LIBDEF_NO_TARGETS No targets
33 LIBDEF_NO_RELATED No related systems
34 LIBDEF_INV_TSCOPE Invalid target scope
35 LIBDEF_INV_RSCOPE Invalid related scope
36 LIBDEF_INV_USAGE Invalid usage
37 LIBDEF_INV_MODE Invalid mode
38 LIBDEF_INV_STATECHK Invalid state check
39 LIBDEF_INV_FORCEINS Invalid force install
40 LIBDEF_INV_NOTIFY Invalid notify
41 LIBDEF_INV_OVERTYPE Invalid over type
42 LIBDEF_INV_OVRBLOCK Invalid override block
43 LIBDEF_INV_ORSTRING Invalid override string
44 LIBDEF_INV_STRNGTERM Invalid string term
45 LIBDEF_INV_EMBEDTERM Invalid embedded terminator
46 LIBDEF_INV_ATTRIBUTE Invalid attribute
47 LIBDEF_INV_LITERAL Invalid literal
48 LIBDEF_INV_ORSTGNA Invalid override string
49 LIBDEF_SCOPE_REQUIRED Scope required
50 LIBDEF_USAGE_CONFLICT Usage conflict
51 LIBDEF_NODEFS_SELECTED No definitions selected
52 LIBDEF_MORE_THAN_1_RELSYS More than one related system
53 LIBDEF_MISSING_RELSYSID Missing related system identifier
54 LIBDEF_SCOPE_CONFLICT Scope conflict
55 LIBDEF_INV_CSDGROUP Invalid CSD group
56 LIBDEF_REC_NOT_REMOVED Record not removed
57 LIBDEF_INV_RESOURCE Invalid resource
58 LIBDEF_INV_CICS_RESTYPE Invalid CICS restype
59 LIBDEF_PARTIAL_ACTION Partial action
60 LIBDEF_NOTHING_ACTIONED Nothing actioned
61 LIBDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62 LIBDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
63 LIBDEF_CSD_ERROR CSD access error
Table 3. LIBDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Offset GraphQL Field
 NAME-1  CHAR CPSM 8 Yes DIFF Name     25 name
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15 24 version
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group     848 CSDGroup
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     8 changeAgent
CHANGEAGENT Input/output valid values
  • CSDAPI
  • CSDBATCH
  • DREPAPI
  • N_A
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     20 changeAgentRelease
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time     0 changeTime
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     12 changeUserID
CREATETIME DATETIME CPSM 8 Yes MAX Time created     752 createTime
CRITICAL EYUDA CPSM 4 Yes LIKE Critical status NO   36 critical
CRITICAL Input/output valid values
  • YES
  • NO
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 844 desccodepage
DESCRIPTION CHAR CPSM 58 No DIFF Description     784 description
DSNAME01 CHAR CPSM 44 No DIFF Data set name 01     46 dsname01
DSNAME02 CHAR CPSM 44 No DIFF Data set name 02     90 dsname02
DSNAME03 CHAR CPSM 44 No DIFF Data set name 03     134 dsname03
DSNAME04 CHAR CPSM 44 No DIFF Data set name 04     178 dsname04
DSNAME05 CHAR CPSM 44 No DIFF Data set name 05     222 dsname05
DSNAME06 CHAR CPSM 44 No DIFF Data set name 06     266 dsname06
DSNAME07 CHAR CPSM 44 No DIFF Data set name 07     310 dsname07
DSNAME08 CHAR CPSM 44 No DIFF Data set name 08     354 dsname08
DSNAME09 CHAR CPSM 44 No DIFF Data set name 09     398 dsname09
DSNAME10 CHAR CPSM 44 No DIFF Data set name 10     442 dsname10
DSNAME11 CHAR CPSM 44 No DIFF Data set name 11     486 dsname11
DSNAME12 CHAR CPSM 44 No DIFF Data set name 12     530 dsname12
DSNAME13 CHAR CPSM 44 No DIFF Data set name 13     574 dsname13
DSNAME14 CHAR CPSM 44 No DIFF Data set name 14     618 dsname14
DSNAME15 CHAR CPSM 44 No DIFF Data set name 15     662 dsname15
DSNAME16 CHAR CPSM 44 No DIFF Data set name 16     706 dsname16
RANKING CHAR CPSM 2 Yes MIN Ranking 50 1-99 44 ranking
STATUS EYUDA CPSM 4 Yes LIKE Enabled status ENABLED   40 status
STATUS Input/output valid values
  • ENABLED
  • DISABLED
USERDATA1 CHAR CPSM 8 No DIFF User data area 1     760 userdata1
USERDATA2 CHAR CPSM 8 No DIFF User data area 2     768 userdata2
USERDATA3 CHAR CPSM 8 No DIFF User data area 3     776 userdata3