MTS Packages Collection

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


See Also

ComponentsInPackage, RolesInPackage, RelatedCollectionInfo, PropertyInfo, ErrorInfo


© 1997 Microsoft Corporation. All rights reserved.