Accessing WebSphere MQ objects using enumeration

Objects within the Active Directory contain an enumeration function on the IADsContainer interface. This function lists objects contained within the current object. Enumeration can be used to reach any object in the WebSphere MQ namespace by traversing down the object hierarchy from a known point. For example, starting from the ADSI root of ADS:

1. From the ADS container, an enumeration request returns all available namespace containers; for example, LDAP, WinNT, and WebSphere MQ.
2. From the WebSphere MQ namespace object, an enumeration request returns MQHost containers, each representing machines that host queue managers.
3. From an MQHost/<Host> instance, an enumeration request returns MQQueueManager containers for each queue manager hosted by that machine.
4. From an MQHost/<Host>/MQQueueManager/<QueueManager> instance, an enumeration request returns MQAliasQueue, MQClntConnChannel, MQClusterQueue, MQClusterReceiverChannel, MQClusterSenderChannel, MQLocalQueue, MQModelQueue, MQProcess, MQReceiverChannel, MQRemoteQueue, MQRequesterChannel, MQSenderChannel, MQServerChannel, MQSvrConnChannel.

   MQChannel, MQProcess and MQQueue objects are represented as containers. Enumerating these objects results in an empty return set, as they contain no child objects.

Note:

Enumeration is an alternative to using a URL or COM address of the object to be interrogated. However, the process implies the enumeration of several intermediate objects.

C++ Language invocation

The following code fragment connects to the queue manager called queue.manager.1 on machine heron and obtains an enumeration of its children. Using the enumeration object obtained, the code then displays information about each child before issuing a count of the number of child objects processed:

//
// Define and initialize variables.
//
 
ULONG cElementFetched = 0L;
IEnumVARIANT *pEnumVariant = NULL;
VARIANT VariantArray[MAX_ADS_ENUM];
IADsContainer *pADsContainer = NULL;
DWORD dwObjects = 0, i = 0;
BOOL fContinue = TRUE;
 
//
// Ensure VARIANT array used to store results is empty
//
 
for (i = 0; i <MAX_ADS_ENUM; i++)
{
    VariantInit(&VariantArray*lbrk.i]);
}
 
//
// Attach to the IADs Container interface for the queue manager
// queue.manager.1 residing on machine heron.
//
 
ADsGetObject( _TEXT("WebSphere MQ://MQHost/heron/MQQueueManager/
                     queue.manager.1")
            , IID_IADsContainer
            , (void **)&pADsContainer);
 
//
// Build an enumerator object for the specified Active Directory container
//
 
ADsBuildEnumerator(pADsContainer, &pEnumVariant);
 
while (fContinue)
{
    BSTR bstrClass = NULL;
    BSTR bstrName = NULL;
    IADs *pObject;
 
    //
    // Populate VARIANT array with elements fetched from
    // the enumerator object
    //
 
    fContinue = ADsEnumerateNext( pEnumVariant
                                , MAX_ADS_ENUM
                                , VariantArray
                                , &pElementFetched);
 
    //
    // Step through the VARIANT obtaining a pointer to the IADs interface
    // on each object. Using this interface, extract the name and class
    // of the object, printing this information onto the screen.
    //
 
    for (i= 0; i < cElementFetched; i++ )
    {
        IDispatch *pDispatch = NULL;
        pDispatch=VariantArray[i].pdispVal;
        pDispatch->QueryInterface( IID_IADs
                                 , (VOID **)&pObject);
        pObject->Get_Name (&bstrName);
        pObject->get_Class(&bstrClass)
 
        printf("  %S(%S)\n", bstrName, bstrClass) ;
 
        pObject->Release();
        pDispatch->Release();
    }
 
    memset( VariantArray
          , 0
          , sizeof(VARIANT)*MAX_ADS_ENUM);
 
    dwObjects += cElementFetched;
}
 
printf("Total Number of Objects enumerated is %d\n", dwObjects);
 
if (pEnumVariant)
{
    pEnumVariant->Release();
}
 
if (pADsContainer)
{
    pADsContainer->Release();
}