Suporte Técnico / Departamento de Operações
Rio de Janeiro, 23 de dezembro de 1996
Documento: 17
Utilitário %HOS (Documentação técnica - Manipula arquivos do hospedeiro)

Objetivo

Manipular um arquivo do sistema operacional hospedeiro.

Chamada 1

W $$A^%HOS(Arquivo,Operacao[,Modo,Flags])

Arquivo

Nome completo do arquivo incluindo o diretório. Este parâmetro deve ter no máximo 50 caracteres.

Operação
L - Abre somente para leitura (o arquivo deve existir).
LG - Abre para leitura e gravação perdendo o conteúdo anterior, se houver.
G - Abre para leitura e gravação apenas se o arquivo não existir.

Modo
T - Modo texto (default)
B - Modo binário

Resultado
0 - Todos os dispositivos da classe 7 estão ocupados.
1 - Tudo OK
Erro - String explicando o erro com no máximo de 79 caracteres. Se o erro for desconhecido será devolvido o string "Erro status: MAJOR,MINOR".

Variáveis de saída
%D7 - O número do dispositivo da classe 7 que foi alocado.
% - Em caso de erro será informado o status no formato "Major/Minor".

Sugestão

Chame o utilitário "C^%DEFAULT" para fechar o arquivo ao término do processamento.

Flags

1º - Se ligado, tenta alocar outro dispositivo da classe 7 mesmo que o processo já seja dono de algum. Caso não consiga, o resultado será 0.

Chamada 2

W $$D^%HOS(Diretório)

Diretório

Nome completo do diretório. Este parâmetro deve ter no máximo 42 caracteres.

Operação

Gera o arquivo %hos.sm , dentro do diretório hospedeiro mencionado, com uma listagem dos nomes dos arquivos presentes no próprio diretório e ao final, abre o arquivo para leitura.

Resultado
0 - Dispositivos da classe 7 ocupados.
1 - Tudo OK (O arquivo %hos.sm foi criado e aberto para leitura).
Erro - String explicando o erro ocorrido quando se tentou criar o arquivo %hos.sm.

Variáveis de saída
%D7 - Contem o nome completo do arquivo %hos.sm, no caso de erro ou se tudo correu bem, o número do dispositivo da classe 7 que foi alocado para leitura.
% - Em caso de erro será informado o status no formato "Major/Minor".

Chamada 3

D lista^%HOS

Operação

Verifica se o ZH esta' funcionando, fazendo ZH " ".

Variável de saída
%listahos - O número "1" no caso de não ter havido qualquer problema ou um string explicando o erro com no máximo de 79 caracteres. Se o erro for desconhecido será devolvido o string "Erro status: MAJOR,MINOR".

Observação

Este utilitário faz uso do novo comando ztrap.