Ejecución de los programas de ejemplo de colocación

[AIX, Linux, Windows]

Ejecución de los ejemplos amqsput y amqsputc

El ejemplo amqqsput es el programa que coloca mensajes utilizando enlaces locales y el ejemplo amqsputc es el programa que usa enlaces de cliente. Estos programas reciben los siguientes parámetros posicionales:
  1. El nombre de la cola de destino (obligatorio).
  2. El nombre del gestor de colas (opcional).

    Si no se especifica un gestor de colas, amqsput se conecta al gestor de colas predeterminado y amqsputc se conecta al gestor de colas identificado por la variable de entorno MQSERVER o el archivo de definición del canal del cliente.

  3. Opciones de apertura (opcional).
    Si no se especifican las opciones de apertura, el ejemplo utiliza el valor 8208, que es la combinación de estas dos opciones:
    • MQOO_OUTPUT
    • MQOO_FAIL_IF_QUIESCING
  4. Opciones de cierre (opcional).

    Si no se especifican opciones de cierre, el ejemplo utiliza el valor 0, que es MQCO_NONE.

  5. El nombre del gestor de colas de destino (opcional).

    Si no se especifica un gestor de colas de destino, el campo ObjectQMgrName del MQOD se deja en blanco.

  6. El nombre de la cola dinámica (optional).

    Si no se especifica un nombre de cola dinámica, el campo DynamicQName del MQOD se deja en blanco.

Estos programas también utilizan la variable de entorno MQSAMP_USER_ID que hay que establecer al ID de usuario que se va a usar en la autenticación de conexión. Cuando esta se define, el programa solicita la correspondiente contraseña.

Para ejecutar estos programas, especifique una de las opciones siguientes:
  • amqsput myqueue qmanagername
  • amqsputc myqueue qmanagername
donde myqueue es el nombre de la cola en la que se van a poner los mensajes, y qmanagername es el gestor de colas propietario de myqueue.
[AIX, Linux, Windows]

Ejecución del ejemplo amq0put

La versión en COBOL no recibe ningún parámetro. Se conecta con el gestor de colas predeterminado y, cuando se ejecuta, solicita el nombre de la cola de destino:
Please enter the name of the target queue

Recibe entrada de StdIn y añade cada línea de entrada a la cola de destino. Una línea en blanco indica que no hay más datos.

[IBM i]

Ejecución del ejemplo C AMQSPUT4 ( IBM i)

El programa C AMQSPUT4, disponible sólo para la plataforma IBM® i , crea mensajes leyendo datos de un miembro de un archivo fuente.

Hay que especificar el nombre del archivo como un parámetro al iniciar el programa. La estructura del archivo tiene que ser esta:
queue name
text of message 1
text of message 2
⋮
text of message n
blank line

En la biblioteca QMQMSAMP archivo AMQSDATA miembro PUT se facilita un ejemplo de entrada para los ejemplos de colocación.

Nota: Recuerde que los nombres de cola distinguen entre mayúsculas y minúsculas. Todas las colas creadas por programa de ejemplo de creación de archivo AMQSAMP4 tienen nombres en mayúscula.

El programa en C coloca los mensajes en la cola nombrada en la primera línea del archivo; se puede utilizar la cola proporcionada SYSTEM.SAMPLE.LOCAL. El programa coloca el texto de cada una de las siguientes líneas del archivo en mensajes de datagrama separados y se para cuando lee una línea en blanco al final del archivo.

Utilizando el archivo de datos de ejemplo, el comando es:
CALL PGM(QMQM/AMQSPUT4) PARM('QMQMSAMP/AMQSDATA(PUT)')
[IBM i]

Ejecución de la muestra AMQ0PUT4 COBOL ( IBM i)

El programa COBOL AMQ0PUT4, disponible sólo en la plataforma IBM i , crea mensajes aceptando datos del teclado.

Para iniciar el programa, invóquelo pasándole el nombre de la cola de destino como parámetro. El programa guarda la entrada del teclado en un búfer y crea un mensaje de datagrama por cada línea de texto. El programa se para cuando se especifica una línea en blanco en el teclado.