É 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.
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}
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.
Por exemplo: -u http://mgmtserver1:8080.
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
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.
Por exemplo: -u http://proxy1:12000.
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.
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.
Por exemplo: -l INFO.
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.
O caminho de arquivo completo do arquivo para o qual a resposta de serviço será gravada.
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}
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.
Por exemplo: -u http://mgmtserver1:8080.
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.
É 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
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
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
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}
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.
Por exemplo: -v C:\override\requestfileoverride.xml.
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.
<?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.
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.)
<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.
db2jcc4.*\.jar=/opt/IBM/sqllib/java/db2jcc4.jar db2jcc4_license_cu.*\.jar=/opt/IBM/sqllib/java/db2jcc4_license_cu.jarSe 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
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
A senha em texto não criptografado que você deseja criptografar. Obrigatório.
É 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}
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.
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.
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
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.
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.