Aplicaciones de ejemplo para .NET

Para ejecutar sus propias aplicaciones .NET , utilice las instrucciones para los programas de verificación, sustituyendo el nombre de aplicación en lugar de las aplicaciones de ejemplo.

Se suministran las aplicaciones de ejemplo siguientes:

Una aplicación de colocación de mensajes
Una aplicación de obtención de mensajes
Una aplicación 'hello world'
Una aplicación de publicación/suscripción
Una aplicación que utiliza propiedades de mensajes

Todas estas aplicaciones se proporcionan en el lenguaje C# y algunas también se proporcionan en C++ y Visual Basic. Puede escribir aplicaciones en cualquier idioma soportado por .NET.

Programa SPUT de "Transferencia de mensaje" (nmqsput.cs, mmqsput.cpp, vmqsput.vb)

Este programa muestra cómo colocar un mensaje en una cola concreta. El programa tiene tres parámetros:

El nombre de una cola (necesario), por ejemplo, SYSTEM.DEFAULT.LOCAL.QUEUE
El nombre de un gestor de colas (opcional)
La definición de un canal (opcional), por ejemplo, SYSTEM.DEF.SVRCONN/TCP/hostname(1414)

Si no se especifica ningún gestor de colas, se utiliza el gestor de colas local predeterminado. Si se define un canal, éste tiene el mismo formato que la variable de entorno MQSERVER.

Programa SGET de "Obtención de mensaje" (nmqsget.cs, mmqsget.cpp, vmqsget.vb)

Este programa muestra cómo obtener un mensaje en una cola concreta. El programa tiene tres parámetros:

El nombre de una cola (necesario), por ejemplo, SYSTEM.DEFAULT.LOCAL.QUEUE
El nombre de un gestor de colas (opcional)
La definición de un canal (opcional), por ejemplo, SYSTEM.DEF.SVRCONN/TCP/hostname(1414)

Si no se especifica ningún gestor de colas, se utiliza el gestor de colas local predeterminado. Si se define un canal, éste tiene el mismo formato que la variable de entorno MQSERVER.

Programa "Hello World" (nmqwrld.cs, mmqwrld.cpp, vmqwrld.vb)

Este programa muestra cómo colocar y obtener un mensaje de una cola concreta. El programa tiene tres parámetros:

El nombre de una cola (opcional), por ejemplo, SYSTEM.DEFAULT.LOCAL.QUEUE o SYSTEM.DEFAULT.MODEL.QUEUE
El nombre de un gestor de colas (opcional)
Una definición de canal (opcional), por ejemplo, SYSTEM.DEF.SVRCONN/TCP/hostname(1414)

Si no se proporciona un nombre de cola, de forma predeterminada el nombre es SYSTEM.DEFAULT.LOCAL.QUEUE. Si no se especifica ningún gestor de colas, se utiliza el gestor de colas local predeterminado.

Programa de "Publicación/suscripción" (MQPubSubSample.cs)

Este programa muestra cómo utilizar la publicación/suscripción de IBM® MQ . Solo se proporciona en C#. El programa tiene dos parámetros:

El nombre de un gestor de colas (opcional)
Una definición de canal (opcional)

Programa "Propiedades de mensaje" (MQMessagePropertiesSample.cs)

Este programa muestra cómo utilizar las propiedades del mensaje. Solo se proporciona en C#. El programa tiene dos parámetros:

El nombre de un gestor de colas (opcional)
Una definición de canal (opcional)

Puede verificar la instalación compilando y ejecutando estas aplicaciones.

Ubicaciones de instalación

Las aplicaciones de ejemplo se instalan en las ubicaciones siguientes, según el lenguaje en el que se escriben. MQ_INSTALLATION_PATH representa el directorio de alto nivel en el que está instalado IBM MQ .

C#

MQ_INSTALLATION_PATH\Tools\dotnet\samples\cs\nmqswrld.cs

MQ_INSTALLATION_PATH\Tools\dotnet\samples\cs\nmqsput.cs

MQ_INSTALLATION_PATH\Tools\dotnet\samples\cs\nmqsget.cs

MQ_INSTALLATION_PATH' \Tools\dotnet\samples\cs\MQPubSubSample.cs

MQ_INSTALLATION_PATH' \Tools\dotnet\samples\cs\MQMessagePropertiesSample.cs

Managed C++

MQ_INSTALLATION_PATH\Tools\dotnet\samples\mcp\mmqswrld.cpp

MQ_INSTALLATION_PATH\Tools\dotnet\samples\mcp\mmqsput.cpp

MQ_INSTALLATION_PATH\Tools\dotnet\samples\mcp\mmqsget.cpp

Visual Basic

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\vmqswrld.vb

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\vmqsput.vb

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\vmqsget.vb

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\xmqswrld.vb

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\xmqsput.vb

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\xmqsget.vb

Creación de las aplicaciones de ejemplo

Para crear las aplicaciones de ejemplo, se proporciona un archivo de proceso por lotes para cada idioma.

C#

MQ_INSTALLATION_PATH\Tools\dotnet\samples\cs\bldcssamp.bat

El archivo bldcssamp.bat contiene una línea para cada ejemplo, que es todo lo necesario para compilar este programa de ejemplo:

csc /t:exe /r:System.dll /r:amqmdnet.dll /lib: MQ_INSTALLATION_PATH\bin
/out:nmqwrld.exe nmqwrld.cs

Managed C++

MQ_INSTALLATION_PATH\Tools\dotnet\samples\mcp\bldmcpsamp.bat

El archivo bldmcpsamp.bat contiene una línea para cada ejemplo, que es todo lo necesario para compilar este programa de ejemplo:

cl /clr:oldsyntax MQ_INSTALLATION_PATH\bin mmqwrld.cpp

Si desea compilar estas aplicaciones en Microsoft Visual Studio 2003/.NET SDKv1.1, sustituya el mandato de compilación:

cl /clr:oldsyntax MQ_INSTALLATION_PATH\bin mmqwrld.cpp

por

cl /clr MQ_INSTALLATION_PATH\bin mmqwrld.cpp

Visual Basic

MQ_INSTALLATION_PATH\Tools\dotnet\samples\vb\bldvbsamp.bat

El archivo bldvbsamp.bat contiene una línea para cada ejemplo, que es todo lo necesario para compilar este programa de ejemplo:

vbc /r:System.dll /r: MQ_INSTALLATION_PATH\bin\amqmdnet.dll /out:vmqwrld.exe vmqwrld.vb

Ejemplos para utilizar IBM MQ con Microsoft .NET Core

A partir de IBM MQ 9.2.0, IBM MQ da soporte a .NET Core para aplicaciones IBM MQ .NET en entornos Windows . IBM MQ classes for .NET Standard, incluidos los ejemplos, se instalan de forma predeterminada como parte de la instalación estándar de IBM MQ .

Las aplicaciones de ejemplo para IBM MQ .NET se instalan en &MQINSTALL_PATH&/samp/dotnet/samples/cs/core/base. También se proporciona un script, que se puede utilizar para compilar los ejemplos.

Puede crear los ejemplos utilizando los archivos build.bat proporcionados. Hay un build.bat para cada ejemplo en la ubicación siguiente en Windows:

MQ\tools\dotnet\samples\cs\core\base\SimpleGet
MQ\tools\dotnet\samples\cs\core\base\SimplePut

[Linux] A partir de IBM MQ 9.2.0, IBM MQ también da soporte a Core para aplicaciones en entornos Linux® .

Para obtener más información sobre cómo utilizar IBM MQ con Microsoft .NET Core, consulte Instalación de clases de IBM MQ para .NET Standard.