Library /sys$common/syshlp/helplib.hlb  —  PMDF  RESTART
    Restart detached PMDF processes.

    Syntax

      PMDF RESTART  [component]

    Command Qualifiers             Defaults

    /CLUSTER                       /NODE
    /NODE[=node]                   /NODE
    /ID=pid                        /NODE

1  –  Restrictions 

    SYSLCK privilege is required to restart detached PMDF processes.

2  –  Prompts 

    Comcomponent

3  –  Parameters 

 component

    Optional parameter which specifies a specific PMDF component
    to be restarted, such as BN_SLAVE, CIRCUIT_CHECK, COUNTERS,
    DISPATCHER, FAX_RECEIVE, HTTP, IMAP (which restarts both the
    system mailbox server and the PMDF MessageStore mailbox server),
    IMAP_SERVER (the PMDF MessageStore server), POP_SERVER (the
    PMDF MessageStore server), POP3 (which restarts both the system
    mailbox server and PMDF MessageStore server), POPPASSD, SMTP,
    or any other Dispatcher service such as the names of PMDF-XGS
    servers, PMDF-LAN Lotus Notes servers, or PMDF-DIRSYNC Lotus
    Notes directory agent servers. Note that restarting the PMDF
    Service Dispatcher, i.e., the DISPATCHER component, effectively
    restarts all the service components it handles, which may include
    HTTP, IMAP, IMAP_SERVER, POP_SERVER, POP3, POPPASSD, SMTP, PMDF-
    XGS, PMDF-LAN, and PMDF-DIRSYNC servers. If no component name is
    given then all active components will be restarted.

4  –  Description 

    Detached PMDF processes should be restarted whenever the PMDF
    configuration is altered-these processes load information from
    the configuration once only and need to be restarted in order for
    configuration changes to become visible to them.

    The RESTART utility is used to restart detached PMDF processes.
    The default is to restart processes on the node on which the
    command is executed. Use the /NODE qualifier with a specific
    node name to affect processes on a different node in the cluster;
    use the /CLUSTER qualifier to restart PMDF processes across the
    cluster; use the /ID qualifier to affect only a single process
    in the cluster. If no component parameter is specified, then all
    detached processes (including processes which use the PMDF API
    PMDF_SET_CALL_BACK procedure) will be restarted. If a component
    parameter is specified, then only detached processes associated
    with that component will be restarted. The standard component
    names are

    Component  Description

    BN_SLAVE   Detached processes which act as the Jnet Local Mail
               Delivery (LMD) daemon. Handles incoming local BITNET
               mail.
    CIRCUIT_   Detached process which monitors loopback message
    CHECK      delivery.
    COUNTERS   Detached processes which synchronize the channel
               counters.
    DISPATCHER PMDF multithreaded Service Dispatcher handling
               services such as SMTP, POP, IMAP, and HTTP servers.
    FAX_       Detached processes which process incoming FAXes.
    RECEIVE
    HTTP       HTTP server processes.
    IMAP       This restarts both IMAP server processes serving out
               system mailboxes, and IMAP server processes serving
               out PMDF MessageStore mailboxes.
    IMAP_      IMAP server processes serving out PMDF MessageStores
    SERVER     mailboxes.
    POP_       PMDF MessageStore POP3 server processes; that is,
    SERVER     the processes serving out PMDF MessageStore and PMDF
               popstore mailboxes.
    POP3       This restarts both POP3 server processes serving out
               system mailboxes, and POP3 server processes serving
               out PMDF MessageStore and PMDF popstore mailboxes.
    POPPASSD   POPPASSD server processes.
    SMTP       SMTP server processes.

    Detached PMDF processes will restart as soon as is convenient.
    They restart by performing an orderly shutdown, exiting the image
    they are running, starting a new detached process running, and
    then exiting.

    If there are no currently running process associated with a given
    component, then that component will not be restarted.

5  –  Command Qualifiers

5.1    /CLUSTER 

    When the /CLUSTER qualifier is specified, the RESTART command
    will affect all nodes in the cluster.

5.2    /NODE 

       /NODE[=node]

    By default, the RESTART command affects only processes on the
    node on which the command is executed; this corresponds to
    specifying the /NODE qualifier without the optional node name
    value. To restart processes on a different node, specify the node
    name. The node name must be the SCS cluster node name.

5.3    /ID 

       /ID=pid

    When the /ID qualifier is specified, only the process with the
    given process id (pid) is affected. Note that process id's are
    unique cluster wide and as such there is no need to also specify
    /NODE.

6  –  Examples 

      To restart cluster-wide all detached processes, simply use the
      command

        $ PMDF RESTART/CLUSTER

      To only restart, for instance, IMAP and POP3 servers on the
      current node, use the commands

        $ PMDF RESTART IMAP
        $ PMDF RESTART POP3

7  –  Error messages 

  SYSTEM-F-TIMEOUT, device timeout

      After waiting two minutes for the component(s) in question
      to acknowledge the restart request, the PMDF RESTART utility
      returns control to the command line. The restart request
      is still outstanding and should be honored by the PMDF
      component(s) for which the command was issued; the utility
      has just given up waiting for the component(s) to immediately
      acknowledge the request as it (they) may be busy with existing
      activity.
Close Help