msiAutoReplicateService ( msParam_t *  xColl,
msParam_t *  xRecursive,
msParam_t *  xRequireNumReplicas,
msParam_t *  xRescGroup,
msParam_t *  xEmailAccountToNotify,
ruleExecInfo_t *  rei 
)
Description:
This microservice is used to handle digital preservation rule through checking data integrity and making necessary repair(s).
Module:
core
Since:
2.2
Author:
Bing Zhu
Date:
2009-07
Note:
This microservice is supposed to be run as a periodic service to check if a designated number of required good copies of dataset(s) from a selected collection is in the system.
  • For a registered copy, it checks if the copy still exits. If the local file is removed by the data owner, the registered copy will be deleted from iRODS.
  • For each replica, wether it is a registered dataset or a vaulted dataset, the service computes the checksum and verifies the replica is still good.
  • If a bad copy is detected, the copy is deleted.
  • Finally, the service creates necessary replicas to meet the required number of copies.
Example Usage:
See clients/icommands/test/rules3.0/
Parameters:
[in] xColl - a STR_MS_T containing the collection or object name
[in] xRecursive - a STR_MS_T determining whether should be run recursively

  • true - will run recursively
  • false - default - will not run recursively
[in] xRequireNumReplicas - a STR_MS_T specifying the number of required replicas iRODS

  • must be at least 1
[in] xRescGroup - a STR_MS_T containing the target resource group name
[in] xEmailAccountToNotify - Optional - a STR_MS_T containing the notification email address
[in,out] rei - The RuleExecInfo structure that is automatically handled by the rule engine. The user does not include rei as a parameter in the rule invocation.
Session Variables Used:
none
Session Variables Modified:
none
iCAT Attributes Used:
COL_D_DATA_CHECKSUM
iCAT Attributes Modified:
none
Side Effect:
none
Returns:
integer
Return values:
0 upon success
Precondition:
none
Postcondition:
none
See also:
none

Definition at line 239 of file reAutoReplicateService.c.

Generated on Sat Nov 16 22:27:08 2013 for iRODS Documentation by  doxygen 1.6.3