IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 69)

CEMT DISCARD
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.
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.
| 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 DFHJ
nn, 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.
Chapter 11. Master terminal CEMT 51