É possível usar campos no ambiente local para alterar dinamicamente o comportamento dos nós FileInput, FileOutput, FTEInput e FTEOutput. Também é possível descobrir que valores os nós de saída utilizaram para processar o arquivo.
LocalEnvironment.CD
LocalEnvironment.CD.Transfer
LocalEnvironment.Destination.CD
LocalEnvironment.WrittenDestination.CD
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Diretório | CHARACTER | O caminho de diretório absoluto do diretório de entrada no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:). |
| Nome | CHARACTER | Nome e extensão do arquivo. |
| LastModified | TIMESTAMP | Data e hora da última modificação do arquivo. |
| TimeStamp | CHARACTER | Data e hora em que o nó de entrada iniciou o processamento do arquivo na zona Coordinated Universal Time (UTC), como uma cadeia de caracteres. Esses dados são a cadeia utilizada para criar nomes de archive e de arquivo de restauração, se um registro de data e hora é incluído. |
| Os seguintes elementos contêm dados sobre o registro atual: | ||
| Offset | INTEGER | Início do registro dentro do arquivo. O primeiro registro inicia no deslocamento 0. Se este elemento fizer parte da árvore de mensagem Fim dos Dados, este valor terá o comprimento do arquivo de entrada. |
| Registro | INTEGER | Número do registro no arquivo. O primeiro registro é o registro número 1. Se este elemento fizer parte da árvore de mensagens Fim dos Dados, este valor será o número de registros. |
| Delimitador | CHARACTER | Os caracteres utilizados para separar esse registro a partir do registro anterior, se Delimitado estiver especificado em Detecção de Registro. O primeiro registro tem um delimitador nulo. Se este elemento fizer parte da árvore de mensagens Fim dos Dados, este valor será o delimitador que segue o último registro, se houver. |
| IsEmpty | BOOLEAN | Se o registro propagado pelo fluxo de mensagens estiver vazio. É configurado para TRUE se o registro atual estiver vazio. Se este elemento fizer parte da árvore de mensagens Fim dos Dados, este valor será sempre configurado como TRUE. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Diretório | CHARACTER | O caminho de diretório absoluto do diretório de entrada no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows,
ele começa com o prefixo de letra da unidade (como C:). Como alternativa, esse caminho é relacionado ao diretório raiz de nós de arquivos, que pode ser substituído pela mesma variável de ambiente usada para os nós FileInput e FileOutput. |
| Nome | CHARACTER | Nome e extensão do arquivo. |
| LastModified | TIMESTAMP | Data e hora da última modificação do arquivo. |
| TimeStamp | CHARACTER | Data e hora em que o nó FileRead iniciou o processamento do arquivo como uma cadeia de caracteres, na zona Coordinated Universal Time (UTC). |
| Os seguintes elementos contêm dados sobre o registro atual: | ||
| Offset | INTEGER | O deslocamento no arquivo em que o registro é iniciado. O primeiro byte no arquivo é o deslocamento 0. |
| NextRecordOffset | INTEGER | O deslocamento no arquivo em que o próximo registro é iniciado, relativo ao início do arquivo, e tem 1 byte após ao fim do registro atual. Se o fim do arquivo for atingido, o valor não será fornecido no ambiente local. |
| EndOfFile | BOOLEAN | O nó FileRead configurará este elemento como TRUE, quando tiver lido o último registro do arquivo de entrada. Portanto, ele será sempre TRUE, quando a propriedade de detecção for O Registro é o Arquivo Inteiro. |
| RecordNumber | INTEGER | O número do registro no arquivo relativo ao deslocamento do qual o nó de leitura inicia a leitura. O valor é sempre 1, a menos que a expressão de filtro esteja sendo usada; nesse caso, ela reflete o número do registro que foi selecionado. |
| NoMatchReason | STRING | A razão pela qual uma mensagem é enviada para o terminal "No
match". Nulo, se a mensagem for enviada para o terminal Out.
Razões possíveis:
|
| Delimitador | CHARACTER | Os caracteres utilizados para separar esse registro a partir do registro anterior, se Delimitado estiver especificado em Detecção de Registro. O primeiro registro tem um delimitador nulo. Se este elemento fizer parte da árvore de mensagens Fim dos Dados, este valor será o delimitador que segue o último registro, se houver. |
| IsEmpty | BOOLEAN | Se o registro propagado pelo fluxo de mensagens estiver vazio. É configurado para TRUE se o registro atual estiver vazio. |
| Archive/Directory | STRING | O nome do diretório no qual o arquivo foi arquivado. |
| Archive/Name | STRING | O nome do arquivo no qual o arquivo foi arquivado. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Diretório | CHARACTER | Caminho de diretório absoluto do diretório de saída no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:). |
| Nome | CHARACTER | Nome do arquivo de saída. |
| Ação | CHARACTER | Os
valores possíveis são:
|
| Registro de Data e Hora | CHARACTER | A data e a hora, no formato de cadeia de caracteres, quando o nó foi iniciado para processar esse arquivo. Esse valor prefixará os nomes de arquivos arquivados se você especificar Registrar Data e Hora, Arquivar, Substituir Arquivo Existente e Anexar ao Arquivo Existente na propriedade Ação se o arquivo existir na guia Básico. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Diretório | CHARACTER | Essa propriedade especifica o caminho do diretório absoluto ou relativo do diretório de saída no formato usado pelo sistema de arquivos do broker. Por exemplo, nos sistemas Windows, este caminho inicia com o prefixo da letra da unidade (tal como C:) e usa uma barra invertida (\) como o delimitador de diretório. Nos sistemas UNIX, o caminho inclui uma barra (/) como o delimitador de diretório. |
| Nome | CHARACTER | Essa propriedade especifica o nome do arquivo de saída. O nó FileOutput não executa substituição de curinga no valor do elemento. Por exemplo, se este valor for Input*.txt, o nó FileOutput tentará gravar em um arquivo com um asterisco (*) em seu nome. Ele pode ou não ser bem-sucedido, dependendo se um asterisco é um caractere válido para arquivos no sistema de arquivos no qual ele está gravando. |
| Comprimento | INTEGER | Essa propriedade especifica o comprimento do registro a ser lido do arquivo. O valor só será utilizado se o comprimento fixo da opção de detecção de registro estiver sendo usado. |
| Offset | INTEGER | Essa propriedade especifica o deslocamento no arquivo para iniciar a procura de um registro. O deslocamento 0 significa iniciar do começo e será o valor padrão se nenhuma substituição for fornecida. |
| Archive/Directory | STRING | O diretório no qual o arquivo é arquivado ao usar uma das opções de archive de disposição de arquivo. Por padrão, o arquivo é arquivado em 'mqsiarchive', no diretório de entrada de arquivo. Nenhum caminho é relativo ao diretório de entrada, mas relativo ao MQSI_FILENODES_ROOT_DIRECTORY. |
| Archive/Name | STRING | O padrão a ser usado para criar um nome de arquivo de archive. Somente um asterisco é permitido no nome do arquivo e o asterisco é substituído pela primeira substituição de asterisco no nome padrão do arquivo. Se Archive com Registro de Data e Hora for especificado, um registro de data e hora será anexado ao nome do archive. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Remote.ServerDirectory | CHARACTER | Essa propriedade especifica o caminho do diretório absoluto ou relativo do diretório de saída no servidor remoto. A propriedade não terá efeito se SFTP ou FTP não estiver ativado no nó FileOutput. Formate o caminho de acordo com a sintaxe de caminho aceita pelo servidor FTP, normalmente usando barra (/) como delimitador de diretório no estilo UNIX. |
, CDInput
e FTEInput, é possível especificar um padrão de nome de arquivo que contenha caracteres curinga. Os nós de entrada copiam os caracteres no nome do arquivo que correspondem aos curingas, juntamente com todos os caracteres intermediários, para LocalEnvironment.Wildcard.WildcardMatch.| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| WildcardMatch | CHARACTER | A cadeia de caracteres no nome do arquivo correspondido por curingas no padrão do nome do arquivo. |
Nos nós FileOutput
, CDOutput
e FTEOutput, é possível usar um caractere curinga no padrão de nome do arquivo. Se você incluir o caractere curinga único, '*', no padrão do nome do arquivo, o nó utiliza o valor que está armazenado em LocalEnvironment.Wildcard.WildcardMatch.
Isso é útil se você tiver um fluxo de mensagens em que os nós de entrada e de saída estão trabalhando com o mesmo arquivo. É possível preservar o nome do arquivo de entrada nos nós de saída. Também é possível usar métodos padrão
para manipular o valor do elemento WildcardMatch para o que
você quiser; você não deve usar um nó FileInput, CDInput ou FTEInput.
Consulte a seção Padrões de Nomes de Arquivos para obter mais informações.
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| TimeStamp | CHARACTER | Data e hora em que o nó de entrada iniciou o processamento do arquivo na zona Coordinated Universal Time (UTC), como uma cadeia de caracteres. Esses dados são a cadeia utilizada para criar nomes de archive e de arquivo de restauração, se um registro de data e hora é incluído. |
| Offset | INTEGER | Início do registro dentro do arquivo. O primeiro registro inicia com deslocamento de 0 bytes. Quando o Deslocamento for parte da árvore de mensagem Fim dos Dados, esse valor será o o comprimento do arquivo de entrada. |
| Registro | INTEGER | Número do registro no arquivo. O primeiro registro é o registro número 1. Quando Registro fizer parte da árvore de mensagens Fim dos Dados, este valor será o número de registros. |
| Delimitador | CHARACTER | Os caracteres utilizados para separar esse registro a partir do registro anterior, se Delimitado estiver especificado em Detecção de Registro. O primeiro registro tem um delimitador nulo. Quando o Delimitador fizer parte da árvore de mensagens Fim dos Dados, este valor será o delimitador que seguirá o último registro, se houver. |
| IsEmpty | BOOLEAN | Se o registro propagado pelo fluxo de mensagens estiver vazio. IsEmpty é configurado como TRUE se o registro atual estiver vazio. Quando IsEmpty for parte da árvore de mensagens Fim dos Dados, esse valor sempre será definido como TRUE. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Diretório | CHARACTER | Caminho de diretório absoluto do diretório de entrada. |
| JobName | CHARACTER | O nome para a transferência. |
| Nome | CHARACTER | Nome do arquivo e extensão (por arquivo). |
| LastModified | TIMESTAMP | Data e hora em que o arquivo foi modificado pela última vez (por arquivo). |
| SourceAgent | CHARACTER | O nome do agente que está enviando o arquivo. |
| DestinationAgent | CHARACTER | O nome do agente para o qual enviar o arquivo. |
| OriginatingHost | CHARACTER | O nome do host a parti do qual a transferência foi submetida. |
| TransferId | CHARACTER | O nome exclusivo da transferência. |
| MQMDUser | CHARACTER | O ID do usuário do WebSphere MQ no MQMD da mensagem de solicitação de transferência. |
| OriginatingUser | CHARACTER | O ID de usuário que submeteu o pedido de transferência. |
| TransferMode | CHARACTER | O modo da transferência. Os valores válidos são Binary ou Text. |
| TransferStatus | CHARACTER | O status da transferência do arquivo. |
| FileSize | INTEGER | O tamanho do arquivo que está sendo transferido. |
| ChecksumMethod | CHARACTER | O único valor permitido é MD5. |
| Checksum | CHARACTER | O elemento ChecksumMethod é configurado como MD5 e este elemento é a soma de verificação real no formato de cadeia hexadecimal. |
| DestinationAgentQmgr | CHARACTER | O nome do gerenciador de filas do agente de destino ao qual enviar o arquivo. |
| SourceAgentQmgr | CHARACTER | O nome do gerenciador de filas do agente de origem que enviou o arquivo. |
| OverallTransferStatus | CHARACTER | O status geral da transferência. |
| TotalTransfers | INTEGER | O número total de arquivos transferidos com êxito. |
| TransferNumber | INTEGER | O número do arquivo atual na transferência. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| DestinationAgent | CHARACTER | O nome do agente para o qual enviar o arquivo. |
| DestinationQmgr | CHARACTER | O nome do gerenciador de filas de destino. |
| JobName | CHARACTER | O nome para a transferência. |
| Diretório | CHARACTER | Caminho de diretório absoluto do diretório de saída no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:). |
| Nome | CHARACTER | Nome do arquivo de saída. |
| Overwrite | BOOLEAN | Especifica se os arquivos no sistema de destino podem ser sobrescritos quando o agente de destino move arquivos com o mesmo nome lá. Se o agente de destino falhar ao sobrescrever o arquivo, a transferência falhará e os logs de transferência relatarão a falha. O nó FTEOutput não lança ou registra qualquer erro. |
| TransferId | CHARACTER | O nome exclusivo da transferência iniciada pelo nó de FTEOutput. |
| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| DestinationAgent | CHARACTER | O nome do agente para o qual enviar o arquivo. |
| DestinationQmgr | CHARACTER | O nome do gerenciador de filas de destino. |
| JobName | CHARACTER | O nome para a transferência. |
| Diretório | CHARACTER | Caminho de diretório absoluto do diretório de saída no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:). |
| Nome | CHARACTER | Nome do arquivo de saída. |
| Overwrite | BOOLEAN | Especifica se os arquivos no sistema de destino podem ser sobrescritos quando o agente de destino move arquivos com o mesmo nome lá. Se o agente de destino falhar ao sobrescrever o arquivo, a transferência falhará e os logs de transferência relatarão a falha. O nó FTEOutput não lança ou registra qualquer erro. |
| PreDestinationCall.Name | CHARACTER | Chame um programa no agente de destino antes de iniciar a transferência. Este elemento fornece o nome de um script Ant para executar. Não é possível chamar outros programas que não sejam scripts Ant ou passar parâmetros para as chamadas. O script Ant pode acessar todos os metadados definidos para a transferência, incluindo os metadados do usuário incluídos usando a substituição de ambiente local LocalEnvironment.Destination.FTE.UserDefined. Consulte Centro de informações do WebSphere File Transfer Edition para obter mais detalhes sobre como usar a função PreDestinationCall. |
| PostDestinationCall.Name | CHARACTER | Chame um programa no agente de destino após concluir a transferência. Este elemento fornece o nome de um script Ant para executar. Não é possível chamar outros programas que não sejam scripts Ant ou passar parâmetros para as chamadas. O script Ant pode acessar todos os metadados definidos para a transferência, incluindo os metadados do usuário incluídos usando a substituição de ambiente local LocalEnvironment.Destination.FTE.UserDefined. Consulte Centro de informações do WebSphere File Transfer Edition para obter mais detalhes de como usar a função PostDestinationCall. |

| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| Transferência | Pasta | Contém metadados da transferência do IBM® Sterling Connect:Direct. |
| Registro de Data e Hora | CHAR | Registro de data e hora do arquivo. |
| Offset | INTEGER | Início do registro dentro do arquivo. O primeiro registro inicia com deslocamento de 0 bytes. Quando o Deslocamento for parte da árvore de mensagem Fim dos Dados, esse valor será o o comprimento do arquivo de entrada. |
| Registro | INTEGER | Número do registro no arquivo. O primeiro registro é o registro número 1. Quando Registro fizer parte da árvore de mensagens Fim dos Dados, este valor será o número de registros. |
| Delimitador | CHARACTER | Os caracteres utilizados para separar esse registro a partir do registro anterior, se Delimitado estiver especificado em Detecção de Registro. O primeiro registro tem um delimitador nulo. Quando o Delimitador fizer parte da árvore de mensagens Fim dos Dados, este valor será o delimitador que seguirá o último registro, se houver. |
| IsEmpty | BOOLEAN | Se o registro propagado pelo fluxo de mensagens estiver vazio. IsEmpty é configurado como TRUE se o registro atual estiver vazio. Quando IsEmpty for parte da árvore de mensagens Fim dos Dados, esse valor sempre será definido como TRUE. |


| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| ProcessName | CHARACTER | O nome do processo do script que transfere o arquivo. |
| StepName | CHARACTER | O nome da etapa que faz com que a transferência ocorra. |
| ProcessNumber | INTEGER | O número do processo que executa o script do processo. |
| Submitter | CHAR | O ID do usuário que envia o script do processo. |
| Contabilidade | CHAR | Os detalhes contábeis do nó secundário (SNODE) para o script do processo. |
| SourcePath | CHAR | O caminho de origem do arquivo na máquina do nó primário (PNODE). |
| DestinationPath | CHAR | O caminho de destino do arquivo na máquina do nó secundário (SNODE) |
| Diretório | CHARACTER | O diretório para o qual o arquivo é copiado. |
| Nome | CHARACTER | O nome do arquivo copiado. |
| PrimaryNodeName | CHARACTER | O nome do nó primário do qual o arquivo foi copiado. |
| SecondaryNodeName | CHARACTER | O nome do nó secundário. |


| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| SNODE | CHARACTER | O nome do Servidor Connect:Direct secundário (SNODE) para o qual enviar o arquivo. |
| ProcessName | CHARACTER | O nome do processo usado pelo script para execução. |
| Contabilidade | CHARACTER | Dados contábeis mostrados quando o script está em execução no Servidor Connect:Direct primário (PNODE) e Servidor Connect:Direct secundário (SNODE). |
| Diretório | CHARACTER | Caminho de diretório absoluto do diretório de saída no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:). |
| Nome | CHARACTER | Nome do arquivo de saída. |
| Copy.From | CHARACTER | A parte final do nome do caminho é a propriedade do script de processo do IBM Sterling Connect:Direct que você
deseja alterar. É um <nome de opção> direto da cláusula FROM ou um valor na opção <SYSOPTS>. Você deve ter cuidado para assegurar-se de que o script criado seja válido, porque qualquer valor existente criado pelo nó é substituído. |
| Copy.To | CHARACTER | A parte final do nome do caminho é a propriedade do script de processo do IBM Sterling Connect:Direct que você
deseja alterar. É um <nome de opção> direto da cláusula TO ou um valor na opção <SYSOPTS>. Você deve ter cuidado para assegurar-se de que o script criado seja válido, porque qualquer valor existente criado pelo nó é substituído. |


| Nome do Elemento | Tipo de Dados do Elemento | Descrição |
|---|---|---|
| ProcessName | CHARACTER | O nome do processo que envia o arquivo. |
| ProcessNumber | CHARACTER | O número do processo que envia o arquivo. |
| Diretório | CHARACTER | Caminho de diretório absoluto do diretório de saída no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:). |
| Nome | CHARACTER | Nome do arquivo de saída. |
| PrimaryNodeName | CHARACTER | O nome do Servidor Connect:Direct primário (PNODE) |
| PrimaryNodeOS | CHARACTER | O sistema operacional do Servidor Connect:Direct primário |
| SecondaryNodeName | CHARACTER | O nome do Servidor Connect:Direct secundário (SNODE) |
| SecondaryNodeOS | CHARACTER | O sistema operacional do Servidor Connect:Direct secundário (não pode ser o mesmo sistema operacional do WebSphere Message Broker) |
