Test per l'accodamento distribuito

È possibile utilizzare il programma di verifica dell'installazione fornito, CSQ4IVPX, per verificare che l'accodamento distribuito sia operativo.

Panoramica del lavoro CSQ4IVPX

CSQ4IVPX è un lavoro batch che avvia l'iniziatore di canali ed emette il comando IBM® MQ DISPLAY CHINIT. Ciò verifica che tutti gli aspetti principali dell'accodamento distribuito siano operativi, evitando la necessità di impostare le definizioni di canale e di rete.

Preparazione all'esecuzione di CSQ4IVPX

Prima di eseguire CSQ4IVPX:

Il JCL di esempio, CSQ4IVPX, richiesto per eseguire il programma di verifica dell'installazione si trova nella libreria thlqual.SCSQPROC.
Personalizzare il JCL CSQ4IVPX con il qualificatore di alto livello per le librerie di IBM MQ , la lingua nazionale che si desidera utilizzare, il nome del gestore code di quattro caratteri e la destinazione per l'output del lavoro.

Aggiornare RACF® per consentire a CSQ4IVPX di accedere alle relative risorse se la sicurezza IBM MQ è attiva. Per eseguire CSQ4IVPX quando è abilitata la sicurezza 'IBM MQ, è necessario un ID utente 'RACF con l'autorità di accedere agli oggetti. Per i dettagli sulla definizione delle risorse a 'RACF, vedere Impostazione della sicurezza su 'z/OS® . L'ID utente che esegue IVP deve disporre della seguente autorità di accesso:

Autorizzazione	Profilo	Classe
CONTROL	ssid.START.CHINIT e ssid.STOP.CHINIT	MQCMDS
AGGIORNA	ssid.SYSTEM.COMMAND.INPUT	MQQUEUE
AGGIORNA	ssid.SYSTEM.CSQUTIL.*	MQQUEUE
LETTURA	ssid.BATCH	MQCONN
LETTURA	ssid.DISPLAY.CHINIT	MQCMDS

Questi requisiti presuppongono che il profilo di sicurezza della connessione ssid.CHIN sia stato definito (come mostrato nella sezione Profili di sicurezza della connessione per l'iniziatore di canali ) e che tutta la sicurezza IBM MQ sia attiva. I comandi RACF per eseguire questa operazione sono riportati nella Figura 1. Questo esempio presuppone che:

Il nome del gestore code è CSQ1
L'ID utente della persona che esegue l'esempio CSQ4IVPX è TS101
Lo spazio di indirizzo dell'iniziatore di canali è in esecuzione con ID utente CSQ1MSTR

Aggiornare RACF per consentire allo spazio di indirizzo dell'iniziatore di canali la seguente autorità di accesso:

Autorizzazione	Profilo	Classe
LETTURA	ssid.CHIN	MQCONN
AGGIORNA	ssid.SYSTEM.COMMAND.INPUT	MQQUEUE
AGGIORNA	ssid.SYSTEM.CHANNEL.INITQ	MQQUEUE
AGGIORNA	ssid.SYSTEM.CHANNEL.SYNCQ	MQQUEUE
MODIFICA	ssid.SYSTEM.CLUSTER.COMMAND.QUEUE	MQQUEUE
AGGIORNA	ssid.SYSTEM.CLUSTER.TRANSMIT.QUEUE	MQQUEUE
MODIFICA	ssid.SYSTEM.CLUSTER.REPOSITORY.QUEUE	MQQUEUE
CONTROL	ssid.CONTEXT.**	MQADMIN

I comandi RACF per eseguire questa operazione sono riportati anche in Figura 1.

Figura 1. Comandi RACF per CSQ4IVPX

RDEFINE MQCMDS CSQ1.DISPLAY.DQM
PERMIT CSQ1.DISPLAY.DQM CLASS(MQCMDS) ID(TS101) ACCESS(READ)

RDEFINE MQCMDS CSQ1.START.CHINIT
PERMIT CSQ1.START.CHINIT CLASS(MQCMDS) ID(TS101) ACCESS(CONTROL)

RDEFINE MQCMDS CSQ1.STOP.CHINIT
PERMIT CSQ1.STOP.CHINIT CLASS(MQCMDS) ID(TS101) ACCESS(CONTROL)

RDEFINE MQQUEUE CSQ1.SYSTEM.COMMAND.INPUT
PERMIT CSQ1.SYSTEM.COMMAND.INPUT CLASS(MQQUEUE) ID(TS101,CSQ1MSTR) ACCESS(UPDATE)

RDEFINE MQQUEUE CSQ1.SYSTEM.CSQUTIL.*
PERMIT CSQ1.SYSTEM.CSQUTIL.* CLASS(MQQUEUE) ID(TS101) ACCESS(UPDATE)

RDEFINE MQCONN CSQ1.BATCH
PERMIT CSQ1.BATCH CLASS(MQCONN) ID(TS101) ACCESS(READ)

RDEFINE MQCONN CSQ1.CHIN
PERMIT CSQ1.CHIN CLASS(MQCONN) ID(CSQ1MSTR) ACCESS(READ)

RDEFINE MQQUEUE CSQ1.SYSTEM.CHANNEL.SYNCQ
PERMIT CSQ1.SYSTEM.CHANNEL.SYNCQ CLASS(MQQUEUE) ID(CSQ1MSTR) ACCESS(UPDATE)

RDEFINE MQQUEUE CSQ1.SYSTEM.CLUSTER.COMMAND.QUEUE
PERMIT CSQ1.SYSTEM.CLUSTER.COMMAND.QUEUE CLASS(MQQUEUE) ID(CSQ1MSTR) ACCESS(ALTER)

RDEFINE MQQUEUE CSQ1.SYSTEM.CLUSTER.TRANSMIT.QUEUE
PERMIT CSQ1.SYSTEM.CLUSTER.TRANSMIT.QUEUE CLASS(MQQUEUE) ID(CSQ1MSTR) ACCESS(UPDATE)

RDEFINE MQQUEUE CSQ1.SYSTEM.CLUSTER.REPOSITORY.QUEUE
PERMIT CSQ1.SYSTEM.CLUSTER.REPOSITORY.QUEUE CLASS(MQQUEUE) ID(CSQ1MSTR) ACCESS(ALTER)

RDEFINE MQQUEUE CSQ1.SYSTEM.CHANNEL.INITQ
PERMIT CSQ1.SYSTEM.CHANNEL.INITQ CLASS(MQQUEUE) ID(CSQ1MSTR) ACCESS(UPDATE)

RDEFINE MQADMIN CSQ1.CONTEXT.**
PERMIT CSQ1.CONTEXT.** CLASS(MQADMIN) ID(CSQ1MSTR) ACCESS(CONTROL)

Esecuzione di CSQ4IVPX

Una volta completata questa procedura, avviare il gestore code.

IVP viene eseguito come lavoro batch. Personalizzare la scheda di lavoro in modo da soddisfare i requisiti di inoltro dell'installazione.

Verifica dei risultati di CSQ4IVPX

CSQ4IVPX esegue il programma di utilità CSQUTIL IBM MQ per immettere tre comandi MQSC. Il dataset di output SYSPRINT dovrebbe essere simile alla Figura 2, anche se i dettagli potrebbero differire a seconda degli attributi dei gestori code.

Dovrebbero essere visualizzati i comandi (1) ciascuno seguito da diversi messaggi.
L'ultimo messaggio da ciascun comando deve essere CSQ9022I ... COMPLETAMENTO NORMALE (2).
L'intero lavoro deve essere completato con codice di ritorno zero (3).

Figura 2. Output di esempio da CSQ4IVPX

CSQU000I CSQUTIL IBM MQ for z/OS - V6
CSQU001I CSQUTIL Queue Manager Utility - 2005-05-09 09:06:48
COMMAND
CSQU127I CSQUTIL Executing COMMAND using input from CSQUCMD data set
CSQU120I CSQUTIL Connecting to queue manager CSQ1
CSQU121I CSQUTIL Connected to queue manager CSQ1
CSQU055I CSQUTIL Target queue manager is CSQ1
START CHINIT
(1)
CSQN205I  COUNT=    2, RETURN=00000000, REASON=00000004
CSQM138I +CSQ1 CSQMSCHI CHANNEL INITIATOR STARTING
CSQN205I  COUNT=    2, RETURN=00000000, REASON=00000000
CSQ9022I +CSQ1 CSQXCRPS ' START CHINIT' NORMAL COMPLETION
(2)
DISPLAY CHINIT
(1)
CSQN205I  COUNT=    2, RETURN=00000000, REASON=00000004
CSQM137I +CSQ1 CSQMDDQM DISPLAY CHINIT COMMAND ACCEPTED
CSQN205I  COUNT=   12, RETURN=00000000, REASON=00000000
CSQX830I +CSQ1 CSQXRDQM Channel initiator active
CSQX002I +CSQ1 CSQXRDQM Queue sharing group is QSG1
CSQX831I +CSQ1 CSQXRDQM 8 adapter subtasks started, 8 requested
CSQX832I +CSQ1 CSQXRDQM 5 dispatchers started, 5 requested
CSQX833I +CSQ1 CSQXRDQM 0 SSL server subtasks started, 0 requested
CSQX840I +CSQ1 CSQXRDQM 0 channel connections current, maximum 200
CSQX841I +CSQ1 CSQXRDQM 0 channel connections active, maximum 200,
including 0 paused
CSQX842I +CSQ1 CSQXRDQM 0 channel connections starting,
0 stopped, 0 retrying
CSQX836I +CSQ1 Maximum channels - TCP/IP 200, LU 6.2 200
CSQX845I +CSQ1 CSQXRDQM TCP/IP system name is TCPIP
CSQX848I +CSQ1 CSQXRDQM TCP/IP listener INDISP=QMGR not started
CSQX848I +CSQ1 CSQXRDQM TCP/IP listener INDISP=GROUP not started
CSQX849I +CSQ1 CSQXRDQM LU 6.2 listener INDISP=QMGR not started
CSQX849I +CSQ1 CSQXRDQM LU 6.2 listener INDISP=GROUP not started
CSQ9022I +CSQ1 CSQXCRPS ' DISPLAY CHINIT' NORMAL COMPLETION
(2)
STOP CHINIT
(1)
CSQN205I  COUNT=    2, RETURN=00000000, REASON=00000004
CSQM137I +CSQ1 CSQMTCHI STOP CHINIT COMMAND ACCEPTED
CSQN205I  COUNT=    2, RETURN=00000000, REASON=00000000
CSQ9022I +CSQ1 CSQXCRPS ' STOP CHINIT' NORMAL COMPLETION
(2)
CSQU057I CSQUCMDS 3 commands read
CSQU058I CSQUCMDS 3 commands issued and responses received, 0 failed
CSQU143I CSQUTIL 1 COMMAND statements attempted
CSQU144I CSQUTIL 1 COMMAND statements executed successfully
CSQU148I CSQUTIL Utility completed, return code=0
(3)