Usando o Processamento de Linha de Comandos

É possível executar um ou mais serviços ao submeter solicitações de serviço ao servidor de gerenciamento a partir da linha de comandos.

Antes de executar um serviço, você deve designá-lo a um proxy e a um servidor de gerenciamento usando o gerenciador. O servidor de gerenciamento e o proxy devem estar em execução para processar a solicitação de serviço. Você também deve instalar o InfoSphere Data Architect e o IBM Optim Designer para obter os arquivos necessários para executar o processamento de linha de comandos.

Existem duas opções para usar a linha de comandos:

script runservice

O script runservice está localizado na pasta ida_folder\optim\designer\runservice, em que ida_folder é a pasta na qual o InfoSphere Data Architect está instalado. Você deve abrir a linha de comandos na pasta ida_folder\optim\designer\runservice. A pasta contém dois arquivos de script, um para o Microsoft Windows (runservice.bat) e outro para Linux e UNIX (runservice.sh).

O script runservice requer que você inclua a pasta-raiz de uma instalação do Java 6.0 JRE ou JDK na variável de ambiente PATH.

O script runservice usa a seguinte sintaxe quando você executa serviços designados a um servidor de gerenciamento e proxy:

runservice {--service | -s} servicename:version
{--url | -u} serverURL {--continueOnError | -c} 
--service | -s servicename:version

O nome e o número da versão do serviço (no formato n.n.n). Obrigatório.

Os nomes dos serviços fazem distinção entre maiúsculas e minúsculas. Se um nome de serviço contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

Por exemplo: -s demosvc:1.0.0.

--url | -u serverURL
O local do servidor de gerenciamento que hospeda o registro e o repositório que contêm o serviço. O local http://localhost:8080 é usado por padrão.

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

--continueOnError | -c

Este parâmetro configura o script para continuar o envio de serviços para o proxy para execução, mesmo se o serviço falhar ao ser iniciado pelo proxy.

O script runservice usa a seguinte sintaxe quando você executa uma solicitação de serviço exportada:

runservice {-r|--serviceRequest} requestfilepath
{-u|-url} proxyURL {-j|--jarMap} mapfilepath 
{-v|--overrideValues} overridefilepath {-l|--logLevel} loglevel
{-t|--timeout} seconds|never {-p|--serviceResponse} responsefilepath
--serviceRequest | -r requestfilepath

O caminho de arquivo completo para a solicitação de serviço exportada. Obrigatório.

Os nomes de serviços fazem distinção entre maiúsculas e minúsculas. Se o nome de arquivo contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

Por exemplo: -r demosvc.jar.

--url | -u proxyURL
O local do proxy que você deseja usar para executar o serviço. O local http://localhost:12000 é usado por padrão.

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

--jarMap | -j mapfilepath

O caminho de arquivo completo para o arquivo de mapeamento.

Os nomes de arquivos de mapeamento fazem distinção entre maiúsculas e minúsculas. Se o nome de arquivo contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

--overrideValues | -v overridefilepath

O caminho de arquivo completo para o arquivo de substituição.

Os nomes de arquivos de mapeamento fazem distinção entre maiúsculas e minúsculas. Se o nome de arquivo contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

--logLevel | -l loglevel
O nível de log do serviço (ou seja, a menor gravidade das mensagens que serão incluídas no log). Valores possíveis são, do mais baixo para o mais alto:
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL

Por exemplo: -l INFO.

--timeout | -t timeoutseconds

Especifica o número de segundos para aguardar por uma resposta antes do término (ou nunca aguardar). O script runservice aguarda 600 segundos por padrão.

--serviceResponse | -p serviceresponsefile

O caminho de arquivo completo do arquivo para o qual a resposta de serviço será gravada.

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

O arquivo com-ibm-nex-client-tool.jar está localizado na pasta ida_folder\optim\designer\runservice, em que ida_folder é a pasta na qual o InfoSphere Data Architect está instalado. Você deve abrir a linha de comandos na pasta ida_folder\optim\designer\runservice.

O comando java -jar com-ibm-nex-client-tool.jar usa a seguinte sintaxe, em que java_folder é a pasta-raiz de uma instalação do Java 6.0 JRE ou JDK. Para evitar a inserção da pasta raiz sempre que você insere um comando, inclua essa pasta na variável de ambiente PATH.

java_folder/java -jar com-ibm-nex-client-tool.jar 
{--service | -s} servicename:version
{--url | -u} serverURL {--continueOnError | -c}
--service | -s servicename:version

O nome o número da versão do serviço de gerenciamento de dados(em formato n.n.n). Obrigatório.

Os nomes dos serviços fazem distinção entre maiúsculas e minúsculas. Se um nome de serviço contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

Por exemplo: -s demosvc:1.0.0.

--url | -u serverURL
O local do servidor de gerenciamento que hospeda o registro e o repositório que contêm o serviço. Obrigatório.

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

--continueOnError | -c

Este parâmetro configura o script para continuar o envio de serviços para o proxy para execução, mesmo se o serviço falhar ao ser iniciado pelo proxy.

Executando múltiplos serviços

É possível que a linha de comando execute serviços múltiplos implementados no mesmo servidor de gerenciamento. Os serviços são iniciados um por vez na ordem especificada, com execução paralela.

Especifique cada par de serviço e versão separado por vírgula. Não deixe espaço entre as vírgulas.

Por exemplo:

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

Espaços nos nomes de serviços

Se um nome do serviço contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), o nome deverá estar entre aspas duplas (" "). Por exemplo:

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

Executando a Solicitação de Serviço Exportada

Você pode usar a linha de comandos para executar uma solicitação de serviço que foi exportada para um arquivo.

Por exemplo:

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

Arquivo de Substituição

Um arquivo de substituição é um arquivo XML que contém parâmetros de solicitação de serviço. Se você especificar um arquivo de substituição ao executar uma solicitação de serviço exportada, o script runservice usará os parâmetros do arquivo de substituição ao executar a solicitação.

Você pode usar o script runservice para gerar um arquivo de substituição que contenha os parâmetros que estão em uma solicitação de serviço.

runservice {-g|--generateOverrideTemplate} requestfilepath
{-v|--overrideValues} overridefilepath {-i|--includeComments} {true|false}
--generateOverrideTemplate | -g requestfilepath

O caminho de arquivo completo para a solicitação de serviço exportada. Obrigatório.

Os nomes de serviços fazem distinção entre maiúsculas e minúsculas. Se um nome de serviço da solicitação de serviço contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

--overrideValues | -v overridefilepath
O caminho de arquivo completo para o novo arquivo de substituição.

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

--includeComments | -i

Especifique se deseja incluir comentários no arquivo de substituição. Os valores válidos são true e false. Por padrão, nenhum comentário é incluído no arquivo de substituição.

Depois de gerar o arquivo de substituição, você poderá alterar os parâmetros nesse arquivo de substituição. Se você executar uma solicitação de serviço, poderá especificar o arquivo de substituição alterado e o script runservice usará os parâmetros alterados para executar a solicitação de serviço.

Os arquivos de substituição usam o mesmo namespace XML das solicitações de serviço (http://www.ibm.com/nex/ecore/2.2.0/svc). O elemento raiz do arquivo de substituição é sempre Substituições. O formato geral é uma hierarquia aninhada de grupos e atributos de substituição derivados dos descritores de grupos e atributos de substituição encontrados na solicitação de serviço. Quando o script runservice gera um modelo de substituição, os elementos de grupo e atributo são nomeados usando os nomes dos descritores de grupos e atributos de substituição.
<?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>
O arquivo de substituição deve ser codificado usando UTF-8.

Arquivo de Mapeamento

Um arquivo de mapeamento é um arquivo que o proxy usa para corresponder o driver JDBC em uma solicitação de serviço com um driver JDBC no proxy. Se o driver JDBC de uma solicitação de serviço fizer a correspondência de uma linha no arquivo de mapeamento, o proxy usará o driver JDBC especificado nessa linha. Se o driver JDBC de uma solicitação de serviço não fizer a correspondência de nenhuma linha no arquivo de mapeamento, o proxy usará o driver JDBC exato que estiver especificado na solicitação de serviço. (O proxy pode ser configurado para usar uma versão mais recente do driver JDBC se uma existir no proxy.)

O arquivo de mapeamento usado pelo script runservice é semelhante a um arquivo Java .properties. As linhas vazias são ignoradas. As linhas que começam com o caractere de sinal numérico (#) são tratadas como comentários. Todas as demais linhas devem seguir este formato:
<regex>=<path>
<regex> é um padrão de expressão regular válido que será usado para corresponder o nome de um arquivo .jar fornecido pelo designer. <path> é um caminho completo para um arquivo .jar real em um proxy.
Por exemplo, um arquivo de mapeamento contém as seguintes linhas:
db2jcc4.*\.jar=/opt/IBM/sqllib/java/db2jcc4.jar
db2jcc4_license_cu.*\.jar=/opt/IBM/sqllib/java/db2jcc4_license_cu.jar
Se uma solicitação de serviço estiver configurada para usar o driver JDBC db2jcc4-9.1.jar, o proxy executará a solicitação de serviço usando o driver JDBC /opt/IBM/sqllib/java/db2jcc4.jar. Se uma solicitação de serviço estiver configurada para usar o driver JDBC db2jcc4_license_cu-9.1.jar, o proxy executará a solicitação de serviço usando o driver JDBC /opt/IBM/sqllib/java/db2jcc4_license_cu.jar

Criptografando uma Senha

Você pode usar o script runservice para criptografar uma senha em texto não criptografado em uma solicitação de serviço.

runservice {-e|--encryptPassword} password 
--encryptPassword | -e password

A senha em texto não criptografado que você deseja criptografar. Obrigatório.

Consultando a Tabela de Início

É possível usar o script runservice para exibir a tabela de início (e outras tabelas) em uma solicitação de serviço.

runservice {-a|--startTable} requestfilepath
{-o|--otherTables } {true|false}
--startTable | -a requestfilepath

O caminho de arquivo completo para a solicitação de serviço exportada cuja tabela de início deverá ser exibida. Obrigatório.

Os nomes de serviços fazem distinção entre maiúsculas e minúsculas. Se o nome de arquivo contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

--otherTables | -o

Especifique se as outras tabelas na solicitação de serviço deverão ser incluídas na saída. Os valores válidos são true e false. Por padrão, todas as tabelas são incluídas.

Exibindo uma Solicitação de Serviço

Você pode usar o script runservice para exibir as informações em uma solicitação de serviço.

runservice {-d|--displayService} requestfilepath
{-x|--xsltStylesheet} stylesheetpath
--displayService | -d requestfilepath

O caminho de arquivo completo para a solicitação de serviço exportada cujas informações deverão ser exibidas. Obrigatório.

Os nomes de serviços fazem distinção entre maiúsculas e minúsculas. Se o nome de arquivo contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.

--xsltStylesheet | -x xsltfilepath

O caminho de arquivo completo para a folha de estilo XSLT que deverá ser usada para formatar a solicitação de serviço.

Os nomes de arquivos da folha de estilo XSLT fazem distinção entre maiúsculas e minúsculas. Se o nome de arquivo contiver um espaço ou caracteres do conjunto de caracteres multibyte (MBCS), você deverá colocá-lo entre aspas duplas.