#!/usr/bin/ksh93
################################################################
function usagemsg_mkviolpar {
  print "
Program: mkviolpar

Create a VIO Server LPAR on a Power 5 HMC managed system.

Usage: ${1##*/} [-?vV] -h HMCname -l LPARname [-u HMCuser]
                 [-s SystemName] [-w #] [-L] [-S]
  Where:
    -v = Verbose mode - displays mkviolpar function info
    -V = Very Verbose Mode - debug output displayed
    -h = HMC machine name
    -u = HMC user name
    -l = LPAR name to create
    -s = System name on which to create the LPAR
    -L = Display a list of systems managed by the specified HMC
    -w = Workgroup management number (default:1)
    -S = Create Secondary VIO Server (default:Primary)

Author: Dana French (dfrench@mtxia.com) Copyright 2005
\"AutoContent\" enabled
"
}
################################################################
#### 
#### Description:
#### 
#### This script is a licensed product and can be obtained 
#### by contacting Mt Xia or TriParadigm.
#### 
####     http://www.mtxia.com
####     http://www.triparadigm.com
#### 
#### This script will create a VIO Server LPAR on a Power 5 HMC
#### managed system.  The resulting LPAR will require manual
#### configuration of physical and/or virtual I/O adapters.
#### 
#### Environment variables may be specified to change the default 
#### values of the LPAR template.
#### 
#### Assumptions:
#### 
#### This script assumes "ssh" connectivity to the HMC, but
#### not necessarily "password-less" login.  
#### 
#### Dependencies:
#### 
#### Connectivity with the HMC using "ssh" is the only
#### communication mechanism supported at this time.
#### 
#### Products:
#### 
#### The product of this script is a configured LPAR and profile
#### on an HMC managed system.  No I/O is configured thru
#### this script, that is left for manual configuration.
#### 
#### Configured Usage:
#### 
#### Environment variables that can be specified to change the
#### default values of the LPAR template:
#### 
####     LPAR_ENV
####     WORK_GROUP_ID
####     MIN_MEM
####     DESIRED_MEM
####     MAX_MEM
####     PROC_MODE
####     MIN_PROC_UNITS
####     DESIRED_PROC_UNITS
####     MAX_PROC_UNITS
####     MIN_PROCS
####     DESIRED_PROCS
####     MIN_PROCS
####     DESIRED_PROCS
####     MAX_PROCS
####     SHARING_MODE
####     UNCAP_WEIGHT
####     BOOT_MODE
####     CONN_MONITORING
#### 
#### Details:
#### 
################################################################