Defining the IBM MQ local NetBIOS name

The local NetBIOS name used by IBM MQ channel processes can be specified in three ways.

In order of precedence the three ways are:

1. The value specified in the -l parameter of the RUNMQLSR command, for example:

   RUNMQLSR -t NETBIOS -l my_station
   

2. The MQNAME environment variable with a value that is established by the command:

   SET MQNAME= my_station
   

   We can set the MQNAME value for each process. Alternatively, we can set it at a system level in the Windows registry.

   If we are using a NetBIOS implementation that requires unique names, we must issue a SET MQNAME command in each window in which an IBM MQ process is started. The MQNAME value is arbitrary but it must be unique for each process.

3. The NETBIOS stanza in the queue manager configuration file qm.ini. For example:

   NETBIOS:
   
   LocalName= my_station
   

Note:

1. Due to the variations in implementation of the NetBIOS products supported, we are advised to make each NetBIOS name unique in the network. If we do not, unpredictable results might occur. If you have problems establishing a NetBIOS channel and there are error messages in the queue manager error log showing a NetBIOS return code of X'15', review your use of NetBIOS names.
2. On Windows, we cannot use your machine name as the NetBIOS name because Windows already uses it.
3. Sender channel initiation requires that a NetBIOS name be specified either by using the MQNAME environment variable or the LocalName in the qm.ini file.

Parent topic: Defining a NetBIOS connection on Windows