Lookup-Services
DESCRIPTION
This webject performs directory searches to find Info*Engine services. The resulting group contains one element per service found. Each element may contain the following attributes:
• dn
• description
• ptcRuntimeServiceName
• ptcServiceName
• ptcServiceClassName
• ptcMetaType
• ptcServiceAddress
• ptcObjectSerializationType
• ptcCoresidentService
(The contents of the ptcApplicationServiceobjectClass plus distinguished name)
Since the ptcApplicationServiceobjectClass only requires ptcServiceName, dn and ptcServiceName are found in all elements, and the presence of the others is dependent on configuration of each specific service.
The defaults values are:
CLASS - none
FILTER - (objectclass=ptcApplicationService) (all available service entries)
GROUP_OUT -SERVICES
SYNTAX
<ie:webject name="Lookup-Services" type="MGT">
<ie:param name="GROUP_OUT" data="group name"/>
<ie:param name="FILTER" data="LDAP search filter"/>
<ie:param name="CLASS" data="class name"/>
</ie:webject>
PARAMETERS
|
Required
|
Select
|
Optional
|
|
|
CLASS
|
|
|
FILTER
|
|
|
GROUP_OUT
|
CLASS
Specifies the type of the objects contained in the output group named by the GROUP_OUT parameter. For example if a webject specifies CLASS=MyClassName and GROUP_OUT=data_1, the XML representation of the output group contains the following tags:
<MyClassName NAME="data_1" TYPE="Object" STATUS="0">
</MyClassName>
The default for this parameter is “Unknown-Class-Name.” This parameter is optional.
FILTER
This parameter allows the user to specify an LDAP search filter such as (ptcServiceName=com.company.host.server). The default value is (objectclass=ptcApplicationService), which returns all services within the Naming Service’s search base (the search is always performed within the VMs Naming Service search base).
GROUP_OUT
This parameter allows the user to specify the name of the output group. The default value is SERVICES. The output group only contains services (LDAP directory entries who specify ptcApplicationService as an objectClass). The output group contains one element per service found. Each element contains at a minimum the dn and ptcServiceName attributes. Each element may also contain the following attributes if they have values set in the corresponding service: ptcRuntimeServiceName, ptcServiceClassName, ptcMetaType, ptcServiceAddress, description, ptcCoresidentService, ptcObjectSerializationType. The following attributes may be multivalued if specified: ptcServiceName, ptcServiceAddress, ptcCoresidentService.