Perform an IPL operation from a CCW device

To IPL an LPAR from a CCW device, snipl requires specifications for the LPAR, the corresponding access data, and the IPL device. There are also several optional parameters.

LPAR mode: IPL from CCW

Where:

<image_name>

specifies the LPARs for which to perform the IPL. If multiple LPARs are specified, the same IPL device and IPL parameters are used for all of them. If snipl directly accesses the SE, this is the LPAR name as defined in the hardware setup.

If snipl accesses the SE through an HMC, the specification has the format <mainframe_system>-<lpar_name> where <mainframe_system> is the name that identifies the mainframe on the HMC. If you are using a snipl configuration file that defines an alias for an LPAR, you can specify the alias.

SE Example: lpar204

HMC Example: z02-lpar204

A snipl command applies to one or more LPARs that are controlled by the same HMC or SE. If multiple LPARs are specified, it is assumed that all LPARs are controlled by the same HMC or SE as the first LPAR. Other LPARs are ignored.

|lpar-access-data|

see Specifying access data for LPAR mode.

-l or --load

performs an IPL for the specified LPARs.

-F or --force

unconditionally forces the IPL operation.

-A <loadaddress> or --address_load <loadaddress>

specifies the hexadecimal four-digit device number of the IPL device. To use a device from a subchannel set other than 0, specify five digits: The subchannel set ID followed by the device number, for example 15199. The default is subchannel set 0. If the - A parameter is omitted, the IPL device of the most recent IPL of the LPAR is used.

--parameters_load <string>

specifies a parameter string for IPL. If this parameter is omitted, the string of the most recent IPL of the LPAR is used.

--load_timeout <timeout>

specifies the maximum time for load completion in seconds. The timeout must be in the range of 60 - 600 seconds. The default timeout is 60 seconds.

If the timeout expires, control is returned without an indication about the success of the IPL operation.

--noclear

prevents the memory from being cleared before loading.

--storestatus

stores status before performing the IPL. This option implies --noclear and also prevents the main memory from being cleared before loading.

Examples:

The following command performs an IPL from a CCW device with bus ID 0.0.5119 for an LPAR SZ02LP03 on a mainframe system that is identified as SZ02 on an HMC with an IP address 2001:0db8::11a0:

# snipl SZ02-SZ02LP03 -L 2001:0db8::11a0 -e -P -l -A 5119
Enter password: 
Warning : No default configuration file could be found/opened.
processing......
SZ02-SZ02LP03: acknowledged.

To perform an IPL from a CCW device in subchannel set 1 with the bus ID 0.1.5119 for an LPAR SZ03LP00:
```
% snipl SZ03LP00 -L 192.0.2.4 -e -P -l -A 15119
```