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 :
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
    &parameters=orderId%3D3&interval=300&name=wcsadmin&start=2001:12:15:00
    &attempts=1&delay=60&URL=/demomall/basemall.html

Comportement

Conditions d'exception
Aucune.

Rubriques connexes

Tâches connexes

Références connexes

IBM copyright