Esecuzione dei programmi di esempio Put

Esecuzione degli esempi amqsput e amqsputc

Ognuno di questi programmi prende i parametri posizionali seguenti:
  1. Il nome della coda di destinazione (obbligatorio)
  2. Il nome del gestore code (facoltativo)

    Se non viene specificato un gestore code, amqsput si connette al gestore code predefinito e amqsputc si connette al gestore code identificato da una variabile di ambiente o dal file di definizione del canale del client.

  3. Le opzioni di apertura (facoltativo)
    Se non vengono specificate le opzioni di apertura, l'esempio utilizza un valore di 8208 che è la combinazione di queste due opzioni:
    • OUTPUT MQOO
    • MQOO_FAIL_IF_QUIESCING
  4. Le opzioni di chiusura (facoltativo)

    Se non vengono specificate le opzioni di chiusura, l'esempio utilizza un valore 0 che è MQCO_NONE.

  5. Il nome del gestore code di destinazione (facoltativo)

    Se non viene specificato un gestore code di destinazione, il campo ObjectQMgrName nell'MQOD verrà lasciato vuoto.

  6. Il nome della coda dinamica (facoltativo)

    Se non viene specificato un nome coda dinamica, il campo DynamicQName in MQOD verrà lasciato vuoto.

Questi programmi utilizzano anche una variabile di ambiente denominata MQSAMP_USER_ID che deve essere impostata sull'ID utente da utilizzare per l'autenticazione della connessione. Quando questa opzione è impostata, il programma richiederà una password che accompagni tale ID utente.

Per eseguire questi programmi, immettere uno dei seguenti:
  • amqsput myqueue qmanagername
  • amqsputc myqueue qmanagername
dove myqueue è il nome della coda in cui verranno inseriti i messaggi e qmanagername è il gestore code proprietario di myqueue.

Esecuzione dell'esempio amq0put

La versione COBOL non ha alcun parametro. Si connette al gestore code predefinito e quando viene eseguito viene richiesto:
Please enter the name of the target queue

Prende l'input da StdIn e aggiunge ogni riga di input alla coda di destinazione. Una riga vuota indica che non ci sono più dati.

[IBMi]

Esecuzione dell'esempio AMQSPUT4 C ( IBM i)

Il programma C AMQSPUT4, disponibile solo per la piattaforma IBM® i , crea i messaggi leggendo i dati da un membro di un file origine.

È necessario specificare il nome del file come parametro quando si avvia il programma. La struttura del file deve essere:
queue name
text of message 1
text of message 2
⋮
text of message n
blank line

Un esempio di input per gli esempi di inserimento viene fornito nella libreria PUT del membro AMQSDATA del file QMQMSAMP.

Nota: tenere presente che i nomi delle code sono sensibili al maiuscolo / minuscolo. Tutte le code create dal programma di creazione del file di esempio AMQSAMP4 hanno nomi creati in caratteri maiuscoli.

Il programma C inserisce i messaggi nella coda denominata nella prima linea del file; è possibile utilizzare la coda fornita SYSTEM.SAMPLE.LOCAL. Il programma inserisce il testo di ciascuna delle seguenti righe del file in messaggi datagramma separati e si arresta quando legge una riga vuota alla fine del file.

Utilizzando il file di dati di esempio il comando è:
CALL PGM(QMQM/AMQSPUT4) PARM('QMQMSAMP/AMQSDATA(PUT)')
[IBMi]

Esecuzione dell'esempio COBOL AMQ0PUT4 ( IBM i)

Il programma COBOL AMQ0PUT4, disponibile solo sulla piattaforma IBM i , crea messaggi accettando i dati dalla tastiera.

Per avviare il programma, richiamare il programma e fornire il nome della coda di destinazione come parametro del programma. Il programma accetta input dalla tastiera in un buffer e crea un messaggio datagramma per ogni riga di testo. Il programma si arresta quando si immette una riga vuota sulla tastiera.