Resource identification classes

Resource identification classes are as follows.

Figure 1. Resource identification classes

IccBase
IccResourceId
IccConvId
IccDataQueueId
IccFileId
IccGroupId
IccJournalId
IccJournalTypeId
IccLockId
IccPartnerId
IccProgramId
IccRequestId
IccAlarmRequestId
IccSysId
IccTempStoreId
IccTermId
IccTPNameId
IccTransId
IccUserId

CICS® resource identification classes define CICS resource identifiers – typically the name of the resource as specified in its RDO resource definition. For example an IccFileId object represents a CICS file name. All concrete resource identification classes have the following properties:
  • 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


dfhal93.html | Timestamp icon Last updated: Monday, 5 June 2017