.PL66
.MB6
.PO0
.HE                                                TRNTXT-TRANSTEXTO Generico.

1. Introducao

Nos ultimos anos,  a crescente utilizacao de microcomputadores a nivel pessoal 
e  a  nivel  de  empresa  dos mais variados  setores  tem  gerado  uma  grande 
necessidade  de tornar viavel a transferencia de informacao entre os  diversos 
equipamentos.

Sensibilizada  por  essa  demanda,  a TELEMIG empenhou-se  em  desenvolver  um 
servico  de  baixo  custo,  facil  utilizacao  e  confiavel  para  permitir  a 
transferencia  de  arquivos entre os usuarios de microcomputadores de forma  a 
atender as necessidades especificas de cada usuario.

O  resultado deste desenvolvimento e' o SERVICO TRANSTEXTO que  possibilita  a 
transferencia   de   arquivos   texto   e  binario  entre   um   conjunto   de 
microcomputadores de fabricacao nacional usando linha discada.  Alem disso,  o 
servico  fornece  a possibilidade de conexao entre dois  micros  remotos  para 
dialogo entre os usuarios.

Nesta  primeira fase,  o SERVICO TRANSTEXTO esta' disponivel para os seguintes 
sistemas:
          .CP-500 Prologica sob CP/M
          .DGT-100 e DGT-1000 Digitus sob CP/M
          .uC-200 Scopus sob CP/M
          .QI-800 Quartzil sob CP/M
          .NEXUS-1600 Scopus sob SISNE, MS/DOS e PC/DOS
          .UNITRON sob APPLE DOS 3.3

Tendo  em  vista o objetivo "Baixo Custo" e a disponibilidade  de  um  servico 
telefonico  eficiente e confiavel,  a TELEMIG oferece o SERVICO TRANSTEXTO nas 
seguintes condicoes:
          .o  hardware do microcomputador deve dispor de uma interface  serial            
           RS-232.
          .a  ligacao e' feita atraves de linha discada utilizando modem  1200            
           half-duplex ou 300 full-duplex.
          .o  software  do SERVICO TRANSTEXTO e'  fornecido  gratuitamente  ao            
           usuario em um diskette juntamente com o manual de utilizacao.

A  maioria  dos  micros nacionais ja' inclue na sua  configuracao  basica  uma 
interface serial RS-232. Caso seu sistema nao disponha ainda da interface, ela 
pode  ser  adquirida do fabricante.  A TELEMIG tem disponivel para locacao  os 
modems acima especificados. 

O software do SERVICO TRANSTEXTO foi baseado no protocolo de transferencia  de 
arquivos  TRNTXT desenvolvido pela Universidade de Columbia (CUCCA),  nos EUA. 
Este software e' de dominio publico e distribuido pelo CUCCA,  nao podendo ser 
comercializado. As adaptacoes, modificacoes e extensoes realizadas no programa 
TRNTXT,  para atender as necessidades do SERVICO TRANSTEXTO e do hardware  dos 
microcomputadores nacionais, foram realizdas por uma equipe do Departamento de 
Ciencia  da  Computacao da Universidade Federal de Minas  Gerais,  atraves  de 
convenio com a TELEMIG.

Para  utilizacao do SERVICO TRANSTEXTO o custo para o usuario sera' somente  o 
do  trafego  telefonico utilizado.  Este software nao pode ser  comercializado 
pelo  usuario.  No entanto,  a copia do software bem como sua  divulgacao  sao 
permitidas.

2. Como Utilizar o SERVICO TRANSTEXTO

2.1 Procedimentos Operacionais

Para   utilizar  o  SERVICO  TRANSTEXTO  devem  ser  observados  os  seguintes 
procedimentos:
          a. conectar o computador ao modem
          b. conectar o modem a linha telefonica
          c. colocar o diskette do SERVICO TRANSTEXTO no drive corrente
          d. ligar o modem e a chave para telefone
          e. discar o numero do telefone do usuario remoto
          f. combinar com o usuario remoto o tipo de operacao
          g. comutar de telefone para modem
          h. executar o programa TRNTXT     
          i. consultar no manual os comandos para a transacao desejada

Observacoes Importantes:
          .o  modem normalmente utilizado no SERVICO TRANSTEXTO opera no  modo 
           half-duplex com velocidade de 1200 bps;  tambem pode ser  utilizado 
           modem  full-duplex  a 300 bps;  portanto,  antes de  estabelecer  a 
           comunicacao   verifique   se   os  dois  modems   tem   as   mesmas 
           caracteristicas
          .ao final da conversacao (item f) lembre o usuario remoto de comutar 
           de telefone para modem

2.2 O Programa TRNTXT

O  software oferecido neste servico e',  provavelmente,  a maneira mais barata 
para  se  fazer uma comunicacao entre dois computadores.  O  hardware  exigido 
normalmente ja' esta' disponivel,  o software e' gratis e e' executado como se 
fosse um software de aplicacao, sem modificacoes do sistema.

Este  programa  possue um conjunto de regras  para  transmitir  confiavelmente 
arquivos e estabelecer comunicacao entre computadores.  Para que se estabeleca 
uma  conexao e' necessario que os dois usuarios estejam executando o  programa 
TRNTXT. Durante uma conexao, este programa preocupa-se principalmente com:
          .verificacao de erros
          .traducao de caracteres 

Para  haver  uma  transmissao  mais  confiavel  de  um  arquivo,  ele  nao  e' 
transmitido todo de uma vez,  e sim,  em pequenos pedacos chamados de pacotes. 
Cada pacote tem um formato especial que o programa TRNTXT pode entender.

Este  programa e' capaz de transmitir arquivos de caracteres,  como  programas 
fonte,  textos,  dados,  etc.  e arquivos binarios, como programs executaveis, 
composto por padroes arbitrarios de bits.  Deve-se  ressaltar  que os arquivos 
binarios, normalmente, so' tem significado para computadores do mesmo tipo.


2.3 Utilizacao do programa TRNTXT

O  programa TRNTXT permite que voce faca transferencia de arquivos entre o seu 
micro  (tratado  a seguir como LOCAL),  e um micro REMOTO,  conectado  ao  seu 
atraves  da rede telefonica publica,  conforme os  procedimentos  operacionais 
descritos no item 2.1.


Esta  secao descreve os comandos basicos,  comuns a todos os computadores  que 
possuem o programa TRNTXT. Para maiores detalhes referentes a particularidades 
de cada mirco, voce deve consultar a secao do manual especifica.

O programa TRNTXT estara' apto a receber um comando quando estiver exibindo:
TRNTXT-xx>
onde xx depende do micro que esta' sendo utilizado. Por exemplo:

TRNTXT-80>         Para micros que utilizam microprocessadores Z80 ou 8085.
TRNTXT-65>         Para  micros  compativeis com a linha APPLE e que  utilizam 
                   microprocessador 6502.

O  comando consiste de uma palavra chave,  podendo ser seguido de um  ou  dois 
campos de opcoes e sub-opcao, conforme sera' mostrado adiante.


2.3.1 Comando HELP

Este  comando  exibe na tela do seu micro os comandos disponiveis no  programa 
TRNTXT. O comando HELP e' util principalmente na fase inicial de utilizacao do 
servico, quando o usuario ainda tem pouca pratica de utilizacao do programa.

Exemplo:

TRNTXT-xx>HELP
  CONNECT  (conecta com o computador remoto)
  SET      (especifica valores para parametros do programa)
   .
   .
   .
  STATUS   (mostra o estado corrente do TRNTXT)

Alem disto, depois de qualquer um dos comandos, se voce teclar "?" (interroga
cao), sera' exibido as opcoes ou sub-opcoes validas para o comando em questao. 
Esta  facilidade  sera' mostrada adiante nos exemplos dos comandos  que  serao 
descritos nesta secao.


2.3.2 Comando SET

Para  fazer uma transmissao de arquivo ou conectar-se a um computador  remoto, 
existem diversos parametros que necessitam estar com seus valores  especifica
dos adequadamente.  O comando SET permite especificar tais parametros. Se voce 
digitar SET seguido de "?", serao exibidos na tela do seu micro, os paramentos 
que voce pode alterar. Sao eles:

BAUD:      Estabelece a velocidade de transmissao para a transacao com o micro 
           remoto.  Os valores possiveis sao 300 e 1200.  Esta informacao voce 
           pode obter teclando SET BAUD seguido de "?".

DUPLEX:    Estabelece  o modo de transmissao que sera' utilizado na transacao. 
           Pode ser Half ou Full.  Esta informacao pode ser obtida teclando-se 
           SET DUPLEX seguido de "?".

ESCAPE:    Permite  mudar  o caractere de escape,  para encerrar  uma  conexao 
           estabelecida atraves do comando CONNECT, que sera' visto adiante.

FILE-MODE: Especifica  o  tipo de arquivo que sera' transmitido  ou  recebido. 
           Pode  ser do tipo TEXT,   no qual apenas caracteres que  podem  ser 
           impressos sao transimitidos, ou do tipo BINARY, para transmissao de 
           arquivos binarios.

WARNING:   Avisa  se o nome do arquivo que esta' sendo recebido ja' existe  no 
           diretorio do seu diskette. Pode ser ON ou OFF. Com FILE WARNING ON, 
           o  programa TRNTXT acrescenta um simbolo de extensao,  ate' que nao 
           exista ambiguidade com o nome de outro arquivo, e  ai entao grava o 
           arquivo com o novo nome gerado. Se FILE WARNING esta' OFF, o arqui
           vo recebido substitui aquele com o mesmo nome ja' existente.

OBSERVACAO IMPORTANTE:

Consulte  a  parte  do manual correspondente ao seu micro  para  saber  outros 
parametros que sao especificos para o seu sistema particular.  Lembre-se que o 
uso  da "?" apos o comando,  informa as opcoes,  e o uso da "?" apos  a  opcao 
informa as sub-opcoes do comando respectivo.

Os parametros que voce pode especificar com o comando SET, ja' sao inicializa
dos pelo programa TRNTXT, com os valores mostrados a seguir:
          BAUD:      1200
          DUPLEX:    HALF
          ESCAPE:    @ ou ESC (para linha APPLE)
          FILE-MODE: TEXT
          WARNING:   ON

Voce  pode  ficar sabendo os valores dos parametros utilizando o comando  SHOW 
que sera' visto adiante nesta secao.


2.3.3 Comandos SHOW e STATUS

O  comando  SHOW mostra os valores dos parametros que  podem  ser  modificados 
atraves  do  comando SET.  Em algumas versoes,  ele se confunde com o  comando 
STATUS  que fornece o estado do programa TRNTXT.  Consulte a secao  especifica 
sobre o seu micro, para maiores detalhes dos comandos SHOW e STATUS.

Exemplo:

TRNTXT-xx>SHOW
  File mode TEXT
  Caractere de escape: @
  Velocidade de transmissao: 1200 baud
  File Warning ON
  Duplex Half

OBSERVACAO:

Para  os micros da linha APPLE e para o DGT-1000 e CP-500 sob DOS,  o  comando 
SHOW  permite  um campo de opcao,  de modo a verificar o valor  de  apenas  um 
parametro particular. Para saber as opcoes, tecle SHOW ?


2.3.4 Comando CONNECT

Alem de permitir a transmissao de arquivos do tipo texto ou binario, o progra
ma TRNTXT permite que voce conecte seu micro a um outro remoto,  ambos funcio
nando  como terminais nao inteligentes.  Para isto,  tecle o comando  CONNECT. 
Desta  forma aparecera' a mensagem [Conectado ao Computador Remoto.  Tecle  @C 
para  retornar],  na tela do seu micro.  Quando o usuario remoto tambem der  o 
comando CONNECT, os dois micros estarao conectados. O que voce digitar, apare
cera' na tela do computador remoto, e vice-versa. Com isto, pode ser estabele
cida uma "conversacao" entre os usuarios conectados.

Para  desfazer a conexao,  voce deve teclar o caractere de escape (normalmente 
@) seguido da letra C.  Tambem no nivel de conexao, voce pode solicitar infor
macao de auxilio teclando o caractere de escape seguido de "?".

Exemplo:

TRNTXT-xx>CONNECT
[Conectado ao Computador Remoto. Tecle @C para retornar]
@?
C  Fecha a conexao e retorna para o estado de comando
S  Mostra o estado da conexao
?  Esta mensagem
0  Envia um caractere "Null"


2.3.5 Comando SEND

Este  comando permite que voce envie um arquivo texto ou binario existente  no 
diretorio do diskette do seu micro,  para o computador remoto. Para isto, voce 
deve digitar:

TRNTXT-xx>SEND  <especificacao-do-arquivo>
onde  <especificacao-do-arquivo> e' um nome de arquivo valido para  o  sistema 
operacional do seu computador.

O usuario do computador remoto deve dar o comando RECEIVE para que a transmis
sao seja iniciada.

Se  o  arquivo  e' transmitido com exito,  ao final da transmissao  aparece  a 
mensagem "COMPLETADO".

Voce  pode  interromper  uma  transmissao de  arquivo  teclando  Control-X  ou 
Control-Z.  Consulte  a parte do manual relativa ao seu micro especifico  para 
maiores detalhes sobre interrupcao da transmissao.

Exemplo:

TRNTXT-xx>SEND PROG.PAS


2.3.6 Comando RECEIVE

Este comando permite receber, no micro Local, um arquivo ou conjunto de arqui
vos (dependendo do sistema),  enviado(s) pelo computador remoto atraves de  um 
comando SEND. Para isto voce deve digitar:

TRNTXT-xx>RECEIVE

Lembre-se que se o nome do arquivo enviado ja' existir,  o TRNTXT vai adotar o 
procedimento especificado pelo parametro WARNING, descrito anteriormente.


2.3.7 Comando EXIT

Este  comando provoca a saida do programa TRNTXT,  voltando o controle para  o 
sistema operacional do seu micro.


2.3.8 Consideracoes Importantes:

1) Para  facilitar o trabalho do usuario,  o programa TRNTXT permite que  voce 
   digite  apenas  as  letras iniciais de um comando ou opcao  que  nao  geram 
   ambiguidade, para que o comando seja reconhecido.

   Por  exemplo:  se voce quiser transmitir um arquivo e digitar apenas SE (as 
   duas  letras iniciais do comando SEND),  o TRNTXT nao reconhece o  comando, 
   pois existe o comando SET que tambem inicia com as letras SE.

   Por  outro lado,  basta digitar REC para que o TRNTXT reconheca  o  comando 
   RECEIVE; basta teclar C para que o comando CONNECT seja reconhecido, etc.

   Quando  voce digita apenas as primeiras letras de um comando,  e em seguida 
   pressiona a tecla <ESC>,  o TRNTXT completa o nome do comando,  se ele  nao 
   for ambiguo.

   Exemplo: Se voce teclar:

            SET BA<ESC> 12<ESC>, aparecera' na tela SET BAUD 1200

2) O programa TRNTXT emite uma serie de mensagens, que podem ser dos seguintes 
   tipos:

   -Mensagens sobre a transmissao de arquivos:
   indicam  o numero de pacotes enviados/recebidos;  indicam sucesso ou nao da 
   transmissao.
   -Mensagens de erro quando se digitar comandos nao existentes,  comandos sem 
   os campos de opcao e sub-opcao adequados, comandos ambiguos.


2.3.9 Recomendacoes para execucao do programa TRNTXT:

1) Seguir os procedimentos operacionais especificados no item 2.1.

2) Quando o programa TRNTXT entra no ar, aparece na tela
   TRNTXT-xx>

3) Voce deve dar o comando SHOW para verificar os valores dos  parametros.  Se 
   os valores estiverem de acordo com a configuracao do seu micro e a do micro 
   remoto, pode-se passar imediatamente para uma transacao de transferencia de 
   arquivos ou conexao.  Caso contrario, os parametros devem ser especificados 
   adequadamente.

   Exemplo:

   Seguindo os procedimentos operacionais, suponhamos que voce esteja ligado a 
   um micro remoto usando modem de 300 baud, full-duplex.
   Quando voce der o comando SHOW, aparecera':


   .
   .
   .
   Tipo do arquivo: Texto
   Velocidade de Transmissao: 1200 baud
   Modo de transmissao: Half-Duplex
   .
   .
   .
   TRNTXT-xx>

   Voce  devera',  entao mudar a taxa e o modo de transmissao usando os coman
   dos:

   TRNTXT-xx>SET BAUD 300
   TRNTXT-xx>SET DUPLEX FULL

   Se o comando SHOW for dado novamente, teremos:
   .
   .
   .
   Tipo do arquivo: Texto
   Velocidade de Transmissao: 300 baud
   Modo de transmissao: Full-Duplex
   .
   .
   .
   TRNTXT-xx>

   Neste  ponto,  pode  ser iniciada a transmissao ou recepcao de  um  arquivo 
   texto,  ou uma conexao entre micros funcionando como terminais,  atraves do 
   comando CONNECT.






















.HE                                          TRNTXT-86 SISNE,  PC-DOS e MS-DOS.


3. SISNE, PC-DOS e MS-DOS TRNTXT-86
    --------------------------------


     TRNTXT-86   e'   um  programa  que  implementa  o  protocolo  TRNTXT   de 
transferencia de arquivos para o Nexus e micro-computadores compatives com IBM 
PC  nos  sistemas  operacionais  Sisne,  PC-DOS e MS-DOS  (  daqui  em  diante 
chamaremos MS-DOS ), versoes 1.1, 2.0 e 2.1. Esta secao descreve tudo que voce 
deve  saber sobre o sistema de arquivos do MS-DOS para fazer uso eficiente  do 
TRNTXT, e depois sera' descrito o programa TRNTXT-86.

     O TRNTXT MS_DOS opera em uma variedade de micro-computadores  compativeis 
com  o PC da IBM.  Este documento concentra-se na implementacao IBM-PC e Nexus 
versao TELEMIG, servico TRANSTEXTO. Informacoes sobre outras instalacoes podem 
ser encontradas com maiores detalhes na documentacao original.


3.1   O sistema de arquivos do MS-DOS
      -------------------------------

     As  caracteristicas do sistema de arquivos do MS-DOS de  maior  interesse 
para  usuarios  do  TRNTXT  sao a forma de  especificacao  de  arquivos,  e  a 
distincao  entre  nomes de arquivos em versoes pre-MS-DOS 2.0 e  versoes  mais 
recentes nas quais sao permitidos "paths" de diretorios nos nomes 
de arquivos conforme pode ser visto a seguir.

3.1.1   ESPECIFICACAO DE ARQUIVOS NO MS_DOS
        -----------------------------------

Especificacoes de arquivo no MS-DOS sao da forma 

  DISPOSITIVO:\PATH\NOME.TIPO


Onde DISPOSITIVO e' um caractere identificador (ex. A para o primeiro drive, C 
para disco rigido,  ou RAM disk ),  \PATH\ e' opcional e ate' 63 caracteres de 
identificador(es)  ( ate' 8 caracteres para cada identificador ) cercados  por 
barras  invertidas  (ou  ".."  para  diretorio  pai,  ou  "."  para  diretorio 
corrente),  NOME e' o identificador do arquivo ( ate' 8 caracteres ) e o  TIPO 
com ate 3 caracteres.  DISPOSITIVO e PATH podem ser omitidos,  sendo default o 
disco e path correntes ( path="." ).  PATH e' normalmente omititido e so' pode 
ser  especificado  nas versoes MS-DOS 2.x.   Assim,  NOME.TIPO e'  normalmente 
suficiente  para especificar um arquivo,  e apenas esta informacao e'  enviada 
junto do arquivo pelo TRNTXT-86. 

     Os campos dispositivo,  path,  nome e tipo podem conter letras, digitos e 
caracteres  especiais  "-"  (menos),  "_" (underscore  ou  sublinhado)  e  "$" 
(dollar). Outros caracteres nao sao permitidos, porem,  apenas para MS-DOS.

     O  campo dispositivo especifica um dispositivo fisico ou "logico" ao qual 
o  arquivo  pertence.   Path  de  diretorio  identifica  uma  area  logica  no 
dispositivo (subdiretorio) em que esta' o arquivo. O TRNTXT-86 nao transmite a 
informacao do dispositivo ou subdiretorio para o sistema alvo (remoto),  e nem 
tenta manter as informacoes deste tipo que possam vir com os arquivos.

     O  campo  de nome e' o identificador primario para o  arquivo.   O  tipo, 
tambem chamado de "extensao", e' um identificador que, por convencao, diz qual 
e' o tipo do arquivo.  Assim,  FOO.BAS e' um arquivo fonte de um programa cujo 
nome  e'  FOO;  FOO.OBJ  deve ser um modulo objeto  relocavel  produzido  pela 
'compilacao' do programa FOO.BAS;   FOO.EXE poderia ser um programa executavel 
produzido pela ligacao (link) do arquivo FOO.OBJ e assim por diante. 

     O  MS-DOS  permite que um grupo de arquivos sejam especificados  por  uma 
unica  especificacao simples que inclui os caracteres especiais  (coringas  ou 
"wildcards")  "*"  e  "?".  Um  asterisco  (*)  "casa"  qualquer  conjunto  de 
caracteres  da posicao do mesmo ate' o fim do campo,  incluindo a ausencia  de 
caracteres;  uma  interrogacao(?) casa qualquer caractere na posicao em que e' 
colocada.  

     Aqui estao alguns exemplos:

*.BAS    Todos  os  arquivos do tipo BAS (todos fonte em Basic)  no  diretorio 
         corrente.

FOO.*    Arquivos de todo e qualquer tipo com nome FOO.

F*.*     Todos os arquivos cujos nomes comecam com F. 

F?X*.*   Todos os arquivos cujos nomes comecam com F e contem um X na terceira 
         posicao seguidos por zero ou mais caracteres.

?.*      Todos os arquivos cujos nomes sao de exatamente um caractere.
     A  notacao  de  coringas  (wildcard)  e'  usada  em  muitos  sistemas  de 
computadores de maneiras similares, e e' o mecanismo mais comumente usado para 
instruir o TRNTXT a enviar grupos de arquivos.

     TRNTXT-86 usa tambem ?  para invocar ajuda (help) em comandos;  entao o 
coringa para caracteres simples no TRNTXT e' o = em vez de ?, por exemplo:

  TRNTXT-86>send =.*


3.2   ARQUIVOS TEXTOS E ARQUIVOS BINARIOS
      -----------------------------------

     O  sistema MS-DOS armazena arquivos como uma colecao de arquivos de bytes 
de 8 bits,  sem nenhuma diferenca peculiar entre texto,  codigo de programa, e 
arquivos  binarios.  Se um sistema nao MS-DOS que vai receber arquivos do  MS-
TRNTXT e precisa distinguir os tipos de arquivos,  o usuario deve fornecer  ao 
sistema  recebedor (remoto) os diversos parametros (comandos SET,  no  remoto) 
para  informa'-lo  do  tipo  de  arquivo particular  (nao  default)  que  este 
recebera',  para  que seja gravado com os  parametros  corretos.  Transmitindo 
arquivos entre sistemas TRNTXT-86, nao importa os tipos dos arquivos.  

     Arquivos ASCII sao supostos conter caracteristicas reconheciveis (<CR> ou 
carriage  return  e <LF> ou line feed delimitando linhas,  <FF> ou  form  feed 
delimitando paginas e caracteres, control-Z delimitando fim de arquivo); porem 
qualquer  codigo  interno de bit e' transmitido.  Recebedores de  arquivos  de 
sistemas  nao  MS-DOS,  podem ficar confusos com arquivos ASCII  nao  padroes. 
Alguns  arquivos  textos produzidos por WordStar e  EASYWRITER,  por  exemplo, 
contem codigos de controle nao ASCII,  e devem sofrer,  em alguns casos, algum 
pre-processamento  antes de serem exportados para outros  sistemas.  Dados  de 
programas spreadsheet,  DBASE II,  etc, podem precisar de formatacao especial, 
em  alguns  casos,  para  serem significativos para  recebedores  nao  MS-DOS. 
(embora  possa  nao existir problemas em sistemas MS-DOS,  com  TRNTXT(s)-86). 
Tambem, processadores de palavra que armazenam dados no fim de arquivo, depois 
do  caractere control-Z e antes do fim fisico do arquivo ( assim como  BLUE  e 
Easy Writer),  devem ser informados a retirar os dados de formatacao, para nao 
confundir recebedores nao MS-DOS.  
   

3.3   Operacao do programa
      --------------------

     O prompt ( indicacao de pronto ) do TRNTXT-86 e' "TRNTXT-86>".  TRNTXT-86 
roda interativamente,  por exemplo:

  A>
  A>TRNTXT
                TELEMIG-TRANSTEXTO  TRNTXT-86 - Ver 1.20.ufmg

  TRNTXT-86>send foo.*
                         (envia grupo de arquivos com nome foo) 


     para saber informacoes sobre arquivos sendo enviados e estados do TRNTXT:

  TRNTXT-86>status

                         (varias informacoes de estado sao mostradas)

  TRNTXT-86>receive

                         (recebe arquivo(s) do remoto)

  TRNTXT-86>exit
  A>

     Durante  a operacao interativa,  voce pode usar o help ("?")  livremente, 
enquanto fornece os comandos. Palavras de comandos podem ser abreviadas para o 
seu  prefixo  mais  curto  (primeiras letras) que  as  diferenciem  de  outras 
palavras chave validas naquele campo, ou seja nao deve haver ambiguidade.


3.4   Comandos do MS-DOS TRNTXT-86
      ----------------------------

     O  MS-DOS  TRNTXT  implementa um grande subconjunto de comandos  de  modo 
local do TRNTXT "ideal".  A Versao TELEMIG-TRANSTEXTO continua com os comandos 
originais,  inclui  outros,  continuando a sintaxe em ingles,  para  manter  a 
compatibilidade com as outras versoes, que e' a filosofia do protocolo TRNTXT. 
Porem as mensagens e informacoes de help e estado estao em Portugues.


3.4.1   O COMANDO HELP
        --------------

Sintaxe: HELP

     Usado como ajuda ao usuario,  como lembretes sobre os diversos comandos e 
opcoes do TRNTXT.
     Exemplo:

TRNTXT-86>he

        CONNECT - conecta ao micro remoto
        EXIT - volta ao sistema operacional
        HELP - exibe esta mensagem
        RECEIVE - recebe arquivo do computador remoto
        SEND - envia arquivo para o computador remoto
        SET - atribui valores a parametros
        STATUS - estado corrente do TRNTXT

TRNTXT-86>
     Alem disso voce pode usar o caractere "?" (interrogacao) para obter  mais 
informacoes sobre os comandos. Note que alem de informar sobre os parametros o 
TRNTXT  ainda  re-escreve a linha com o comando esperando que voce complete  o 
mesmo com uma das opcoes mostradas...
 
     Exemplos:
     Para saber os parametros possiveis do comando SET:

TRNTXT-86>set ? 

        BACKARROW - configura a tecla de backarrow
        BAUD - estabelece a taxa de transmissao
        BELL - habilita a campainha
        DUPLEX - estabelece o modo de transmissao
        ESCAPE - define caracter de escape
        FILE-WARNING - sinaliza transferencia de arquivo
        INCOMPLETE - tratamento de arquivos incompletos
        LOCAL-ECHO - eco local 
        PARITY - define tipo de paridade

TRNTXT-86>set _

     Para saber os valores possiveis do comando SET PARITY:

TRNTXT-86>set par ?

          None    Mark    Odd    Even    Space

TRNTXT-86>set par _

3.4.2   O COMANDO SEND
        --------------

Sintaxe: SEND <arq>

     O comando SEND envia um arquivo ou grupo de arquivos do MS-DOS para outro 
sistema.  <arq> pode conter o drive:,  por exemplo A:, e os caracteres coringa 
(wildcards) "*" e/ou "=". A versao atual do TRNTXT-86 nao permite PATH no nome 
do arquivo.

     Se <arq> contem * ou = todos os arquivos que casarem com a  especificacao 
serao  enviados,  na ordem encontrada no diretorio corrente.  Se o arquivo nao 
puder ser aberto para leitura, os procedimentos padrao para recuperacao do MS-
DOS estarao disponiveis (pode ser que se precise reinicializar o TRNTXT).

Operacao geral do comando SEND

     Os  arquivos serao enviados juntamente com seus nomes e tipos  (nao  sera 
enviado nome do dispositivo nem subdiretorio).  Se voce quizer enviar arquivos 
cujos  nomes voce sabe a priori que sao ilegais no sistema alvo (remoto) e que 
o remoto nao pode fazer a conversao para seu proprio padrao,  voce pode copiar 
ou  trocar os nomes destes arquivos antes de entrar no TRNTXT ou entao  voltar 
ao  DOS  para tal.  (obs:  nao exitem tais problemas entre sistemas  MS-DOS  e 
CP/M). 

     Cada  arquio  e' enviado em pacotes,  como uma sequencia de bytes  de  8 
bits. 
     Uma  vez  dado  o comando SEND,  o nome de cada arquivo  do  grupo  sendo 
tranmitido  sera  mostrado  na sua tela;  um contador de pacotes  e  outro  de 
retransmicoes   tambem  sera'  mostrado  alem  das  mensagens  de   informacao 
apropriadas.  Se o arquivo e' transmitido com exito,  aparecera' "COMPLETADO", 
senao uma mensagem de erro sera' exibida. Quando a operacao completar soara' a 
campainha.  

 . Interrompendo um arquivo ou grupo de arquivos:

     Se voce notar um arquivo indesejado sendo transmitido voce pode  cancelar 
a  operacao  imediatamente teclando Control-X ou Control-Z.  Se  voce  estiver 
mandando  um grupo de arquivos,  Control-X causara' o cancelamento do  arquivo 
sendo transmitido no dado instante,  enquanto que Control-Z cancela o envio do 
grupo inteiro e voce retornara para o modo de comandos do TRNTXT.  Um CONTROL-
C cancela a operacao imediatamente e retorna para o nivel de comandos.


3.4.3   O COMANDO RECEIVE
        -----------------

Sintaxe: RECEIVE


     O comando receive informa o TRNTXT-86 para receber um arquivo ou grupo de 
arquivos  vindo de outro sistema.  TRNTXT simplesmente espera pela chegada  do 
arquivo.

     Se  o nome do arquivo recebido for ilegal para o MS-DOS,  TRNTXT-86  ira' 
deletar os caracteres ilegais ou em excesso.

     Se  o nome do arquivo recebido ja' existe,  e FILE-WARNING esta' ON  (ver 
comando status),  TRNTXT-86 mudara' o nome (voce sera' informado do novo nome) 
de modo a nao destruir o arquivo pre-existente.

     Se um arquivo nao e' recebido integralmente,  TRNTXT-86 ira' descarta'-lo 
normalmente.   Voce  pode  mudar  este  comportamento  usando  o  comando  SET 
INCOMPLETE KEEP, o que causara' que o maximo recebido seja gravado e mantido. 

 . Interrompendo um arquivo ou grupo de arquivos:

     Se  voce nao deseja um arquivo que esteja sendo  recebido,  voce  podera' 
cancela'-lo   teclando  Control-X.   Isto  causara'  o  envio  de  pedido   de 
cancelamento para o TRNTXT remoto. Se o TRNTXT remoto entender esta requisicao 
(esta' e' uma funcao opcional), ele atendera'; senao ele continuara' enviando. 
Se  um  grupo de arquivos  esta' sendo recebido,  voce pode pedir que o  grupo 
inteiro seja cancelado teclando Control-Z. Se voce teclar control-C retornara' 
imediatamente para o nivel de comandos ( TRNTXT-86> ).

3.4.4   O COMANDO CONNECT
        -----------------

Sintaxe: CONNECT

     Quando voce entrar no modo connect sera impressa a seguinte mensagem:

[Conectado ao computador remoto, tecle Control-] C para retornar ao Micro
        Taxa de transmissao de 1200 Baud, conectado ao porto COM1]

     O  modo  connect  estabelece a coneccao com o remoto  como  se  fosse  um 
terminal  do  mesmo,  no  porto serial correntemente selecionado  (COM1  nesta 
versao)  usando  o  tipo de eco correntemente especificado  (eco  local  e'  o 
default)  e nenhuma paridade,  a nao ser que seja previamente especificado  no 
comando  SET.  Voce podera' entao se comunicar com alguem no micro remoto  (se 
estiver no modo CONNECT). Voce pode retornar para o modo de comandos do TRNTXT 
local teclando o caractere de escape seguido da tecla C. O caractere de escape 
padrao  e'  o  Control-]  (pode-se especificar outro atravez  do  comando  set 
escape).  Quando voce tecla o caractere de escape alguns caracteres de comando 
podem ser especificados conforme abaixo: 

  ?   Help - imprime esta mensagem.
  C   Close - Encerra a coneccao.     (retorna ao modo de comandos)
  S   Status - estado da coneccao.    (imprime status do TRNTXT)
  B   Envia um Break.                 (um sinal de break e' enviado ao remoto)
  Teclando o caracter de escape este sera' enviado ao hospedeiro.

     Voce  pode  usar  o comando SET ESCAPE para definir  outro  caractere  de 
escape,  e pode usar o SET BAUD para mudar a taxa de transmissao, e em futuras 
versoes podera' usar outra linha de comunicacao alem de COM1.  (COM1 = LIN1 no 
nexus)

     O  modo connect pode tambem ser usado como terminal tty normal (burro) de 
um computador que nao possua algum tipo de protocolo de terminal.


3.4.5   O COMANDO SET
        -------------

Sintaxe: SET parametro [valor]

     Estabelece  ou modifica varios parametros para transmissao de arquivo  ou 
coneccao  de terminal.  Os parametros correntemente em vigor podem ser  vistos 
atravez do comando STATUS. Os seguintes parametros podem ser mudados:

BACKARROW       Configura  qual  o  codigo  sera' enviado  pela  linha  ao  se 
                pressionar a tecla com a seta para tras (Backarrow). Podem ser 
                enviados BACKSPACE (default) ou DELETE.

BAUD            Estabelece a taxa de comunicacao.
                Os valores podem ser 300 ou 1200 (default).

BELL            A  campainha e' normalmente tocada ao final de uma  transacao. 
                SET BELL OFF pode ser usado para silenciar a campainha.
                Os valores podem ser ON (default) ou OFF.
DUPLEX          Estabelece o modo de transmissao.
                Os  valores podem ser FULL (para modems full duplex)  ou  HALF 
                (default).

ESCAPE          Define o caractere de escape que sera' usado no modo  connect. 
                o caractere de escape padrao e' o Control-].

FILE-WARNING    Avisa  se o nome do arquivo recebido esta' ou nao em  conflito 
                com algum ja' existente,  e tenta construir um outro nome para 
                o arquivo. Se for especificado SET FILE OFF serao deletados os 
                arquivos  antigos  cujos nomes estao em conflito.  Os  valores 
                possiveis sao ON (default) ou OFF.
  

INCOMPLETE      Define   o   que  deve  ser  feito  com   arquivos   recebidos 
          ??    incompletamente:   KEEP   (mantem)  ou  DISCARD  (descarta   = 
                default).

LOCAL-ECHO      Estabelece o tipo de eco a ser usado no modo connect OFF  (eco 
                remoto) ou ON (eco local), que e' o default.

PARITY          Define  o  tipo  de  paridade de caractere  a  ser  usada  nas 
                transmissoes.  Os valores podem ser NONE (sem paridade, que e' 
                default),  ODD  (impar),   EVEN (par),  MARK (bit de  paridade 
                sempre em 1) ou SPACE (sempre em 0).



3.4.6   O COMANDO STATUS
        ----------------

Sintaxe: STATUS
         ou simplesmente ST

     Informa  o estado atual dos parametros de configuracao  do  TRNTXT.  Tais 
parametros podem ser modificados atravez do comando SET.

     Exemplo de informacoes do comando STATUS:

TRNTXT-86>st

        Eco Local on
        Usando porto de comunicacao COM1
        File Warning on
        Sem paridade
        Toca campainha ao final da transmissao
        Descarta arquivo recebido se incompleto 
        Backarrow envia backspace 
        DUPLEX half
        Caracter de fim de linha : ^M
        Caracter de escape : Control-]
        Taxa de transmissao 1200 Baud

TRNTXT-86>



o