Activate, deactivate, reset, stop, or get status information

Several main options follow a simple command syntax that requires specifications for one or more LPARs and the corresponding access data.

LPAR mode: -a, -d, -r, -o, -g options


1  snipl +  <image_name> %lpar-access-data
1   -a?  -F
2.1!  --profilename <defaultprofile>(1)
2.1?  --profilename <filename>
1   -d?  -F
1   -r?  -F
1  -o
1  -g
Notes:
  • 1 If not specified, the HMC or SE default profile for the specified LPAR is used.
Where:
<image_name>
specifies an LPAR. 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.
-a or --activate
activates the specified LPARs.
--profilename <filename>
specifies an activation profile. If omitted, the SE or an HMC default profile for the specified LPAR is used.
-d or --deactivate
deactivates the specified LPARs.
-r or --reset
resets the specified LPARs.
-o or --stop
stops all CPUs for the specified LPARs.
-g or --getstatus
returns the status for the specified LPARs.
-F or --force
unconditionally forces the operation.

Examples

  • The following command deactivates an LPAR SZ01LP02 with the force option: 
    # snipl SZ01LP02 -L 192.0.2.4 -e -P -d -F
Enter password: 
Warning : No default configuration file could be found/opened.
processing......
SZ01LP02: acknowledged.
  • The following command retrieves the status for an LPAR SZ01LP03: 
    # snipl SZ01LP03 -L 192.0.2.4 -e -P -g
Enter password: 
Warning : No default configuration file could be found/opened.
status of sz01lp03:  operating
  • The following command retrieves the status 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 -g
Enter password: 
Warning : No default configuration file could be found/opened.
status of SZ02-SZ02LP03:  operating