Deleting runtime application program resource and descriptor definitions with the DELETE command

With dynamic resource definition (DRD) enabled, you can delete runtime application program resources and resource descriptors dynamically, eliminating the need to use the online change process or the batch system definition process with an IMS cold start.

Delete runtime application program resource and descriptor definitions using the DELETE PGM and DELETE PGMDESC commands.

Procedure

  1. Check for work in progress with a QRY PGM SHOW(WORK) command. If there is work in progress, either:
    1. Wait for the work to finish.
    2. Address the work in progress.
  2. Determine whether any transactions reference the program by using a QRY PGM SHOW(TRAN) command. The DELETE PGM command fails if any transactions reference the program. If a transaction references the program, before deleting the program you must either:
    • Delete the transactions that reference the program by issuing a DELETE TRAN command.
    • Update the transactions to reference a different program by using the UPDATE PGM command.
  3. Determine whether any routing codes reference the program by using a QRY PGM SHOW(RTC) command. The DELETE PGM command fails if any routing codes reference the program. If a routing code references the program, before deleting the program you must either:
    • Delete the routing codes that reference the program.

      To delete a routing code associated with a Fast Path exclusive FP(E) transaction, issue a DELETE TRAN command.

      To delete a routing code associated with a Fast Path potential FP(P) transaction, issue a DELETE RTC command.

    • Update the routing code to reference a different program using the UPDATE RTC command.

      To update a routing code associated with an FP(E) transaction, issue an UPDATE TRAN command.

      To update a routing code associated with an FP(P) transaction, issue an UPDATE RTC command.

  4. The next step varies depending on where the application program is running.
    • If the program is running in an IFP region or is a BMP processing a WFI transaction, issue a /STOP REGION command to terminate the program.
    • If the program is running in a BMP or JBP region, either:
      1. Wait for the program to finish.
      2. Issue a /STOP REGION command to terminate the program.
    • If the program is running in an MPP or JMP region, issue a /STOP PGM or UPDATE PGM STOP(SCHD) command to terminate the program.
  5. Issue the DELETE PGM or DELETE PGMDESC command to delete the application program resource or descriptor definition, respectively.