MSNAME macro

The MSNAME macro provides a name for the remote and local system identifications that it represents. The MSNAME macro can be followed by one or more NAME macros that define remote logical terminals. MSNAMEs are also referred to as logical link paths.

Dynamic definition

Logical link path names for remote and local MSC systems can be defined dynamically with the CREATE MSNAME command, instead of defining them statically with the system definition MSNAME macro.

Supported environments

The MSNAME macro can be used in the DB/DC and DCCTL environments.

Syntax

Figure 0.
Read syntax diagramSkip visual syntax diagramlabelMSNAMESYSID=( remote system identification, local system identification )

Label field

The label field msname is a one- to eight-character alphanumeric name used externally in commands. Link names, msname, transaction codes, and logical terminal names, collectively, cannot contain duplicates. Specifying the msname label field is required.

Positional parameters

The MSNAME macro does not include positional parameters.

Keyword parameters

To find which parameters apply to your IMS configuration, refer to Selecting the appropriate macros to define your system.

SYSID=
remote system identification identifies the remote system that is represented by this name.
remote system identification specification must not have been previously defined as:
  • A remote system identification within a previous MSNAME macro statement.
  • A local system identification within an APPLCTN, TRANSACT, or MSNAME macro statement.

The local system identification specifies the system identification that is to be used for routing messages back to this system.

local system identification specification must not have been previously defined as a remote system identification within a previous MSNAME macro statement.

Values from 1 through 2036 are valid.

You can change the local or remote system IDs of the SYSID= keyword by using the type-2 command UPDATE MSNAME NAME(msname) SET(SIDR(remote_SID), SIDL(local_SID)).

A one-to-one relationship exists between remote SYSIDs and MSNAMEs. APPLCTN and TRANSACT macro statements must refer to remote SYSIDs specified in MSNAME statements in the same system definition when defining remote applications.