Proprietà del canale

È possibile impostare le proprietà per tutti i tipi di canali, compresi i canali di connessione client. Alcune proprietà sono specifiche per determinati tipi di canale.

Le seguenti tabelle elencano tutte le proprietà che è possibile impostare:

Alcune proprietà non si applicano a tutti i tipi di canali:
  • Alcune proprietà sono specifiche per i canali cluster.
  • [z/OS]Alcune proprietà sono specifiche dei canali z/OS® .

Per ogni proprietà, è riportata una breve descrizione di quando potrebbe essere necessario configurarla. Nelle tabelle è riportato anche il parametro MQSC equivalente per i comandi DEFINE, ALTER e DISPLAY CHANNEL. Per ulteriori informazioni sui comandi MQSC, consultare Amministrazione utilizzando i comandi MQSC.

Pagina Generale

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Generale della finestra Proprietà del canale .

Proprietà Significato Parametro MQSC
Nome canale Sola lettura. Questo è il nome della definizione del canale. CHANNEL
Tipo Sola lettura. Questo è il tipo di definizione di canale. CHLTYPE
Disposizione gruppo di condivisione code Sola lettura. Questa è la disposizione del gruppo di condivisione code della definizione del canale. Non è possibile modificare la disposizione di una definizione di un canale dopo averla creata. Queue manager significa che la definizione dell'oggetto è disponibile soltanto sul gestore code in cui è presente; Group significa che la definizione dell'oggetto è memorizzata sul repository condiviso e ogni gestore code nel gruppo di condivisione code ha una copia della definizione; Copy significa che la definizione dell'oggetto è la copia del gestore code di una definizione nel repository condiviso. QSGDISP
Descrizione Immettere una descrizione della funzione del canale. Consultare Stringhe nelle finestre delle proprietà. DESCR
Nome del gestore code Il nome del gestore code su cui è definito il canale. Per canali di connessione client, immettere il nome del gestore code a cui un'applicazione in esecuzione nell'ambiente client MQI può richiedere la connessione. QMNAME
Protocollo di trasmissione Selezionare dall'elenco il tipo di trasporto utilizzato dal canale. TRPTYPE
Nome connessione Per tutti i tipi di canale, tranne per i canali riceventi del cluster, immettere il nome del computer su cui è presente il gestore code di destinazione. Il formato del nome della connessione dipende dal protocollo di trasmissione selezionato. Ad esempio, se si sta utilizzando il protocollo TCP/IP e si sa che il gestore code utilizza un numero di porta diverso dal valore predefinito IBM® MQ 1414, immettere computer_name(port_number), dove computer_name è il nome o l'indirizzo IP del computer su cui è presente il gestore code di destinazione e port_number è la porta utilizzata dal listener del gestore code.

[AIX, Linux, Windows]Per i canali del ricevente del cluster su AIX®, Linux®, and Windows, che utilizzano il protocollo di trasporto TCP/IP, non specificare un valore per questa proprietà; IBM MQ genera un nome per l'utilizzo, supponendo la porta predefinita e l'indirizzo IPv4 corrente del sistema. Se il sistema non ha un indirizzo IPv4, verrà utilizzato l'indirizzo IPv6 corrente del sistema. Per canali riceventi del cluster su altre piattaforme e per canali riceventi del cluster che non utilizzano il protocollo TCP/IP, immettere il nome del computer su cui è presente il gestore code locale.

CONNAME
Coda di trasmissione Immettere il nome della coda di trasmissione che corrisponde al gestore code all'estremità ricevente del canale. XMITQ
Indirizzo di comunicazione locale Se il canale utilizza TCP/IP e si desidera che il canale utilizzi un indirizzo IP, una porta o un intervallo di porte particolare per le comunicazioni in uscita, immettere l'indirizzo di comunicazione locale per il canale. Il canale si collega all'indirizzo in locale. Utilizza il formatoipaddress(low-port, high-port), dove ipaddress è l'indirizzo IP specificato in formato IPv4 decimale puntato, IPv6 esadecimale o nome host alfanumerico. Ad esempio,192.0.2.0specifica l'indirizzo IPv4 con qualsiasi porta;192.0.2.0(1000)specifica l'indirizzo IPv4 e una porta specifica;192.0.2.0(1000,2000)specifica l'indirizzo IPv4 e un intervallo di porte;(1000)specifica solo una porta.

Cluster-sender channels: se si immette un valore nel campo Local communication address di un canale mittente del cluster definito manualmente, questo valore viene sovrascritto con i valori nel canale ricevente del cluster del repository completo quando si stabilisce la comunicazione con il gestore code del repository completo. Oltre a specificare il valore nel canale mittente del cluster definito manualmente, è necessario scrivere un'uscita di definizione automatica del canale per forzare il valore della proprietà Local communication address in qualsiasi canale mittente del cluster definito automaticamente.

LOCLADDR
 

Cluster-receiver channels: non inserire l'indirizzo IP nel campo Local communication address di un canale ricevente del cluster, a meno che tutti i gestori code non si trovino sullo stesso computer. Questo perché qualsiasi gestore code che tenta di connettersi a un gestore code con un indirizzo IP nel campo Local communication address del proprio canale ricevente del cluster ha questi valori propagati ai propri canali mittenti del cluster definiti automaticamente. Tuttavia, è possibile inserire un numero di porta o un intervallo di porte nel campo Local communication address di un canale ricevente del cluster se si desidera che tutti i gestori code in un cluster utilizzino una porta specifica o un intervallo di porte per tutte le relative comunicazioni in uscita.

 
Stato generale del canale Sola lettura. Questo è lo stato del canale. Stato

Pagina Esteso

La seguente tabella contiene le proprietà che è possibile impostare nella pagina Esteso della finestra Proprietà del canale .

Proprietà Significato Parametro MQSC
Lunghezza massima dei messaggi Immettere la lunghezza massima di un messaggio che può essere trasmesso sul canale.
  • Nelle seguenti piattaforme, il valore deve essere maggiore o uguale a zero e minore o uguale alla lunghezza massima del messaggio del gestore code:
    • [AIX]AIX
    • [IBM i]IBM i
    • [ Windows]Windows
    • VSE/ESA
  • Su altri Multiplatforms, il valore deve essere superiore o uguale a zero e inferiore o uguale a 4.194.304 byte.
  • [z/OS]Su IBM MQ for z/OS, il valore deve essere maggiore o uguale a zero e minore o uguale a 104.857.600 byte.
MAXMSGL
Intervallo heartbeat Immettere l'intervallo heartbeat compreso tra 0 e 999999. Il valore zero significa che non si verifica alcuno scambio heartbeat. Impostare il valore in modo che sia inferiore al valore della proprietà Disconnect interval. Il valore utilizzato è il valore maggiore tra quelli specificati sul lato di invio e sul lato di ricezione. L'intervallo heartbeat è il tempo (espresso in secondi) tra flussi heartbeat che passano dall'MCA di invio quando non sono presenti messaggi nella coda di trasmissione. Lo scambio heartbeat offre all'MCA di ricezione la possibilità di sospendere il canale. HBINT
Istanze massime

Questo parametro viene utilizzato sui canali di connessione server e sui canali AMQP. Maximum instances specifica il numero massimo di istanze simultanee di un singolo canale di connessione server o di un canale AMQP.

Il valore può essere un numero compreso tra 0 e 999999999. Il valore predefinito è 999999999

Il valore zero significa che viene impedito qualsiasi accesso client.

Se Maximum instances è impostato su un valore inferiore al numero di istanze del canale di connessione server attualmente in esecuzione, l'avvio di nuove istanze viene impedito fino a quando un numero sufficiente di istanze esistenti non arresta l'esecuzione.

Se un client si connette su un canale AMQP con un ID che è già connesso (ovvero, esegue un'acquisizione client) l'acquisizione riuscirà indipendentemente dal fatto che il numero dei client connessi abbia raggiunto MAXINST.

MAXINST
Massimo istanze per client

Questo parametro viene utilizzato sui canali di connessione server. Maximum instances per client specifica il numero massimo di istanze simultanee di un singolo canale di connessione server che possono essere avviate da un singolo client. In questo contesto, le connessioni aventi origine dallo stesso indirizzo di rete remoto vengono considerate come provenienti dallo stesso client.

Il valore può essere un numero compreso tra 0 e 999999999. Il valore predefinito è 999999999

Il valore zero significa che viene impedito qualsiasi accesso client.

Maximum instances è diverso da Maximum instances per client in quanto Maximum instances è la quantità massima di connessioni, mentre Maximum instances per client è la quantità massima di connessioni al server consentita per ciascun client.

MAXINSTC
Intervallo keep alive Immettere la lunghezza dell'intervallo keep alive, un numero compreso tra 0 e 99999. Questa proprietà viene ignorata se il canale utilizza un tipo di trasporto diverso da TCP o SPX. La proprietà TCP Keep alive deve essere impostata su Yes nella pagina Canali delle proprietà del gestore code.

[z/OS]Su z/OS gestori code, la proprietà Keep alive interval specifica l'intervallo keep alive per il singolo canale.

[UNIX, Linux, Windows, IBM i]Nei gestori code su più piattaforme, la proprietà Keep alive interval viene utilizzata solo se il canale si connette a un gestore code z/OS ; per utilizzare la funzionalità fornita dalla proprietà Keep alive interval , impostare la proprietà Keep alive interval su Automatico per utilizzare un valore basato sul valore dell'intervallo di heartbeat negoziato.

KAINT
Wrap numero di sequenza Il numero di sequenza è il numero di messaggi inviati mediante il canale. Tale numero viene incrementato ogni volta che viene inviato un messaggio.

[z/OS]Per z/OS utilizzare CICS®, immettere il numero più alto compreso nell'intervallo 1 - 999999999, che il numero di sequenza del messaggio raggiunge prima che venga riavviato su 1.

Per tutte le altre piattaforme, immettere il numero maggiore, nell'intervallo compreso tra 100 e 999999999, che il numero di sequenza dei messaggi raggiunge prima di ricominciare da 1.

Il valore deve essere sufficientemente grande da non essere riemesso mentre viene utilizzato da un messaggio precedente. Le due estremità del canale devono avere lo stesso valore del wrap numero di sequenza quando viene avviato il canale, altrimenti verrà restituito un errore.

SEQWRAP
Velocità messaggio non permanente

Per specificare che i messaggi non persistenti su un canale non vengono trasferiti all'interno di una transazione, selezionare Rapido. Ciò significa che i messaggi non persistenti possono essere richiamati più rapidamente che se facessero parte di una transazione. Tuttavia, poiché i messaggi non persistenti non fanno parte di una transazione, potrebbero essere persi se, ad esempio, il canale viene arrestato mentre i messaggi sono in transito. Per evitare che ciò avvenga, selezionare Normale. NPMSPEED
Dimensione del batch Immettere il numero massimo di messaggi da inviare prima del raggiungimento del punto di sincronizzazione. I messaggi vengono sempre trasferiti singolarmente ma ne viene eseguito il commit o il backout come batch. Provare la dimensione batch predefinita di50e modificare il valore solo se necessario. BATCHSZ
Compressione messaggi Fare clic su Modifica per aprire la finestra Modifica compressione messaggi. Selezionare le tecniche di compressione supportate dalla definizione del canale in base alle preferenze. Verrà utilizzata la prima tecnica supportata dall'altra estremità del canale. Nessuna significa che non viene eseguita alcuna compressione dei messaggi, RLE significa che la compressione dei dati dei messaggi viene eseguita mediante una codifica della durata dell'esecuzione, ZLIBFAST significa che la compressione viene eseguita mediante la tecnica di compressione zlib in un tempo breve, ZLIBHIGH significa che la compressione dei dati viene eseguita mediante la tecnica zlib con un livello elevato di compressione, ANY significa che è possibile utilizzare tutte le tecniche di compressione supportate dal gestore code. Per ulteriori informazioni, consultare Accodamento distribuito e cluster. COMPMSG
Compressione intestazione Fare clic su Modifica per aprire la finestra Modifica compressione intestazione. Selezionare le tecniche di compressione delle intestazioni supportate dalla definizione del canale in base alle preferenze. Verrà utilizzata la prima tecnica supportata dall'altra estremità del canale. Nessuno significa che non viene eseguita alcuna compressione mentre System significa che viene eseguita la compressione dell'intestazione. Per ulteriori informazioni, consultare Accodamento distribuito e cluster. COMPHDR
Intervallo batch Immettere il numero di millisecondi, da 0 a 999999999, durante il quale il canale mantiene un processo batch aperto anche se non sono presenti messaggi nella coda di trasmissione. BATCHINT
Limite dati batch Fornire il limite in kilobyte, con un valore compreso tra 0 e 999999, della quantità di dati inviata tramite un canale prima di acquisire un punto di sincronizzazione. Un valore 0 indica che non viene applicato alcun limite di dati ai batch in questo canale. BATCHLIM
Intervallo di disconnessione Immettere il numero di secondi, compreso tra 0 e 999999, tra il termine del batch e la chiusura del canale. Un valore uguale a 0 indica che il canale non si disconnette. DISCINT
Conversione dati Per specificare che il messaggio viene convertito dall'applicazione di ricezione nel formato richiesto sul sistema di ricezione (questo è il metodo solito), selezionare No; se il gestore code remoto si trova su una piattaforma che non supporta la conversione di dati, selezionare per specificare che il messaggio viene convertito prima della trasmissione nel formato richiesto dal sistema di ricezione. CONVERT
Autorizzazioni Put Questa proprietà specifica il tipo di elaborazione di sicurezza che deve essere utilizzato dall'agent MCA (Message Channel Agent) durante l'esecuzione di un comando MQPUT nella coda di destinazione o in una chiamata MQI. Per utilizzare l'ID utente predefinito, fare clic su Predefinito mentre per utilizzare l'ID utente alternativo dalle informazioni del contesto associate al messaggio, fare clic su Contesto. PUTAUT
Intervallo heartbeat batch

Se il canale di invio ha avuto una comunicazione dal canale ricevente nell'Intervallo heartbeat batch, il canale ricevente si presume sia ancora attivo, altrimenti viene inviato un 'heartbeat' al canale ricevente per un controllo. Il canale di invio attende una risposta dall'estremità di ricezione del canale per un intervallo, basato sul numero di secondi specificato nella proprietà intervallo heartbeat del canale (HBINT).

Se l'estremità di ricezione non è attiva, è possibile eseguire il backout del batch prima che questo entri in uno stato dubbio. Eseguendo il backout del batch, i messaggi restano disponibili per l'elaborazione in modo che possano, ad esempio, essere indirizzati a un altro canale. Immettere il numero di secondi, compreso tra 0 e 999999, che l'estremità di invio del canale deve attendere per una risposta dall'estremità di ricezione prima di assumere che l'estremità di ricezione del canale è inattiva.

Un valore uguale a 0 indica che l'heartbeat del batch non viene utilizzato. Per ulteriori informazioni, vedi Configurazione del canale per ridurre l'opportunità di essere messo 'in dubbio'.

BATCHHB
Disposizione canale predefinita Quando viene immesso il comando START CHANNEL senza la CHLDISP (channel disposition keyword), il canale viene avviato utilizzando il valore della Disposizione canale predefinita (DEFCDISP). I tre valori possibili sono:

Privato. Questo è il valore predefinito. Avvio come canale privato sul gestore code locale.

Condiviso. Un canale ricevente viene condiviso se è stato avviato in risposta a una trasmissione in entrata diretta al gruppo di condivisione code. Un canale mittente viene condiviso se la sua coda di trasmissione ha una disposizione SHARED.

Fix condivisa. Un canale mittente è condiviso se la sua coda di trasmissione ha una disposizione SHARED e CONNAME non è vuoto.
DEFCDISP
Controllo delle proprietà

(Solo su canali mittente, canali server, canali mittente cluster e canali ricevente cluster)

Questo definisce ciò che accade alle proprietà dei messaggi che stanno per essere inviati ad un gestore code IBM WebSphere® MQ 6.0 o antecedenti. Il valore deve essere modificato da Compatibilità a Tutto per preservare il modo in cui IBM WebSphere MQ 6.0 propaga RFH2 al chiamante. I valori possibili sono:

Tutti significa che tutte le proprietà del messaggio vengono incluse nel messaggio quando viene inviato al gestore code remoto. Le proprietà, eccetto quelle nel descrittore di messaggi (o estensione) vengono collocate in una o più intestazioni MQRFH2 nei dati del messaggio.

Compatibilità. Questo è il valore predefinito; consente alle applicazioni che prevedono proprietà relative a JMS in un'intestazione MQRFH2 nei dati del messaggio, di continuare a funzionare senza modifiche.

Se il messaggio contiene una proprietà con prefisso mcd., jms., usr., o mqext. tutte le proprietà facoltative del messaggio (dove il valore del supporto è MQPD_SUPPORT_OPTIONAL), eccetto quelle nel descrittore (o estensione) del messaggio, vengono collocate in una o più intestazioni MQRFH2 nei dati del messaggio prima che il messaggio venga inviato al gestore code remoto. In caso contrario, tutte le proprietà del messaggio, eccetto quelle nel descrittore di messaggi (o estensione), vengono rimosse dal messaggio prima che quest'ultimo venga inviato al gestore code remoto.

Se il messaggio contiene una proprietà in cui il campo Supporto del descrittore della proprietà non è impostato su MQPD_SUPPORT_OPTIONAL, il messaggio viene rifiutato e gestito conformemente alle relative opzioni del report. Se il messaggio contiene una o più proprietà in cui il campo Supporto del descrittore della proprietà è impostato su MQPD_SUPPORT_OPTIONAL, ma gli altri campi del descrittore della proprietà sono impostati su valori non predefiniti, queste proprietà vengono rimosse dal messaggio prima che quest'ultimo venga inviato al gestore code remoto.

Nessuno significa che tutte le proprietà del messaggio, eccetto quelle nel descrittore dei messaggi (o estensione), vengono rimosse dal messaggio prima che quest'ultimo venga inviato al gestore code remoto. Se il messaggio contiene una proprietà in cui il campo Supporto del descrittore della proprietà non è impostato su MQPD_SUPPORT_OPTIONAL, il messaggio viene rifiutato e gestito conformemente alle relative opzioni del report.

PROPCTL
Conversazioni di condivisione

(Solo in canali di connessione server e canali di connessione client)

Specifica il numero massimo di conversazioni che è possibile condividere in una particolare istanza del canale client TCP/IP (socket). I valori possibili sono:
0: indica nessuna condivisione di conversazioni in un socket TCP/IP. L'istanza del canale viene eseguita in una modalità precedente a IBM WebSphere MQ 7.0, in termini di:
  • Arresto o inattività amministratore
  • Heartbeat in corso
  • Lettura anticipata

1: indica nessuna condivisione di conversazioni in un socket TCP/IP. L'heartbeat client e la lettura anticipata sono disponibili, sia all'interno che all'esterno di una chiamata MQGET, e l'inattività del canale è più controllabile.

Da 2 a 999999999: il numero di conversazioni condivise. Il valore predefinito è 10.

Se il valore di connessione client SHARECNV non corrisponde al valore di connessione server SHARECNV, viene utilizzato il valore minore.
SHARECNV
Numero sequenza di reimpostazione in sospeso

Si tratta del numero sequenza da una richiesta in sospeso e indica che una richiesta del comando RESET CHANNEL dell'utente è in attesa. Un valore zero indica che non sono presenti RESET CHANNEL in sospeso. Il valore può essere compreso tra 1 e 999999999.

Quando il valore di RESETSEQ è 0, il comando DISPLAY CHANNEL restituisce RESETSEQ(NO).

RESETSEQ
Utilizza coda di messaggi non recapitabili

(Non su canali di connessione client, canali di connessione server o canali di telemetria)

Specifica se viene utilizzata la coda di messaggi non recapitabili quando i canali non sono in grado di consegnare i messaggi. Esistono due valori possibili:
  • No significa che i messaggi che non possono essere consegnati da un canale vengono considerati come un errore e il canale termina in base all'impostazione di Velocità messaggio non persistenteo elimina i messaggi.
  • significa che se la proprietà Dead - letter queue del gestore code fornisce il nome di una Dead Letter Queue, viene utilizzata. Altrimenti il funzionamento avviene come per No.
USEDLQ
PORT

(Solo sui canali AMQP)

Specifica la porta per la connessione AMQP. La porta predefinita per le connessioni AMQP 1.0 è 5672. Se si sta già utilizzando la porta 5672, è possibile specificare una porta differente. PORTA
Utilizza ID client

(Solo sui canali AMQP)

Specifica che l'ID client viene utilizzato per le connessioni su un canale AMQP. È impostato su o No. USECLTID
Keepalive AMQP

(Solo sui canali AMQP)

Specifica il tempo di keepalive in millisecondi. Se il client AMQP non ha inviato alcun frame nell'intervallo keep alive, la connessione viene chiusa con unamqp:resource-limit-exceededCondizione di errore AMQP. AMQPKA
Root argomento

(Solo sui canali AMQP)

Specifica la root argomento per un canale AMQP. Utilizzare questa proprietà per assicurarsi che un'applicazione MQ Light , quando distribuita a un gestore code, non pubblichi o sottoscriva i messaggi da o verso le aree della struttura ad albero degli argomenti utilizzate da altre applicazioni.

Il valore predefinito per TPROOT è SYSTEM.BASE.TOPIC. Con questo valore predefinito, la stringa di argomento utilizzata da un client AMQP per pubblicare o sottoscrivere non ha alcun prefisso e il client può scambiare messaggi con altre applicazioni di pubblicazione/sottoscrizione MQ.

TPROOT
[MQ 9.3.0 Lug 2022]Coda modello temporanea

(Solo sui canali AMQP)

Specifica il nome della coda modello da utilizzare mentre si crea una coda temporanea (lunghezza massima di 48 caratteri).

Il valore predefinito è SYSTEM.DEFAULT.MODEL.QUEUE.

TMPMODEL
[MQ 9.3.0 Lug 2022]Prefisso coda temporaneo

(Solo sui canali AMQP)

Il prefisso del nome di coda temporanea da aggiungere all'inizio della coda modello quando si deriva un nome di coda temporanea (lunghezza massima di 32 caratteri).

Il valore predefinito è AMQP.*

TMPQPRFX
[z/OS]Protezione della politica di protezione Definisce il comportamento dell'MCA (Message Channel Agent) quando si ricevono dei messaggi da una coda di trasmissione o si inseriscono in una coda di destinazione, in termini di applicazione delle politiche di sicurezza AMS.
Questo è valido per i canali di tipo mittente, server, ricevente e richiedente. I valori possibili sono:
Passthrough
Passare tutti i messaggi non modificati inviati o ricevuti dall'MCA (message channel agent) per questo canale.
Questo valore è valido per i canali di tipo mittente, server, ricevente o richiedente ed è il valore predefinito.
Rimuovi
Rimuovere qualsiasi protezione AMS dai messaggi richiamati dalla coda di trasmissione dall'MCA (message channel agent) ed inviare i messaggi al partner.
Quando l'MCA riceve un messaggio dalla coda di trasmissione, se è definita una politica AMS per la coda di trasmissione, viene applicata per rimuovere la protezione AMS dal messaggio prima di inviarlo attraverso il canale. Se non è definita una politica AMS per la coda di trasmissione, il messaggio viene inviato così com'è.
Questo valore è valido solo per i canali di tipo mittente e server.
Come politica
In base alla politica predefinita per la coda di destinazione, applicare la protezione AMS ai messaggi in entrata prima di inserirli sulla coda di destinazione.
Quando l'MCA (message channel agent) riceve un messaggio in entrata, se è definita una politica AMS per la coda di destinazione, viene applicata la protezione AMS al messaggio prima che venga inserito nella coda di destinazione. Se non è definita una politica AMS per la coda di destinazione, il messaggio viene inserito così com'è.
Questo valore è valido solo per i canali di tipo ricevente o richiedente.
SPLPROT

Pagina MCA

Nella seguente tabella sono riportate le proprietà che è possibile impostare sulla pagina MCA della finestra Proprietà dei canali . Per configurare la modalità di esecuzione dell'agent MCA (Message Channel Agent) per questo canale, modificare le proprietà nella pagina MCA.

Proprietà Significato Parametro MQSC
ID utente MCA L'identificativo utente MCA (Message Channel Agent). Se non è vuoto, è l'ID utente che deve essere utilizzato dall'MCA (Message Channel Agent) per l'autorizzazione ad accedere alle risorse IBM MQ, compresa (se PUTAUT è DEF) l'autorizzazione a inserire il messaggio nella coda di destinazione per i canali ricevitore o richiedente.
Se è vuoto, l'agent MCA utilizza l'identificativo utente predefinito. Tale identificativo deriva dall'ID utente che ha avviato il canale ricevente. I valori possibili sono:
  • [z/OS]Su z/OS, l'ID utente assegnato all'attività avviata dell'iniziatore di canali dalla tabella delle procedure avviate z/OS .
  • Per TCP/IP, per piattaforme diverse da z/OS, l'ID utente dalla voce inetd.conf o l'utente che ha avviato il listener.
  • Per SNA, per le piattaforme diverse da z/OS, l'ID utente dalla voce del server SNA o, in mancanza di questo, la richiesta di collegamento in entrata o l'utente che ha avviato il listener.
  • Per NetBIOS o SPX, l'ID utente che ha avviato il listener.
La lunghezza massima della stringa è:
  • [ Windows]64 caratteri su Windows.

    Per i canali con CHLTYPE uguale a AMQP, prima di IBM MQ 9.2.0, l'impostazione ID utente MCAUSER è supportata solo per gli ID utente con lunghezza fino a 12 caratteri. Da IBM MQ 9.2.0, il limite di 12 caratteri viene rimosso.

  • 12 caratteri su piattaforme diverse da Windows.

[ Windows]Su Windows, è possibile qualificare un identificativo utente con il nome dominio nel formato user@domain.

MCAUSER
Tipo MCA Per specificare che l'MCA (message channel agent) viene eseguito come thread, selezionare Thread; per specificare che MCA viene eseguito come processo, selezionare Processo. MCATYPE
Nome MCA Sola lettura. Non è possibile modificare questa proprietà perché il nome MCA è riservato e deve essere impostato solo su valori vuoti. MCANAME

Pagina Uscite

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Uscite della finestra Proprietà dei canali . Per configurare il canale in modo da eseguire le uscite utente, modificare le proprietà nella pagina Uscite.

Proprietà Significato Parametro MQSC
Nome uscita di invio Fare clic su Modifica per aprire la finestra Modifica nome uscita di invio. Aggiungere i nomi dei programmi delle uscite di invio:
  • [AIX][Linux]Su AIX and Linux, immettere i nomi di uno o più programmi di uscita. La lunghezza massima totale di tutti i nomi insieme è 999 caratteri. Utilizza il formatolibraryname(functionname), dove il numero massimo di caratteri in un nome è 128.
  • [ Windows]Su Windows, immettere il nome di uno o più programmi di uscita. La lunghezza massima totale di tutti i nomi insieme è 999 caratteri. Utilizza il formatodllname(functionname), dove il numero massimo di caratteri in un nome è 128.
  • [IBM i]Su IBM i, immettere i nomi di un massimo di 10 programmi di uscita. Utilizza il formatoprogramname libname, dove programname occupa i primi 10 caratteri e libname occupa i secondi 10 caratteri. Aggiungere spazi alla fine di nomi più brevi per portarli a 10 caratteri.
  • [z/OS]Su z/OS, immettere i nomi di un massimo di 8 programmi di uscita. Utilizzare il nome del modulo di caricamento, dove il numero massimo di caratteri di un nome è 8.
  • Su altre piattaforme, è possibile specificare il nome dell'unica uscita di invio per ogni canale.
SENDEXIT
Dati utente di uscita di invio Immettere i dati (massimo 32 caratteri) da inviare all'uscita di invio del canale quando viene richiamato il programma di uscita di invio:
  • [AIX, Linux, Windows]Su AIX, Linux, and Windows, immettere i dati per uno o più programmi di uscita. Separare i dati con le virgole. La lunghezza massima totale del campo è 999 caratteri.
  • [IBM i]Su IBM i, immettere fino a 10 stringhe di dati, ognuna con una lunghezza di 32 caratteri. La prima stringa di dati viene inviata alla prima uscita, la seconda stringa alla seconda uscita e così via.
  • [z/OS]Su z/OS, immettere fino a 8 stringhe di dati, ciascuna con una lunghezza di 32 caratteri. La prima stringa di dati viene inviata alla prima uscita, la seconda stringa alla seconda uscita e così via.
  • Su altre piattaforme, è possibile specificare soltanto una stringa di dati per l'uscita di invio per ogni canale.
SENDDATA
Nome uscita di ricezione Fare clic su Modifica per aprire la finestra Modifica nome uscita di ricezione. Aggiungere i nomi dei programmi delle uscite di ricezione:
  • [AIX][Linux]Su AIX and Linux, immettere i nomi di uno o più programmi di uscita. Il numero massimo di caratteri totale in tutti i nomi è 999 caratteri. Utilizza il formatolibraryname(functionname), dove il numero massimo di caratteri in una stringa è 128.
  • [ Windows]Su Windows, immettere il nome di uno o più programmi di uscita. Separare i nomi con le virgole. La lunghezza massima totale del campo è 999 caratteri. Utilizza il formatodllname(functionname), dove il numero massimo di caratteri in una stringa è 128.
  • [ Windows]Su Windows, immettere i nomi di un massimo di 10 programmi di uscita. Separare i nomi con le virgole. Utilizza il formatoprogramname libname, dove programname occupa i primi 10 caratteri e libname occupa i secondi 10 caratteri. Aggiungere spazi alla fine di nomi più brevi per portarli a 10 caratteri.
  • [z/OS]Su z/OS, immettere i nomi di un massimo di 8 programmi di uscita. Separare i nomi con le virgole. Utilizzare il nome del modulo di caricamento, dove il numero massimo di caratteri è 8.
  • Su altre piattaforme, è possibile specificare il nome dell'unica uscita di invio per ogni canale.
RCVEXIT
Dati utente di uscita di ricezione Immettere i dati (massimo 32 caratteri) inviati all'uscita di ricezione del canale quando viene richiamato il programma di uscita di ricezione:
  • [AIX, Linux, Windows]Su AIX, Linux, and Windows, immettere i dati per uno o più programmi di uscita. Separare i dati con le virgole. La lunghezza massima totale del campo è 999 caratteri.
  • [IBM i]Su IBM i, immettere fino a 10 stringhe di dati, ognuna con una lunghezza di 32 caratteri. La prima stringa di dati viene inviata alla prima uscita di ricezione, la seconda stringa alla seconda uscita e così via.
  • [z/OS]Su z/OS, immettere fino a 8 stringhe di dati, ciascuna con una lunghezza di 32 caratteri. La prima stringa di dati viene inviata alla prima uscita di ricezione, la seconda stringa alla seconda uscita e così via.
  • Su altre piattaforme, è possibile specificare soltanto una stringa di dati per l'uscita di ricezione per ogni canale.
RCVDATA
Nome uscita di sicurezza Immettere il nome dell'uscita di sicurezza:
  • [AIX, Linux, Windows]Su AIX, Linux, and Windows, utilizzare il formatolibraryname(functionname), dove il numero massimo di caratteri in una stringa è 128.
  • [IBM i]Su IBM i, utilizzare il formatoprogramname libname, dove programname occupa i primi 10 caratteri e libname occupa i secondi 10 caratteri. Aggiungere spazi alla fine di nomi più brevi per portarli a 10 caratteri.
  • [z/OS]Su z/OS, utilizzare il nome del modulo di caricamento, dove il numero massimo di caratteri è 8.
SCYEXIT
Dati utente di uscita di sicurezza Immettere i dati (massimo 32 caratteri) inviati all'uscita di sicurezza del canale quando viene richiamata l'uscita di sicurezza. SCYDATA
Nome uscita messaggi Fare clic su Modifica per aprire la finestra Modifica nome uscita messaggio. Aggiungere i nomi dei programmi delle uscite di messaggi:
  • [AIX][Linux]Su AIX and Linux, immettere i nomi di uno o più programmi di uscita. La lunghezza massima totale di tutti i nomi insieme è 999 caratteri. Utilizza il formatolibraryname(functionname), dove il numero massimo di caratteri in un nome è 128.
  • [ Windows]Su Windows, immettere il nome di uno o più programmi di uscita. La lunghezza massima totale di tutti i nomi insieme è 999 caratteri. Utilizza il formatodllname(functionname), dove il numero massimo di caratteri in un nome è 128.
  • [IBM i]Su IBM i, immettere i nomi di un massimo di 10 programmi di uscita. Utilizza il formatoprogramname libname, dove programname occupa i primi 10 caratteri e libname occupa i secondi 10 caratteri. Aggiungere spazi alla fine di nomi più brevi per portarli a 10 caratteri.
  • [z/OS]Su z/OS, immettere i nomi di un massimo di 8 programmi di uscita. Utilizzare il nome del modulo di caricamento, dove il numero massimo di caratteri di un nome è 8.
  • Su altre piattaforme, è possibile specificare il nome dell'unica uscita di messaggi per ogni canale.
MSGEXIT
Dati utente uscita messaggi Immettere i dati (massimo 32 caratteri) inviati all'uscita dei messaggi del canale quando viene richiamato il programma di uscita dei messaggi:
  • [AIX, Linux, Windows]Su AIX, Linux, and Windows, immettere i dati per uno o più programmi di uscita. Separare i dati con le virgole. La lunghezza massima totale del campo è 999 caratteri.
  • [IBM i]Su IBM i, immettere fino a 10 stringhe di dati, ognuna con una lunghezza di 32 caratteri. La prima stringa di dati viene inviata alla prima uscita dei messaggi, la seconda stringa alla seconda uscita e così via.
  • [z/OS]Su z/OS, immettere fino a 8 stringhe di dati, ciascuna con una lunghezza di 32 caratteri. La prima stringa di dati viene inviata alla prima uscita dei messaggi, la seconda stringa alla seconda uscita e così via.
  • Su altre piattaforme, è possibile specificare soltanto una stringa di dati per l'uscita dei messaggi per ogni canale.
MSGDATA

Pagina LU6.2

La seguente tabella contiene le proprietà che è possibile impostare nella pagina LU6.2 della finestra Proprietà del canale . Se il canale utilizza il protocollo di trasporto LU 6.2, modificare le proprietà nella pagina LU6.2.

Proprietà Significato Parametro MQSC
Nome modalità Immettere il nome della modalità LU 6.2, che è il nome della modalità SNA a meno che il valore della proprietà Connection name nella pagina Generale contenga un oggetto laterale, nel qual caso è necessario lasciare vuoto il valore Mode name. La lunghezza massima è 8 caratteri. MODENAME
Nome TP Immettere il nome, o il nome generico, del programma MCA eseguito all'estremità del link. TPNAME
ID utente Immettere l'ID utente utilizzato da MCA durante il tentativo di inizializzazione di una sessione LU 6.2 sicura con un MCA remoto. La lunghezza massima è 12 caratteri, tuttavia, solo i primi 10 vengono utilizzati. USERID
Password Fare clic su Modifica password canale, quindi nella finestra Modifica password immettere la password utilizzata da MCA durante il tentativo di inizializzazione di una sessione LU 6.2 sicura con un MCA remoto. La lunghezza massima è 12 caratteri. Password

Pagina Nuovo tentativo

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Riprova della finestra Proprietà del canale . Per configurare il comportamento del canale se non riesce a connettersi al gestore code remoto, modificare le proprietà nella pagina Nuovo tentativo.

Proprietà Significato Parametro MQSC
Numero di tentativi brevi Immettere il numero massimo, compreso tra 0 e 999999999 (o, per z/OS con CICS, compreso tra 1 e 999999999), di tentativi di connessione del canale al gestore code remoto. SHORTRTY
Intervallo nuovo tentativo breve Immettere l'intervallo approssimativo, in secondi, che il canale deve attendere prima di provare di nuovo a connettersi al gestore code remoto durante il numero di tentativi brevi. Un valore uguale a 0 indica che il canale esegue immediatamente il nuovo tentativo di collegamento. SHORTTMR
Numero di tentativi lunghi Immettere il numero massimo, compreso tra 0 e 999999999, di tentativi di connessione del canale al gestore code remoto. Il valore di questa proprietà viene utilizzato solo quando il conteggio specificato nella proprietà Short retry count è esaurito e il canale non è ancora connesso correttamente al gestore code remoto. LONGRTY
Intervallo nuovo tentativo lungo Immettere l'intervallo approssimativo, in secondi, che il canale deve attendere prima di provare di nuovo a connettersi al gestore code remoto durante il numero di tentativi lunghi. Un valore uguale a 0 indica che il canale esegue immediatamente il nuovo tentativo di collegamento. LONGTMR
Intervallo keep alive Il valore della proprietà Keep alive interval specifica il valore di timeout del canale. Per basare il valore keep alive sul valore di Intervallo heartbeat negoziato, selezionare Automatico. Se l'intervallo di heartbeat negoziato è maggiore di zero, Keep alive interval è l'intervallo di heartbeat negoziato più 60 secondi; se l'intervallo di heartbeat negoziato è zero, anche Keep alive interval è zero. Per specificare un valore di time-out, immettere il numero di secondi compreso tra 0 e 99999. Per disabilitare KeepAlive su questo canale, immettere 0. KAINT

Pagina Nuovo tentativo di messaggio

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Nuovo tentativo di messaggio della finestra Proprietà del canale . Per configurare il comportamento del canale se viene restituito un errore la prima volta in cui tenta di inserire un messaggio in una coda remota, modificare le proprietà nella pagina Nuovo tentativo di messaggio.

Proprietà Significato Parametro MQSC
Conteggio nuovo tentativo di messaggio Immettere il numero di tentativi, compreso tra 0 e 999999999, di consegna di un messaggio da parte di un canale, prima che quest'ultimo decida che non è possibile consegnare il messaggio alla coda remota. Questa proprietà controlla l'azione di MCA solo se la proprietà Message retry exit name è vuota. Se la proprietà Message retry exit name non è vuota, il valore della proprietà Message retry count viene passato all'uscita perché possa utilizzarlo, ma il numero di volte in cui il canale riprova a consegnare il messaggio è controllato dall'uscita, non dalla proprietà Message retry count. MRRTY
Intervallo nuovo tentativo di messaggio Immettere il tempo minimo, in millisecondi, che il canale deve attendere prima di poter provare di nuovo a inserire un messaggio nella coda remota. MRTMR
Nome uscita nuovo tentativo messaggi Immettere il nome del programma di uscita dei nuovi tentativi dei messaggi del canale:
  • [AIX][Linux]Su AIX and Linux, utilizzare il formatolibraryname(functionname), dove il numero massimo di caratteri in una stringa è 128.
  • [ Windows]Su Windows, utilizzare il formatodllname(functionname), dove il numero massimo di caratteri in una stringa è 128.
  • [IBM i]Su IBM i, utilizzare il formatoprogramname libname, dove programname occupa i primi 10 caratteri e libname occupa i secondi 10 caratteri. Aggiungere spazi alla fine di nomi più brevi per portarli a 10 caratteri.
  • [z/OS]Su z/OS, utilizzare il nome del modulo di caricamento, dove il numero massimo di caratteri è 8.
MRDATA
Dati utente uscita nuovo tentativo messaggi Immettere i dati (massimo 32 caratteri) inviati all'uscita dei nuovi tentativi dei messaggi del canale quando viene richiamata l'uscita. MREXIT

Pagina Cluster

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Cluster della finestra Proprietà dei canali . Per condividere il canale in uno o più cluster, modificare le proprietà nella pagina Cluster.
Nota: specificare le proprietà del canale cluster sui canali riceventi del cluster sui gestori code di destinazione. Tutte le proprietà specificate nei corrispondenti canali mittenti del cluster verranno probabilmente ignorate. Consultare Canali cluster.
Proprietà Significato Parametro MQSC
Non condivisi in un cluster Questa opzione è selezionata per impostazione predefinita, pertanto il canale non è condiviso in alcun cluster. Non applicabile.
Condiviso in cluster Per condividere il canale in un cluster, selezionare questa opzione, quindi immettere il nome del cluster. Consultare Stringhe nelle finestre delle proprietà. cluster
Condiviso in un elenco di cluster Per condividere il canale in più di un cluster, selezionare questa opzione, quindi immettere il nome dell'elenco nomi che contiene i nomi dei cluster. Consultare Stringhe nelle finestre delle proprietà. CLUSNL
Priorità di rete Il valore di questa proprietà indica la priorità del canale per la connessione di rete. Immettere il valore, compreso tra 0 e 9; 0 è la priorità più bassa. Consultare Proprietà del canale NETPRTY. NETPRTY
Classificazione canale CLWL Immettere la classificazione del canale nel cluster, compresa tra 0 e 9; 0 è la classificazione più bassa. Consultare Proprietà del canale CLWLRANK. CLWLRANK
Priorità canale CLWL Immettere la priorità del canale nel cluster, compresa tra 0 e 9; 0 è la priorità più bassa. Consultare Proprietà del canale CLWLPRTY. CLWLPRTY
Peso canale CLWL Immettere il valore di importanza applicato al canale in modo che venga controllata la proporzione dei messaggi inviati mediante il canale. Il valore deve essere compreso tra 1 e 99; 1 è il peso minimo. Consultare Proprietà del canale CLWLWGHT. CLWLWGHT

Pagina SSL

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina SSL della finestra Proprietà dei canali . Per configurare il canale in modo da utilizzare la sicurezza SSL, modificare le proprietà nella pagina SSL.

Proprietà Significato Parametro MQSC
CertificateLabel Etichetta certificato destinata all'utilizzo da parte di questo canale. L'etichetta identifica quale certificato personale nel repository delle chiavi deve essere inviato al peer remoto. Se questa proprietà è vuota, il certificato viene determinato dalla proprietà CertificateLabel del gestore code. CERTLABL
CipherSpec Immettere il nome (massimo 32 caratteri) della CipherSpec per una connessione TLS. Entrambe le estremità della definizione di canale SSL di IBM MQ devono avere lo stesso valore nella proprietà CipherSpec. Per ulteriori informazioni, consultare la proprietà SSLCIPH in DEFINE CHANNEL.

Il valore per questo parametro viene utilizzato anche per impostare il valore della proprietà Protocollo di protezione, che è un campo di output nella pagina Attributi di stato canale .

SSLCIPH
Autenticazione dei componenti che avviano le connessioni Per specificare che il canale deve ricevere e autenticare un certificato TLS da un client TLS, selezionare Richiesto; per specificare che il canale non deve ricevere e autenticare un certificato TLS da un client TLS, selezionare Facoltativo; se si seleziona Facoltativo e il client TLS peer invia un certificato, il canale lo autenticherà come normale. SSLCAUTH
Nome emittente peer Il filtro di DN (Distinguished Name) dell'emittente del certificato. Questo campo contiene un filtro di DN (Distinguished Name) che corrisponde al DN emittente del certificato personale del peer remoto. Nome emittente peer è un campo chiave nell'associazione peer SSL, ossia viene utilizzato per mettere in corrispondenza i record di autorizzazione canale per le connessioni del canale in ingresso. SSLCERTI
Accetta solo certificati quando il DN corrisponde a questi valori Immettere il valore del DN sul certificato dal gestore code peer o dal client all'altra estremità del canale IBM MQ . Quando il canale viene avviato, il valore di questa proprietà viene confrontato con il DN (Distinguished Name) del certificato. SSLPEER
Accetta solo certificati quando il DN corrisponde a questi valori Questo record di autenticazione di canale associa i DN (Distinguished Name) TLS a valori MCAUSER. Il parametro SSLPEERMAP deve essere accompagnato da un SSLPEER. SSLPEERMAP

Pagina di bilanciamento del carico

Nella tabella seguente sono riportate le proprietà che è possibile impostare nella pagina Bilanciamento del carico della finestra Proprietà del canale .

Proprietà Significato Parametro MQSC
Peso La proprietà relativa al peso del canale client viene utilizzata per specificare un peso per influenzare quale definizione del canale di connessione client verrà utilizzata. La proprietà del peso del canale client viene utilizzata in modo che le definizioni del canale client possano essere selezionate in modo casuale in base al loro peso quando è disponibile più di una definizione adatta.

Quando un client emette un MQCONN che richiede una connessione a un gruppo di gestori code, specificando un nome di un gestore code che inizia per asterisco, ed è disponibile più di una definizione canale adatta nella tabella CCDT (client channel definition table), la definizione da utilizzare verrà selezionata a caso, sulla base del peso, con tutte le definizioni CLNTWGHT(0) applicabili precedentemente selezionate in ordine alfabetico. Specificare un valore compreso nell'intervallo 0 - 99. Il valore predefinito è 0. Il valore 0 indica che non viene eseguito alcun bilanciamento del carico e che le funzioni applicabili vengono selezionate in ordine alfabetico. Per abilitare il bilanciamento del carico, scegliere un valore compreso fra 1 e 99, dove 1 è il peso minore e 99 quello maggiore. La distribuzione dei messaggi fra due o più canali il cui peso è differente da zero, è approssimativamente proporzionale al rapporto di tali pesi.

CLNTWGHT
Affinità La proprietà di affinità del canale viene utilizzata in modo che le applicazioni client che si connettono più volte utilizzando lo stesso nome del gestore code possano scegliere se utilizzare la stessa definizione di canale client per ogni connessione. Utilizzare questa proprietà quando sono disponibili più definizioni di canale applicabili. I valori possibili sono:

PREFERITA. Questo è il valore predefinito. La prima connessione in un processo che legge una tabella CCDT (client channel definition table) provvede alla creazione di un elenco di definizioni applicabili basate sul peso del canale client, in cui tutte le definizioni hanno un peso iniziale di 0 e sono disposte in ordine alfabetico. Ciascuna connessione del processo esegue tentativi di connessione utilizzando la prima definizione nell'elenco. Se una connessione non riesce, verrà utilizzata la definizione successiva. Le definizioni non riuscite con valori di peso del canale client diversi 0 vengono spostate in fondo all'elenco. Le definizioni con un peso del canale client pari a 0 rimangono all'inizio dell'elenco e vengono selezionate per prime, per ciascuna connessione. Ciascun processo client con lo stesso nome host crea lo stesso elenco.

NONE. La prima connessione in un processo che legge una tabella CCDT (client channel definition table) provvede alla creazione di un elenco di definizioni applicabili. Tutte le connessioni in un processo selezionano una definizione applicabile basata sul peso del canale client, in cui tutte le definizioni con un peso pari a 0 vengono selezionate inizialmente in ordine alfabetico.

AFFINITÀ

Pagina Statistiche

Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Statistiche della finestra Proprietà del canale . Per configurare il canale in modo da raccogliere i dati di controllo o delle statistiche, modificare le proprietà nella pagina Statistiche.

Proprietà Significato Parametro MQSC
Data della modifica Sola lettura. Questa è la data dell'ultima modifica delle proprietà della coda. ALTDATE
Ora della modifica Sola lettura. Questa è l'ora dell'ultima modifica delle proprietà della coda. ALTTIME
Controllo canale È possibile configurare IBM MQ per raccogliere i dati di monitoraggio online sulle prestazioni correnti del canale. Per ereditare il valore della proprietà Channel monitoring del gestore code (consultare Proprietà gestore code), fare clic su Gestore code. Se la proprietà Channel monitoring del gestore code è None, la proprietà Channel monitoring della coda viene ignorata. Se la proprietà Channel monitoring del gestore code non è None: per sovrascrivere le impostazioni del gestore code e impedire la raccolta dei dati per questo canale, fare clic su Disattivo; per raccogliere dati a frequenza bassa, fare clic su Bassa; per raccogliere i dati a frequenza media, fare clic su Media; per raccogliere dati a frequenza alta, fare clic su Alta. MONCHL
Statistiche canale È possibile configurare IBM MQ per raccogliere dati statistici sull'attività del canale. Per ereditare il valore della proprietà Channel statistics del gestore code (consultare Proprietà del Gestore code), fare clic su Gestore code. Se la proprietà Channel statistics del gestore code è None, la proprietà Channel statistics della coda viene ignorata. Se la proprietà Channel statistics del gestore code non è None: per sovrascrivere le impostazioni del gestore code e impedire la raccolta dei dati per questo canale, fare clic su Disattivo; per raccogliere dati a frequenza bassa, fare clic su Bassa; per raccogliere i dati a frequenza media, fare clic su Media; per raccogliere dati a frequenza alta, fare clic su Alta. STATCHL