Comando BPMProcessInstancesCleanup (obsoleto)
Tradizionale:
Utilizzare questo comando per eliminare i dati dell'istanza di definizione del processo aziendale (BPD) e i documenti associati per uno snapshot dell'applicazione di processo su IBM® Workflow Server.
Utilizzando questo comando si elimina l'istanza BPD e le attività e i documenti associati per le istanze specificate dai parametri del comando. Registra inoltre i dati in un file standard SystemOut.log per tenere traccia delle applicazioni del processo selezionate per l'eliminazione dei dati di istanza e dei documenti associati.
Prerequisiti
- Eseguire il comando in modalità connessa, ovvero non utilizzare l'opzione
-conntype nonewsadmin. - Non è possibile utilizzare questo comando per eliminare i messaggi per i processi BPEL.
- È possibile eseguire il comando da qualsiasi membro del cluster in un ambiente di distribuzione di rete. Tuttavia, è necessario prima stabilire la sessione wsadmin sulla porta SOAP del membro del cluster da cui si sta eseguendo il comando.
- Per accedere al comando wsadmin, l'ID utilizzato deve avere un ruolo WebSphere® Application Server con più privilegi rispetto al ruolo di monitoraggio. Consultare Ruoli amministrativi per informazioni sui ruoli.
- Per accedere all'API Business Automation Workflow Utilizzato da questo comando, l'ID utilizzato deve appartenere a bpmAdminGroup o bpmAuthorGroup. Il nome predefinito per bpmAdminGroup è tw_admins e il nome predefinito per bpmAuthorGroup è tw_authors. Per informazioni sui gruppi, consultare IBM Business Automation Workflow tipi di gruppo predefiniti .Suggerimento: Per impostazione predefinita, solo l'utente DeAdmin ha sia il ruolo di amministratore che l'appartenenza a WebSphere Application Server ruolo di amministratore e l'appartenenza al sito bpmAdminGroup.
Ubicazione
Avviare il client di script wsadmin dalla directory install_root/bin .
Sintassi
BPMProcessInstancesCleanup
-containerAcronym process_application_acronym
-containerSnapshotAcronym process_application_snapshot_acronym
-instanceStatus instance_status
[-endedAfterLocal local_time_on_the_server]
[-endedBeforeLocal local_time_on_the_server]
[-instanceID instance_IDs]
[-maximumDuration number_of_minutes]
[-outputFile file_path]
[-transactionSlice number_of_instances_to_delete_in_a_transaction]Parametri
- -containerAcronym acronimo applicazione processo
- Un parametro obbligatorio che identifica l'acronimo che specifica l'applicazione del processo per cui eseguire la ripulitura dell'istanza del processo. Ad esempio, l'applicazione del processo BillingDispute potrebbe avere un acronimo di BILLDISP.
- -containerSnapshotAcronym acronimo di process_application_snapshot_acronym
- Un parametro obbligatorio che identifica l'acronimo della snapshot per l'applicazione del processo. L'acronimo dell'istantanea può essere differente dal nome dell'istantanea. Per trovare l'acronimo dell'istantanea, eseguire il comando BPMShowProcessApplication . Fare riferimento all'argomento nel link correlato.
- -instanceStatus stato_istanza
- Un parametro obbligatorio che identifica lo stato delle istanze del processo da ripulire.
- COMPLETATO - Rimuove tutte le istanze di processo completate
- NON RIUSCITO - Rimuove tutte le istanze del processo non riuscite
- ANNULLATO - Rimuove tutte le istanze del processo terminate
- ALL - Rimuove tutte le istanze di processo completate, non riuscite e annullate
Suggerimento: non è possibile eliminare una istanza attualmente in esecuzione.
- -endedAfterLocal tempo_locale_sul server
- Un parametro facoltativo di tipo
Stringche identifica l'ora locale sul server. La stringa deve avere il seguente formato:yyyy-MM-ddThh:mm:ss(anno, mese, giorno, T, ore, minuti, secondi). Vengono elaborate solo le istanze completate, non riuscite o annullate dopo il periodo di tempo specificato da questo parametro. Se si utilizza questo parametro con il parametro endedBeforeLocal , vengono elaborate solo le istanze completate, non riuscite o annullate durante il periodo di tempo specificato da questo parametro.
- -endedBeforeLocal tempo_locale_sul server
- Un parametro facoltativo di tipo
Stringche identifica l'ora locale sul server. La stringa deve avere il seguente formato:yyyy-MM-ddThh:mm:ss(anno, mese, giorno, T, ore, minuti, secondi). Vengono elaborate solo le istanze completate, non riuscite o annullate prima del periodo di tempo specificato. Se si utilizza questo parametro con il parametro endedAfterLocal , vengono elaborate solo le istanze completate, non riuscite o annullate durante il periodo di tempo specificato da questo parametro.
- -instanceID ID_istanza
- Un parametro facoltativo di tipo
String[]che identifica un elenco di ID istanza che vengono rimossi. Se è presente più di un ID istanza, ogni ID istanza deve essere delimitato da uno spazio per i comandi in formato Jython o da un punto e virgola per i comandi in formato JACL. È inoltre possibile utilizzare questo parametro con endedAfterLocal o endedBeforeLocal. Consultare gli esempi in questo argomento.
- -maximumDuration numero_di_minuti
- Un parametro facoltativo che specifica il tempo massimo di eliminazione in minuti. Se la ripulitura impiega più tempo del tempo qui specificato, la sezione della transazione corrente per il lavoro di ripulitura corrente viene completata e, quindi, il lavoro di ripulitura corrente viene arrestato. Il valore predefinito è 0 (ovvero, nessun limite) se non specificato.
- -outputFile percorso_file
- Un parametro facoltativo che specifica il percorso file per scrivere i messaggi di log risultanti dall'esecuzione del comando. Il percorso del file può essere assoluto o relativo, ma la struttura della directory deve esistere già. Se non si fornisce questo parametro, il messaggio viene scritto nel file SystemOut.log .
- -transactionSlice numero_di_istanze_da_eliminare in_a_transazione
- Un parametro facoltativo che specifica il numero di istanze nella transazione per l'operazione di eliminazione. Il valore predefinito è 1 se non specificato.
Si consiglia di controllare il file SystemOut.log per le eccezioni se il servizio di cleanup ha modificato transactionSlice. La modifica del numero di istanze da eliminare in una transazione può migliorare il tempo dell'operazione di ripulitura.
Esempi
I seguenti esempi mostrano come utilizzare il comando BPMProcessInstancesCleanup .
- Eliminazione dell'istanza BPD e delle relative attività associate per le istanze
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym PA435 -containerSnapshotAcronym V1 -instanceStatus FAILED -outputFile C:\US58626\log1.txt]')
- Eliminazione delle istanze basate sugli ID istanza
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -instanceID [4 5 1001 1002]]') - Eliminazione di istanze che si verificano durante un intervallo di tempo che rientra in un intervallo specifico
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedAfterLocal 2012-01-01T00:00:00 -endedBeforeLocal 2012-02-31T21:37:06]') - Eliminazione delle istanze che si verificano prima dell'ora locale specificata sul server
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedBeforeLocal 2012-01-02T21:37:06]') wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedBeforeLocal 2012-05-02]') - Eliminazione di istanze che si verificano dopo l'ora locale specificata sul server
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedAfterLocal 2012-05-31T21:38:00]') wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedAfterLocal 2012-07-31]') - Eliminazione di istanze specifiche che si verificano in un intervallo di tempo specifico e si basano su ID istanza
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedAfterLocal 2012-01-01T00:00:00 -endedBeforeLocal 2012-02-31T21:37:06 -instanceID [53 54 55]]') - Eliminazione delle istanze che si verificano prima e dopo l'ora locale specificata nel server e che si basano sugli ID istanza
wsadmin -conntype SOAP -port 8880 -host ProcessServer01.mycompany.com -user admin -password admin -lang jython wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedAfterLocal 2012-05-20T00:00:00 -instanceID [53 54 55 56 57 58]]') wsadmin>AdminTask.BPMProcessInstancesCleanup('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -instanceStatus ALL -endedBeforeLocal 2012-05-31T21:37:06 -instanceID [53 54 55 56 57 58]]')