Comando AddJob
Questo comando pianifica un processo per conto di un sito o di un negozio. La
sincronizzazione viene specificata con un orario di inizio ed un intervallo. I
processi pianificati possono essere ricorrenti; ossia, possono essere eseguiti a
scadenza regolare con un periodo time-out specificato.

Valori dei parametri
- http://nome_host/percorso/
- Il nome completo di WebSphere Commerce Server ed il percorso di configurazione
- langId
- Imposta o reimposta la lingua prescelta per la durata della sessione; le lingue supportate per un negozio si trovano nella tabella STORELANG
- URL
- L'URL da richiamare quando il comando viene completato con esito positivo.
- name
- L'utente per conto del quale il programma di pianificazione esegue il lavoro. Questo parametro è preso dalla colonna LOGONID nella tabella
USERREG.
- pathInfo
- Il comando di WebSphere Commerce da eseguire. Ad esempio:
request=commerce/servlet/percorsoInfo?queryString
- queryString
- I parametri del comando da eseguire. E' necessario codificare tutti i caratteri speciali, ad esempio &, =, / e ?.
- start
- L'ora in cui deve verificarsi la prima esecuzione di questo lavoro, nel
formato: AAAA:MM:GG:HH:MM:SS; sono obbligatori soltanto i valori HH:MM:SS.
- host
- Il nome dell'host che è in grado di eseguire questo processo. Se questo
parametro viene omesso, il processo può essere eseguito da qualsiasi host. Questo
parametro è necessario solo se il programma di pianificazione è in esecuzione su più
host e se un processo deve essere limitato ad uno solo di questi. Il nome host dovrebbe essere del tipo seguente: name.domain
- interval
- Il numero di secondi tra successive esecuzioni di questo processo. Se questo
parametro viene omesso, il processo viene eseguito una sola volta.
- attempts
- Il numero di tentativi di esecuzione di questo processo fatti dal
programma di pianificazione, in caso di esito negativo. Questo parametro deve essere utilizzato insieme al parametro delay. Entrambi i parametri devono essere presenti per eseguire un altro tentativo del processo.
- delay
- Il numero di secondi tra i nuovi tentativi di esecuzione di un processo che ha avuto esito negativo. Questo parametro deve essere utilizzato insieme al parametro attempts. Entrambi i parametri devono essere presenti per eseguire un altro tentativo del processo.
- schedulePolicy
- Specifica il criterio che deve essere utilizzato dal programma di
pianificazione quando non è possibile eseguire il processo. Vengono definiti due valori possibili:
- 0 - Il processo è stato eseguito una volta sola e la
prossima esecuzione è programmata per il futuro; questa è l'impostazione predefinita.
- 1 - Il processo viene eseguito tante volte quante
necessarie per recuperare tutte le esecuzioni mancate.
- priority
- Il numero associato alla priorità del processo. Questo valore
verrà inserito nella colonna SCCPRIORITY della
tabella SCHCONFIG. Un numero maggiore indica un processo di priorità più alta.
- applicationType
- Il tipo di applicazione utilizzato per l'esecuzione del lavoro da aggiungere. Lo scopo di questo parametro è di ridurre i lavori ad alto consumo di risorsa ad un
numero limitato di thread. I tipi di applicazione e le leggi che regolano l'accesso
alle risorse sono definiti dall'utente nel file di configurazione del server
XML. Il tipo di applicazione predefinito è nullo.
- storeId
- Il negozio proprietario del lavoro pianificato.
- checkCmdId
- Un comando di attività che implementa l'interfaccia CheckForWorkCmd
utilizzata per determinare se è necessario eseguire il comando o meno.
Esempio 1
Il seguente esempio aggiunge un processo con un'ora di inizio specificata:
http://myhostname/webapp/wcs/stores/servlet/AddJob?start=2000:07:15:14:15:20
&pathInfo='/InterestItemDisplay'&URL=basemall.jsp&name=login999&queryString=listId%3D
Esempio 2
Nel seguente esempio viene pianificato un processo che esegue un ordine con numero
di riferimento 3. Il comando viene eseguito per conto dell'utente wcsadmin,
a partire dal 21 Febbraio 2001 alle 12:15 e viene ripetito ogno 5 minuti (300 secondi). Se il comando ha esito negativo, verrà fatto un tentativo di recupero per una sola volta, 60 secondi dopo il malfunzionamento:
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
Azione
- Imposta un lavoro da eseguire sul server di background.
- Aggiunge una voce alle tabelle SCHCONFIG e
SCHACTIVE. Se nell'ora di inizio sono stati omessi anno, mese o giorno, viene utilizzato il valore corrispondente alla data corrente. E' possibile omettere solo le seguenti combinazioni di ora di inizio:
- anno
- anno e mese
- anno, mese e giorno
- Il programma di pianificazione esegue il comando per conto dell'utente
specificato dal parametro name. Tale comando viene eseguito per il
numero di volte indicate dal parametro interval e viene ritentato in base ai valori
dei parametri attempts e delay.
Condizioni di eccezione
Nessuno.
