Comando mqsichangeflowuserexits

Sistemi operativi supportati

Funzione

Utilizzare il comando mqsichangeflowuserexits per impostare l'elenco di uscite utente attive e inattive. Esiste un elenco di uscite utente attive e un elenco di uscite utente inattive per ogni gruppo di esecuzione e flusso di messaggi. Lo stato effettivo delle uscite utente per un determinato flusso viene deciso all'avvio del flusso. Viene deciso considerando l'elenco delle suddette uscite per il flusso e per il relativo gruppo di esecuzione.

L'ordine di precedenza è flusso di messaggio, gruppo di esecuzione e quindi valore predefinito del broker. L'elenco attivo ha la precedenza rispetto all'elenco inattivo nelle impostazioni del flusso di messaggi e del gruppo di esecuzione.

Se lo stato di una determinata uscita utente non viene impostato per il flusso di messaggi, il relativo stato viene acquisito dall'impostazione del gruppo di esecuzione. Se il relativo stato non viene impostato per il flusso di messaggi o per il gruppo di esecuzione, assume lo stato predefinito implicitamente inattivo o può essere definito esplicitamente come attivo dalla proprietà del broker activeUserExits, tramite il comando mqsichangebroker.

Se un determinato nome dell'uscita utente è presente sia negli elenchi attivi che in quelli inattivi per un flusso di messaggi o per un gruppo di esecuzione, l'elenco attivo ha la precedenza e l'uscita utente è attiva per tale livello. Quindi, per modificare un'uscita utente da attiva a inattiva, occorre specificarla come parte dell'elenco inattivo, utilizzando l'indicatore -i rispecificando il nuovo elenco attivo tramite l'indicatore -a.

Quando sono attive più uscite per un determinato flusso, esse vengono richiamate in un ordine definito. Tali uscite nell'elenco attivo del flusso di messaggi vengono richiamate per prime nell'ordine in cui sono state specificate nell'indicatore -a.

Dopo averle richiamate, le uscite nell'elenco attivo del gruppo di esecuzione (che non si trovavano né nell'elenco attivo che inattivo del flusso) vengono richiamate. Esse vengono richiamate nell'ordine in cui sono state specificate nell'indicatore -a.

Tutte le uscite utente non indicate nell'elenco attivo o inattivo del gruppo di esecuzione o del flusso di messaggi, ma presenti nell'elenco attivo del broker, vengono richiamate nell'ordine in cui sono state specificate quando la proprietà del broker activeUserExits è stata impostata.

Se una delle uscite utente specificata nell'elenco attivo o inattivo non viene registrata per il gruppo di esecuzione di destinazione, il comando ha esito negativo con un errore BIP8858.

Dopo il completamento del comando corretto, se una delle uscite utente specificata diventa non valida, a seconda dell'elenco in cui l'uscita utente è stata visualizzata, viene eseguita la seguente azione:
  • Se l'uscita utente è stata specificata nell'elenco attivo o inattivo del flusso di messaggi, il flusso ha esito negativo e viene scritto il messaggio BIP2315 nella registrazione del sistema.
  • Se l'uscita utente è stata specificata nell'elenco attivo o inattivo del gruppo di esecuzione, tale gruppo ha esito negativo e viene scritto il messaggio BIP2314 nella registrazione del sistema.
Ciò potrebbe verificarsi per uno dei tre seguenti motivi:
  • Il broker o il gruppo di esecuzione viene riavviato dopo avere modificato la variabile MQSI_USER_EXIT_PATH rimuovendo la directory contenente la libreria dell'uscita utente.
  • Il broker o il gruppo di esecuzione viene riavviato dopo avere modificato la proprietà del broker userExitPath rimuovendo la directory contenente la libreria dell'uscita utente.
  • Tale libreria (o una delle relative dipendenze) viene rimossa o il broker non è in grado di caricarla.

Sintassi

Parametri

brokername
(Obbligatorio). Il nome del broker.
-e egName
(Obbligatorio). Il nome del gruppo di esecuzione.
-f messageflow
(Facoltativo). Il nome del flusso di messaggi Se fornita, l'uscita utente viene modificata per tale flusso di messaggi. Se non fornita, l'uscita utente viene impostata al livello del gruppo di esecuzione.
-a activeUserExitNames
(Facoltativo). Un elenco dei nomi, separato dai due punti, delle uscite utente attive. Questi sono nomi registrati dalle uscite utente, durante il relativo caricamento. Se una delle uscite utente non viene registrata per il gruppo di esecuzione di destinazione, il comando ha esito negativo con un errore BIP8858.
-i inactiveUserExitNames
(Facoltativo).

Un elenco dei nomi, separato dai due punti, delle uscite utente inattive. Questi sono nomi registrati dalle uscite utente, durante il relativo caricamento. Se una delle uscite utente non viene registrata per il gruppo di esecuzione di destinazione, il comando ha esito negativo con un errore BIP8858.

Autorizzazione

L'ID utente utilizzato per richiamare questo comando deve disporre di un'autorizzazione del gruppo mqbrkrs.

Risposte

Questo comando restituisce le seguenti risposte:
  • BIP8852 Istruzione di utilizzo
  • BIP80711 Comando completato con esito positivo.
  • BIP8858 Nomi di uscita utente &1 non valide (in cui &1 è il nome delle uscite utente specificate su questo comando ma che non sono valide perché non sono state registrate nel gruppo di esecuzione di destinazione).

Esempi

Impostazione delle uscite attive a livello del flusso
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -a exit2
BIP8071I: Comando completato con esito positivo.
Impostazione delle uscite inattive a livello del flusso
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -i exit1
BIP8071I: Comando completato con esito positivo.
Impostazione delle uscite attive a livello del gruppo di esecuzione
mqsichangeflowuserexits WBRK_BROKER -e default -a exit3,exit1
BIP8071I: Comando completato con esito positivo.
Impostazione delle uscite inattive a livello del gruppo di esecuzione
mqsichangeflowuserexits WBRK_BROKER -e default -1 exit2
BIP8071I: Comando completato con esito positivo.
La modifica di exit1 in inattiva mentre exit2 è attivo a livello del flusso (Un comando è stato immesso precedentemente con "-a exit1:exit2" per impostarli entrambi su attivi)
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -i exit1 -a exit2
BIP8071I: Comando completato con esito positivo.
Concetti correlati
Sviluppo di uscite utente
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an35900_