Comando mqsichangeflowuserexits - sistemi Windows, Linuxe AIX

Alcuni parametri hanno nomi alternativi; ad esempio, -e e --integration-server sono nomi di parametri alternativi del server di integrazione. I nomi lunghi e i nomi brevi disponibili sono elencati nella sezione Parametri.

integrationNodeName

Questo parametro identifica il nome di uno specifico nodo di integrazione. Per connettersi a un nodo di integrazione remoto per nome, è necessario specificare anche --admin-host e (facoltativamente) --admin-port.

-n integrationNodeFileName | --integration-node-file integrationNodeFileName

Questo parametro identifica il nome di un file .broker che contiene i dettagli di connessione per un nodo di integrazione o un server di integrazione indipendente. Includere l'ubicazione (percorso) e il nome del file quando si specifica questo parametro. È necessario assicurarsi che l'ubicazione sia accessibile quando si esegue questo comando.

Il file può essere utilizzato per connettersi a un server di integrazione indipendente se:

• I dettagli della connessione non includono un nome di nodo (integrationNodeName )
• L'host e la porta sono per un server di integrazione indipendente.

Utilizza questa opzione se più utenti desiderano connettersi allo stesso nodo di integrazione o server di integrazione, oppure se stai utilizzando parametri di connessione avanzati come SSL. Per ulteriori informazioni, vedere Connessione a un nodo di integrazione mediante la creazione di un file.broker.

È possibile eseguire un comando che utilizza SSL per amministrare un nodo di integrazione remoto o un server di integrazione tramite un canale protetto. È necessario specificare la password keystore e truststore per la connessione che sta utilizzando la variabile di ambiente IBM_JAVA_OPTIONS. Per ulteriori informazioni, vedere Risoluzione dei problemi durante l'esecuzione dei comandi.

--admin-hostipAddress --admin-port porto

Questi parametri identificano un host e una porta per un nodo di integrazione o un server di integrazione indipendente, per le connessioni che non richiedono parametri di connessione avanzati.

Per connettersi a un nodo di integrazione remoto specifico in base al nome, è possibile aggiungere il prefisso integrationNodeName. Non puoi usare-n integrationNodeFileName nello stesso comando.

Per un nodo di integrazione, qualsiasi parametro omesso assume valori predefiniti.

• --admin-hostindirizzo IP : il nome host o l'indirizzo IP del computer su cui è in esecuzione il nodo di integrazione o il server. Se non si specifica questo parametro, viene utilizzato un valore che rappresenta il computer locale.

  Per connettersi a un server di integrazione indipendente, il valore è l'host specificato nella proprietà adminRestApiHost nel file di configurazione server.conf.yaml per il server di integrazione.

  Se si desidera connettersi a un nodo di integrazione protetto o a un server come utente specifico, fornire le credenziali di sicurezza come URI nel seguente formato: tcp://user:password@hostname. Se la password contiene caratteri URI riservati, è necessario convertire tali caratteri nel formato codificato in percentuale. Per ulteriori informazioni, vedere Un URL e una password corretti restituiscono l'errore BIP1939 quando si tenta di connettersi a un nome host remoto in Risoluzione dei problemi durante l'esecuzione dei comandi.

• --admin-port porta : La porta su cui è in ascolto l'ascoltatore di connessioni dell'interfaccia utente web HTTP. Se non si specifica questo parametro, viene utilizzato il valore 4414.

  Per collegarsi a un server di integrazione indipendente, il valore è la porta impostata per la proprietà adminRestApiPort nel file di configurazione server.conf.yaml . Il valore predefinito è 7600.

--https

(Facoltativo) Specifica che per la connessione al nodo o al server di integrazione verrà utilizzato HTTPS. Se non vengono specificati né --https né --no-https , la connessione viene tentata prima con HTTPS e poi senza HTTPS se il primo tentativo fallisce.

--no-https

(Facoltativo) Specifica che HTTPS non sarà usato per la connessione al nodo o al server di integrazione. Se non vengono specificati né --https né --no-https , la connessione viene tentata prima con HTTPS e poi senza HTTPS se il primo tentativo fallisce.

--cacert cacertFile

(Facoltativo) Indica il percorso del file del certificato (in formato PEM, P12 o JKS) da utilizzare per verificare il nodo di integrazione o il server. Se non viene specificato alcun file cacert e viene abilitato admin-ssl predefinito, il file cacert viene impostato come file pem predefinito per admin-ssl.

• Il parametro --cacert è valido solo se per la connessione viene utilizzato HTTPS, pertanto non può essere impostato insieme al parametro --no-https . È possibile specificare --cacert se il --https parametro è stato impostato oppure se non è stato impostato né il parametro --https--no-https né l'altro (nel qual caso viene utilizzato per impostazione predefinita il valore " SSL ").
• Il parametro --cacert può essere impostato solo se il parametro --admin-host è specificato senza URI o se è specificato un URI che inizia con ssl://.

--cacert-password cacertPassword

(Facoltativo) La password per i file cacert protetti da password.

• Il parametro --cacert-password è valido solo se per la connessione è stato utilizzato HTTPS e se è stato impostato il parametro --cacert . Non è possibile impostarlo insieme al parametro --no-https .
• Il parametro --cacert-password può essere impostato solo se il parametro --admin-host è specificato senza URI o se è specificato un URI che inizia con ssl://.

--insecure

(Facoltativo) Specifica che il certificato restituito dal nodo o dal server di integrazione non sarà verificato.

• Il parametro --insecure è valido solo se per la connessione viene utilizzato HTTPS, pertanto non può essere impostato insieme al parametro --no-https . È possibile specificare --insecure se il --https parametro è stato impostato oppure se non è stato impostato né il parametro --https--no-https né l'altro (nel qual caso viene utilizzato per impostazione predefinita il valore " SSL ").
• Il parametro --insecure può essere impostato solo se il parametro --admin-host è specificato senza URI o se è specificato un URI che inizia con ssl://.

-a | --active-user-exit-list activeUserExitNames

(Facoltativo). Un elenco dei nomi, separati da due punti, delle uscite utente attive. Questi nomi sono stati registrati quando sono state caricate le uscite utente. Se una delle uscite utente elencate non è registrata per il nodo di integrazione di destinazione o il server di integrazione di destinazione, il comando ha esito negativo con un errore BIP8858 . Questo parametro può essere applicato solo a un nodo di integrazione o a un server di integrazione. È possibile cancellare l'elenco delle uscite utente attive fornendo un elenco vuoto ("") come valore per activeUserExitNames.

-e | --integration-server integrationServerName

(Obbligatorio per un server di integrazione gestito da un nodo di integrazione). Il nome del server di integrazione.

-f | --flow MessageFlow

(Facoltativo). Il nome del flusso di messaggi.

Quando si imposta questo parametro, è necessario impostare anche il parametro -k (nome applicazione).

Se si fornisce questo valore, l'uscita utente viene modificata per tale flusso di messaggi; in caso contrario, l'uscita utente viene impostata al livello del server di integrazione.

-i | --inactive-user-exit-list inactiveUserExitNames

(Facoltativo). Un elenco dei nomi, separati da due punti, delle uscite utente inattive. Questi nomi sono stati registrati quando sono state caricate le uscite utente. Se una delle uscite utente elencate non è registrata per il nodo di integrazione di destinazione o il server di integrazione di destinazione, il comando ha esito negativo con un errore BIP8858 . Questo parametro può essere applicato solo a un nodo di integrazione o a un server di integrazione. È possibile cancellare l'elenco delle uscite utente inattive fornendo un elenco vuoto ("") come valore per inactiveUserExitNames.

-k | --application applicationName

(Facoltativo) Questo parametro specifica il nome dell'applicazione che contiene il flusso di messaggi per cui viene modificata l'uscita utente.

Quando si imposta questo parametro, è anche necessario impostare il parametro -f (flusso di messaggi). Per modificare l'uscita utente per un flusso di messaggi denominato in un'applicazione specifica, impostare i parametri -k e -f .

È possibile utilizzare questo parametro con il parametro -y (nome libreria) per specificare che il flusso di messaggi si trova in una libreria a cui l'applicazione fa riferimento.

--non-persist

(Facoltativo) Per impostazione predefinita, le modifiche vengono conservate dopo il riavvio del server. Questo parametro garantisce che le modifiche non vengano conservate dopo un riavvio del server. Non può essere utilizzato per nodi di integrazione e non può essere utilizzato con il parametro --offline .

-o | --offline

(Facoltativo) Questo parametro abilita l'esecuzione del comando quando il nodo di integrazione viene arrestato. Non può essere utilizzato per un server di integrazione indipendente o un server di integrazione supportato da un nodo di integrazione.

-v | --trace traceFileName

(Facoltativo) Invia le informazioni della traccia di debug interna al file specificato.

-x | --user-exit-path userExitPath

(Facoltativo) Questo parametro specifica il nome percorso completo della directory da cui il nodo di integrazione ricerca tutte le uscite utente. Questo percorso viene aggiunto al percorso di ricerca della libreria di sistema (PATH, LIBPATH, LD_LIBRARY_PATH, SHLIBPATH) solo per il processo del nodo di integrazione. Se si utilizza questo parametro, è necessario specificare anche il parametro --offline . Questo parametro non può essere utilizzato per un server di integrazione supportato da un nodo di integrazione o da un server di integrazione indipendente.

Nota: è necessario impostare il percorso dell'uscita utente per un server di integrazione indipendente completando la seguente procedura:

1. Arrestare il server di integrazione indipendente. Per ulteriori informazioni, vedere Arresto di un server di integrazione.
2. Modificare il file server.conf.yaml per visualizzare il nome percorso completo della directory da cui il server di integrazione indipendente ricerca tutte le uscite utente:

   UserExits:
               userExitPath: 'C:\Program Files\IBM\ACE\11.0.0.x\server\sample\extensions\userexits\transport'

3. Avviare il server di integrazione. Per ulteriori informazioni, vedere Avvio di un server di integrazione.

-y | --library libraryName

(Facoltativo) Questo parametro specifica il nome della libreria che contiene il flusso di messaggi per cui viene modificata l'uscita utente.

Quando si imposta questo parametro, è anche necessario impostare i parametri -k (nome applicazione) e -f (flusso di messaggi). Per impostare le uscite utente attive o inattive per un flusso di messaggi denominato in una libreria specifica, impostare i parametri -y, -ke -f .

mqsichangeflowuserexits INODE -x C:\UserExitDirectory --offline

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -a ""

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -a exit1:exit2

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -i exit3:exit4

mqsichangeflowuserexits INODE -e default -a exit1:exit3

mqsichangeflowuserexits INODE -e default -i exit2:exit4

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -i exit1 -a exit2

mqsichangeflowuserexits --admin-host localhost --admin-port 7600 -k myApplication -f myFlow -a exit1:exit2

mqsichangeflowuserexits --admin-host localhost --admin-port 7600 -k myApplication -f myFlow -i exit3:exit4

mqsichangeflowuserexits --admin-host localhost --admin-port 7600 -a exit5:exit6 --trace C:\myTraceFile.txt --non-persist

Per eseguire questo esempio, è necessario prima impostare il percorso dell'uscita utente per il server di integrazione indipendente. Per ulteriori informazioni, consultare il suggerimento nella sezione Parametri.