phs(S)                         6 January 1993                         phs(S)


 Name

    phs - Note the MMDF transmission phase (phs_)

 Syntax


    cc  . . .  -lmmdf


    #include  <util.h>
    #include  <mmdf.h>
    #include  <ch.h>
    #include  <phs.h>

    time_t
    phs_get (thechan, phase)
    Chan *thechan;
    int phase;

    phs_msg (thechan, naddrs, len)
    Chan *thechan;
    int naddrs;
    long len;

    phs_note (thechan, phase)
    Chan *thechan;
    int phase;

    phases:
        PHS_CNGOT       /* Got connection to site */
        PHS_CNEND       /* End connection to site */
        PHS_CNSTRT      /* Start connecting to site */
        PHS_REEND       /* End reading (sending) mail from site */
        PHS_RESTRT      /* Start reading (sending) mail from site */
        PHS_WREND       /* End writing (picking up) mail to site */
        PHS_WRSTRT      /* Start writing (picking up) mail to site */


 Description

    These routines are used to record the progress made during a connection
    between MMDF and another mail system.  Sessions are divided into the pre-
    viously listed phases.  External time-stamps are maintained for each
    channel and for each phase.  The time-stamps are primarily used by the
    checkque(ADM) program, but notations also are made in the channel log
    (see logs(F)).  The time-stamps are maintained by setting the modified
    time of files in channel subdirectories of the "phsdfldir" directory
    specified in the MMDF configuration.  One file is kept per time-stamp
    (see FILES in the next section).

    The phsnote routine records the indicated event.  The phsmsg routine is
    a special case; it records the transmission of one message, noting the
    number of addresses for it and the number of characters.  This is
    recorded only in the channel log and is not given any external time-
    stamps. The phsget routine returns the time-stamp of the specified chan-
    nel and phase.  If a time-stamp does not exist for the specified channel
    and phase, phsget returns zero.

 Files


    <phsdfldir>/<channel>/cend      PSH_CNEND time-stamp file
    <phsdfldir>/<channel>/cgot      PSH_CNGOT time-stamp file
    <phsdfldir>/<channel>/cstrt     PSH_CNSTRT time-stamp file
    <phsdfldir>/<channel>/rend      PSH_REEND time-stamp file
    <phsdfldir>/<channel>/rmsg      PSH_REMSG time-stamp file
    <phsdfldir>/<channel>/rstrt     PSH_RESTRT time-stamp file
    <phsdfldir>/<channel>/wend      PSH_WREND time-stamp file
    <phsdfldir>/<channel>/wmsg      PSH_WRMSG time-stamp file
    <phsdfldir>/<channel>/wstrt     PSH_WRSTRT time-stamp file


 See also

    llog(S), mlsend(S), mmdf(S), tai(S)

 Standards conformance

    The phsget, phsmsg, and phsnote routines are not part of any currently
    supported standard; they were developed at the University of Delaware and
    are used by permission.