PLATDEF Resource Table
This CICS® Resource object provides information about platform definitions.
The First key field for this resource is NAME.
The following action is supported:
- INSTALL
- Deploy a PLATDEF resource into the CICSplex.
- External resource name(CMCI)
- CICSPlatformDefinition
- Object type
- CICSPlex SM Definition
- Length
- 368
- Usage
- API, Batch Utility, CICS Management Client Interface(CMCI)
- API view
- No
- CMAS context
- No
- SCOPE applies
- No
- Only query CMASs in workload
- No
- Copybook identifier
- EYUt3527
- Security Class
- CLOUD.DEF
- Unsupported CICS Releases
- None
| Operations | Actions | Parameters | Required |
|---|---|---|---|
| CREATE | None | N/A | |
| GET | None | N/A | |
| REMOVE | None | N/A | |
| PERFORM SET, PERFORM OBJECT | INSTALL | None | N/A |
| 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. |
| Name | Datatype | Source | Len | Req | Sum | Description | Default | Offset |
|---|---|---|---|---|---|---|---|---|
| NAME-1 | CHAR | CPSM | 8 | Yes | DIFF | Platform definition | 36 | |
| CHANGEAGENT | CVDAS | CPSM | 4 | No | LIKE | Last modification agent | 8 | |
| CHANGEAGENT Input/output valid values |
|
|||||||
| CHANGEAGREL | CHAR | CPSM | 4 | No | DIFF | Last modification agent release | 32 | |
| CHANGETIME | DATETIME | CPSM | 8 | Yes | MAX | Last modification | 0 | |
| CHANGEUSRID | CHAR | CPSM | 8 | No | DIFF | Last modification user ID | 24 | |
| CREATETIME | DATETIME | CPSM | 8 | Yes | MAX | Time created | 16 | |
| DESCCODEPAGE | BINARY | CPSM | 4 | No | MAX | Description code page | 37 | 104 |
| DESCRIPTION | CHAR | CPSM | 58 | No | DIFF | Description | 44 | |
| PLATDIR | CHAR | CPSM | 255 | Yes | DIFF | Platform bundle directory. | 108 | |