wiki:es:Documentation/ARexxAPI/MAILCHECK

Version 2 (modified by AmigaPhil, 6 months ago) (diff)

--

En otros idiomas:


ARexx API

    MAILCHECK

    NOMBRE

    MailCheck -- Recoger el correo nuevo.

    PLANTILLA

    VAR/K,STEM/K,POP/K/N,MANUAL/S

    FUNCIÓN

    Descarga el correo nuevo de la cuenta POP3 indicada, o de todas ellas en caso de no indicar ninguna.

    ENTRADAS

    VAR/K - variable alternativa en la que almacenar el resultado en lugar de hacerlo en RESULT (V2.0)
    STEM/K - nombre base usado para los STEMs donse se almacenará la información devuelta (V2.0)
    POP/K/N - cuenta POP3 de la que descargar el correo (V2.0), indicada según su posición en la lista de cuentas POP3 en Configuración ->TCP/IP; la primera cuenta ocupa la posición 0
    MANUAL/S - abrir la ventana de transferencia para permitir la intervención del usuario (preselección de mensajes) (V2.0)

    RESULTADOS

    VAR - información devuelta por el comando
    <STEM>DOWNLOADED - número de mensajes descargados
    <STEM>ONSERVER - número de mensajes que permanecen en el servidor
    <STEM>DUPSKIPPED - número de duplicados saltados
    <STEM>DELETED - número de mensajes borrados en el servidor

    En la V1.x, RC siempre se ponía a 0. Sin embargo, a partir de la V2.0, RC se pone a 5 si la pila TCP/IP no está en línea.

    Del mismo modo, en la V1.x RESULT se ajustaba de acuerdo al número de mensajes descargados, o a -1 si no se podía conectar con el servidor de correo.

    NOTAS

    El comando retorna inmediatamente cuando se utiliza MANUAL.

    Si no se indica cuenta alguna, el comando sólo comprobará las cuentas marcadas como "activas" en la configuración, del mismo modo que haría el botón "Recoger correo" de la barra de herramientas.

    EJEMPLO

    /* Activar códigos de resultados */

    OPTIONS RESULTS

    /* Descargar correo de una cuenta */

    MAILCHECK POP 2 STEM st.

    /* Mostrar los resultados */

    SAY 'Mensajes descargados: 'st.downloaded
    SAY 'Permanecen en el servidor: 'st.onserver
    SAY 'Duplicados saltados: 'st.dupskipped
    SAY 'Borrados del servidor: 'st.deleted

    FALLOS

    RC se ponía a 5 si no se encontraba ningún mensaje nuevo en la cuenta, y <STEM>ONSERVER simplemente devolvía el número de mensajes hallados en ella. Ambos fallos fueron corregidos en YAM 2.4.

    VÉASE TAMBIÉN