Mandato AddJob
Este mandato planifica un trabajo en nombre de un sitio o una tienda. El tiempo se
especifica mediante una fecha y hora de inicio y un intervalo. Los trabajos planificados
pueden ser recurrentes; es decir, se pueden ejecutar a intervalos regulares con un periodo de
tiempo de espera especificado.

Valores de parámetros
- http://nombre_sistpral/vía de acceso/
- El nombre totalmente calificado del servidor WebSphere Commerce y la vía de acceso de configuración.
- langId
- Establece o restaura el idioma preferido para la duración de la sesión;
los idiomas soportados para una tienda se encuentran en la tabla STORELANG.
- URL
- El URL al que se debe llamar cuando el mandato se completa satisfactoriamente.
- name
- El usuario en cuyo nombre el planificador ejecuta el trabajo. Este parámetro
se extrae de la columna LOGONID de la tabla USERREG.
- pathInfo
- El mandato de WebSphere Commerce que se ejecutará. Por
ejemplo:
request=commerce/servlet/pathInfo?queryString
- queryString
- Los parámetros del mandato que se ha de ejecutar. Todos los
caracteres especiales como, por ejemplo, &, =, / y ?, se deben
codificar.
- start
- La fecha y hora en que debe llevarse a cabo la primera ejecución de este trabajo, en el formato:
AAAA:MM:DD:HH:MM:SS; sólo los valores HH:MM:SS son obligatorios.
- host
- El nombre del sistema principal que tiene permiso para ejecutar este
trabajo. Si se omite este parámetro, el trabajo lo puede ejecutar cualquier
sistema principal. El parámetro sólo es necesario si el planificador
se está ejecutando en varios sistemas principales y si un trabajo necesita
restringirse a uno de ellos. El nombre del sistema principal debe tener el
formato: nombre.dominio
- interval
- El número de segundos entre las sucesivas ejecuciones de este trabajo. Si se
omite este parámetro, el trabajo se ejecuta una sola vez.
- attempts
- El número de veces que el planificador reintenta el trabajo si éste no se
ejecuta satisfactoriamente. Este parámetro debe utilizarse junto con el parámetro delay.
Ambos parámetros deben estar presentes para que pueda reintentarse el trabajo.
- delay
- El número de segundos a transcurrir antes de reintentar un trabajo anómalo. Este
parámetro debe utilizarse junto con el parámetro attempts. Ambos parámetros deben
estar presentes para que pueda reintentarse el trabajo.
- schedulePolicy
- Especifica la política que ha de utilizar el planificador cuando la
ejecución del trabajo ha fallado. Hay dos valores posibles definidos:
- 0 - El trabajo se ejecuta una sola vez y la siguiente ejecución se
planifica para el futuro; este es el valor por omisión.
- 1 - El trabajo se ejecuta tantas veces como se necesario
para recuperar todas las ejecuciones fallidas.
- priority
- El número asociado a la prioridad de este trabajo. Este valor se insertará
en la columna SCCPRIORITY de la tabla SCHCONFIG. Un
número más alto indica un trabajo de prioridad más alta.
- applicationType
- El tipo de aplicación que se utiliza para ejecutar el trabajo que se va a añadir. La
finalidad de este parámetro es restringir los trabajos que consumen muchos recursos
a un número limitado de hebras. Los tipos de aplicaciones, y las normas que rigen
su acceso a los recursos, los define el usuario en el archivo de configuración
de servidor XML. El tipo de aplicación por omisión es nulo.
- storeId
- La tienda que es propietaria del trabajo planificado.
- checkCmdId
- Un mandato de tarea que implementa la interfaz CheckForWorkCmd utilizada
para determinar si un mandato se ha de ejecutar o no.
Ejemplo 1
El ejemplo siguiente añade un trabajo con una hora de inicio especificada:
http://misistpral/webapp/wcs/stores/servlet/AddJob?start=2000:07:15:14:15:20
&pathInfo='/InterestItemDisplay'&URL=basemall.jsp&name=login999&queryString=listId%3D
Ejemplo 2
El ejemplo siguiente planifica un trabajo que formaliza un pedido con el número de
referencia 3. Se ejecuta en nombre del usuario wcsadmin, empezando el 21 de febrero de 2001 a
las 12:15 PM y se repite cada 5 minutos (300 segundos). Si el mandato no se ejecuta
satisfactoriamente, se realizará un intento de recuperación ejecutándolo una
vez, 60 segundos después de la anomalía:
http://misistpral/webapp/wcs/stores/servlet/AddJob?command=OrderProcess
¶meters=orderId%3D3&interval=300&name=wcsadmin&start=2001:12:15:00
&attempts=1&delay=60&URL=/demomall/basemall.html
Comportamiento
- Establece un trabajo para que lo ejecute el servidor subordinado.
- Añade una entrada a las tablas SCHCONFIG y
SCHACTIVE. Si en
la fecha y hora de inicio se ha omitido el año, el mes o el día, se utiliza el valor correspondiente
a la fecha actual. Sólo pueden omitirse las siguientes combinaciones de fecha y hora de inicio:
- año
- año y mes
- año, mes y día
- El planificador ejecuta el mandato en nombre del usuario especificado en el
parámetro name. Se ejecuta el número de veces que indique el parámetro
interval y reintenta el trabajo según los valores de los parámetros attempts
y delay.
Condiciones de excepción
Ninguna.
