Auxílios do VisualAge Generator

EZECONV

EZECONV converte dados entre os formatos EBCDIC (host) e ASCII (estação de trabalho) ou executa a conversão da página de códigos dentro de um único formato.

Usos

Você pode utilizar EZECONV como o nome de função em uma instrução de chamada da função.

A seguir a seqüência de chamada para EZECONV:

>>-EZECONV---(--destino--,---direction--,----------------------->
 
>----conversion_table--)--;------------------------------------><
 

destino
O nome do registro, mapa ou item de dados que possui o formato que deseja converter. Os dados são convertidos no lugar baseado na definição de item dos itens de nível mais baixo (itens sem estrutura) no objeto de destino.

Registros de comprimento variável são convertidos somente para o comprimento atualmente definido para o registro no item número de ocorrências de registros. Estes ocorrem de forma variável, ou no item de comprimento variável ou no item comprimento de registro de outros tipos de registros. Um erro de conversão ocorre e o programa termina se o registro de comprimento variável terminar no meio de um campo numérico ou de um caractere DBCS.

direção ('R' ou 'L')
Um literal caractere opcional identificando a direção da conversão. Se você especificar 'R', os dados são reconhecidos como formato remoto e são convertidos para o formato local. Se você especificar 'L', os dados são reconhecidos como formato local e são convertidos para o formato remoto definido na tabela de conversão. 'R' é o padrão. O 'R' e o 'L' devem ser envolvidos por aspas.

A direção é necessária quando se especifica conversion_table.

conversion_table
Um item de dados de 8 caracteres opcional ou literal especificando o nome da tabela de conversão que você deseja usar para a conversão de dados. O padrão é a tabela de conversão associada ao código nacional do idioma especificado quando o programa foi gerado.

Considerações sobre Definição

Pode-se usar a tabela de ligação para pedir que a conversão automática de dados seja gerada para chamadas remotas, para pedidos de CREATX e para pedidos de E/S de arquivo.

A conversão automática é sempre feita com a estrutura de dados definida para o argumento que está sendo convertido. Não solicite conversão automática se houver argumento com vários formatos. Nesse caso, codifique o programa de modo a chamar explicitamente EZECONV com definições de registro redefinidas que mapeiam corretamente os valores atuais do argumento.

Mais informações a esse respeito podem ser encontradas na seção que trata da conversão de dados no documento Design Guide.

Ambientes de Destino

Ambiente Considerações de compatibilidade
VM CMS Nenhum.
VM batch Nenhum.
CICS para MVS/ESA Nenhum.
MVS/TSO Nenhum.
MVS batch Nenhum.
IMS/VS Nenhum.
IMS BMP Nenhum.
CICS para VSE Nenhum.
VSE batch Nenhum.
CICS para OS/2 Nenhum.
OS/400 Não suportado.
OS/2 (GUI) Não suportado.
Windows (GUI) Não suportado.
Java (GUI) Não suportado.
OS/2 (C++) Nenhum.
AIX Nenhum.
HP-UX Nenhum.
CICS for AIX Nenhum.
Solaris Suportado.
CICS para Solaris Suportado.
Windows NT Nenhum.
CICS para Windows NT Nenhum.
Dispositivo de Teste Nenhum.

Exemplo de

No exemplo a seguir, MY_RECORD é definido como um registro VisualAge Generator e MY_CONV_TABLE é um item de dados de caracteres de 8 bytes que cotém o nome da tabela de conversão.

EZECONV(MY_RECORD,'L',MY_CONV_TABLE);


[ Início da Página | Página Anterior | Próxima Página | Índice ]