Il programma di esempio Connect

Il programma di esempio Connect consente di esplorare la chiamata MQCONNX e le sue opzioni da un client. L'esempio si connette al gestore code utilizzando la chiamata MQCONNX, richiede il nome del gestore code utilizzando la chiamata MQINQ e lo visualizza. Inoltre, vengono fornite informazioni sull'esecuzione dell'esempio amqscnxc.

Nota: il programma di esempio Connect è un esempio client. È possibile compilarlo ed eseguirlo su un server, ma la funzione è significativa solo su un client e vengono forniti solo i file eseguibili dal client.

Esecuzione dell'esempio amqscnxc

La sintassi della riga comandi del programma di esempio Connect è:

amqscnxc [-x ConnName [-c SvrconnChannelName]] [-u User] [QMgrName]

I parametri sono opzionali e il loro ordine non è importante, a eccezione di QMgrName, che, se specificato, deve arrivare per ultimo. I parametri sono:

ConnName: Il nome della connessione TCP/IP del gestore code del server
Se non si specifica il nome della connessione TCP/IP, MQCONNX viene emesso con il ClientConnPtr impostato a NULL.
SvrconnChannelName: Il nome del canale di connessione server
Se si specifica il nome connessione TCP/IP ma non il canale di connessione server (l'inverso non è consentito), l'esempio utilizza il nome SYSTEM.DEF.SVRCONN.
Utente: Il nome utente da utilizzare per l'autenticazione della connessione
Se si specifica questa opzione, il programma richiederà una parola d'ordine per accompagnare tale ID utente.
QMgrName: Il nome del gestore code di destinazione
Se non si specifica il gestore code di destinazione, l'esempio si connette al gestore code in ascolto sul nome della connessione TCP/IP fornito.

Nota: se si immette un punto interrogativo come unico parametro o se si immettono parametri non corretti, viene visualizzato un messaggio che spiega come utilizzare il programma.

Se si esegue l'esempio senza alcuna opzione della riga comandi, il contenuto della variabile di ambiente MQSERVER viene utilizzato per determinare le informazioni di connessione. (In questo esempio MQSERVER è impostata su SYSTEM.DEF.SVRCONN/TCP/machine.site.company.com.) Viene visualizzato il seguente output:

Sample AMQSCNXC start
Connecting to the default queue manager
with no client connection information specified.
Connection established to queue manager machine

Sample AMQSCNXC end

Se si esegue l'esempio e si fornisce un nome di connessione TCP/IP e un nome di canale di connessione server, ma nessun nome di gestore code di destinazione, come riportato di seguito:

amqscnxc -x machine.site.company.com -c SYSTEM.ADMIN.SVRCONN

viene utilizzato il nome gestore code predefinito e viene visualizzato un output simile al seguente:

Sample AMQSCNXC start
Connecting to the default queue manager
using the server connection channel SYSTEM.ADMIN.SVRCONN
on connection name machine.site.company.com.
Connection established to queue manager MACHINE

Sample AMQSCNXC end

Se si esegue l'esempio e si fornisce un nome connessione TCP/IP e un nome gestore code di destinazione, come segue:

amqscnxc -x machine.site.company.com MACHINE

viene visualizzato un output simile al seguente:

Sample AMQSCNXC start
Connecting to queue manager MACHINE
using the server connection channel SYSTEM.DEF.SVRCONN
on connection name machine.site.company.com.
Connection established to queue manager MACHINE

Sample AMQSCNXC end