Creación de un archivo de tarea de mandato

Este tema describe cómo crear archivos de tarea de mandato (archivos CMDTask) que se utilizan para integrar software de gestión externo y otros programas de terceros con IBM Director.

Los archivos CMDTask deben residir en el directorio dir_instalación_director\classes\extensions y su extensión debe ser ".CMDExt". La extensión .CMDExt no distingue entre mayúsculas y minúsculas, pero el prefijo del nombre de un archivo .CMDExt debe estar escrito en mayúsculas todo él (por ejemplo, TELNET.CMDExt).

Cuando inicia la Consola de IBM Director, se procesan todos los archivos del directorio dir_instalación_director\classes\extensions cuya extensión sea .CMDExt, y el título de cada tarea, que está especificado por el parámetro Title dentro del archivo, aparece como subtarea de la tarea Inicio de aplicación externa en el panel Tareas.

Por ejemplo, si tiene un archivo llamado TELNET.CMDExt (donde Title=mandato telnet) que reside en el directorio dir_instalación_director\classes\extensions del Servidor de IBM Director, el título de tarea mandato telnet se visualiza como subtarea de la tarea Inicio de aplicación externa.

En una plataforma Windows, puede también crear un grupo de tareas afines (una tarea padre con un árbol de tareas hijas). Por ejemplo, podría crear el grupo siguiente:
  1. Una tarea padre con un nombre de archivo FILESYSTEM.CMDExt y Title=Mandatos de sistema archivos
  2. Una tarea hija con un nombre de archivo FILESYSTEM_1.CMDExt (el número "1" es necesario) y a) Title=mandato Volume y b) ParentTaskFilename=FILESYSTEM
  3. Una tarea hija con un nombre de archivo FILESYSTEM_2.CMDExt (el número "2" es necesario) y a) Title=mandato Dir y b) ParentTaskFilename=FILESYSTEM
  4. Una tarea hija con un nombre de archivo FILESYSTEM_3.CMDExt (el número "3" es necesario) y a) Title=mandato DiskCopy y b) ParentTaskFilename=FILESYSTEM

Tal como se indica en el ejemplo, debe añadir _n a cada nombre de archivo de tarea hija e incluir los parámetros Title y ParentTaskFilename de cada archivo. Observe que cuando inicia una tarea padre, las tareas hijas situadas debajo de la tarea padre no se ejecutan. La relación padre-hija solamente se aplica a la visualización, no a la ejecución.

Los títulos de tarea están clasificados dentro de un grupo. Por ejemplo, las tareas especificadas en los ejemplos se visualizarían en el orden siguiente:

Inicio de aplicación externa
    Mandatos de sistema de archivos
        mandato Dir
        mandato DiskCopy
        mandato Volume
    mandato telnet

Para renovar la lista de subtareas, pulse con el botón derecho del ratón en la tarea Inicio de aplicación externa y luego pulse Renovar.

Para restringir el uso de una subtarea a usuarios determinados, utilice las opciones del menú Acceso a tareas dentro de Administración del usuario.

Parámetros del archivo .CMDExt:

Nota: Un asterisco (*) denota parámetros que es muy recomendable definir. Los parámetros y valores distinguen entre mayúsculas y minúsculas.
Nombre del parámetro Descripción Información sobre el valor
Título* Título de la tarea o clave de NLS para el título que se mostrará como subtarea de Inicio de aplicación externa Es recomendable que defina este parámetro. Si no define este parámetro, se utiliza el nombre de archivo base del archivo .CMDExt.
ResourceBundle Paquete de NLS utilizado para el título  
ParentTaskFilename Cuando se crea un archivo de tarea hija, este parámetro define el nombre de archivo de la tarea padre.

Especifique este parámetro solamente si crea una tarea hija.

Especifique el nombre de archivo de la tarea padre sin la extensión .CMDExt. Por ejemplo:

ParentTaskFilename=FILESYSTEM

El título de la tarea hija se muestra debajo del título de la tarea padre. Se comprueba si existe el nombre de archivo de la tarea padre.

CommandString.Windows* Es la cadena de mandato que se debe ejecutar en un sistema Windows.

Importante: los archivos .CMDExt utilizan propiedades Java para el formateo de archivos; por tanto, las barras inclinadas invertidas se deben codificar como barras inclinadas invertidas dobles. Los valores de variables de entorno deben tener únicamente una sola barra inclinada invertida. Por ejemplo:

dir c:\\*exe /s

CommandString.Unix* Es la cadena de mandato que se debe ejecutar en un sistema UNIX/Linux

Importante: los archivos .CMDExt utilizan propiedades Java para el formateo de archivos; por tanto, las barras inclinadas invertidas se deben codificar como barras inclinadas invertidas dobles. Los valores de variables de entorno deben tener únicamente una sola barra inclinada invertida.

Cwd.Windows Vía de acceso del directorio de trabajo actual en un sistema Windows Especifique este parámetro solamente si el mandato necesita iniciarse en un directorio determinado.
Cwd.Unix Vía de acceso del directorio de trabajo actual en un sistema UNIX/Linux Especifique este parámetro solamente si el mandato necesita iniciarse en un directorio determinado.
CheckFileExists Nombre de un archivo que es necesario que exista para ejecutar satisfactoriamente el mandato.

Este archivo es opcional y se supone que existe en el directorio de trabajo actual (Cwd).

Recordatorio: las barras inclinadas invertidas se deben codificar como barras inclinadas invertidas dobles.

ShellRequired Indica si es necesaria una ventana de shell.

Especifique uno de los valores siguientes:

verdadero
Es necesaria una ventana de shell.
falso
No es necesaria una ventana de shell (valor por omisión).
Icon.Small Vía de acceso del icono pequeño de CMDTask, que se muestra junto al título de la tarea en la lista de subtareas, debajo de Inicio de aplicación externa

Esta vía de acceso está referida al directorio dir_instalación_director/classes.

Preceda la vía de acceso con una barra inclinada (/). Por ejemplo, si el icono reside en dir_instalación_director/classes/icondir, el valor del parámetro es:

Icon.Small=/icondir/iconname.gif

Icon.Large Vía de acceso del icono grande de CMDTask, que se muestra en el panel Tareas de la consola de IBM Director.

Esta vía de acceso está referida al directorio dir_instalación_director/classes.

Preceda la vía de acceso con una barra inclinada (/). Por ejemplo, si el icono reside en dir_instalación_director/classes/icondir, el valor del parámetro es:

Icon.Large=/icondir/iconname.gif

Con destino Indica si CMDTask se debe arrastrar y soltar en un sistema de destino.

Especifique uno de los valores siguientes:

none
La tarea se puede abrir pulsando el botón derecho del ratón o mediante una doble pulsación del ratón
one
Es necesario arrastrar la tarea y soltarla en un sistema de destino (valor por omisión).
none|one
La tarea se puede abrir, o arrastrar y soltar en un sistema de destino.
Tiempo de espera Número de segundos que se debe esperar a que concluya el mandato de la tarea después de la ejecución. Especifique un valor numérico comprendido entre 1 y 60. El valor por omisión es 5 segundos. El valor máximo permitido es 60 segundos.

Ejemplos para CommandString.Windows y CommandString.Unix:

Estos ejemplos muestran casos de utilización habituales para ayudarle a evitar confusiones de sintaxis. Utilice estos ejemplos como guía para crear cadenas de mandato.

Ejemplo 1:

Abrir una sesión de telnet y mantener abierta la ventana mientras los usuarios escriben su ID de usuario y contraseña. La opción -hold le permite también recibir un mensaje de error si el mandato de telnet no se ejecuta satisfactoriamente.

En UNIX/Linux:

CommandString.Unix = xterm -e -hold telnet $CMDTASK_IP_ADDRESS0

En Windows:

CommandString.Windows = telnet %CMDTASK_IP_ADDRESS0%

Ejemplo 2:

Utilizar "net use" para conectarse a un sistema

CommandString.Windows = net use * \\\\%CMDTASK_COMPUTERNAME%\\c$ /u:ID_usuario contraseña

(C) Copyright IBM Corporation 1999,2005. Reservados todos los derechos.