Platform SDK: Transaction Server

MTS Packages Collection

[This product will work only on Windows NT 4.0 versions and earlier. For Windows 2000 and later, see COM+ (Component Services).]

As the top-level collection managed by the MTS Explorer, the Packages collection contains the packages installed on the local machine running MTS. Packages contain a set of components that run in the same server process, and define declarative security constructs that determine access to components at run time. The Packages collection supports the Add method and Remove method on the CatalogCollection object. In addition, the GetUtilInterface method of this collection returns a PackageUtil object which can be used to install and export packages.

The following table provides a list of the properties supported by the CatalogObject objects within the Packages collection.

Property	Description
Name	Name of the package. Data Type: String Default value: “New package” Access: Read/Write
ID	A universally unique identifier (UUID) for the package. Data Type: String Default value: A unique identifier is generated Access: Read/Write when using the Add method. Read-only after using the Add method.
Description	Describes the package. Description fields hold a maximum of 500 characters. Data Type: String Default value: None Access: Read/Write
IsSystem	Identifies an MTS system package. “N” signifies that the package is not a Transaction Server system package, and “Y” indicates that package is an MTS system package. Data Type: String Default value: “N” Access: Read only
Authentication	Sets authentication level for calls. Possible values are 0 through 6, which correspond to the Remote Procedure Call (RPC) authentication settings. Data Type: Long Default value: 4 Access: Read/Write
ShutdownAfter	Sets the delay before shutting down a server process after it becomes idle. Shutdown latency ranges from 0 to 1440 minutes. Data Type: Long Default value: 3 Access: Read/Write
RunForever	Enables a server process to continue if a package is idle. If value is set to “Y”, the server process will not shut down when left idle. If set to “N”, the process will shut down according the value set by the ShutDownAfter property. Data Type: String Default value: “N” Access: Read/Write
SecurityEnabled	Checks the security credentials of any client that calls the package if value is set to “Y.” Data Type: String Default value: “N” Access: Read/Write
Identity	Sets the server process identity for the package. Specify a valid Windows NT user account or "Interactive User" to have the package assume the identity of the current logged-on user. Data Type: String Default value: “Interactive User” Access: Read/Write
Password	Sets the password used by the server process to log on under the identity above. Data Type: String Default value: None Access: Write only
Activation	Sets the package level activation property to either “Local” or “Inproc”. The Local setting determines that objects within the package will run within a dedicated local server process. A package running under the Local activation setting is a “server package”. The Inproc activation setting means objects run in their creator’s process. A package running under the Inproc activation setting is a “library package” Data Type: String Default Value: “Local” Access: Read/Write
Changeable	Sets whether changes to the package settings, or those of its components, are allowed (either programmatically, or through the MTS UI).
	Data Type: String Default Value: Y Access: Read/Write
Deleteable	Sets whether the package or its components can be deleted (either programmatically, or through the MTS UI). Data Type: String Default Value: “Y” Access: Read/Write
CreatedBy	Informational string to describe the package creator. Data Type: String Default Value: Empty string Access: Read/Write