DCMT DISPLAY DATA SHARING Command

The DCMT DISPLAY DATA SHARING command displays information about the data sharing environment.
idmscu19
The DCMT DISPLAY DATA SHARING command displays information about the data sharing environment.
This article describes the following information:
Syntax
►►─ DCMT ─┬───────────────────┬─────────────────────────────────────────────►           └─ 
broadcast-parms
 ─┘  ►─── Display DAta SHaring ─┬─────────────┬─────────────────────────────────►◄                             ├─ SUMmary ◄──┤                             ├─ XES LIst ──┤                             ├─ XES LOck ──┤                             ├─ XCF GRoup ─┤                             └─ ALL ───────┘
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.
  • SUMmary
    Displays summary information about this system's data sharing group. SUMmary is the default if no option is specified.
  • XES LIst
    Displays information about the coupling facility list structure associated with this system's data sharing group.
  • XES LOck
    Displays information about the coupling facility lock structure associated with this system's data sharing group.
  • XCF GRoup
    Displays information about the members of this system's data sharing group and messages that have between sent between those members.
  • ALL
    Displays information about the members, list and lock structures associated with this system's data sharing group. It includes all information displayed for each of the above options.
Usage
Display for DCMT DISPLAY DATA SHARING SUMMARY
The following information is displayed for the SUMMARY option:
  • The name of this system's data sharing group and the name of this system's default cache.
  • The following information about the list of the members of the group:
    • Their member name
    • Their member state as assigned by XCF
    • Their prior and current user states as assigned by CA IDMS
    • The number of recovery locks held on proxies and resources (records and areas) on behalf of the member if it requires recovery
  • The following information about the list structure associated with this system's data sharing group:
    • Its name
    • The name of the Coupling Facility in which it is allocated
    • Its connection identifier and version
    • The structure size and the maximum count of elements and entries
  • The following information about the lock structure associated with this system's data sharing group:
    • Its name
    • The name of the Coupling Facility in which this system's lock structure was allocated
    • This system's lock structure connection identifier
    • This system's lock structure connection version
    • Its size
    • The maximum number of CA IDMS systems that can be members of the group
    • The number of lock entries in the structure
    • The maximum number of record data entries that can be contained in the lock structure
    • The number of times the lock structure has run short on record data entries
    • The number of record data entries currently allocated
    • The number allocated by this system
    • The highest number of record data entries allocated at one time
    • The number of record data entries that are held by this member and that are freeable because they are held on behalf of unused proxies
Display for DCMT DISPLAY DATA SHARING XES LIST
The following information is displayed for the XES LIST option:
  • The summary information about the list structure as described above for the SUMMARY option
  • The following information about the set of statistics associated with each list in the list structure:
    • Its name or list identifier. AreaList maintains information about shared areas. FileList maintains information about files associated with shared areas. QueueList maintains information about shared queues
    • The number of reads issued for entries in the list
    • The number of writes issued for entries in the list
    • The number of deletes issued for entries in the list
    • The number of conflicts detected when updating a list entry
    • The number of other errors detected when accessing the list
Display for DCMT DISPLAY DATA SHARING XES LOCK
The following information is displayed for the XES LOCK option:
  • The summary information about the lock structure as described above for the SUMMARY option
  • The following information about the set of statistics for each type of global resource controlled through the lock structure:
    • The resource type. LmgrResource represents a record or area. Phys.Page represents a database page. GlobalDeadLk represents a resource used to single thread assignment of a global deadlock detector. LmgrProxy represents a proxy. EnqDeq represents an enqueued resource. AreaList represents a resource used to single thread update of the coupling facility area list. FileList represents a resource used to single thread update of the coupling facility file list. GlobalQueue represents a shared queue.
    • The number of lock acquisition requests (obtains) that were issued by this system
    • The number of obtains not serviced immediately
    • The number of times an obtain failed because a wait was required and a wait was not allowed
    • The number of times an obtain was denied by the CA IDMS contention exit
    • The number of times other exception conditions were encountered on an obtain request
    • The number of times a request was issued to alter the state of a global lock held by this system
    • The number of times an alter could not be serviced immediately
    • The number of lock release requests issued by this system
    • The number of times a lock release could not be serviced immediately
    • The number of times an exception condition was encountered on an alter or release request
    • The number of times the CA IDMS contention exit was invoked to resolve conflicts for the resource type
    • The number of times the CA IDMS notify exit was invoked as part of conflict resolution
Display for DCMT DISPLAY DATA SHARING XCF GROUP
The following information is displayed for the XCF GROUP option:
  • The name of this system's data sharing group and the name of this system's default cache.
  • The following information about the list of the members of the group:
    • Their member name
    • Their member state as assigned by XCF
    • Their prior and current user states as assigned by CA IDMS
    • The number of recovery locks held on proxies and resources (records and areas) on behalf of this member if it requires recovery
  • The following information about the set of statistics for each member by message type:
    • The type of message. Reply represents replies issued by this system to messages sent by the indicated member. SyncStamp messages inform members of changes in SQL table definitions. GlobalDeadLock messages are used to resolve global deadlocks. DCMTDCUFSEND messages are used to broadcast commands. AreaFileVal messages inform members of changes in area and file status. QueueMsg messages inform members of the creation of a new global queue. ProgramMsg messages inform members whenever a #DELETE ... NEW COPY is issued.
    • The number of messages sent to the member from this system
    • The number of errors encountered when sending a message to the member
    • The number of messages received from the member by this system
    • The number of messages sent to this system by the member that were purged because no task was registered to receive that type of message
    • The number of errors encountered in attempting to receive a message from the member
Example
DCMT DISPLAY DATA SHARING SUMMARY
***  Display Data Sharing request  *** Group name                QAGRP3 Default Cache             IDMSQACACHE002 On Connectivity Loss      ABEND Group member SYSQA10  is Active    Prior   CV state: Ready               LmgrProxy recovery locks           0    Current CV state: Active              LmgrResource recov. locks          0 Group member SYSQA11  is Left    Prior   CV state: Quiescing           LmgrProxy recovery locks           0    Current CV state: Quiesced            LmgrResource recov. locks          0 Structure CAIDMSQAGRP3LI   type LIST    CF name                    COUPLET1   Actual size (K)                24576    Connection id                     1   Max. element count             37613    Connection version         000101B9   Max. entry   count             24920 Structure CAIDMSQAGRP3LK   type LOCK    CF name                    COUPLET1   Actual size (K)                 4096    Connection id                     1   Max. connections                   7    Connection version         000101B9   Lock entries                    4096    Record Data Entry information:    Maximum number                12669   Nr of times SOS                    0    Currently in use                121   Held by this CV                    0    HWM                             131   Freeable by this CV                0
DCMT DISPLAY DATA SHARING XES LIST
***  Display Data Sharing request  *** Structure CAIDMSQAGRP3LI   type LIST    CF name                    COUPLET1   Actual size (K)                24576    Connection id                     1   Max. element count             37613    Connection version         000101B9   Max. entry   count             24920 List structure statistics List name    * Reads      * Writes     * Deletes    * VersionErr * Errors List 0       *          0 *          0 *          0 *          0 *          0 AreaList     *        273 *        249 *          0 *          0 *          0 FileList     *        431 *        183 *          0 *          0 *          0 QueueList    *          0 *          0 *          0 *          0 *          0 QuiesceList  *         14 *          6 *          6 *          0 *          0 List 5       *          0 *          0 *          0 *          0 *          0
DCMT DISPLAY DATA SHARING XES LOCK
***  Display Data Sharing request  *** Structure CAIDMSQAGRP3LK   type LOCK    CF name                    COUPLET1   Actual size (K)                 4096    Connection id                     1   Max. connections                   7    Connection version         000101B9   Lock entries                    4096    Record Data Entry information:    Maximum number                12669   Nr of times SOS                    0    Currently in use                121   Held by this CV                    0    HWM                             131   Freeable by this CV                0 Lock structure statistics (Obtain) ResType      * Obtains    * Obt.Async  * Obt.Syncf  * Obt.Denied * Obt.Except LmgrResource *         64 *         43 *          0 *          0 *          0 Phys.Page    *          2 *          2 *          0 *          0 *          0 GlobalDeadLk *          0 *          0 *          0 *          0 *          0 LmgrProxy    *        471 *        357 *          0 *          0 *          0 EnqDeq       *          1 *          1 *          0 *          0 *          0 AreaList     *          1 *          1 *          0 *          0 *          0 FileList     *        105 *        105 *          0 *          0 *          0 GlobalQueue  *          0 *          0 *          0 *          0 *          0 QuiesceList  *         22 *         22 *          0 *          0 *          2 Lock structure statistics (Alter, Release) ResType      * Alters     * Alt.Async  * Releases   * Rel.Async  * Alt+Rel.Exc LmgrResource *          4 *          4 *         64 *         36 *          0 Phys.Page    *          1 *          1 *          1 *          1 *          0 GlobalDeadLk *          0 *          0 *          0 *          0 *          0 LmgrProxy    *        264 *        231 *        284 *         14 *          0 EnqDeq       *          0 *          0 *          1 *          0 *          0 AreaList     *          0 *          0 *          1 *          0 *          0 FileList     *          0 *          0 *        105 *          1 *          0 GlobalQueue  *          0 *          0 *          0 *          0 *          0 QuiesceList  *          0 *          0 *         20 *          0 *          0 Lock structure statistics (Miscellaneous) ResType      * ContExit   * NotifExit LmgrResource *          6 *          4 Phys.Page    *          2 *          1 GlobalDeadLk *          0 *          0 LmgrProxy    *        389 *        188 EnqDeq       *          0 *          0 AreaList     *          0 *          0 FileList     *          0 *          0 GlobalQueue  *          0 *          0 QuiesceList  *          0 *          0
DCMT DISPLAY DATA SHARING XCF GROUP
***  Display Data Sharing request  *** Group name                QAGRP3 Default Cache             IDMSQACACHE002 On Connectivity Loss      ABEND Group member SYSQA10  is Active    Prior   CV state: Ready               LmgrProxy recovery locks           0    Current CV state: Active              LmgrResource recov. locks          0 XCF Message statistics: MessageType  * Sends      * SendErrors * Receives   * RecvPurged * RecvErrors Reply        *          0 *          0 *          0 *          0 *          0 TestMsg      *          0 *          0 *          0 *          0 *          0 SyncStamp    *          0 *          0 *          0 *          0 *          0 GlobalDeadLk *          0 *          0 *          0 *          0 *          0 DCMTDCUFSEND *          0 *          0 *          0 *          0 *          0 AreaFileVal  *          0 *          0 *          0 *          0 *          0 QueueMsg     *          0 *          0 *          0 *          0 *          0 ProgramMsg   *          0 *          0 *          0 *          0 *          0 QuiesceMsg   *          0 *          0 *          0 *          0 *          0 Group member SYSQA11  is Left    Prior   CV state: Quiescing           LmgrProxy recovery locks           0    Current CV state: Quiesced            LmgrResource recov. locks          0 XCF Message statistics: MessageType  * Sends      * SendErrors * Receives   * RecvPurged * RecvErrors Reply        *          2 *          0 *          1 *          0 *          0 TestMsg      *          0 *          0 *          0 *          0 *          0 SyncStamp    *          0 *          0 *          0 *          0 *          0 GlobalDeadLk *          0 *          0 *          0 *          0 *          0 DCMTDCUFSEND *          0 *          0 *          0 *          0 *          0 AreaFileVal  *          0 *          0 *          2 *          0 *          0 QueueMsg     *          0 *          0 *          0 *          0 *          0 ProgramMsg   *          1 *          0 *          0 *          0 *          0 QuiesceMsg   *          0 *          0 *          0 *          0 *          0
More Information
  • For more information about the meaning of these parameters, see the
    CA IDMS System Reference section
    .
  • For more information about data sharing, see the
    CA IDMS System Reference section
    .