CSL RM initialization with the IMSRSC repository

During Resource Manager (RM) initialization, RM reads the CSLRIxxx member of the IMS PROCLIB data set and processes the REPOSITORY section.

The CSLRIxxx member can be defined with the REPOSITORY section to define the IMSRSC repository name and repository type to be managed by the RM system. If the REPOSITORY section is defined, RM during RM initialization automatically registers to the Repository Server (RS) address space. RM connects to the repository with the name defined in the CSLRIxxx member.

Any errors during RM initialization with the RS REGISTER or CONNECT requests result in CSL2510E or CSL2511E error messages with the return or reason code from the RS. Additionally, the CSL2502A or CSL2503A messages are issued. RM does not complete its initialization and it does not issue the CSLSCRDY request to SCI indicating that it is ready to accept work. If all RMs in the IMSplex are waiting for the RS or repository, any IMS control region being initialized and using RM services waits for RM with the DFS3306A message. Any active IMS issues the DFS3306A message, indicating that RM services are not available.

The CSL2510E message during RM initialization is followed by the CSL2502A message, indicating that RM is waiting for the RS address space to be started. RM tries to register with the RS every 5 seconds until it is successful in registering with RS or it is terminated. RM must be terminated using the CANCEL command. RM cannot be terminated using the SCI SHUTDOWN request, because RM is not registered to SCI. RM cannot be terminated using the MVS STOP command, because the repository REGISTER and CONNECT is in early RM initialization and the threads to process the MVS STOP command are not yet set up. When RM is successful in registering to RS, the CSL2502A highlighted message is deleted.

The CSL2511E message during RM initialization is followed by the CSL2503A message, indicating that RM is waiting to connect to the repository with name and type specified in the CSL2503A message. RM retries to connect to the repository every 5 seconds until it is successful in connecting to the repository or it is terminated. RM must be terminated using the CANCEL command. RM cannot be terminated using the SCI SHUTDOWN request, because RM is not registered to SCI. RM cannot be terminated using the MVS STOP command, because the repository REGISTER and CONNECT is in early RM initialization and the threads to process the MVS STOP command are not yet set up. When RM is successful in connecting to the repository, the CSL2503A highlighted message is deleted.

Any errors parsing the CSLRIxxx member repository section result in the CSL25xx error messages. If this is the first RM being started in the IMSplex (when RM is with or without a resource structure), RM comes up without the repository enabled. After the error in the CSLRIxxx member is fixed, RM can be enabled with the repository using the UPDATE RM command.

If RM is being started with the resource structure, and the IMSplex is enabled with the repository, then any repository name errors result in the CSL25xx error messages followed by RM connecting to the repository with the name that is read from the resource structure.

When RM is started, if there is a mismatch in the XCFGROUP name in the CSLRIxxx member and the resource structure, RM abends with abend code 0010 and subcode X'00000634'.

When RM is started, if RM initialization modules cannot get storage, RM abends with abend code 0010 and subcode X'00000635' or X'00000636'.

The first RM to connect to the repository with the CONNECT request defines the index and key fields to be used in the repository. The subsequent RMs will use the index and key field information in the repository for their use. When RM connects successfully to the repository, the CSL2500I message is issued. Additionally, if the RM initializes the repository key and index fields and the repository is empty, the CSL2501I message is issued.

If RM is using the resource structure, the first RM stores the repository name, repository type, and audit access information from its CSLRIxxx member in the resource structure. Subsequent RMs obtain the repository name, repository type, and audit access information from the resource structure. Any mismatch in the information in the resource structure to the values in the RM's CSLRIxxx member results in the CSL2512W message, indicating the mismatch. RM connects to the repository name and type obtained from the resource structure.

If RM cannot connect to the resource structure the CSL2515E message is issued with the error return and reason code. RM continues processing without the repository services.

You can dynamically enable the repository using the UPDATE RM command after the errors are resolved.

If RM is not using the resource structure, RM always connects to the repository with the name specified in the CSLRIxxx member.

In an environment where RM is not using the resource structure, do not modify the repository name in the CSLRIxxx member between RM restarts.