>>-+-/MSASSIGN-+------------------------------------------------> '-/MSA------' .-------. V | >--+-LINK----link#-+--+----+--MSPLINK--msplinkname--+---------->< | '-TO-' | +-MSNAME--msname--+----+--LINK--link#------------+ | '-TO-' | +-SYSID--sysid#--+----+--LINK--link#-------------+ | '-TO-' | | .----------. | | V | | '-TRAN--+---tranname-+-+--TO--+-LOCAL----------+-' '-ALL----------' '-MSNAME--msname-'
Table 80 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/MSASSIGN | X | X | |
LINK | X | X | |
LOCAL | X | X | |
MSNAME | X | X | |
MSPLINK | X | X | |
SYSID | X | X | |
TRAN | X | X |
The /MSASSIGN command alters the assignments of the following multisystem resources: LINK, MSPLINK, MSNAME, and SYSID. These assignments include logical link to physical link, remote system identification (SYSID) to logical link, logical link path (MSNAME) to logical link, and transaction to a local or remote system.
All changes made by an /MSASSIGN command remain until changed with another /MSASSIGN command or an IMS cold start is performed. After the /MSASSIGN command is used, /MSVERIFY should be used to ensure that the assignment produced a valid configuration.
Logical links can be assigned to physical links for input/output purposes. Only one logical link at a time can be assigned to a physical link (except for VTAM MSPLINKs, which can have multiple logical links assigned to them). The logical link must be stopped and idle for this assignment. Systems can only communicate with each other across a logical link established through specification of the same partner ID in both systems.
This type of assignment must be synchronized between the master terminal operators of the two systems. If a connection becomes inoperable while a transmission is in progress, this type of assignment allows switching to an alternate connection and proceeding with the unfinished transmission.
The command /MSASSIGN LINK p1 MSPLINK p2 assigns the logical link p1 to the physical link p2 for input and output purposes.
For successful completion of the command:
/MSASSIGN TRANSACTION cannot be used for the CPI Communications driven transaction program.
Entry ET:
/MSASSIGN LINK 2 TO MSPLINK BBB
Response ET:
DFS058I MSASSIGN COMMAND COMPLETED
Explanation: The input system now has a logical connection to physical link BBB for all the SYSIDs assigned to link 2.
Entry ET:
/MSASSIGN MSNAME BOSTON TO LINK 3
Response ET:
DFS058I MSASSIGN COMMAND COMPLETED
Explanation: The MSNAME BOSTON and its associated SYSID (19) have been reassigned to link 3. Link 3 can be used to associate all its SYSIDs with a main storage-to-main storage connection as opposed to a channel-to-channel or a bisynchronous connection.
Entry ET:
/MSASSIGN SYSID 19 TO LINK 2
Response ET:
DFS058I MSASSIGN COMMAND COMPLETED
Explanation: SYSID 19 might have been originally assigned to link 1 in the remote system and known by the MSNAME of CHICAGO. In this example, SYSID 19 (CHICAGO) is reassigned to link 2. This assignment can be made when both link 1 and link 2 are connected to the same two IMS systems and link 1 is inoperable.
Entry ET:
/MSASSIGN TRANSACTION XYZ TO MSNAME LNKY
Response ET:
DFS058I MSASSIGN COMMAND COMPLETED
Explanation: Local and remote SYSIDs of transaction XYZ are assigned to the link associated with MSNAME LNKY.