IMS Version 9

/MSASSIGN

Format

Read syntax diagramSkip visual syntax diagram>>-+-/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-'

Environments and Keywords

Table 80 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 80. Valid Environments for the /MSASSIGN Command and Keywords
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

Usage

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.

LINK
Specifies the logical link in a multiple system 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.

LOCAL
Specifies the local system. that is the subsystem in which the command is issued. The command /MSASSIGN TRANSACTION p1 TO LOCAL assigns transaction p1 to the local system.
MSNAME
Specifies the logical link path in a multiple systems configuration.
MSPLINK
Specifies the physical link in a multiple subsystem configuration.

The command /MSASSIGN LINK p1 MSPLINK p2 assigns the logical link p1 to the physical link p2 for input and output purposes.

SYSID
Specifies the system identification of a remote system in a multiple system configuration. Remote SYSIDs can be assigned to logical links for output purposes. More than one SYSID (=MSNAME) can be assigned to one logical link. A remote SYSID (=MSNAME) cannot be assigned to another logical link if a message is currently transmitting on the connection corresponding to this SYSID. Therefore, the logical link must be stopped and idle for this assignment.
TRANSACTION
Specifies the transaction to be assigned to either the local or the remote system.

For successful completion of the command:

/MSASSIGN TRANSACTION cannot be used for the CPI Communications driven transaction program.

Examples

Example 1 for /MSASSIGN Command

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.

Example 2 for /MSASSIGN Command

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.

Example 3 for /MSASSIGN Command

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.

Example 4 for /MSASSIGN Command

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.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004