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

book

Article ID: 3912

calendar_today

Updated On:

Products

CA Endevor Software Change Manager (SCM) CA Endevor Software Change Manager - Natural Integration (SCM) CA Endevor Software Change Manager - ECLIPSE Plugin (SCM) CA Endevor Software Change Manager - Enterprise Workbench (SCM) CA PDSMAN

Issue/Introduction

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

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.

Environment

PDSMAN 7.7

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: