PScheme (package-scheme)

Purpose

Indicates the readiness of a change package for a particular migration scheme, including the user IDs of approvers. Also contains a history of the commands performed on this combination of change package and migration scheme.

Object data

List default output  
Yes
<CPID> change_package_ID </CPID>
Yes
<Scheme> migration_scheme </Scheme>
Yes
<Ver> object_version </Ver>
Yes
<ChangeTime> time_stamp </ChangeTime>
Yes
<UserID> user_ID </UserID>
 
<CRCCRC> checksum </CRCCRC>  1 
 
<CRCScheme> checksum </CRCScheme>  2 
 
<RdyStat> YES | NO </RdyStat>  3 
 
<AppStat> NONE | PENDING | APPROVED </AppStat>
 
<MigStat> NONE | INPROGRESS | FAILED | COMPLETE </MigStat>
 
<AuthName1> approver_role </AuthName1>
 
<AuthName2> approver_role </AuthName2>
 
<AuthName3> approver_role </AuthName3>
 
<AuthName4> approver_role </AuthName4>
 
<AuthName5> approver_role </AuthName5>
 
<UserID1> approver_user_ID </UserID1>
 
<UserID2> approver_user_ID </UserID2>
 
<UserID3> approver_user_ID </UserID3>
 
<UserID4> approver_user_ID </UserID4>
 
<UserID5> approver_user_ID </UserID5>
 
<RGroup>  4 
  <CHCount> element_count </CHCount> 
  <RGroupElement> 
    <CH_APICMD> API_command_name </CH_APICMD>
    <CH_DaTime> time_stamp </CH_DaTime>
    <CH_UserID> user_ID </CH_UserID>
    <CH_EvID> event_ID </CH_EvID>
    <CH_RC> return_code </CH_RC>
    <CH_Rsn> reason_code </CH_Rsn>
  </RGroupElement>
 
  More repeating group elements…
 
</RGroup>
 1 
The <CRCCRC> element contains a "checksum of checksums": that is, it contains a checksum of the checksums for each resource definition (see the <CRC> element in the key association object). CICS® Configuration Manager uses this value to detect whether any resource definitions in the change package have been updated, or whether resource definitions have been added to the change package, or deleted from the change package.
 2 
The <CRCScheme> element contains a checksum of the migration paths in the migration scheme. CICS Configuration Manager uses this value to detect whether any migration paths in the migration scheme have changed.
 3 
Ready status, approval status, and migration status.
 4 
The <RGroup> ("repeating group") element is a container for a set of <RGroupElement> elements. Here, <RGroup> contains the history of the change package with this migration scheme. Each <RGroupElement> identifies a command that has been performed on this combination of change package and migration scheme. The number of <RGroupElement> elements must match the element_count specified by <CHCount>.

Object criteria

<ObjType> PScheme </ObjType>
<CPID> change_package_ID </CPID>
<Scheme> migration_scheme </Scheme>

Usage

Inquire and List are the only commands that you can use with a package-scheme object. You cannot use the Create or Update commands to create or update a package-scheme object. Instead, the CICS Configuration Manager server creates and updates these objects as a result of other API commands, such as a Create command for a change package, or an Approve command.