Information managed by the CSL RM

You can use the Resource Manager (RM) to create, update, query, or delete resources in the resource structure.

Examples of resources whose information is stored on a resource structure include:

  • Global resource status information for databases, DEDB areas, and transactions
  • Message destination resource information; for example, APPC descriptors, VTAM® LTERMS, MSNAMEs, VTAM terminal nodes, users, and user IDs
  • Global information for the OLCSTAT data set; for example, current online change libraries
  • IMSplex-wide parameters
  • Scheduled serial programs
RM maintains the following information about resources on a resource structure:
Resource Name
A client-defined resource name that is 11 bytes in length.
Name Type
A resource attribute that ensures that all resources within the same type have unique names. RM enforces this rule. Resources within a name type can have different resource types.
Resource Type
A client-defined resource attribute that allows CQS to physically group resources on a coupling facility list structure. RM supports up to 255 resource types.

RM uses resource type 253 to store its global information. Resource type 253 hashes to the same physical list headers as resource types 11, 22, 33, 44,...253. A client can define resource types that map to the same physical list headers as RM's global information.

Resource Version
The number of times that the resource has been updated. RM uses the version to serialize updates on the resource structure.
Resource Owner
A resource attribute that signifies the owner of the resource. This attribute is optional.

If the owner is identified, the client is responsible for enforcing a single owner of a resource. For example, IMS can set owners for the following resources to enforce a single active instance of the resources: nodes, lterms, users, and user IDs. A user or user ID that is signed on to one IMS in the IMSplex cannot be signed on to another IMS in the IMSplex at the same time. An lterm that is active on one IMS in the IMSplex cannot be active on another IMS in the IMSplex at the same time.

Resource Data
A resource attribute that contains any additional data about the resource.

RM registers to the Repository Server and connects to the IMSRSC repository during RM initialization or during the UPDATE RM command processing. If RM is defined with the resource structure, RM uses the resource structure to save the repository information, such as repository name, repository type, audit access values, and the RS z/OS® cross-system coupling facility (XCF) group information. The resource structure ensures that all RMs in the IMSplex use the same repository.

To display information about the resource structure managed by RM, use the QUERY STRUCTURE command. More information on this command is in IMS Version 15.4 Commands, Volume 2: IMS Commands N-V.