IMS fails to start when an MFS library contains a PDSMAN Space Map ($$$SPACE) member.

Products

• PDSMAN

Issue/Introduction

IMS fails to start when an MFS library contains a PDSMAN Space Map ($$$SPACE) member.

Environment

PDSMAN 7.7

Cause

The PDSMAN Library Space Reuse facility offers a proactive solution to the problem of PDS out-of-space conditions and the related issues of unscheduled compressions, unnecessary compressions and PDS over-allocation. This facility dynamically reuses the dead PDS space whenever a member is updated. The space occupied by a deleted or replaced member is recorded and is made available for use by this or future updates. PDSMAN records space information in a special member (normally named $$$SPACE) called the Space Map that is created in the library.

IMS expects its MFS library members to have two bytes of binary zero user data in their directory entries. Since the PDSMAN Space Map member does not have user data written in this special format, IMS fails to start properly.

Resolution

The problem is resolved by explicitly telling PDSMAN that the library is an IMS MFS library so that the proper directory entry user data can be set. This is done by specifying the LIBTYPE=IMSMFS parameter on the matching $UPDATE initialization control statement for library.

To specify LIBTYPE=IMSMFS:

• Edit your PDSMAN Initialization Control Statements.
  
  
• Create a new $UPDATE control statement for the MFS library that specifies the LIBTYPE parameter and enables Library Space Reuse. For example:
  
  $UPDATE LIB=ims.mfs.library.name LIBTYPE=IMSMFS PSR=Y
  
  
• Place the new control statement before any other, less specific $UPDATE rule that may also match the library name specification.
  
  
• Reinitialize PDSMAN to enable the control statement changes.
  
  
• Compress the MFS library to recreate the Space Map member with the new user data format.

Additional Information

Additional information is available in the following PDSMAN 7.7 documentation:

 

• Library Space Reuse and considerations for its use with IMS libraries are described in Dynamically Reusing Library Space.
  
  
• The PDSMAN Initialization Control Statements, including the $UPDATE statement, are described in Initialization Control Statements.
  
  
• Procedures for reinitializing PDSMAN to enable Initialization Control Statement changes are described in Address Space Commands.