MQ Visual Browse

Chapter 10 Proxy UserId List

Proxy UserId List.

This section will describe how to create a Proxy UserId List and how to enable it with MQ Visual Browse. A Proxy UserId is useful when the MQAdministrator does not want to define a workstation UserId on the server where the queue manager is located.

To create a Proxy UserId on the server where the queue manager is located, please follow the Operating System's instructions. Once done, the user may now create the Proxy UserId List for MQ Visual Browse to use.

Lets assume 3 Proxy UserIds were create on the server (i.e. pu1, pu2 and pu3). Now you need to map the real UserId to the Proxy UserIds. If you have 6 users called: Fred, Barney, Wilma, Betty, Pebbles and BamBam then create a file called ProxyList.txt with the following entries:

    fred = pu1
    barney = pu3
    wilma = pu2
    betty = pu2
    pebbles = pu3
    bambam = pu3
    

Note: UserIds in the Proxy UserId list are case sensitive.

As you can see, Fred is only user that is mapped to the Proxy UserId of pu1. Wilma and Betty are mapped to the Proxy UserId of pu2 and Barney, Pebbles and BamBam are mapped to the Proxy UserId of pu3.

Therefore, when the Proxy UserId List is actived in MQ Visual Browse, ALL MQ API calls will be done under the Proxy UserId. If a UserId is not found in the Proxy UserId List then the regular logged on UserId will be used. You may define a default "catch all" UserId called: DefaultProxyUserId. When this entry is defined in the Proxy UserId List then if a UserId is not found in the Proxy UserId List, the DefaultProxyUserId will be used.

    Example:
    fred = pu1
    barney = pu3
    wilma = pu2
    betty = pu2
    pebbles = pu3
    bambam = pu3
    DefaultProxyUserId = pu3
    

To active a Proxy UserId List, update the mqvb.bat file or the mqvb.sh script with a JVM environment variable called ProxyList. The ProxyList (JVM environment variable) will contain the full path and file name of the Proxy UserId List.

    Example: mqvb.bat
    start javaw -Xms64m -Xmx512m -DProxyList=H:\test\proxylist.txt biz.capitalware.mqvb.MQVB
    
    Example: mqvb.sh
    java -Xms64m -Xmx512m -DProxyList=/apps/test/proxylist.txt biz.capitalware.mqvb.MQVB
    
    Two important points:
  • When the Proxy UserId List is actived in MQ Visual Browse, the user can no longer change / update their UserId in MQ Visual Browse's Preferences dialog box.
  • From an administration point of view, the users should ONLY have read access to the Proxy UserId List and also MQ Visual Browse's install directory.

 




Copyright © 2002-2008 Capitalware Inc.  All Rights Reserved.