Interfaces EJB del planificador de trabajos
La interfaz EJB (Enterprise JavaBeans) del planificador de trabajos se utiliza para enviar de forma programada un trabajo por lotes al planificador de trabajos y manipular el trabajo.
El código siguientees la interfaz remota para el EJB del planificador de trabajos. El código genera interfaces de programación de aplicaciones.
Parte del código se divide en varias líneas para facilitar su impresión.
/**
* Esta es la interfaz remota para el EJB del planificador de trabajos.
* Los clientes de esta interfaz pueden someter y manipular mediante programación trabajos al
* planificador de trabajos. Código como el siguiente se puede utilizar para buscar e invocar
* la interfaz EJB del planificador de trabajos remoto:
*
* 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);
*
* // Para buscar el EJB del planificador de trabajos desde el contexto de célula en el espacio de nombres,
* // el contexto de nombre del servidor de aplicaciones o clúster en el que se ha desplegado la aplicación
* // del planificador de trabajos se tendrá que proporcionar.
* // Ej: "nodos/miNodo/servidores/miServidor" o "clusters/miCluster". *
* 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 {
/**
* Somete el trabajo especificado, guardado en el repositorio xJCL, al planificador de trabajos
* @param job El nombre del trabajo que se almacenó en el repositorio xJCL
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio de xJCL.
* @throws SchedulerException si un error inesperado es lanzado por el
* planificador de trabajos al someter el trabajo
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*/
public String submitJobFromRepository( String job ) throws
InvalidJobNameException,
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Somete el trabajo, definido por el xJCL, al planificador de trabajos
*
* @param xJCL El xJCL para el trabajo
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws SchedulerException si un error inesperado es lanzado por el
* planificador de trabajos al someter el trabajo
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*
*/
public String submitJob( String xJCL ) throws
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Somete el trabajo especificado por el xJCL pasado en el planificador de trabajos y
* guarda el xJCL en el repositorio de xJCL.
*
* @param xJCL El xJCL para el trabajo
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL.
* Este nombre se puede utilizar al invocar el método submitJobFromRepository.
*
* @param replace Valor booleano que indica si el xJCL del repositorio se debería
* sustituir, en caso de que ya exista dicho nombre
* en el repositorio xJCL.
*
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws InvalidOperationException si el trabajo ya existe en el repositorio xJCL
* y el parámetro de sustitución especificado es false
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*
*/
public String saveJobToRepositoryAndSubmit( String xJCL, String job, boolean replace ) throws
InvalidOperationException,
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Depura el trabajo, identificado por el ID de trabajo, desde los entornos
* del planificador de trabajos y del punto final de cuadrícula.
*
* @throws InvalidJobIDException si en el planificador de trabajos no existen trabajos especificados por el ID de trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* la depuración del trabajo
* @throws java.rmi.RemoteException
*
* @param jobid ID del trabajo a depurar
*/
public void purgeJob( String jobid ) throws
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Cancela el trabajo identificado por el ID de trabajo
*
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws InvalidJobIDException si no hay trabajos con el ID de trabajo especificado en el
* planificador de trabajos
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante la cancelación del trabajo
* @throws java.rmi.RemoteException
*
* @param jobid El ID del trabajo
*/
public void cancelJob( String jobid ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Obliga a la cancelación del trabajo identificado por el ID de trabajo
*
* Sólo con soporte en z/OS. La solicitud forcedCancelJob se procesará como una
* solicitud cancelJob en plataformas distribuidas. *
*
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws InvalidJobIDException si no hay trabajos con el ID de trabajo especificado en el
* planificador de trabajos
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante la cancelación del trabajo
* @throws java.rmi.RemoteException
*
* @param jobid El ID del trabajo
*/
public void forcedCancelJob( String jobid ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Reinicia el trabajo identificado por el ID de trabajo. Sólo los trabajos en estado reiniciable se pueden
* reiniciar.
*
* @throws InvalidJobIDException si no hay trabajos con el ID de trabajo especificado en el
* planificador de trabajos
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el reinicio del trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*
* @param jobid El ID del trabajo
*/
public void restartJob( String jobid ) throws
InvalidJobIDException,
InvalidOperationException,
SchedulerException,
JCLException,
JobSubmissionException,
java.rmi.RemoteException;
/**
* Devuelve el estado de trabajo para un ID de trabajo dado. Consulte {@link JobStatusConstants
* JobStatusConstants} para ver una
* lista de los códigos de estado de trabajo que devuelve este método.
*
* @param jobid El ID del trabajo
*
* @throws InvalidJobIDException si no hay trabajos con el ID de trabajo especificado en el
* planificador de trabajos
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
* @return el estado del trabajo
*/
public int getJobStatus( String jobid ) throws
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve la salida de trabajo para un ID de trabajo dado que muestra el progreso del trabajo. Esto sólo
* se aplica a trabajos por lotes.
*
* @param jobid El ID del trabajo
*
* @throws InvalidJobIDException si en el planificador de trabajos no existen trabajos especificados por el ID de trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el proceso del mandato
* @throws java.rmi.RemoteException
*
* @return la salida generada por el trabajo
*/
public String getJobOutput( String jobid ) throws
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve los detalles del trabajo para un ID de trabajo dado.
*
* @throws InvalidJobIDException si en el planificador de trabajos no existen trabajos especificados por el ID de trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el proceso del mandato
* @throws java.rmi.RemoteException
*
* @return los detalles del trabajo, como el ID de trabajo, el texto de estado, quién lo ha sometido y el tipo de trabajo
*/
public String getJobDetails(String jobid) throws
InvalidJobIDException,SchedulerException,java.rmi.RemoteException;
/**
* Guarda el xJCL pasado en el repositorio xJCL.
*
* @param xJCL El xJCL para el trabajo
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL. Este nombre se puede
* utilizar al invocar el método submitJobFromRepository.
*
* @param replace Valor booleano que indica si el xJCL del repositorio se debería
* sustituir, en caso de que ya exista dicho nombre
* en el repositorio xJCL.
*
* @throws InvalidOperationException si el trabajo ya existe en el repositorio
* xJCL y el parámetro de sustitución (replace) sea false
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws java.rmi.RemoteException
*
*/
public void saveJobToRepository( String xJCL, String job, boolean replace ) throws
InvalidOperationException,
SchedulerException,
JCLException,
java.rmi.RemoteException;
/**
* Devuelve el xJCL del repositorio de xJCL para el nombre del trabajo dado.
*
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL. Este nombre se puede utilizar
* al invocar el método submitJobFromRepository.
*
*
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio de xJCL.
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
* @return el xJCL del trabajo dado
*/
public String showJobFromRepository( String job ) throws
InvalidJobNameException,
SchedulerException,
java.rmi.RemoteException;
/**
* Elimina el xJCL del trabajo especificado del repositorio de xJCL
*
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL.
*
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio de xJCL.
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
*/
public void removeJobFromRepository( String job ) throws
InvalidJobNameException,
SchedulerException,
java.rmi.RemoteException;
/**
* Muestra todos los trabajos del planificador de trabajos
*
* @return la lista de los ID de trabajo para todos los trabajos del planificador de trabajos
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
*/
public String[] showAllJobs() throws
SchedulerException,
java.rmi.RemoteException;
/**
* Suspende el trabajo especificado durante la cantidad de segundos especificada. Una vez que el periodo de tiempo
* se termina, el trabajo se reanuda
* automáticamente. Esto sólo se aplica a trabajos por lotes.
*
* @param jobid ID del trabajo a suspender
* @param seconds Segundos para la suspensión del trabajo
*
* @throws InvalidJobIDException si en el planificador de trabajos no existen trabajos especificados por el ID de trabajo
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al suspender el trabajo
* @throws java.rmi.RemoteException
*
*/
public void suspendJob( String jobid, String seconds ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Reanuda la ejecución del trabajo especificado. Esto sólo se aplica a trabajos por lotes.
*
* @param jobid ID del trabajo a reanudar
*
* @throws InvalidJobIDException si no hay trabajos con el ID de trabajo especificado en el
* planificador de trabajos
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @emite una excepción SchedulerException si el planificador de trabajos genera un error inesperado
* al reanudar el trabajo
* @throws java.rmi.RemoteException
*
*/
public void resumeJob( String jobid ) throws
InvalidOperationException,
InvalidJobIDException,
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve el código de retorno del trabajo por lotes.
*
* @param jobid El ID del trabajo
* @return el código de retorno del trabajo por lotes
*
* @throws InvalidJobIDException si en el planificador de trabajos no existen trabajos especificados por el ID de trabajo
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
*/
public int getBatchJobRC(String jobid) throws InvalidOperationException,
InvalidJobIDException, SchedulerException, java.rmi.RemoteException;
/**
* Somete el trabajo, definido por el xJCL, al planificador de trabajos en la
* hora de inicio especificada.
*
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá el trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora
* no están en el formato correcto
* @throws StaleTimeException si la fecha o la hora de inicio han pasado, en relación a la
* hora actual
* @throws java.rmi.RemoteException
*/
public String submitDelayedJob( String xJCL, String startTime ) throws
SchedulerException,
JCLException,
JobSubmissionException,
InvalidStartDateTimeFormatException,
StaleTimeException,
java.rmi.RemoteException;
/**
* Somete el trabajo, guardado en el repositorio xJCL, al planificador de trabajos
* a la hora especificada.
*
* @param job El nombre del trabajo que se almacenó en el repositorio de trabajos
* @param startTime Hora a la que se someterá el trabajo. El formato de la hora de sometimiento
* es aaaa-mm-dd hh:mm:ss.
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio xJCL.
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora
* no están en el formato correcto
* @throws StaleTimeException si la fecha o la hora de inicio han pasado, en relación a la
* hora actual
* @throws java.rmi.RemoteException
*/
public String submitDelayedJobFromRepository( String job, String startTime ) throws
InvalidJobNameException,
SchedulerException,
JCLException,
JobSubmissionException,
InvalidStartDateTimeFormatException,
StaleTimeException,
java.rmi.RemoteException;
/**
* Somete el trabajo retardado especificado por el xJCL pasado en el planificador de trabajos y
* guarda el xJCL en el repositorio de xJCL.
*
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá el trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL. Este nombre se puede
* utilizar al invocar el método submitJobFromRepository.
*
* @param replace Valor booleano que indica si el xJCL del repositorio se debería sustituir
* en caso de que ya exista dicho nombre
* en el repositorio de trabajos.
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el sometimiento del trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora no están en el
* formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio han pasado, en relación a la
* hora actual
* @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;
/**
* Crea una planificación de trabajo para someter el trabajo, definido por el xJCL, en la hora e
* intervalo especificados. *
* @param reqId El nombre de la solicitud de trabajo recurrente
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá el primer trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param interval El intervalo de tiempo entre trabajos (por ejemplo, diario, semanal, mensual)
*
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws InvalidStartDateTimeFormatException si la fecha o la hora no están en el
* formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio han pasado,
* en relación a la hora actual
* @throws InvalidIntervalException si el intervalo especificado no es uno de los
* intervalos de tiempo con soporte
* @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;
/**
* Crea una planificación de trabajos para someter el trabajo especificado, guardado en el repositorio xJCL,
* a la hora e intervalo especificados. *
* @param jobName El nombre del trabajo que se almacenó en el repositorio de trabajos
* @param reqId El nombre de la solicitud de trabajo recurrente
* @param startTime Hora a la que se someterá el trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param interval El intervalo de tiempo entre trabajos (por ejemplo, diario, semanal, mensual)
*
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws InvalidStartDateTimeFormatException si la fecha o la hora no están en el
* formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio
* han pasado, en relación a la hora actual
* @throws InvalidIntervalException si el intervalo especificado no es uno de los
* intervalos de tiempo con soporte
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio xJCL.
* @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;
/**
* Cancelar una planificación de trabajo existente
*
* @param reqId El nombre de la planificación de trabajos
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* la cancelación del trabajo
* @throws java.rmi.RemoteException
*/
public void cancelRecurringRequest( String reqId ) throws
InvalidOperationException,
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve detalles de una planificación de trabajos existente.
*
* @param reqId El nombre de la planificación de trabajos a devolver
* @return información sobre la planificación, como el nombre de la planificación, el nombre del trabajo, la hora de inicio y
* el intervalo
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el proceso del mandato
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws java.rmi.RemoteException
*/
public String getRecurringRequestDetails(String reqId) throws
SchedulerException,
InvalidOperationException,
java.rmi.RemoteException;
/**
* Modifica una planificación de trabajos existente.
*
* @param reqId El nombre de la planificación de trabajos a modificar
* @param xJCL El xJCL del trabajo
* @param startTime Hora a la que se someterá el primer trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param interval El intervalo de tiempo entre trabajos (por ejemplo, diario, semanal, mensual)
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora no están en el
* formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio han pasado, en relación a la
* hora actual
* @throws InvalidIntervalException si el intervalo especificado no es uno de los
* intervalos de tiempo con soporte
* @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;
/**
* Lista todas las planificaciones de trabajos existentes
*
* @return una lista de todas las planificaciones de trabajos actualmente en el sistema
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el proceso del mandato
* @throws java.rmi.RemoteException
*/
public String[] showAllRecurringRequests() throws
SchedulerException,
java.rmi.RemoteException;
/**
* Muestra todos los trabajos en la planificación de trabajos especificada
*
* @param reqId el nombre de la planificación de trabajos
* @return la lista de los ID de trabajo de los trabajos en la planificación de trabajos especificada
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws java.rmi.RemoteException
*/
public String[] showRecurringJobs(String reqId) throws
SchedulerException,
InvalidOperationException,
java.rmi.RemoteException;
/**
* Devuelve el estado del trabajo en formato XML para los ID de trabajo dados.
*
* @param jobid Lista de los ID de trabajo
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
* @return Estado del trabajo, como ID de trabajo, código de retorno, código de estado y texto de estado en formato XML
*/
public String getJobsStatus(String[] jobid) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve una lista de los ID de trabajo que coincidan con los criterios especificados. Se deben cumplir todas las condiciones
* para que se produzca la coincidencia.
*
* @param jobFilter Valor del filtro SQL a aplicar al ID de trabajo (por ejemplo Postings% )
* @param submitterFilter Valor del filtro SQL a aplicar al sometedor
* @param nodeFilter Valor del filtro SQL a aplicar a los nombres de los nodos en los que
* se han ejecutado trabajos (por ejemplo node_ )
* @param appServerFilter Valor del filtro SQL a aplicar a los nombres de los servidores
* de aplicaciones en los que se han ejecutado los trabajos.
* @param stateFilter Lista de los estados de trabajo. Consulte {@link JobStatusConstants
* JobStatusConstants} para ver una
* lista de los estados de trabajo posibles. * @ param sortBy Campo utilizado para ordenar resultados (Por ejemplo JOBID, STATUS, APPSERVER)
* @param ascending - distintivo que indica si los resultados se deben devolver en
* orden descendente o ascendente
* según el campo sortBy.
*
* @return La lista de los ID de trabajo que coincidan con los criterios especificados
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @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;
/**
* Cancela los trabajos identificados por la lista de los ID de trabajo
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante la cancelación del trabajo
* @throws java.rmi.RemoteException
*
* @param jobid La lista de los ID de trabajo a cancelar.
* @return Lista de códigos de retorno. Consulte {@link JobSchedulerConstants JobSchedulerConstants}
* para obtener una lista de los posibles códigos de retorno.
*/
public int[] cancelJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Depuera los trabajos, identificados por la lista de los ID de trabajo desde el planificador de trabajos y los
* entornos de punto final de cuadrícula.
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al depurar el trabajo
* @throws java.rmi.RemoteException
*
* @param jobid La lista de los ID de trabajo a depurar
* @return Lista de códigos de retorno. Consulte
* {@link JobSchedulerConstants JobSchedulerConstants} Para ver una lista de los posibles
* códigos de retorno.
*/
public int[] purgeJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Reinicia los trabajos identificados por la lista de los ID de trabajo. Sólo los trabajos en
* estado reiniciable se pueden reiniciar.
*
* @throws SchedulerException si un error inesperado es lanzado por el
* planificador de trabajos al reiniciar el trabajo
* @throws java.rmi.RemoteException
*
* @param jobid La lista de los ID de trabajo a reiniciar.
* @return Lista de códigos de retorno. Consulte {@link JobSchedulerConstants
* JobSchedulerConstants} para obtener una lista de los posibles códigos de retorno.
*/
public int[] restartJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Reanuda la ejecución de los trabajos identificados por la lista de los ID de trabajo. Esto sólo
* se aplica a trabajos por lotes.
*
* @param jobid La lista de los ID de trabajo a reanudar
* @return Lista de códigos de retorno. Consulte {@link JobSchedulerConstants
* JobSchedulerConstants} para obtener una lista de los posibles códigos de retorno.
*
* @throws SchedulerException si el planificador de trabajos genera un error inesperado
* al reanudar el trabajo
* @throws java.rmi.RemoteException
*
*/
public int[] resumeJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Suspende los trabajos especificados durante la cantidad de segundos especificada. Una vez que el
* periodo de tiempo transcurre, los trabajos automáticamente
* se reanudan. Esto sólo se aplica a trabajos por lotes.
*
* @param jobid ID del trabajo a suspender
* @param seconds Segundos para la suspensión del trabajo
* @return Lista de códigos de retorno. Consulte {@link JobSchedulerConstants
* JobSchedulerConstants} para obtener una lista de los posibles códigos de retorno.
*
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws SchedulerException si un error inesperado es lanzado por el
* planificador de trabajos al suspender el trabajo
* @throws java.rmi.RemoteException
*
*/
public int[] suspendJob( String[] jobid, String seconds ) throws
SchedulerException,
InvalidOperationException,
java.rmi.RemoteException;
/**
* Somete el trabajo especificado, guardado en el repositorio xJCL, y cualquier pareja nombre/valor
* especificado en el planificador de trabajos a la hora
* de inicio especificada.
*
* @param job El nombre del trabajo que se almacenó en el repositorio xJCL
* @param startTime Hora a la que se someterá el trabajo. El formato de la hora de sometimiento
* es aaaa-mm-dd hh:mm:ss.
* @param nameValuePairs El espacio delimita pares nombre=valor, que se utilizan para
* modificar el xJCL; por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL con un
* esquema de codificación de UTF-8 para poder pasarlo en la solicitud.
*
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio de xJCL.
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora no están en el
* formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio han pasado,
* en relación a la hora actual
* @throws java.rmi.RemoteException
*/
public String submitModifiableDelayedJobFromRepository( String job, String startTime,
String nameValuePairs )
throws InvalidJobNameException, SchedulerException, JCLException, JobSubmissionException,
InvalidStartDateTimeFormatException, StaleTimeException, java.rmi.RemoteException;
/**
* Somete el trabajo, que está definido por el xJCL y los pares nombre/valor especificados, al
* planificador de trabajos a la hora de inicio
* especificada.
*
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá el trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param nameValuePairs El espacio delimita pares nombre=valor, que se utilizan para
* modificar el xJCL; por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL con
* un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
*
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws SchedulerException si el planificador de trabajos genera un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora
* no están en el formato correcto
* @throws StaleTimeException si la fecha o la hora de inicio han pasado,
* en relación a la hora actual
* @throws java.rmi.RemoteException
*/
public String submitModifiableDelayedJob
( String xJCL, String startTime, String nameValuePairs )
throws SchedulerException, JCLException, JobSubmissionException,
InvalidStartDateTimeFormatException, StaleTimeException, java.rmi.RemoteException;
/**
* Somete el trabajo retardado, que está definido opr el xJCL y cualquier pareja nombre/valor
* especificada, al planificador de trabajos y
* guarda el xJCL en el repositorio de xJCL.
*
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá el trabajo. El formato de la
* hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL. Este nombre
* se puede utilizar al invocar el método submitJobFromRepository.
*
* @param replace Valor booleano que indica si el xJCL del repositorio se debería
* sustituir, en caso de que ya exista dicho nombre
* en el repositorio de trabajos.
* @param nameValuePairs Pares nombre=valor delimitados por espacios, que se utilizan
* para modificar el xJCL; por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL
* con un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
*
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora
* no están en el formato correcto
* @throws StaleTimeException si la fecha o la hora de inicio han pasado, en relación a la
* hora actual
* @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;
/**
* Crea una planificación de trabajos para someter trabajos en el intervalo de tiempo especificado. Los trabajos
* están definidos por el xJCL y los pares nombre/valor especificados.
*
* @param reqId El nombre de la planificación de trabajos
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá el trabajo. El formato de
* la hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param interval El intervalo de tiempo entre trabajos (por ejemplo, diario, semanal, mensual)
* @param nameValuePairs El espacio delimita pares nombre=valor, que se utilizan para
* modificar el xJCL; por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL
* con un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
*
* @throws InvalidOperationException si la operación no tiene actualmente permiso
* sobre el trabajo
* @throws SchedulerException si un error inesperado es lanzado por el
* planificador de trabajos al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws InvalidStartDateTimeFormatException si la fecha o la hora de inicio
* no están en el formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio han pasado,
* en relación a la hora actual
* @throws InvalidIntervalException si el intervalo especificado no es uno de los
* intervalos de tiempo con soporte
* @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;
/**
* Crea una planificación de trabajos para someter trabajos en el intervalo de tiempo especificado. Los trabajos
* se definen por el xJCL almacenado en el repositorio de xJCL
y los pares nombre/valor especificados.
*
* @param jobName El nombre del trabajo que se almacenó en el repositorio de trabajos
* @param reqId El nombre de la solicitud de trabajo recurrente
* @param startTime Hora a la que se someterá el trabajo. El formato de
* la hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param interval El intervalo de tiempo entre trabajos (por ejemplo, diario, semanal, mensual)
* @param nameValuePairs El espacio delimita pares nombre=valor, que se utilizan para
* modificar el xJCL; por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL con
* un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
*
* @throws InvalidOperationException si la operación no tiene actualmente permiso sobre el trabajo
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL del trabajo está corrupto o no es válido.
* @throws InvalidStartDateTimeFormatException si la fecha o la hora no están en el
* formato necesario
* @throws StaleTimeException si la fecha o la hora de inicio han pasado,
* en relación a la hora actual
* @throws InvalidIntervalException si el intervalo especificado no es uno de los
* intervalos de tiempo con soporte
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio xJCL.
* @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;
/**
* Somete el trabajo, que está definido opr el xJCL y cualquier pareja nombre/valor
* especificada, al planificador de trabajos y
* guarda el xJCL en el repositorio de xJCL.
*
* @param xJCL El xJCL para el trabajo
* @param job El nombre asignado para el trabajo guardado en el repositorio xJCL. Este nombre
* se puede utilizar al invocar el método submitJobFromRepository.
*
* @param replace Valor booleano que indica si el xJCL del repositorio
* se debería sustituir, en caso de que ya exista dicho nombre
* en el repositorio xJCL.
* @param nameValuePairs Pares nombre=valor delimitados por espacios, que se
* utilizan para modificar el xJCL; por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL
* con un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
*
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws InvalidOperationException si el trabajo ya existe en el repositorio
* xJCL y el parámetro de sustitución (replace) sea false
* @throws SchedulerException si un error inesperado es lanzado por el
* planificador de trabajos al someter el trabajo
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*
*/
public String saveModifiableJobToRepositoryAndSubmit( String xJCL, String job,
boolean replace, String nameValuePairs )
throws InvalidOperationException, SchedulerException, JCLException,
JobSubmissionException, java.rmi.RemoteException;
/**
* Somete el trabajo especificado, guardado en el repositorio xJCL y cualquier pareja
* nombre/valor especificada, al planificador de trabajos
*
* @param job El nombre del trabajo que se almacenó en el repositorio xJCL
* @param nameValuePairs El espacio delimita pares nombre=valor, que se utilizan para
* modificar el xJCL; (por ejemplo: "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL con
* un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws InvalidJobNameException si el trabajo no se encuentra en el repositorio de xJCL.
* @throws SchedulerException si el planificador de trabajos genera un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*/
public String submitModifiableJobFromRepository( String job, String nameValuePairs )
throws InvalidJobNameException, SchedulerException, JCLException, JobSubmissionException,
java.rmi.RemoteException;
/**
* Somete el trabajo, que está definido por el xJCL y los pares nombre/valor especificados, al
* planificador de trabajos
*
* @param xJCL El xJCL para el trabajo
* @param nameValuePairs El espacio delimita pares nombre=valor, que se utilizan para
* modificar el xJCL (por ejemplo "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL
* con un esquema de codificación de UTF-8 para poder pasarla en la solicitud.
* @return El ID de trabajo asignado por el planificador de trabajos para el trabajo sometido
*
* @throws SchedulerException si el planificador de trabajos genera un error inesperado
* al someter el trabajo
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws JobSubmissionException si se produce un error al someter el trabajo
* @throws java.rmi.RemoteException
*
*/
public String submitModifiableJob( String xJCL, String nameValuePairs )
throws SchedulerException, JCLException, JobSubmissionException, java.rmi.RemoteException;
/**
* Modifica una planificación de trabajos existente.
*
* @param reqId El nombre de la planificación de trabajos a modificar
* @param xJCL El xJCL para el trabajo
* @param startTime Hora a la que se someterá
* el primer trabajo. El formato de la hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param interval El intervalo de tiempo entre trabajos
* (por ejemplo, diario, semanal, mensual)
* @param nameValuePairs Pares nombre=valor delimitados
* por espacios, que se utilizan para modificar xJCL (por ejemplo "host=mihost port=mipuerto")
* Los valores que contienen caracteres especiales o espacios deben estar codificados en el URL con
* un esquema de codificación de UTF-8 para poder pasarlo en la solicitud.
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado * al procesar el mandato
* @throws JCLException si el xJCL para el trabajo está corrupto
* o no es válido.
* @throws InvalidOperationException si la operación no tiene actualmente permiso
* sobre el trabajo
* @throws InvalidStartDateTimeFormatException si la fecha o la hora
* no están en el formato correcto
* @throws StaleTimeException si la fecha o la hora de inicio
* han pasado, en relación a la hora actual
* @throws InvalidIntervalException si el intervalo especificado no es uno de los
* intervalos de tiempo con soporte
* @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;
/**
* Devuelve una lista de nombres de trabajo en el repositorio del trabajo que coincide con el criterio
* especificado. Para que se produzca la coincidencia, se deben aplicar todas las condiciones.
*
* @param jobNameFilter Valor del filtro SQL a aplicar a los nombres de trabajo (por ejemplo Postings%)
* @param jobDescFilter no se utiliza
* @param sortBy - Campo utilizado para ordenar resultados (por ejemplo JOBNAME, TXT)
* @param ascending - distintivo que indica si los resultados se deben devolver en
* orden descendente o ascendente
* según el campo sortBy.
*
* @return La lista de los nombres de trabajo que coincidan con los criterios especificados
*
* @throws SchedulerException si el planificador de trabajos genera un error inesperado
* al procesar la solicitud
* @throws java.rmi.RemoteException
*/
public String[] getJobsName(String jobNameFilter, String jobDescFilter,
String sortBy, boolean ascending) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Detiene el trabajo identificado por el ID de trabajo
*
* @throws InvalidOperationException si la operación no tiene actualmente permiso
* sobre el trabajo
* @throws InvalidJobIDException si en el planificador de trabajos no existen trabajos
* especificados por el ID de trabajo
* @throws SchedulerException si el planificador de trabajos genera un error inesperado
* al procesar la solicitud
* @throws java.rmi.RemoteException
*
* @param jobid El ID del trabajo
*/
public void stopJob( String jobid )
throws InvalidOperationException, InvalidJobIDException, SchedulerException,
java.rmi.RemoteException;
/**
* Detiene los trabajos identificados por la lista de los ID de trabajo
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* al depurar el trabajo
* @throws java.rmi.RemoteException
*
* @param jobid La lista de los ID de trabajo a detener.
* @return Lista de códigos de retorno. Consulte {@link JobSchedulerConstants
* JobSchedulerConstants} para obtener una lista de los posibles códigos de retorno.
*/
public int[] stopJob( String[] jobid ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Analiza el xJCL para crear una correlación de todas las variables simbólicas utilizadas en el xJCL
* que no son propiedades del sistema
* @param xJCL El xJCL para el trabajo
* @return una correlación de pares nombre/valor predeterminado; value==null ==> sin valor predeterminado
* en substitution-props
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws JCLException si el xJCL almacenado en el repositorio está corrupto o no es válido.
* @throws java.rmi.RemoteException
*
*/
public String getSymbolicVariables( String clientXJCL )
throws SchedulerException, JCLException, java.rmi.RemoteException;
/**
* Devuelve la información de planificación de trabajos en formato XML para los nombres de planificación de trabajos dados.
*
* @param requestid Lista de los nombres de planificación de trabajos
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
* @return Información de planificación de trabajos en formato XML, como nombre de planificación de trabajos,
* nombre del trabajo, hora de inicio e intervalo
*/
public String getRequests(String[] requestid) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve una lista de los nombres de planificación de trabajos que coincidan con los criterios especificados. Todas las condiciones * deben aplicarse para que se produzca la coincidencia.
*
* @param requestIdFilter Valor del filtro SQL a aplicar al nombre de la planificación de trabajos
* (por ejemplo %Postings% )
* @param startTimeFilter Valor del filtro SQL a aplicar a la hora de sometimiento inicial de los
* trabajos. El formato de la hora de sometimiento es aaaa-mm-dd hh:mm:ss.
* @param submitterFilter Valor del filtro SQL a aplicar al sometedor
* @param intervalFilter Lista de los periodos de tiempo entre sometimientos de trabajos (por ejemplo diario,
* semanal, mensual)
* @param statusFilter Lista de estados de trabajo. Consulte
* {@link JobStatusConstants JobStatusConstants} para ver una
* lista de los estados de trabajo posibles. * @ param sortBy Campo utilizado para ordenar resultados (por ejemplo REQUESTID, STARTTIME, INTERVAL)
* @param ascending - distintivo que indica si los resultados se deben devolver en
* orden descendente o ascendente
* según el campo sortBy.
*
* @return La lista de los nombres de planificación de trabajos que coincidan con los criterios especificados
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @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;
/**
* Cancelar planificaciones de trabajos existentes
*
* @param reqId La lista de los nombres de planificación de trabajos a cancelar
* @return Lista de códigos de retorno. Consulte
* {@link JobSchedulerConstants JobSchedulerConstants} para obtener una lista de los
* códigos de retorno posibles.
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante la cancelación del trabajo
* @throws java.rmi.RemoteException
*/
public int[] cancelRecurringRequest( String[] reqId ) throws
SchedulerException,
java.rmi.RemoteException;
/**
* Devuelve las anotaciones de trabajo comprimidas asociadas al ID de trabajo solicitado
*
* @param jobid El ID del trabajo cuyo nombre de archivo de registro se va a devolver
* @return el nombre del sistema de archivos para el registro de trabajo del trabajo especificado
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado durante
* el proceso del mandato
* @throws InvalidJobIDException si para el ID de trabajo especificado no se encuentran registros de trabajo por parte del
* planificador de trabajos
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String getJobLog( String jobid ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Devuelve los metadatos del registro de trabajo asociados al ID de trabajo solicitado
* lista de los distintos subdirectorios de registros de trabajo para el ID de trabajo)
*
* @param jobid El ID del trabajo cuyos metadatos se van a devolver
* @return Los metadatos del registro de trabajo para el trabajo especificado
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra metadatos de registro de trabajo
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getLogMetaData( String jobid ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Devuelve la lista de la parte del registro de trabajo asociada con el ID de trabajo y el subdirectorio de registro
*
* @param jobid El ID del trabajo cuya información de parte se va a devolver
* @param logSubDirName El nombre del subdirectorio de registro del trabajo
* cuya información se va a devolver
* @return La información de parte del registro de trabajo para el trabajo especificado
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra información de parte
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getLogPartList( String jobid, String logSubDirName ) throws
SchedulerException, InvalidJobIDException, InvalidOperationException,
java.rmi.RemoteException;
/**
* Devuelve el contenido del archivo de registro de trabajo asociado con el ID de trabajo solicitado,
* el subdirectorio de registro y el número de parte
*
* @param jobid El ID del trabajo cuya información de parte se va a devolver
* @param logSubDirName El nombre del subdirectorio de registro del trabajo
* cuya información se va a devolver
* @param partNumber El nombre del trozo del registro de trabajo en el subdirectorio de registro del que
* se va a devolver la información de parte
*
* @return el contenido de la parte del registro de trabajo para el trabajo especificado y el subdirectorio de registro
*
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra información de parte
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getLogPart( String jobid, String logSubDirName, String partNumber )
throws SchedulerException, InvalidJobIDException, InvalidOperationException,
java.rmi.RemoteException;
/**
* Devuelve el tamaño en bytes del archivo de registro de trabajo asociado con el ID de trabajo solicitado
*
* @param jobid El ID del trabajo cuya información de tamaño se va a devolver
* @param logSubDirName El nombre del subdirectorio de registro del trabajo
* cuya información se va a devolver
* @return el tamaño del registro de trabajo para el trabajo especificado
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra información de tamaño
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String getLogSize( String jobid, String logSubDirName ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Devuelve la antigüedad del archivo de registro de trabajo asociado con el ID de trabajo solicitado,
* y el subdirectorio del registro
*
* @param jobid El ID del trabajo cuya información de antigüedad se va a devolver
* @param logSubDirName El nombre del subdirectorio de registro del trabajo cuya información de antigüedad
* se va a devolver
*
* @return la antigüedad (en días) del registro de trabajo para el nombre del trabajo especificado y el subdirectorio de registro
*
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra información de antigüedad
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public int getLogAge( String jobid, String logSubDirName ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Devuelve la lista del registro de trabajos asociados a la clase del trabajo solicitado
*
* @param jobid El identificador de clase cuya información de lista de trabajo se va a devolver
* @param jobClass El identificador de clase con el que realizar la coincidencia
* @return una lista de todos los ID de trabajo cuyo identificador de clase coincida con la jobClass especificada
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getJobsByClass( String jobClass ) throws SchedulerException,
InvalidOperationException, java.rmi.RemoteException;
/**
* Elimina las anotaciones de trabajo comprimidas asociadas al ID de trabajo solicitado [ esta es la
* acción complementaria necesaria para {@link JobScheduler#getJobLog(String) getJobLog(jobid) ]
*
* @param jobid ID del trabajo cuyo archivo de registro comprimido se va a eliminar
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra información de parte
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public void removeJobLog( String jobid ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Depuera el archivo del registro de trabajo asociado con el ID de trabajo y el subdirectorio de registro
*
* @param jobid El ID del trabajo cuyo registro de trabajo se va a depurar
* @param logSubDirName El nombre del subdirectorio de registro del trabajo cuyo registro de trabajo
* se va a depurar
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra información de trabajo
* para el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public void purgeJobLog( String jobid, String logSubDirName ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
* Devuelve las direcciones JMX del clúster del planificador
*
* @return las direcciones JMX del clúster del planificador
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getAdminAddresses() throws SchedulerException, InvalidOperationException,
java.rmi.RemoteException;
/**
* Recupera una lista de preferencias de usuario para el ID de usuario y el ámbito dados.
* @param userId El ID de usuario utilizado para iniciar sesión en la consola de gestión de trabajos
* @param prefScope El ámbito de las preferencias dentro de la Consola de gestión de trabajos.
* (por ejemplo JobCollectionForm, SavedJobCollectionForm,
* JobScheduleCollectionForm)
* @return una lista de preferencias de usuario en formato nombre=valor
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
*/
public String[] getUserPrefs( String userId, String prefScope ) throws
SchedulerException, java.rmi.RemoteException;
/**
* Guarda la lista de preferencias de usuario para el ID de usuario y el ámbito dados.
* @param userId El ID de usuario utilizado para iniciar sesión en la consola de gestión de trabajos
* @param prefScope El ámbito de las preferencias dentro de la Consola de gestión de trabajos.
* (por ejemplo JobCollectionForm, SavedJobCollectionForm,
* JobScheduleCollectionForm)
* @param prefNameValue La lista de preferencias de usuario en formato nombre=valor
*
* @throws SchedulerException si el planificador de trabajos lanza un error inesperado
* durante el proceso del mandato
* @throws java.rmi.RemoteException
*
*/
public void saveUserPrefs( String userId, String prefScope, String[] prefNameValue)
throws SchedulerException, java.rmi.RemoteException;
/**
* Devuelve la lista del registro de trabajos asociados a la clase del trabajo solicitado clasificada por antigüedad
*
* @param jobClass El identificador de clase con el que realizar la coincidencia
* @return una lista de todos los ID de trabajo cuyo identificador de clase coincida con la clase jobClass
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getJobLogMetaDataByAgeForClass( String jobClass ) throws
SchedulerException, InvalidOperationException, java.rmi.RemoteException;
/**
* Devuelve la lista del registro de trabajos asociados a la clase del trabajo solicitado clasificada por tamaño
*
* @param jobClass El identificador de clase con el que realizar la coincidencia
* @return una lista de todos los ID de trabajo cuyo identificador de clase coincida con la clase jobClass
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public String[] getJobLogMetaDataBySizeForClass( String jobClass ) throws
SchedulerException, InvalidOperationException, java.rmi.RemoteException;
/**
* Detiene el registro del trabajo de usuario
*
* @param jobid ID del trabajo cuyo registro de trabajo de aplicación se va a detener
* @throws SchedulerException si el planificador de trabajos lanza un error no soportado
* durante el proceso del mandato
* @throws InvalidJobIDException si el planificador de trabajos no encuentra el ID de trabajo especificado
* @throws InvalidOperationException si la operación no se permite actualmente en el trabajo
* @throws java.rmi.RemoteException
*/
public void quiesceLogging( String jobid ) throws SchedulerException,
InvalidJobIDException, InvalidOperationException, java.rmi.RemoteException;
/**
*
*
* @param jobid El ID del trabajo
* @param Status El estado del trabajo
*
* @throws java.rmi.RemoteException
*/
public void sendCheckpointNotification( String jobid, String Status )
throws java.rmi.RemoteException;
/**
* Devuelve true si la autorización SAF está habilitada.
* Sólo con soporte en z/OS.
*
* @return true si la autorización SAF está habilitada; de lo contrario, devuelve false.
* @throws java.rmi.RemoteException
*/
public boolean isSAF() throws java.rmi.RemoteException;
}