MAPDEF Resource Table

A CICS® Definition that describes a map set, which is a group of related screen layouts or maps.

The Primary key field for this resource class is NAME.

The Secondary key field for this resource class is DEFVER.

The Tertiary key field for this resource class is CSDGROUP.

The following actions are supported:
INSTALL
Install a Map Set Definition.

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

External resource name
CICSDefinitionMapSet
Length
168
Usage
API or Batch Utility or WUI or CICS Management Client Interface
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICS Definition
Copybook identifier
EYUt3805
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   CICSSYS(value) No
    CSDGROUP(value) No
    RESGROUP(value) No
CREATE   CSD No
    RESGROUP(value) No
UPDATE   CSD No
REMOVE   CSD No
PERFORM SET 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
  ADDTOGRP RESGROUP(value) Yes
  CSDINSTALL None N/A
  CSDCOPY AS_RESOURCE(value) No
    DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) No
    TO_CSDGROUP(value) No
Table 2. MAPDEF FEEDBACK error codes
Value Code Description
1 MAPDEF_INV_DATA Attribute data invalid
2 MAPDEF_REC_NOT_FOUND Requested resource not found
4 MAPDEF_REC_EXISTS Resource already exists
5 MAPDEF_REC_CHANGED Resource definition already changed
6 MAPDEF_INV_RESTYPE Invalid resource type
7 MAPDEF_INV_VER Invalid resource version
11 MAPDEF_NON_MP Maintenance point CMAS not available
12 MAPDEF_INV_CONTEXT Context not found
13 MAPDEF_INCONSISTENT_SET Inconsistent set condition
14 MAPDEF_INV_RESGROUP Resource group not found
21 MAPDEF_INV_ACTION Invalid action
22 MAPDEF_INV_RECADDR Invalid record address
23 MAPDEF_INV_RECLEN Invalid record length
24 MAPDEF_DIFF_VERSION Different version
25 MAPDEF_EARLY_NAMELIST_END Early name list end
26 MAPDEF_INV_NAMELIST Invalid name list
27 MAPDEF_INV_NAME Invalid name
28 MAPDEF_INV_MINNAME Invalid minor name
29 MAPDEF_NOTIFY Notify
30 MAPDEF_PARTIAL_INSTALL Partial install
31 MAPDEF_NOTHING_INSTALLED Nothing installed
32 MAPDEF_NO_TARGETS No targets
33 MAPDEF_NO_RELATED No related systems
34 MAPDEF_INV_TSCOPE Invalid target scope
35 MAPDEF_INV_RSCOPE Invalid related scope
36 MAPDEF_INV_USAGE Invalid usage
37 MAPDEF_INV_MODE Invalid mode
38 MAPDEF_INV_STATECHK Invalid state check
39 MAPDEF_INV_FORCEINS Invalid force install
40 MAPDEF_INV_NOTIFY Invalid notify
41 MAPDEF_INV_OVERTYPE Invalid over type
42 MAPDEF_INV_OVRBLOCK Invalid override block
43 MAPDEF_INV_ORSTRING Invalid override string
44 MAPDEF_INV_STRNGTERM Invalid string terminator
45 MAPDEF_INV_EMBEDTERM Invalid embedded terminator
46 MAPDEF_INV_ATTRIBUTE Invalid attribute
47 MAPDEF_INV_LITERAL Invalid literal
48 MAPDEF_INV_ORSTGNA Invalid override string
49 MAPDEF_SCOPE_REQUIRED Scope required
50 MAPDEF_USAGE_CONFLICT Usage conflict
51 MAPDEF_NODEFS_SELECTED No definitions selected
52 MAPDEF_MORE_THAN_1_RELSYS More than one related system
53 MAPDEF_MISSING_RELSYSID Missing related system identifier
54 MAPDEF_SCOPE_CONFLICT Scope conflict
55 MAPDEF_INV_CSDGROUP Invalid CSD group
56 MAPDEF_REC_NOT_REMOVED Record not removed
57 MAPDEF_INV_RESOURCE Invalid resource
58 MAPDEF_INV_CICS_RESTYPE Invalid CICS restype
59 MAPDEF_PARTIAL_ACTION Partial action
60 MAPDEF_NOTHING_ACTIONED Nothing actioned
61 MAPDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62 MAPDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
63 MAPDEF_CSD_ERROR CSD access error
Table 3. MAPDEF resource table attributes
Name Datatype Source Len Req Sum Set Description Default Value Range Get Invalid Attr ID
CHANGEAGENT CVDAS CPSM 4 No LIKE No Last modification agent     E640 E650 19
CHANGEAGENT Input/output valid values DREPAPI
CHANGEAGREL CHAR CPSM 4 No DIFF No Last modification agent release     E640 E650 21
CHANGETIME DATETIME CPSM 8 Yes MAX No Last modification time       1
CHANGEUSRID CHAR CPSM 8 No DIFF No Last modification user ID     E640 E650 20
CREATETIME DATETIME CPSM 8 Yes MAX No Time created       13
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF Yes CSD group     E640 E650 23
 DEFVER-2  BINARY CPSM 1 Yes AVG Yes Version 0 0-15   5
DESCCODEPAGE BINARY CPSM 4 No DIFF No Description code page 37 0-99999999   18
DESCRIPTION CHAR CPSM 58 No DIFF No Description       17
 NAME-1  CHAR CPSM 8 Yes DIFF Yes Name       7
RESIDENT EYUDA CPSM 4 Yes LIKE No Residence status NO     8
RESIDENT Input/output valid values YES, NO
RSL CHAR CPSM 8 No DIFF No Resource security value 0 0-24 E330+ 12
RSL Input/output valid values PUBLIC
STATUS CVDAS CPSM 4 Yes LIKE No Map set status ENABLED     9
STATUS Input/output valid values ENABLED, DISABLED
USAGE EYUDA CPSM 4 Yes LIKE No Map set storage release NORMAL     10
USAGE Input/output valid values NORMAL, TRANSIENT
USELPACOPY EYUDA CPSM 4 Yes LIKE No Use map set from link pack area (LPA) option NO     11
USELPACOPY Input/output valid values YES, NO
USERDATA1 CHAR CPSM 8 No DIFF No User data area 1       14
USERDATA2 CHAR CPSM 8 No DIFF No User data area 2       15
USERDATA3 CHAR CPSM 8 No DIFF No User data area 3       16


MAPDEFtab.html | Timestamp icon Last updated: Thursday, 27 June 2019