/MSASSIGN command

Subsections:

• Environment
• Syntax
• Keywords
• Usage notes
• Equivalent IMS type-2 commands
• Examples

Environment

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

Syntax

>>-+-/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-'     

Keywords

The following keywords are valid for the /MSASSIGN command:

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 TRAN 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.

TRAN

Specifies the transaction to be assigned to either the local or the remote system.

For successful completion of the command:

• The transactions must be stopped.
• When assigning a remote transaction to local, a local APPLCTN macro (no SYSID parameter) for the corresponding program (PSB) must have been included in the system definition. There must be a local as well as a remote PSB of the same name defined during system definition.

The /MSASSIGN TRAN command cannot be used for the CPI Communications driven transaction program.

Usage notes

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.

The /MSASSIGN TRAN tranname TO LOCAL command sets the remote system ID to be the same as the local system ID. It is equivalent to the command UPDATE TRAN NAME(tranname) SET(REMOTE(N),SIDR(localsysid),SIDL(localsysid)).

This command can be issued to an IMSplex by using the Batch SPOC utility.

Equivalent IMS type-2 commands

The following table shows variations of the /MSASSIGN command and the IMS type-2 commands that perform similar functions.