wiki:es:Documentation/ARexxAPI/MAILINFO

Version 5 (modified by Emilio Jimenez, 5 years ago) (diff)

En otros idiomas:


ARexx API

    MAILINFO

    NOMBRE

    MailInfo — Obtener información sobre un mensaje. (V2.0)

    PLANTILLA

    VAR/K,STEM/K,INDEX/N

    FUNCIÓN

    Devuelve información sobre un mensaje de la carpeta, o sobre el mensaje actual si no especifica ninguno.

    ENTRADAS

    VAR/K - variable alternativa en la que almacenar los resultados en lugar de RESULT
    STEM/K - nombre base usado para los STEMs donde se almacenará la información devuelta
    INDEX/N - posición del mensaje del que se quiere obtener información, donde el primer mensaje de la carpeta ocupa la posición 0; si no se indica índice alguno, se utilizará el mensaje actual

    RESULTADOS

    VAR - información devuelta por el comando
    <STEM>INDEX - posición del mensaje en la carpeta; el primer mensaje de la misma ocupa la posición 0
    <STEM>STATUS - estado del mensaje; los valores posibles son

    N - nuevo
    O - leído
    U - no leído
    R - respondido
    F - reenviado
    S - enviado
    W - listo para enviar
    H - retenido
    E - envío fallido

    <STEM>FROM - remitente del mensaje, o más exactamente el primer remitente que figura en la cabecera "De:"
    <STEM>TO - destinatario del mensaje, o más exactamente el primero que figura en la cabecera "Para:"
    <STEM>REPLYTO - dirección de retorno del mensaje, o más exactamente el primer destinatario que figura en la cabecera "Responder-A:", o en su defecto el primer remitente de la cabecera "De:"
    <STEM>SUBJECT - asunto del mensaje (contenido de la cabecera "Asunto:")
    <STEM>FILENAME - fichero donde se encuentra el mensaje, incluyendo la senda
    <STEM>SIZE - tamaño del mensaje, en bytes
    <STEM>DATE - fecha del mensaje, en el formato "MM-DD-AA HH:MM:SS"
    <STEM>FLAGS - una cadena de 9 bytes en el formato "MARCS-77M":

                             MARCS-77M\\
                             !||||| !|||\\
                             !||||| !||`--------- bandera '''M'''arcado (V2.4)\\
                             !||||| |`---------- bandera volátil (véase [[SETFLAG| SETFLAG ]])\\
                             !||||| `----------- bandera permanente (véase [[SETFLAG| SETFLAG ]])\\
                             !||||`------------- firmado con PGP\\
                             !|||`-------------- en'''C'''riptado con PGP\\
                             !||`--------------- info'''R'''me de estado\\
                             |`---------------- contiene '''A'''nexos\\
                             `----------------- '''M'''últiples destinatarios\\
    

    <STEM>MSGID - representación hexadecimal comprimida en 32 bits del contenido de la cabecera "Message-ID:", por ejemplo BBC62595 (V2.1)

    RC se pone a 10 si INDEX está fuera del rango de mensajes disponibles en la carpeta.

    NOTAS

    A partir de YAM 2.4, <STEM>MSGID devuelve un valor hexadecimal.

    EJEMPLO

             /* Activar códigos de resultados */
    
             OPTIONS RESULTS
    
             /* Obtener información sobre el mensaje actual */
    
             MAILINFO STEM st.
    
             /* Mostrar los resultados */
    
             SAY 'Mensaje:     'st.index\\
             status = st.status\\
             SELECT\\
                WHEN status = 'N' THEN status = 'Nuevo'\\
                WHEN status = 'O' THEN status = 'Leído'\\
                WHEN status = 'U' THEN status = 'No leído'\\
                WHEN status = 'R' THEN status = 'Respondido'\\
                WHEN status = 'F' THEN status = 'Reenviado'\\
                WHEN status = 'S' THEN status = 'Enviado'\\
                WHEN status = 'W' THEN status = 'Listo para enviar'\\
                WHEN status = 'H' THEN status = 'Retenido'\\
                OTHERWISE status = 'Envío fallido'\\
             END\\
             SAY 'Estado:      'status\\
             SAY 'De:          'st.from\\
             SAY 'Para:        'st.to\\
             SAY 'Contestar a: 'st.replyto\\
             SAY 'Asunto:      'st.subject\\
             SAY 'Fichero:     'st.filename\\
             SAY 'Tamaño:      'st.size\\
             SAY 'Fecha:       'st.date\\
             SAY 'Banderas:    'st.flags\\
             SAY 'Message-ID:  'st.msgid\\
    

    FALLOS

    En la V2.3p1, <STEM>FILENAME omitía la parte del nombre de la carpeta cuando no se indicaba un índice. Esto fue corregido en YAM 2.4.

    VÉASE TAMBIÉN

    SETFLAG