Previous Topic: Policy Parameters Structure

Next Topic: Policy Example

Attributes

The policy structure attributes are as follows:

POLICYID="policyid"

The policy ID of the policy to be inserted, modified, or deleted.

Limits: 64 characters maximum.

REALMID="realmid”

The ID of the realm (folder) that this policy belongs to.

Default: No default

Note: This attribute must be specified when EditAction=add.

USERLIMITFILES="n"

The maximum number of user-inserted files that can coexist in this realm.

-ve

Unlimited

Default: -1

USERLIMITSIZE= "n"

The maximum total size (in Kbytes) of user-inserted files that can coexist for this policy.

-ve

Unlimited

Default: -1

XCOMLIMITFILES="n"

The maximum number of CA XCOM Data Transport originating files that can coexist for this policy.

-ve

Unlimited

Default: -1

XCOMLIMITSIZE="n"

The maximum total size (in Kbytes) of CA XCOM Data Transport originating files that can coexist for this policy.

-ve

Unlimited

Default: -1

TOTALLIMITFILES="n"

The maximum number of files (of any type) that can coexist for this policy.

-ve

Unlimited

Default: -1

TOTALLIMITSIZE="n"

The maximum total size (in Kbytes) of files (of any type) that can coexist for this policy.

-ve

Unlimited

Default: -1

ENC="algorithmname"

The name of the symmetrical data encryption algorithm to be used for encrypting stored data files for this policy. The specified algorithm must be one of the algorithms supported by CA XCOM Gateway, and also by CA XCOM Data Transport if the file is to be transferred through CA XCOM Data Transport. A value of “NULL” indicates that stored data files for this policy should not be encrypted.

Default: ‘NULL’, that is, the word NULL

MAC="algorithmname"

The name of a message digest algorithm to be used for hashing stored data files for this policy. The specified algorithm must be one of the algorithms supported by CA XCOM Gateway, and also by CA XCOM Data Transport if the file is to be transferred through CA XCOM Data Transport. A value of “NULL” indicates that stored data files for this policy should not be hashed.

Default: ‘NULL’, that is, the word NULL

</USERDELIVERYXML>
xml
</USERDELIVERYXML>

The TRANSFERCOLLECTION XML entity that is to be used to distribute user-inserted files through CA XCOM Data Transport.

Note: This XML attribute value must be properly escaped, that is, the less than character (<), the greater than character (>), and the ampersand (&) must be represented by the following expressions, respectively:

Optional: This attribute is optional.

Default: Null

USERFORWARDING="No|Yes"

When this is set, uploaded files are made available for download by other users.

No

Not set

Yes

Set

Default: No

EXTRACTEDRETENTION="n"

The number of days that extractable files are to be retained in the realm staging area, after successful extraction by all subscribed recipients.

Default: 2

UNEXTRACTEDRETENTION="n"

The number of days that extractable files are to be retained in the realm staging area, even if not extracted by all subscribed recipients.

Default: 7

SCHEDULERETRYINTERVAL="n"

The number of seconds that CA XCOM Data Transport should wait before retrying an attempted local system connection, when scheduling CA XCOM Data Transport distribution.

Default: -1

Note: If a negative value is specified, or assumed by default, the effective retry interval is as specified by ConnectRetryInterval in the XCOM section of the global parameters.

SCHEDULERETRYLIMIT="n"

The number of retry attempts that CA XCOM Data Transport should make when an attempting local system connection to schedule CA XCOM Data Transport distribution.

Default: -1

If a negative value is specified, or assumed by default, the effective retry limit is as specified by ConnectMaxRetry in the XCOM section of the global parameters.

LASTIMPORTATION= "dd/mm/yy hh:mm:ss"

The most recent date and time at which a file was staged for this policy.

Null if no files have been staged.

Note: This attribute is disregarded if specified in the XML provided for a ConfigurePolicy request. It is provided in the XML returned by the ConfigurePolicy response.