Shut down detached PMDF processes.

Syntax

PMDF SHUTDOWN [component]

Command Qualifiers	Defaults
/CLUSTER	/NODE
/NODE[=node]	/NODE
/ID=pid	/NODE

restrictions

SYSLCK privilege is required to shut down detached PMDF processes.

prompts

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). If no component name is given then all active components will be shut down.

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_CHECK	Detached process which monitors loopback message delivery.
COUNTERS	Detached processes which synchronize the channel counters.
DISPATCHER	Multithreaded Service Dispatcher.
FAX_RECEIVE	Detached processes which process incoming FAXes.
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_SERVER	IMAP server processes serving out PMDF MessageStore mailboxes.
POP_SERVER	PMDF MessageStore POP3 server processes; that is, 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).

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.

Command Qualifiers

/CLUSTER

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

/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.

/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.

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

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.