CEMT DISCARD

The CEMT DISCARD command removes targets, nodes, pools, or property sets completely from FEPI.

Syntax

CEMT DISCARD

Read syntax diagramSkip visual syntax diagramCEMT DISCARDATOMSERVICE( value)AUTINSTMODEL( value)BUNDLE( value)CONNECTION( value)DB2CONN( value)DB2ENTRY( value)DB2TRAN( value)DOCTEMPLATE( value)ENQMODEL( value)EPADAPTER( value)EVENTBINDING( value)FENODE( nodename)FEPOOL( poolname)FEPROPSET( propsetname)FETARGET( targetname)FILE( value)IPCONN( value)JMODEL( value)JOURNALNAME( value)JVMSERVER( value)LIBRARY( name)MQCONNMQMONITOR( value)PARTNER( value)PIPELINE( value)PROCESSTYPE( value)PROFILE( value)PROGRAM( value)TCLASS( value)TCPIPSERVICE( value)TDQUEUE( value)TERMINAL( value)TRANSACTION( value)TSMODEL( value)URIMAP( value)WEBSERVICE( value)

Options

ATOMSERVICE(value)
Specifies the name of the ATOMSERVICE definition to be discarded. The name can be up to 8 characters long. You must disable the ATOMSERVICE resource before discarding it.
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 CICS® system and the CICS catalog.
BUNDLE(value)
Specifies the name of the BUNDLE definition to be discarded. The name can be up to 8 characters long. You must disable the BUNDLE resource before discarding it. Discarding the bundle automatically discards any other resources that were created when the bundle was installed. A BUNDLE can only be discarded if the enable count value is zero; an explicit DISABLE that reduces the enable count to zero is therefore required before DISCARD can proceed.
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 z/OS® Communications Server 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.

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. 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 be discarded only 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.
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.
EPADAPTER(value)
Specifies the name of the EP adapter that is to be removed. You must disable the EP adapter before discarding it.
EVENTBINDING(value)
Specifies the name of the event binding that is to be removed. You must disable the event binding before discarding it.
FENode( nodename )
The name of the FEPI node to be discarded.
FEPOol( poolname )
The name of the FEPI pool to be discarded.
FEPRopset( propsetname )
The name of the FEPI property set to be discarded.
FETarget( targetname )
The name of the FEPI target to be discarded.
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 system and the CICS catalog. You cannot directly discard a FILE resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
IPCONN(value)
Specifies the name of the IPCONN to be removed. The name can be up to 8 characters long. You cannot discard an IPCONN unless it is in OUTSERVICE status.
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 CICS system and the CICS catalog. It does not affect any existing journals that are 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 CICS system 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. 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.

JVMSERVER(value)
Specifies the name of a JVMSERVER resource that you want to remove. The name can be up to 8 characters long. The DISCARD JVMSERVER command removes the JVMSERVER definition from the CICS system and the CICS catalog. You cannot directly discard a JVMSERVER resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
LIBRARY(name)
Specifies the name of a LIBRARY resource that you want to remove. The name can be up to 8 characters long. The LIBRARY must be disabled. The DISCARD LIBRARY command removes an installed resource definition and its corresponding catalog entry from an active CICS system.

Specifying a LIBRARY name of DFHRPL is invalid and results in the message NOT VALID FOR RPL being displayed.

You cannot directly discard a LIBRARY resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
MQCONN
Specifies that the currently installed MQCONN definition is to be removed. You can discard an MQCONN definition when the connection between CICS and WebSphere® MQ is not active. When you discard an MQCONN definition that has an INITQNAME attribute, the associated MQMONITOR resource definition DFHMQINI and any user-defined MQMONITOR resources are also discarded.
MQMONITOR(value)
Specifies the name of the MQMONITOR resource definition that is to be removed. You can discard an MQMONITOR resource definition when the MQMONITOR is stopped and disabled.
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 system and the CICS catalog.
PIPELINE(value)
Specifies 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. You cannot directly discard a PIPELINE resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
PROCESSTYPE(value)
Specifies the 8–character name of the PROCESSTYPE to be removed. Only disabled process types can be discarded. If you are using BTS in a sysplex, it is strongly recommended that you use CICSPlex SM 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 system 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 system and the CICS catalog. You cannot directly discard a PROGRAM resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
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 system and the CICS catalog. TRANCLASS is also accepted as a synonym for TCLASS.
TCPIPSERVICE(value)
Specifies the name of the TCPIP service to be removed. You cannot directly discard a TCPIPSERVICE resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
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.

When you discard an intrapartition queue that is defined with attribute RECOVSTATUS=LOGICAL (which means logically recoverable), an implicit DELETEQ command is issued to free the control intervals used by the queue. A syncpoint is taken after the DELETEQ request but before the queue definition is discarded, which ensures that the associated control intervals are freed before the definition is discarded.

When you discard an intrapartition queue that is defined with attribute RECOVSTATUS=NO (which means not recoverable), the control intervals used by the queue are not freed.

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 CICS system and the CICS catalog.

Only terminals that use z/OS Communications Server 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 system and the CICS catalog. You cannot directly discard a TRANSACTION resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.

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.
URIMAP(value)
Specifies 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. You cannot directly discard a URIMAP resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.
WEBSERVICE(value)
Specifies the name of the web service that is to be removed. The name can be up to 8 characters long. The DISCARD WEBSERVICE command removes the web service from the CICS system and the CICS catalog. You cannot directly discard a WEBSERVICE resource that is created by a BUNDLE resource. To discard it you must use the bundle resource.