QUERY MSLINK command
Use the QUERY MSLINK command to query information about the definition and status of specified logical links.
Subsections:
Environment
The following table lists the environments (DB/DC, DBCTL, and DCCTL) from which the QUERY MSLINK command and keywords can be issued.
Command / keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
QUERY MSLINK | X | X | |
NAME | X | X | |
BANDWIDTH | X | X | |
SHOW | X | X | |
STATUS | X | X |
Syntax
Keywords
The following keywords are valid for the QUERY MSLINK command:
- BANDWIDTH()
- This filter selects logical links that are either using, or not
using, bandwidth mode.
When you specify the BANDWIDTH keyword, the output returned includes the bandwidth mode, even if you do not specify SHOW(BANDWIDTH).
- ON
- Selects only logical links that are using bandwidth mode.
- OFF
- Selects only logical links that are not using bandwidth mode.
- NAME()
- Specifies the 1- to 8-character names of the logical links displayed. NAME(*) indicates that the command is to be applied to ALL the links in the system. Wildcards (*) can be specified in the name. The default is NAME(*) which returns all MSLINK resources. The logical link number, assigned during system generation, cannot be specified. Instead, the logical link name must be specified. The logical link number is returned as command output.
- SHOW()
- Specifies the MSLINK output fields to be returned. If you do not
specify the SHOW() parameter, only the logical link names and associated
logical link numbers are returned.
The MSLINK logical link name is always returned along with the name of the IMS that created the output for the link and the completion code. The filters supported with the SHOW parameter are:
- AFFIN
- In an IMS system that uses either TCP/IP or VTAM® generic resources, AFFIN identifies the specific IMS system in the generic resources group with which the specified logical link has an affinity. For TCP/IP generic resources AFFIN displays the IMS ID of the IMS system. For VTAM generic resources, AFFIN displays the APPLID name of the IMS system.
- ALL
- Includes all of the information in the other SHOW parameters, except for MSNAME.
This filter displays the values of the ASR and SYNCOPT attributes as statuses, not as attributes
- ASR
- Specifies the Automatic Session Restart (ASR) when the Session Outage Notification (SON)
facility value is returned.
ASR applies only to logical links that are assigned to VTAM physical links when both sides of the link are using the ASR option.
If SHOW(DEFN,ASR) is specified, the local and repository ASR values are returned. If SHOW(STATUS) is specified, the ASR value is shown as a status.
ASR must be specified with DEFN, otherwise the command is rejected.
- BACKUP
- For XRF-capable IMS systems, displays how the automatic restart of TCP/IP and VTAM links after
an XRF takeover are controlled.
The specification of BACKUP in the definition of a logical link overrides any switching options that are specified in the definition of the associated physical link. Use only if HSB=YES is specified on the IMSCTRL macro.
BACKUP is an MSC physical link attribute that you can set by using the CREATE MSPLINK, CREATE MSLINK, or UPDATE MSPLINK command. You can display the physical link BACKUP value by using the QUERY MSPLINK and QUERY MSLINK commands.Important: Even though BACKUP is a physical link attribute, the CREATE MSLINK NAME(linkname) SET(MSPLINK(msplinkname)) command can also change the BACKUP value of the specified physical link. You can use the QUERY MSPLINK command to display the updated BACKUP value. You can also use the QUERY MSLINK command and specify the MSC logical links, including the newly created logical link, that are assigned to the physical link to display the updated BACKUP value.The displayed value can be a numeric integer from 1 to 7, inclusive, which is the priority for reestablishing the session that has been set. When either the BACKUP keyword is omitted or no value is specified for BACKUP in the definition of either the physical or logical link, the default is 4. NO means that the session recovery of the physical link at takeover has been suppressed.
Although BACKUP displays the priority of the order in which IMS restarts TCP/IP and VTAM links, the active requests might be completed in any order because of variables such as internal VTAM conflicts and pacing, TCP/IP network traffic, and so on.
- BANDWIDTH
- Displays whether the link is using bandwidth mode.
- BUFSIZE
- Displays the current input and output buffer size for the logical links.
- CID
- Displays the VTAM Communication Identifications (CIDs) for the logical links.
- COUNT
- Displays the number of messages sent to and received from the specified logical links.
- DEFN
- Specifies that the resource definitions are to be returned.
The MSC logical link attributes that can be returned are: ASR, BACKUP, BANDWIDTH, BUFSIZE, MODETBL, MSPLINK, PARTNER, SYNCOPT, the repository create and update time stamps, and the IMS runtime create and update time stamps.
If SHOW(DEFN) is specified without any other SHOW filters or with the IMSID filter, all the definitional attributes are returned. The runtime resource definitions from the IMS system are returned by each IMS that receives the command. The stored resource definitions in the IMSRSC repository are returned by the command master IMS if the command master IMS is enabled to use the repository.
The command master IMS returns a response line for each generic stored resource definition that is obtained from the repository. This response line displays the attributes of the generic resource definition. When SHOW(DEFN) is specified without the IMSID filter and all the IMS systems have the same attribute values defined, only the response line for the generic definition is returned. The IMS IDs of the IMS systems that have the stored resource definition defined are not returned. If an IMS system has a stored resource definition with one or more attribute values that differ from the generic stored resource definition, an additional response line is returned for each IMS that has different attribute values.
If SHOW(DEFN,LOCAL) is specified, the runtime resource definitions from the IMS system are returned by each IMS that received the command.
If SHOW(DEFN,GLOBAL) is specified, the stored resource definitions from the repository are returned by the command master IMS. SHOW(DEFN,GLOBAL) is valid only when the command master IMS is enabled to use the repository.
If SHOW(DEFN) is specified with other parameters, only the requested definitional attributes are returned. For example, if SHOW(DEFN,TIMESTAMP) is specified, only the time stamps are returned.
Restrictions:- SHOW(DEFN) cannot be specified with AFFIN, CID, COUNT, DEFNTYPE, MSNAME, STATISTICS or STATUS. The LAffin, LCID, LDefnType, LRecdCnt, LSentCnt, LSIDL, LSIDR and LLclStat, which are returned on the QRY MSLINK SHOW(ALL) command, are not returned with SHOW(DEFN).
- SHOW(DEFN) cannot be specified with the filter BANDWIDTH or STATUS.
- The Repo and IMSid columns, which are returned with SHOW(DEFN), are not returned with SHOW(ALL).
Resource definitions that are stored in the repository are used to determine the response lines with the repository information, and the runtime resource definitions are used to determine the response lines with the IMS runtime resource information.
If SHOW(DEFN,IMSID) is specified, a response line is returned for the generic stored resource definition, and an additional response line is returned for each IMS that has the resource defined in the repository, regardless of whether their stored resource definitions are the same as the generic resource definition.
- DEFNTYPE
- Displays the definition type that the resource was defined with.
- EXPORTNEEDED
-
Specifies that only the MSC logical link resources that match the NAME parameter and have not been exported to the IMSRSC repository since they were created or last updated are to be returned on the QUERY command. SHOW(EXPORTNEEDED) behaves like a filter by only displaying resources that need to be exported, as if QUERY MSLINK EXPORTNEEDED(Y) were supported.
If the NAME keyword is omitted or NAME(*) is specified, only the names of the MSC logical links that need to be exported to the repository are returned.
If a specific name or a generic name that is not NAME(*) is specified on the NAME keyword, a response line is returned for each MSC logical link name specified on the command. If the specified MSC logical link does not need to be exported to the repository, an N is returned in the ExportNeeded column.
Restrictions:- SHOW(EXPORTNEEDED) cannot be specified with any other SHOW parameters or other keywords.
- SHOW(EXPORTNEEDED) is valid only when IMS is enabled with dynamic resource definition for MSC resources (MSCRSCS=DYN) and the IMSRSC repository.
- The QUERY MSLINK SHOW(EXPORTNEEDED) command is not valid on an XRF alternate system.
Tip: For resources that have not been exported to the IMSRSC repository, you can issue the /CHECKPOINT command to automatically write the resources to the repository so that they are available for the next IMS cold start. - GLOBAL
- For output fields that have both local and global values, this option returns only the global
values. GLOBAL must be specified with DEFN, otherwise the command is rejected. If used with another
SHOW keyword to request a specific output field, this option requests that only the global value of
the specified output field is returned.
SHOW(DEFN,GLOBAL,LOCAL) is equivalent to SHOW(DEFN).
- IMSID
- Specifies that the IMS IDs of the IMS systems whose resource lists contain the specified
resource name are to be returned. SHOW(IMSID) is processed only by the command master IMS and is
valid only when the command master IMS is enabled to use the repository.
IMSID cannot be specified with any other SHOW keywords other than DEFN or GLOBAL.
When SHOW(DEFN,IMSID) is specified, a separate line is returned for each IMS that has the resource defined, along with the stored resource definitions.
When SHOW(IMSID) is specified without the DEFN keyword, a separate line is returned for each IMS that has the resource defined, along with the resource name. No resource definitions are returned.
- LOCAL
- For output fields that have both local and global values, this option returns only the local
values. LOCAL must be specified with DEFN, otherwise the command is rejected. If used with another
SHOW keyword to request a specific output field, this option requests that only the local value of
the specified output field is returned. Local output is returned by each IMS that processes the
command.
SHOW(DEFN,LOCAL) returns only the local definitional attributes from the IMS system that processes the command.
SHOW(DEFN,GLOBAL,LOCAL) is equivalent to SHOW(DEFN).
- MODETBL
- Displays the mode table names that are associated with the specified links. The output includes DEF MODETBL and ACT MODETBL. DEF MODETBL is the default mode table name that is set by system definition or by issuing an UPDATE command. The name can be overridden with the UPDATE command or, for non-IMS session initiations, the LOGON exit. ACT MODETBL is the mode table name used to initiate the session. This name is displayed only while the session is active. The field is blank at normal session termination.
- MSNAME
- Displays the MSNAMEs assigned to the specified logical link, and their remote and local SYSIDs. When SHOW(MSNAME) is specified, STATUS() is invalid. MSNAME is mutually exclusive of all other SHOW filters.
- MSPLINK
- Displays the physical link to which this logical link is assigned.
- PARTNER
- Displays the current partner ID for this logical link.
- STATISTICS
- Displays the statistics for the logical link.
MSC link statistics are displayed by type-2 command QUERY MSLINK NAME(linkname) SHOW(STATISTICS). The SHOW(STATISTICS) keyword also displays the statistics reset mode, RESET,CHKPT or NORESET,CHKPT. Link statistics are not displayed with the SHOW(ALL) keyword.
I/O statistics are recorded only in bandwidth mode.
Additional I/O statistics are recorded for TCP/IP links, including the high, low, and total send I/O times for both the local and remote SCI, IMS Connect, and TCP/IP components.
Important: To be accurate, the I/O statistics for CTC, TCP/IP, and VTAM links require synchronized clocks on the local and remote IMS installations.If the clocks are not synchronized, elapsed I/O times can be calculated as negative values on one of the send I/O paths. The QUERY MSLINK command does not display negative values for elapsed I/O times.
IMS cannot determine if clocks are synchronized. Unless both partner IMS systems are on the same processor or are within the same sysplex, clocks are typically synchronized using an external method, such as an External Time Reference (ETR) hardware device.
MTM link partners are always on the same processor, so the timers are always synchronized. Partner IMS systems within the same SYSPLEX also have synchronized timers.
- STATUS
- Displays the logical link status.
- SYNCOPT
- For logical links that are assigned to TCP/IP or VTAM physical links only, displays the session
resynchronization options for the logical link.
- SYNCSESS
-
Indicates that session initiation is to be completed only if session resynchronization is successful. Successful session resynchronization occurs when the message sequence numbers of the two logical units in session agree, or when the sequence number of the sender is not less than the sequence number of the receiver.
- FORCSESS
-
Forces the session initiation to be completed regardless of whether session resynchronization is successful.
If SHOW(DEFN,SYNCOPT) is specified, the local and repository synchronization option values are returned. If SHOW(STATUS) is specified, the synchronization option value is shown as a status.
SYNCOPT must be specified with DEFN, otherwise the command is rejected.
SYNCOPT only applies to the global SYNCOPT definition in the IMSRSC repository. Use the STATUS(SYNCSESS) filter to display the local SYNCOPT definition.
- TIMESTAMP
- Displays the creation time (TimeCreate), last update time (TimeUpdate),
last access time (TimeAccess), and last import time (TimeImport) time
stamps are returned. The time is returned in local time in the format YYYY.JJJ
HH:MM:SS:TH:
- YYYY
- The year
- JJJ
- The Julian day (001 - 365)
- HH
- The hour (01 - 24)
- MM
- The minute (00 - 59)
- SS
- The seconds (00 - 59)
- TH
- The tenths and hundredths of a second (00 - 99)
- STATUS()
- Displays logical links that possess at least one of the specified
status. When you specify the STATUS keyword, the output returned includes
the logical link status even if you do not specify SHOW(STATUS). The
STATUS keyword cannot be specified with SHOW(MSNAME).
- ACTIVE
- Indicates, for the logical link, that link startup processing is complete and the line is available for message transfer.
- ASR
- Indicates the current automatic session restart designation as part of the Session Outage Notification.
- COLDSESS
- Indicates that for the logical link, startup processing is not complete.
- ERE
- Indicates that for the logical link, startup processing is not complete. However, when started, emergency restart synchronization is performed, because the previous link shutdown was either not normal or an IMS emergency restart was performed.
- FORCSESS
- Indicates that message resynchronization is attempted when the logical link is started. Even if resynchronization fails, the link is still started.
- IDLE
- Indicates that no activity is in progress for the logical link.
- INOP
- Indicates an inoperable link.
- LOST
- Indicates that the VTAM LOSTERM EXIT has been scheduled for this link.
- NOTIDLE
- Indicates that the link is waiting for the completion of a synchronous
event. The status can be NOTIDLE-A, NOTIDLE-B, or NOTIDLE-Cxx,
where xx represents the value of the access method
operation code.
- NOTIDLE-A
- Indicates a status of NOTIDLE-POST, which means that an event has completed but the link has not been dispatched to process it.
- NOTIDLE-B
- Indicates a status of NOTIDLE-IWAIT, which means the link is waiting for completion of internal I/O.
- NOTIDLE-Cxx
- Indicates a status of NOTIDLE-TP WAIT, which means the link is waiting for completion of a TP access method request. The two characters xx indicate the value of the access method operation code. Blanks appear if the link is VTAM.
- NOTOPEN
- Indicates that the link is not in open status.
- NRE
- Indicates that startup processing is not complete for the logical link. Normal restart synchronization is performed when the logical link starts, because the previous link shutdown or IMS restart was normal.
- PRI
- Indicates that the link is the primary partner of the MSC VTAM session.
- RESYNC
- Indicates that the positive acknowledgment for an IMS recoverable output message was not received when the MSC session was terminated.
- SEC
- Indicates that the link is the primary partner of the MSC VTAM session.
- STOCOMM
- Indicates that the link was stopped for communications.
- SYNCSESS
- Indicates that message resynchronization is attempted when the logical link is started, and that the link is started only if resynchronization is successful.
- TKOTRA
- Indicates that the logical link in an XRF session is traced only during takeover, to help diagnose XRF link switch problems.
- TRACE
- Indicates that the logical link is traced.
Usage notes
You can issue this command only through the Operations Manager (OM) API. This command applies to DB/DC and DCCTL systems.
The syntax for this command is defined in XML and is available to automation programs that communicate with OM.
The CREATE MSLINK NAME(mslinkname) command specified with SET(MSPLINK(msplinkname)) is rejected if at least one logical link attribute specified in the command (ASR, BACKUP, MODETBL, or SYNCOPT) conflicts with the physical link type. However, after the logical link is created, it can be reassigned to any type of physical link with an UPDATE MSLINK command or an /MSASSIGN command. If a logical link defined with attributes applicable to specific physical link types is reassigned to a different physical link type that does not support those attributes, they are ignored when the link is started.
If you want to display information about resource definitions, specify SHOW(DEFN). If you want to know which IMS systems have the resource defined and also know the attributes or resource definitions at each IMS system, specify SHOW(DEFN,IMSID). If you want to know which IMS systems have the resource defined, specify SHOW(IMSID).
If QUERY MSLINK is specified with SHOW(DEFN,BACKUP) and the local BACKUP value is NO, but the repository value is a number from 1 to 7, this is because the local IMS is not XRF capable. If QUERY MSLINK is specified with SHOW(DEFN,BACKUP) and the local BACKUP value is a number from 1 to 7, but the repository value is NO, this is because the local IMS was not XRF capable when it last exported the MSLINK, but it is XRF capable now.
Equivalent IMS type-1 commands
The following table shows variations of the QUERY MSLINK command and the type-1 IMS commands that perform similar functions.
QUERY MSLINK command | Similar IMS type-1 command |
---|---|
QUERY MSLINK NAME(linkname | linkname*) SHOW(ALL) | /DIS LINK link# | ALL |
QUERY MSLINK NAME(linkname | linkname*) SHOW(MODETBL) | /DIS LINK link# | ALL MODE |
QUERY MSLINK NAME(linkname | linkname*) SHOW(MSPLINK|MSNAME) | /DIS ASSIGNMENT LINK link# | ALL |
QUERY MSLINK NAME(linkname | linkname*) SHOW(AFFIN) | /DIS AFFIN LINK link# | ALL |
Output fields
The query output will display a series of headers and values, including the MSLINK name and number, IMSID that processed the command, and the command condition code (CC) of the command.
- Short label
- Contains the short label that is generated in the XML output.
- Long label
- Contains the column heading displayed on the TSO SPOC screen.
- Keyword
- Identifies the keyword on the command that caused the field to be generated. error appears for output fields that can appear for a nonzero completion code. N/A (not applicable) appears for output fields that are always returned.
- Meaning
- Provides a brief description of the output field.
Following are the statistics headers on the QUERY MSLINK command, and their meanings. All count fields with times and rates are in seconds. For example, 1.3 is equal to 1.3 seconds. .000003 is equal to 3 microseconds. The other fields such as byte or message counts are in decimal numbers. Rates are in units per second (for example, CHKW_RATE means check write calls per second).
Short label | Long label | Keyword | Scope | Meaning |
---|---|---|---|---|
AFFIN | LAffin | AFFIN | N/A | In an IMS system that uses either TCP/IP or VTAM generic resources, this field identifies the IMS system in the generic resource group with which the link has affinity, if any. For TCP/IP generic resources AFFIN displays the IMS ID of the IMS system. For VTAM generic resources, AFFIN displays the APPLID name of the IMS system. |
AMRS | LAvg_Msg_Rec_SZ | STATISTICS | N/A | Average message size received (type 01/03 message record). |
AMSS | LAvg_Msg_Send_SZ | STATISTICS | N/A | Average message size sent (type 01/03 message record). |
AMTB | LActMdtbl | MODETBL | N/A | Active VTAM logon mode table entry for the logical link. |
APT | LAvg_Proc_Time | STATISTICS | N/A | Average link processing time per dispatch calculated by dividing TPT by TDN. |
AQGT | LAvg_Qget_Time | STATISTICS | N/A | The average time for QMGR calls (GU or DEQ) to process a send message. |
AQPT | LAvg_Qput_Time | STATISTICS | N/A | The average QMGR call (ISRT or ENQ) to process a received message. |
ASR | LASR | ASR | LCL | Indicates the current automatic session restart designation as part of the Session Outage Notification. The output is returned from the local IMS. |
BANDW | LBandwidth | BANDW | N/A | The current usage of bandwidth mode. |
BKUP | LBackUp | BACKUP | N/A | Automatic restart of TCP/IP and VTAM links after an XRF takeover. |
BSR | LSend_MsgByte_Rate | STATISTICS | N/A | Message bytes sent per second from MSC link. The send time per each message sent is the time from Get Unique (GU) to get the message to send, to dequeue the message when the response is received. The link idle time in between sending messages is ignored. |
BUFSZ | LBufSize | BUFSIZE | N/A | Input and output buffer size for the logical link. |
CID | LCID | CID | N/A | VTAM Communication Identification. |
CNTR | LRecdCnt | COUNT | N/A | Number of messages received from the specified link. |
CNTS | LSentCnt | COUNT | N/A | Number of messages sent on the specified link. |
CWION | LChkwIO_CT | STATISTICS | N/A | Number of the logger check writes that resulted in a write (I/O) of the get unique (GU) or insert (ISRT) call to the logger write ahead data set (WADS). |
CWN | LChkw_CT | STATISTICS | N/A | Number of logger check writes. Check writes are requests to the logger to insure the message is logged (for example, Message get uniques are logged on the send side and inserts are logged on the receive side). |
CWR | LChkw_Rate | STATISTICS | N/A | Logger check write rate calculated by dividing the CWR by the statistics recording time. |
DFNT | LDefnType | DEFNTYPE | N/A | Definition type, which can be one of the following:
At the next IMS cold start, the definition reverts back to the definition in the DFSCLL3x member. |
DMTB | LDefMdtbl | MODETBL | N/A | Default VTAM logon mode table entry (set by system definition or modified by the UPDATE command). |
EXPN | ExportNeeded | EXPORTNEEDED | LCL | Indicates whether the MSC logical link has been exported to the IMSRSC repository. The value can be Y or N. |
HLISIOT | LHiLocIconSendIOTime | STATISTICS | N/A | The longest interval of time that the local IMS Connect instance required to process a message from SCI and send it to TCP/IP. |
HLSSIOT | LHiLocSciSendIOTime | STATISTICS | N/A | The longest interval of time that the local SCI instance required to process a message from IMS and send it to the local IMS Connect. |
HMRS | LHi_Msg_Rec_SZ | STATISTICS | N/A | Largest message size received (type 01/03 message record). |
HMSS | LHi_Msg_Send_SZ | STATISTICS | N/A | Largest message size sent (type 01/03 message record). |
HPT | LHi_Proc_Time | STATISTICS | N/A | The highest (longest) time the link was dispatched to process. |
HQGT | LHi_Qget_Time | STATISTICS | N/A | The highest (longest) QMGR call (GU or DEQ) to process a send message. |
HQPT | LHi_Qput_Time | STATISTICS | N/A | The highest (longest) QMGR call (ISRT or ENQ) to process a received message. |
HRIOT | LHi_RecIO_Time | STATISTICS | N/A | The highest (longest) I/O time to receive a message. |
HRISIOT | LHiRmtIconSendIOTime | STATISTICS | N/A | The longest interval of time that the remote IMS Connect instance required to process a message from TCP/IP and send it to the remote SCI. |
HRSSIOT | LHiRmtSciSendIOTime | STATISTICS | N/A | The longest interval of time that the remote SCI instance required to process a message from the remote IMS Connect instance and send it to the remote IMS system. |
HSIOT | LHi_SentIO_Time | STATISTICS | N/A | The highest (longest) I/O time to send a message. |
HTCSIOT | LHiTcpipSendIOTime | STATISTICS | N/A | The longest interval of time that a message required to travel from the local IMS Connect instance to the remote IMS Connect instance on the TCP/IP network. |
IMSID | IMSid | IMSID | GBL | Returns from the repository the IMSIDs that have the resource defined. |
LINKN | LMSLink# | No keywords, or DEFN, or DEFN,LOCAL | LCL | Logical link number. |
LLISIOT | LLowLocIconSendIOTime | STATISTICS | N/A | The shortest interval of time that the local IMS Connect instance required to process a message from SCI and send it to TCP/IP. |
LLSSIOT | LLowLocSciSendIOTime | STATISTICS | N/A | The shortest interval of time that the local SCI instance required to process a message from IMS and send it to the local IMS Connect. |
LMRS | LLow_Msg_Rec_SZ | STATISTICS | N/A | Smallest message size received (type 01/03 message record). |
LMSS | LLow_Msg_Send_SZ | STATISTICS | N/A | Smallest message size sent (type 01/03 message record). |
LPT | LLow_Proc_Time | STATISTICS | N/A | Lowest (shortest) time the link was dispatched to process. |
LQGT | LLow_Qget_Time | STATISTICS | N/A | The lowest (shortest) QMGR call (GU or DEQ) to process a send message. |
LQPT | LLow_Qput_Time | STATISTICS | N/A | The lowest (shortest) QMGR call (ISRT or ENQ) to process a received message. |
LRIOT | LLow_RecIO_Time | STATISTICS | N/A | The lowest (shortest) I/O time to receive a message. |
LRISIOT | LLowRmtIconSendIOTime | STATISTICS | N/A | The shortest interval of time that the remote IMS Connect instance required to process a message from TCP/IP and send it to the remote SCI. |
LRSSIOT | LLowRmtSciSendIOTime | STATISTICS | N/A | The shortest interval of time that the remote SCI instance required to process a message from the remote IMS Connect instance and send it to the remote IMS system. |
LSIOT | LLow_SendIO_Time | STATISTICS | N/A | The lowest (shortest) I/O time to send a message. |
LSTT | LLclStat | STATUS | N/A | The current status of the logical link. For the possible status values returned, see the description of the STATUS keyword. |
LTCSIOT | LLowTcpipSendIOTime | STATISTICS | N/A | The shortest interval of time that a message required to travel from the local IMS Connect instance to the remote IMS Connect instance on the TCP/IP network. |
MSN | LMSName | MSNAME | N/A | MSNAMEs associated with the logical link. |
MSP | LMSPLink | MSPLINK | N/A | Physical link to which the logical link is assigned. |
MSR | LSend_MsgCT_Rate | STATISTICS | N/A | Messages sent per second by MSC link. The send time per each message sent is the time from Get Unique (GU) to get the message to send, to dequeue the message when the response is received. The link idle time in between sending messages is ignored. |
PID | LPID | PARTNER | N/A | Partner ID for the link. |
RASR | ASR | ASR and DEFN | GBL | Indicates the current automatic session restart designation as part of the Session Outage Notification. The output is returned from the repository. |
RBANDW | Bandwidth | BANDWIDTH and DEFN | GBL | The current usage of bandwidth mode. The output is returned from the repository. |
RBKUP | BackUp | BACKUP and DEFN | GBL | Automatic restart of TCP/IP and VTAM links after an XRF takeover. The output is returned from the repository. |
RBR | LRecIO_Byte_Rate | STATISTICS | N/A | Rate in bytes per second being received. This is calculated by dividing the total bytes received (TBRC) by the total send time (TRIOT). |
RBUFSZ | BufSize | BUFSIZE and DEFN | GBL | Input and output buffer sizes for logical link. The output is returned from the repository. |
RDMTB | DefMdtbl | DEFN and MODETBL | GBL | VTAM logon mode table entry (logon mode name) containing the SNA bind parameters to be used when a session is established for this terminal. The output is returned from the repository. |
REPO | Repo | DEFN | GBL | Indicates whether the line displays the stored resource definitions.
|
RIOR | LRecIO_Req_Rate | STATISTICS | N/A | The receive I/O requests per second. This is calculated by dividing the total receives (TRN) by the total send I/O time (TRIOT). |
RMSP | MSPLink | DEFN and MSPLINK | GBL | Physical link to which the logical link is assigned. The output is returned from the repository. |
RMT | LRec_Msg_Time | STATISTICS | N/A | Interval of time between the first and last message received. Used for benchmark testing of a block of messages. |
RPID | PID | DEFN and PARTNER | GBL | Partner ID for the link. The output is returned from the repository. |
RSYNC | SyncOpt | DEFN and SYNCOPT | GBL | Indicates the session resynchronization options for the logical link. The output is returned from the repository. |
RTMCR | TimeCreate | DEFN | GBL | Create time from the repository. This is the time the resource was first created in the repository. |
RTMUP | TimeUpdate | DEFN | GBL | Update time from the repository. This is the time the resource was last updated in the repository. |
RSYNC | SyncOpt | DEFN and SYNCOPT | GBL | Indicates the session resynchronization options for the logical link. The output is returned from the repository. |
SBR | LSendIO_Byte_Rate | STATISTICS | N/A | Rate in bytes per second being sent. This is calculated by dividing the total bytes sent (TBSC) by the total send time (TSIOT). |
SIDL | LSIDL | MSNAME | N/A | Local system identification of the associated MSNAME. |
SIDR | LSIDR | MSNAME | N/A | Remote system identification of the associated MSNAME. |
SIOR | LSendIO_Req_Rate | STATISTICS | N/A | The send I/O requests per second. This is calculated by dividing the total sends (TSN) by the total send I/O time (TSIOT). |
SMT | LSend_Msg_Time | STATISTICS | N/A | Interval of time between the first and last message sent. Used for benchmark testing of a block of messages. |
SOPT | LOption | STATISTICS | N/A | Statistics reset option = RESET,CHKPT = statistics are reset at each IMS checkpoint or NORESET,CHKPT = statistics are not reset at IMS checkpoints. |
STIM | LStart_Time | STATISTICS | N/A | The start date and local time for the statistics. For option
RESET,CHKPT, this will be the last IMS checkpoint time. For
option NORESET,CHKPT, this will be when the last UPDATE MSLINK START STATISTICS OPTION (RESET)
command was issued. The format is yyyy.ddd hh.mm.ss.tt, where:
|
TBRC | LTot_Byte_Rec_CT | STATISTICS | N/A | Total bytes of data received including message data, response data, and internal message control blocks used for bandwidth mode. |
TBSC | LTot_Byte_Send_CT | STATISTICS | N/A | Total bytes of data sent including message data, response data, and internal message control blocks used for bandwidth mode. |
TDN | LTot_Disp_CT | STATISTICS | N/A | Number of times the logical link ITASK was dispatched. A typical send or receive message operation will require two dispatches, one to send and one to process the acknowledgment, or one to receive and one to send the acknowledgment. |
TLISIOT | LTotLocIconSendIOTime | STATISTICS | N/A | The total amount of time that the local IMS Connect instance required to process all messages from SCI and send them to TCP/IP. |
TLSSIOT | LTotLocSciSendIOTime | STATISTICS | N/A | The total amount of time that the local SCI instance required to process all messages from IMS and send them to the local IMS Connect. |
TMAC | LTimeAccess | TIMESTAMP | N/A | The time that the resource was last accessed. This is not yet supported. |
TMBRC | LTot_MsgByte_Rec_CT | STATISTICS | N/A | Total count of message bytes of data received. This includes the message prefixes and user data segments (for example, all the data in the type 01/03 log record). |
TMBSC | LTot_MsgByte_Send_CT | STATISTICS | N/A | Total count of message bytes of data sent. This includes the message prefixes and user data segments (for example, all the data in the type 01/03 log record). |
TMCR | LTimeCreate | TIMESTAMP | N/A | The time that the resource was created with a CREATE MSLINK command, an IMPORT command that creates the MSC logical link, or an IMS cold start. The create time is retained across IMS warm start. The output is returned from the local IMS. |
TMIM | LTimeImport | TIMESTAMP | N/A | The time that the resource was last imported, if applicable. The local import timestamp is set to be the IMS cold start time, if the resource was automatically imported from the IMSRSC repository during IMS cold start. The import time is retained across IMS warm start and emergency restart. The output is returned from the local IMS. |
TMRN | LTot_Msg_Rec_CT | STATISTICS | N/A | Total number of messages received. |
TMSN | LTot_Msg_Send_CT | STATISTICS | N/A | Total count of messages sent. |
TMUP | LTimeUpdate | TIMESTAMP | N/A | The last time the attributes of the runtime resource definition were updated as a result of the UPDATE MSLINK command. The update time is retained across warm start and emergency restart. The output value is obtained from the local IMS. |
TPT | LTot_Proc_Time | STATISTICS | N/A | Total amount of time the logical link ITASK was dispatched to be processed. This includes wait time while the ITASK was dispatched. This time is in seconds with a resolution to micro seconds. |
TQGN | LTot_Qget_CT | STATISTICS | N/A | Total count of QMGR calls issued to get messages off the queue (local or shared queues) for processing. This includes get unique (GU) and dequeue (DEQ) calls. |
TQGT | LTot_Qget_Time | STATISTICS | N/A | Total processing time for QMGR calls issued to get messages off the queue (local or shared queues) for processing. This includes get unique (GU) and dequeue (DEQ) calls. Times are calculated from the time the call was issued by the MSC ITASK, to the time the call returned from QMGR. |
TQPN | LTot_Qput_CT | STATISTICS | N/A | Total count of QMGR calls issued to put messages to the queue (local or shared queues) for processing. This includes insert (ISRT) and enqueue (ENQ) calls. |
TQPT | LTot_Qput_Time | STATISTICS | N/A | Total processing time for QMGR calls issued to put messages to the queue (local or shared queues) for processing. This includes insert (ISRT) and enqueue (ENQ) calls. Times are calculated from the time the call was issued by the MSC ITASK, to the time the call returned from QMGR. |
TRIOT | LTot_RecIO_Time | STATISTICS | N/A | Total amount of I/O time to receive messages. This is time from which the access method was called to process the receive, to the time the partner IMS access method was called to send the message. This is the time between the access method calls on each side, for the data to cross the media (for example, CTC link, memory, or network). |
TRISIOT | LTotRmtIconSendIOTime | STATISTICS | N/A | The total amount of time that the remote IMS Connect instance required to process all messages from TCP/IP and send them to the remote SCI. |
TRN | LTot_Req_CT | STATISTICS | N/A | Total count of receive I/O requests received from the access method. |
TRSSIOT | LTotRmtSciSendIOTime | STATISTICS | N/A | The total amount of time that the remote SCI instance required to process all messages from the remote IMS Connect instance and send them to the remote IMS system. |
TSIOT | LTot_SendIO_Time | STATISTICS | N/A | Total amount of I/O time to send messages. This is the time from which the access method was called to process the send, to the time the partner IMS ITASK was dispatched upon receipt of the message. This is the time between the access method calls on each side, for the data to cross the media (for example, CTC link, memory, or network). |
TSN | LTot_Send_CT | STATISTICS | N/A | Total count of send I/O requests issued to the access method. |
TTCSIOT | LTotTcpipSendIOTime | STATISTICS | N/A | The sum total of the amount of time that all messages required to travel from the local IMS Connect instance to the remote IMS Connect instance on the TCP/IP network. |
Return, reason, and completion codes
The return and reason codes that can be returned as a result of the QUERY MSLINK command are standard for all commands entered through the OM API.
The following table includes the return and reason codes and a brief explanation of the codes. The return or reason code returned for the command might also indicate an error from a CSL request.
Return code | Reason code | Meaning |
---|---|---|
X'00000000' | X'00000000' | The QUERY MSLINK command completed successfully. |
X'00000004' | X'00001010' | No resources were found to be returned because of one of the following reasons:
|
X'00000008' | X'00002040' | More than one filter value is specified on the QUERY MSLINK command. |
X'0000000C' | X'00003000' | Command was successful for some resources but failed for others. The command output contains a line for each resource, accompanied by its completion code. For details on completion codes, see Table 5. |
X'0000000C' | X'00003004' | Command was not successful for any of the resources. The command output contains a line for each resource, accompanied by its completion code. For details on completion codes, see Table 5. |
X'00000010' | X'0000400C' | Command is not valid on the XRF alternate. |
X'00000010' | X'0000401C' | Command is not valid on the FDBR region. |
X'00000010' | X'0000402D' | Command was not successful because dynamic resource definition for MSC resources is not enabled; that is, MSCRSCS=DYN is not defined in the DFSDFxxx member. |
X'00000010' | X'00004104' | No RM address space. |
X'00000010' | X'00004108' | No SCI address space. |
X'00000010' | X'00004500' | IMS is not enabled to use the IMSRSC repository. |
X'00000010' | X'00004501' | RM is not enabled with the IMSRSC repository. |
X'00000010' | X'00004502' | The IMSRSC repository is not available. |
X'00000010' | X'00004504' | IMSRSC repository spare recovery is in progress. |
X'00000010' | X'00004505' | No IMS resource list exists, or no resources for the resource type exist in the IMS resource list. |
X'00000010' | X'00004507' | IMSRSC repository access is denied. |
X'00000010' | X'00004508' | Repository maximum put length exceeded. |
X'00000010' | X'00004509' | RM data version is lower than the IMS data version. |
X'00000010' | X'0000450A' | Repository Server (RS) is being shut down. |
X'00000010' | X'0000450B' | Repository Server (RS) is not available. |
X'00000010' | X'0000450C' | Repository Server (RS) is busy. |
X'00000010' | X'0000450D' | RM failed to define some of the internal fields that are related to the IMSRSC repository. |
X'00000014' | X'00005004' | The QUERY MSLINK command processing terminated as a DFSOCMD response buffer could not be obtained. |
X'00000014' | X'00005100' | RM request error. |
X'00000014' | X'00005104' | CQS error. |
X'00000014' | X'00005108' | SCI request error. |
X'00000014' | X'00005110' | Repository error. |
X'00000014' | X'0000551C' | The
QUERY MSLINK command is rejected because the resource list is unusable. Contact
IBM Software Support with the following information:
|
Errors that are unique to the processing of this command are returned as completion codes. A completion code is returned for each action against an individual resource.
Completion code | Completion code text | Meaning |
---|---|---|
0 | The QUERY MSLINK command completed successfully for the resource. | |
10 | NO RESOURCES FOUND | MSLINK name is invalid, or the specified wildcard parameter does not match any resource names. |
Example 1 for QUERY MSLINK command
TSO SPOC input:
QUERY
MSLINK NAME(LNK12C01,LNK12V01,LNK12M01,LNK12T01) SHOW(ALL)
TSO SPOC output:
MSLink LMSLink# MbrName CC LMSPLink LCID LPID LRecdCnt LSentCnt
LNK12C01 2 IMS1 0 PLNK12C AC 0 0
LNK12M01 3 IMS1 0 PLNK12M AD 0 0
LNK12T01 22 IMS1 0 PLNK12TA TA 0 0
LNK12V01 1 IMS1 0 PLNK12V 00000000 AB 0 0
MSLink LMSLink# MbrName LDefMdtbl LBufSize LBandwidth LAffin
LNK12C01 2 IMS1 1024 OFF
LNK12M01 3 IMS1 1024 OFF
LNK12T01 22 IMS1 65536 ON
LNK12V01 1 IMS1 1024 OFF
MSLink LMSLink# MbrName LclStat LBackUp
LNK12C01 2 IMS1 STOCOMM,IDLE,NOTOPEN
LNK12M01 3 IMS1 STOCOMM,IDLE,COLDSESS
LNK12T01 22 IMS1 STOCOMM,IDLE,COLDSESS,SYNCSESS NO
LNK12V01 1 IMS1 STOCOMM,IDLE,COLDSESS,SYNCSESS NO
MSLink LMSLink# MbrName LTimeCreate
LNK12C01 2 IMS1 2014.282 15:59:39.74
LNK12M01 3 IMS1 2014.282 15:59:39.74
LNK12T01 22 IMS1 2014.282 15:59:39.74
LNK12V01 1 IMS1 2014.282 15:59:39.74
MSLink LMSLink# MbrName LTimeUpdate LTimeAccess LDefnType
LNK12C01 2 IMS1 MSCGEN
LNK12M01 3 IMS1 MSCGEN
LNK12T01 22 IMS1 MSCGEN
LNK12V01 1 IMS1 MSCGEN
OM API input:
CMD(QRY MSLINK NAME(LNK12C01,LNK12V01,LNK12M01,LNK12T01)
SHOW(ALL))
OM API output:
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2014.283 16:40:17.403520</statime>
<stotime>2014.283 16:40:17.403851</stotime>
<staseq>CDE247CF8E680574</staseq>
<stoseq>CDE247CF8E7CB0F4</stoseq>
<rqsttkn1>USRT011 10094017</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>MSLINK </kwd>
<input>QUERY MSLINK NAME(LNK12C01,LNK12V01,LNK12M01,LNK12T01) SHOW(ALL)
</input>
</cmd>
<cmdrsphdr>
<hdr slbl="MSL" llbl="MSLink" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LINKN" llbl="LMSLink#" scope="LCL" sort="a" key="2"
scroll="no" len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MSP" llbl="LMSPLink" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="CID" llbl="LCID" scope="LCL" sort="n" key="0" scroll="yes"
len="8" dtype="INT" align="left" skipb="yes" />
<hdr slbl="PID" llbl="LPID" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="CNTR" llbl="LRecdCnt" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="CNTS" llbl="LSentCnt" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="DMTB" llbl="LDefMdtbl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="AMTB" llbl="LActMdtbl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="BUFSZ" llbl="LBufSize" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="BANDW" llbl="LBandwidth" scope="LCL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="AFFIN" llbl="LAffin" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LSTT" llbl="LclStat" scope="LCL" sort="n" key="0"
scroll="yes" len="*" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="BKUP" llbl="LBackUp" scope="LCL" sort="n" key="0"
scroll="yes" len="2" dtype="CHAR" align="right" skipb="yes" />
<hdr slbl="TMCR" llbl="LTimeCreate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMUP" llbl="LTimeUpdate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMAC" llbl="LTimeAccess" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMIM" llbl="LTimeImport" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="DFNT" llbl="LDefnType" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MSL(LNK12C01) LINKN(2) MBR(IMS1) CC( 0) MSP(PLNK12C ) PID(AC)
CNTR(0) CNTS(0) BUFSZ(1024) BANDW(OFF ) LSTT(STOCOMM,IDLE,NOTOPEN)
TMCR(2014.282 15:59:39.74) DFNT(MSCGEN) </rsp>
<rsp>MSL(LNK12V01) LINKN(1) MBR(IMS1) CC( 0) MSP(PLNK12V )
CID(00000000) PID(AB) CNTR(0) CNTS(0) BUFSZ(1024) BANDW(OFF )
LSTT(STOCOMM,IDLE,COLDSESS,SYNCSESS) BKUP(NO) TMCR(2014.282
15:59:39.74) DFNT(MSCGEN) </rsp>
<rsp>MSL(LNK12M01) LINKN(3) MBR(IMS1) CC( 0) MSP(PLNK12M ) PID(AD)
CNTR(0) CNTS(0) BUFSZ(1024) BANDW(OFF ) LSTT(STOCOMM,IDLE,COLDSESS)
TMCR(2014.282 15:59:39.74) DFNT(MSCGEN) </rsp>
<rsp>MSL(LNK12T01) LINKN(22) MBR(IMS1) CC( 0) MSP(PLNK12TA) PID(TA)
DMTB( ) CNTR(0) CNTS(0) BUFSZ(65536) BANDW(ON )
LSTT(STOCOMM,IDLE,COLDSESS,SYNCSESS) BKUP(NO) TMCR(2014.282
15:59:39.74) DFNT(MSCGEN) </rsp>
</cmdrspdata>
</imsout>
Explanation: The QUERY MSLINK command is issued for one MSC logical link of each link type. Many of the possible headers are displayed.
Example 2 for QUERY MSLINK command
TSO SPOC input:
QUERY MSLINK NAME(LNK12*02) SHOW(MSNAME)
TSO SPOC output:
MSLink LMSLink# MbrName CC LMSName LSIDR LSIDL
LNK12C02 18 IMS1 0 LINK12C2 92 72
LNK12M02 9 IMS1 0 ELINK126 54 46
LNK12T02 23 IMS1 0 LINK12T2 85 75
LNK12T02 23 IMS1 0 LINK12T3 97 75
LNK12V02 10 IMS1 0 LINK12Y 90 500
LNK12V02 10 IMS1 0 LINK13V 266 2036
LNK12V02 10 IMS1 0 LINK13X 80 300
LNK12V02 10 IMS1 0 LINK12V1 20 10
LNK12V02 10 IMS1 0 LINK13V1 36 16
LNK12V02 10 IMS1 0 LINK12V 256 1012
OM API input:
CMD(QRY MSLINK NAME(LNK12*02) SHOW(MSNAME))
OM API output:
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2014.283 16:56:50.714836</statime>
<stotime>2014.283 16:56:50.715191</stotime>
<staseq>CDE24B82DA0D46F4</staseq>
<stoseq>CDE24B82DA2370F4</stoseq>
<rqsttkn1>USRT011 10095650</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>MSLINK </kwd>
<input>QRY MSLINK NAME(LNK12*02) SHOW(MSNAME) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MSL" llbl="MSLink" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LINKN" llbl="LMSLink#" scope="LCL" sort="a" key="2"
scroll="no" len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MSN" llbl="LMSName" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="SIDR" llbl="LSIDR" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="SIDL" llbl="LSIDL" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MSL(LNK12002) LINKN(5) MBR(IMS1) CC( 0) MSN(ELINK120) SIDR(26)
SIDL(16) </rsp>
<rsp>MSL(LNK12002) LINKN(5) MBR(IMS1) CC( 0) MSN(ELINK122) SIDR(29)
SIDL(19) </rsp>
<rsp>MSL(LNK12M02) LINKN(9) MBR(IMS1) CC( 0) MSN(ELINK126) SIDR(54)
SIDL(46) </rsp>
<rsp>MSL(LNK12V02) LINKN(10) MBR(IMS1) CC( 0) MSN(LINK12V1) SIDR(20)
SIDL(10) </rsp>
<rsp>MSL(LNK12V02) LINKN(10) MBR(IMS1) CC( 0) MSN(LINK13V1) SIDR(36)
SIDL(16) </rsp>
<rsp>MSL(LNK12V02) LINKN(10) MBR(IMS1) CC( 0) MSN(LINK12V ) SIDR(256)
SIDL(1012) </rsp>
<rsp>MSL(LNK12V02) LINKN(10) MBR(IMS1) CC( 0) MSN(LINK12Y ) SIDR(90)
SIDL(500) </rsp>
<rsp>MSL(LNK12V02) LINKN(10) MBR(IMS1) CC( 0) MSN(LINK13V ) SIDR(266)
SIDL(2036) </rsp>
<rsp>MSL(LNK12V02) LINKN(10) MBR(IMS1) CC( 0) MSN(LINK13X ) SIDR(80)
SIDL(300) </rsp>
<rsp>MSL(LNK12C02) LINKN(18) MBR(IMS1) CC( 0) MSN(LINK12C2) SIDR(92)
SIDL(72) </rsp>
<rsp>MSL(LNK12T02) LINKN(23) MBR(IMS1) CC( 0) MSN(LINK12T2) SIDR(85)
SIDL(75) </rsp>
<rsp>MSL(LNK12T02) LINKN(23) MBR(IMS1) CC( 0) MSN(LINK12T3) SIDR(97)
SIDL(75) </rsp>
<rsp>MSL(LNK12X02) LINKN(26) MBR(IMS1) CC( 0) MSN(LINK12X2) SIDR(88)
SIDL(78) </rsp>
</cmdrspdata>
</imsout>
Explanation: The QUERY MSLINK command is issued with a wildcard parameter to display all of the MSC logical links that match the wildcard name, and displays the MSC logical link path (MSNAME) names, local SYSID, and remote SYSIDs.
Example 3 for QUERY MSLINK command
QUERY MSLINK NAME(LNK31V02,LNK32M01,LNK32C01,LNK32T01,LNKV001) SHOW(DEFN)
TSO SPOC output:
MSLink LMSLink# MbrName CC Repo IMSid MSPLink LMSPLink PID LPID
LNKV001 IMS1 0 Y PLNKV001 ZA
LNKV001 33 IMS1 0 IMS1 PLNKV001 ZA
LNK31V02 IMS1 0 Y PLNKSON1 SA
LNK31V02 8 IMS1 0 IMS1 PLNKSON1 SA
LNK32C01 IMS1 0 Y PLNK23CA BD
LNK32C01 12 IMS1 0 IMS1 PLNK23CA BD
LNK32M01 IMS1 0 Y PLNK23M BE
LNK32M01 3 IMS1 0 IMS1 PLNK23M BE
LNK32T01 IMS1 0 Y PLNK32TA TD
LNK32T01 20 IMS1 0 IMS1 PLNK32TA TD
MSLink LMSLink# MbrName Repo DefMdtbl LDefMdtbl BufSize LBufSize
LNKV001 IMS1 Y 4096
LNKV001 33 IMS1 4096
LNK31V02 IMS1 Y MTMSCVAA 1024
LNK31V02 8 IMS1 MTMSCVAA 1024
LNK32C01 IMS1 Y 1024
LNK32C01 12 IMS1 1024
LNK32M01 IMS1 Y 1024
LNK32M01 3 IMS1 1024
LNK32T01 IMS1 Y 65536
LNK32T01 20 IMS1 65536
MSLink LMSLink# MbrName Repo Bandwidth LBandwidth ASR LASR BackUp LBackUp
LNKV001 IMS1 Y OFF OFF NO
LNKV001 33 IMS1 OFF OFF NO
LNK31V02 IMS1 Y OFF OFF NO
LNK31V02 8 IMS1 OFF OFF NO
LNK32C01 IMS1 Y OFF
LNK32C01 12 IMS1 OFF
LNK32M01 IMS1 Y OFF
LNK32M01 3 IMS1 OFF
LNK32T01 IMS1 Y ON NO
LNK32T01 20 IMS1 ON NO
MSLink LMSLink# MbrName Repo SyncOpt LSyncOpt
LNKV001 IMS1 Y SYNCSESS
LNKV001 33 IMS1 SYNCSESS
LNK31V02 IMS1 Y FORCSESS
LNK31V02 8 IMS1 FORCSESS
LNK32C01 IMS1 Y
LNK32C01 12 IMS1
LNK32M01 IMS1 Y
LNK32M01 3 IMS1
LNK32T01 IMS1 Y SYNCSESS
LNK32T01 20 IMS1 SYNCSESS
MSLink LMSLink# MbrName Repo TimeCreate LTimeCreate
LNKV001 IMS1 Y 2015.307 11:10:46.05
LNKV001 33 IMS1 2015.307 11:10:46.05
LNK31V02 IMS1 Y 2015.307 11:09:46.97
LNK31V02 8 IMS1 2015.307 11:09:46.97
LNK32C01 IMS1 Y 2015.307 11:09:46.97
LNK32C01 12 IMS1 2015.307 11:09:46.97
LNK32M01 IMS1 Y 2015.307 11:09:46.97
LNK32M01 3 IMS1 2015.307 11:09:46.97
LNK32T01 IMS1 Y 2015.307 11:09:46.97
LNK32T01 20 IMS1 2015.307 11:09:46.97
MSLink LMSLink# MbrName Repo TimeUpdate LTimeUpdate
LNKV001 IMS1 Y
LNKV001 33 IMS1
LNK31V02 IMS1 Y
LNK31V02 8 IMS1
LNK32C01 IMS1 Y
LNK32C01 12 IMS1
LNK32M01 IMS1 Y
LNK32M01 3 IMS1
LNK32T01 IMS1 Y
LNK32T01 20 IMS1
MSLink LMSLink# MbrName Repo TimeAccess
LNKV001 IMS1 Y
LNKV001 33 IMS1
LNK31V02 IMS1 Y
LNK31V02 8 IMS1
LNK32C01 IMS1 Y
LNK32C01 12 IMS1
LNK32M01 IMS1 Y
LNK32M01 3 IMS1
LNK32T01 IMS1 Y
LNK32T01 20 IMS1
CMD(QRY MSLINK NAME(LNK31V02,LNK32M01,LNK32C01,LNK32T01,LNKV001) SHOW(DEFN)
<cmd>
<master>IMS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>MSLINK </kwd>
<input>QRY MSLINK NAME(LNK31V02,LNK32M01,LNK32C01,LNK32T01,LNKV001)
SHOW(DEFN) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MSL" llbl="MSLink" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LINKN" llbl="LMSLink#" scope="LCL" sort="a" key="2"
scroll="no" len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="REPO" llbl="Repo" scope="LCL" sort="d" key="2" scroll="no"
len="1" dtype="CHAR" align="left" />
<hdr slbl="IMSID" llbl="IMSid" scope="GBL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RMSP" llbl="MSPLink" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="MSP" llbl="LMSPLink" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RPID" llbl="PID" scope="GBL" sort="n" key="0" scroll="yes"
len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="PID" llbl="LPID" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RDMTB" llbl="DefMdtbl" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="DMTB" llbl="LDefMdtbl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="AMTB" llbl="LActMdtbl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RBUFSZ" llbl="BufSize" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="BUFSZ" llbl="LBufSize" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="RBANDW" llbl="Bandwidth" scope="GBL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="BANDW" llbl="LBandwidth" scope="LCL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RASR" llbl="ASR" scope="GBL" sort="n" key="0" scroll="yes"
len="3" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ASR" llbl="LASR" scope="LCL" sort="n" key="0" scroll="yes"
len="3" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RBKUP" llbl="BackUp" scope="GBL" sort="n" key="0"
scroll="yes" len="2" dtype="CHAR" align="right" skipb="yes" />
<hdr slbl="BKUP" llbl="LBackUp" scope="LCL" sort="n" key="0"
scroll="yes" len="2" dtype="CHAR" align="right" skipb="yes" />
<hdr slbl="RSYNC" llbl="SyncOpt" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="SYNC" llbl="LSyncOpt" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RTMCR" llbl="TimeCreate" scope="GBL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMCR" llbl="LTimeCreate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="RTMUP" llbl="TimeUpdate" scope="GBL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMUP" llbl="LTimeUpdate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMAC" llbl="LTimeAccess" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMIM" llbl="LTimeImport" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="EXPN" llbl="ExportNeeded" scope="LCL" sort="y" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MSL(LNK31V02) LINKN(8) MBR(IMS1) CC( 0) MSP(PLNKSON1)
CID(00000000) PID(SA) DMTB(MTMSCVAA) CNTR(0) CNTS(0) ASR(OFF )
BUFSZ(1024) BANDW(OFF ) LSTT(STOCOMM,IDLE,COLDSESS) BKUP(NO)
SYNC(FORCSESS) TMCR(2015.307 11:09:46.97) DFNT(MSCGEN) IMSID(IMS1)
</rsp>
<rsp>MSL(LNK32M01) LINKN(3) MBR(IMS1) CC( 0) MSP(PLNK23M ) PID(BE)
CNTR(0) CNTS(0) BUFSZ(1024) BANDW(OFF ) LSTT(STOCOMM,IDLE,COLDSESS)
TMCR(2015.307 11:09:46.97) DFNT(MSCGEN) IMSID(IMS1) </rsp>
<rsp>MSL(LNK32C01) LINKN(12) MBR(IMS1) CC( 0) MSP(PLNK23CA) PID(BD)
CNTR(0) CNTS(0) BUFSZ(1024) BANDW(OFF ) LSTT(STOCOMM,IDLE,NOTOPEN)
TMCR(2015.307 11:09:46.97) DFNT(MSCGEN) IMSID(IMS1) </rsp>
<rsp>MSL(LNK32T01) LINKN(20) MBR(IMS1) CC( 0) MSP(PLNK32TA) PID(TD)
CNTR(0) CNTS(0) BUFSZ(65536) BANDW(ON ) LSTT(STOCOMM,IDLE,COLDSESS)
BKUP(NO) SYNC(SYNCSESS) TMCR(2015.307 11:09:46.97) DFNT(MSCGEN)
IMSID(IMS1) </rsp>
<rsp>MSL(LNKV001 ) LINKN(33) MBR(IMS1) CC( 0) MSP(PLNKV001)
CID(00000000) PID(ZA) CNTR(0) CNTS(0) ASR(OFF ) BUFSZ(4096) BANDW(OFF
) LSTT(STOCOMM,IDLE,COLDSESS) BKUP(NO) SYNC(SYNCSESS) TMCR(2015.307
11:10:46.05) DFNT(CREATE) IMSID(IMS1) </rsp>
<rsp>MSL(LNK31V02) MBR(IMS1 ) CC( 0) REPO(Y) IMSID() RASR(OFF)
RBKUP(NO) RBANDW(OFF) RBUFSZ(1024) RDMTB(MTMSCVAA) RMSP(PLNKSON1)
RPID(SA) RSYNC(FORCSESS) RTMCR(2015.307 11:09:46.97) </rsp>
<rsp>MSL(LNK32M01) MBR(IMS1 ) CC( 0) REPO(Y) IMSID() RASR()
RBANDW(OFF) RBUFSZ(1024) RMSP(PLNK23M ) RPID(BE) RSYNC()
RTMCR(2015.307 11:09:46.97) </rsp>
<rsp>MSL(LNK32C01) MBR(IMS1 ) CC( 0) REPO(Y) IMSID() RASR()
RBANDW(OFF) RBUFSZ(1024) RMSP(PLNK23CA) RPID(BD) RSYNC()
RTMCR(2015.307 11:09:46.97) </rsp>
<rsp>MSL(LNK32T01) MBR(IMS1 ) CC( 0) REPO(Y) IMSID() RASR()
RBKUP(NO) RBANDW(ON ) RBUFSZ(65536) RMSP(PLNK32TA) RPID(TD)
RSYNC(SYNCSESS) RTMCR(2015.307 11:09:46.97) </rsp>
<rsp>MSL(LNKV001 ) MBR(IMS1 ) CC( 0) REPO(Y) IMSID() RASR(OFF)
RBKUP(NO) RBANDW(OFF) RBUFSZ(4096) RMSP(PLNKV001) RPID(ZA)
RSYNC(SYNCSESS) RTMCR(2015.307 11:10:46.05) </rsp>
</cmdrspdata>
Explanation: The QUERY command displays all four types of MSC logical links, including one that is dynamically created and one that has a mode table defined, so that all possible local and repository definition headers are displayed for all eight MSLINK attributes.
Example 4 for QUERY MSLINK command
QUERY MSLINK NAME(LNK12C01,LNK12M01) SHOW(EXPORTNEEDED)
MSLink LMSLink# MbrName CC ExportNeeded
LNK12C01 2 IMS1 0 N
LNK12M01 3 IMS1 0 N
CMD(QRY MSLINK NAME(LNK12V01,LNK12M01) SHOW(EXPORTNEEDED)
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2015.322 22:08:27.436635</statime>
<stotime>2015.322 22:08:27.436888</stotime>
<staseq>CFDE82A7A765B1CA</staseq>
<stoseq>CFDE82A7A77584CA</stoseq>
<rqsttkn1>USRT011 10140827</rqsttkn1>
<rc>02000004</rc>
<rsn>00001014</rsn>
<rsnmsg>CSLN055I</rsnmsg>
<rsntxt>At least one request completed with warning/s.</rsntxt>
</ctl>
<cmderr>
<mbr name="IMS1 ">
<typ>IMS </typ>
<styp>DBDC </styp>
<rc>00000004</rc>
<rsn>00001010</rsn>
<rsntxt>No resources or matches found</rsntxt>
</mbr>
</cmderr>
<cmd>
<master>IMS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>MSLINK </kwd>
<input>QRY MSLINK NAME(LNK12C01,LNK12M01) SHOW(EXPORTNEEDED) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MSL" llbl="MSLink" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LINKN" llbl="LMSLink#" scope="LCL" sort="a" key="2"
scroll="no" len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="EXPN" llbl="ExportNeeded" scope="LCL" sort="y" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MSL(LNK12C01) LINKN(2) MBR(IMS1) CC( 0) EXPN(N) </rsp>
<rsp>MSL(LNK12M01) LINKN(3) MBR(IMS1) CC( 0) EXPN(N) </rsp>
</cmdrspdata>
Explanation:
This QUERY command displays whether export is needed for two MSC logical links
that do not need to be exported. The resulting two lines of output have a completion code of zero,
but a non-zero reason code of 1010 and reason text of No resources or matches found
are returned.
Example 5: Querying statistics for a TCP/IP link
In this example, the QUERY MSLINK command is issued twice against the TCP/IP link LNK12T01: first with SHOW(ALL) specified to view the buffer size and second to view the statistics.
For this example, the Batch SPOC utility (CSLUSPOC) was used and configured to print the output in a column format by specifying F=BYCOL in the JCL.
TSO SPOC input to display the buffer size for the link:
QUERY MSLINK NAME(LNK12T01) SHOW(ALL)
TSO SPOC output that shows the link buffer size. For TCP/IP links, the bandwidth mode is always on.
MSLink LMSLink# MbrName CC LMSPLink LPID LRecdCnt LSentCnt LDefMdtbl
LNK12T01 22 IMS1 0 PLNK12TA TA 0 0
MSLink LMSLink# MbrName LBufSize LBandwidth LAffin
LNK12T01 22 IMS1 65536 ON
MSLink LMSLink# MbrName LclStat LBackUp
LNK12T01 22 IMS1 STOCOMM,IDLE,COLDSESS,SYNCSESS NO
MSLink LMSLink# MbrName LTimeCreate
LNK12T01 22 IMS1 2014.282 15:59:39.74
MSLink LMSLink# MbrName LTimeUpdate LTimeAccess LDefnType
LNK12T01 22 IMS1 MSCGEN
OM API input to display the buffer size for the link:
CMD(QRY MSLINK NAME(LNK12T01) SHOW(ALL))
OM API output that shows the link buffer size:
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2014.283 17:01:21.646214</statime>
<stotime>2014.283 17:01:21.646548</stotime>
<staseq>CDE24C853B68666A</staseq>
<stoseq>CDE24C853B7D416A</stoseq>
<rqsttkn1>USRT011 10100121</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>MSLINK </kwd>
<input>QUERY MSLINK NAME(LNK12T01) SHOW(ALL) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MSL" llbl="MSLink" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LINKN" llbl="LMSLink#" scope="LCL" sort="a" key="2"
scroll="no" len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="INT" align="right" skipb="no" />
<hdr slbl="MSP" llbl="LMSPLink" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="CID" llbl="LCID" scope="LCL" sort="n" key="0" scroll="yes"
len="8" dtype="INT" align="left" skipb="yes" />
<hdr slbl="PID" llbl="LPID" scope="LCL" sort="n" key="0" scroll="yes"
len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="CNTR" llbl="LRecdCnt" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="CNTS" llbl="LSentCnt" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="DMTB" llbl="LDefMdtbl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="AMTB" llbl="LActMdtbl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="BUFSZ" llbl="LBufSize" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="INT" align="right" skipb="yes" />
<hdr slbl="BANDW" llbl="LBandwidth" scope="LCL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="AFFIN" llbl="LAffin" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="LSTT" llbl="LclStat" scope="LCL" sort="n" key="0"
scroll="yes" len="*" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="BKUP" llbl="LBackUp" scope="LCL" sort="n" key="0"
scroll="yes" len="2" dtype="CHAR" align="right" skipb="yes" />
<hdr slbl="TMCR" llbl="LTimeCreate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMUP" llbl="LTimeUpdate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMAC" llbl="LTimeAccess" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="no" />
<hdr slbl="TMIM" llbl="LTimeImport" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="DFNT" llbl="LDefnType" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MSL(LNK12T01) LINKN(22) MBR(IMS1) CC( 0) MSP(PLNK12TA) PID(TA)
DMTB( ) CNTR(0) CNTS(0) BUFSZ(65536) BANDW(ON )
LSTT(STOCOMM,IDLE,COLDSESS,SYNCSESS) BKUP(NO) TMCR(2014.282
15:59:39.74) DFNT(MSCGEN) </rsp>
</cmdrspdata>
</imsout>
TSO SPOC input to display the link statistics:
QUERY MSLINK NAME(LNK12T01) SHOW(STATISTICS)
The TSO SPOC output of the link statistics for a TCP/IP link:
Response for: QUERY MSLINK NAME(LNK12T01) SHOW(STATISTICS)
MSLink MSLink# MbrName CC Option Start_Time Tot_Disp_CT Tot_Proc_Time Hi_Proc_Time
-------- ------- -------- ---- ---------------- -------------------- ----------- ------------- ------------
LNK12T01 22 IMS1 0 RESET,CHKPT 2010.209 11:52:59.39 16 0.020195 0.004190
MSLink MSLink# MbrName Low_Proc_Time Avg_Proc_Time Chkw_CT ChkwIO_CT Chkw_Rate Tot_Send_CT Tot_Msg_Send_CT
-------- ------- -------- ------------- ------------- -------- --------- --------- ----------- ---------------
LNK12T01 22 IMS1 0.000235 0.001262 5 2 0.000000 5 2
MSLink MSLink# MbrName Tot_MsgByte_Send_CT Tot_Byte_Send_CT Hi_Msg_Send_SZ Low_Msg_Send_SZ Avg_Msg_Send_SZ
-------- ------- -------- ------------------- ---------------- -------------- --------------- ---------------
LNK12T01 22 IMS1 1,040 2,816 538 502 520
MSLink MSLink# MbrName Send_Msg_Time Send_MsgCT_Rate Send_MsgByte_Rate Tot_Qget_CT Tot_Qget_Time Hi_Qget_Time
-------- ------- -------- ------------- --------------- ----------------- ----------- ------------- ------------
LNK12T01 22 IMS1 47.917786 30.472011 15,845.445957 6 0.000129 0.000043
MSLink MSLink# MbrName Low_Qget_Time Avg_Qget_Time Tot_SendIO_Time Hi_SendIO_Time Low_SendIO_Time SendIO_Req_Rate
-------- ------- -------- ------------- ------------- --------------- -------------- --------------- ---------------
LNK12T01 22 IMS1 0.000004 0.000021 0.052853 0.016744 0.011833 94.602009
MSLink MSLink# MbrName SendIO_Byte_Rate Tot_Loc_SCI_SendIO_Time Hi_Loc_SCI_SendIO_Time Low_Loc_SCI_SendIO_Time
-------- ------- -------- ---------------- ----------------------- ---------------------- -----------------------
LNK12T01 22 IMS1 53,279.851664 0.001503 0.000988 0.000103
MSLink MSLink# MbrName Tot_Loc_ICON_SendIO_Time Hi_Loc_ICON_SendIO_Time Low_Loc_ICON_SendIO_Time
-------- ------- -------- ------------------------ ----------------------- ------------------------
LNK12T01 22 IMS1 0.023818 0.008290 0.004861
MSLink MSLink# MbrName Tot_TCPIP_SendIO_Time Hi_TCPIP_SendIO_Time Low_TCPIP_SendIO_Time Tot_Rmt_ICON_SendIO_Time
-------- ------- -------- --------------------- -------------------- --------------------- ------------------------
LNK12T01 22 IMS1 0.003279 0.001210 0.000506 0.019013
MSLink MSLink# MbrName Hi_Rmt_ICON_SendIO_Time Low_Rmt_ICON_SendIO_Time Tot_Rmt_SCI_SendIO_Time
-------- ------- -------- ----------------------- ------------------------ -----------------------
LNK12T01 22 IMS1 0.005403 0.004312 0.005240
MSLink MSLink# MbrName Hi_Rmt_SCI_SendIO_Time Low_Rmt_SCI_SendIO_Time Tot_Rec_CT Tot_Msg_Rec_CT
-------- ------- -------- ---------------------- ----------------------- ---------- --------------
LNK12T01 22 IMS1 0.005403 0.004312 5 3
MSLink MSLink# MbrName Tot_MsgByte_Rec_CT Tot_Byte_Rec_CT Hi_Msg_Rec_SZ Low_Msg_Rec_SZ Avg_Msg_Rec_SZ
-------- ------- -------- ------------------ --------------- ------------- -------------- --------------
LNK12T01 22 IMS1 1,595 3,419 549 502 531
MSLink MSLink# MbrName Rec_Msg_Time Tot_Qput_CT Tot_Qput_Time Hi_Qput_Time Low_Qput_Time Avg_Qput_Time
-------- ------- -------- ------------ ----------- ------------- ------------ ------------- -------------
LNK12T01 22 IMS1 235.933123 0 0.000000 0.000000 0.000000 0.000000
MSLink MSLink# MbrName Tot_RecIO_Time Hi_RecIO_Time Low_RecIO_Time RecIO_Req_Rate RecIO_Byte_Rate
-------- ------- -------- -------------- ------------- -------------- -------------- ---------------
LNK12T01 22 IMS1 0.053281 0.014511 0.012323 93.842082 64,169.216043
Example 6: Querying statistics for VTAM links
Explanation: In this example, the QUERY MSLINK command is issued twice: once in the IMS systems at each end of the VTAM link. The commands were issued after each side sent 10 remote transactions that processed and sent a response message back (10 transactions + 10 responses = 20 messages sent each direction).
TSO SPOC input:
QUERY MSLINK NAME(LNK12V02) SHOW(STATISTICS)
TSO SPOC output:
(screen 1)
MSLink LMSLink# MbrName CC LOption LStart_Time
LNK12V02 10 IMS1 0 NORESET,CHKPT 2006.261 19:03:58.77
(scrolled to the right, screen 2)
MSLink LMSLink# MbrName LTot_Disp_CT LTot_Proc_Time LHi_Proc_Time LLow_Proc_Time LAvg_Proc_Time
LNK12V02 10 IMS1 98 0.176661 0.059530 0.000003 0.000853
(scrolled to the right, screen 3)
MSLink LMSLink# MbrName LChkw_CT LChkwIO_CT LChkw_Rate LTot_Send_CT LTot_Msg_Send_CT
LNK12V02 10 IMS1 33 33 0.165016 26 20
(scrolled to the right, screen 4)
MSLink LMSLink# MbrName LTot_MsgByte_Send_CT LTot_Byte_Send_CT LHi_Msg_Send_SZ LLow_Msg_Send_SZ
LNK12V02 10 IMS1 10,461 22,403 578 502
(scrolled to the right, screen 5)
MSLink LMSLink# MbrName LAvg_Msg_Send_SZ LSend_Msg_Time LTot_Qget_CT LTot_Qget_Time LHi_Qget_Time
LNK12V02 10 IMS1 523 2.408548 51 0.002054 0.001070
(scrolled to the right, screen 6)
MSLink LMSLink# MbrName LLow_Qget_Time LAvg_Qget_Time LTot_SendIO_Time LHi_SendIO_Time
LNK12V02 10 IMS1 0.000004 0.000040 0.505401 0.193435
(scrolled to the right, screen 7)
MSLink LMSLink# MbrName LLow_SendIO_Time LSendIO_Req_Rate LSendIO_Byte_Rate LTot_Rec_CT
LNK12V02 10 IMS1 0.000708 51.444298 44,327 26
(scrolled to the right, screen 8)
MSLink LMSLink# MbrName LTot_Msg_Rec_CT LTot_MsgByte_Rec_CT LTot_Byte_Rec_CT LHi_Msg_Rec_SZ
LNK12V02 10 IMS1 20 10,503 22,445 584
(scrolled to the right, screen 9)
MSLink LMSLink# MbrName LLow_Msg_Rec_SZ LAvg_Msg_Rec_SZ LRec_Msg_Time LTot_Qput_CT LTot_Qput_Time
LNK12V02 10 IMS1 502 525 2.320062 40 0.037326
(scrolled to the right, screen 10)
MSLink LMSLink# MbrName LHi_Qput_Time LLow_Qput_Time LAvg_Qput_Time LTot_RecIO_Time LHi_RecIO_Time
LNK12V02 10 IMS1 0.015957 0.000008 0.000933 0.070947 0.025376
(scrolled to the right, screen 11)
MSLink LMSLink# MbrName LLow_RecIO_Time LRecIO_Req_Rate LRecIO_Byte_Rate
LNK12V02 10 IMS1 0.000155 366.470750 148,040.09
TSO SPOC input:
QUERY MSLINK NAME(LNK21V02) SHOW(STATISTICS)
TSO SPOC output:
(scrolled to the right, screen 1)
MSLink LMSLink# LMbrName CC LOption LStart_Time
LNK21V02 13 IMS2 0 NORESET,CHKPT 2006.261 19:03:08.42
(scrolled to the right, screen 2)
MSLink LMSLink# MbrName LTot_Disp_CT LTot_Proc_Time LHi_Proc_Time LLow_Proc_Time LAvg_Proc_Time
LNK21V02 13 IMS2 97 0.150468 0.060122 0.000003 0.000696
(scrolled to the right, screen 3)
MSLink LMSLink# MbrName LChkw_CT LChkwIO_CT LChkw_Rate LTot_Send_CT LTot_Msg_Send_CT
LNK21V02 13 IMS2 33 33 0.544554 26 20
(scrolled to the right, screen 4)
MSLink LMSLink# MbrName LTot_MsgByte_Send_CT LTot_Byte_Send_CT LHi_Msg_Send_SZ LLow_Msg_Send_SZ
LNK21V02 13 IMS2 10,503 22,445 584 502
(scrolled to the right, screen 5)
MSLink LMSLink# MbrName LAvg_Msg_Send_SZ LSend_Msg_Time LTot_Qget_CT LTot_Qget_Time LHi_Qget_Time
LNK21V02 13 IMS2 525 2.395508 51 0.003884 0.001169
(scrolled to the right, screen 6)
MSLink LMSLink# MbrName LLow_Qget_Time LAvg_Qget_Time LTot_SendIO_Time LHi_SendIO_Time
LNK21V02 13 IMS2 0.000004 0.000076 1.304330 0.217838
(scrolled to the right, screen 7)
MSLink LMSLink# LMbrName LLow_SendIO_Time LSendIO_Req_Rate LSendIO_Byte_Rate LTot_Rec_CT
LNK21V02 13 IMS2 0.000821 19.933605 17,208 26
(scrolled to the right, screen 8)
MSLink LMSLink# MbrName LTot_Msg_Rec_CT LTot_MsgByte_Rec_CT LTot_Byte_Rec_CT LHi_Msg_Rec_SZ
LNK21V02 13 IMS2 20 10,461 22,403 578
(scrolled to the right, screen 9)
MSLink LMSLink# MbrName LLow_Msg_Rec_SZ LAvg_Msg_Rec_SZ LRec_Msg_Time LTot_Qput_CT LTot_Qput_Time
LNK21V02 13 IMS2 502 523 2.344878 40 0.054777
(scrolled to the right, screen 10)
MSLink LMSLink# MbrName LHi_Qput_Time LLow_Qput_Time LAvg_Qput_Time LTot_RecIO_Time LHi_RecIO_Time
LNK21V02 13 IMS2 0.023559 0.000007 0.001369 0.210252 0.036846
(scrolled to the right, screen 11)
MSLink LMSLink# MbrName LLow_RecIO_Time LRecIO_Req_Rate LRecIO_Byte_Rate
LNK21V02 13 IMS2 0.000155 123.661130 106,553