Monitoring and Controlling Local System Resources

Use operational or enhanced commands to monitor local system resources:
cadts151
Use operational or enhanced commands to monitor local system resources:
  • To perform an inquiry on URTs for the local system, use either the enhanced command or the corresponding operational command. 
  • To perform an inquiry on MUFs for the local system, use the enhanced command.
  • To perform an action on URTs for the local system or to initiate or terminate the local system, use an enhanced command or the corresponding operational command.
  • To perform an action on MUFs for the local system, use an enhanced command.
The following tables summarize command options for displaying and taking action on URTs, TBLs, and MUFs in the local CICS system.
URT-Level Inquiry Command Options
Objective
Command Options
Display all URTs.
DBEX INQ,URT(????)
DBIC INQ=????
Display URTs within a specified numeric range, for example10 -- 19.
DBIC INQ=1?
DBEX INQ,URT(1?)
Display all URTs of a specified type.
DBEX INQ,SQL,URT(????)
DBIC INQ=SQL
 
DBEX INQ,DYN,URT(????)
DBIC INQ=DYN
Display all URTs of a specified status.
DBEX INQ,OPENED,URT(????)
DBIC INQ=OPENED
 
DBEX INQ,CLOSED,URT(????)
DBIC INQ=CLOSED
 
DBIC INQ=FAIL
 
(Alternative:)
None
DBEX INQ,CLOSING,URT(????)
(Alternative:)
None
DBEX INQ,UNOPENED,URT(????)
Display all URTs of a specified time for opening.
DBEX INQ,AUTO,URT(????)
DBIC INQ=AUTO
 
DBEX INQ,DEFER,URT(????)
DBIC INQ=DEFER
 
DBEX INQ,PLT,URT(????)
DBIC INQ=PLT
Display all URTs with no CSD entry.
DBEX INQ,NOCSD,URT(????)
(Alternative:)
None
Display all URTs for a specified MUF.
DBEX INQ,URT(????),SIDNAME(DBSIDPR)
(Alternative:)
None
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
Table-Level Inquiry Command Options
Objective
Command Options
Display all tables for all URTs.
DBEX INQ,TBL(????)
DBIC INQ=????.???
Display all tables for URT 10.
DBEX INQ,TBL(10)
DBIC INQ=10.???
Limit display by table name, where display includes an entry for the designated table and any synonyms for each URT where referenced.
DBIC INQ=????.PMF
 
(Alternative:)
None
Limit display to a specified table in a specified URT.
DBIC INQ=58.PMF
(Alternative:)
None
Limit display to tables in a specified database, for example DBID=25.
DBIC INQ=????.???.025
(Alternative:)
None
Display all tables for all URTs for a specified MUF.
DBEX INQ,TBL(????),SIDNAME(DBSIDPR)
(Alternative:)
None
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
Initiating or Terminating CA Datacom CICS Services
Objective
Command Options
Initiate
CA Datacom® CICS Services
.
DBEC P,STARTUP
DBOC STARTUP
Terminate
CA Datacom® CICS Services
.
DBEC P,SHUTDOWN
DBOC SHUTDOWN
Opening or Closing URTs
Objective
Command Options
Open one URT, for example 123.
DBEC P,OPEN,URT(123)
DBOC OPEN=123
Open multiple URTs, for example 110 -- 119.
DBEC P,OPEN,URT(11?)
DBOC OPEN=11?
Open all local URTs.
DBEC P,OPEN,URT(????)
DBOC OPEN=????
Close one URT, for example 123.
DBEC P,CLOSE,URT(123)
DBOC CLOSE=123
Close all local URTs.
DBEC P,CLOSE,URT(????)
DBOC CLOSE=????
Close all local URTs for a range of MUFs.
DBEC P,CLOSE,URT(????),SIDNAME(DBSID*)
(Alternative:)
None
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
These DBEC perform functions can also be implemented by using line commands on the URT-level inquiry.
Setting or Resetting When to Open
Objective
Command Options
Set one URT for automatic opening, for example 123.
DBEC P,AUTO,URT(123)
DBOC AUTO=123
Set for automatic opening URTs with a suffix equal to or greater than the specified suffix, for example 110 -- 119.
DBEC P,AUTO,URT(11?)
DBOC AUTO=11?
Set all local URTs for automatic opening.
DBEC P,AUTO,URT(????)
DBOC AUTO=????
Set for deferred opening one URT, for example 123.
DBEC P,DEFER,URT(123)
DBOC DEFER=123
Set for deferred opening all local URTs.
DBEC P,DEFER,URT(????)
DBOC DEFER=????
Reset to original STATUS for one URT, for example 123.
DBEC P,RESTART,URT(123)
DBOC RESTART=123
Reset to original STATUS for multiple URTs, for example 110 -- 119.
DBEC P,RESTART,URT(11?)
DBOC RESTART=11?
Reset to original STATUS for all local URTs.
DBEC P,RESTART,URT(????)
DBOC RESTART=????
Reset to original STATUS for all local URTs for a range of MUFs.
DBEC P,RESTART,URT(????),SIDNAME(DBSID*)
(Alternative:)
None
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
These DBEC perform functions can also be implemented by using line commands on the URT-level inquiry.
For the RESTART examples, "Reset to original STATUS" means to reset the URT STATUS to OPEN or UNOPENED from CLOSED. If TYPE is AUTO, the STATUS becomes UNOPENED. If TYPE is PLT,
CA Datacom® CICS Services
tries to OPEN the URT and, if successful, the STATUS changes to OPEN. If TYPE is DEFER, RESTART has no impact on the STATUS of URTs.
Creating a New Copy of a URT
Objective
Command Options
Create a copy of a URT, for example 123.
DBEC P,CLOSE,URT(123)
DBEC P,NEWCOPY,URT(123)
DBEC P,OPEN,URT(123)
DBOC CLOSE=123
DBOC DELETE=123
. . . use CEMT to newcopy
DBOC OPEN=123
Create a copy of all URTs for a specific MUF.
DBEC P,CLOSE,URT(????),SIDNAME(DBSIDPR)
DBEC P,NEWCOPY,URT(????),SIDNAME(DBSIDPR)
DBEC P,OPEN,URT(????),SIDNAME(DBSIDPR)
(Alternative:)
None
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
These DBEC perform functions can also be implemented by using line commands on the URT-level inquiry.
A P,NEWCOPY command results in a URT inquiry display, once the perform has been completed. In the resulting display, however, be aware that any URTs in OPEN status were not part of the NEWCOPY. The DBOCPRT file contains errors for the NEWCOPY commands that failed. You can also use the N line command from a URT inquiry display to see specific messages.
Overriding URT Attributes (DBURSTR)
Objective
Command Options
Change maximum I/O for set processing.
DBEC I,URT(nnnn)
Overtype the value displayed in Column CBSIO with a value between 0 and 524287 to establish a new CBSIO= interrupt value.
Change job priority for requests processed through this URT.
DBEC I,URT(nnnn)
Overtype the value displayed in Column PRTY with a value between 1 and 15 to establish a new priority level, where 1 is the lowest and 15 is the highest.
Change the maximum amount of time a program using this URT is to wait for a record held under exclusive control by another request.
DBEC I,URT(nnnn)
Overtype the value displayed in Column MIN or Column SEC to change the TIMEMIN= or TIMESEC= value, respectively. Enter a value between 1 and 120 to change the elapsed time specification in minutes or seconds.
Changing the transaction backout option from off to on, or vice versa.
DBEC I,URT(nnnn)
Overtype the value displayed in Column UNDO to change the TXNUNDO= specification. YES indicates that transaction backout is dynamically invoked for any program using this URT when an abend occurs. No transaction backout is indicated by a NO.
Close the URTs first. Each of the display commands may be limited to a specific MUF or range of MUFs with the addition of the SIDNAME parameter to the command.
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
There are no operational commands to override the URT attributes.
Overriding Table Attributes (DBURTBL)
Objective
Command Options
Changing whether exclusive control is dropped for this table when a RDUxx command is issued from the same Request Area.
DBEC I,TBL(nnnn)
Overtype displayed option (YES or NO) with its alternative in Column AUTODXC for each table requiring a change.
Changing whether this table is bypassed from the opening when the URT is opened.
DBOC DISABLE=urt.table.dbid
 
DBOC ENABLE=urt.table.dbid
DBEC I,TBL(nnnn)
Overtype displayed option (YES or NO) with its alternative in Column BYPOPEN for each table requiring a change.
Changing specification for whether this table name is duplicated in either this URT or another URT.
DBEC I,TBL(nnnn)
 
Overtype displayed option (YES or NO) with its alternative in Column SYNONYM for each table requiring a change. With YES, all requests for this table must include the DBID in the Request Area.
Changing specification of whether updates are to be permitted for this table when accessed through this URT.
DBEC I,TBL(nnnn)
Overtype displayed option (YES or NO) with its alternative in Column UPDATE for each table requiring a change.
Close the URTs first. Each of the display commands can be limited to a specific MUF or range of MUFs with the addition of the SIDNAME parameter to the command.
These commands can be further limited in a multiple MUF environment by adding the SIDNAME(xxxxxxxx) parameter to the input commands.
Except for BYOPEN, there are no operational commands to override the Table-level attributes.
MUF-Level Inquiry Command Options
Objective
Command Options
Display all MUFs.
DBEX INQ,MUF(??)
DBEX INQ,MSIDname(*)
Display MUFs within a specified numeric range. For example, 1 -- 9 or a specified SIDNAME (not to be confused with the SIDNAME qualifier for URTs or TBLs) range in the DBCSID macro appended to the DBCVTPR macro.
DBEX INQ,MUF(?)
DBEX INQ,MSIDname(x*)
Display statistics for all MUFs.
DBEX INQ,STATS,MUF(??)
DBEX INQ,STATS,MSIDname(*)
Display all MUFs of a specified status.
DBEX INQ,CONNECTED,MUF(??)
DBEX INQ,CONNECTED,MSIDname(xxxxxxxx*)
DBEX INQ,DISCONNECTED,MUF(??)
DBEX INQ,DISCONNECTED,MSIDname(*)
DBEX INQ,CONNECTING,MUF(??)
DBEX INQ,CONNECTING,MSIDname(*)
DBEX INQ,DISCONNECTING,MUF(??)
DBEX INQ,DISCONNECTING,MSIDname(*)
DBEX INQ,UNCONNECTED,MUF(??)
DBEX INQ,UNCONNECTED,MSIDname(*)
Display all MUFs of a specified time for connecting.
DBEX INQ,AUTO,MUF(??)
DBEX INQ,AUTO,MSIDname(*)
DBEX INQ,DEFER,MUF(??)
DBEX INQ,DEFER,MSIDname(*)
DBEX INQ,PLT,MUF(??)
DBEX INQ,PLT,MSIDname(*)
Connecting or Disconnecting MUFs
Objective
Command Options
Connect one MUF, for example 1 or the MUF whose SIDNAME is DBSIDPR in the DBCSID macro.
DBEC P,CONNECT,MUF(1)
DBEC P,CONNECT,MSID(DBSIDPR)
Connect multiple MUFs, for example 1 -- 9 or multiple MUFs of a range whose SIDNAMEs in the DBCSID macro begin with D.
DBEC P,CONNECT,MUF(?)
DBEC P,CONNECT,MSID(D*)
Connect all local MUFs.
DBEC P,CONNECT,MUF(??)
DBEC P,CONNECT,MSIDNAME(*)
Disconnect one MUF, for example 1 or the MUF whose SIDNAME is MUF1 in the SIDNAME parameter of the DBCSID macro appended to the DBCVTPR.
DBEC P,DISCONNECT,MUF(1)
DBEC P,DISCONNECT,MSID(MUF1)
Disconnect all local MUFs.
DBEC P,DISCONNECT,MUF(??)
DBEC P,DISCONNECT,MSID(*)
Immediately disconnect one MUF regardless of open URTs or active tasks, for example 2 or the MUF whose SIDNAME is MUF2 in the DBCSID macro of the DBCVTPR.
DBEC P,IMMEDIATE,MUF(2)
DBEC P,IMMEDIATE,MSID(MUF2)
Resetting MUFs Statistics
Objective
Command Options
Reset statistics for any MUF.
DBEC I,MUF(??),STATS
DBEC I,MSID(*),STATS
Type
R
in the Action column of the line corresponding to the number of the MUF to reset the statistics for that MUF. Statistics for multiple MUFs can be reset simultaneously on this display.
Overriding MUF USERS Attribute (DBCSID)
Objective
Command Options
Change the number of USERS allocated for a MUF.
DBEC I,MUF(??)
DBEC I,MSID(*)
  • For a MUF that is unconnected or disconnected, overtype the value displayed in column USERS with a value between 1 and 255 to establish a new USERS= tasks value.
  • For a MUF that is connected:
    1. Type a
      D
      in the Action column to disconnect the MUF,
    2. Overtype the value displayed in column USERS with a valid value.
    3. Type a
      C
      in the Action column to connect and establish the MUF with the new USERS value. Multiple MUFs can be processed simultaneously on this display.