IDMS RHDCMPUT Error 384108 MAP CHECKED OUT

Products

• IDMS
• IDMS - Database
• IDMS - ADS

Issue/Introduction

Running IDMS mapping batch utility RHDCMPUT to process a map fails with error:

384108    E   MODIFY OR DELETE OF MAP NOT ALLOWED. MAP IS CHECKED OUT

This can also occur when running RHDCMAP1.

Environment

Release : 19.0

Cause

Both maps and ADS dialogs have a CHECKOUT and RELEASE facility to prevent multiple updates to the same entity from different users or batch and online. A map can have an explicit or implicit checkout. The explicit checkout is done in MAPC from the CHECKOUT option in the MODIFY menu item. An explicit checkout is only released by the RELEASE  option in the MAPC MODIFY menu item.
An implicit checkout is done when you start modifying a map. The implicit checkout is released after a successful compile.
The error indicates that the map has a checkout so it cannot be processed. The checkout needs to be released first.

Resolution

To release the checkout do one of the following:

• For an explicit checkout,  the user holding the checkout can go into MAPC and use the RELEASE  option in the MODIFY menu item.
• For an implicit checkout , he user holding the checkout can go into MAPC and either compile the map or use the RELEASE  option in the MODIFY menu item.
• Use transaction ADSL to list checkouts and then ADSM to release the checkout.
• Turn on optional bit OPT00235 in RHDCOPTF. This will cause the ADS and mapping batch utilities to ignore the checkout flags. It is not recommended this option be left on permanently. Only turn this bit on for mass batch compiles and then turn it off again.

Additional Information

See documentation section Checkout and Release Procedures, Creating an RHDCOPTF Module  and article  56986 on modifying RHDCOPTF