PLATDEF Resource Table

This CICS resource object provides information about platform definitions.

The Primary key field for this resource class is NAME.

The following actions are supported:
INSTALL
Deploy a PLATDEF resource into the CICSplex.

External resource name
CICSPlatformDefinition
Length
368
Usage
API or Batch Utility or CICS Management Client Interface
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICSPlex SM Definition
Copybook identifier
EYUt3527
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
CREATE   None N/A
REMOVE   None N/A
PERFORM SET INSTALL None N/A
Table 2. PLATDEF FEEDBACK error codes
Value Code Description
1 PLATDEF_DATA_INVALID Attribute data invalid
2 PLATDEF_REC_NOT_FOUND Platform definition not found
3 PLATDEF_CICSPLEX_MATCHES_NAME PLATDEF name matches an existing CICSplex
4 PLATDEF_REC_EXISTS Platform definition already exists
5 PLATDEF_CSYSGRP_MATCHES_NAME PLATDEF name matches an existing system group
6 PLATDEF_CSYSDEF_MATCHES_NAME PLATDEF name matches an existing system definition
7 PLATDEF_PLATFORM_INSTALLED Platform is already installed
8 PLATDEF_BUNDLE_FILE_NOT_AUTH User ID not authorized to access zFS file
9 PLATDEF_NOT_FOUND_BUNDLE_FILE Platform bundle file not found
10 PLATDEF_XML_IN_BUNDLE_INVALID Invalid XML in bundle
12 PLATDEF_CSYSGRP_NOT_FOUND System group named in platform bundle not found
13 PLATDEF_CSYSGRP_IN_USE System group named in platform bundle is in use
15 PLATDEF_PLATFORM_INVALID The specified platform is invalid
16 PLATDEF_PLATHOME_INVALID The specified platform home is invalid
17 PLATDEF_RGNTYPE_ID_INVALID A region type ID used in the platform is invalid
18 PLATDEF_RGNTYPE_NAME_INVALID A region type name used in the platform is invalid
19 PLATDEF_DUPLICATE_RGNTYPE The platform contains a duplicate region type name
20 PLATDEF_RGNTYPE_HAS_SUBGROUPS A region type used in the platform has subgroups
21 PLATDEF_INSTALLED_SOME_BUNDLES CICS bundles were not installed in some regions
22 PLATDEF_INSTALLED_NO_BUNDLES CICS bundles were not installed in any regions
23 PLATDEF_DUPLICATE_RGNTYPE_ID Platform references a duplicate region type ID
24 PLATDEF_DUPLICATE_REGION A duplicate CICS region exists and cannot be used
25 PLATDEF_REGION_MATCHES_GROUP VTAM APPLID matches an existing group definition
26 PLATDEF_BUNDLE_INVALID_VERSION Invalid version of Platform bundle.
27 PLATDEF_INSTALL_FAILED PLATDEF install failed.
28 PLATDEF_PLATFORM_BUSY Platform is busy for another action.
29 PLATDEF_PLATDIR_INVALID Platform directory does not reside in a sub directory named platform, within the platform home directory.
30 PLATDEF_RLINK_DUPLICATE Duplicate regionLink.
31 PLATDEF_REGIONTYPE_UNEXPECTED Region type defined in regionTypes.xml not defined in platform.xml.
32 PLATDEF_REGIONTYPE_MISSING Missing regionType.
33 PLATDEF_REGION_FIELD_INVALID Region attribute specifies an unrecognised value.
34 PLATDEF_INCOMPATIBLE_MODEL A region type model for region type contains an incompatible attribute value.
35 PLATDEF_NOLINK_CREATED_RTYPE No region type links were found for created region type.
36 PLATDEF_LINK_FOR_ADOPTED_RTYPE A region type link was found for an adopted region type.
37 PLATDEF_SHARED_RGN_NOT_CREATED A region could not be shared to created region.
38 PLATDEF_NO_RTYPE_FND_FOR_LINK A region type link specifies unknown region type.
39 PLATDEF_NO_REGION_FND_FOR_LINK A region type link specifies unknown region.
40 PLATDEF_INVALID_MODEL_ATTR A region type model attribute is invalid.
41 PLATDEF_NOLINK_CREATED_RGN No region types link for a created region
42 PLATDEF_CREATED_RTYPE_EXISTS System group for a created region type already exists.
43 PLATDEF_CREATED_REGION_ACTIVE Created region already active.
44 PLATDEF_NO_RTYPE_FOR_BINDING No region type for binding.
45 PLATDEF_RGNTYPE_HAS_CREATEDRGN A platform created region was found in an adopted region type.
Table 3. PLATDEF resource table attributes
Name Datatype Source Len Req Sum Set Description Default Attr ID
CHANGEAGENT CVDAS CPSM 4 No LIKE No Last modification agent   4
CHANGEAGREL CHAR CPSM 4 No DIFF No Last modification agent release   7
CHANGETIME DATETIME CPSM 8 Yes MAX No Last modification   1
CHANGEUSRID CHAR CPSM 8 No DIFF No Last modification user ID   6
CREATETIME DATETIME CPSM 8 Yes MAX No Time created   5
DESCCODEPAGE BINARY CPSM 4 No MAX Yes Description code page 37 12
DESCRIPTION CHAR CPSM 58 No DIFF Yes Description   11
 NAME-1  CHAR CPSM 8 Yes DIFF Yes Platform definition   10
PLATDIR CHAR CPSM 255 Yes DIFF Yes Platform bundle directory.   13