IMPORT DEFN SOURCE(CATALOG) command

The IMS management of ACBs must be enabled before you can use the IMPORT DEFN SOURCE(CATALOG) command. If the IMS management of ACBs is not enabled, IMPORT DEFN SOURCE(CATALOG) is rejected. For more information about the IMS management of ACBs, see IMS management of ACBs.

If you are modifying certain types of PSBs in an IMSplex that uses a shared IMS catalog, you can activate the modified PSBs in a subset of the IMS systems by using the UPDATEPSB and REFRESHPSB options. You can then test the application changes in the subset before you activate the changes across the entire IMSplex.

You can use the UPDATEPSB option for GSAM DBDs, so that when the IMPORT command is issued with the FOR(IMSID()) keyword, any GSAM DBDs in the staging data set are activated in the IMS directory.

The IMPORT command can be issued through TSO SPOC, IBM Management Console for IMS and DB2® for z/OS®, the Manage Resources options in the IMS Applications menu, or any user-written programs that issue commands through OM API. These commands can also be issued to an IMSplex by using the Batch SPOC utility.

Subsections:

• Environment
• Syntax
• Keywords
• Usage notes
• Output fields
• Return and reason codes
• Completion codes
• Examples

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the command and keywords.

Syntax

N

A

D

F

Keywords

The following keywords are valid for the IMPORT command:

DEFN

A required keyword.

FOR()

When the OPTION() keyword is specified, specifies which IMS systems in the IMS sysplex are to participate in the IMPORT process. Depending on the type of resources that are being imported and the state of processing in each IMS system, the options that are specified on the OPTION() keyword might impact systems that are not listed in the FOR(IMSID()) keyword. For more information, see the description of the OPTIONS() keyword.

IMSID()

Specify one or more comma-separated IMS IDs of the IMS systems that are to process the IMPORT command and the specified option.

The IMS ID specified on the FOR(IMSID()) keyword must be an IMS that exists within the IMSplex. The IMS specified might be active or down when the command is issued.

Note: Depending on the value that is specified on the OPTION() keyword, the IMS systems that are listed on the IMSID() keyword must either include or exclude the command master.

IMS selects a command master from the IMS systems that the command is routed to when the command is submitted. Therefore, to include the command master, route the command to one or more of the IMS systems that are specified on the IMSID() keyword. To exclude the command master, route the command to one or more IMS systems that are not specified on the IMSID() keyword.

When OPTION(UPDATEPSB) is specified, one of the IMS systems that is specified on the IMSID() keyword must be the command master, so route the IMPORT DEFN command to only the specified IMS systems.

When either of the preceding options is specified, if the command is routed to all IMS systems in the IMSplex, either explicitly or by default, the success of the command is unpredictable because the IMS system that is selected as the command master is unpredictable.

To see a list of the IMS systems in your IMSplex, issue the QUERY IMSPLEX TYPE(IMS) SHOW(ALL) command.

NAME

Specifies one or more 1 - 8 character names of database DBD or program PSB or both resources to import from the staging directory to the active directory. Wildcard names can be specified. The name is a repeatable parameter. If the NAME parameter specified is a specific name or a wildcard name, command responses are returned for all the resource names that are processed. NAME is an optional parameter, and if not specified, it defaults to NAME(*). Duplicate names are ignored.

For example, IMPORT DEFN SOURCE(CATALOG) NAME(DB1,DB2*,PSB1,PSB2%%) is a valid combination of DBD or PSB (or both) name parameters.

When NAME(*) is specified, all of the ACBs in the staging directory are imported. This is equivalent to the IMPORT DEFN SOURCE(CATALOG) command with no NAME keyword. If you specify NAME(*), it is not supported with any other NAME parameters.

For a successful IMPORT command, all the resources associated with the database DBD and program PSB resources that are specified on the NAME() keyword are also imported, except for GSAM. For GSAM DBDs and PSBs, only the named GSAM DBDs and PSBs are imported. If the associated PSB resources do not exist in the staging directory, the import command fails.

For example, if a DBD is in the staging directory, any of its index databases, logically related databases (including secondary index), and PSBs that are also in the staging directory will be imported.

In another example, if a PSB is in the staging directory, any of the database DBDs it references that are also in the staging directory will be imported.

When the OPTION(NOCHECK) is specified, only the resources specified on the NAME keyword are imported.

OPTION()

Specifies optional functions of the command.

You can specify the following options:

DELPENDERR

Specifies that if errors occur during the prepare phase of IMPORT DEFN SOURCE(CATALOG) command processing, the pending resources are deleted from the staging data set. An error in the prepare phase is indicated by OLCPREPF in the IMPORT DEFN command output.

NOCHECK

OPTION(NOCHECK) is independent of OPTION(DELPENDERR), OPTION(UPDATEPSB), OPTION(REFRESHPSB), and FOR(IMSID(imsid)).

For metadata database changes, OPTION(NOCHECK) is not required to be specified when the associated PSBs of the changed database are not included in the staging directory. If OPTION(NOCHECK) is specified for metadata database changes, LclStatus of "NO-ASSOCIATED-PSB-FOUND-IN-STAGE" is returned in the command response.

If OPTION(NOCHECK) is specified, the IMPORT DEFN command imports database changes that are created without their associated PSBs that are included in the staging directory by using the DFS3UACB utility with BLDPSB=NO parameter or DDL ALTER.

Note:

The IMPORT DEFN command does not scan the directory to find PSBs in the catalog directory so that it can validate that the PSBs were rebuilt for the changed database.

If a changed database is built incorrectly and its PSBs must be rebuilt but are not included in staging directory, the OPTION(NOCHECK) will not detect missing rebuilt PSB errors because using this option does not scan directories for all PSBs that are required to be rebuilt. Not scanning for these PSBs can cause unpredictable problems such as IMS not being able to schedule programs or cause database integrity problems.

If you want to disable the OPTION(NOCHECK) for your organization, you can use the OM Input Exit to reject the IMPORT DEFN SOURCE(CATALOG) OPTION(NOCHECK) command in case OPTION(NOCHECK) is mistakenly specified in the IMPORT DEFN SOURCE(CATALOG) command.

REFRESHPSB

Causes the IMS systems that are listed in the FOR(IMSID()) option to reload from the IMS catalog directory data set all PSBs in the system that have a refresh-pending (REFP) status.

Specify the REFRESHPSB option to activate PSB changes in an IMSplex that were previously activated by the UPDATEPSB option in only a subset of the IMS systems in the IMSplex.

Program resources that might be affected by the changes must be stopped on the systems that are listed in the FOR() option.

PSB activation does not occur for systems that are not listed in the FOR(IMSID()) clause.

To see a list of the IMS systems in your IMSplex, issue the QUERY IMSPLEX TYPE(IMS) SHOW(ALL) command.

While the REFRESHPSB option is being processed by an IMS system, the system status includes RFSHPSB in the LclStat field of the QUERY MEMBER command output.

UPDATEPSB

In an IMSplex, activates PSB changes in the IMS catalog and causes the IMS systems that are listed in the FOR(IMSID()) option to reload the changed PSBs the next time the PSBs are scheduled. IMS systems that are omitted from the FOR(IMSID()) keyword are not notified by the command to reload the modified PSBs and continue to use the original PSB definition in online memory until the REFRESHPSB option is submitted or another event, like a system restart, causes the PSB to be reloaded.

When 64-bit storage pools are enabled and the UPDATEPSB option is specified, IMS loads the old version of the non-resident PSBs into 64-bit storage. The PSBs are marked as refresh pending.

If the staging data set of the IMS catalog contains any DBDs when the UPDATEPSB option is specified, the IMPORT command fails.

The FOR(IMSID()) keyword is not effective for DOPT PSBs. After you issue the UPDATEPSB option, all IMS system that schedule the PSB in the IMSplex load the new, modified PSB from the IMS directory.

The FOR(IMSID()) keyword is effective for non-resident PSBs only if the PSB is cached in the 64-bit storage pools of the IMS systems that are not specified on the FOR(IMSID()) keyword.

Program resources that might be affected by the changes must be stopped on the systems that are listed in the FOR(IMSID()) option. Stopping the resources is not necessary for systems that are not listed in the FOR(IMSID()) option, unless the PSB is a DOPT PSB or a non-resident PSB that is not cached in the 64-bit storage pool of the systems.

All pending PSB changes in the staging data set are activated in the IMS systems that are listed in the FOR(IMSID()) clause when the IMPORT command is issued with the UPDATEPSB option.

When OPTION(UPDATEPSB) is specified, one of the IMS systems that is specified on the IMSID() keyword must be the command master, so route the IMPORT DEFN command to only the specified IMS systems.

To see a list of the IMS systems in your IMSplex, issue the QUERY IMSPLEX TYPE(IMS) SHOW(ALL) command.

While OPTION(UPDATEPSB) is being processed by an IMS system, the system status includes UPDPSB in the LclStat field of the QUERY MEMBER command output.

SOURCE()

Specifies the source of the resource definitions to be imported.

CATALOG

A required parameter that indicates that the resources to be activated are to be imported into the online IMS systems from the staging data set of the IMS catalog.

Usage notes

Before you run the IMPORT DEFN SOURCE(CATALOG) command, stop all existing database and program resources that will be affected by the changes.

However, for existing database resources with only metadata changes, for example, DATATYPE, EXTERNALNAME, REMARKS, and so on, you do not need to stop these database resources before you run the IMPORT DEFN SOURCE(CATALOG) command for nonstructural database changes.

After the command processing completes, restart all databases and programs that were stopped for the change.

When you issue the IMPORT DEFN SOURCE(CATALOG) command, IMS uses an internal process that is similar to the online change function to activate the resources in online IMS systems. Consequently, if you issue the QUERY MEMBER command during import processing, the status reflects the same prepare and commit phases that online change uses. If errors occur, the messages might also reflect these phases.

The IMPORT DEFN SOURCE(CATALOG) command can be issued only through the Operations Manager (OM) API. This command applies to DB/DC and DBCTL systems in which the IMS management of ACBs is enabled by ACBMGMT=CATALOG in the CATALOG section of the DFSDFxxx member.

The IMPORT command is not valid on the XRF alternate or FDBR region.

By default, when the IMPORT command is issued, OM routes the command to all active IMS systems (or to all IMS systems that are specified in the route list if the ROUTE parameter is specified on the CSLOMCMD or CSLOMI request) that registered interest in the command. All IMS systems that receive the command attempt to process the IMPORT command and import the resource definitions from the specified source. If you need the IMPORT command to be processed by a specific IMS, the ROUTE parameter must be used to direct the IMPORT command to the specific IMS.

If the IMPORT command processing fails because an SCI went down, issue the QUERY MEMBER TYPE(IMS) SHOW(STATUS) command to determine the state of all the IMSs in the IMSplex and the recommended action to take.

If the IMPORT command timed out with an OM return code of x'02000004', reason code x'00001000' and reason text "Command timed out" and QUERY MEMBER TYPE(IMS) SHOW(STATUS) shows no IMS in an online change state, the import worked, but the command timeout value was not long enough to get the response. If QUERY MEMBER TYPE(IMS) SHOW(STATUS) shows IMSs in an online change state, the command might have timed out because an SCI was down. Run the QUERY IMSPLEX SHOW(STATUS) command to see the IMSplex address spaces to determine whether SCI is down.

If SCI goes down after the directory was successfully updated, the import is committed, the directory update cannot be backed out, and message DFS4898E IMPORT DEFN SOURCE(CATALOG) FAILED is issued. If one or more IMSs are still in an online change state, bring SCI back up and run the IMPORT DEFN SOURCE(CATALOG) command again to the command master of the failing import to finish up the import.

If the command master of the failing import abended, another IMS in the IMSplex takes over processing the import and another IMPORT command to finish the import is not needed. If none of the IMSs are in an online change state, then the import was committed and no action is required. If an IMS is down before the IMPORT command is run, the IMPORT command succeeds with a warning return code and the IMS synchronizes itself with the directory when it comes back up. If a non-master IMS goes down during the IMPORT command processing, the IMPORT works and the IMS synchronizes itself with the directory when it comes back up.

Output fields

Return and reason codes

The following table includes the return and reason codes and a brief explanation of the codes. The return or reason code returned for the command might also indicate an error from a CSL request.

Errors unique to the processing of this command are returned as completion codes. The following table includes an explanation of the completion codes.

Completion codes

Table 4. Completion codes for the IMPORT command

Completion code	Completion code text	Meaning
0		Command completed successfully for resource or descriptor definition.
1	COMMAND NOT APPLICABLE TO THIS IMS	The IMPORT DEFN SOURCE(CATALOG) command does not apply to this IMS.
2	COMMAND NOT ATTEMPTED BY THIS IMS	The IMPORT DEFN SOURCE(CATALOG) command was not attempted by this IMS for one of the following reasons: The IMPORT DEFN SOURCE(CATALOG) command master encountered an error and did not direct this IMS to process the IMPORT DEFN SOURCE(CATALOG) command. The IMPORT DEFN SOURCE(CATALOG) command master rejected the command because one or more IMS systems are down. The IMPORT DEFN SOURCE(CATALOG) command master did not direct this IMS to process the command. The IMPORT DEFN SOURCE(CATALOG) command was specified with FOR(IMSID()) with no option, or with OPTION(REFRESHPSB) or OPTION(UPDATEPSB), and this IMS was not specified in the FOR(IMSID()).
3	IMS ALREADY IN REQUESTED OLC STATE	This IMS already processed the IMPORT DEFN SOURCE(CATALOG) command.
4	OLC PHASE INCOMPLETE ON THIS IMS	The IMPORT DEFN SOURCE(CATALOG) command is incomplete on this IMS. Look for other nonzero completion codes in the command output to determine why command processing is incomplete.
5	OLC COMPLETE, SOME MBRS UNUSABLE	The IMPORT DEFN SOURCE(CATALOG) command is complete; however, during internal commit processing after the IMS list was updated in the IMS directory, an error was encountered and one or more ACBs that were added or changed are unusable.
10	NO RESOURCES FOUND	The DBD or PSB name is invalid, or the wildcard name does not match any DBD or PSB names in the staging directory.
17	ANOTHER CMD IN PROGRESS	Another IMPORT command or an OLC command is in progress. If the previous IMPORT command did not complete and IMS terminated after the message CSL2200I CLIENT clientname INITIATED PROCESS DFSOLC was shown but the message CSL2200I CLIENT clientname TERMINATED PROCESS DFSOLC was not issued, the next IMPORT command can result in this error because the process in the Resource Manager (RM) was not cleaned up during the IMS restart or by another IMS sharing the IMS catalog. In a single RM environment, you can stop RM and restart RM, or you can shut down IMS and restart IMS to clean up and terminate the RM process so that the next IMPORT command runs successfully. In a multi-RM environment, you must shut down IMS and restart IMS to clean up and terminate the RM process so that the next IMPORT command runs successfully.
1D	XRF TAKEOVER IS IN PROGRESS	The IMPORT DEFN SOURCE(CATALOG) command cannot be processed because a takeover is in progress.
32	NOT ALLOWED FOR AN MSDB	The IMPORT command cannot be processed because one of the resources that is being imported from the staging directory is an MSDB. If the IMPORT command that is being processed does not include the NAME keyword, the command terminates on the first error, and the command output includes only the resources processed until the error. If the IMPORT command that is being processed includes the NAME keyword, all the resources that are associated with the name or names that are specified on the IMPORT command are listed in the command output.
51	NO RESOURCE STRUCTURE	The resource structure is not available. The resource could not be registered with RM. The resource definition was not imported.
52	RESOURCE STRUCTURE FULL	The resource structure is full. The resource could not be registered with RM. The resource definition was not imported.
58	IMS NOT REGISTERED TO RM	IMS is not registered to RM.
60	IMODULE GETMAIN storage error.
61	DFSBCB STORAGE ERROR	DFSBCB storage error. Could not get storage for DDIR, PDIR, RCTE, or SMB control block. The resource or descriptor definition was not imported.
62	HIOP storage error.
63	WKAP storage error.
64	GETSTOR STORAGE ERROR	DFSPOOL storage error. Could not get storage from the CMDP pool. The resource or descriptor was not imported.
73	PROGRAM SCHEDULED	Program is scheduled.
77	DEPENDENT REGIONS ACTIVE	One or more dependent regions are scheduled against the database, or one or more areas are open. The DEDB cannot be updated.
80	DATASET ERROR	Function (8 characters), ddname (8 characters), return code (8 bytes), and error detail (8 characters). Function can be one of the following: BLDL Data set BLDL error. BUSY The data set is busy. The detail contains the job name that has the data set. DIR Data set directory error. EMPTY Library is empty. ENQUEUE Data set enqueue error. EOF Data set end-of-file (EOF) error. OPEN Data set open error. Error detail can be 'DLS REG'. READ Data set read error. WRITE Data set write error. Ddname can be the DFSDIRC, the ddname of the IMS directory data set or DFSSTDI, the ddname of the staging data set of the IMS directory. Return code is the data set service return code. Reason code is the data set service reason code.
90	INTERNAL ERROR	An IMS internal error occurred. The definition was not imported.
91	TIMEOUT ERROR	An internal prepare phase, commit phase, or abort phase of the IMPORT DEFN SOURCE(CATALOG) command timed out before this IMS responded to the internal prepare or commit phase. The prepare phase or commit phase might have succeeded on this IMS.
94	RM REQUEST ERROR	An RM request error occurred. The resource could not be registered with RM. The resource definition was not imported.
B0	RESOURCE DEFINITION ERROR	The resource exists as another resource type in the RM structure. The resource definition was not imported.
B1	RESOURCE STATE ERROR	Resource type (8 characters), resource name (8 characters), error detail (16 characters). The resource name is the name of the resource as it is defined to IMS, such as the database name, the program name, or the transaction name. The error detail can be one of the following: AREA OPEN An area associated with the FP DEDB is open. AREA STARTED An area associated with the FP DEDB is started. DATABASE dbname ALTER INCOMPLETE Alter processing is not complete for a HALDB database. After alter processing completes, retry the INITIATE OLC command. DATABASE dbname STG TOO SMALL The IMPORT DEFN SOURCE(CATALOG) command cannot process the altered DDIR because there is not enough internal block storage. The lack of storage could be caused by the start of another HALDB alter operation after the IMPORT command reaches the commit phase. Retry the IMPORT DEFN SOURCE(CATALOG) command. Error details continued in next row.
B1	RESOURCE STATE ERROR (continued)	DBD ACTIVE A /DBDUMP command is active for the database. DBR ACTIVE A /DBRECOVERY command is active for the database. DBR NEEDED A /DBRECOVERY command is needed for the database resource. The IMPORT DEFN SOURCE(CATALOG) command was initiated to either change or delete one or more HALDB databases which have not been taken offline with a /DBR command. If the IMS catalog is enabled with an alias other than DFSC (the standard alias prefix), and the catalog databases have been modified with the IMPORT DEFN SOURCE(CATALOG) command, issue the /DBR DB command for the databases IMS1D000 and IMS1X000 instead of DFSCD000 and DFSCX000. DEP REGS ACTIVE Dependent regions using the FP DEDB are active. Error details are shown in next row.
B1	RESOURCE STATE ERROR (continued)	Error detail (continued): INTERNAL ERROR The resource control block is not found in the active IMS, or the resource control block exists. These are internal errors that should not occur. IN USE The resource is in use. A transaction has queuing in progress (either terminal input program-to-program switch). A database is in use. PSB SCHEDULED A program referencing a database to be changed or deleted is scheduled. QUEUEING Messages are queued to the transaction or program. SCHEDULED The named resource (a transaction or program to be changed or deleted, or a program referencing a database to be changed or deleted) is scheduled. SUSPENDED The transaction to be changed or deleted is on the suspend queue.
B2	IMS STATE ERROR	IMS state error (32 characters). The IMS state can be one of the following: CHECKPOINT IN PROGRESS This IMS has checkpoint in progress. NOT-REACHABLE The online change phase is rejected because this IMS is NOT-REACHABLE. The SCI on the OS image where this IMS is active is down. Restart the SCI and reissue the IMPORT DEFN SOURCE(CATALOG) command. OLC ALREADY COMMITTED The internal online change phase of IMPORT command processing is rejected because online change is already committed.
B2	IMS STATE ERROR (continued)	IMS state error (32 characters). The IMS state can be one of the following: OLC PHASE IN PROGRESS The IMPORT DEFN SOURCE(CATALOG) command is rejected because this IMS is processing either another IMPORT DEFN SOURCE(CATALOG) command or an online change request. RECOVERY IN PROGRESS The IMPORT DEFN SOURCE(CATALOG) command is rejected because the online recovery service is already in progress. RESOLVE DB INDOUBTS This IMS has DB indoubts. You must resolve the DB indoubts either by reconnecting the coordinator controller and IMS or by using an operator command. RESTART IN PROGRESS This IMS has restart in progress. RESTART NOT COMPLETE This IMS initialized before the IMPORT DEFN SOURCE(CATALOG) command was issued, but has not completed restart. The command is rejected as long as this IMS is in this state.
D6	DATABASE IN USE	Database in use. The DEDB cannot be changed because the DEDB is in use in a region.
E1	DB MUST BE STOPPED AND OFFLINE	The database must be stopped and taken offline in order for the attribute to be changed. You might need to issue a /DBR DB command or an UPDATE DB STOP(ACCESS) command to stop the database and take it offline before issuing the IMPORT DEFN command.
120	STAGING ACBLIB IS EMPTY	The IMPORT DEFN SOURCE(CATALOG) command failed.
121	RESOURCE IN CMD HAS NO CHANGE	The IMPORT DEFN SOURCE(CATALOG) command failed.
122	NOT ALL PSBS REBUILT FOR THIS DMB	The IMPORT DEFN SOURCE(CATALOG) command failed.
123	STAGING LIBRARY LEVEL NOT COMPATIBLE WITH CURRENT IMS	The IMPORT DEFN SOURCE(CATALOG) command failed.
125	NO PSB REBUILT	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS found existing PSB resources in the IMS directory that must be rebuilt before a modified DBD resource can be activated.
137	NO PSB FOR CHANGED DB IN STAGING	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS does not find any associated PSBs rebuilt for the changed DBD resource in the staging directory.
1D0	NOT DONE DUE TO ERROR	The identified resource was not imported because an error occurred. Check for other completion codes that are greater than 4 to determine the cause of the error.
1F2	DIRECTORY BLDL FAILED	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS encountered a BLDL error while reading the directory data sets.
1F3	BAD ACB FORMAT IN DIRECTORY	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS encountered an ACB that contains a block with an unrecognized DBD or PSB format.
1F5	OPEN DIRECTORY FAILED	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS was unable to open the IMS directory data set for update. This is probably an internal error. Contact IBM Software Support.
1F6	CANNOT IMPORT IMS SYSTEM RSC	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS encountered an ACB for the IMS catalog or another IMS system resource. The IMS catalog cannot be modified by using the IMPORT DEFN SOURCE(CATALOG) command.
1FB	PSB NOT REBUILT	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS found existing PSB resources in the IMS directory that must be rebuilt before a modified DBD resource can be activated.
1FC	I/O ERROR READING DIRECTORY	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS was unable to read from the IMS directory. Determine the cause of the error and restore or rebuild the IMS directory. After the IMS directory is recovered, reissue the IMPORT command.
1FD	I/O ERROR READING STAGING	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS was unable to read from the staging data set of the IMS catalog. Resubmit the resource changes to IMS by using either DDL or one of the IMS catalog populate utilities. After the changes are resubmitted to IMS, reissue the IMPORT command.
1FE	ADDED MBR NOT IN STAGING	This is probably an internal error. Contact IBM Software Support.
1FF	REPLACED MEMBER NOT IN STAGING	This is probably an internal error. Contact IBM Software Support.
227	ERROR CLEANUP DIRECTORY	IMPORT DEFN SOURCE(CATALOG) command processing attempted to clean up the directory data sets before initiating a new import activation process, but the cleanup process failed. Check the console for error messages and correct any errors before resubmitting the IMPORT command.
231	DLET MBR NOT IN DIRECTORY	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS attempted to delete a resource from the IMS directory, but the resource was not found in the IMS directory.
235	EMPTY STAGING DIRECTORY	During processing of the IMPORT DEFN SOURCE(CATALOG) command, no resources were found to import in the staging data set.
236	I/O ERROR UPDATING DIRECTORY	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS was unable to update the IMS directory. This is probably an internal error. Contact IBM Software Support.
237	I/O ERROR READING DFSIMSL	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS could not read the IMS list in the IMS directory. Either the directory data set is not available, or the IMS list member does not exist. In the case where the directory data set is not available, resolve the I/O error and then try import again.
238	I/O ERROR WRITING DFSIMSR	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS could not update the resource list in the IMS directory.
23A	I/O ERROR WRITING DFSIMSL	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS could not write to the list of IMS systems that share the IMS catalog in the IMS directory.
23C	THIS IMS CATALOG IS NO LONGER SHARED	The ACBSHR specification for this IMS system changed from ACBSHR=Y to ACBSHR=N. When processing the IMPORT DEFN SOURCE(CATALOG) command, IMS no longer includes this IMS system in the global coordination of changes to a shared IMS catalog in the IMSplex.
23D	DIRECTORY DATA SET FULL	The IMPORT DEFN SOURCE(CATALOG) command failed because the directory data set was full. Run the catalog recovery utility to get more spaces for the data sets.
23E	STAGING BLDL FAILED	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS encountered a BLDL error while reading the staging data sets.
240	IMSID NOT FOUND IN DFSIMSL	During processing of the IMPORT DEFN SOURCE(CATALOG) command, an imsid provided in the FOR(IMSID(imsid)) list does not exist in the DFSIMSL member of the IMS directory data set.
241	DMB FOUND IN STAGING DATA SET	During processing of the IMPORT DEFN SOURCE(CATALOG), a non-GSAM DMB was found in the staging data set.
242	NO RESOURCES IN REFRESH PENDING	During processing the IMPORT DEFN SOURCE(CATALOG) OPTION(REFRESHPSB) no PSBs were found to refresh.
243	NO REFRESH PENDING AND NO UPDATE	During processing of the IMPORT DEFN SOURCE(CATALOG) FOR(IMSID()) command with no OPTION() specified, no PSBs were found to be refreshed. The staging data set is empty and no PSBs were updated to the directory.
244	STOW ERROR IN DIRECTORY DATA SET	During processing of the IMPORT DEFN SOURCE(CATALOG) command, an I/O error occurs when writing the directory of the IMS directory. The IMPORT DEFN SOURCE(CATALOG) command fails.
246	OPEN STAGING DIRECTORY FAILED	During processing of the IMPORT DEFN SOURCE(CATALOG) command, IMS was unable to open the IMS staging directory data set for update.
247	DESERV FAILED	The IMPORT DEFN SOURCE(CATALOG) command failed issuing a z/OS DESERV request to retrieve system-managed directory entries (SMDE) for all members of the staging directory. The error text contains the module name that detected the error (8 characters) and the DESERV return code (8 characters).
248	CAT DBDS IN STG WITH OTHER RSCS	During processing of the IMPORT DEFN SOURCE(CATALOG), a catalog DBD was found in the staging data set with other resources. Other resources must be removed before a modified catalog DBD resource can be activated.
249	DIRECTORY IS CLOSED	The directory is closed due to an I/O error.
24A	ESTAE SETUP ERROR	ESTAE setup fails.