/MSVERIFY command

The /MSVERIFY command verifies local transactions and local LTERMs for corresponding remote transactions and remote LTERMs.

The /MSVERIFY command also verifies the consistency of the attributes of corresponding transactions. For instance, Fast Path exclusive transactions cause an error message to be returned because the transactions can only be processed as local transactions. Defined paths that are usable between the two systems can also be verified with this command.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /MSVERIFY command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/MSVERIFY X   X
MSNAME X   X
SYSID X   X

Syntax

Read syntax diagramSkip visual syntax diagram/MSVERIFY/MSVMSNAMEmsnameSYSIDsysid#

Keywords

The following keywords are valid for the /MSVERIFY command:

MSNAME
Specifies the logical link path in a multiple systems configuration.
SYSID
Specifies the remote system identification of a system in a multiple systems configuration.

Usage notes

The IMS Multiple Systems Verification utility is run offline following system definition. The /MSVERIFY command is used during online execution when verification of two systems is desired, such as after an /MSASSIGN command has been entered.

Restrictions: The /MSVERIFY command has the following restrictions:
  • Only one remote system can be specified for each /MSVERIFY command.
  • The /MSVERIFY command does not apply to Intersystem Communication (ISC) or directed routing.

Examples

The following are examples of the /MSVERIFY command:

Example 1 for /MSVERIFY command

Entry ET: 
  /MSVERIFY MSNAME ABC
Response ET: 
  DFS2234I MSVERIFY COMMAND IN PROGRESS FOR LOCAL
  SYSIDS 001,002,003,004 dddddd

Explanation: Assume SYSID numbers 001 through 004 are defined as local in the input system. dddddd is the time stamp.

Response ET: 
  DFS2243 TA11A IS NOT DEFINED AS TRANSACTION
  IN BOTH SYSTEMS.

Explanation: TA11A is defined as a remote transaction in one system but is not defined as a transaction in the partner system.

Response ET: 
  DFS2237I MSVERIFY COMPLETED FOR LOCAL SYSID 001
  dddddd

Explanation: Verification of local SYSID 001 is completed. The response message is repeated for local SYSIDs 002, 003, and 004 if all verify. dddddd is the time stamp.

Response ET: 
  DFS2235I  SYSID 004 IS DEFINED AS LOCAL IN BOTH
  SYSTEMS.  dddddd

Explanation: SYSID 004 has no corresponding remote SYSID. dddddd is the time stamp.

Remote SYSIDs are processed next.

Response ET: 
  DFS2236I MSVERIFY COMMAND IN PROGRESS FOR REMOTE
  SYSIDS 005,006,007,008 dddddd
Response ET: 
  DFS2237I MSVERIFY COMPLETED FOR SYSID 005
  dddddd

Explanation: The verification of one remote SYSID is completed. The response is repeated for remote SYSIDs 006, 007, and 008 if all verify. dddddd is the time stamp.

Example 2 for /MSVERIFY command

Entry ET: 
  /MSVERIFY SYSID 8

Explanation: The input system sends a list of its local SYSIDs to the remote system and then displays the following message on the input terminal.

Response ET: 
  DFS2234I MSVERIFY COMMAND IN PROGRESS FOR LOCAL SYSIDS
  001, 002, 003, 004 dddddd

Explanation: Assume SYSID numbers 001 through 004 are defined as local in the input system.

As the input system completes processing of the information returned for each of the input system's local SYSIDs, the following message is displayed on the input terminal:

Response RT: 
  DFS2237I MSVERIFY COMPLETED FOR SYSID 001
  dddddd

Explanation: The verification of local SYSID 001 is completed. The response message is repeated for local SYSIDs 002, 003, 004 if all verify. Verification is complete only if a DFS2237I message is received for every SYSID identified in the DFS2234I message. Definition and assignment errors can cause conditions that prevent these messages from being returned. Stopped or unassigned links can also prevent the return of the message. dddddd is the time stamp.

Remote SYSIDs are processed next. The input system sends all its pertinent information related to the remote system's local SYSIDs and displays the following message:

Response ET: 
  DFS2236I MSVERIFY COMMAND IN PROGRESS FOR REMOTE
  SYSIDs 005, 006, 007, and 008 dddddd

As the remote system completes processing of the information it received for each of its local SYSIDs, the following message is displayed on the input terminal. dddddd is the time stamp.

Response ET: 
  DFS2237I MSVERIFY COMPLETED FOR SYSID 005
  dddddd

Explanation: The verification of one remote SYSID is complete. The last response message is repeated for remote SYSIDs 006, 007, 008 if all verify. dddddd is the time stamp.