DSNC MODIFY

The CICS® DB2® attachment facility command DSNC MODIFY modifies the message queue destinations of the DB2CONN, THREADLIMIT value for the pool, for DSNC commands, or for DB2ENTRYs. The same function can also be achieved using CEMT/EXEC CICS SET DB2CONN or DB2ENTRY commands.

Environment

This command can be issued only from a CICS terminal.

Syntax

Read syntax diagramSkip visual syntax diagramMODIFY syntax
 
>>-DSNC MODIFY--+-DESTination--old--new----------------+-------><
                '-TRANsaction--transaction-id--integer-'
 

Abbreviation

DSNC MODI or MODI (using the MODI transaction from the CICS DB2 sample group DFH$DB2).

Authorization

Access to this command can be controlled using the following CICS authorization checks:

Parameter description

DESTination
Specifies that the MSGQUEUE parameter of the DB2CONN table is to be changed, replacing the "old" destination ID with the "new" destination ID.
old
Any destination ID currently set in the MSGQUEUE of the DB2CONN.
new
A new destination identifier.

TRANsaction

Specifies that the THREADLIMIT value associated with the given transaction or group is to be modified.

transaction-ID
The command uses a transaction ID to identify either the pool, command, or the DB2ENTRY THREADLIMIT value to be modified.
integer
Is a new maximum value.

Usage notes

The integer specified in the command DSNC MODIFY TRANSACTION cannot be larger than the value specified for the TCBLIMIT parameter of the DB2CONN. The lowest possible value is zero.

Examples

Example 1
To change the specification of the MSGQUEUE parameter in the DB2CONN from MTO1 to MTO2 as follows:
 
            DSNC MODI DEST MTO1 MTO2
Figure 10. Sample output from DSNC MODIFY DESTINATION command
 
 DFHDB2039 07/09/98 14:47:17 IYK4Z2G1 The error destinations are: MT02 ****
 ****.
 
Example 2
To change the pool thread limit to 12:
 
    DSNC MODI TRAN CEPL 12
Figure 11. Sample output from DSNC MODIFY TRANSACTION command (pool thread)
 
 DFHDB2019 07/09/98 14:49:28 IYK4Z2G1 The modify command is complete.
 
Example 3
To change the command thread limit to 3:
 
    DSNC MODI TRAN DSNC 3
Figure 12. Sample output from DSNC MODIFY TRANSACTION command (for a command thread)
 
 DFHDB2019 07/09/98 14:49:28 IYK4Z2G1 The modify command is complete.
 
Example 4
To change the thread limit of the DB2ENTRY used by transaction XP05 to 8:
 
    DSNC MODI TRAN XP05 8
Figure 13. Sample output from DSNC MODIFY TRANSACTION command (changing DB2ENTRY thread limit)
 
 DFHDB2019 07/09/98 14:49:28 IYK4Z2G1 The modify command is complete.
 

Related concepts
CICS-supplied transactions for CICS DB2
Issuing commands to DB2 using DSNC
DSNC DISCONNECT
DSNC DISPLAY
DSNC STOP
DSNC STRT
[[ Contents Previous Page | Next Page Index ]]