vparreset(1M)															     vparreset(1M)

NAME

       vparreset - reset a virtual partition

SYNOPSIS

       vp_name

DESCRIPTION

       The command simulates, at the virtual partition level, the hard reset (ReSet, RS) and soft reset (Transfer Of Control, TOC) operations sup-
       ported by server management processor commands.

       causes the vPars Monitor to simulate a hard (RS) reset or soft (TOC) reset of the specified virtual partition.	Either	operation  gathers
       new Processor Information Module (PIM) data, which is displayed unless the (quiet) option is also specified.

       Following  a  soft  (TOC)  reset,  the  specified virtual partition is normally rebooted if it has been configured with the attribute using
       either the or commands.	However when a virtual partition is reset during very early stages of loading, the virtual partition  may  not	be
       automatically  rebooted.   Also,  on hard-partitionable systems such as the HP Superdome, if there is a pending reboot for reconfiguration,
       the specified virtual partition will be booted until all the virtual partitions on that hard partition are shut down and the vPars  Monitor
       is rebooted.  Refer to the and the section titled "Performing a Reboot for Reconfig for an nPartition" for further details.

       Unintentional  use  of  the  command has serious consequences.  Therefore, the user is prompted to confirm the operation unless the (force)
       option is specified.

   Options
       recognizes the following command line options and arguments:

       Specifies the unique name of the virtual partition to be reset.
		      The virtual partition must be in a state other than or Required.

       The force option.
		      Omits the confirmation dialog before resetting the virtual partition.  This option is intended for use by scripts and  other
		      non-interactive applications.

       Simulates a hard (RS) reset instead of a TOC.
		      Displays	current PIM data before resetting unless the option is also specified.	It also inhibits the autoboot behavior, as
		      does the command.  Therefore can be used to break out of a reboot loop.  Because overrides  the  autoboot  setting  for  the
		      specified virtual partition, the virtual partition must be manually restarted using or

		      With  the  option,  the virtual partition operating system is abruptly shutdown and no operating system crash dump is saved.
		      Therefore, HP recommends using the (soft reset) option instead of the option to save a crash dump when resetting.

       Bypasses the display of current PIM data when resetting the virtual partition.

       Simulates a TOC reset.
		      Displays current PIM data before resetting unless the option is also specified.

		      The TOC reset is also the default operation of the command, applied if neither the nor option is specified.

		      The and options cannot both be specified in the same command.

SECURITY RESTRICTIONS

       This command is restricted to processes owned by superuser.

       When virtual partition flexible administrative capability is enabled, a virtual partition can only be reset from within a  Designated-Admin
       virtual partition.

RETURN VALUE

       The command exits with one of the following values:

       Successful completion.
       One or more error conditions occurred.

WARNINGS

       The option causes an abrupt system shutdown and no operating system crash dump is saved.  Refer to the option explanation for more informa-
       tion.

EXAMPLES

       Perform a TOC reset on the virtual partition called dumping the PIM data:

       Perform a hard reset on virtual partition skipping the confirmation dialog:

ERRORS

       displays error messages on standard error for any of the following conditions:

       o  A required option is omitted.

       o  An unknown option is specified.

       o  A value is omitted for an argument that requires one, or a value is specified for an argument which does not take one.

       o  vp_name does not exist in the monitor database, or is in the wrong state.

       o  Both the and options are specified.

       o  The command and the vPars Monitor are at different revision levels.  This message is only a warning.	The command continues.

       o  When the virtual partition flexible administrative capability is enabled and the local virtual partition is not a Designated-Admin  vir-
	  tual partition.

AUTHOR

       was developed by the Hewlett-Packard Company.

SEE ALSO

       vparadmin(1M),  vparboot(1M),  vparconfig(1M), vparcreate(1M), vpardump(1M), vparefiutil(1M), vparenv(1M), vparextract(1M), vparmodify(1M),
       vparreloc(1M), vparremove(1M), vparstatus(1M), vparutil(1M), vparresources(5), vpartition(5), vpmon(5).

																     vparreset(1M)