Displaying information about an MSC network
There are two commands that you can use to view information about an MSC network: the type-1 command /DISPLAY and the type-2 command QUERY.
/DISPLAY command and MSC
The IMS type-1 /DISPLAY commands show available information that helps you manage an MSC environment. These facilities operate only within the domain of the local system, however, and do not provide information that is available only from remote systems. The following table summarizes the information that is available to the MTO with the /DISPLAY command.
| Command | Keyword | MSC use and effect |
|---|---|---|
| /DISPLAY AFFIN | LINK | Displays the current link affinities that logical links have within a TCP/IP or VTAM® generic resource group. Also displays the name and number of the logical links and for VTAM links, the node. |
| /DISPLAY ASMT | LINK | The physical link, the local and remote system IDs, and logical link paths assigned to the specified logical link. |
| MSNAME | Logical link number, physical link, local and remote system IDs, MSNAME label, and IMS ID. | |
| MSPLINK | Logical link number,
physical link, physical link type (CTC, MTM, TCP/IP, VTAM), physical link address, the maximum number
of allowed sessions, and the identifier used by the remote IMS system. For TCP/IP physical links, the command output displays the IMS ID of the remote IMS system. For VTAM physical links, the output displays the VTAM node name of the remote IMS system. |
|
| SYSID | The physical link, logical link, and logical link path assignments associated with the specified system identification. | |
| /DISPLAY LINK | [None] | Logical link number. |
| Partner ID. | ||
| The local totals for the numbers of messages received, sent, enqueued, dequeued, currently queued for link, and link status. | ||
| MODE | For VTAM links, displays various modes in which VTAM terminals can operate. | |
| OPTION BUFSIZE | Displays the link number, link name, bandwidth, buffer size, and the link status. | |
| QCNT | The global totals for the numbers of messages received, sent, enqueued, dequeued, currently queued for link, and link status. | |
| /DISPLAY MSNAME | [None] | Logical link path name (MSNAME) and the local totals for the numbers of messages enqueued, dequeued, and currently queued to the MSNAME. |
| QCNT | Logical link path name (MSNAME) and the global totals for the numbers of messages enqueued, dequeued, and currently queued to the MSNAME. |
QUERY command and MSC
The IMS type-2 QUERY commands display available attribute and status information to help you manage an MSC environment. The following table summarizes the MSC information returned by the QUERY command.
| Command | Keyword | MSC use and effect |
|---|---|---|
| QUERY MSLINK | BANDWIDTH(ON|OFF) | Identifies logical links that are or are not in bandwidth mode. |
| SHOW(ALL|attribute) | Returns the user-defined attributes of logical links. You can limit the information returned by specifying a valid attribute as a parameter of the SHOW() keyword. | |
| STATUS(status_type) | Identifies the logical links that have the specified status type. | |
| QUERY MSNAME | QCNT() | Identifies logical link paths that have queue counts relative to a number you specify. For example, you can view all logical link paths with a queue count that is greater-than-or equal-to 100. |
| SHOW(ALL|attribute) | Returns the user-defined attributes of logical link paths. You can limit the information returned by specifying a valid attribute as a parameter of the SHOW() keyword. | |
| STATUS(status_type) | Identifies the logical link paths that have the specified status type. | |
| QUERY MSPLINK | SHOW(ALL|attribute) | Returns the user-defined attributes of physical links. You can limit the information returned by specifying a valid attribute as a parameter of the SHOW() keyword. |
| STATUS(status_type) | Identifies the physical links that have the specified status type. | |
| TYPE(link_type) | Identifies physical links by their link types: CTC, MTM, TCP/IP, and VTAM. You can query one or more link types at a time. |