Utilizar proceso de línea de mandatos

Puede ejecutar uno o varios servicios sometiendo solicitudes de servicio en el servidor de gestión desde la línea de mandatos.

Antes de ejecutar un servicio, debe asignar el servicio en un proxy y en un servidor de gestión utilizando el gestor. El proxy y el servidor de gestión deben estar en ejecución para procesar la solicitud de servicio. También debe instalar InfoSphere Data Architect y IBM Optim Designer para obtener los archivos que necesita para ejecutar procesos de línea de mandatos.

Existen dos opciones para utilizar la línea de mandatos:

script runservice

El script runservice está ubicado en la carpeta carpeta_ida\optim\designer\runservice, donde carpeta_ida es la carpeta en la que se ha instalado InfoSphere Data Architect. Debe abrir la línea de mandatos en la carpeta carpeta_ida\optim\designer\runservice. La carpeta contiene dos archivos de script, uno para Microsoft Windows (runservice.bat) y otro para Linux y UNIX (runservice.sh).

El script runservice requiere que se añada la carpeta raíz de una instalación Java 6.0 JRE o JDK a la variable de entorno PATH.

El script runservice utiliza la sintaxis siguiente cuando se ejecutan servicios asignados a un servidor de gestión y proxy:

runservice
{--service | -s} nombreservicio:versión
{--url | -u} URLservidor {--continueOnError | -c} 
--service | -s nombreservicio:versión

El nombre de servicio y el número de versión (en formato n.n.n). Obligatorios.

Los nombres de servicio distinguen entre mayúsculas y minúsculas. Si un nombre de servicio contiene un espacio o contiene caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

Por ejemplo: -s demosvc:1.0.0.

--url | -u URLservidor
La ubicación del servidor de gestión que aloja al registro y al repositorio que contiene el servicio. La ubicación http://localhost:8080 se utiliza de forma predeterminada.

Por ejemplo: -u http://mgmtserver1:8080.

--continueOnError | -c

Este parámetro define el script para continuar enviando servicios al proxy para su ejecución, aunque el proxy no pueda iniciar un servicio.

El script runservice utiliza la sintaxis siguiente cuando se ejecuta una solicitud de servicio exportada:

runservice
{-r|--serviceRequest} vía_acceso_archivo_solicitud
{-u|-url} URLproxy {-j|--jarMap} vía_acceso_archivo_correlación
{-v|--overrideValues} vía_acceso_archivo_alteración_temporal {-l|--logLevel} nivel_registro
{-t|--timeout} segundos|never {-p|--serviceResponse} vía_acceso_archivo_respuestas
--serviceRequest | -r vía_acceso_archivo_solicitud

La vía de acceso de archivo completa de la solicitud de servicio exportada. Obligatorio.

Los nombres de archivo de solicitud de servicio distinguen entre mayúsculas y minúsculas. Si el nombre de archivo contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

Por ejemplo: -r demosvc.jar.

--url | -u URLproxy
La ubicación del proxy que se desea utilizar para ejecutar el servicio. La ubicación http://localhost:12000 se utiliza de forma predeterminada.

Por ejemplo: -u http://proxy1:12000.

--jarMap | -j vía_acceso_archivo_correlación

La vía de acceso de archivo completa del archivo de correlación.

Los nombres del archivo de correlación distinguen entre mayúsculas y minúsculas. Si el nombre de archivo contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

--overrideValues | -v vía_acceso_archivo_sobrescritura

La vía de acceso de archivo completa del archivo de sobrescritura.

Los nombres del archivo de correlación distinguen entre mayúsculas y minúsculas. Si el nombre de archivo contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

--logLevel | -l nivelregistro
El nivel de registro para el servicio (es decir, la gravedad más baja de los mensajes para que se incluyan en el registro). Los valores posibles son, de más bajo a más alto:
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL

Por ejemplo: -l INFO.

--timeout | -t segundos_tiempo_espera

Especifica el número de segundos que hay que esperar una respuesta antes del final (o no esperar nunca). El script runservice espera durante 600 segundos de forma predeterminada.

--serviceResponse | -p archivo_respuesta_servicio

La vía de acceso completa del archivo en la que se graba la respuesta del servicio.

Mandato java -jar com-ibm-nex-client-tool.jar

El archivo com-ibm-nex-client-tool.jar está ubicado en la carpeta carpeta_ida\optim\designer\runservice, donde carpeta_ida es la carpeta en la que se ha instalado InfoSphere Data Architect. Debe abrir la línea de mandatos en la carpeta carpeta_ida\optim\designer\runservice.

El mandato java -jar com-ibm-nex-client-tool.jar utiliza la sintaxis siguiente, donde carpeta_java es la carpeta raíz de la instalación de Java 6.0 JRE o JDK. Para evitar que se le solicite introducir la carpeta raíz cada vez que introduce este mandato, añada la carpeta raíz a la variable de entorno PATH.

carpeta_java/java -jar com-ibm-nex-client-tool.jar 
{--service | -s} nombreservicio:versión
{--url | -u} URLservidor {--continueOnError | -c}
--service | -s nombreservicio:versión

Nombre del servicio de gestión de datos y número de versión (en formato n.n.n). Obligatorios.

Los nombres de servicio distinguen entre mayúsculas y minúsculas. Si un nombre de servicio contiene un espacio o contiene caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

Por ejemplo: -s demosvc:1.0.0.

--url | -u URLservidor
La ubicación del servidor de gestión que aloja al registro y al repositorio que contiene el servicio. Obligatorio.

Por ejemplo: -u http://mgmtserver1:8080.

--continueOnError | -c

Este parámetro define el script para continuar enviando servicios al proxy para su ejecución, aunque el proxy no pueda iniciar un servicio.

Ejecución de varios servicios

Puede utilizar la línea de mandatos para ejecutar varios servicios desplegados en el mismo servidor de gestión. Los servicios se inician uno cada vez en el orden especificado. ejecutar en paralelo

Especifique cada par de servicio y versión separados por una coma. No deje espacios antes o después de cada coma.

Por ejemplo:

runservice -s service1:1.0.0,service2:1.0.0 -u http://mymgmtserver:8080 -c

Espacios en los nombres de servicio

Si un nombre de servicio contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas (" "). Por ejemplo:

runservice -s "service name":1.0.0 -u http://mymgmtserver:8080

Ejecución de una solicitud de servicio exportada

Puede utilizar la línea de mandatos para ejecutar una solicitud de servicio que se ha exportado a un archivo.

Por ejemplo:

runservice -r C:\services\service1.jar -u http://myproxy:12000

Archivo de alteración temporal

Un archivo de alteración temporal es un archivo XML que contiene parámetros de solicitud de servicio. Si especifica un archivo de alteración temporal al ejecutar una solicitud de servicio exportada, el script runservice utiliza los parámetros del archivo de alteración temporal al ejecutar la solicitud.

Puede utilizar el script runservice para generar un archivo de alteración temporal que contenga los parámetros de una solicitud de servicio.

runservice
{-g|--generateOverrideTemplate} vía_acceso_archivo_solicitud
{-v|--overrideValues} vía_acceso_archivo_alteración_temporal {-i|--includeComments} {true|false}
--generateOverrideTemplate | -g vía_acceso_archivo_solicitud

La vía de acceso de archivo completa de la solicitud de servicio exportada. Obligatorio.

Los nombres de archivo de solicitud de servicio distinguen entre mayúsculas y minúsculas. Si un nombre de archivo de solicitud de servicio contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

--overrideValues | -v vía_acceso_archivo_sobrescritura
La vía de acceso de archivo completa del nuevo archivo de sobrescritura.

Por ejemplo: -v C:\override\requestfileoverride.xml.

--includeComments | -i

Especifique si desea incluir comentarios en el archivo de alteración temporal. Los valores válidos son true y false. De forma predeterminada, no se incluyen comentarios en el archivo de alteración temporal.

Después de generar el archivo de alteración temporal, puede cambiar los parámetros del archivo de alteración temporal. Si ejecuta una solicitud de servicio, puede especificar el archivo de alteración temporal modificado y el script runservice utilizará los parámetros modificados para ejecutar la solicitud de servicio.

Los archivos de alteración temporal utilizan el mismo espacio de nombres XML que las solicitudes de servicio (http://www.ibm.com/nex/ecore/2.2.0/svc). El elemento raíz del archivo de alteración temporal es siempre Overrides. El formato genérico es una jerarquía anidada de atributos y grupos de alteración temporal derivados de los descriptores de tributo y grupo de alteración temporal que se encuentran en la solicitud de servicio. Cuando el script runservice genera una plantilla de alteración temporal, los elementos de grupo y atributo se nombran utilizando los nombres de descriptor de atributos y del grupo de alteración temporal.
<?xml version=”1.0” encoding=”UTF-8”?>
<svc:Overrides xmlns:svc=”http://www.ibm.com/nex/ecore/2.2.0/svc”>
    <svc:ParentGroup uuid=”...”>
        <svc:ChildGroup uuid=”...”>
            <svc:Attribute1 value=”...” uuid=”...” />
            <svc:Attribute2 value=”...” uuid=”...” />
            <svc:Attribute3 value=”...” uuid=”...” />
            ...
        </svc:ChildGroup>
        ...
    </svc:ParentGroup>
    ...
</svc:Overrides>
El archivo de alteración temporal debe codificarse con UTF-8.

Archivo de correlación

Un archivo de correlación es un archivo que utiliza el proxy para comparar el controlador JDBC de una solicitud de servicio con un controlador JDBC del proxy. Si el controlador JDBC de una solicitud de servicio coincide con una línea del archivo de correlación, el proxy utiliza el controlador JDBC especificado en dicha línea. Si el controlador JDBC de una solicitud de servicio no coincide con ninguna de las líneas del archivo de correlación, el proxy utiliza el controlador JDBC especificado en la solicitud de servicio. (El proxy puede configurarse para utilizar una versión más reciente del controlador JDBC si existe una en el proxy).

El archivo de correlación utilizado por el script runservice es similar a un archivo .properties Java estándar. Las líneas vacías se ignoran. Las líneas que empiezan con el carácter de almohadilla (#) se consideran comentarios. Todas las demás líneas deben ajustarse al formato siguiente:
<regex>=<vía_acceso>
<regex> es un patrón de expresión regular válido que se utilizará para comparar el nombre archivo .jar suministrado por el diseñador. <vía_acceso> es una vía de acceso completa a un archivo .jar real de un proxy.
Por ejemplo, un archivo de correlación contiene las líneas siguientes:
db2jcc4.*\.jar=/opt/IBM/sqllib/java/db2jcc4.jar
db2jcc4_license_cu.*\.jar=/opt/IBM/sqllib/java/db2jcc4_license_cu.jar
Si una solicitud de servicio está establecida para utilizar el controlador JDBC db2jcc4-9.1.jar, el proxy ejecuta la solicitud de servicio con el controlador JDBC /opt/IBM/sqllib/java/db2jcc4.jar. Si una solicitud de servicio está establecida para utilizar el controlador JDBC db2jcc4_license_cu-9.1.jar, el proxy ejecuta la solicitud de servicio con el controlador JDBC /opt/IBM/sqllib/java/db2jcc4_license_cu.jar

Cifrado de una contraseña

Puede utilizar el script runservice para cifrar una contraseña de texto plano en una solicitud de servicio.

runservice {-e|--encryptPassword} contraseña 
--encryptPassword | -e contraseña

La contraseña de texto plano que desea cifrar. Obligatorio.

Búsqueda en la tabla de inicio

Puede utilizar el script runservice para visualizar la tabla de inicio (y otras tablas) de una solicitud de servicio.

runservice {-a|--startTable} vía_acceso_archivo_solicitud
{-o|--otherTables } {true|false}
--startTable | -a vía_acceso_archivo_solicitud

La vía de acceso de archivo completa de la solicitud de servicio exportada cuya tabla de inicio se visualizará. Obligatorio.

Los nombres de archivo de solicitud de servicio distinguen entre mayúsculas y minúsculas. Si el nombre de archivo contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

--otherTables | -o

Especifique si las demás tablas de la solicitud de servicio deben incluirse en la salida. Los valores válidos son true y false. De forma predeterminada, se incluyen todas las tablas.

Visualización de una solicitud de servicio

Puede utilizar el script runservice para visualizar la información de una solicitud de servicio.

runservice {-d|--displayService} vía_acceso_archivo_solicitud
{-x|--xsltStylesheet} vía_acceso_hoja_estilo
--displayService | -d vía_acceso_archivo_solicitud

La vía de acceso de archivo completa de la solicitud de servicio exportada cuya información se visualizará. Obligatorio.

Los nombres de archivo de solicitud de servicio distinguen entre mayúsculas y minúsculas. Si el nombre de archivo contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.

--xsltStylesheet | -x vía_acceso_archivo_xslt

La vía de acceso de archivo completa de la hoja de estilo XSLT que debe utilizarse para formatear la solicitud de servicio.

Los nombres de archivo de hoja de estilo XSLT distinguen entre mayúsculas y minúsculas. Si el nombre de archivo contiene un espacio o caracteres del juego de caracteres de varios bytes (MBCS), el nombre debe encerrarse entre comillas.