Resource identification classes
Resource identification classes are as follows.
IccBase
IccResourceId
IccConvId
IccDataQueueId
IccFileId
IccGroupId
IccJournalId
IccJournalTypeId
IccLockId
IccPartnerId
IccProgramId
IccRequestId
IccAlarmRequestId
IccSysId
IccTempStoreId
IccTermId
IccTPNameId
IccTransId
IccUserId
- The name of the class ends in Id.
- The class is a subclass of the IccResourceId class.
- The constructors check that any supplied resource identifier meets CICS standards. For example, an IccFileId object must contain a 1 to 8 byte character field; providing a 9-byte field is not tolerated.
The resource identification classes improve type checking; methods that expect an IccFileId object as a parameter do not accept an IccProgramId object instead. If character strings representing the resource names are used instead, the compiler cannot check for validity – it cannot check whether the string is a file name or a program name.
Many of the resource classes, described in Resource classes , contain resource identification classes. For example, an IccFile object contains an IccFileId object. You must use the resource object, not the resource identification object, to operate on a CICS resource. For example, you must use IccFile , rather than IccFileId to read a record from a file.
| Class | CICS resource |
|---|---|
| IccAlarmRequestId | alarm request |
| IccConvId | conversation |
| IccDataQueueId | transient data queue |
| IccFileId | file |
| IccGroupId | group |
| IccJournalId | journal |
| IccJournalTypeId | journal type |
| IccLockId | (Not applicable) |
| IccPartnerId | APPC partner definition files |
| IccProgramId | program |
| IccRequestId | request |
| IccSysId | remote system |
| IccTempStoreId | temporary storage queue |
| IccTermId | terminal |
| IccTPNameId | remote APPC TP name |
| IccTransId | transaction |
| IccUserId | user |