home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / jf101p.zip / JFREQ.ESP < prev    next >
Text File  |  1995-02-03  |  41KB  |  928 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                    - - - - -
  8.                                    J F R e q
  9.                                    - - - - -
  10.  
  11.  
  12.               Procesador externo de File Request para FrontDoor,
  13.       MainDoor, Intermail o mailers compatibles y Remote Access, Maximus
  14.          o cualquier sistema de BBS basado en la estructura FILES.BBS
  15.  
  16.  
  17.                   (C) 1994-95 Jordi Sesé (Fidonet 2:343/116)
  18.  
  19.  
  20.                                  versión 1.01
  21.  
  22.  
  23.  
  24.  
  25.                                    ATENCION
  26.         Este programa NO es, en modo alguno, de dominio público. Lee el
  27.           documento REGISTRO.TXT para conocer sus condiciones de uso.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                               Tabla de Contenidos
  34.  
  35.  
  36.  
  37.   1. Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  38.     1.1 ¿Qué es un procesador de File Request?  . . . . . . . . . . . . . . 1
  39.     1.2 Características de JFReq 1.01 . . . . . . . . . . . . . . . . . . . 1
  40.     1.3 Ficheros en el paquete  . . . . . . . . . . . . . . . . . . . . . . 2
  41.  
  42.   2. Instalación  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  43.     2.1 ACTUALIZACION desde la versión 1.00 . . . . . . . . . . . . . . . . 3
  44.     2.2 Notas Generales . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  45.     2.3 Sistemas Multilínea . . . . . . . . . . . . . . . . . . . . . . . . 4
  46.     2.4 Variables de entorno  . . . . . . . . . . . . . . . . . . . . . . . 4
  47.     2.5 Instalación en el Mailer  . . . . . . . . . . . . . . . . . . . . . 4
  48.       2.5.1 Configuración para MainDoor y MainDoor/2: . . . . . . . . . . . 5
  49.       2.5.2 Configuración para FrontDoor 2.1x y 2.2x  . . . . . . . . . . . 5
  50.       2.5.3 Configuración para Intermail 2.27:  . . . . . . . . . . . . . . 5
  51.     2.6 El programa de configuración  . . . . . . . . . . . . . . . . . . . 6
  52.       2.6.1 Global Options  . . . . . . . . . . . . . . . . . . . . . . . . 6
  53.       2.6.2 Time Settings . . . . . . . . . . . . . . . . . . . . . . . . . 7
  54.       2.6.3 Limits  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  55.       2.6.4 Mail Addresses  . . . . . . . . . . . . . . . . . . . . . . . . 8
  56.       2.6.5 Template Editor . . . . . . . . . . . . . . . . . . . . . . . . 8
  57.  
  58.   3. Otros datos  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  59.     3.1 Parámetros de la línea de comandos  . . . . . . . . . . . . . . . . 9
  60.     3.2 Variables utilizadas en las plantillas  . . . . . . . . . . . . . . 9
  61.     3.3 Formato de los ficheros de directorios y alias  . . . . . . . . .  11
  62.       3.3.1 fichero de directorios: . . . . . . . . . . . . . . . . . . .  11
  63.       3.3.2 lista de ALIAS: . . . . . . . . . . . . . . . . . . . . . . .  12
  64.     3.4 El compilador de nodelists  . . . . . . . . . . . . . . . . . . .  12
  65.     3.5 El compilador del índice interno  . . . . . . . . . . . . . . . .  12
  66.     3.6 El compilador de áreas de ficheros para Remote Access . . . . . .  13
  67.     3.7 Sistemas VIP  . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  68.     3.8 Peticiones especiales con mensaje incluído  . . . . . . . . . . .  13
  69.     3.9 Informes Estadísticos . . . . . . . . . . . . . . . . . . . . . .  14
  70.     3.10 Comandos del editor  . . . . . . . . . . . . . . . . . . . . . .  14
  71.     3.11 Colaboradores  . . . . . . . . . . . . . . . . . . . . . . . . .  15
  72.     3.12 Cómo contactar con el autor  . . . . . . . . . . . . . . . . . .  15
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                                        i
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.                                   Capítulo 1
  94.  
  95.                                  Introducción
  96.  
  97.  
  98.  
  99.  
  100.  
  101.   1.1 ¿Qué es un procesador de File Request?
  102.  
  103.   Hasta hace un tiempo, los mailers buscaban por  una  lista  de  directorios
  104.   aquellos  ficheros  que se les pedían en cada File Request, pudiendo tardar
  105.   poco o mucho, ya que la búsqueda era totalmente secuencial.   Ahora,  tanto
  106.   FrontDoor  (2.1x  ó  2.2x),  MainDoor (0.94) o Intermail (2.27) permiten la
  107.   ejecución instantánea de una utilidad externa que localice  rápidamente  en
  108.   los  índices  de  ficheros  de  la BBS los ficheros, generando al tiempo un
  109.   informe de respuesta o cualquier otra cosa.
  110.  
  111.   JFReq busca en los índices de las bases de ficheros  de  Maximus  o  Remote
  112.   Access,  incrementando en el último caso los contadores de download de cada
  113.   fichero pedido.  El uso de los índices ya existentes de la BBS hace que  su
  114.   instalación  sea  muy  rápida, y su mantenimiento nulo, ya que es la propia
  115.   BBS la que realiza el mantenimiento.
  116.  
  117.  
  118.   1.2 Características de JFReq 1.01
  119.  
  120.   * Versiones nativas de ejecutable para DOS y OS/2
  121.   * Soporte Multilínea
  122.   * Programa de configuración muy fácil de usar.
  123.   * Mailers soportados:   FrontDoor, MainDoor, InterMail
  124.   * BBSs e índices soportados:    Maximus (2.x), Remote Access (2.x)
  125.   * Otros BBS o Doors soportadas vía un índice propio a partir de listados
  126.     tipo FILES.BBS, con limitaciones por nivel y password.
  127.   * listado de directorios y ficheros de Alias (con o sin passwords)
  128.   * Limitaciones por cantidad de ficheros, KBytes, minutos por sesión o
  129.     día, velocidad mínima y horario
  130.   * Cuatro tipos de sesiones, protegidas (con password), sistemas
  131.     listados, sistemas no listados y happy hour (horario especial para
  132.     sesiones sin password), pudiendo definir límites para cada tipo de
  133.     sesión por separado.
  134.   * Posibilidad de comprobar la existencia de los sistemas en un índice de
  135.     nodelist propio
  136.   * Asimilación de seguridad de la sesión a un nivel de usuario en la BBS
  137.   * Limitación de acceso a sistemas non-gratos o con cadenas sospechosas
  138.   * Informe de respuesta y mensajes de error totalmente configurables
  139.     mediante plantillas
  140.   * Informes y mensajes configurables según zona y/o red del sistema que
  141.     realiza la petición
  142.   * Envío de mensajes adicionales si se pide algún fichero especial
  143.  
  144.  
  145.                                        1
  146.  
  147. Capítulo 1. Introducción                                                   2
  148.  
  149.  
  150.   * Control interno para evitar envíos duplicados en una misma sesión
  151.   * Soporta y utiliza Download Counters y Passwords en Remote Access
  152.   * Soporte automático para Download Counters en Maximus y FILES.BBS
  153.   * Buffering para archivos situados en unidades de acceso crítico
  154.     (CD-ROMs, etc.)
  155.   * Realización de informes estadísticos en pantalla o como mensaje
  156.     (Netmail o en un área de mensajes determinada)
  157.   * Soporte de sesiones especiales con sistemas VIP
  158.  
  159.  
  160.   1.3 Ficheros en el paquete
  161.  
  162.   100TO101.COM    Utilidad de actualización del fichero de configuración
  163.                   de la versión 1.00 a la 1.01 (DOS)
  164.   JFREQ.DOC       Manual de uso de JFReq 1.01 en inglés
  165.   JFREQ.ESP       Manual de uso de JFReq 1.01 en castellano
  166.   JFREQP.EXE      Ejecutable principal de JFReq para OS/2
  167.   JFRQCFGP.EXE    Versión OS/2 del programa de configuración de JFReq
  168.   JFREQ.EXE       Ejecutable principal de JFReq para DOS
  169.   JFREQCFG.COM    Versión DOS del programa de configuración de JFReq
  170.   JFNCP.EXE       Compilador de Nodelist, versión OS/2
  171.   JFNC.COM        Compilador de Nodelist, versión DOS
  172.   JFNC.CTL        Fichero de control de nodelists
  173.   JFFCP.EXE       Compilador de índice secundario de ficheros. Versión OS/2
  174.   JFFC.COM        Compilador de índice secundario de ficheros. Versión DOS
  175.   JFFC.CTL        Fichero de control para el índice secundario de ficheros
  176.   JFSTATP.EXE     Generador de informes estadísticos, versión OS/2
  177.   JFSTAT.COM      Generador de informes estadísticos, versión DOS
  178.   LDATP.EXE       Lista el contenido del fichero JFREQ.DAT (OS/2)
  179.   LDAT.COM        Lista el contenido del fichero JFREQ.DAT (DOS)
  180.   DEFAULT.FRQ     Plantilla de respuesta por defecto
  181.   *.FRQ           Plantillas de ejemplo
  182.   FNAMES.DAT      Fichero de control de peticiones de ficheros especiales
  183.   REGISTER.TXT    Información de uso y registro de JFReq. Inglés
  184.   REGISTRO.TXT    Información de uso y registro de JFReq. Castellano
  185.   UADDRESS.DAT    Fichero de control por direcciones de sistemas non-gratos
  186.   UMAILERS.DAT    Fichero de control por cadenas de sistemas non-gratos
  187.   JFREQ.CFG       Fichero de Configuración
  188.   NFRQSTAT.*      Fichero estadístico (nodos)
  189.   FFRQSTAT.*      Fichero estadístico (fichs.)
  190.   JFREQ.DAT       Fichero de datos (nodos)
  191.   JFNC.NDX        Indice de nodelists
  192.   JFFILES.IDX     Indice de ficheros secundario
  193.   JFAREA.DAT      Indice de áreas
  194.   JFREQ.VIP       Fichero de especificaciones para sesiones VIP
  195.   RAFILES.IDX     Indice de ficheros de JFREQ para áreas de RA
  196.   JFRAFC.COM      Compilador de áreas de ficheros de RA (DOS)
  197.   JFRAFCP.EXE     Compilador de áreas de ficheros de RA (OS/2)
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.                                   Capítulo 2
  205.  
  206.                                   Instalación
  207.  
  208.  
  209.  
  210.  
  211.  
  212.   2.1 ACTUALIZACION desde la versión 1.00
  213.  
  214.   a) Desempaquete el  archivo  en  el  directorio  donde  resida  JFREQ,  sin
  215.   sobreescribir los ficheros de configuración de la versión 1.00 existentes.
  216.  
  217.   b)  Ejecute  la utilidad denominada 100to101.com para actualizar el fichero
  218.   JFREQ.CFG a la versión 1.01
  219.  
  220.   c) Ejecute el programa de configuración para comprobar que todos los  datos
  221.   son correctos.
  222.  
  223.   d)  Si  utiliza  la  versión  DOS,  borre  el  fichero JFREQ.COM.  La nueva
  224.   versión utiliza el formato .EXE para el ejecutable principal.
  225.  
  226.  
  227.   2.2 Notas Generales
  228.  
  229.   JFReq  funciona  en  procesadores  286  o  superior.   En  la  mayoría   de
  230.   instalaciones  bajo  DOS, es necesaria la presencia de SHARE o equivalente.
  231.   Para evitar cualquier problema en la  ejecución,  añada  el  directorio  de
  232.   JFReq a su variable de entorno PATH.
  233.  
  234.   Utilice   los  listados  de  directorios  para  aquellos  ficheros  y  /  o
  235.   directorios que NO estén en su índice del BBS.  Intente que sean los  menos
  236.   posibles, ya que son los que representan un mayor tiempo de búsqueda.
  237.  
  238.   El  índice  auxiliar  es para aquellos sistemas que tengan DOORs especiales
  239.   de ficheros, o que posean un software de BBS  diferente  a  RA  o  Maximus.
  240.   Este  índice  es  adicional a los otros, por lo que si no disponde ni de RA
  241.   ni Maximus, deje en blanco el campo del path del BBS  y  seleccione  Remote
  242.   Access como tipo de BBS.
  243.  
  244.   De  este  modo,  JFReq  puede  llegar  a  buscar,  en  una sola petición de
  245.   ficheros, en un fichero de Alias, un listado de directorios, un  índice  de
  246.   la  BBS  y  el  índice  propio.   Racionalice  su  sistema para permitir la
  247.   búsqueda más rápida posible, evitando  buscar  varias  veces  en  el  mismo
  248.   sitio.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.                                        3
  257.  
  258.  Capítulo 2. Instalación                                                    4
  259.  
  260.  
  261.   2.3 Sistemas Multilínea
  262.  
  263.   Tan  sólo  es  necesario  tener  correctamente  definidas  las variables de
  264.   entorno TASK y  JFREQ  para  que  la  ejecución  de  JFReq  en  un  sistema
  265.   multilínea  sea  correcta.   JFReq  mantiene un fichero LOG para cada tarea
  266.   (llamado JFREQ@.LOG, donde @ es  el  valor  de  TASK),  que  abre  en  modo
  267.   exclusivo  para  prevenir  errores en la configuración.  Los demás ficheros
  268.   se abren en modo compartido.
  269.  
  270.  
  271.   2.4 Variables de entorno
  272.  
  273.   TASK            Nº de tarea actual. Evita colisiones, ya que por
  274.                   ejemplo, el nombre del fichero LOG depende de ella. Cada
  275.                   fichero LOG lleva al final el número de tarea en la que
  276.                   se ejecuta. Si no está definido se asume tarea cero
  277.                   (monolínea)
  278.  
  279.   JFREQ           Indica el directorio de programa para JFReq. Util para
  280.                   configuraciones multilinea con diferentes directorios de
  281.                   arranque. No precisa la barra invertida final. Se
  282.                   aconseja utilizarla, aunque el directorio de ejecución
  283.                   sea el mismo.
  284.  
  285.   ejemplos:
  286.   SET TASK=1
  287.   SET JFREQ=C:\JFREQ
  288.  
  289.   Si  se  usa  MainDoor,  la  variable  MD  deberá  apuntar   al   directorio
  290.   correspondiente.
  291.  
  292.  
  293.   2.5 Instalación en el Mailer
  294.  
  295.   ATENCION:  No  utilicéis  paths demasiado largos para paquetes y entrada de
  296.   ficheros en vuestra configuración  del  mailer.   Estos  paths  se  pasarán
  297.   después  a  JFReq  en  la  línea  de  comando,  y  por la limitación de 128
  298.   caracteres que impone  el  sistema  operativo  podría  ocurrir  que  no  se
  299.   reconociera completamente la línea de comando.
  300.  
  301.   ATENCION:  Colocar  la  línea  EXACTAMENTE IGUAL.  Tan sólo puede variar el
  302.   nombre del ejecutable (JFREQ para DOS, JFREQP.EXE para OS/2), y  el  camino
  303.   de ejecución del mismo (si es necesario).
  304.  
  305.  Capítulo 2. Instalación                                                    5
  306.  
  307.  
  308.   2.5.1 Configuración para MainDoor y MainDoor/2:
  309.  
  310.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ File Request         │░░░░░░░░░░░░░░░░░
  311.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ Swap┌─── File Request ────┐░░░░░░░░░░░░
  312.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ Ento│ Ficheros            │░░░░░░░░░░░░
  313.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░└─────│ Límites             │░░░░░░░░░░░░
  314.   ░░░░░░░░░░░░░░░░░░ Copyright (c) 19│ Procesador          │ppa. ░░░░░░░
  315.   ┌──────────────────────────────── File Req - FRQP ────────────────────
  316.   │ Programa jfreq /MD =F =R =T =X =B =H =D =W
  317.   │ Activo   Si
  318.   │ Swapping Si
  319.   └─────────────────────────────────────────────────────────────────────
  320.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  321.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  322.  
  323.   Nota:  en  algunas  versiones  de  MainDoor,  los parámetros =D y =W aún no
  324.   están soportado.  Sustituya =D por INBOUND si su  versión  de  MainDoor  es
  325.   anterior  a  la  1.00.  El parámetro =W es opcional, por lo que omitirlo no
  326.   afectará a su funcionamiento.
  327.  
  328.   2.5.2 Configuración para FrontDoor 2.1x y 2.2x
  329.  
  330.   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╔═══════════════════╗▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  331.   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║                   ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  332.   ▒╔════════════════════════════════════════════════ Request processor ╗
  333.   ▒║
  334.   ▒║ Program  jfreq /FD =F =R =T =X =B =H =D =W░░░░░░░░░░░░░░░░░░░░░░░░░
  335.   ▒║ Enabled  Yes
  336.   ▒║ Swapping Yes
  337.   ▒║
  338.   ▒╚════════════════════════════════════════════════════════════════════
  339.   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ Swapping         ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  340.   ▒▒▒▒▒▒▒▒ Copyright ║ Protection       ║mrighausen; All rights reserved
  341.   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ Fax              ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  342.   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒╚══════════════════╝▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  343.   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  344.  
  345.   2.5.3 Configuración para Intermail 2.27:
  346.  
  347.   ╔══════════════════════════════════════════════════════ File requests
  348.   ║
  349.   ║ Mode      Anyone can request
  350.   ║ List      C:\IM\SYSTEM\OKREQDIR.LST
  351.   ║ Alias
  352.   ║ Message
  353.   ║ Max match 0
  354.   ║ Max time  0
  355.   ║ Max size  0
  356.   ║ Min speed 300
  357.   ║ Limited   No
  358.   ║ Start     00:00
  359.   ║ End       00:00
  360.   ║ Days      -------A
  361.   ║ External  JFREQ /IM %A %F %X %B %M %D %O░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  362.  
  363.  Capítulo 2. Instalación                                                    6
  364.  
  365.  
  366.   ║
  367.   ╚═════════════════════════════════════════════════════════════════════
  368.  
  369.  
  370.   2.6 El programa de configuración
  371.  
  372.   El menú de configuración es muy sencillo y se explica  a  sí  mismo  cuando
  373.   situamos  el  cursor sobre la opción a ejecutar.  Las opciones que aparecen
  374.   con una <+> a su derecha, no están disponibles  a  menos  que  el  programa
  375.   esté  registrado.   Consulta  el fichero REGISTRO.TXT para conocer la forma
  376.   de registro.
  377.  
  378.   2.6.1 Global Options
  379.  
  380.   Permite cambiar los valores comunes a toda sesión, como son:
  381.  
  382.               BBS Type - selecciona el tipo de BBS,
  383.               BBS Path - directorio principal de la BBS,
  384.       Use Custom Index - usar o no el índice secundario de ficheros.
  385.                          utilice esta opción para soportar doors de
  386.                          CD-ROMs o bien otros programas de BBS basados en
  387.                          la estructura FILES.BBS (en este último caso,
  388.                          seleccione Remote Access como tipo de BBS y deje
  389.                          en blanco el campo BBS Path)
  390.      Download Counters - tipo de soporte para contadores de download.
  391.                          Escoja cualquiera de las opciones (diferente a
  392.                          no) para activarlo en Remote Access. Este soporte
  393.                          se extiende al índice adicional. Los contadores
  394.                          de download DEBEN existir para que JFReq los
  395.                          actualice.
  396.         Min. Baud Rate - velocidad mínima para poder establecer
  397.                          peticiones,
  398.          PKT Directory - directorio para paquetes de respuesta (se
  399.                          recomienda usar un disco RAM si se dispone de él)
  400.          LOG Directory - directorio donde crear los ficheros de LOG
  401.       Special Requests - editar el fichero que contiene la lista de
  402.                          ficheros a los que añadir un mensaje especial. El
  403.                          formato es tan simple como <FICHERO> (nombre
  404.                          parcial o total sin comodines) <path
  405.                          completo\mensaje>. Se pueden usar cualquiera de
  406.                          los tokens disponibles. Si se desea enviar algún
  407.                          mensaje adicional siempre, coloque un punto (.)
  408.                          como nombre de fichero.
  409.        Nodelist Lookup - activar / desactivar la comprobación en el indice
  410.                          de nodelist del programa
  411.        Nodelist Files  - editar la lista de nodelists a procesar cuando se
  412.                          ejecuta JFNC, el compilador de nodelists
  413.    Allow Outbound Req. - permitir o no peticiones de ficheros que se
  414.                          producen en llamadas salientes (cuando es tu
  415.                          sistema el que realiza la llamada)
  416.        Buffered Drives - unidades de las que realizar buffering (copiar
  417.                          los ficheros a disco duro antes de la
  418.                          transferencia)
  419.         Buffering Path - vía de acceso en que realizar la copia temporal
  420.                          de ficheros de CD-ROMs, etc.
  421.  
  422.  Capítulo 2. Instalación                                                    7
  423.  
  424.  
  425.        Keep Statistics - activar / desactivar el almacenamiento de datos
  426.                          estadísticos para posteriores informes.
  427.       Expand Wildcards - activar la resolución de las peticiones que
  428.                          contengan comodines en más de un fichero.
  429.  
  430.  
  431.   2.6.2 Time Settings
  432.  
  433.   Ajuste del horario
  434.  
  435.             Start Time - hora de inicio para permitir peticiones,
  436.               End Time - hora de finalización,
  437.         Happy H. Start - inicio del periodo Happy Hour
  438.           Happy H. End - fin del periodo Happy Hour
  439.  
  440.   2.6.3 Limits
  441.  
  442.   Fija los límites según el tipo de sesión.  En un primer nivel, tenemos:
  443.  
  444.      Listed / Unsecure - sesiones con sistemas listados o con los que
  445.                          no hemos concertado ningún password
  446.               Unlisted - sesiones con sistemas no listados en nuestras
  447.                          nodelists
  448.             Passworded - sesiones 'protegidas' con sistemas con password
  449.                          concertado. da igual si éstos estan listados o no
  450.             Happy Hour - sesiones con sistemas sin password (listados o no)
  451.                          en un periodo determinado de tiempo
  452.            VIP Systems - editar la lista de especificaciones en las
  453.                          sesiones con sistemas VIP. Vea la sección
  454.                          Sistemas VIP para conocer el formato de este
  455.                          fichero ASCII
  456.       Unwanted Systems - dos ficheros que contienen las cadenas a comprobar
  457.                          tanto en la dirección como en la información de
  458.                          los sistemas para detectar aquellos sistemas que
  459.                          por alguna razón no sean bienvenidos. consulte el
  460.                          apartado comandos del editor para conocer las
  461.                          teclas disponibles dentro de la ventana de
  462.                          edición de ficheros.
  463.  
  464.   Dentro de cada uno de estos apartados (excepto el de  sistemas  non-gratos,
  465.   en el que editamos un par de ficheros), las opciones son las siguientes:
  466.  
  467.        Alias List File - fichero que contiene los nombres especiales de
  468.                          ficheros y sus equivalencias, con o sin passwords
  469.                          (ver más adelante su formato)
  470.         Directory List - lista de ficheros y directorios (con o sin
  471.                          password). Se utiliza para proteger ficheros o
  472.                          directorios con un password, o para añadir
  473.                          directorios que no constan en la base de ficheros
  474.                          del BBS (ver más adelante su formato)
  475.   Level for BBS Access - nivel de usuario de BBS al que equiparamos el
  476.                          tipo de sesión, para limitar el acceso a las
  477.                          áreas del BBS
  478.           Maximum Time - máximo tiempo a permitir en una sesión. el tiempo
  479.                          a utilizar se calcula a partir de la velocidad en
  480.  
  481.  Capítulo 2. Instalación                                                    8
  482.  
  483.  
  484.                          baudios de la llamada
  485.           Maximum Size - máximo tamaño acumulado a permitir en una sesión
  486.          Maximum Files - número máximo de ficheros a transmitir en una
  487.                          sesión
  488.       Max Time per Day - máximo tiempo por día
  489.       Max Size per Day - máximo tamaño por día
  490.      Max Files per Day - número máximo de ficheros por día
  491.  
  492.           NOTAS:
  493.           a) si se deja el límite a cero, significa que no existe
  494.              limitación en ese apartado
  495.           b) si se deja en blanco el apartado de fichero de directorio o
  496.              alias, se desactiva esa comprobación para ese tipo de
  497.              sesiones
  498.  
  499.   2.6.4 Mail Addresses
  500.  
  501.   Definición  de  la  dirección  de  correo  principal y hasta 11 secundarias
  502.   (AKAs)
  503.  
  504.   2.6.5 Template Editor
  505.  
  506.   Permite  editar  las  plantillas  desde  el   fichero   de   configuración,
  507.   seleccionando  el  fichero  (mostrando  su  ámbito  de  actuación  al pie),
  508.   separando los apartados de:
  509.  
  510.         Error Messages - edita uno a uno los posibles mensajes de error
  511.                          del sistema
  512.               Template - editar la plantilla a enviar en todas las
  513.                          peticiones permitidas
  514.           Bad Template - editar la plantilla a enviar en caso de coincidir
  515.                          los datos del sistema con alguna de las cadenas
  516.                          definidas en el apartado 'Unwanted Systems'
  517.  
  518.   Consulte  el  apartado  'comandos  del  editor'  para  conocer  las  teclas
  519.   disponibles dentro de la ventana de edición de ficheros.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                   Capítulo 3
  527.  
  528.                                   Otros datos
  529.  
  530.  
  531.  
  532.  
  533.  
  534.   3.1 Parámetros de la línea de comandos
  535.  
  536.   Esta  es  una  descripción  de los parámetros que se pasan a JFREQ desde el
  537.   mailer en la línea de comandos.  Estos parámetros corresponden  al  Mailer,
  538.   no  a  JFReq.   JFReq lee la línea tal como la genera el Mailer al traducir
  539.   los parámetros.  Es imprescindible que la línea de comandos  de  JFReq  sea
  540.   tal  y como se especifica para cada tipo de Mailer.  No se puede alterar el
  541.   orden de los parámetros.
  542.  
  543.   Modo de Operación:
  544.     /MD     MainDoor
  545.     /FD     FrontDoor
  546.     /IM     InterMail
  547.   Modo FD/MD:
  548.     =F      Fichero de información del sistema remoto
  549.     =R      Fichero que contiene los ficheros pedidos
  550.     =T      Fichero a crear con los ficheros a transmitir
  551.     =X      SECURE/UNSECURE
  552.     =B      Velocidad de conexión en BPS
  553.     =H      Minutos hasta el siguiente evento que no acepte FREQs
  554.     =D      INBOUND/OUTBOUND (dirección de la llamada)
  555.     =W      LISTED/UNLISTED
  556.   Modo Intermail:
  557.     %A      Dirección de correo del sistema remoto
  558.     %F      Fichero que contiene los ficheros pedidos
  559.     %X      SECURE/UNSECURE/UNLISTED
  560.     %B      Velocidad de conexión en BPS
  561.     %M      Minutos hasta el siguiente evento que no acepte FREQs
  562.     %D      INBOUND/OUTBOUND (dirección de la llamada)
  563.     %O      Nombre del SysOp del sistema remoto
  564.  
  565.  
  566.   3.2 Variables utilizadas en las plantillas
  567.  
  568.   El  uso  de  plantillas  de  respuesta  es  una  de   las   características
  569.   principales  del  programa,  ya  que  permiten  personalizar  totalmente el
  570.   mensaje de respuesta.
  571.  
  572.   Estos ficheros tienen la extensión .FRQ, y en su nombre contienen la  clave
  573.   para  definir a qué sistemas se enviarán.  Veamos unos ejemplos, puestos en
  574.   el mismo orden que se realiza la selección:
  575.  
  576.  
  577.  
  578.                                        9
  579.  
  580.  Capítulo 3. Otros datos                                                   10
  581.  
  582.  
  583.          2#343.FRQ    ->  se enviará a todos los sistemas de la zona 2,
  584.                           red 343.
  585.          2#34@.FRQ    ->  se enviará a todos los sistemas de la zona 2,
  586.                           abarcando aquellas redes que no tengan plantilla
  587.                           definida y comiencen por 34.
  588.          2.FRQ        ->  se enviará a todos los sistemas de la zona 2 que
  589.                           no tengan otra plantilla definida.
  590.          DEFAULT.FRQ  ->  se enviará a todos los sistemas de cualquier
  591.                           zona que no tengan ninguna plantilla definida.
  592.                           Este fichero DEBE existir para una correcta
  593.                           ejecución del programa.
  594.  
  595.   Para crear una nueva plantilla, copie la plantilla  existente  que  más  se
  596.   parezca  a  la nueva a un fichero con el nombre correspondiente al juego de
  597.   direcciones a los que  se  lo  desea  enviar.   En  futuras  versiones  del
  598.   programa, esta función estará integrada en la configuración.
  599.  
  600.   Si  bien  cualquiera  de estas plantillas pueden ser editadas con cualquier
  601.   editor  ASCII,  ya  que  los  ficheros  están  suficientemente  comentados,
  602.   recomendamos  utilizar  el mismo programa de configuración, ya que facilita
  603.   enormemente la labor.
  604.  
  605.           NOTAS:
  606.           a) La justificación de párrafos se realiza eliminando espacios
  607.              extra y líneas en blanco, y adecuando la longitud de cada
  608.              línea a un máximo de 75 caracteres.
  609.           b) Es importante que el juego de mayúsculas/minúsculas en los
  610.              tokens se mantenga en las plantillas tal como se lista aquí.
  611.  
  612.   Las variables utilizables en las plantillas son las siguientes:
  613.  
  614.   Token                   Valor/Acción
  615.   ---------------------------------------------------------------------
  616.   @@BegJust       Indica el comienzo de un párrafo justificado.
  617.   @@EndJust       Indica el final de un párrafo justificado.
  618.   @@FileDesc      A partir de esta línea se coloca el listado de ficheros
  619.                   y sus descripciones.
  620.   @@FrqSyst       Nombre del sistema remoto
  621.   @@FrqName       Nombre completo del SysOp del sistema que hace el File
  622.                   Request.
  623.   @@FrqAddr       Dirección electrónica del sistema que hace el File
  624.                   Request.
  625.   @@FrqFrom       Localidad desde donde llama el sistema remoto
  626.   @@FrqPhon       Teléfono del sistema remoto
  627.   @@FrqSPWD       Password de sesión (en blanco si no lo hay)
  628.   @@FrqSerN       Número de serie del Mailer remoto.
  629.   @@SesType       Tipo de Sesión en curso (secure/unsecure/unlisted/happy
  630.                   hour)
  631.   @@PrgName       Nombre y versión actual del programa JFReq en uso.
  632.   @@RegName       Nombre de usuario tal como consta en el fichero llave de
  633.                   registro del programa JFReq.
  634.   @@AKMatch       Aka del propio sistema que coincide con la del sistema
  635.                   que realiza el File Request, o la primaria, si no existe
  636.                   coincidencia.
  637.   @@RegAKA<#>     Dirección electrónica del sistema. Sustituir <#> por el
  638.  
  639.  Capítulo 3. Otros datos                                                   11
  640.  
  641.  
  642.                   nº de AKA en la configuración.
  643.   @@MinBaud       Velocidad mínima de conexión en Baudios permitida.
  644.   @@BegTime       Hora de inicio de FileRequest permitidos en el sistema
  645.                   (formato 24 Hrs).
  646.   @@EndTime       Hora de finalización de FileRequest permitidos en el
  647.                   sistema (formato 24 Hrs).
  648.   @@BegHapp       Hora de inicio del horario especial para FileRequest en
  649.                   el sistema (formato 24 Hrs).
  650.   @@EndHapp       Hora de finalización del horario especial de FileRequest
  651.                   en el sistema (formato 24 Hrs).
  652.   @@OkFiles       Número de ficheros localizados.
  653.   @@TKbytes       Ks totales de los ficheros localizados.
  654.   @@CumCall       Número de llamadas totales del sistema remoto
  655.   @@CumFile       Número de ficheros pedidos por el sistema remoto (acum.)
  656.   @@CumSize       Ks pedidos por el sistema remoto (acumulado)
  657.   @@CumTime       Minutos acumulados por el sistema remoto
  658.   @@DayFile       Total de ficheros pedidos hoy por el sistema remoto
  659.   @@DaySize       Ks. pedidos hoy por el sistema remoto
  660.   @@DayTime       Total de minutos usados hoy por el sistema remoto
  661.   @@MaxFile       Máximo número de ficheros permitidos en esta sesión
  662.   @@MaxSize       Máximo de Ks permitidos para esta sesión.
  663.   @@MaxTime       Tiempo máximo de transmisión para esta sesión.
  664.   @@Ma<#>File     Máximo de ficheros para ese tipo de sesión
  665.   @@Ma<#>Size     Máximo tamaño (en Ks) para ese tipo de sesión
  666.   @@Ma<#>Time     Máximo tiempo (minutos) para ese tipo de sesión
  667.   @@Da<#>File     Máximo de ficheros por día para ese tipo de sesión
  668.   @@Da<#>Size     Máximo de Ks por día para ese tipo de sesión
  669.   @@Da<#>Time     Máximo de minutos por día para ese tipo de sesión
  670.  
  671.   En los seis últimos tokens, debe sustituir <#> por:
  672.           L - sesiones con sistemas listados (sin password)
  673.           U - sesiones con sistemas no listados
  674.           H - sesiones con sistemas sin password durante el periodo happy
  675.               hour
  676.           P - sesiones protegidas por un password de sesión
  677.           A - tipo de sesión en la llamada activa
  678.  
  679.  
  680.   3.3 Formato de los ficheros de directorios y alias
  681.  
  682.   Estos ficheros pueden ser diferentes según el  tipo  de  sesión  y  han  de
  683.   contener  una  entrada  por  línea,  procurando no dejar líneas en blanco y
  684.   siguiendo este formato lo más adecuadamente posible.
  685.  
  686.   3.3.1 fichero de directorios:
  687.  
  688.     para representar ficheros:
  689.   <disco>:\<path>\<nombre>.<ext> [!<password>]
  690.     para representar directorios:
  691.   <disco>:\<path> [!<password>]
  692.     ejemplo:
  693.   C:\FICHEROS\SECRETO.ZIP !seguro
  694.  
  695.  Capítulo 3. Otros datos                                                   12
  696.  
  697.  
  698.   3.3.2 lista de ALIAS:
  699.  
  700.   <alias> [!<pwd>] <disco>:\<path>\<nombre>.<ext> [<disco>:\<path>\...]
  701.     ejemplo:
  702.     LAS_BETAS !seguro C:\FICHEROS\SECRETO.* C:\FICHEROS\NOTAS.ZIP
  703.  
  704.   (los passwords en la lista de alias y en la de directorios son opcionales)
  705.  
  706.  
  707.   3.4 El compilador de nodelists
  708.  
  709.   El programa JFNC.COM (JFNCP.EXE  en  OS/2)  nos  sirve  para  compilar  las
  710.   nodelists  actuales  tal  como  están  definidas  en  el  fichero JFNC.CTL,
  711.   creando un índice especial para que JFReq pueda conocer lo más  rápidamente
  712.   posible si un sistema está o no listado.
  713.  
  714.   Esta  comprobación, obviamente, se toma su tiempo, por lo que se recomienda
  715.   comprobar  si  el  mailer  realiza  ya  ésta  función,  en  cuyo  caso   se
  716.   desactivará la opción 'Nodelist Lookup'.
  717.  
  718.   Recuerde  ejecutar  el  programa compilador de nodelists cada vez que éstas
  719.   cambien, ya que si no lo hace la comprobación no tiene sentido.
  720.  
  721.   El fichero JFNC.CTL ya está comentado, por lo que no debe  tener  problemas
  722.   en cuanto a su estructura
  723.  
  724.  
  725.   3.5 El compilador del índice interno
  726.  
  727.   Para  poder  utilizar  el  índice  interno,  deberá  crear un fichero ASCII
  728.   (JFFC.CTL), siguiendo el siguiente formato para cada una de las líneas:
  729.  
  730.   [!<pwd>] [#<user level>] <down. path> <files.bbs path> <desc. column>
  731.  
  732.   [!<password>] (opcional) password para todos los ficheros del área
  733.  
  734.   [#<user level>] (opcional) nivel de usuario para poder acceder al  área  en
  735.   formato numérico, siguiendo esta tabla si usa el modo de Maximus:
  736.  
  737.            0 - Disgrace         Si usa el modo Remote Access, tan sólo ha
  738.            1 - Limited          de colocar la misma cifra que pondría en
  739.            2 - Normal           RACONFIG o JFREQCFG.
  740.            3 - Worthy
  741.            4 - Privil
  742.            5 - Favoured
  743.            6 - Extra
  744.            7 - Clerk
  745.            8 - AsstSysop
  746.            9 - SysOp
  747.  
  748.   Para actualizar el índice, ejecute JFFC(P) siempre que sea necesario.
  749.  
  750.  Capítulo 3. Otros datos                                                   13
  751.  
  752.  
  753.   3.6 El compilador de áreas de ficheros para Remote Access
  754.  
  755.   Es  posible  usar un índice adicional para RA que acelera considerablemente
  756.   el tiempo de búsqueda.  Este índice debe actualizarse al menos una  vez  al
  757.   día  si  hay  variaciones  en las áreas de ficheros de RA.  Si no existe el
  758.   índice, la búsqueda se realiza usando  los  índices  estándar  de  RA.   El
  759.   compilador  de  índices  de  RA  se  llama JFRAFC.EXE y precisa que esté la
  760.   variable de entorno RA definida.  El fichero de índice resultante se  llama
  761.   RAFILES.IDX y ha de estar en el directorio base de JFREQ.
  762.  
  763.  
  764.   3.7 Sistemas VIP
  765.  
  766.   JFREQ  permite  definir sesiones con sistemas determinados, basándose en la
  767.   dirección principal del sistema que realiza la llamada.   Este  control  de
  768.   sesiones  se  realiza  a  través  del  fichero  JFREQ.VIP,  cuyo formato se
  769.   describe a continuación:
  770.  
  771.   Syst. Address BBS Lev. MaxTime MaxSize MaxFile DayTime DaySize DayFile
  772.   ------------- -------- ------- ------- ------- ------- ------- -------
  773.   @2:343/116.*      300      60     5000      25      0       0       0
  774.   2:343/129.0       300      60     5000      25      0       0       0
  775.   2:343/117.0       300      60     5000      25      0       0       0
  776.  
  777.   '@' colocado delante de una dirección indica que la  sesión  debe  ser  con
  778.   password para considerar a ese sistema como VIP.
  779.  
  780.   Los  niveles  de usuario de BBS se guían por la misma tabla que se aplica a
  781.   la  configuración  del  índice  interno  (JFFC).   Consulte   el   apartado
  782.   correspondiente en caso de duda.
  783.  
  784.   Las  direcciones  que  se  usen  deben ser 4D (incluyendo número de punto).
  785.   Pueden usarse caracteres  comodín  en  cualquier  lugar  de  la  dirección,
  786.   ampliando  el  número  de  sistemas a los que se aplica la condición de VIP
  787.   siguiendo la pauta del comodín.
  788.  
  789.   Si indica '0' en algún campo de limitación (excluído el de nivel del  BBS),
  790.   JFREQ interpretará que no existe límite en ese parámetro concreto.
  791.  
  792.  
  793.   3.8 Peticiones especiales con mensaje incluído
  794.  
  795.   JFReq  permite  añadir  mensajes  específicos al paquete de respuesta si el
  796.   sistema remoto se lleva un  determinado  fichero.   Estos  mensajes  pueden
  797.   utilizar  los  mismos  tokens  que  en  los mensajes normales de respuesta.
  798.   Para activar esta opción, tan sólo  ha  de  editar  el  fichero  FNAMES.DAT
  799.   desde  el  programa  de  configuración,  en  el  apartado Special Requests,
  800.   dentro de las opciones globales.
  801.  
  802.   En este fichero, deberá especificar el nombre parcial  (sin  comodines),  a
  803.   cotejar  con los que se llevan los sistemas, junto con un nombre de fichero
  804.   (con su path completo) que corresponda con el mensaje que  desee  adjuntar.
  805.   Este  mensaje se enviará junto con el normal de respuesta, dentro del mismo
  806.   paquete de correo.
  807.  
  808.  Capítulo 3. Otros datos                                                   14
  809.  
  810.  
  811.   Por ejemplo, si definimos la siguiente línea dentro de FNAMES.DAT:
  812.  
  813.       .JPG    c:\jfreq\gifjpg.msg
  814.  
  815.   Se adjuntará el fichero gifjpg.msg (convirtiendo los tokens que  contenga),
  816.   al  paquete  de  respuesta  de  todo  sistema  que  nos pida un fichero con
  817.   extensión JPG.
  818.  
  819.  
  820.   3.9 Informes Estadísticos
  821.  
  822.   JFSTAT(P) es el programa a ejecutar para  obtener  información  estadística
  823.   acerca  de  los  pedidos  de ficheros a su sistema.  Esta información es de
  824.   todo su sistema.  Si desea saber los pedidos de cada línea  en  particular,
  825.   consulte los LOGs de cada tarea.
  826.  
  827.   La sintaxis del programa puede ser:
  828.  
  829.   a) informar en un fichero PKT, a NETMAIL o de Echo.:
  830.  
  831.    JFSTAT(P) /PKT <to> <area> <inbound path> [days to report] [days to purge]
  832.  
  833.   <to>  a  quién  irá  destinado  el mensaje, usando el carácter de subrayado
  834.   para los espacios (e.g.  Joe_Sysop)
  835.  
  836.   <area> es NETMAIL para correo Net o el TAG del  área  a  la  que  se  desea
  837.   enviar los informes
  838.  
  839.   <inbound  path>  es  su path de entrada de paquetes de correo, para colocar
  840.   allí el fichero PKT, que será procesado luego por su procesador de correo.
  841.  
  842.   b) informe a pantalla:
  843.  
  844.    JFSTAT [days to report] [days to purge]
  845.  
  846.   [days to report] días en que se basa la estadística.
  847.  
  848.   [days to purge] después de realizar la estadística, sólo  se  mantendrá  la
  849.   información  correspondiente  a  los  últimos  días  especificados  en esta
  850.   cifra.  Eg.  si se especifica 4, se borrará toda la información de cinco  o
  851.   más  días  de  antigüedad.   Si especifica 0, se borrará toda la infomación
  852.   estadística.  La información de los  LOGs  o  de  los  nodos  no  resultará
  853.   afectada.
  854.  
  855.   c)  Si ejecuta JFSTAT sin argumentos, se le dará por pantalla un informe de
  856.   todos los datos estadísticos acumulados.
  857.  
  858.  
  859.   3.10 Comandos del editor
  860.  
  861.   El programa de configuración de  JFReq  incorpora  un  sencillo  editor  de
  862.   textos  para  facilitarle  la edición de algunos ficheros importantes en la
  863.   configuración de su sistema.  Aparte de los cursores y  otras  teclas  cuya
  864.   función  se presupone, estas son otras teclas que puede utilizar dentro del
  865.   editor, con su función correspondiente:
  866.  
  867.  Capítulo 3. Otros datos                                                   15
  868.  
  869.  
  870.   Ctrl+flecha der - coloca el cursor en la siguiente palabra
  871.   Ctrl+flecha izq - coloca el cursor en la palabra anterior
  872.          Ctrl+fin - borra desde el cursor hasta el final de la línea
  873.       Ctrl+inicio - borra desde el cursor hasta el inicio de la línea
  874.    Ctrl+retroceso - borra la línea entera (se puede recuperar con Alt+R)
  875.        Ctrl+AvPag - mueve el cursor al final del documento
  876.        Ctrl+RePag - mueve el cursor al inicio del documento
  877.             Alt+S - copia el contenido de la línea actual en memoria
  878.             Alt+R - restaura la última línea copiada o borrada
  879.             Alt+X - finaliza la edición, guardando el fichero
  880.  
  881.  
  882.   3.11 Colaboradores
  883.  
  884.   Mi más sincero agradecimiento a las siguientes personas, que han  realizado
  885.   las  pruebas  y  comentarios  pertinentes para hacer de JFReq un sistema lo
  886.   más estable posible en multitud de configuraciones:
  887.  
  888.   Ignacio Plasencia       2:341/11@fidonet.org
  889.   Rafael Suárez           2:341/14@fidonet.org
  890.   Francisco Sedano        2:341/20@fidonet.org
  891.   Rafael Gutiérrez        2:341/45@fidonet.org
  892.   Tirs Abril              2:343/106@fidonet.org
  893.   José Gonzalvo           2:343/129@fidonet.org
  894.   Carlos Hermida          2:348/603@fidonet.org
  895.  
  896.  
  897.   3.12 Cómo contactar con el autor
  898.  
  899.   Envía  tus  comentarios  constructivos  sobre  el   producto   vía   correo
  900.   electrónico a:
  901.  
  902.   Jordi Sese,
  903.   BlackAdders' BBS:  34-3-2103303 (24Hr. V32b, V42b, FAX)
  904.   Fidonet:     2:343/116.0
  905.   RedBBS:      757:101/25
  906.   Internet:    shel@black.lonestar.es
  907.  
  908.   o por correo ordinario a:
  909.  
  910.   Jordi Sesé
  911.   C/ Sostres 31, pta 7
  912.   08024 Barcelona
  913.   (Spain)
  914.  
  915.   Si  eres  un  usuario  registrado, puedes utilizar estos mismos medios para
  916.   realizar aquellas consultas que precises para una correcta utilización  del
  917.   programa.   Si  no  estás  registrado  todavía, lee el fichero REGISTRO.TXT
  918.   para conocer las condiciones de uso de  JFReq  y  cómo  convertirse  en  un
  919.   usuario registrado de este programa.
  920.  
  921.   NOTA:  Si  deseas registrarte, por favor, contacta con el Register Site que
  922.   consta en REGISTRO.TXT.
  923.  
  924.  Capítulo 3. Otros datos                                                   16
  925.  
  926.  
  927.                              - Fin de JFReq.Doc -
  928.