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

CEMT SET DB2ENTRY
TERM
Specifies the terminal identification (four
characters padded to eight) as an authorization ID.
An authorization ID cannot be obtained in this
manner if a terminal is not connected with the
transaction.
If a transaction is started (using a CICS command)
and has no terminal associated with it,
AUTHTYPE(TERM) should not be used.
TX Specifies the transaction identification (four
characters padded to eight) as the authorization
ID.
OPID
The operator identification associated with the
CICS transaction is used as the authorization ID
(three characters padded to eight).
USERID
The 8-character USERID associated with the
CICS transaction is used as the authorization ID.
When the DB2 sample sign-on exit DSN3@SGN
is used with AUTHTYPE(USERID), the exit sends
the user ID to DB2 as the primary authorization ID
and the RACF group ID to DB2 as the secondary
ID. When the sample sign-on exit is used, there is
no difference between AUTHTYPE(USERID) and
AUTHTYPE(GROUP).
DISABLEDACT
specifies what CICS is to do with new transactions that
access a DB2ENTRY when it has been disabled or is
disabling. CVDA values are:
POOL
The CICS DB2 attachment facility routes the
request to the pool. Message DFHDB2072 is sent
to the transient data destination specified by
MSGQUEUEn on the DB2CONN for each
transaction routed to the pool.
ABEND
The CICS DB2 attachment facility abends the
transaction.The abend code is AD26.
SQLCODE
An SQLCODE is returned to the application
indicating that the DB2ENTRY is disabled.
ENABLESTATUS(cvda)
specifies whether the DB2ENTRY can be accessed by
applications. CVDA values are:
ENABLED
The DB2ENTRY can be accessed by applications.
DISABLED
The DB2ENTRY cannot be accessed by
applications. A DB2ENTRY has to be disabled
before it can be reinstalled or discarded.
| FORCEDISABLED
| All tasks using the DB2ENTRY and those queued
| against the DB2ENTRY are forcepurged. The
| DB2ENTRY is then disabled.
PLAN
specifies the name of the plan to be used for this
DB2ENTRY.
If PLAN is specified, PLANEXITNAME cannot be
specified.
PLANEXITNAME
specifies the name of the dynamic plan exit to be used
for this DB2ENTRY. If you change the PLAN and
PLANExitname while there are active transactions for
the DB2ENTRY the next time the transaction releases
the thread, the plan/exit is determined using the new
rules. If PLANExitname is specified, PLAN cannot be
specified.
PRIORITY
specifies the priority of the thread tasks for the
DB2ENTRY relative to the CICS main task (QR TCB).
CVDA values are:
HIGH
subtasks attain a higher priority than the CICS
main task from which the subtask was generated.
EQUAL
subtasks have equal priority with the CICS main
subtask.
LOW
subtasks have a lower priority than the CICS main
task.
PROTECTNUM
specifies the maximum number of protected threads for
this DB2ENTRY.
THREADLIMIT
specifies the maximum number of threads for this
DB2ENTRY that the CICS DB2 attachment allows active
before requests are made to wait, are rejected, or are
routed to the pool.
THREADWAIT
specifies whether or not transactions should wait for a
DB2ENTRY thread, be abended, or overflow to the pool
should the number of active DB2ENTRY threads reach
the THREADLimit number. CVDA values are:
TWAIT
If all threads are busy, the transaction waits until
one becomes available.
NOTWAIT
If all threads are busy, the transaction is
terminated with an abend code AD2P.
TPOOL
If all threads are busy, the transaction is diverted
to use the pool of threads. If the pool is also busy,
and NOTWAIT has been specified for the
Chapter 11. Master terminal CEMT 173