Novell Doc: Novell Storage Manager 3.0.1 for eDirectory Action Object Reference Guide

6.3 Optional Attributes

The following attributes can be added to any Action Object.

6.3.1 Execute Time

Description

The cccFSFactoryActionExecuteTime attribute provides a way to set a deferral time on an action. The value for the attribute is an integer based on UNIX time, which is calculated as the number of seconds since midnight UTC of January 1, 1970.

Parameters

Attribute	Value	Details
cccFSFactoryActionExecuteTime (IN)	0 to 2³¹ -1	This follows the UNIX time _t standard, indicating the number of seconds since midnight UTC Jan. 1, 1970.

Return Values

The cccFSFactoryActionResult attribute is set to Success if it is successful; otherwise, an error message displays.

NOTE:The current release does not provide a mechanism for using human readable time-date stamps.

One helpful site for converting time to UNIX time format is found at the Time Stamp Generator Web sitehttp://www.timestampgenerator.com.

Example

To set a CreateDir action to take place on February 1, 2009 at 7 pm EST (Eastern Standard Time), the corresponding value for the scheduling attribute is 1233532800.

#Example LDIF for CreateDir Action Object with deferred time
version: 1
dn: cn=createdirtest,ou=actionObjects,o=org
changetype: add
objectClass: cccFSFactoryAction
cccFSFactoryActionPath1: cn=SERVER1_VOL1,o=org#0#/path1
cccFSFactoryActionExecuteTime: 1233532800
cccFSFactoryActionOperation: CreateDir
cccFSFactoryActionTrigger: Ready

6.3.2 Link Next

Description

The cccFSFactoryActionLinkNext attribute sets the next Action Object to process after the current one.

Parameters

Attribute	Value	Details
cccFSFactoryActionLinkNext	<Link> <Process> 0 \| 1 </Process> <NextAction> [FDN] </NextAction> </Link>	Process:0 – Engine processes the next Action Object trigger.1 – External processing of the next Action Object trigger. NextAction:Dotted, typeless, fully distinguished name of the next action object to trigger.

Attribute

Value

Details

cccFSFactoryActionLinkNext

<Link>
    <Process> 0 |  1 </Process>
    <NextAction> [FDN] </NextAction>
</Link>

Process:0 – Engine processes the next Action Object trigger.1 – External processing of the next Action Object trigger.

NextAction:Dotted, typeless, fully distinguished name of the next action object to trigger.

Notes

If the attribute is present, the Engine tries to process any valid <NextAction> tags.
If the value of <Process> is set to anything other than 0, the attribute is left alone. This is useful for cases where an external system such as Novell Identity Manager will drive the triggering of the next linked action.

Example

The following example shows how to link a CreateDir action to a SetTrustee action that follows it:

#Example LDIF for CreateDir Action Object with deferred time
version: 1
dn: cn=createdir-1,ou=actions,o=org
changetype: add
objectClass: cccFSFactoryAction
cccFSFactoryActionPath1: cn=SERVER1_VOL1,o=org#0#/path1
cccFSFactoryActionLinkNext: <Link><Process>0</Process>
 <NextAction>cn=trustee-1,ou=actions,o=org</NextAction>
 </Link>
cccFSFactoryActionOperation: CreateDir
cccFSFactoryActionTrigger: Ready

dn: cn=settrustee-1,ou=actions,o=org
changetype: add
objectClass: cccFSFactoryAction
cccFSFactoryActionPath1: cn=SERVER1_VOL1,ou=resources,o=org#
 0#/path1/subpath1
cccFSFactoryActionOperation: SetTrustee
cccFSFactoryActionOption: RF
cccFSFactoryActionTarget: user1.hq.org

NOTE:Only the first action in the sequence should have the cccFSFactoryActionTrigger attribute set to Ready.

6.3.3 Cleanup

Description

The cccFSFactoryActionCleanup attribute specifies whether the Action Object should be deleted from eDirectory after processing for it has completed.

Parameters

Attribute	Value	Details
cccFSFactoryActionCleanup	[ System \| OnSuccess ]	System – the Engine will delete the action object unconditionally at the end of processing, whether or not the defined action completed with a result of “Success”.OnSuccess – the Engine will delete the action object only if its action has completed with a result of “Success”..Any other value, or absence of the attribute leaves the Action Object behind.

NOTE:Once the Engine has verified the trigger on an Action Object, it is eligible for automatic cleanup regardless of whether the defined action is successful or not.

Example

#Example LDIF for CreateDir Action Object with cleanup
version: 1
dn: cn=createdir-1,ou=actions,o=org
changetype: add
objectClass: cccFSFactoryAction
cccFSFactoryActionPath1: cn=SERVER1_VOL1,o=org#0#/path1
cccFSFactoryActionCleanup: System
cccFSFactoryActionOperation: CreateDir
cccFSFactoryActionTrigger: Ready