
 ---------------------------------------------------------------------------

                                TransNet 2.10

                   "The Ultimate Internet/Fidonet Gateway"


                   Copyright (C) 1996-98 por Marc S. Ressl
                        Todos los derechos reservados.



                            - MANUAL DEL USUARIO -

 ---------------------------------------------------------------------------



                                  * INDICE *



  Contenido                                                    Seccin
 ---------------------------------------------------------------------------

  General

        Introduccin..........................................    1
        Configurar TransNet...................................    2

  Caractersticas para Internet

        El servidor de listas de correo.......................    3
        El servidor de archivos...............................    4

  Caractersticas para Fidonet

        El gateway de netmail/email...........................    5
        Enlazando echomail con listas de correo...............    6
        Enlazando listas hosteadas localmente a echomail......    7
        Sistema de enlace de Fidonet via Internet.............    8
        Soporte para BBS's....................................    9
        Modo de usuario nico.................................   10

  Otras caractersticas

        El sistema de seguridad...............................   11
        El servicio de 'templates'............................   12
        El servicio de aliases................................   13

  Ms informacin

        Glosario..............................................   14
        Informacin tcnica...................................   15
        Contacto con el autor.................................   16
        Asuntos legales.......................................   17
        Registrate!..........................................   18
        Agradecimientos.......................................   19



 Introduccin                                                     Seccin 1
 ---------------------------------------------------------------------------

 Bienvenido a TransNet!
 =======================

 TransNet es un verstil programa de mail que posee utilidades tanto para
 usuarios de Internet como de Fidonet. El mejor orden a seguir para
 configurar Transnet es comenzar con esta introduccin, luego seguir con
 la seccin "Configurar TransNet" y por ltimo leer las secciones con
 los servicios que utilizar.

 Estas son las caractersticas de TransNet:

  - Para usuarios de Internet y Fidonet:
        * Hosteo de listas de correo (mailing lists)
        * Servidor de archivos (Filebot)
        * Sistema de seguridad
        * Soporte de 'templates'
        * Soporte de aliases

  - Para usuarios de Fidonet nicamente:
        * Enlazar email a netmail
        * Enlazar listas de correo a echomail
        * Enlazar listas de correo hosteadas localmente a echomail
        * Enlazar sistemas Fidonet via email
        * Soporte para BBS's de Fidonet
        * Compatible con formatos FrontDoor y Binkley
        * Soporte de dominios de Fidonet


 Requerimientos
 ==============

 Para funcionar, TransNet solo necesita una cuenta de email. Para que
 TransNet pueda recibir/enviar los mensajes de email necesitar las
 "TransNet Mail Utilities" (utilidades de correo de TransNet), o cualquier
 programa de mail con soporte del estndar de UNIX .TXT/.WRK. Si usa
 TransNet bajo UNIX en una ventana DOS, puede usar directamente los
 directorios de correo de UNIX.

 Esta cuenta de email debe ser dedicada, porque otros programas de correo
 podran retener los mensajes destinados al TransNet.


 Como funciona
 =============

 Email de Internet: Dado que TransNet est diseado para trabajar con una
 nica cuenta de correo, requiere de una palabra clave en la lnea de
 subject (tema) de los mensajes para reconocer el servicio solicitado.

 A continuacin de esta palabra clave puede ir el subject verdadero del
 mensaje (separado por al menos un espacio).

 TransNet incluye estas palabras claves estndar:

      HELP          Responde con un mensaje de ayuda.
      SYSOP         Enva el mensaje al operador del sistema.
      MAILMAN       Accede al administrador de listas de correo.

      SYSTEM        Usado internamente para el ruteo de correo.
      USER          Usado para el soporte de BBS's.


 Correo de Fidonet: La parte de FidoNet funciona de una manera similar,
 siendo reconocidas estas palabras claves en el destinatario y el tema:

      HELP          Responde con un mensaje de ayuda.
      SYSOP         Enva el mensaje al operador del sistema.


 Notas para usuarios de FidoNet
 ==============================

 Es recomendable configurar al gateway como nodo o point dedicado para
 TransNet, porque sino netmails enviados a su sistema sern tomados como
 mensajes destinados a TransNet.

 Sin embargo, si planea usar solo los siguientes servicios, puede utilizar
 el modo de usuario nico, y solo necesitar una direccin Fidonet:

        * Enlace email/netmail
        * Enlace de sistemas Fidonet via Internet


 En cuanto al funcionamiento de reas de echomail, Transnet crea paquetes
 en el directorio de entrada del mailer (Mailer Inbound dir) a la direccin
 del destinatario de paquetes (Packet destination address).

 Para enlazar reas de echomail con TransNet, debe modificar las siguientes
 opciones en su procesador de correo (mail tosser): Agregar el nodo del
 gateway a los links, y agregar las reas que sern conectadas va TransNet
 al nodo del gateway. El password de paquetes deber ser vaco (si el mail
 tosser soporta passwords), y el tosser deber generar archivos estndar
 .PKT. No use compresin (por ej. ARC, ZIP, etc.), debido a que TransNet no
 reconoce estos archivos.



 Configurar TransNet                                              Seccin 2
 ---------------------------------------------------------------------------

 Esta es una breve explicacin de como configurarlo:

 1) Configure la cuenta de correo.

 Si usa las "TransNet Mail Utilities", lea los documentos includos para
 configurar su cuenta de correo.

 Desde ahora se asume que ya cre los directorios de entrada/salida de
 correo Internet.

 2) Ejecute TNSETUP. Defina el nombre de su organizacin y la zona horaria,
 la direccin Internet de TransNet, y los directorios de correo
 correspondiente.

 Donde dice 'Sysop address' se pone la direccin del operador del sistema.
 Ac puede ponerse tanto una direccin email como Fidonet.

 3) Salte al punto 4) si no tiene Fidonet.

 Configure la direccin de Fidonet para TransNet, y elija el tipo de
 estndar de mailer (FrontDoor/Binkley). Ahora presiona 'Setup' y pulse F1
 para ms ayuda sobre dichos seteos.

 4) Lea las secciones con las caractersticas de TransNet que desee
 utilizar.

 5) Una vez configurado, puede ejecutar TransNet con estos parmetros:

    /internet   Procesa los mensajes de Internet.
    /fidonet    Procesa los mensajes de Fidonet.

    Si usted no tiene Fidonet, debe usar solo el parmetro /internet.

    Es aconsejable crear un archivo batch que busque el correo, ejecute
    TransNet y luego envie el correo resultante.

    Sugerencia: Hay un ejemplo de un archivo batch en las
    "TransNet Mail Utilities".



 El servidor de listas de correo                                  Seccin 3
 ---------------------------------------------------------------------------

 El servidor de listas de correo redistribuye los mensajes entrantes a los
 usuarios suscriptos.

 TransNet tiene un administrador de listas de correo llamado MAILMAN, que
 es usado para la suscripcin. Para usarlo, los usuarios deben mandar un
 mensaje a la direccin del gateway, y poner en el subject la palabra
 MAILMAN. Los comandos deben ser puestos en el cuerpo del mensaje.

 Los comandos son:

        lists
            Retorna una lista de listas de correo activas.

        subscribe <lista> [<address>]
            Lo suscribe a Ud. (o a <address>) a <lista>.

        unsubscribe <lista> [address]
            Lo borra a Ud. (o a <address>) de <lista>.

        which [<address>]
            Devuelve en que listas esta Ud. (o <address>).

        who <lista>
            Informa quienes estan en <lista>.

        info <lista>
            Devuelve informacion introductoria de <lista>.

        end
            Termina el procesamiento de comandos.
            (Si su programa de correo agrega firmas)

 Para dejar un mensaje en una lista, los usuarios mandan un mensaje a
 la direccin del gateway y ponen en el subject el nombre de la lista,
 seguido opcionalmente del subject verdadero.


 Para crear una lista de correo edite el archivo TNROUTE.CFG dentro del
 directorio del TransNet.

 Agregue una lnea HOST por cada lista que desee crear. Al final del
 archivo TNROUTE.CFG encontrar una descripcin completa de las opciones
 del comando HOST.

 Sugerencia: Puede administrar las listas manualmente, editando los
 archivos de configuracin de dichas listas. Cada lnea corresponde a
 un usuario suscripto.



 El servidor de archivos                                          Seccin 4
 ---------------------------------------------------------------------------

 El servidor de archivos (Filebot) reacciona ante una palabra clave en el
 subject, y responde el pedido con archivos attacheados.


 El mismo es configurado en el archivo TNROUTE.CFG, agregando una lnea
 FILE para cada paquete de archivos. Hay una descripcin completa del
 comando FILE en el final del archivo TNROUTE.CFG.



 El gateway de netmail/email                                      Seccin 5
 ---------------------------------------------------------------------------

 El gateway de netmail/email reacciona a direcciones de Fidonet vlidas en
 la palabra clave del subject, y reenva el mensaje a Fidonet. Se puede
 colocar un subject normal a continuacin de la direccin.

 Para enviar emails, los usuarios de Fidonet tienen que mandar mensajes a
 la direccin Fidonet del gateway y especificar la direccin de Internet:

 1) en el campo "To:" directamente, o
 2) poniento "To:" en la primera lnea del mensaje, seguido de la direccin.

 Este segundo mtodo se implement, debido a que el campo "To:" de FidoNet
 est limitado a 35 caracteres.


 Para habilitar el gateway de netmail/email no se requiere ninguna
 configuracin adicional.

 Para desactivar el gateway, lea la seccin correspondiente a seguridad.



 Enlazando echomail con listas de correo                          Seccin 6
 ---------------------------------------------------------------------------

 El enlace entre echomail y listas de correo analiza los emails entrantes
 por condiciones (que se pueden definir para los campos "From:", "To:",
 "Subject:" y/o "Reply:"), y los importa luego a echomail.

 Tambin exporta el echomail a las listas de correo.

 Para hacerlo funcionar configure su procesador de correo como lo explica
 la introduccin de este manual.

 Para crear un enlace edite el archivo TNROUTE.CFG del directorio TransNet.

 Agregue una lnea LIST por cada enlace que desee realizar. Puede encontrar
 una descripcin completa de este comando al final del archivo TNROUTE.CFG.



 Enlazando listas hosteadas localmente a echomail                 Seccin 7
 ---------------------------------------------------------------------------

 Busque la lnea HOST del servidor de lista de correo en el archivo
 TNROUTE.CFG, y agregue el parmetro AREA para enlazarla a echomail.

 Recuerde preparar su procesador de correo como lo explica la introduccin
 de este documento.



 Sistema de enlace de Fidonet via Internet                        Seccin 8
 ---------------------------------------------------------------------------

 El sistema de enlace permite conectar dos sistemas Fidonet via email.


 Se configura editando el archivo TNROUTE.CFG, y agregando una lnea LINK
 por cada enlace que se quiera realizar. El comando LINK est explicado
 detalladamente al final del archivo TNROUTE.CFG.


 Esta versin shareware limita el nmero de conecciones a tres.



 Soporte para BBS's                                               Seccin 9
 ---------------------------------------------------------------------------

 TransNet est preparado para integrarse con BBS's.

 Para configurar el gateway de email/netmail y/o el enlace de listas de
 correo/echomail siga las explicaciones de las secciones anteriores.

 TransNet tiene una palabra clave especial USER para que usuarios de
 BBS's puedan recibir emails. Los usuarios de Internet deben poner esta
 palabra clave en el subject, seguido el nombre del destinatario (usuario
 del BBS). De esta forma el campo "To:" del netmail ser el correcto.

 Para que funcione, la direccin de destino de paquetes (Packet destination
 address) debe ser la misma que la del BBS.



 Modo de usuario nico                                           Seccin 10
 ---------------------------------------------------------------------------

 El modo de usuario nico fue realizado para los usuarios de Fidonet que
 solo desean recibir/enviar email, y/o usar el sistema de enlace de Fidonet
 via Internet.


 Este modo puede ser habilitado en la seccin de configuracin Fidonet en
 el TNSETUP.

 Para este modo la direccin del operador (Sysop address) debe ser la misma
 que su direccin principal de Fidonet. La direccin Fidonet del gateway
 es ignorada en este modo, y por lo tanto no necesaria.

 Para escribir emails enve un mensaje a su propia direccin de Fidonet, y
 ponga el destinatario en el campo "To:". El mtodo alternativo "To:" en el
 cuerpo del mensaje tambin funciona, y est explicado en la introduccin.
 Aviso: Los mensajes deben tener el flag LOCAL activo.

 Sugerencia: Si usted define el directorio "File Attach Inbound directory"
 en el TNSETUP, los archivos que se le enven sern decodificados en este
 directorio.



 El sistema de seguridad                                         Seccin 11
 ---------------------------------------------------------------------------

 Este sistema permite controlar el acceso a los servicios del gateway.


 Para configurar el sistema de seguridad, edite el archivo TNSECURE.CFG.
 Encontrar una descripcin de este archivo al final del mismo.


 Notas: si tiene activo el gateway de netmail/email, no deber habilitar el
 acceso a servidores de listas de correo o robots, porque los mensajes
 creados por estos sistemas no tendrn una palabra clave vlida en el
 subject. Pero si como operador desea por ej. suscribirse a una lista, no
 lo podr.

 La solucin a este problema es el modo operador (Modo SYSOP): Para
 usarlo debe definir un AKA en su editor de mensajes igual a la direccin
 del gateway, y escribir desde esta direccin. En este caso el sistema de
 seguridad ser ignorado, y no se usarn 'templates'. Aviso: Los mensajes
 deben tener el flag LOCAL activo.



 El servicio de 'templates'                                      Seccin 12
 ---------------------------------------------------------------------------

 Los templates definen el formato de los mensajes manipulados por el
 gateway (Mensaje redistribuidos por el servidor de listas de correo no
 tienen formato).


 El archivo responsable de esto es TRANSNET.TPL y se encuentra en el
 mismo directorio de TransNet.

 Cada entrada de este archivo debe empezar con alguno de estos cdigos:

                    #importmail                 #importlist
                    #exportmail                 #exportlist

                    #importhelp                 #importerror
                    #exporthelp                 #exporterror

 El prefijo "import" es el template usado cuando cuando los mensajes van de
 Internet a Fidonet, "export" es el inverso.

 El sufijo "mail" es para correo privado, "list" para listas de correo,
 "help" para la ayuda, y "error" para respuestas de error.


 Estas claves son usados para personalizar los mensajes de error:

  #errorkeyword -> Palabra clave invalida en la lnea de subject.
  #errorinvdest -> El destinatario es invlido.
  #errorsecfrom -> No esta autorizado para usar este sistema.
  #errorsecdest -> El destinatario no esta autorizado en este sistema.
  #errornosysop -> El operador de sistema no recibe mensajes.
  #errornotsubs -> No esta suscrito a esa lista de correo.


 Y estas claves pueden ser usadas despues de los cdigos de tipo de
 template:

                #organization           Organizacin.
                #fidogate               La direccin Fidonet del gateway.
                #emailgate              La direccin email del gateway.

                #error                  El error producido.
                                        (solo en los templates "error")

                #fromuser               El emisor del mensaje.
                                        (direccin + nombre de usuario)
                #fromaddress            La direccin del emisor.
                #fromname               El nombre del emisor.

                #touser                 El destinatario.
                                        (direccin + nombre de usuario)
                #toaddress              La direccin del destinatario.
                #toname                 El nombre del destinatario.

                #date                   Fecha/hora.
                #subject                El tema del mensaje.

 La clave "#message" se refiere al mensaje original. Esta clave debe ser
 puesta inmediatamente despues de un cdigo de tipo de template.

 Para poner un signo #, use ##.



 El servicio de aliases                                          Seccin 13
 ---------------------------------------------------------------------------

 La funcin de los aliases es reemplazar palabras clave por otras (ms
 sencillas).


 Para definir aliases, edite el archivo TNALIAS.CFG, y lea las instrucciones
 al final de dicho archivo.


 Sugerencias:

 - Puede definir aliases para listas de correo. La definicin del alias
   debe ser el nombre real de la lista de correo.
 - Puede temporariamente deshabilitar un servicio de TransNet, definiendo
   un alias vaco.
 - Puede usar aliases para las palabras clave estndar SYSOP y HELP, y
   renombrarlas por ej. OPERADOR y AYUDA.



 Glosario                                                        Seccin 14
 ---------------------------------------------------------------------------

 AKA:           Also Known As: este es un trmino de Fidonet, y se refiere
                a direcciones alternativas de Fidonet, sin contar la
                direccin primaria. Se pueden tener varios AKA's.

 BBS:           Bulletin Board System. Sistema de computacin pblico con
                una base de mensajes y de archivos disponibles.

 Bot:           Un programa RoBot. Automatiza tareas.

 Echomail:      Grupos de discusin de Fidonet donde la gente con intereses
                semejantes puede intercambiar mensajes.

 Email:         Mensaje de Internet (privado).

 Email,
 direcciones:   Tienen esta forma: USUARIO@DOMINIO

                El USUARIO es el ... usuario :). DOMINIO es el sistema donde
                est la cuenta de correo.

 Fidonet:       Una de las redes ms grandes de mensajera amateur del mundo.

 Fidonet,
 direcciones:   Tienen esta forma: ZONA:NET/NODO.POINT@DOMINIO

                ZONA establece el continente, NET la regin (primero el
                nmero de pas, luego estado y por ltimo ciudad), y el
                NODO del usuario. El .POINT es opcional, y especifica
                usuarios que dependen de un nodo.

                El DOMINIO especifica la red a la que la direccin se
                refiere (por ej. Fidonet tiene el dominio fidonet.org).

 Mailer:        Programa que transfiere correo.

 Mailing lists: Grupos de discusiones basados en email.

 Netmail:       Estos son los mensajes privados de Fidonet (semejantes a
                emails de Internet).

 Nodo:          Un sistema interconectado de Fidonet.

 Packet:        Un archivo con un conjunto de mensajes.

 Point:         Un sistema terminal de Fidonet.

 POP3:          Protocolo de Internet para recibir emails.

 SMTP:          Protocolo de Internet para enviar emails.

 Tosser:        Programa para la redistribucin de correo Fidonet.



 Informacin tcnica                                             Seccin 15
 ---------------------------------------------------------------------------

 Mensajes y ruteos
 =================

 - A los emails enviados desde Fidonet se les agrega la direccin Fidonet
 del emisor en la lnea de subject, de modo que las respuestas tendrn el
 subject correcto. Las excepciones son el modo SYSOP y el modo de usuario
 nico.

 - TransNet reconoce correctamente el caso especial en que un usuario de
 TransNet enva un email a otro usuario de TransNet; el emisor simplemente
 completa la lnea de subject como si estuviese en Internet.

 - TransNet tambin chequea e ignora los subjects que comienzan con "Re:" y
 "Rv:" agregados por la mayora de los programas de email.

 - TransNet reenva en forma correcta las respuestas de error de Internet
 usando una lnea especial llamada "X-TransNet-Errors-To". El soporte
 de respuestas de error de FidoNet no est disponible, dado que no hay un
 estndar.

 - El mximo tamao de mensajes es de 64000 caracteres. Mensajes ms largos
 sern cortados.

 - El operador de TransNet puede recibir archivos attacheados, que sern
 guardados en el directorio "File attach inbound directory". Este servicio
 no est disponible para los otros usuarios, por razones de seguridad.

 - TransNet reconoce file-attaches de Fidonet a Internet. Los archivos son
 enviados en MIME/BASE64.


 Miscelneas
 ===========

 - TransNet considera todos los directorios especificados en relacin al
 directorio TransNet (donde est el archivo TRANSNET.EXE).


 Compatibilidad
 ==============

 - TransNet es compatible con RFC 822, RFC 1341, RFC 1521, RFC 1522,
 FSC-0001, FSC-0035, FSC-0041. El formato MIME y Rich-Text es totalmente
 soportado.

 - TransNet soporta los estndares FrontDoor (dinmico: los paquetes
 salientes son netmails con attaches) y Binkley (esttico: los paquetes
 salientes tienen un archivo/carpeta dedicado para cada link).

 - El programa fue probado con los siguientes tossers de Fidonet: I-Mail,
 FastEcho.

 - Juegos de caracteres soportados son: estndar US-ASCII, ISO-8859-1
 internacional, y el estndar MS-DOS. Las tablas de caracteres son
 automticamente convertidas. Los emails creados por TransNet estn en la
 forma quoted-printable.

 - TransNet usa el formato de UNIX .TXT/.WRK para guardar los emails.

 Cada email est compuesto por dos archivos de nombres idnticos, pero de
 extension .TXT y .WRK respectivamente.

 Los archivos .WRK son archivos de texto con el siguiente formato:

        Primera lnea    :  El servidor de destino.
        Segunda lnea    :  El email emisor del mensaje.
        Las dems lneas :  La(s) direccion(es) destinatario del mensaje.

 Los archivos .TXT contienen el mensaje crudo.



 Contacto con el autor                                           Seccin 16
 ---------------------------------------------------------------------------

 Me puede encontrar ac:

        ressl@interactive.com.ar
        ressl@geocities.com

 Tambien puede visitar la pgina oficial de TransNet en Internet:

        http://www.geocities.com/SiliconValley/Lakes/2382/transnet.html



 Finalmente, puede anotarse en la lista de correo de novedades de TransNet:

        transnet@geocities.com

 - Para suscribirse a la lista, ponga en el subject del mensaje:

        MAILMAN

 - y en el cuerpo del mensaje:

        SUBSCRIBE TRANSNET

 - la suscripcin es probablemente ruteada a otro email, por lo que por
   favor NO escriba a transnet@geocities.com para dejar un mensaje en
   la lista.



 Asuntos legales                                                 Section 17
 ---------------------------------------------------------------------------

 TransNet es shareware lo que significa que puede ser usado legalmente
 por 30 das sin cargo para evaluacin. Si durante, o pasado este perodo
 decide seguir usndolo, por favor registre su copia. Su registracin le
 dar una licencia para usar su copia personalizada de TransNet, soportar
 la actualizacin del progama, y lo proveer con soporte tcnico via email.

 Por favor, lea "Registrate!" para registrarse.

 TransNet puede ser libremente distribuido sujeto, pero no limitado, a
 los siguientes trminos: TransNet no se podr vender ni revender, ser
 distribuido como parte de cualquier paquete comercial, usado en entidades
 comerciales, usado o distribuido como soporte de un servicio comercial,
 o usado o distribuido soportando cualquier tipo de actividad lucrativa,
 pese a que es distribuido gratuitamente.

 Si desea distribuir TransNet como parte de un archivo shareware, en
 revistas, libros de Internet, CD-ROM, etc., por favor contcteme para
 pedir permiso.

 Todos los intereses comerciales de TransNet deben dirigirse a:
 ressl@interactive.com.ar, o ressl@geocities.com

 La integridad del archivo de distribucin original de TransNet tal cual
 distribuido por parte de Marc S. Ressl es esencial. TransNet y todos sus
 archivos deben ser distribuidos conjuntamente en el formato original.
 El archivo de distribucin de TransNet no podr tener archivos agregados
 ni eliminados, y ninguno de los archivos pueden ser modificados o
 descompilados, o ingenieriados en reversa.

 Transnet se provee sin ninguna garanta de ninguna ndole, expresa o
 mplicita.  Bajo ninguna instancia Marc S. Ressl se hace responsable de
 cualquier tipo de dao, incluyendo directo, indirecto, intencional,
 consecuente, por prdidas de ganancias, o por daos especiales, a pesar
 que Marc S. Ressl advierte acerca de la posibilidad de estos daos.



 Registrate!                                                    Seccin 18
 ---------------------------------------------------------------------------

 TransNet es shareware. Si contina usndolo luego de un perodo de 30
 das, debe pagar la registracin.

 La registracin es de 40 US $.

 Para registrarse, enve un mensaje a:

        ressl@interactive.com.ar
        ressl@geocities.com

 Se aceptan cheques o depsitos en banco.


                          Gracias por registrarse!


 Nota: Los usuarios registrados al TransNet 1.x pueden recibir
       TransNet 2.1 por un cargo de actualizacin de 10 US $.



 Agradecimientos                                                 Seccin 19
 ---------------------------------------------------------------------------

 Muchas gracias a Manuel Adorni [adorni@usa.net] por traducir la mayora
 de la documentacin al castellano!!!

 Y tambin agradecimientos a toda la gente que soport el programa,
 mandandome bug-reports y demas yerbas!

 Marc S. Ressl



 --------------------------------------------------------------------------
