3.1.1.3.6 Conglomerations Table

The entries in the Conglomerations table represent conglomerations.

Table identifier: {D495F321-AF37-11D1-8B7E-00C04FD7A924}

AuxiliaryGuid: None.

Defined in catalog version: All catalog versions.

Prerequisites: None.

Hidden bitness property: No.

Supported query templates:

Catalog version 3.00: Empty query.

Catalog version 4.00 and catalog version 5.00:

Cell 1
PartitionIdentifier equals <A>

Primary key: ConglomerationIdentifier

Other referential constraints:

Catalog version 3.00: None.

Catalog version 4.00 and catalog version 5.00: There MUST exist an entry in the Partitions table with identical value for the PartitionIdentifier property.

Write restrictions: Add MUST be supported if and only if:

• Catalog version 4.00 and catalog version 5.00: The partition identified by the PartitionIdentifier property of the new entry has the Changeable property set to TRUE (0x00000001).

Update MUST be supported if and only if:

• Changeable has the value "Y" or only Changeable and/or Deleteable are updated.

• IsSystem has the value "N".

• IsProxyApp has the value FALSE (0x00000000), or no properties designated read-only for proxies are updated.

• The conglomeration is not a protected conglomeration.<125> For historical reasons, there is no general mechanism for a client to determine if a conglomeration is protected except to attempt updating the Changeable property. However, so that clients can avoid making calls that would update a protected conglomeration, the following container identifiers are reserved for protected conglomerations: {01885945-612C-4A53-A479-E97507453926}, {9EB3B62C-79A2-11D2-9891-00C04F79AF51}, and {6B97138E-3C20-48D1-945F-81AE63282DEE}.

• Catalog version 4.00 and catalog version 5.00: The partition identified by the PartitionIdentifier property of the new entry has the Changeable property set to TRUE (0x00000001).

Remove MUST be supported if and only if:

• Deleteable has the value "Y".

• IsSystem has value "N".

• Catalog version 4.00 and catalog version 5.00: The partition identified by the PartitionIdentifier property of the new entry has the Changeable property set to TRUE (0x00000001).

Cascade: On removal of an entry, all entries in the ComponentsAndFullConfigurations (section 3.1.1.3.1), ComponentLegacyConfigurations (section 3.1.1.3.3), and Roles (section 3.1.1.3.9) table with identical values for ConglomerationIdentifier property MUST be removed.

Populate: None.

Properties:

Index (3.00)	Index (4.00/5.00)	Property name	Type	Size	Flags	Meta
0	0	ConglomerationIdentifier	eDT_GUID	16	0x00000003	RO
1	1	Name	eDT_LPWSTR	variable	0x00000002
2	2	Internal1	eDT_ULONG	4	0x00000002	IN
3	3	ServerName	eDT_LPWSTR	variable	0x00000000
4	4	Internal2	eDT_ULONG	4	0x00000002	IN
5	5	CommandLine	eDT_LPWSTR	variable	0x00000000	TR
6	6	ServiceName	eDT_LPWSTR	variable	0x00000000
7	7	Internal3	eDT_ULONG	4	0x00000002	IN
8	8	RunAsUser	eDT_LPWSTR	variable	0x00000000
9	9	Internal4	eDT_BYTES	variable	0x00000000	IN
10	10	Description	eDT_LPWSTR	variable	0x00000000
11	11	IsSystem	eDT_LPWSTR	4	0x00000006	RO
12	12	Authentication	eDT_ULONG	4	0x00000002
13	13	ShutdownAfter	eDT_ULONG	4	0x00000002	TR
14	14	RunForever	eDT_LPWSTR	4	0x00000006	TR
15	15	Password	eDT_LPWSTR	variable	0x00000008
16	16	Activation	eDT_LPWSTR	variable	0x00000000	TR
17	17	Changeable	eDT_LPWSTR	4	0x00000004
18	18	Deleteable	eDT_LPWSTR	4	0x00000004
19	19	CreatedBy	eDT_LPWSTR	variable	0x00000000
20	20	Internal5	eDT_BYTES	variable	0x00000000	IN
21	21	Internal6	eDT_ULONG	4	0x00000002	IN
22	22	RoleBasedSecurityEnabled	eDT_ULONG	4	0x00000002	TR
23	23	Internal7	eDT_BYTES	variable	0x00000000	IN, NT
24	24	ImpersonationLevel	eDT_ULONG	4	0x00000002
25	25	ORBSecuritySettings	eDT_ULONG	4	0x00000002
26	26	CRMEnabled	eDT_ULONG	4	0x00000002	TR
27	27	Enable3GigSupport	eDT_ULONG	4	0x00000002	TR
28	28	IsQueued	eDT_ULONG	4	0x00000002	TR
29	29	QCListenerEnabled	eDT_LPWSTR	4	0x00000006	TR
30	30	EventsEnabled	eDT_ULONG	4	0x00000002	TR
31	31	Internal8	eDT_ULONG	4	0x00000002	IN
32	32	Internal9	eDT_ULONG	4	0x00000002	IN
33	33	IsProxyApp	eDT_ULONG	4	0x00000002	RO
34	34	CRMLogFile	eDT_LPWSTR	variable	0x00000000	TR
-	35	DumpEnabled	eDT_ULONG	4	0x00000002	TR
-	36	DumpOnException	eDT_ULONG	4	0x00000002	TR
-	37	DumpOnFailFast	eDT_ULONG	4	0x00000002	TR
-	38	MaxDumpCount	eDT_ULONG	4	0x00000002	TR
-	39	DumpPath	eDT_LPWSTR	variable	0x00000000	TR
-	40	IsEnabled	eDT_ULONG	4	0x00000002
-	41	PartitionIdentifier	eDT_GUID	16	0x00000002	RO
-	42	ConcurrentApps	eDT_ULONG	4	0x00000002	TR
-	43	RecycleLifetimeLimit	eDT_ULONG	4	0x00000002	TR
-	44	RecycleCallLimit	eDT_ULONG	4	0x00000002	TR
-	45	RecycleActivationLimit	eDT_ULONG	4	0x00000002	TR
-	46	RecycleMemoryLimit	eDT_ULONG	4	0x00000002	TR
-	47	RecycleExpirationTimeout	eDT_ULONG	4	0x00000002	TR
-	48	QCListenerMaxThreads	eDT_ULONG	4	0x00000002	TR
-	49	QCAuthenticateMsgs	eDT_ULONG	4	0x00000002	TR
-	50	ApplicationDirectory	eDT_LPWSTR	variable	0x00000000
-	51	SRPTrustLevel	eDT_ULONG	4	0x00000002	TR
-	52	SRPEnabled	eDT_ULONG	4	0x00000002	TR
-	53	SoapActivated	eDT_ULONG	4	0x00000002	TR
-	54	SoapVRoot	eDT_LPWSTR	variable	0x00000000	TR
-	55	SoapMailTo	eDT_LPWSTR	variable	0x00000000	TR
-	56	SoapBaseUrl	eDT_LPWSTR	variable	0x00000000	TR
-	57	Replicable	eDT_ULONG	4	0x00000002	TR

In the previous table, internal properties (marked with IN in the Meta column) MUST NOT be written to or interpreted by the client. The server's use of these properties is implementation-specific because it does not affect interoperability.

ConglomerationIdentifier: The conglomeration identifier for the conglomeration.<126>

Name: A NameProperty (section 2.2.2.6) providing a human-readable name of the conglomeration.<127> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

ServerName: A ComputerNameOrAddressProperty (section 2.2.2.16) indicating the remote server on which the ORB is to attempt to instantiate the components in the conglomeration, if the conglomeration is a Configured Proxy (section 3.1.1.1.7).<128> The ServerName property must be null if IsProxyApp is FALSE (0x00000000).

CommandLine: If not null, an ORBSpecificCommandLineProperty (section 2.2.2.13.6) containing command that is to be executed by the ORB to host instance containers for the conglomeration.<129>This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

ServiceName: If not null, an ORBSpecificAlternateLaunchNameProperty (section 2.2.2.13.4) corresponding to the AlternateLaunchName property of the alternate launch configuration (section 3.1.1.4) to be used by the ORB to perform an alternate launch for the conglomeration.<130> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RunAsUser: If not null, a SecurityPrincipalNameProperty (section 2.2.2.17) indicating the security principal to be used by the ORB when creating instance containers for the conglomeration.<131> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

Description: A DescriptionProperty (section 2.2.2.7) providing a human-readable description of the conglomeration.<132>

IsSystem: A YesNoProperty (section 2.2.2.19) that indicates whether or not a conglomeration is distinguished by the COMA server.<133> A distinguished conglomeration is handled much like one for which Changeable is "N", except that role members for its roles can be added or removed (see write restrictions for this and other tables for a more formal specification). The criteria for determining whether or not a conglomeration is distinguished are implementation-specific.

Authentication: A DefaultAuthenticationLevelProperty (section 2.2.2.22) that, when configured for a conglomeration with Activation set to "Local", indicates the authentication level the ORB is to use for instance containers associated with the conglomeration. <134> The meaning of this property when Activation is set to "Inproc" is ORB-specific. <135> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

ShutdownAfter: A ShortTimeoutInMinutesProperty (section 2.2.2.11.4) indicating the time that the ORB is to allow an instance container to run until it is forcibly shut down.<136> The ORB is to trigger the timer for this time out once it has determined that the instance collection is idle. The criteria for determining that an instance container is idle are ORB-specific. This property is to be ignored by the ORB if RunForever is "Y". This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RunForever: A YesNoProperty that indicates whether or not the ORB is to ignore the ShutdownAfter property.<137> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

Password: If not null, a PasswordProperty (section 2.2.2.18) indicating the password for the security principal specified by the RunAsUser property.<138> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

Activation: An ActivationTypeProperty (section 2.2.2.23) that indicates whether the ORB is to host instance containers associated with the conglomeration in a new process or the creator's process, for local instantiation.<139> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

Changeable: A YesNoProperty that indicates whether or not the conglomeration and its contained objects are changeable (see write restrictions for this and other tables for a more formal specification).<140> MUST be "N" for a protected conglomeration.

Deleteable: A YesNoProperty that indicates whether or not the conglomeration is deleteable (see write restrictions for this table for a more formal specification).<141> MUST be "N" for a protected conglomeration.

CreatedBy: If not null, a NameProperty providing an informational name of the user who created the conglomeration.<142>

RoleBasedSecurityEnabled: A BooleanProperty (section 2.2.2.9) that indicates whether the ORB is to enable role-based security for the conglomeration.<143> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

ImpersonationLevel: A DefaultImpersonationLevelProperty (section 2.2.2.25) indicating the impersonation level to be used by the ORB as the default for outgoing DCOM calls that are made from instance containers associated with the conglomeration.<144> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

ORBSecuritySettings: An ORBSecuritySettingsProperty (section 2.2.2.26) indicating security settings to be used by the ORB for instance containers associated with the conglomeration.<145> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

CRMEnabled: A BooleanProperty that indicates whether or not the ORB is to provide a compensating resource manager for each instance container associated with the conglomeration.<146> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

Enable3GigSupport: A BooleanProperty that indicates whether or not the ORB is to provide large address space support to instance containers associated with the conglomeration.<147> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

IsQueued: A BooleanProperty that indicates whether or not the ORB is to enable a queuing transport (see section 3.1.1.1.5) for components configured in the conglomeration.<148> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

QCListenerEnabled: A YesNoProperty that indicates whether or not the ORB is to provide a queue listener for each instance container associated with the conglomeration.<149> If "Y", the IsQueued property MUST be TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

EventsEnabled: A BooleanProperty that indicates whether or not the ORB is to collect activity statistics for instance containers associated with the conglomeration.<150> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

IsProxyApp: A BooleanProperty that indicates whether or not the conglomeration is a Configured Proxy.<151> If TRUE (0x00000001), this indicates that instance containers for this conglomeration are to be hosted by a different ORB, located on the machine identified by ServerMachine.

CRMLogFile: An ImplementationSpecificPathProperty (section 2.2.2.2) providing the path to a log file, to be used by compensating resource managers provided by the ORB for the conglomeration.<152> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

DumpEnabled: A BooleanProperty that indicates whether or not the ORB is to collect debugging data for an instance container that encounters an exceptional condition.<153> If TRUE, property DumpPath SHOULD be non-NULL. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

DumpOnException: A BooleanProperty that indicates whether or not the ORB is to collect debugging data when a critical application-specific error occurs.<154> If TRUE, DumpEnabled MUST be TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

DumpOnFailFast: A BooleanProperty that indicates whether or not the ORB is to collect debugging data when a critical ORB-specific error occurs.<155> This property is only meaningful if DumpEnabled has the value TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

MaxDumpCount: A MaxDumpCountProperty (section 2.2.2.27) indicating the maximum count of debugging data files the ORB is to collect for the conglomeration.<156> This property is only meaningful if DumpEnabled has the value TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

DumpPath: If not null, an ImplementationSpecificPathProperty providing a location where the ORB is to create debugging data files.<157> This property is only meaningful if DumpEnabled has the value TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

IsEnabled: A BooleanProperty indicating whether or not the ORB is to allow instantiation of components configured in the conglomeration.<158> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

PartitionIdentifier: The partition identifier of the partition containing the conglomeration.

ConcurrentApps: A ConcurrentAppsProperty (section 2.2.2.28) indicating the maximum number of instance containers the ORB is to create for the conglomeration at any given time.<159> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RecycleLifetimeLimit: A LongTimeoutInMinutesProperty (section 2.2.2.11.3) indicating the time that the ORB is to allow an instance container to run before it is recycled.<160> A value of zero indicates that recycling based on instance container lifetime is to be disabled. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RecycleCallLimit: A RecyclingCriterionLimitProperty (section 2.2.2.29) indicating the maximum number of calls to component instances in an instance container that the ORB is to allow before it is recycled.<161> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RecycleActivationLimit: A RecyclingCriterionLimitProperty indicating the maximum number of activations of components in an instance container that the ORB is to allow before it is recycled.<162> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RecycleMemoryLimit: A RecyclingCriterionLimitProperty indicating the maximum memory in kilobytes consumed by an instance container that the ORB is to allow before it is recycled.<163> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

RecycleExpirationTimeout: A ShortTimeoutInMinutesProperty (section 2.2.2.11.4) indicating the time that the ORB is to wait after recycling an instance container before forcibly shutting it down.<164> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

QCListenerMaxThreads: A MaxThreadsProperty (section 2.2.2.30) indicating the maximum number of threads the ORB-provided queue listener (section 3.1.1.1.5) is to use in a given instance container.<165> If nonzero, QCListenerEnabled MUST be "Y". This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

QCAuthenticateMsgs: A BooleanProperty indicating whether the ORB is to authenticate messages in an enabled queuing protocol (section 3.1.1.1.5).<166> If TRUE, EnableQueueing MUST be TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

ApplicationDirectory: If not null, an ImplementationSpecificPathProperty providing a path that the ORB is to use to locate additional ORB-specific files containing application-specified configuration.<167> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

SRPTrustLevel: If SRPEnabled is TRUE, a TrustLevelProperty (section 2.2.2.24) indicating the trust level that is to be used by the ORB in an ORB-specific manner to control instantiation of components configured in the conglomeration.<168> Otherwise, this property has no meaning. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

SRPEnabled: A BooleanProperty that indicates whether or not the ORB is to enforce its software restriction policy (section 3.1.1.1.9) for the conglomeration.<169> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

SoapActivated: A BooleanProperty that indicates whether or not the ORB is to expose components configured in the conglomeration as SOAP [SOAP1.1] endpoints.<170> This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

SoapVRoot: If not null, an ORBSpecificWebServerVirtualDirectoryProperty (section 2.2.2.13.7) providing a path to a virtual directory in a web server that the ORB is to use as the SOAP [SOAP1.1] endpoint for components in the conglomeration.<171> If not null, SoapActivated MUST be TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

SoapMailTo: If not null, a Simple Mail Transfer Protocol (SMTP), as specified in [RFC821], mailing address that the ORB is to use as the SOAP, as specified in [SOAP1.1], endpoint for components in the conglomeration.<172> If not null, SoapActivated MUST be TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

SoapBaseUrl: If not null, a URL that the ORB is to use as the SOAP, as specified in [SOAP1.1], endpoint for components in the conglomeration.<173> If not null, SoapActivated MUST be TRUE. This property MUST be read-only if IsProxyApp is TRUE (0x00000001).

Replicable: A BooleanProperty indicating to replication client applications whether or not a conglomeration is to be copied during replication in which this COMA server is the replication source.<174> This value is advisory and intended for interpretation only by replication client applications.<175>