Restart detached PMDF processes.
PMDF RESTART [component]
Command Qualifiers Defaults /CLUSTER /NODE /NODE[=node] /NODE /ID=pid /NODE
SYSLCK privilege is required to restart detached PMDF processes.
componentOptional parameter which specifies a specific PMDF component to be restarted, such as BN_SLAVE, CIRCUIT_CHECK, COUNTERS, DISPATCHER, FAX_RECEIVE, HTTP, IDENT, 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, IDENT (Process Software MultiNet sites only), 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.
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_backprocedure) 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. IDENT IDENT server processes (Process Software MultiNet sites only). 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.
/CLUSTERWhen 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=pidWhen 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.
To restart cluster-wide all detached processes, simply use the command
To only restart, for instance, IMAP and POP3 servers on the current node, use the commands
$ PMDF RESTART/CLUSTER
$ PMDF RESTART IMAP $ PMDF RESTART POP3
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.