Shut down detached PMDF processes.

    Syntax

      PMDF SHUTDOWN  [component]

    Command Qualifiers             Defaults

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

1  –  Restrictions

    SYSLCK privilege is required to shut down detached PMDF
    processes.

2  –  Prompts

    Comcomponent

3  –  Parameters

 component

    Optional parameter which specifies a specific PMDF component
    to be shut down: DISPATCHER (which effectively shuts down
    all components handled by the PMDF Service Dispatcher), BN_
    SLAVE, CIRCUIT_CHECK, COUNTERS, FAX_RECEIVE, HTTP, IMAP (which
    shuts down both the system mailbox IMAP server and the PMDF
    MessageStore mailbox server), IMAP_SERVER (which shuts down the
    PMDF MessageStore mailbox server), POP_SERVER (which shuts down
    the PMDF MessageStore mailbox server), POP3 (which shuts down
    the system mailbox POP server and the PMDF MessageStore mailbox
    server), POPPASSD, SMTP, or the name of any Dispatcher service
    (as defined in the Dispatcher configuration file) such as those
    for PMDF-XGS, PMDF-LAN Lotus Notes, or PMDF-DIRSYNC Lotus Notes
    servers. If no component name is given then all active components
    will be shut down.

4  –  Description

    The SHUTDOWN utility is used to shut down detached PMDF
    processes. The default is to shut down processes on the node
    on which the command is executed. Use the /NODE qualifier with
    a specific node name to shut down processes on a different node
    in the cluster; use the /CLUSTER qualifier to shut down detached
    PMDF processes cluster wide. For the FAX_RECEIVE process, the
    /ID qualifier may be used 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 shutdown. If a component
    parameter is specified, then only detached processes associated
    with that component will be shut down. 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 Multithreaded Service Dispatcher.
    FAX_       Detached processes which process incoming FAXes.
    RECEIVE
    HTTP       HTTP server processes.
    IMAP       This shuts down both IMAP server processes serving out
               system mailboxes, and IMAP server processes serving
               out PMDF MessageStore mailboxes.
    IMAP_      IMAP server processes serving out PMDF MessageStore
    SERVER     mailboxes.
    POP_       PMDF MessageStore POP3 server processes; that is,
    SERVER     the processes serving out PMDF MessageStore and PMDF
               popstore mailboxes.
    POP3       This shuts down 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.

    In addition, any Dispatcher service may be specified by name
    (that name used in the Dispatcher configuration file) such as
    PMDF-XGS, PMDF-LAN Lotus Notes, or PMDF-DIRSYNC Lotus Notes
    servers.

    Detached PMDF processes will shutdown as soon as is convenient
    for the process to do so. They do so by performing an orderly
    shutdown, exiting the image they are running, and then exiting
    the process.

    Note that in the case of BN_SLAVE, no Local Mail Delivery (LMD)
    daemon is left running, not even the default Jnet daemon.

5  –  Command Qualifiers

5.1    /CLUSTER

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

5.2    /NODE

       /NODE[=node]

    By default, the SHUTDOWN 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 shut down processes on a different node, specify the
    node name. The node name must be the SCS cluster node name.

5.3    /ID

       /ID=pid

    For a FAX_RECEIVE process, the /ID qualifier may be used to
    specify that only the FAX_RECEIVE process with the given process
    id (pid) is to be affected. The /ID qualifier is only valid
    for FAX_RECEIVE; it is not valid for other processes such as
    Dispatcher services. Note that process id's are unique cluster
    wide and as such there is no need to also specify /NODE.

6  –  Examples

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

        $ PMDF SHUTDOWN/CLUSTER

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

        $ PMDF SHUTDOWN IMAP
        $ PMDF SHUTDOWN POP3

7  –  Error messages

  SYSTEM-F-TIMEOUT, device timeout

      After waiting two minutes for the component(s) in question to
      acknowledge the shutdown request, the PMDF SHUTDOWN utility
      returns control to the command line. The shutdown 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.