com.ibm.itim.apps.recon
Class ReconUnitData

java.lang.Object
  |
  +--com.ibm.itim.apps.recon.ReconUnitData

All Implemented Interfaces:

java.io.Serializable

public class ReconUnitData

extends java.lang.Object

implements java.io.Serializable

Represents a reconciliation unit configured for a given resource or service. A resource or service can have multiple reconciliation units configured with different schedule information. So no two reconciliation units for the same resource, can have the same schedule information.

A new reconciliation unit created with the default constructor has the following default values :-

• ID - 0
• Minute - Calendar.MINUTE
• Hour - Calendar.HOUR
• Day of Month - Calendar.DAY_OF_MONTH
• Month - Calendar.MONTH
• Day of Week - 0
• Max Duration - 600 minutes
• Lock Service - true
• Recon query filter - null
• Recon query attributes - Empty list, but this implies all attributes applicable for the resource will be reconciled.

Since:

ITIM 4.6 IF32

See Also:

Serialized Form

Constructor Summary

ReconUnitData()
Default constructor, initializes a reconciliation unit with following default values - ID - 0 Minute - Calendar.MINUTE Hour - Calendar.HOUR Day of Month - Calendar.DAY_OF_MONTH Month - Calendar.MONTH Day of Week - 0 Max Duration - 600 minutes Lock Service - true Recon query filter - null Recon query attributes - Empty list, but this implies all attributes applicable for the resource will be reconciled.

Method Summary

int	getDayOfMonth() Returns the day of the month of schedule of this reconciliation unit.
int	getDayOfWeek() Returns the day of the week of schedule of this reconciliation unit.
int	getHour() Returns the hour of the schedule of this reconciliation unit.
long	getID() Returns the reconciliation unit data id.
long	getLastReconDuration() Returns the duration (in milliseconds) of the last reconciliation event.
long	getMaxDuration() Returns the max duration the reconciliation process, launched using this reconciliation unit, can run.
int	getMinute() Returns the minute of the schedule of this reconciliation unit.
int	getMonth() Returns the month of the schedule of this reconciliation unit.
java.util.Collection	getReconQueryAttributes() Returns the reconciliation query attributes associated with this reconciliation unit.
java.lang.String	getReconQueryFilter() Returns the query filter associated with this reconciliation unit.
boolean	isLockService() Returns true if the service is locked during reconciliation, else returns false.
void	setDayOfMonth(int dayOfMonth) Changes the day of the month of schedule of this reconciliation unit.
void	setDayOfWeek(int dayOfWeek) Changes the day of the week of schedule of this reconciliation unit.
void	setHour(int hour) Changes the hour of the schedule of this reconciliation unit.
void	setID(long id) Sets the reconciliation unit data id.
void	setLastReconDuration(long lastReconDuration) Sets the duration (in milliseconds) of the last reconciliation event
void	setLockService(boolean lockService) Indicates whether the service is locked during reconciliation.
void	setMaxDuration(long maxDuration) Sets the max duration the reconciliation process, launched using this reconciliation unit, can run.
void	setMinute(int minute) Changes the minute of the schedule of this reconciliation unit.
void	setMonth(int month) Changes the month of the schedule of this reconciliation unit.
void	setReconQueryAttributes(java.util.Collection reconQueryAttributes) Sets the attributes that are to be reconciled from the resource.
void	setReconQueryAttributes(java.util.Collection availableReconAttributes, java.util.Collection excludedReconAttributes) Sets the attributes that are to be reconciled from the resource.
void	setReconQueryFilter(java.lang.String filter) Sets the reconciliation query filter associated with this reconciliation unit.
java.lang.String	toString() Returns schedule information of this reconciliation unit in string format.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ReconUnitData

public ReconUnitData()

Default constructor, initializes a reconciliation unit with following default values -

• ID - 0
• Minute - Calendar.MINUTE
• Hour - Calendar.HOUR
• Day of Month - Calendar.DAY_OF_MONTH
• Month - Calendar.MONTH
• Day of Week - 0
• Max Duration - 600 minutes
• Lock Service - true
• Recon query filter - null
• Recon query attributes - Empty list, but this implies all attributes applicable for the resource will be reconciled.

Method Detail

getID

public long getID()

Returns the reconciliation unit data id.

Returns:

id

setID

public void setID(long id)

Sets the reconciliation unit data id. When adding a new reconciliation unit, this is an optional parameter and will be auto-generated by ITIM and a unique ID will be assigned to the reconciliation unit. The default value is 0.

Parameters:

id -

isLockService

public boolean isLockService()

Returns true if the service is locked during reconciliation, else returns false. If a service is locked, any provisioning requests fired during reconciliation using this service, will be suspended and will be executed only after reconciliation process completes. So the service will be dedicated only for reconciliation.

Returns:

setting of the lock service flag.

setLockService

public void setLockService(boolean lockService)

Indicates whether the service is locked during reconciliation. A 'true' value, locks the service during reconciliation, and a 'false' value, unlocks the service. Default setting if not set is 'true'.

Parameters:

lockService - Primitive type boolean value.

getMaxDuration

public long getMaxDuration()

Returns the max duration the reconciliation process, launched using this reconciliation unit, can run. The duration is in minutes.

Returns:

Max duration.

setMaxDuration

public void setMaxDuration(long maxDuration)

Sets the max duration the reconciliation process, launched using this reconciliation unit, can run. The duration should be specified in minutes. Default duration, if not set is 600 minutes.

Parameters:

maxDuration - Max duration.

getLastReconDuration

public long getLastReconDuration()

Returns the duration (in milliseconds) of the last reconciliation event.

setLastReconDuration

public void setLastReconDuration(long lastReconDuration)

Sets the duration (in milliseconds) of the last reconciliation event

getMinute

public int getMinute()

Returns the minute of the schedule of this reconciliation unit.

Returns:

The configured minute.

setMinute

public void setMinute(int minute)

Changes the minute of the schedule of this reconciliation unit.

Parameters:

minute - New minute to configure. Allowed values 0-59.

getHour

public int getHour()

Returns the hour of the schedule of this reconciliation unit.

Returns:

the configured hour. Allowed values 0-23. -1 stands for hourly reconciliation.

setHour

public void setHour(int hour)

Changes the hour of the schedule of this reconciliation unit.

Parameters:

hour - New hour to configure. Allowed values 0-23. Use -1 to configure hourly reconciliation.

getMonth

public int getMonth()

Returns the month of the schedule of this reconciliation unit.

Returns:

The configured month. Allowed values 1-12. -1 stands for monthly reconciliation, 0 to ignore.

setMonth

public void setMonth(int month)

Changes the month of the schedule of this reconciliation unit.

Parameters:

month - New month to configure (-1 if every month, 0 to ignore). Allowed values 1-12 (1 = January, 2 = February, ...). java.util.Calendar constants can be used.

getDayOfWeek

public int getDayOfWeek()

Returns the day of the week of schedule of this reconciliation unit.

Returns:

The configured day of the week.

setDayOfWeek

public void setDayOfWeek(int dayOfWeek)

Changes the day of the week of schedule of this reconciliation unit.

Parameters:

dayOfWeek - New day of the week to configure This attribute is exclusive with dayOfMonth. Allowed values 1-7 (1 = Sunday, 2 = Monday, ...), 0 to ignore. java.util.Calendar constants can be used.

getDayOfMonth

public int getDayOfMonth()

Returns the day of the month of schedule of this reconciliation unit.

Returns:

The configured day of the month or -1 if every day, 0 to ignore.

setDayOfMonth

public void setDayOfMonth(int dayOfMonth)

Changes the day of the month of schedule of this reconciliation unit.

Parameters:

dayOfMonth - New day of the month to configure. This attribute is exclusive with dayOfWeek. Allowed values 1-31, -1 if every day, 0 to ignore.

getReconQueryFilter

public java.lang.String getReconQueryFilter()

Returns the query filter associated with this reconciliation unit. The filter is an LDAP search filter and if specified, then accounts satisfying the filter will only be reconciled. A null or empty value indicates all entries will be reconciled.

Returns:

Reconciliation query filter.

setReconQueryFilter

public void setReconQueryFilter(java.lang.String filter)

Sets the reconciliation query filter associated with this reconciliation unit. The filter is an LDAP search filter and if specified, then accounts satisfying the filter will only be reconciled. This is an optional parameter and if a null or empty value is specified then all entries will be reconciled.

Parameters:

filter - Reconciliation query filter.

getReconQueryAttributes

public java.util.Collection getReconQueryAttributes()

Returns the reconciliation query attributes associated with this reconciliation unit.

Returns:

A collection of reconciliation query attributes.

setReconQueryAttributes

public void setReconQueryAttributes(java.util.Collection reconQueryAttributes)

Sets the attributes that are to be reconciled from the resource. This is an optional parameter, and if not set, or a null or empty collection is set, then all attributes of an entry will be reconciled from the resource.

Parameters:

reconQueryAttributes - A collection of available reconciliation query attributes.

setReconQueryAttributes

public void setReconQueryAttributes(java.util.Collection availableReconAttributes,
                                    java.util.Collection excludedReconAttributes)

Sets the attributes that are to be reconciled from the resource. This is calculated as - availableReconAttributes - excludedReconAttributes.

Parameters:

availableReconAttributes - A collection of all available reconciliation query attribute names.

excludedReconAttributes - A collection of reconciliation query attributes to be excluded.

toString

public java.lang.String toString()

Returns schedule information of this reconciliation unit in string format. Since a schedule uniquely identifies a reconciliation unit for a resource, the string representation only contains the schedule information.

Overrides:

toString in class java.lang.Object

Returns:

String representation of this reconciliation unit.