DEFINE SERVICE (crear una nueva definición de servicio) en Multiplatforms

Utilice el mandato MQSC DEFINE SERVICE para definir una nueva definición de servicio IBM® MQ y establecer sus parámetros.

Utilización de mandatos MQSC

Para obtener información sobre cómo utilizar los mandatos MQSC, consulte Administración de IBM MQ utilizando mandatos MQSC.

Diagrama de sintaxis
Notas de uso
Descripciones de parámetros para DEFINE SERVICE

Los valores que se muestran encima de la línea principal en el diagrama de sintaxis son los valores predeterminados que se proporcionan con IBM MQ, pero es posible que la instalación los haya cambiado. Para obtener una explicación sobre cómo utilizar estos diagramas, consulte Cómo leer diagramas de sintaxis.

DEFINE SERVICE

Definir atributos

Atributos de servicio

Notas de uso

Se utiliza un servicio para definir los programas de usuario que se van a iniciar y detener cuando se inicia y se detiene el gestor de colas. También puede iniciar y detener estos programas emitiendo los mandatos START SERVICE y STOP SERVICE .

Atención: Este mandato permite a un usuario ejecutar un mandato arbitrario con autorización mqm. Si se le otorgan derechos para utilizar este mandato, un usuario malintencionado o descuidado podría definir un servicio que dañe sus sistemas o datos, por ejemplo, suprimiendo archivos esenciales.

Para obtener más información sobre los servicios, consulte Servicios.

Descripciones de parámetros para DEFINE SERVICE

Las descripciones de los parámetros se aplican a los mandatos ALTER SERVICE y DEFINE SERVICE , con las excepciones siguientes:

El parámetro LIKE sólo se aplica al mandato DEFINE SERVICE .
El parámetro NOREPLACE y REPLACE sólo se aplica al mandato DEFINE SERVICE .

(nombre-servicio)

Nombre de la definición de servicio de IBM MQ (consulte Reglas de denominación de objetos de IBM MQ ).

El nombre no debe ser el mismo que cualquier otra definición de servicio definida actualmente en este gestor de colas (a menos que se especifique REPLACE ).

CONTROL(cadena )

Especifica cómo se debe iniciar y detener el servicio.

MANUAL: El servicio no se debe iniciar ni detener de forma automática. Debe controlarse mediante el uso de los mandatos START SERVICE y STOP SERVICE .
QMGR: El servicio que se define se debe iniciar y detener al mismo tiempo que se inicia y se detiene el gestor de colas.
STARTONLY: El servicio debe iniciarse al mismo tiempo que se inicia el gestor de colas, pero no tiene que detenerse cuando se detiene el gestor de colas.

DESCR(cadena )

Comentario en texto sin formato. Proporciona información descriptiva sobre el servicio cuando un operador emite el mandato DISPLAY SERVICE (consulte DISPLAY SERVICE (visualizar información de servicio) en Multiplatforms).

Debe contener sólo caracteres visualizables. La longitud máxima es de 64 caracteres. En una instalación DBCS, contiene caracteres DBCS (sujetos a una longitud máxima de 64 bytes).

Nota: Si se utilizan caracteres que no están en el identificador de juego de caracteres codificados (CCSID) para este gestor de colas, es posible que se conviertan incorrectamente si la información se envía a otro gestor de colas.

LIKE(nombre del servicio )

El nombre de un servicio cuyos parámetros se utilizan para modelar esta definición.

Este parámetro sólo se aplica al mandato DEFINE SERVICE .

Si este campo no se completa y no se completan los campos de parámetro relacionados con el mandato, los valores se toman de la definición predeterminada para los servicios de este gestor de colas. La no cumplimentación de este parámetro equivale a especificar:

LIKE(SYSTEM.DEFAULT.SERVICE)

Se proporciona un servicio predeterminado, pero se puede modificar mediante la instalación de los valores predeterminados necesarios. Consulte Reglas para la denominación de objetos IBM MQ.

REPLACE y NOREPLACE

Si la definición existente se va a sustituir por esta.

Este parámetro sólo se aplica al mandato DEFINE SERVICE .

REPLACE: La definición debe sustituir cualquier definición existente con el mismo nombre. Si no existe ninguna definición, se creará una.
NOREPLACE: La definición no debe reemplazar ninguna definición existente que tenga el mismo nombre.

SERVTYPE

Especifica la modalidad en la que se va a ejecutar el servicio:

COMMAND: Objeto de servicio del mandato. Se pueden ejecutar varias instancias de un objeto de servicio de mandato al mismo tiempo. No puede supervisar el estado de los objetos de servicio de mandatos.
SERVER: Objeto de servicio del servidor. Sólo se puede ejecutar una instancia de un objeto de servicio de servidor al mismo tiempo. El estado de los objetos de servicio de servidor se puede supervisar utilizando el mandato DISPLAY SVSTATUS .

STARTARG(cadena )

Especifica los argumentos que deben pasarse al programa de usuario durante el inicio del gestor de colas.

STARTCMD(cadena )

Especifica el nombre del programa que se va a ejecutar. Debe especificar un nombre de vía de acceso completo para el programa ejecutable.

STDERR(cadena )

Especifica la vía de acceso a un archivo al que se redirige el error estándar (stderr) del programa de servicio. Si el archivo no existe cuando se inicia el programa de servicio, se crea el archivo. Si este valor está en blanco, se descartan los datos grabados en stderr por el programa de servicio.

STDOUT(cadena )

Especifica la vía de acceso a un archivo al que se redirige la salida estándar (stdout) del programa de servicio. Si el archivo no existe cuando se inicia el programa de servicio, se crea el archivo. Si este valor está en blanco, se descartan los datos grabados en stdout por el programa de servicio.

STOPARG(cadena )

Especifica los argumentos que deben pasarse al programa de detención cuando se le indique que detenga el servicio.

STOPCMD(cadena )

Especifica el nombre del programa ejecutable que se debe ejecutar cuando se solicita la detención del servicio. Debe especificar un nombre de vía de acceso completo para el programa ejecutable.

Las inserciones sustituibles se pueden utilizar para cualquiera de las series STARTCMD, STARTARG, STOPCMD, STOPARG, STDOUT o STDERR , para obtener más información, consulte Inserciones sustituibles en definiciones de servicio.