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.

Importante Il comando BPMProcessInstancesCleanup è obsoleto. Si deve invece utilizzare il comando BPMProcessInstancesPurge, come descritto nel comando BPMProcessInstancesPurge.

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.

Il comando BPMProcessInstancesCleanup viene eseguito utilizzando l'oggetto AdminTask del client di script wsadmin.
Importante: attendere il completamento del comando prima di eseguirlo nuovamente.
Nota: in un ambiente con più domini di sicurezza configurati, utilizzare l'MBean PALService invece di questo comando wsadmin. Consultare MBean PAL (Process Application LifeCycle ).

Prerequisiti

Le seguenti condizioni devono essere soddisfatte:
  • Eseguire il comando in modalità connessa, ovvero non utilizzare l'opzione -conntype none wsadmin.
  • 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 String che 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 String che 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 .

Importante: in un ambiente di distribuzione di rete, utilizzare la porta configurata per il membro del cluster di applicazioni che esegue il file Workflow Server o IBM Workflow Center applicazioni. Per determinare il numero di porta corretto, consultare la pagina di raccolta Porte della console amministrativa (fare clic su Server > Tipi di server > WebSphere application server > nome_server > Comunicazioni > Porte e trovare il valore di SOAP_CONNECTOR_ADDRESS).
  • 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]]')