com.ibm.itim.apps

Class Request

java.lang.Object

com.ibm.itim.apps.Request

Direct Known Subclasses:

BulkRequest, UserRequest

public class Request
extends java.lang.Object

Represents a request submitted to the provisioning platform.

Field Summary

Fields

Modifier and Type	Field and Description
static int	FAILED Constant identifying the failed status.
static int	IN_PROCESS Constant identifying the in-process status.
static int	NOT_STARTED Constant identifying the not-started status.
static int	SUCCEEDED Constant identifying the successfully completed status.
static int	WARNING Constant identifying the warning status.

Constructor Summary

Constructors

Constructor and Description
Request(PlatformContext platform, javax.security.auth.Subject subject, long id) Constructs with a platform, subject, and request id.
Request(PlatformContext platform, javax.security.auth.Subject subject, long id, java.util.Date scheduledTime) Constructs with a platform, subject, request id, and scheduled time.
Request(PlatformContext platform, javax.security.auth.Subject subject, long id, long activityID) Constructs with a platform, subject, and request id.

Method Summary

Modifier and Type	Method and Description
void	abort() Aborts the request.
void	abort(java.lang.String justification) Aborts the request.
com.ibm.itim.apps.ejb.request.RequestAuditData	getAuditData() Returns audit data for the request.
long	getID() Returns the ID of the request.
java.util.Date	getScheduledTime() Returns the time the request was scheduled to begin.
int	getStatus() Returns the status of the request.

Methods inherited from class java.lang.Object

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

Field Detail

NOT_STARTED

public static final int NOT_STARTED

Constant identifying the not-started status.

See Also:

Constant Field Values

IN_PROCESS

public static final int IN_PROCESS

Constant identifying the in-process status.

See Also:

Constant Field Values

SUCCEEDED

public static final int SUCCEEDED

Constant identifying the successfully completed status.

See Also:

Constant Field Values

FAILED

public static final int FAILED

Constant identifying the failed status.

See Also:

Constant Field Values

WARNING

public static final int WARNING

Constant identifying the warning status.

See Also:

Constant Field Values

Constructor Detail

Request

public Request(PlatformContext platform,
               javax.security.auth.Subject subject,
               long id)

Constructs with a platform, subject, and request id.

Parameters:

platform - PlatformContext holding platform connection information.

subject - Authenticated user.

id - Unique id of the request.

Request

public Request(PlatformContext platform,
               javax.security.auth.Subject subject,
               long id,
               long activityID)

Constructs with a platform, subject, and request id.

Parameters:

platform - PlatformContext holding platform connection information.

subject - Authenticated user.

id - Unique id of the request.

activityID - Unique id of the activity in case of batch request.

Request

public Request(PlatformContext platform,
               javax.security.auth.Subject subject,
               long id,
               java.util.Date scheduledTime)

Constructs with a platform, subject, request id, and scheduled time.

Parameters:

platform - PlatformContext holding platform connection information.

subject - Authenticated user.

id - Unique id of the request.

scheduledTime - The scheduled starting time of the process. If null, the process will start immediately. In case this method is invoked remotely, passing this parameter as the current date/time of the client machine is not a safe technique to use, since the date/time of the client machine may not be the same as the date/time of the ITIM server machine.

Method Detail

getID

public long getID()

Returns the ID of the request.

Returns:

ID of the request.

getScheduledTime

public java.util.Date getScheduledTime()
                                throws java.rmi.RemoteException,
                                       ApplicationException

Returns the time the request was scheduled to begin.

Returns:

Date holding the begin time.

Throws:

java.rmi.RemoteException - Thrown if unable to communicate with platform.

ApplicationException - Thrown if no request exists with the given ID.

getStatus

public int getStatus()
              throws java.rmi.RemoteException,
                     ApplicationException

Returns the status of the request.

Returns:

An int representing the request status. The value may be one of the following: NOT_STARTED, IN_PROCESS, SUCCEEDED, WARNING, or FAILED.

Throws:

java.rmi.RemoteException - Thrown if unable to communicate with platform.

ApplicationException - Thrown if no request exists with the given ID.

abort

public void abort()
           throws java.rmi.RemoteException,
                  ApplicationException

Aborts the request.

Throws:

java.rmi.RemoteException - Thrown if unable to communicate with platform.

ApplicationException - Thrown if no request exists with the given ID.

abort

public void abort(java.lang.String justification)
           throws ApplicationException

Aborts the request.

Parameters:

justification - The reason to abort the request. The length limit is 1000.

Throws:

java.rmi.RemoteException - Thrown if unable to communicate with platform.

ApplicationException - Thrown if no request exists with the given ID, or the justification length exceeds the limit.

getAuditData

public com.ibm.itim.apps.ejb.request.RequestAuditData getAuditData()
                                                            throws java.rmi.RemoteException,
                                                                   ApplicationException

Returns audit data for the request.

Throws:

ApplicationException - if an application error occurs.

java.rmi.RemoteException - if a remote error occurs.