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.