Interfaces EJB du planificateur de travaux
L'interface Enterprise JavaBeans (EJB) du planificateur de travaux est utilisée pour soumettre un travail par lots au planificateur de travail et de le manipuler à l'aide d'un programme.
Le code suivant est l'interface distante de l'EJB planificateur de travaux. Le code produit des API.
Certains éléments de code sont répartis sur plusieurs lignes pour faciliter l'impression.
/**
* Il s'agit de l'interface distante de l'EJB planificateur de travaux.
* Les clients de cette interface peuvent soumettre et manipuler des travaux à l'aide d'un programme par
* le planificateur de travaux. Des codes similaires au suivant peuvent être utilisés pour rechercher et appeler
* l'interface EJB du planificateur de travaux distante :
*
* InitialContext ctxt = new InitialContext();
* Hashtable env = new Hashtable();
*
* env.put (Context.INITIAL_CONTEXT_FACTORY,
* "com.ibm.websphere.naming.WsnInitialContextFactory");
* env.put(Context.PROVIDER_URL,
* "corbaloc:iiop:<schedulerHostName>:<schedulerBootstrapPort>/NameServiceCellRoot");
* ctxt = new InitialContext(env);
*
* // Pour rechercher l'EJB du planificateur de travaux à partir de la cellule de contexte dans l'espace de nom,
* // le contexte du nom sur le serveur d'applications ou le cluster sur lequel l'application du planificateur de travaux
* // est déployée doit être fourni.
* // Par exemple : "nodes/myNode/servers/myServer" or "clusters/myCluster".
*
* String jobSchedulerContext = clusters/myCluster;
*
* JobSchedulerHome zjsHome = (JobSchedulerHome)
* PortableRemoteObject.narrow(ctxt.lookup(jobSchedulerContext +
* "/ejb/com/ibm/websphere/longrun/JobSchedulerHome"),JobSchedulerHome.class);
*
* JobScheduler js = zjsHome.create();
*
*
* @ibm-api
*/
public interface JobScheduler extends javax.ejb.EJBObject {
/**
* Soumet le travail indiqué, enregistré dans le référentiel xJCL, au planificateur de travaux
* @param job Nom du travail qui a été enregistré dans le référentiel xJCL
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors de la soumission du travail
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*/
public String submitJobFromRepository( String job ) throws
InvalidJobNameException,
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Soumet le travail, défini par xJCL, au planificateur de travaux
*
* @param xJCL xJCL correspondant au travail
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors de la soumission du travail
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*
*/
public String submitJob( String xJCL ) throws
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Soumet le travail indiqué par le xJCL transmis au planificateur de travaux et
* sauvegarde le xJCL dans le référentiel xJCL.
*
* @param xJCL xJCL correspondant au travail
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL.
* Ce nom peut être utilisé lors de l'appel de la méthode
* submitJobFromRepository
* @param replace Valeur booléenne indiquant si le xJCL du référentiel doit
* être remplacé si un travail existe déjà sous ce nom
* dans le référentiel xJCL.
*
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws InvalidOperationException si le travail existe déjà dans le référentiel xJCL
* et si le paramètre replace a la valeur false
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*
*/
public String saveJobToRepositoryAndSubmit( String xJCL, String job, boolean replace ) throws
InvalidOperationException,
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Supprime le travail identifié par l'ID de travail des environnements du planificateur de travaux et du noeud final
* de grille.
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la purge du travail
* @throws java.rmi.RemoteException
*
* @param jobid ID du travail à purger
*/
public void purgeJob( String jobid ) throws
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Annule le travail identifié par l'ID de travail.
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le
* planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de l'annulation du travail
* @throws java.rmi.RemoteException
*
* @param jobid ID du travail
*/
public void cancelJob( String jobid ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Force l'annulation du travail identifié par l'ID de travail
*
* Sous z/OS uniquement. La demande forcedCancelJob sera exécutée en tant que
* demande cancelJob sur des plateformes réparties.
*
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le
* planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de l'annulation du travail
* @throws java.rmi.RemoteException
*
* @param jobid ID du travail
*/
public void forcedCancelJob( String jobid ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Redémarre le travail identifié par l'ID de travail. Seuls les travaux à l'état redémarrable peuvent être
* redémarrés.
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le
* planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du redémarrage du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*
* @param jobid ID du travail
*/
public void restartJob( String jobid ) throws
InvalidJobIDException,
InvalidOperationException,
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Renvoie l'état du travail pour l'ID de travail concerné. Reportez-vous à {@link JobStatusConstants
* JobStatusConstants} pour obtenir une
* liste des codes d'état de travail renvoyés par cette méthode.
*
* @param jobid ID du travail
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le
* planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
* @return l'état du travail.
*/
public int getJobStatus( String jobid ) throws
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie la sortie du travail pour un ID de travail donné affichant la progression du travail. S'applique
* uniquement aux travaux par lots.
*
* @param jobid ID du travail
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
* @return la sortie du travail
*/
public String getJobOutput( String jobid ) throws
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie les détails du travail pour l'ID de travail concerné.
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
* @return les caractéristiques du travail, telles que l'ID, l'état, le type d'émetteur et de travail
*/
public String getJobDetails(String jobid) throws
InvalidJobIDException,SchedulerException,java.rmi.RemoteException;
/**
* Sauvegarde le xJCL transmis au référentiel xJCL.
*
* @param xJCL xJCL correspondant au travail
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL. Ce nom peut
* être utilisé lors de l'appel de la méthode submitJobFromRepository
* submitJobFromRepository
* @param replace Valeur booléenne indiquant si le xJCL du référentiel doit être
* remplacé si un travail existe déjà sous ce nom
* dans le référentiel xJCL.
*
* @throws InvalidOperationException si le travail existe déjà dans le référentiel xJCL
* et si le paramètre replace a la valeur false
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws java.rmi.RemoteException
*
*/
public void saveJobToRepository( String xJCL, String job, boolean replace ) throws
InvalidOperationException,
SchedulerException,
JCLException,
java.rmi.RemoteException;
/**
* Renvoie le xJCL à partir du référentiel xJCL à partir du nom de travail concerné.
*
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL. Ce nom peut être utilisé
* lors de l'appel de la méthode submitJobFromRepository
* submitJobFromRepository
*
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
* @return le xJCL pour le travail concerné.
*/
public String showJobFromRepository( String job ) throws
InvalidJobNameException,
SchedulerException,
java.rmi.RemoteException;
/**
* Supprime le xJCL pour le travail indiqué dans le référentiel xJCL.
*
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL.
*
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
*/
public void removeJobFromRepository( String job ) throws
InvalidJobNameException,
SchedulerException,
java.rmi.RemoteException;
/**
* Affiche tous les travaux dans le planificateur de travaux
*
* @return la liste des ID de tous les travaux dans le planificateur de travaux
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
*/
public String[] showAllJobs() throws
SchedulerException,
java.rmi.RemoteException;
/**
* Suspend le travail indiqué pendant le nombre de secondes indiqué. Une fois le temps indiqué
* écoulé, le travail reprend
* automatiquement. Applicable uniquement aux travaux par lots.
*
* @param jobid ID du travail à suspendre
* @param seconds Nombre de secondes nécessaires pour suspendre le travail
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de l'interruption du travail
* @throws java.rmi.RemoteException
*
*/
public void suspendJob( String jobid, String seconds ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Reprend l'exécution du travail spécifié. Applicable uniquement aux travaux par lots.
*
* @param jobid ID du travail à reprendre
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le
* planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la reprise du travail
* @throws java.rmi.RemoteException
*
*/
public void resumeJob( String jobid ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie le code retour du travail par lots.
*
* @param jobid ID du travail
* Renvoie le code retour du travail par lots.
*
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
*/
public int getBatchJobRC(String jobid) throws InvalidOperationException, InvalidJobIDException, SchedulerException, java.rmi.RemoteException;
/**
* Soumet le travail, défini par xJCL, au planificateur de travaux
* à l'heure de début indiquée.
*
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @return ID de travail attribué par le planificateur de travaux au travail soumis
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont
* pas au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures à
* l'heure courante
* @throws java.rmi.RemoteException
*/
public String submitDelayedJob( String xJCL, String startTime ) throws
SchedulerException,
JCLException,
JobSubmissionException,
InvalidStartDateTimeFormatException,
StaleTimeException,
java.rmi.RemoteException;
/**
* Soumet le travail, enregistré dans le référentiel xJCL, au planificateur de travaux
* à l'heure de début indiquée.
*
* @param job Nom du travail qui a été enregistré dans le référentiel des travaux
* @param startTime Heure à laquelle le travail sera soumis. Le format de l'heure de soumission
* est aaaa-mm-jj hh:mm:ss.
* @return ID de travail attribué par le planificateur de travaux au travail soumis
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont
* pas au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws java.rmi.RemoteException
*/
public String submitDelayedJobFromRepository( String job, String startTime ) throws
InvalidJobNameException,
SchedulerException,
JCLException,
JobSubmissionException,
InvalidStartDateTimeFormatException,
StaleTimeException,
java.rmi.RemoteException;
/**
* Soumet le travail retardé indiqué par le xJCL transmis au planificateur de travaux et
* sauvegarde le xJCL dans le référentiel xJCL.
*
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL. Ce nom peut
* être utilisé lors de l'appel de la méthode submitJobFromRepository
* submitJobFromRepository
* @param replace Valeur booléenne indiquant si le xJCL du référentiel doit être remplacé
* si un travail existe déjà sous ce nom
* dans le référentiel du travail.
* @return ID de travail attribué par le planificateur de travaux au travail soumis
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont pas
* au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures à
* l'heure courante
* @throws java.rmi.RemoteException
*/
public String saveDelayedJobToRepositoryAndSubmit( String xJCL, String job, boolean replace, String startTime ) throws
InvalidOperationException,
SchedulerException,
JCLException,
JobSubmissionException,
InvalidStartDateTimeFormatException,
StaleTimeException,
java.rmi.RemoteException;
/**
* Crée une planification de travaux pour soumettre le travail, définie par le xJCL, à l'heure et
* à l'intervalle indiqués.
*
* @param reqId Nom de la demande de travail récurrente
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le premier travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param Intervalle entre les travaux (par exemple quotidien, hebdomadaire, mensuel)
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont pas
* au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws InvalidIntervalException si l'intervalle indiqué n'est pas l'un de
* ceux pris en charge
* @throws java.rmi.RemoteException
*/
public void submitRecurringRequest( String reqId, String xJCL, String startTime, String interval ) throws
InvalidOperationException,
SchedulerException,
JCLException,
InvalidStartDateTimeFormatException,
InvalidIntervalException,
StaleTimeException,
java.rmi.RemoteException;
/**
* Crée une planification de travaux pour soumettre le travail indiqué, enregistrée dans le référentiel xJCL, à
* l'heure et à l'intervalle indiqués.
*
* @param jobName Nom du travail enregistré dans le référentiel des travaux
* @param reqId Nom de la demande de travail récurrente
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param Intervalle entre les travaux (par exemple quotidien, hebdomadaire, mensuel)
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont pas
* au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* l'heure courante
* @throws InvalidIntervalException si l'intervalle indiqué n'est pas l'un de ceux pris
* en charge
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws java.rmi.RemoteException
*/
public void submitRecurringRequestFromRepository(String jobName, String reqId, String startTime, String interval) throws
InvalidOperationException,
SchedulerException,
JCLException,
InvalidStartDateTimeFormatException,
InvalidIntervalException,
StaleTimeException,
InvalidJobNameException,
java.rmi.RemoteException;
/**
* Annuler une planification de travaux existante
*
* @param reqId Nom de la planification de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de l'annulation du travail
* @throws java.rmi.RemoteException
*/
public void cancelRecurringRequest( String reqId ) throws
InvalidOperationException,
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie les caractéristiques d'une planification de travaux existante.
*
* @param reqId Nom de la planification de travaux à renvoyer
* @return les informations relatives à la planification, telles que le nom de la planification, le nom du travail et l'heure de début et
* d'intervalle
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String getRecurringRequestDetails(String reqId) throws
SchedulerException,
InvalidOperationException,
java.rmi.RemoteException;
/**
* Modifier une planification de travaux existante.
*
* @param reqId Nom de la planification de travaux à modifier
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le premier travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param Intervalle entre les travaux (par exemple quotidien, hebdomadaire, mensuel)
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont pas au
* au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures à
* l'heure courante
* @throws InvalidIntervalException si l'intervalle indiqué n'est pas l'un de ceux pris
* en charge
* @throws java.rmi.RemoteException
*/
public void modifyRecurringRequest(String reqId, String xJCL, String startTime, String interval) throws
SchedulerException,
JCLException,
InvalidOperationException,
InvalidStartDateTimeFormatException,
StaleTimeException,
InvalidIntervalException,
java.rmi.RemoteException;
/**
* Répertorie toutes les planifications de travaux existantes
*
* @return une liste de toutes les planifications de travaux actuellement dans le système
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*/
public String[] showAllRecurringRequests() throws
SchedulerException,
java.rmi.RemoteException;
/**
* Afficher tous les travaux dans la planification de travaux indiquée
*
* @param reqId Nom de la planification de travaux
* @return la liste des ID des travaux dans la planification de travaux indiquée
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] showRecurringJobs(String reqId) throws
SchedulerException,
InvalidOperationException,
java.rmi.RemoteException;
/**
* Renvoie l'état de travail au format XML pour les ID de travaux donnés.
*
* @param jobid Liste des ID de travaux
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
* @return Etat de travail tel que l'ID du travail, le code retour, le code d'état et l'état au format XML
*/
public String getJobsStatus(String[] jobid) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie une liste des ID de travaux correspondant aux critères indiqués. Toutes les conditions doivent s'appliquer
* pour qu'une correspondance se produise.
*
* @param jobFilter Valeur du filtre SQL à appliquer à l'ID de travail (par exemple Postings%)
* @param submitterFilter Valeur du filtre SQL à appliquer à l'émetteur
* @param nodeFilter Valeur du filtre SQL à appliquer aux noms des noeuds sur lesquels les
* travaux sont exécutés (par exemple node_ )
* @param appServerFilter Valeur du filtre SQL à appliquer aux noms des serveurs d'applications
* sur lesquels les travaux sont exécutés
* @param stateFilter Liste des états des travaux. Reportez-vous à {@link JobStatusConstants
* JobStatusConstants} pour obtenir une
* liste des états de travaux possibles.
* @param sortBy - Zone utilisée pour trier des résultats (par exemple JOBID, STATUS, APPSERVER)
* @param ascending - Balise indiquant si les résultats doivent être renvoyés par
* ordre croissant ou décroissant
* dans la zone sortBy.
*
* @return la liste des ID de travaux correspondant aux critères indiqués
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*/
public String[] getJobsId(String jobFilter, String submitterFilter, String nodeFilter, String appServerFilter, Integer[] stateFilter, String sortBy, boolean ascending) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Annule les travaux identifiés par la liste des ID de travaux.
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de l'annulation du travail
* @throws java.rmi.RemoteException
*
* @param jobid Liste des ID de travaux à annuler
* @return Liste des codes retour. Reportez-vous à {@link JobSchedulerConstants JobSchedulerConstants}
* pour obtenir une liste des codes retour possibles.
*/
public int[] cancelJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Supprime les travaux identifiés par la liste des ID de travaux des environnements du planificateur de travaux et
* du noeud final.
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la purge du travail
* @throws java.rmi.RemoteException
*
* @param jobid Liste des ID de travaux à purger
* @return Liste des codes retour. Consultez la rubrique
* {@link JobSchedulerConstants JobSchedulerConstants} pour obtenir une liste des codes retour
* possibles.
*/
public int[] purgeJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Redémarre les travaux identifiés par la liste des ID de travaux. Seuls les travaux
* à l'état redémarrable peuvent être redémarrés.
*
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors du redémarrage du travail
* @throws java.rmi.RemoteException
*
* @param jobid Liste des ID de travaux à redémarrer
* @return Liste des codes retour. Reportez-vous à {@link JobSchedulerConstants
* JobSchedulerConstants} pour obtenir une liste des codes retour possibles.
*/
public int[] restartJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Reprend l'exécution des travaux identifiés par la liste des ID de travaux. S'applique
* uniquement aux travaux par lots.
*
* @param jobid Liste des ID de travaux à reprendre
* @return Liste des codes retour. Reportez-vous à {@link JobSchedulerConstants
* JobSchedulerConstants} pour obtenir une liste des codes retour possibles.
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la reprise du travail
* @throws java.rmi.RemoteException
*
*/
public int[] resumeJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Suspend les travaux indiqués pendant le nombre de secondes indiqué. Une fois
* le temps indiqué écoulé, les travaux reprennent
* automatiquement. Applicable uniquement aux travaux par lots.
*
* @param jobid ID du travail à suspendre
* @param seconds Nombre de secondes nécessaires pour suspendre le travail
* @return Liste des codes retour. Reportez-vous à {@link JobSchedulerConstants
* JobSchedulerConstants} pour obtenir une liste des codes retour possibles.
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors de l'interruption du travail
* @throws java.rmi.RemoteException
*
*/
public int[] suspendJob( String[] jobid, String seconds ) throws
SchedulerException,
InvalidOperationException,
java.rmi.RemoteException;
/**
* Soumet le travail indiqué, enregistré dans le référentiel xJCL, ainsi que toute paire nom/valeur
* indiquée dans le planificateur de travaux
* à l'heure de début indiquée.
*
* @param job Nom du travail qui a été enregistré dans le référentiel xJCL
* @param startTime Heure à laquelle le travail sera soumis. Le format de l'heure de soumission
* est aaaa-mm-jj hh:mm:ss.
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
*
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont pas
* au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws java.rmi.RemoteException
*/
public String submitModifiableDelayedJobFromRepository( String job, String startTime,
String nameValuePairs )
throws InvalidJobNameException, SchedulerException, JCLException, JobSubmissionException,
InvalidStartDateTimeFormatException, StaleTimeException, java.rmi.RemoteException;
/**
* Soumet le travail, défini par xJCL, ainsi que toutes les paires nom/valeur indiquées, au
* planificateur de travaux
* à l'heure de début indiquée.
*
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
*
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont
* pas au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws java.rmi.RemoteException
*/
public String submitModifiableDelayedJob
( String xJCL, String startTime, String nameValuePairs )
throws SchedulerException, JCLException, JobSubmissionException,
InvalidStartDateTimeFormatException, StaleTimeException, java.rmi.RemoteException;
/**
* Soumet le travail retardé, défini par xJCL, ainsi que toutes les paires nom/valeur indiquées, au
* planificateur de travaux et
* sauvegarde le xJCL dans le référentiel xJCL.
*
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL. Ce nom
* peut être utilisé lors de l'appel de la méthode submitJobFromRepository
* submitJobFromRepository
* @param replace Valeur booléenne indiquant si le xJCL du référentiel doit être
* remplacé si un travail existe déjà sous ce nom
* dans le référentiel du travail.
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
*
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont
* pas au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws java.rmi.RemoteException
*/
public String saveModifiableDelayedJobToRepositoryAndSubmit
( String xJCL, String job, boolean replace, String startTime, String nameValuePairs )
throws InvalidOperationException, SchedulerException, JCLException, JobSubmissionException,
InvalidStartDateTimeFormatException, StaleTimeException, java.rmi.RemoteException;
/**
* Crée une planification de travaux pour soumettre des travaux à l'intervalle de temps indiqué. Les travaux
* sont définis par le xJCL ainsi que toutes les paires nom/valeur indiquées.
*
* @param reqId Nom de la planification de travaux
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param Intervalle entre les travaux (par exemple quotidien, hebdomadaire, mensuel)
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
*
* @throws InvalidOperationException si l'opération n'est actuellement pas
* autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont
* pas au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws InvalidIntervalException si l'intervalle indiqué n'est pas l'un des
* intervalles de temps pris en charge
* @throws java.rmi.RemoteException
*/
public void submitModifiableRecurringRequest
( String reqId, String xJCL, String startTime, String interval, String nameValuePairs )
throws InvalidOperationException, SchedulerException, JCLException,
InvalidStartDateTimeFormatException,
InvalidIntervalException, StaleTimeException, java.rmi.RemoteException;
/**
* Crée une planification de travaux pour soumettre des travaux à l'intervalle de temps indiqué. Les travaux
* sont définis par le xJCL stocké dans le référentiel xJCL
* ainsi que toutes les paires nom/valeur indiquées.
*
* @param jobName Nom du travail enregistré dans le référentiel des travaux
* @param reqId Nom de la demande de travail récurrente
* @param startTime Heure à laquelle le travail sera soumis. Le format de
* l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param Intervalle entre les travaux (par exemple quotidien, hebdomadaire, mensuel)
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
*
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL correspondant au travail est altéré ou non valide
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont pas
* au format requis
* @throws StaleTimeException si la date et/ou l'heure sont antérieures
* à l'heure courante
* @throws InvalidIntervalException si l'intervalle indiqué n'est pas l'un de
* ceux pris en charge
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws java.rmi.RemoteException
*/
public void submitModifiableRecurringRequestFromRepository(String jobName, String
reqId, String startTime, String interval, String nameValuePairs )
throws InvalidOperationException, SchedulerException, JCLException,
InvalidStartDateTimeFormatException,
InvalidIntervalException, StaleTimeException, InvalidJobNameException,
java.rmi.RemoteException;
/**
* Soumet le travail, défini par xJCL, ainsi que toutes les paires nom/valeur indiquées, au
* planificateur de travaux et
* sauvegarde le xJCL dans le référentiel xJCL.
*
* @param xJCL xJCL correspondant au travail
* @param job Nom donné au travail sauvegardé dans le référentiel xJCL. Ce nom
* peut être utilisé lors de l'appel de la méthode submitJobFromRepository
* submitJobFromRepository
* @param replace Valeur booléenne indiquant si le xJCL du référentiel doit
* être remplacé si un travail existe déjà sous ce nom
* dans le référentiel xJCL.
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
*
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws InvalidOperationException si le travail existe déjà dans le référentiel xJCL
* et si le paramètre replace a la valeur false
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors de la soumission du travail
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*
*/
public String saveModifiableJobToRepositoryAndSubmit( String xJCL, String job,
boolean replace, String nameValuePairs )
throws InvalidOperationException, SchedulerException, JCLException,
JobSubmissionException, java.rmi.RemoteException;
/**
* Soumet le travail indiqué, enregistré dans le référentiel xJCL, ainsi que toute paire nom/valeur
* indiquée dans le planificateur de travaux
*
* @param job Nom du travail qui a été enregistré dans le référentiel xJCL
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple, "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws InvalidJobNameException si le travail est introuvable dans le référentiel
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*/
public String submitModifiableJobFromRepository( String job, String nameValuePairs )
throws InvalidJobNameException, SchedulerException, JCLException, JobSubmissionException,
java.rmi.RemoteException;
/**
* Soumet le travail, défini par xJCL, ainsi que toutes les paires nom/valeur indiquées, au
* planificateur de travaux
*
* @param xJCL xJCL correspondant au travail
* @param nameValuePairs Paires nom-valeur délimitées par des espaces et utilisées pour
* modifier le xJCL (par exemple "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
* @return ID de travail attribué par le planificateur de travaux au travail soumis
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la soumission du travail
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws JobSubmissionException si une erreur survient lors de la soumission du travail
* @throws java.rmi.RemoteException
*
*/
public String submitModifiableJob( String xJCL, String nameValuePairs )
throws SchedulerException, JCLException, JobSubmissionException, java.rmi.RemoteException;
/**
* Modifier une planification de travaux existante.
*
* @param reqId Nom de la planification de travaux à modifier
* @param xJCL xJCL correspondant au travail
* @param startTime Heure à laquelle le premier travail
* sera soumis. Le format de l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param interval Intervalle entre les travaux
* (par exemple quotidien, hebdomadaire, mensuel)
* @param nameValuePairs Paires nom-valeur délimitées par des espaces
* utilisées pour modifier le xJCL (par exemple "host=myhost port=myport")
* Toutes les valeurs contenant des caractères spéciaux ou des espaces doivent disposer d'une URL codée avec un
* schéma de codage UTF-8 pour être transmises à la requête.
* @throws SchedulerException si une erreur inattendue est émise par le
* planificateur de travaux lors du traitement de la commande
* @throws JCLException si le xJCL correspondant au travail est altéré
* ou non valide.
* @throws InvalidOperationException si l'opération n'est actuellement pas
* autorisée sur le travail
* @throws InvalidStartDateTimeFormatException si la date et/ou l'heure de démarrage ne sont
* pas au format requis
* @throws StaleTimeException si la date et/ou l'heure de démarrage ne sont
* à l'heure courante
* @throws InvalidIntervalException si l'intervalle indiqué n'est pas
* l'un des intervalles de temps pris en charge
* @throws java.rmi.RemoteException
*/
public void modifyModifiableRecurringRequest(String reqId, String xJCL,
String startTime, String interval, String nameValuePairs)
throws SchedulerException, JCLException, InvalidOperationException,
InvalidStartDateTimeFormatException, StaleTimeException, InvalidIntervalException,
java.rmi.RemoteException;
/**
* Renvoie une liste de noms de travaux dans le référentiel correspondant aux critères
* indiqués. Toutes les conditions doivent s'appliquer pour qu'une correspondance se produise.
*
* @param jobNameFilter Valeur du filtre SQL à appliquer aux noms de travaux (par exemple Postings% )
* @param jobDescFilter non utilisé
* @param sortBy - Zone utilisée pour trier des résultats (par exemple JOBNAME, TXT)
* @param ascending - Balise indiquant si les résultats doivent être renvoyés par
* ordre croissant ou décroissant
* dans la zone sortBy.
*
* @return la liste des noms de travaux correspondant aux critères indiqués
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la requête
* @throws java.rmi.RemoteException
*/
public String[] getJobsName(String jobNameFilter, String jobDescFilter, String sortBy, boolean ascending) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Arrête le travail identifié par l'ID de travail.
*
* @throws InvalidOperationException si l'opération n'est actuellement pas
* autorisée sur le travail
* @throws InvalidJobIDException si aucun travail n'existe sous l'ID indiqué dans le
* planificateur de travaux
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la requête
* @throws java.rmi.RemoteException
*
* @param jobid ID du travail
*/
public void stopJob( String jobid )
throws InvalidOperationException, InvalidJobIDException, SchedulerException,
java.rmi.RemoteException;
/**
* Arrête les travaux identifiés par la liste des ID de travaux.
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de la purge du travail
* @throws java.rmi.RemoteException
*
* @param jobid Liste des ID de travaux à arrêter
* @return Liste des codes retour. Reportez-vous à {@link JobSchedulerConstants
* JobSchedulerConstants} pour obtenir une liste des codes retour possibles.
*/
public int[] stopJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Analyse le xJCL pour générer une mappe de toutes les variables symboliques utilisées dans le xJCL
* qui ne sont pas des propriétés système
* @param xJCL xJCL correspondant au travail
* @return une mappe de paires nom/valeur avec valeur par défaut; value==null ==> aucune valeur par défaut
* dans substitution-props
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws JCLException si le xJCL stocké dans le référentiel est altéré ou non valide
* @throws java.rmi.RemoteException
*
*/
public String getSymbolicVariables( String clientXJCL )
throws SchedulerException, JCLException, java.rmi.RemoteException;
/**
* Renvoie des informations de planification de travaux au format XML pour les noms de planification de travaux donnés.
*
* @param requestid Liste de noms de planifications de travaux
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
* @return Informations de planification de travaux au format XML, telles que le nom de planification de travaux,
* le nom du travail, l'intervalle de temps et l'heure de début
*/
public String getRequests(String[] requestid) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie une liste des noms de planifications de travaux correspondant aux critères indiqués. Toutes les conditions
* doivent s'appliquer pour qu'une correspondance se produise.
*
* @param requestIdFilter Valeur du filtre SQL à appliquer au nom de la planification de travaux
* (par exemple %Postings% )
* @param startTimeFilter Valeur du filtre SQL à appliquer à l'heure de soumission initiale des
* travaux. Le format de l'heure de soumission est aaaa-mm-jj hh:mm:ss.
* @param submitterFilter Valeur du filtre SQL à appliquer à l'émetteur
* @param intervalFilter Liste du temps écoulé entre des soumissions de travaux (par exemple quotidiennes,
* hebdomadaires, mensuelles)
* @param statusFilter Liste des états des travaux. Consultez la rubrique
* {@link JobStatusConstants JobStatusConstants} pour obtenir une
* liste des états de travaux possibles.
* @param sortBy - Zone utilisée pour trier des résultats (par exemple REQUESTID, STARTTIME, INTERVAL)
* @param ascending - Balise indiquant si les résultats doivent être renvoyés par
* ordre croissant ou décroissant
* dans la zone sortBy.
*
* @return la liste des noms de planification de travaux correspondant aux critères indiqués
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*/
public String[] getRequestsId(String requestIdFilter, String startTimeFilter, String submitterFilter, String[] intervalFilter, Integer[] statusFilter, String sortBy, boolean ascending) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Annuler des planifications de travaux existantes
*
* @param reqId Liste des noms de planification de travaux à annuler
* @return Liste des codes retour. Consultez la rubrique
* {@link JobSchedulerConstants JobSchedulerConstants} pour obtenir une liste des
* codes retour possibles.
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors de l'annulation du travail
* @throws java.rmi.RemoteException
*/
public int[] cancelRecurringRequest( String[] reqId ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Renvoie le journal des travaux compressé associé à l'ID de travail demandé
*
* @param jobid ID du travail dont le nom du fichier journal doit être renvoyé
* @return le nom du système de fichiers pour le journal des travaux du travail indiqué.
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucun journal des travaux n'est trouvé par le planificateur de grille pour l'ID de travail indiqué
* par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String getJobLog( String jobid ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Renvoie les métadonnées du journal des travaux associé à l'ID de travail demandé
* (liste des différents sous-répertoires de journal de travaux pour l'ID de travail)
*
* @param jobid ID du travail dont les métadonnées doivent être renvoyées
* @return les métadonnées du journal des travaux pour le travail indiqué.
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune métadonnée de journal des travaux pour l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getLogMetaData( String jobid ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Renvoie la partie du journal des travaux associée à l'ID de travail demandé et au sous-répertoire du journal.
*
* @param jobid ID du travail dont les informations partielles doivent être renvoyées
* @param logSubDirName Nom du sous-répertoire du travail dont
* les informations doivent être renvoyées
* @return les informations partielles du journal des travaux pour le travail indiqué.
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune information partielle relative à l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getLogPartList( String jobid, String logSubDirName ) throws
SchedulerException, InvalidJobIDException, InvalidOperationException,
java.rmi.RemoteException;
/**
* Renvoie le contenu du fichier journal du travail associé à l'ID de travail demandé,
* au sous-répertoire du journal et au numéro de composant
*
* @param jobid ID du travail dont les informations partielles doivent être renvoyées
* @param logSubDirName Nom du sous-répertoire du travail dont
* les informations doivent être renvoyées
* @param partNumber Nom du bloc du journal des travaux dans le sous-répertoire du journal dont
* les informations partielles doivent être renvoyées
*
* @return le contenu de la partie du journal des travaux pour le travail indiqué et le sous-répertoire du journal
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune information partielle relative à l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getLogPart( String jobid, String logSubDirName, String partNumber )
throws SchedulerException, InvalidJobIDException, InvalidOperationException,
java.rmi.RemoteException;
/**
* Renvoie la taille en octets du fichier du journal des travaux associé à l'ID de travail demandé.
*
* @param jobid ID du travail pour lequel les informations de taille doivent être renvoyées
* @param logSubDirName Nom du sous-répertoire du travail dont
* les informations doivent être renvoyées
* @return la taille du journal des travaux pour le travail indiqué
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune information de taille relative à l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String getLogSize( String jobid, String logSubDirName ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Renvoie l'ancienneté du fichier du journal des travaux associé à l'ID de travail demandé et au
* sous-répertoire du journal.
*
* @param jobid ID du travail dont les informations d'ancienneté doivent être renvoyées
* @param logSubDirName Nom du sous-répertoire du travail dont
* les informations d'ancienneté doivent être renvoyées
*
* @return l'ancienneté, en nombre de jours, du journal des travaux pour le nom de travail indiqué et du sous-répertoire du journal.
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune information d'ancienneté relative à l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public int getLogAge( String jobid, String logSubDirName ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Renvoie la liste des journaux des travaux associés à la classe de travail demandée.
*
* @param jobid Identificateur de classe dont les informations de liste des travaux doivent être renvoyées
* @param jobClass Identificateur de classe pour la correspondance
* @return une liste de tous les ID de travail dont l'identificateur de classe correspond à la classe de travail indiquée.
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getJobsByClass( String jobClass ) throws SchedulerException,
InvalidOperationException, java.rmi.RemoteException;
/**
* Supprime le journal des travaux compressé associé à l'ID de travail demandé [ il s'agit de
* l'action complémentaire obligatoire sur {@link JobScheduler#getJobLog(String) getJobLog(jobid) ]
*
* @param jobid ID du travail dont le fichier de journal compressé doit être supprimé
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune information partielle relative à l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public void removeJobLog( String jobid ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Purge le fichier du journal des travaux associé à l'ID de travail et au sous-répertoire du journal demandés.
*
* @param jobid ID du travail dont le journal des travaux doit être purgé
* @param logSubDirName Nom du sous-répertoire du journal du travail dont le journal des travaux
* doit être purgé
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si aucune information de travail relative à l'ID de travail indiqué n'est
* trouvée par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public void purgeJobLog( String jobid, String logSubDirName ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Renvoie les adresses JMX du cluster du planificateur.
*
* @return les adresses JMX du cluster du planificateur.
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getAdminAddresses() throws SchedulerException, InvalidOperationException,
java.rmi.RemoteException;
/**
* Extrait une liste des préférences utilisateur pour un ID utilisateur donné et une portée donnée.
* @param userId ID utilisateur utilisé pour se connecter à la console de gestion des travaux
* @param prefScope Portée des préférences dans la console de gestion des travaux
* (par exemple JobCollectionForm, SavedJobCollectionForm,
* JobScheduleCollectionForm)
* @return une liste des préférences utilisateur au format nom-valeur
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
*/
public String[] getUserPrefs( String userId, String prefScope ) throws SchedulerException, java.rmi.RemoteException;
/**
* Enregistre la liste des préférences utilisateur pour un ID utilisateur donné et une portée donnée.
* @param userId ID utilisateur utilisé pour se connecter à la console de gestion des travaux
* @param prefScope Portée des préférences dans la console de gestion des travaux
* (par exemple JobCollectionForm, SavedJobCollectionForm,
* JobScheduleCollectionForm)
* @param prefNameValue Liste des préférences utilisateur au format nom-valeur
*
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws java.rmi.RemoteException
*
*/
public void saveUserPrefs( String userId, String prefScope, String[] prefNameValue) throws SchedulerException, java.rmi.RemoteException;
/**
* Renvoie la liste des journaux des travaux associés à la classe de travail demandée, triée selon l'ancienneté des journaux.
*
* @param jobClass Identificateur de classe pour la correspondance
* @return une liste de tous les ID de travail dont l'identificateur de classe correspond à la classe de travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getJobLogMetaDataByAgeForClass( String jobClass ) throws
SchedulerException, InvalidOperationException, java.rmi.RemoteException;
/**
* Renvoie la liste des journaux des travaux associés à la classe de travail demandée, triée selon la taille des journaux.
*
* @param jobClass Identificateur de classe pour la correspondance
* @return une liste de tous les ID de travail dont l'identificateur de classe correspond à la classe de travail
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public String[] getJobLogMetaDataBySizeForClass( String jobClass ) throws
SchedulerException, InvalidOperationException, java.rmi.RemoteException;
/**
* Arrête la consignation des travaux de l'utilisateur.
*
* @param jobid ID du travail pour lequel la consignation des travaux d'application doivent être arrêtés
* @throws SchedulerException si une erreur inattendue est émise par le planificateur de travaux
* lors du traitement de la commande
* @throws InvalidJobIDException si l'ID de travail indiqué n'est pas trouvé par le planificateur de travaux
* @throws InvalidOperationException si l'opération n'est actuellement pas autorisée sur le travail
* @throws java.rmi.RemoteException
*/
public void quiesceLogging( String jobid ) throws SchedulerException, InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
*
*
* @param jobid ID du travail
* @param Status Etat du travail
*
* @throws java.rmi.RemoteException
*/
public void sendCheckpointNotification( String jobid, String Status )
throws java.rmi.RemoteException;
/**
* Renvoie la valeur true si l'autorisation SAF est activée.
* Sous z/OS uniquement.
*
* @return valeur true si l'autorisation SAF est activée sinon, valeur false.
* @throws java.rmi.RemoteException
*/
public boolean isSAF() throws java.rmi.RemoteException;
}