CEMT DISCARD commands

The DISCARD command allows you to remove an installed resource definition and its corresponding catalog entry from an active CICS® system.

For the following resources, the CICS Explorer® Operations views provide a functional equivalent. See CICSPlex SM Operations views in the CICS Explorer product documentation.

Command Explorer operations view
DISCARD ATOMSERVICE Atom services view
DISCARD BUNDLE Bundles view
DISCARD CONNECTION ISC/MRO connections view
DISCARD DB2CONN DB2® connections view
DISCARD DB2ENTRY DB2 entries view
DISCARD DB2TRAN DB2 transactions view
DISCARD DOCTEMPLATE Document templates view
DISCARD FILE Files view
DISCARD IPCONN IPIC connections view
DISCARD JVMSERVER JVM servers view
DISCARD LIBRARY Libraries view
DISCARD MQCONN Websphere MQ Connections view
DISCARD MQMONITOR Websphere MQ monitors view
DISCARD PIPELINE Pipelines view
DISCARD PROCESSTYPE Processtypes view
DISCARD PROGRAM Programs view
DISCARD TCLASS Transaction classes view
DISCARD TCPIPSERVICE TCP/IP services view
DISCARD TDQUEUE TD Queues view
DISCARD TERMINAL Terminals view
DISCARD TRANSACTION Transactions view
DISCARD TSMODEL TS models view
DISCARD URIMAP URI maps view
DISCARD WEBSERVICE Web services view

DISCARD does not affect the CICS system definition (CSD) file, and you can therefore reinstate the resource using CEDA INSTALL(resourcename). DISCARD commands require ALTER access to the resource to provide similar security to that for SET commands (which use UPDATE access). You cannot discard resources that are currently in use or are CICS-owned resources (beginning with DFH or C).

For a list of the resource types that you can discard, see CEMT DISCARD.

Programming information about FEPI commands is in FEPI system programming reference.

There are two ways to discard a resource:
  1. If you know the name of the resource that you want to discard, type: 
    CEMT DISCARD resourcetype(resourcename)
  2. If you do not know the name of the resource, type: 
    CEMT INQUIRE resourcetype
    A screen similar to Figure 1 appears. Use the carriage return key to move the cursor to the beginning of the line for the resource or resources you want to discard, and type D as shown and then press Enter.
Note:
  1. A CEMT INQUIRE display can be used to discard more than one entry at a time. If you overtype another value as well as typing D, the D is ignored.
  2. When discarding a resource, the use of * or + in the resource name is not allowed.
Figure 1. Example of screen showing the discarding of resources
  IN PROG
  STATUS:  RESULTS - OVERTYPE TO MODIFY
 D Prog(ABCDTASK) Len(0002936) Ass Pro Ena Pri    Ced
      Res(000) Use(000000)
   Prog(DFHACP  ) Len(0008232) Ass Pro Ena Pri
      Res(001) Use(000002) Any Cex Ful
   Prog(DFHAMP  ) Len(0108432) Ass Pro Ena Pri
      Res(000) Use(000009) Any Cex Ful
   Prog(DFHAPATT) Len(0000632) Ass Pro Ena Sha
      Res(005) Use(000018) Any Cex Ful
   Prog(DFHBRCP ) Len(0000000) Ass Pro Ena Pri
      Res(000) Use(000000) Bel Cex Ful
   Prog(DFHCCNV ) Len(0000000) Ass Pro Ena Pri
      Res(000) Use(000000) Any Cex Ful
 D Prog(ERRTASK ) Len(0000448) Ass Pro Ena Pri
      Res(000) Use(000000)