IDEAL Object Transport IDUTXPRT25E - program in use

Products

• Ideal
• IPC

Issue/Introduction

IDEAL Object Transport batch Utility (IDUTOTRN) to move programs fails with error message:

      IDUTXPRT25E - program in use

Environment

Ideal ( all versions) 

Resolution

When running the Object Transport Utility (IDUTOTRN), follow this process:

1. Use the DISABLE RUN command.
2. Transport the application using the object transport utility.
3. Use the ENABLE RUN command.

The DISABLE command forces users to exit from an application. However, even with the DISABLE command, a user written exit will get control after the DISABLE command and can override it. The DISABLE command must specify the highest level of an application (that program executed by a RUN command). It has no effect if issued for a subprogram. Precede the DISABLE command with the appropriate SELECT SYSTEM command.

Additional Information

For documentation , see IDUTOTRN Utility--Transport Applications in Object Form

The following are considerations while disabling an active online application:

• If the application to disable is running in multiple CICS regions or partitions, execute the DISABLE command in each region. This is true for each standalone CICS region and each AOR region in an MRO environment.
• When the DISABLE time arrives, the users running the specified application are not immediately purged. Their runs are aborted at the next transaction boundary (when the user presses a PF key or the Enter key or when a panel is transmitted) after the disable time arrives. For programs and panels in VLS format, the ENQUEUE on those programs and panels are not released until the run is actually aborted. If a user left the terminal before the disable time arrives, those ENQUEUEs are not released until the user returns and presses the Enter key or a PF key. These ENQUEUEs prevent the transport utility from running or a new version of a program from being marked to PROD status since an exclusive ENQUEUE on those programs and panels is requested from the operating system. In this case, eliminating these ENQUEUEs requires a DEQUEUE command be issued for each program and panel ENQUEUEd before running the object transport utility or issuing the MARK STATUS command. This is not a problem for application programs and panels in load module format since the runtime executor uses no ENQUEUE in this case.
• It is not possible to disable a particular subprogram or portion of a run-unit. Specifying a subprogram name instead of the main program name is ineffective. The program name specified in the DISABLE command must be the same program name specified in the RUN command.
• If a new version of a program is replaced and multiple applications use it, each of those applications must be disabled.