com.ibm.able.platform
Interface RmiAbleEServerJobService

All Superinterfaces:
java.rmi.Remote, RmiAblePlatformService, RmiAblePlatformServiceEventGenerator
All Known Implementing Classes:
RmiAbleEServerJobSystem

public interface RmiAbleEServerJobService
extends java.rmi.Remote, RmiAblePlatformService

Defines the behavior of an RMI eServer Job Service.

The AbleEServerJobService interface defines the operations that can be requested of Job service objects.

A Job Service is used to register and deregister platform jobs.

The iSeries startup code uses it to keep track of the jobs so the platform can easily be brought back down.


Method Summary
 void deregisterJob(AbleEServerJobIfc job, AbleSecureKey key)
          This is the method that is used to deregister a job from the Job Service.
 AbleEServerJobIfc getJobInfo(java.lang.String theJobKey)
          Returns the AbleEServerJobIfc that is registered to job key theJobKey.
 void registerJob(AbleEServerJobIfc job, AbleSecureKey key)
          This is the method that is used to register a job to the Job Service.
 
Methods inherited from interface com.ibm.able.platform.RmiAblePlatformService
getState, terminateService
 
Methods inherited from interface com.ibm.able.platform.RmiAblePlatformServiceEventGenerator
addAblePlatformServiceEventListener, getAblePlatformServiceEventListeners, removeAblePlatformServiceEventListener
 

Method Detail

registerJob

public void registerJob(AbleEServerJobIfc job,
                        AbleSecureKey key)
                 throws java.rmi.RemoteException,
                        AbleEServerJobException
This is the method that is used to register a job to the Job Service.

Parameters:
job - The AbleEServerJobIfc job that is to be registered.

key - AbleSecureKey to secure communication

Throws:
java.rmi.RemoteException - On all remote errors.

AbleEServerJobException -

If the caller is not authenticated.

If attempting to register an invalid AbleEServerJobIfc Object.

If there is an existing job registered to the job key of job.


deregisterJob

public void deregisterJob(AbleEServerJobIfc job,
                          AbleSecureKey key)
                   throws java.rmi.RemoteException,
                          AbleEServerJobException
This is the method that is used to deregister a job from the Job Service.

If the platform is running secure, the caller must have an authority level equal to or greater than the one who originally registered the job that is to be removed.

Calls to this method may be delegated, but the VerifiableAgentName at every hop along the way must be authenticated and authorized.

Parameters:
job - The AbleEServerJobIfc job that is to be deregistered.

key - AbleSecureKey to secure communication

Throws:
java.rmi.RemoteException - On all remote errors.

AbleEServerJobException -

If the caller is not authenticated.

If attempting to deregister an invalid AbleEServerJobIfc Object.

If there is not an existing job registered to the job key of job.

If the caller is not authorized.


getJobInfo

public AbleEServerJobIfc getJobInfo(java.lang.String theJobKey)
                             throws java.rmi.RemoteException,
                                    AbleEServerJobException
Returns the AbleEServerJobIfc that is registered to job key theJobKey.

Parameters:
theJobKey - The job key of the AbleEServerJobIfc that is to be returned.

Returns:
AbleEServerJobIfc Object registered to job key theJobKey.

Throws:
java.rmi.RemoteException - On all remote errors.

AbleEServerJobException -

If theJobKey is null.

If no Job is registered to key theJobKey.