com.ibm.etools.iseries.remotebuild
Class JobTicketManager

java.lang.Object
  java.util.Observable
      com.ibm.etools.iseries.remotebuild.JobTicketManager

Deprecated. This class has been moved to com.ibm.etools.systems.as400jobsubsys.impl and you should use this one instead. This class is now just a thin wrapper for the new class to maintain api consistency.

public class JobTicketManager
extends Observable

A JobTicketManager is responsible for managing the set of JobTickets found in the workbench. It updates them with new status when requested by either a user or a timer. It will cause them to be persisted and deleted when necessary.

There is a single instance of this manager in the workbench which is created during workbench initialization. This instance can be retrieved using JobTicketManager.getDefault().

A JobTicketManager implements the Observable interface and can tell observers when a change in its state occurs. This may be useful in designing a user interface that updates when the JobTickets being managed by this JobTicketManager are updated.

Field Summary

static String	Copyright Deprecated.
static Integer	INTERVAL Deprecated. Argument used when notifying observers of a change in the interval.
static int	NEVER Deprecated. The value used to set the timer to never automatically refresh.
static String	PREF_BuildMonitorRefreshInterval Deprecated. The name of the preference that stores the refresh interval.
static Integer	TICKETS Deprecated. Argument used when notifying observers of a change in the tickets.

Method Summary

void	add(JobTicket ticket) Deprecated. Adds a new JobTicket to those being managed.
void	cancel(JobTicket ticket) Deprecated. Cancels a job represented by the job ticket.
void	commitInterval() Deprecated. Commits the manager to begin refreshing at the set interval.
static JobTicketManager	getDefault() Deprecated. Returns the singletime JobTicketManager for this workbench.
int	getInterval() Deprecated. Returns the interval value known by this manager.
JobTicket[]	getTickets() Deprecated. Returns all the tickets known by this manager.
static void	initializeDefaultPreferences() Deprecated. Initializes the default preferences for all JobTicketManagers.
void	refresh() Deprecated. Refreshes all the unfinished tickets being managed by this job manager.
void	remove(JobTicket ticket) Deprecated. Removes a JobTicket from those being managed.
void	resetTimer() Deprecated. Schedules the refresh task so that it will be automatically run.
void	setInterval(int interval) Deprecated. Sets the interval value for this manager.

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Field Detail

Copyright

public static final String Copyright

Deprecated.

See Also:

Constant Field Values

TICKETS

public static final Integer TICKETS

Deprecated.

Argument used when notifying observers of a change in the tickets.

INTERVAL

public static final Integer INTERVAL

Deprecated.

Argument used when notifying observers of a change in the interval.

PREF_BuildMonitorRefreshInterval

public static final String PREF_BuildMonitorRefreshInterval

Deprecated.

The name of the preference that stores the refresh interval.

See Also:

Constant Field Values

NEVER

public static final int NEVER

Deprecated.

The value used to set the timer to never automatically refresh.

See Also:

Constant Field Values

Method Detail

getDefault

public static JobTicketManager getDefault()

Deprecated.

Returns the singletime JobTicketManager for this workbench.

initializeDefaultPreferences

public static void initializeDefaultPreferences()

Deprecated.

Initializes the default preferences for all JobTicketManagers. Used at workbench startup to retrieve the refresh interval. Note: the current value of the refresh interval is always set to NEVER in this method to avoid connecting to the host system on every startup.

Invoked during plugin initialization. Not meant to be called by clients.

resetTimer

public void resetTimer()

Deprecated.

Schedules the refresh task so that it will be automatically run. If the interval is NEVER then the task is not scheduled.

Called by the user interface when a refresh has been performed.

add

public void add(JobTicket ticket)

Deprecated.

Adds a new JobTicket to those being managed. This is the primary client interface. The client will create a job ticket after a job is submitted and add it to the manager as follows:

JobTicket ticket = new JobTicket(project, timeStamp, jobName, jobUser, jobNumber, JobTicket.Queued, connectionName, systemName, tag); JobTicketManager.getDefault().add(ticket);

remove

public void remove(JobTicket ticket)

Deprecated.

Removes a JobTicket from those being managed. If the ticket is not managed by this manager it does nothing.

This is typically invoked by the user interface when a ticket is selected and removed by a user.

cancel

public void cancel(JobTicket ticket)

Deprecated.

Cancels a job represented by the job ticket. This will only cancel the job if the ticket returns a non-null connection. If the ticket is not managed by this manager it does nothing.

Used to implement a "cancel" or "endjob" function by the user interface.

refresh

public void refresh()

Deprecated.

Refreshes all the unfinished tickets being managed by this job manager. If there are no observers then the refresh is skipped. This may be automatically invoked by the timer or may be manually invoked. If it is manually invoked it will cancel and reschedule the current timer task for a new interval.

Usually run by the user interface as the result of a user requested "refresh" action.

Clients are not expected to invoke this as it is invoked by the user interface or a timer.

getTickets

public JobTicket[] getTickets()

Deprecated.

Returns all the tickets known by this manager. These are returned in no particular order.

Used by the user interface to present the remembered jobs to the user.

getInterval

public int getInterval()

Deprecated.

Returns the interval value known by this manager. This is the number of seconds between refreshes. It is NEVER if the manager never refreshes.

The value is expressed in seconds.

setInterval

public void setInterval(int interval)

Deprecated.

Sets the interval value for this manager. This is the number of seconds between refreshes. It is NEVER if the manager never refreshes.

Setting the interval notifies all observers the the interval setting has been changed. However, the interval must be committed to affect the refresh rate of this manager.

The value is expressed in seconds.

commitInterval

public void commitInterval()

Deprecated.

Commits the manager to begin refreshing at the set interval. This is done so that the interval may be adjusted several times prior to being committed.