DCMT DISPLAY DISTRIBUTED RESOURCE MANAGER Command

This command displays information about resource managers that are known to a system.
idmscu19
This command displays information about resource managers that are known to a system.
This article describes the following information:
Syntax
►►─── DCMT ─┬───────────────────┬─────────────────────────────────────────────► └─
broadcast-parms
─┘ ►─── Display DISTributed ─┬─ RESource MANager ─┬─┬─────────────┬─────────────►◄ └─ RM ───────────────┘ └─ '
rm-name
' ─┘
Parameters
  • broadcast-parms
    Indicates to execute the DCMT command on all or a list of data sharing group members.
    For more information about broadcasting and
    broadcast-parms
    syntax, see the section How to Broadcast System Tasks.
  • RESource MANager
    Valid values are '
    rm-name
    ' and spaces. If '
    rm-name
    ' is not specified, a list of all known resource managers is displayed.
    • rm-name
      Specifies the name of the resource manager to display. The
      rm-name
      value must adhere to the following rules:
      • Enclosed in single quotes
      • Use the format: 'xxxxxxxx::yyyyyyyy'
      • Match a value on the summary display
Usage
Output from DCMT DISPLAY DISTRIBUTED RESOURCE MANAGER
Provides the following summary information:
Field
Value
RM Name
Name of the resource manager
Status
The resource manager's status. Valid values are:
Initial or Closed -- Resynchronization of the resource manager has not occurred
Open -- Resynchronization with the identified resource manager completed successfully
ResyncQued -- Resynchronization is in-progress or abnormally terminated
ResyncCmpl -- Resynchronization completed unsuccessfully, possibly because the resource manager is not active
Startup time (UTC)
The time the resource manager was last started, if known to the local system. The time shown is a UTC (GMT) value.
PndResync
The number of distributed transactions pending resynchronization in which this resource manager has an interest.
Output from DCMT DISPLAY DISTRIBUTED RM 'rm-name'
Output from this command includes the summary information and a list of the distributed transactions in which the resource manager has an interest. The latter information may not always be available, depending on the type of resource manager being displayed. For a description of the transaction-related information, see the DCMT DISPLAY DISTRIBUTED TRANSACTION summary command.
Field
Value
RM Name
Name of the resource manager
Status
The resource manager's status. Valid values are:
Initial or Closed -- Resynchronization of the resource manager has not occurred
Open -- Resynchronization with the identified resource manager completed successfully
ResyncQued -- Resynchronization is in-progress or abnormally terminated
ResyncCmpl -- Resynchronization completed unsuccessfully, possibly because the resource manager is not active
Startup time (UTC)
The time the resource manager was last started, if known to the local system. The time shown is a UTC (GMT) value.
Task/LTE
The task or logical terminal element associated with the transaction. If an active task is processing the transaction, its task ID is shown. If a logical terminal but no task is associated with the transaction, the LTE's ID is shown. A distributed transaction that is pending resynchronization or pending completion by RRS or an XA transaction manager may not have an associated task or logical terminal.
Distributed transaction ID
The distributed transaction ID (DTRID) assigned to the transaction.
Branch ID
The identifier of the top-level branch of the transaction.
Ctrl
The type of the transaction manager, or coordinator, that is in control of the transaction. Possible types are:
IDMS -- CA IDMS
RRS -- RRS
XA -- XA transaction manager
CICS -- CICS system
State
The state of the transaction. Possible states are:
Reset -- InReset
InFl -- InFlight
InPrp -- InPrepare
InDbt -- InDoubt
LstAg -- LastAgent
InBck -- InBackout
InCmt -- InCommit
Forg -- Forgotten
Ind
An indication of if this transaction is pending resynchronization. Possible values are:
Rsy -- The transaction is pending resynchronization
Rst -- The transaction was restarted and is pending resynchronization
Outcome
The transaction's outcome to date. Possible outcomes are:
OK -- OK
OK_P -- OK_Pending
FGT -- Forget
BACK -- Backout
BK_P -- Backout_Pending
HC -- Heuristic Commit
HM -- Heuristic Mixed
HR -- Heuristic Reset
Example
DCMT DISPLAY DISTRIBUTED RESOURCE MANAGER
This example illustrates using the DCMT DISPLAY DISTRIBUTED RESOURCE MANAGER command to obtain a summary of known resource managers.
DCMT D DISTRIBUTED RM RM Name Status Startup time (UTC) PndResync SYSTEM73::RRS_RMI Open N/A 0 SYSTEM73::DSI_CLI Open 2003-01-30-11.36.05.368120 0 SYSTEM73::DSI_SRV Open 2003-01-30-11.36.05.368120 0 SYSTEM72::DSI_SRV Initial *Unknown 1 SYSTEM74::DSI_SRV Open 2003-01-31-13.17.27.855555 1
DCMT DISPLAY DISTRIBUTED RM 'SYSTEM74::DSISRV'
This example provides detail information about an individual resource manager and all distributed transactions in which it has an interest.
DCMT D DIST RM 'SYSTEM74::DSI_SRV' RM Name SYSTEM74::DSI_SRV Status Open Startup time (UTC) 2003-01-31-13.17.27.855555 Task/LTE |Distributed transaction ID-Branch ID |Ctrl|State|Ind|Outcome *none |SYSTEM74::01650D6EDFB1AB93-01650D6A79F31E50|IDMS|InDbt|Rsy|OK
More Information
For more information about distributed resource managers, see the "Administrating CA IDMS Database" section of the CA IDMS documentation.