msiDataObjOpen ( msParam_t *  inpParam,
msParam_t *  outParam,
ruleExecInfo_t *  rei 
)
Description:
This a microservice performs a low-level open for existing data object
Module:
core
Since:
pre-2.1
Author:
Mike Wan
Date:
2007
Note:
Can be called by client through irule
Example Usage:
See clients/icommands/test/rules3.0/
Parameters:
[in] inpParam - a msParam of type DataObjInp_MS_T or a STR_MS_T which would be taken as msKeyValStr. msKeyValStr - This is the special msKeyValStr format of keyWd1=value1++++keyWd2=value2++++keyWd3=value3... If the keyWd is not specified (without the '=' char), the value is assumed to be the path of the data object("objPath") for backward compatibility. Valid keyWds are:

  • "objPath" - the path of the data object to open.
  • "rescName" - the resource of the data object to open.
  • "replNum" - the replica number of the copy to open.
  • "openFlags" - the open flags. valid open flags are: O_RDONLY, O_WRONLY, O_RDWR and O_TRUNC. These can be combined by concatenation, e.g. O_WRONLYO_TRUNC (without the '|' character). The default open flag is O_RDONLY.
[out] outParam - a msParam of type INT_MS_T containing the descriptor of the open.
[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:
none
iCAT Attributes Modified:
none
Side Effect:
none
Returns:
integer
Return values:
positive on success
Precondition:
none
Postcondition:
none
See also:
none

Definition at line 179 of file reDataObjOpr.c.

Generated on Tue Nov 12 23:09:21 2013 for iRODS Documentation by  doxygen 1.6.3