3.1.1.3.6 Conglomerations Table

  • Article

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>