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.
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.
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.
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:
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:
|
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:
|
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