Instruction AddJob
Cette instruction permet de planifier un travail pour un site ou un magasin. Le délai est indiqué par une heure de début et un intervalle. Les travaux planifiés peuvent être récurrents, c'est-à-dire qu'ils peuvent être lancés régulièrement avec une temporisation donnée.

Valeurs des paramètres
- http://host_name/path/
- Nom qualifié complet de WebSphere Commerce Server et chemin de configuration.
- langId
- Affecte ou réinitialise la langue privilégiée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG
- URL
- URL devant être lancée lorsque l'instruction aboutit.
- name
- Utilisateur pour lequel le planificateur exécute ce travail. Ce paramètre est extrait de la colonne LOGONID de la
table USERREG.
- pathInfo
- Instruction WebSphere Commerce à exécuter. Par exemple:
request=commerce/servlet/pathInfo?queryString
- queryString
- Paramètres de la commande à lancer. Tous les caractères spéciaux,
tels que =, &, / et ?, doivent être codés.
- start
- Heure à laquelle doit avoir lieu la première exécution de ce travail, présentée au format JJ:MM:AAAA:HH:MM:SS ; seules les valeurs HH:MM:SS sont obligatoires.
- hôte
- Nom de l'hôte autorisé à exécuter ce travail. Si ce paramètre est omis,
le travail peut être exécuté par un autre hôte. Ce paramètre est nécessaire
uniquement si le planificateur s'exécute sur plusieurs hôtes et si un travail
doit être limité à un seul d'entre eux. Le nom d'hôte doit figurer sous la forme : nom.domaine
- interval
- Nombre de secondes entre deux exécutions successives de ce travail. Si ce paramètre
est omis, le travail n'est exécuté qu'une seule fois.
- attempts
- Nombre de tentatives d'exécution du travail faites par le planificateur
en cas d'échec. Ce paramètre
doit être utilisé avec le paramètre de délai. Les deux paramètres doivent être présents pour une nouvelle tentative d'exécution du travail.
- delay
- Nombre de secondes devant s'écouler avant une nouvelle tentative d'exécution du travail. Ce paramètre doit être utilisé avec le paramètre de délai. Les deux paramètres doivent être présents pour une nouvelle tentative d'exécution du travail.
- schedulePolicy
- Indique la stratégie devant être mise en oeuvre par le planificateur lorsque l'exécution du travail a échoué. Deux valeurs sont possibles pour ce paramètre :
- 0 - Le travail est exécuté une seule fois et l'exécution suivante
est planifiée pour plus tard ; il s'agit du paramètre par défaut.
- 1 - Le travail est exécuté autant de fois que nécessaire pour reconstituer toutes les
exécutions manquées.
- priority
- Numéro associé à la priorité du travail. Cette valeur est insérée à la colonne SCCPRIORITY de la table SCHCONFIG. Un nombre élevé
indique un travail avec un niveau de priorité élevé.
- applicationType
- Type d'application utilisée pour exécuter le travail ajouté. Le rôle de ce paramètre est de contraindre les travaux
mobilisant de nombreuses ressources à utiliser un nombre limité d'unités d'exécution. Les types d'application et les
règles régissant leur accès aux ressources sont définis par l'utilisateur dans
le fichier de configuration XML du serveur. Le type d'application par défaut
est la valeur nulle.
- storeId
- Magasin auquel appartient le travail planifié.
- checkCmdId
- Instruction de tâche qui permet d'implémenter l'interface CheckForWorkCmd utilisée pour déterminer s'il est
nécessaire une d'exécuter une instruction.
Exemple 1
L'exemple suivant montre comment ajouter un travail avec une heure de démarrage précise :
http://mon_nom_hôte/webapp/wcs/stores/servlet/AddJob?start=2000:07:15:14:15:20
&pathInfo='/InterestItemDisplay'&URL=basemall.jsp&name=login999&queryString=listId%3D
Exemple 2
L'exemple suivant montre comment planifier un travail qui passe une commande de numéro de référence 3.
Ce travail est exécuté au nom de l'utilisateur wcsadmin, commence le 21 février 2001 à 12:15 et se répète toutes les
5 minutes (300 secondes). Si la commande échoue, une seule
tentative de récupération a lieu, 60 secondes après l'incident :
http://myhostname/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
Comportement
- Définit un travail pour le serveur d'arrière-plan.
- Ajoute une entrée aux tables SCHCONFIG et SCHACTIVE. Lorsque l'heure de début a oublié l'année, le mois ou le jour, la valeur correspondant à la date actuelle est utilisée. Seules les combinaisons suivantes sont possibles pour l'heure de début :
- année
- année et mois
- année, mois et jour
- Le planificateur lance l'instruction au nom de l'utilisateur indiqué par le paramètre nom. L'instruction est exécutée le nombre de fois indiqué par le paramètre d'intervalle et fait l'objet de nouvelles tentatives en fonction de la valeur des paramètres tentatives et délai.
Conditions d'exception
Aucune.
