IMS™ management of ACBs
This topic describes how FM/IMS operates when IMS™ is configured to manage the runtime application control blocks (ACBs).
When management of ACBs by IMS™ is enabled:
- The IMS™ catalog is the trusted source for DBDs and PSBs.
- IMS™ mostly no longer requires DBD, PSB, and ACB libraries.
In keeping with this, FM/IMS retrieves the PSBs and DBDs from the IMS catalog.
Mostly the IMS™ Catalog API (DFS3CATQ) is used to retrieve these control blocks. However, when the control blocks are required by IMS™ utilities that FM/IMS uses to provide dynamic PSB support, the IMS™ Catalog Library Builder utility (DFS3LU00) is used to retrieve them. This is because the IMS utilities require the control blocks to be in libraries.
Dynamic PSB support when IMS™ management of ACBs is enabled
Dynamic PSBs are supported differently when IMS management of ACBs is enabled.
| When ACBs are managed by your installation | When ACBs are managed by IMS™ |
|---|---|
| IMS builds the ACB for the DOPT PSB when functions are run in DLI mode. | IMS does not build an ACB for the DOPT PSB when functions are run in DLI mode or BMP mode. |
| FM/IMS builds the ACB for the DOPT PSB when functions are run in BMP mode. | FM/IMS builds an ACB for the DOPT PSB when functions run in BMP mode or DLI mode. |
| The ACB maintenance utility uses your installation's DBD libraries. | The ACB maintenance utility uses DBD libraries that are dynamically generated by the IMS Catalog Library Builder utility. |
| The DOPT ACB library is concatenated with the primary ACBLIB data set in the IMS execution JCL. | The IMS Catalog Populate utility adds the DOPT PSBs to the IMS catalog. |
Restrictions on FM/IMS functions when IMS™ management of ACBs is enabled
- FM/IMS does not support accessing logical databases, as the IMS Catalog API and the IMS Catalog Library Builder utility do not support retrieval of logical DBDs.
- FM/IMS adds DOPT PSBs to the IMS catalog but it does not delete them. Therefore periodically use the IMS Catalog Record Purge utility (DFS3PU10) to remove the DOPT PSBs from the IMS catalog.
Configuring FM/IMS when IMS™ management of ACBs is enabled
Set ACBMGMT=CATALOG on the FMN1POPI macro statement to specify that IMS™ management of ACBs is enabled.
Also set the following FMN1POPI parameters:
- Use the BSDSHLQ parameter to specify the high level qualifier for the IMS™ bootstrap data set.
- Use the DFSDF parameter to specify the 3-character suffix of the DFSDFxxx member of the IMS™ PROCLIB data set that contains the settings and attributes of the IMS™ catalog.
- Use the PROCLIB parameter to specify the name of the IMS™ PROCLIB data set that contains the required DFSDFxxx member.
- Use the REGCATLG parameter to specify whether the IMS catalog is registered with DBRC.
If you plan to use dynamic PSBs to access databases, use the DYNACB parameter to specify the name of the ACBLIB data set into which the ACB Maintenance utility generates the DOPT PSBs. You would also do this if the ACBs are managed by your installation, but when IMS management of ACBs is enabled, the specified data set is required by functions that access databases in BMP mode or in DLI mode.
For more information on how to code these parameters, see FM/IMS options.