Contains the list of resource definitions and commands that are in a change package, optionally limited to the candidates for a particular migration scheme. Also identifies the ready status of each candidate.
<CPID> change_package_ID </CPID>
<Scheme> migration_scheme </Scheme>
<Sel_Command> A | R | D </Sel_Command> 1 2
<Sel_CPID> change_package_ID </Sel_CPID>
<Sel_CConfig> CICS_configuration </Sel_CConfig>
<Sel_Group> resource_group </Sel_Group>
<Sel_ObjType> resource_type </Sel_ObjType>
<Sel_ObjName> resource_name </Sel_ObjName>
<Sel_TContainer> resource_group </Sel_TContainer> 3
<CSD> CSD_DSN </CSD> 4
<Context> context </Context>
<CreMethod> D | P </CreMethod> 5
<CC_Type> C | D | E </CC_Type> 6
<Prev_CConfig> change_package_ID </Prev_CConfig> 7
<Prev_Group> resource_group </Prev_Group>
<Prev_ObjType> resource_type </Prev_ObjType>
<Prev_ObjName> resource_name </Prev_ObjType>
<Prev_TContainer> resource_group </Prev_TContainer>
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode> 6
Return code | Reason code (last 4 digits*) | Status |
---|---|---|
0 | 0000 | Ready |
4 | 0018 | Not ready: this item has been changed after the change package was marked as ready |
4 | 004E | Not ready: either this item was added to the change package after the change package was marked as ready; or the change package has never been marked as ready. (For example, a key association was found for the resource definition, but its checksum was zero.) |
4 | 0058 | Not found: the change package refers to a resource definition that no longer exists. (The resource definition was added to the change package, but then subsequently deleted.) |
* The reason code is returned in the response as 8 hexadecimal digits. The first four digits identify the CICS Configuration Manager server module that performed the processing. The last four digits (shown above) identify the status of the item in the ready list. For a list of all reason codes, see Reason codes.
A ready list is different from most other repository objects because it does not directly represent an equivalent record type in the repository. Instead, the CICS Configuration Manager server generates ready list objects dynamically, when it receives a List command that requests a ready list.
List is the only command that you can use with a ready list. Here is the request format:
<CCV210>
<List>
<LocationCriteria>
<LocationType> Repository </LocationType>
</LocationCriteria>
<ObjectCriteria>
<ObjType> ReadyLst </ObjType>
<Scheme> migration_scheme </Scheme> 1
<CPID> change_package_ID </CPID>
</ObjectCriteria>
<RestrictionCriteria> 2
<ListCount> element_count </ListCount>
<ListElement>
<RestrictionField>CCONFIG</RestrictionField>
<RestrictionOperator>EQ</RestrictionOperator>
<RestrictionValue> CICS_configuration </RestrictionOperator>
</ListElement>
</RestrictionCriteria>
</List>
</CCV210>
In either case, you can further limit the resource definitions returned by the List command by specifying restriction criteria, described below.
Each list element in the response represents a resource definition or a command in the change package specified in the request:
<CCV210>
<List>
<OutputData>
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode> 1
<TaskNo> CICS_task_number </TaskNo>
<ListCount> element_count </ListCount>
<ListElement>
<ObjectData>
Object data for an item in the ready list
</ObjectData>
</ListElement>
More list elements…
</OutputData>
</List>
</CCV210>