/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.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/MSVERIFY | X | X | |
MSNAME | X | X | |
SYSID | X | X |
Syntax
>>-+-/MSVERIFY-+--+-MSNAME--msname-+--------------------------->< '-/MSV------' '-SYSID--sysid#--'
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.
- 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
/MSVERIFY MSNAME ABC
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.
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.
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.
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.
DFS2236I MSVERIFY COMMAND IN PROGRESS FOR REMOTE
SYSIDS 005,006,007,008 dddddd
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
/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.
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:
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:
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.
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.