Utilización del nombre de aplicación en lenguajes de programación admitidos

Utilice esta información para saber cómo se selecciona el nombre de aplicación en los distintos idiomas a los que IBM® MQ da soporte.

Caracteres recomendados para el nombre de aplicación

Los nombres de aplicación deben estar en el juego de caracteres proporcionado por el atributo CodedCharSetId del campo del gestor de colas. Para obtener más información sobre este atributo, consulte Atributos para el gestor de colas.

Sin embargo, si la aplicación se ejecuta como un IBM MQ MQI client, el nombre de la aplicación debe estar en el juego de caracteres y la codificación del cliente.

Para garantizar una transición fluida del nombre de aplicación entre gestores de colas y permitir la supervisión de recursos de aplicación a través de los temas de supervisión de recursos, los nombres de aplicación sólo deben contener caracteres imprimibles de un solo byte.

Notas:

También debería evitar el uso de la barra inclinada y los caracteres ampersand en los nombres de aplicación.
Debe evitar el uso del carácter ampersand en los nombres de aplicación. No se generarán las métricas STATAPP del tema del sistema para los nombres de aplicación que contengan un ampersand.

Esto limita el nombre a:

Caracteres alfanuméricos: A-Z, a-zy 0-9
Nota: No debe utilizar los caracteres a-z en minúsculas en los nombres de aplicación en sistemas que utilizan EBCDIC Katakana.
El carácter de espacio
Caracteres imprimibles que son invariables en EBCDIC: + < = > % * ' ( ) , _ - . : ; ?
El carácter/. Al suscribirse al rastreo de actividad o a las métricas de tema del sistema STATAPP para una aplicación cuyo nombre contiene una barra inclinada, debe sustituir los caracteres de barra inclinada por un carácter ampersand. Por ejemplo, para recibir métricas STATAPP para una aplicación denominada "DEPT1/APPS/STOCKQUOTE" debe suscribirse a la serie de tema "$SYS/MQ/INFO/QMGR/QMBASIC/Monitor/STATAPP/DEPT1&APPS&STOCKQUOTE/INSTANCE". Las aplicaciones de ejemplo amqsact y amqsrua convertirán automáticamente los caracteres de barra inclinada a ampersand al crear sus suscripciones.

Cómo se establecen los caracteres

En la tabla siguiente se resumen los medios por los que se elige el nombre de aplicación en los distintos idiomas a los que IBM MQ da soporte. El medio por el que se elige el nombre está en orden de prioridad, el más alto en primer lugar.

	Enlaces de C y cliente	Enlaces y cliente de Java	Enlaces y cliente de JMS	Cliente .NET gestionado	Enlaces .NET no gestionados y cliente	Cliente XMS gestionado	Enlaces y cliente .XMS no gestionados
Alteración temporal de la propiedad de conexión		Java alteración temporal de propiedad de conexión		.Alteración temporal de propiedad de conexión NET	.Alteración temporal de propiedad de conexión NET
Propiedad alterada temporalmente		Java propiedad alterada temporalmente		.Propiedad alterada temporalmente NET	.Propiedad alterada temporalmente NET
MQEnvironment		Java Entorno MQEntorno		entorno MQ de.NET	entorno MQ de.NET
Propiedad de fábrica de conexiones			Propiedad de fábrica de conexiones			Propiedad de fábrica de conexiones	Propiedad de fábrica de conexiones
JMSAdmin			JMSAdmin			JMSAdmin	JMSAdmin
MQCNO	Opciones de conexión
Variable de entorno	variables de entorno				variables de entorno		variables de entorno
mqclient.ini (Aplicable a las conexiones de cliente solamente)	Conexiones del cliente				Conexiones del cliente		Conexiones del cliente
Java nombre de clase		Java nombre de clase	Java nombre de clase
Nombre predeterminado	Nombre predeterminado			.NET Nombre predeterminado	.NET Nombre predeterminado	.NET Nombre predeterminado	.NET Nombre predeterminado

Nota: La columna de cliente y enlaces C se aplica también a los siguientes lenguajes de programación:

COBOL
Ensamblador
Visual Basic
RPG

Conexiones de lenguaje de programación

Las aplicaciones que se resuelven en las bibliotecas de IBM MQ en C, y otros lenguajes de programación, pueden proporcionar el nombre de aplicación de las formas siguientes.

Los métodos de conexión se enumeran en orden de prioridad, empezando por el más alto.

Opciones de conexión

MQCNO
Nota: Cuando se conecta a un IBM MQ for z/OS® gestor de colas, sólo puede establecer el nombre de la aplicación utilizando conexiones en modo cliente, o utilizando aplicaciones IBM MQ classes for JMS o IBM MQ classes for Java.
MQCNO en IBM i

Variables de entorno

Si todavía no ha seleccionado un nombre de aplicación, puede utilizar la variable de entorno MQAPPLNAME para identificar la conexión con el gestor de colas. Por ejemplo:

export MQAPPLNAME=ExampleApplName

Tenga en cuenta que solo se utilizan los primeros 28 caracteres y estos caracteres no deben ser todos espacios en blanco o nulos.

Nota: El atributo se aplica únicamente a los lenguajes de programación soportados, a las conexiones .NETno gestionadas y a las conexiones XMS no gestionadas.

Archivo de configuración del cliente

Si todavía no ha seleccionado un nombre de aplicación y la conexión es una conexión de cliente, puede especificar la información siguiente en el archivo de configuración de cliente (por ejemplo, mqclient.ini) para identificar la conexión con el gestor de colas.


Connection:
	ApplName=ExampleApplName

Notas:

Solo se utilizan los primeros 28 caracteres y estos caracteres no deben ser todos espacios en blanco o nulos.
El atributo sólo se aplica a las conexiones de cliente en los lenguajes de programación soportados, las conexiones .NETno gestionadas y las conexiones XMS no gestionadas.

Para obtener más información, consulte el archivo de configuración de IBM MQ MQI client , mqclient.ini.

Nombre predeterminado

Si todavía no ha elegido el nombre de aplicación, se sigue utilizando el nombre predeterminado, que contiene tanto la vía de acceso como el nombre del ejecutable como se muestra en el sistema operativo. Para obtener más información, consulte PutApplName.

Aplicaciones .NET gestionadas

Las aplicaciones .NET gestionadas pueden proporcionar el nombre de aplicación de las formas siguientes.

Los métodos de conexión se enumeran en orden de prioridad, empezando por el más alto.

Alteración temporal de la propiedad de conexión

Puede proporcionar un archivo de alteración temporal de detalles de conexión a las aplicaciones de la forma siguiente:


<appSettings>
     <add key="overrideConnectionDetails" value="true" />
     <add key="overrideConnectionDetailsFile" value="<location>" />
</appSettings>

El archivo especificado por overrideConnectionDetailsFile contiene una lista de propiedades precedidas por mqj. Las aplicaciones deben definir la propiedad mqj.APPNAME donde el valor de la propiedad mqj.APPNAME especifica el nombre utilizado para identificar la conexión al gestor de colas.

Solo se utilizan los primeros 28 caracteres del nombre. Por ejemplo:

mqj.APPNAME=ExampleApplName

Propiedad alterada temporalmente


Hashtable properties = new Hashtable();
properties.Add( MQC.APPNAME_PROPERTY, "ExampleApplName" );
MQQueueManager qMgr = new MQQueueManager("qmgrname", properties);

Para obtener más información, consulte Operaciones gestionadas y no gestionadas en .NET.

MQEnvironment

La propiedad AppName se añade a la clase MQEnvironmenty sólo se utilizan los primeros 28 caracteres. Por ejemplo:

MQEnvironment.AppName = "ExampleApplName";

Nombre predeterminado

Si no ha proporcionado el nombre de la aplicación por alguno de los medios descritos en el texto anterior, el nombre de la aplicación se establece automáticamente como el nombre ejecutable (y como gran parte de la vía de acceso que se ajustará).

XMS aplicaciones

Los métodos de conexión se enumeran en orden de prioridad, empezando por el más alto.

Propiedad de fábrica de conexiones

Las aplicaciones XMS pueden proporcionar el nombre de aplicación en la fábrica de conexiones utilizando la propiedad XMSC.WMQ_APPLICATIONNAME ("XMSC_WMQ_APPNAME") de forma similar a JMS. Puede especificar un máximo de 28 caracteres.

Para obtener más información, consulte XMS .NET creando objetos administrados y Propiedades de un mensaje XMS.

JMSAdmin

En las herramientas administrativas, la propiedad se conoce como "APPLICATIONNAME" o "APPNAME" para abreviar.

Aplicaciones de enlaces Java y JMS

Los métodos de conexión se enumeran en orden de prioridad, empezando por el más alto.

[AIX, Linux, Windows] Java y JMS las aplicaciones cliente ya pueden especificar un nombre de aplicación, y esto se ha extendido en IBM MQ for Multiplatforms a las aplicaciones bindings, haciendo uso del campo MQCNO ApplName.

Alteración temporal de la propiedad de conexión

La propiedad Application name se ha añadido a la lista de propiedades de conexión que puede alterar temporalmente. Para obtener más información, consulte Utilización de la alteración temporal de la propiedad de conexión IBM MQ.

Atención: Las propiedades de conexión y la forma de utilizar el archivo de alteración temporal de propiedades de conexión son las mismas para IBM MQ classes for Java y .NET.

Propiedad alterada temporalmente

Se ha definido una constante MQC.APPNAME_PROPERTY con el valor APPNAME. Ahora puede pasar esta propiedad al constructor MQQueueManager, utilizando los primeros 28 caracteres solo del nombre. Para obtener más información, consulte Utilización de la alteración temporal de la propiedad de conexión en IBM MQ classes for Java.

MQEnvironment

La propiedad AppName se añade a la clase MQEnvironment y sólo se utilizan los primeros 28 caracteres.

Para obtener más información, consulte Configuración del entorno IBM MQ para las clases IBM MQ para Java.

Java nombre de clase

Si no ha proporcionado el nombre de aplicación por alguno de los medios del texto anterior, el nombre de aplicación se deriva del nombre de clase principal.

Para obtener más información, consulte Configuración del entorno IBM MQ para las clases IBM MQ para Java.

Atención: En IBM i no es posible consultar el nombre de la clase principal, por lo que en su lugar se utiliza IBM MQ client para Java.