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.