CEMT DISCARD commands

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

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").

You can discard the following resource types:

(Programming information about FEPI commands is in the CICS® Front End Programming Interface User’s Guide.)

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
    and a screen similar to Figure 61 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.
Figure 61. 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(DFHAKP  ) Len(0005672) Ass Pro Ena Pri
      Res(000) Use(000001) Bel 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)
 

Notes:
  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.

CEMT DISCARD

Syntax

Read syntax diagramSkip visual syntax diagramCEMT DISCARD
 
                 .-------------------------.
                 V                         |
>>-CEMT Discard----+---------------------+-+-------------------><
                   +-Autinstmodel(value)-+
                   +-CONnection(value)---+
                   +-CORbaserver(value)--+
                   +-DB2Conn-------------+
                   +-DB2Entry(value)-----+
                   +-DB2TRAN(value)------+
                   +-DJar(value)---------+
                   +-DOctemplate(value)--+
                   +-Enqmodel(value)-----+
                   +-FENode(value)-------+
                   +-FEPool(value)-------+
                   +-FEPropset(value)----+
                   +-FETarget(value)-----+
                   +-FIle(value)---------+
                   +-JModel(value)-------+
                   +-JOurnalname(value)--+
                   +-PArtner(value)------+
                   +-PIpeline(value)-----+
                   +-PROCesstype(value)--+
                   +-PROFile(value)------+
                   +-PROGram(value)------+
                   +-Requestmodel(value)-+
                   +-TCLass(value)-------+
                   +-TCPipservice(value)-+
                   +-TDqueue(value)------+
                   +-TErminal(value)-----+
                   +-TRansaction(value)--+
                   +-TSmodel(name)-------+
                   +-Urimap(name)--------+
                   '-Webservice(name)----'
 

Options

Autinstmodel(value)
specifies the name of the autoinstall model that is to be removed. The name can be up to 8 characters long. The DISCARD AUTINSTMODEL command removes the installed name of an autoinstall model from the autoinstall terminal model (AITM) table and the CICS catalog.
CONnection(value)
specifies the 4-character identifier of the CONNECTION definition to be discarded. When a connection is removed, all its associated sessions are also removed.

For deletion to be successful:

  • A non-remote connection must be out of service.
  • A remote connection must have no active sessions.
  • For MRO connections, the interregion communications facility (IRC) must be closed. (You can use CEMT SET IRC CLOSED to close it.)
  • If the local system is a member of a VTAM generic resource group, APPC synclevel 2 connections must not have any outstanding recovery information.

    Other types of connection can be discarded, even if there is recovery work outstanding for them. However, it is recommended that you do not discard them if there is. You can use the INQUIRE CONNECTION RECOVSTATUS command to check.

In some unusual circumstances, it is possible for deletion of an LU61 connection to fail, even though the connection is out of service, because its sessions are still in-service. If this happens, set the connection INSERVICE, then OUTSERVICE, then reissue the DISCARD command.

CORbaserver(value)
Specifies the 4-character name of the CORBASERVER definition to be discarded.

If any of the beans installed in the named CorbaServer are in use when the DISCARD command executes, the state of the CorbaServer turns to DISCARDING. No new work is accepted. When all outstanding work has completed, the CORBASERVER definition is removed.

Copies of deployed JAR files are deleted from the CorbaServer's shelf, together with any other files on the shelf that belong to the CorbaServer. The CorbaServer’s shelf directory is deleted.

DB2Conn(value)
Specifies that the currently installed DB2CONN is to be removed. You can only discard a DB2CONN when the CICS DB2 interface is not active. Note that discarding a DB2CONN also discards all currently installed DB2ENTRYs and DB2TRANs.
DB2Entry(value)
Specifies the name of an installed DB2ENTRY to be removed. A DB2ENTRY can only be discarded when it is in a disabled state.
DB2Tran(value)
Specifies the name of the DB2TRAN to be removed. Transaction IDs referenced by this DB2TRAN will be routed to the pool after the DB2TRAN is removed.
DJar(value)
Specifies the 1-32 character name of the DJAR definition to be discarded.

As well as the DJAR definition, the shelf copy of the deployed JAR file and the beans it contains are also removed from the system. The current set of JVM instances are marked for termination, so that each JVM instance will not be reused after it terminates. New JVM instances load all their classes and do not use old versions of classes whose bytecodes have been replaced.

Passivated stateful session bean instances are not deleted by this operation because, in a workload-managed CICS EJB server, they could be activated by other AORs.

References to the homes of enterprise beans in the deployed JAR file are not retracted from the namespace because other AORs might still have the homes installed. However, before discarding a deployed JAR file from the last AOR in which it is installed, you might wish to issue a PERFORM DJAR RETRACT command to retract references to home interfaces.

DOctemplate(value)
Specifies the name of the document template to be removed.
Enqmodel(value)
specifies the 8-character identifier of the resource to be discarded.
FENode
This is described in the CICS Front End Programming Interface User’s Guide.
FEPool
This is described in the CICS Front End Programming Interface User’s Guide.
FEPropset
This is described in the CICS Front End Programming Interface User’s Guide.
FETarget
This is described in the CICS Front End Programming Interface User’s Guide.
FIle(value)
specifies the name of the file that is to be removed. The name can be up to 8 characters long. The DISCARD FILE command removes the installed name of a file from the CICS file control table and the CICS catalog.
JModel(value)
specifies the name of the installed journal model that you want to remove. The name can be up to 8 characters long. The DISCARD JMODEL command removes the journal model name from the installed journal model table and the CICS catalog. It does not affect any existing journals that have been defined using the journal model name. These continue to use their existing definitions unless they are discarded using the DISCARD JOURNALNAME command.
JOurnalname(value)
specifies the journal name that you want to remove. The name can be up to 8 characters long. The DISCARD JOURNALNAME command removes the journal name from the journal table and the CICS catalog. It does not affect the VSAM data sets currently using the journal as a forward recovery log or autojournal; they continue to use the existing definition until the data sets are closed.

To discard journals defined with a numeric identifier for auto-journaling or forward recovery logs, specify the journal name as DFHJnn, where nn is the journal number in the range 1-99.

Note:
Specifying DFHJ01 on this command refers to a user journal, DFHJ01.

Any future reference to the journal name will cause it to be reinstalled using the journal model resource in effect at that time.

PArtner(value)
specifies the name of the partner that is to be removed. The name can be up to 8 characters long. The DISCARD PARTNER command removes the installed name of a partner from the CICS side information table and the CICS catalog.
Start of changePIpeline(value) End of change
Start of changespecifies the name of the PIPELINE that is to be removed. The name can be up to 8 characters long. The DISCARD PIPELINE command removes the PIPELINE from the CICS system and the CICS catalog.End of change
PROCesstype(value)
Specifies the 8-character name of the Processtype to be removed. Only disabled processtypes can be discarded. If you are using BTS in a sysplex, it is strongly recommended that you use CPSM to remove them.
PROFile(value)
specifies the name of the profile that is to be removed. The name can be up to 8 characters long. The DISCARD PROFILE command removes the installed name of a profile from the CICS profile table (PFT) and the CICS catalog.
PROGram(value)
specifies the name of the program, map set, or partition set that is to be removed. The name can be up to 8 characters long. The DISCARD PROGRAM command removes the installed name of a program, map set, or partition set from the CICS processing program table (PPT) and the CICS catalog.
Requestmodel(value)
specifies the name of the Requestmodel resource definition to be removed.
TCLass(value)
specifies the name of the transaction class that is to be removed. The name can be up to 8 characters long. The DISCARD TCLASS command removes the installed name of a transaction class from the CICS program control table (PCT) and the CICS catalog.
Note:
‘TRANCLASS’ is also accepted as a synonym for TCLASS.
TCPipservice(value)
Specifies the name of the TCPIP service to be removed.
TDqueue(value)
specifies the name of the transient data queue that is to be removed from a running CICS system. The name can be up to 4 characters long.
Note:
When you discard a transient data queue, an implicit DELETEQ command is issued to free the control intervals used by the queue if the queue is an intrapartition queue. If the queue is a logically recoverable intrapartition queue, a syncpoint is taken after the DELETEQ request, but before the queue definition is discarded. This ensures that the associated control intervals have been freed before the definition is discarded.
TErminal(value)
specifies the name of the terminal to be removed. The name can be up to 4 characters long. The DISCARD TERMINAL command removes the installed name of a terminal from the terminal control table (TCT) and the CICS catalog.

Only terminals that use VTAM as an access method or consoles are eligible for deletion. Terminals that represent sessions cannot be deleted with DISCARD TERMINAL; use the DISCARD CONNECTION command instead.

TRansaction(value)
specifies the name of the transaction that is to be removed. The name can be up to 8 characters long. The DISCARD TRANSACTION command removes the installed name of a transaction from the CICS program control table (PCT) and the CICS catalog.
TSmodel(value)
specifies the name of the TS model that is to be removed. The name can be up to 8 characters long. You cannot discard a TSmodel that is in use, or one which has a name beginning with DFH.
Start of changeUrimap(value) End of change
Start of changespecifies the name of the URIMAP definition that is to be removed. The name can be up to 8 characters long. The DISCARD URIMAP command removes the URIMAP definition from the CICS system and the CICS catalog. For a URIMAP definition to be removed, it must be disabled individually (using the SET URIMAP command). Disabling a virtual host (using the SET HOST command) does not allow the URIMAP definitions that make up the virtual host to be removed.End of change
Start of changeWebservice(value) End of change
Start of changespecifies the name of the WEBSERVICE that is to be removed. The name can be up to 8 characters long. The DISCARD WEBSERVICE command removes the WEBSERVICE from the CICS system and the CICS catalog.End of change
[[ Contents Previous Page | Next Page Index ]]