Restart detached PMDF processes.

Syntax

PMDF RESTART [component]

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

restrictions

SYSLCK privilege is required to restart detached PMDF processes.

prompts

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, or SMTP. 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, and SMTP servers. If no component name is given then all active components will be restarted.

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_CHECK	Detached process which monitors loopback message 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_RECEIVE	Detached processes which process incoming FAXes.
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_SERVER	IMAP server processes serving out PMDF MessageStores mailboxes.
POP_SERVER	PMDF MessageStore POP3 server processes; that is, 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.

Command Qualifiers

/CLUSTER

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

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

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

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

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.