Synopsis
PONCLI.EXE HostName [/IP:IPAddress /MAC:MACAddress /SNM:SubnetMask] [/WT:WaitTime] [/RC:nn /RI: nnnn]
Description
The PONCLI.EXE command powers on the client that supports a Wakeup on LAN feature, which enables a remote client to be booted automatically.
This command also allows you to power on the client on another subnet if in a TCP/IP environment.
This command is not supported in IPv6 environments. Use this command in IPv4 environments or in environments where dual stack is supported.
Parameters
HostName
Specifies a host name of the client to be powered on.
Specify the host name in HostName within 15 alphanumeric characters. If the host name contains a space character, enclose it in double quotation marks.
/IP:IPAddress
Specifies an IP address of the client to be powered on. The IP address is specified in a decimal string, which is something similar to "133.161.222.110".
If omitted, the command reads the host information definition file to retrieve the IP address of the target client.
/MAC:MACAddress
Specifies a MAC address of the client to be powered on. The MAC address is specified in a hexadecimal string, which is similar to "00-00-0E-9D-2C-38". If omitted, the command reads the host information definition file to retrieve the MAC address of the target client.
/SNM:SubnetMask
Specifies a subnet mask of the client to be powered on. The subnet mask is specified in a decimal string, which is something similar to "255.255.255.0".
If omitted, the command reads the host information definition file to retrieve the subnet mask of the target client.
/WT:WaitTime
Specifies the wait time to ensure the client is powered on. Specify an integer value between 1 and 999 for WaitTime in seconds.
If omitted, waiting is not performed.
/RC:nn
Specifies the retry count in case an error occurs in powering on the client.
Specify an integer value between 0 and 99 for nn. Setting any other value results in an error. If omitted, no retry is performed.
/RI:nnnn
Specifies the retry interval in case an error occurs. This parameter is valid if 1 or a greater value is specified to nn in the /RC parameter.
Specify an integer value between 0 and 9999 (in seconds) for nnnn. Setting any other value results in an error. The default value is 0.
Return Values
Return value | Meaning |
|---|---|
0 | Completed |
Value other than 0 | Abended |
Command Location
Systemwalker Operation Manager installation directory\MpWalker.JM\bin
Example
In this example, the client "foo" is powered on under the following condition.
133.161.222.110
00-00-0E-9D-2C-38
255.255.255.0
PONCLI.EXE foo /IP:133.161.222.110 /MAC:00-00-0E-9D-2C-38 /SNM:255.255.255.0
Execution Results/Output Format
After the command has been through processing, the information at command completion is output to the standard output.
The contents to be output are shown below:
[Process start time] MM-DD-YYYY HH:MM:SS [Host name] HostName [MAC address] MAC address [IP address] IP address [Subnet mask] Subnet mask [Retry count] Number of retries performed [Error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
In [Error], "None" is output if the command completed successfully. A message is output if the command is canceled or failed. For details on the messages, see the Systemwalker Operation Manager Message Guide.
If an error occurs before power on, a message is output in the following format:
[Process start time] MM-DD-YYYY HH:MM:SS [Command error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
For details on the messages, see the Systemwalker Operation Manager Message Guide.
Cautions
To execute this command by using the host information definition file, define the client information in the host information definition file in advance. For details, see the Systemwalker Operation Manager Installation Guide.
The client that can be powered on using this command must be a computer supporting a Wakeup on LAN feature. To turn on the power in a client on another subnet, you need to configure the network hardware (e.g., router) so that the broadcast packet sent from the server can be received by the network of the target computer. For details about the settings method, see the documentation for your networking hardware.
To check whether the broadcast packet can arrive at the destination or not, you can use the ping command by submitting it on a command prompt on the Systemwalker Operation Manager server side. And if it is not responded, the broadcast packet cannot reach the destination.
For example, to ping the remote network host of having the IP address "10.90.100.100" and subnet mask "255.255.255.0", use the "ping 10.90.100.255" command.
In response to connection of a power source, the Wakeup on LAN packet is passed to the network host to which the target client belongs, and immediately after that, this command is returned as completed successfully. To wait to ensure that the computer system is booted after power on, specify the /WT parameter.
