[Windows]

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
    

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

    If you are using a NetBIOS implementation that requires unique names, you 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, you are advised to make each NetBIOS name unique in the network. If you 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, you 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.