FixedStorageArea Properties

Specifies if and and under what condition the content data in this storage area can be cached. The property takes a CachedContentOption constant value.

Indicates whether content can be deleted from a storage area. The default is true (deletes are allowed). When false, any attempt to delete (or move) content from the storage area will result in an exception.

An EventSet collection of the Event objects containing the audited events that have occurred for the object.

Specifies a ClassDescription object containing the fixed description (immutable metadata) of the class from which this object is instantiated.

Specifies the date and time when the storage area will close and no longer accept new content.

Specifies whether content in this storage area should be compressed. Content compression reduces the space consumed in a storage area of any type, but there are performance tradeoffs in using it. For more information, see Content compression.

If you enable content compression, you can modify default operation settings with the CmCompressionThresholdPercent and CompressionBlockSize properties.

Specifies as a percentage of the original size the minimum to which the first block of a content stream must be compressed in order for the entire stream to be compressed. For example, for a compression ratio of 80%, the entire data stream will be compressed if the first block of uploaded data, when compressed, is 80% or less of the original uncompressed size.

Some data formats, such as JPEG and ZIP, do not compress well, and the server compression overhead might not be worth the marginal savings of storage space for such formats. This property allows you to define the threshold at which data will not be compressed. You can also define the block size of the content stream to be compressed, as set in the CompressionBlockSize property.

This property requires that content compression be turned on, as set in the CmCompressionEnabled property. For administrator-related information, see Content compression.

A DeviceRetentionMode constant that specifies the retention mode of this fixed storage area relative to a fixed content device. Both retention modes apply only to checked-in documents that have their content stored on a fixed content device.

This property can have one of the following values:

• ALIGNED: Specifies an alignment relative to a fixed content device. Documents checked in on a fixed storage area in aligned mode have retention enforced by both the Content Engine server and the fixed content device. In this mode, the fixed content device must support the retention period specified by the value of the CmRetentionDate property of the document, or else the operation fails. If the source location of the content data of a document is on a fixed content device that is under aligned mode, the content data can only be deleted or moved if the retention period of the document has expired.
• NOT_ALIGNED: Specifies no alignment relative to a fixed content device. In this mode, retention is enforced by the Content Engine server only.

The priority for changing this index area from a standby index area to an open index area. The higher the value of this property, the lower the priority. The highest priority is 0, which is the default value.

When an open index areas becomes full, the Content Engine server chooses the standby index area with the highest priority and sets it to open. If two or more index areas exist with the same priority, one of these standby index areas is chosen randomly by the server.

You can control this feature by setting the JVM parameter com.filenet.engine.cbr.LegacyStandbyActivationPolicy on your application server. By default, this JVM parameter is false, which instructs the Content Engine server to open a standby index area when an index area becomes full. Set this JVM parameter to true to instruct the Content Engine server to open a standby index area only when all the index areas are either full or closed. For information about how to assign JVM parameter values for your application server, see Setting JVM parameters.

The number of content elements stored in this storage area.

For a ContentCacheArea object, this property returns null when the server cannot physically access the cache storage area and the CacheStatus property setting is Closed. Also, this statistic, along with the statistic concerning content element size (the ContentElementKBytes property), can become inaccurate as the result of power failures; properly timed failures will prevent servers from keeping the statistics in perfect sync with content creations and deletions. A cache sweep updates the statistics every 60 days to keep them reasonably accurate.

The size of all content elements stored in this storage area (in kilobytes). If content compression is turned on for a StorageArea object, this property reflects the compressed size of the content.

For the ContentCacheArea object, this property returns null when the server cannot physically access the cache storage area and the CacheStatus property setting is Closed. Also, this statistic can become inaccurate; for more information, see the ContentElementCount property.

Total content elements created in a Storage Area.

The number of content elements deleted from this storage area.

For the ContentCacheArea object, a cache clearing operation initializes this number to 0 (zero). For information on cache clearing, see the CacheStatus property. For information on the potential inaccuracy of this number, see the ContentCacheArea class.

Indicates the name of the user assigned as the creator of the object.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is settable only on create. After initial object creation, this property is read-only for all users.

Indicates the date and time the object was created. The Content Engine server stores dates and times using Coordinated Universal Time (UTC). For more information, see Timestamps.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is settable only on create. After initial object creation, this property is read-only for all users.

Indicates the date and time the object was last modified. The Content Engine server stores dates and times using Coordinated Universal Time (UTC). For more information, see Timestamps.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is read/write. (The read/write access for those users can only change if a change is made to the ACL on the object store that controls who has privileged write access to objects in that object store).

The setting that specifies the deletion method for content in this storage area. The AreaDeleteMethod class has constants defined for the deletion method settings.

Valid settings are:

• DESTRUCTIVE: Specifies that content be overwritten once with zeros before it is deleted.
• PURGE: Specifies that content be overwritten three times before it is deleted. This is the most secure form of delete.
• STANDARD (default setting): Specifies that content be deleted using the normal delete operation for the given device or file system.

User-readable text that describes an object.

The text is not locale-specific to the retrieving user except for the following classes:

• ClassDescription
• PropertyDescription
• ClassDefinition
• PropertyTemplate
• PropertyDefinition

The user-readable, provider-specific name of an object. This property is usually the designated Name property of the object's class.

For CmAuditProcessingBookmark and AuditDefinition objects, this property is intended to identify client applications that process the audit log. For CmAuditProcessingBookmark objects, this property, in support of the audit disposition feature, identifies the client that created the object. For AuditDefinition objects, this property identifies a set of audit definitions for a given client or client functionality.

For CmAuditProcessingBookmark and AuditDefinition objects, it is recommended that you set this property. Specify a unique value to distinguish one client application from another. Note, however, that the server does not prevent identical display names across multiple CmAuditProcessingBookmark or AuditDefinition objects. Therefore, the client application is responsible for enforcing uniqueness.

Provides single instancing at the storage area level of the Content Engine. For incoming content, the property indicates whether the Content Engine should check the storage area for duplicate content. If set to true, incoming content is not added to the storage area if identical content already exists in the storage area; only unique content is added.

Consider setting this property to true for high-volume content ingestion, such as when archiving emails to a Content Engine repository. However, because this feature impacts server performance, you might want to keep the default setting if the frequency of duplicate content is low.

For the FixedStorageArea interface, you cannot set the value to true in this release.

For more information, see Content duplication suppression.

Specifies whether content in this storage area should be encrypted.

Setting this property to true generates a new encryption key, which is used to encrypt new content. For more information on how content encryption works, see Content encryption.

Sets the key used for encrypting content in the storage area. Setting this property overrides the existing encryption key. The value of this property is not persisted, and a call to retrieve its value returns null.

This property is intended for external management of encryption keys by supporting IBM products. In general, a custom application should not use this property, unless there is a compelling reason to supply its own key rather than use a server-generated key.

An encryption key must be 128 bits in length. An incorrect length results in a E_BAD_VALUE exception. It is recommended that a Federal Information Processing Standards (FIPS) 140-compliant algorithm be used to generate an encryption key.

Note that an encryption key is used only if the EncryptionEnabled property is set to true. If the EncryptionEnabled property is set to false, the value set on this property is ignored. If the EncryptionEnabled property is set to true but this property is not set, then the server automatically generates the encryption key.

For more information on how content encryption works, see Content encryption.

Specifies a fixed content device associated with this FixedStorageArea object or external repository.

A representation of the Globally Unique Identifier (GUID), a unique 128-bit number, that is assigned to this Content Engine object when the object is created. When converted to a string, the Id property is typically depicted as 32 hexadecimal characters enclosed by brackets in the following format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}. For example, {3F2504E0-4F89-11D3-9A0C-0305E82C3301}.

For User and Group classes, the Id property takes the value of the Security Identifier (SID) rather than the 128-bit GUID. The string representation of the SID is in this example format: S-1-5-21-1559522492-2815155736-3711640725-55269. When Active Directory is used as the directory service for IBM FileNet P8, calls to User.get_Id() and Group.get_Id() always return the current SID for the principal, even if this user or group has only historical SIDs populating the Active Directory server.

For a given property representation, the Id property has the following characteristics:

• PropertyDescription.get_Id() is equal to PropertyTemplate.get_Id(), which is equal to PropertyDefinition.get_PrimaryId().
• PropertyDefinition.get_Id() is not equal to PropertyDefinition.get_PrimaryId().
• PropertyDefinition.get_Id() is not equal to PropertyDescription.get_Id().

For a newly created document object, you can override the Id property of its associated VersionSeries object before you save or check in the document for the first time.

Indicates the name of the user who last modified this object.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is read/write. (The read/write access for those users could only change if a change is made to the ACL on the object store that controls who has privileged write access to objects in that object store).

The maximum number of content elements designated for this storage area.

For a content cache area, new content can be added to a cache only if the number-of-content-elements statistic (the ContentElementCount property) is less than this maximum. (This maximum might be slightly exceeded, as statistics are managed on a delayed basis, and multiple servers can be adding content.) The value for this property must be greater than or equal to 1.

The maximum size of all content elements designated for this storage area (in kilobytes).

For a content cache area, new content can be added to a cache only if the size-of-content-elements statistic (the ContentElementKBytes property) is less than this maximum. (This maximum might be slightly exceeded, as statistics are managed on a delayed basis, and multiple servers can be adding content.) The value for this property must be greater than or equal to 1.

Manages the discretionary permissions assigned to the object.

Specifies a ResourceStatus constant, which indicates the availability status of an index area, index, or storage area.

For CmTextSearchIndexArea objects, this property specifies the availability status of an IBM® Content Search Services index area. This property can hold one of the following values:

• OPEN: The index area is active and new indexes can be created in it. New indexes can only be created in an index area when this property is set to OPEN. Existing indexes can also be updated, deleted, or queried.
• CLOSED: The index area is closed to new indexes. However, existing indexes can be updated, deleted, or queried.
• FULL: The index area has reached its full capacity because the number of its indexes is equal to the value of its MaxIndexes property and all its indexes are either full or closed. This setting indicates that no more objects can be indexed in the index area. However, existing indexes can be deleted or queried. Only the Content Engine server can set the ResourceStatus property to FULL.
• STANDBY: The index area is inactive. New indexes cannot be created, but existing entries can be updated, deleted, or queried. If there are no open index areas available, the Content Engine server can set the status of an index area that is set to STANDBY to OPEN.

For these CmTextSearchIndexArea objects, the Content Engine server supports only the following manual transitions between status values:

• OPEN to CLOSED: This transition is always allowed.
• OPEN to STANDBY: This transition is always allowed.
• CLOSED to OPEN: This transition is only allowed if the value of the MaxIndexes property is greater than the number of indexes in the index area or there are open indexes in the index area.
• CLOSED to STANDBY: This transition is only allowed if the value of the MaxIndex property is greater than the number of indexes in the index area or there are open indexes in the index area.
• FULL to OPEN: This transition is only allowed if the value of the MaxIndex property is greater than the number of indexes in the index area or there are open indexes in the index area.
• FULL to CLOSED: This transition is always allowed.
• FULL to STANDBY: This transition is only allowed if the value of the MaxIndex property is greater than the number of indexes in the index area or there are open indexes in the index area.
• STANDBY to OPEN: This transition is always allowed, but it should occur automatically when one index becomes full and a standby index is opened.
• STANDBY to CLOSED: This transition is always allowed.

For CmTextSearchIndex objects, this property specifies the availability status of an IBM® Content Search Services index. This property can hold one of the following values:

• OPEN: The index is open for create index requests. New index entries can only be created in an index when this property is set to OPEN. Existing index entries can also be updated, deleted, or queried.
• CLOSED: The index is closed for create index requests. However, existing index entries can be updated, deleted, or queried. If an index job closes an index for deletion, the server sets the ResourceStatus property to CLOSED and sets the IndexingStatus property to REPLACING. As long as the IndexingStatus property is set to REPLACING, you cannot change the ResourceStatus property from CLOSED to OPEN by using the API. If the index job is canceled, the server sets the IndexingStatus property to NORMAL; the ResourceStatus property remains set to CLOSED unless it is changed by the API.
• FULL: The index has reached its full capacity, as defined by the index area to which it belongs (MaxObjectsPerIndex and MaxSizePerIndexKbytes properties of a CmTextSearchIndexArea object). This setting indicates that no more index entries can be created. However, existing index entries can be deleted or queried. Only the Content Engine server can set the ResourceStatus property to FULL.
• UNAVAILABLE: The index is unavailable for indexing. New indexes cannot be created and existing index entries cannot be updated, deleted or queried. A query that includes an unavailable index will not fail, but it will not produce any results. An administrator should inform users when an index has been set to UNAVAILABLE. An administrator typically sets an index to the UNAVAILABLE status to prevent reindexing failures because of a corrupted index. A corrupted index that has been set to UNAVAILABLE allows reindexing to complete without generating an error that can cause the entire reindexing operation to fail. After an index has been set to UNAVAILABLE, it cannot be set to any other state; this state is a final state for the index. It is recommended that an unavailable index be reindexed as soon as possible. The server automatically creates a new index or opens a standby index to handle any pending index requests for the unavailable index. After an unavailable index is reindexed, the server deletes the unavailable index.

For these CmTextSearchIndex objects, the Content Engine server supports only the following manual transitions between status values:

• OPEN to CLOSED: This transition is always allowed.
• OPEN to UNAVAILABLE: This transition is always allowed.
• CLOSED to OPEN: This transition is only allowed if the index is not scheduled to be deleted by an index job (that is, the IndexingStatus property is not set to REPLACING).
• CLOSED to UNAVAILABLE: This transition is always allowed.
• FULL to OPEN: This transition is only allowed if the index is not at full capacity, as defined by the index area to which it belongs (MaxObjectsPerIndex and MaxSizePerIndexKbytes properties of a CmTextSearchIndexArea object).
• FULL to CLOSED: This transition is always allowed.
• FULL to UNAVAILABLE: This transition is always allowed.

For StorageArea objects, this property specifies the availability status of a storage area. This property can hold one of the following values:

• OPEN: The storage area is open for new content. Existing content can be updated, deleted, or retrieved.
• CLOSED: The storage area has been disabled or its closure date is set and occurs in the past. In a closed storage area, new content cannot be created and existing content cannot be updated. However, existing content can be deleted or retrieved.
• FULL: The maximum size or maximum number of content elements in the storage area has been exceeded. In a full storage area, new content cannot be created and existing content cannot be updated. However, existing content can be deleted or retrieved.
• STANDBY: The storage area is in standby mode. In a standby storage area, new content cannot be created. However, existing content can be updated, deleted, or retrieved.

For these StorageArea objects, the Content Engine server supports the following automatic transitions between status values:

• OPEN to FULL: Applied when adding a content element to a storage area exceeds the maximum size or maximum number of content elements allowed in the storage area.
• OPEN to CLOSED: Applied when adding a content element to a storage area whose closure date is in the past.
• STANDBY to OPEN: Applied when adding a content element to a storage area and the storage policy contains a standby storage area but no open storage areas.

For these StorageArea objects, the Content Engine server supports only the following manual transitions between status values:

• Transitions to CLOSED, FULL, or STANDBY: These transitions are allowed at any time (size, count, or closure date limits do not restrict the change).
• Transitions to OPEN: These transitions are allowed only when the size and count are below the specified limits, and the closure date is in the future (or null). This restriction includes changes from OPEN to OPEN, which allow you to change limit values for an open area.

Specifies a string that contains provider-specific information about a fixed content device.

For Image Services, this property allows you to specify the Image Services document class name for content that is stored on an Image Services fixed content device. This value will override the DefaultISDocumentClass property on the associated IMFixedContentDevice object. For example:

x-filenetfsrs:?ISDocClassName=SomeDocClassName

Deprecated.
Specifies when a content element will expire, so that it can be deleted from a storage area object. A positive value represents the number of minutes the content element must be retained. Other possible values, as enumerated in the RetentionPeriod class, are:

• 0: No minimum retention period (content may be deleted at any time).
• -1: Infinite retention period (content can never be deleted).
• -2: Same retention period as the associated fixed content device. (For FixedStorageArea objects only.)
• -101: Reserved for internal use only.
• -102: Retention period is not supported. This is the default if no RetentionPeriod value has been defined for the storage area.

Identifies the site associated with a given object. A site represents a geographical area in the FileNet P8 domain. If you do not specify a site when creating the associated object, the value of that object's Site property defaults to the value of Domain.DefaultSite.

Note that you cannot change the site directly on an ObjectStore object. To move an object store to a different site, you must change this property on the CmDatabaseConnection object that is referenced by the ObjectStore object.

For IsolatedRegion, this property is deprecated.

Specifies a file system directory path that will be used to store content elements prior to uploading them to a fixed content device.

The current object. The primary purpose of this property is to enable the expression of relationships among objects in a Content Engine query and to select candidate objects in the query results.