HPEStoragePowerShellToolkit

3.1.0.0

CLI/NodeSubsystemManagement.psm1

####################################################################################
## © 2020,2021 Hewlett Packard Enterprise Development LP
##
## Permission is hereby granted, free of charge, to any person obtaining a
## copy of this software and associated documentation files (the "Software"),
## to deal in the Software without restriction, including without limitation
## the rights to use, copy, modify, merge, publish, distribute, sublicense,
## and/or sell copies of the Software, and to permit persons to whom the
## Software is furnished to do so, subject to the following conditions:
##
## The above copyright notice and this permission notice shall be included
## in all copies or substantial portions of the Software.
##
## THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
## IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
## FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
## THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
## OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
## ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
## OTHER DEALINGS IN THE SOFTWARE.
##
## File Name: NodeSubsystemManagement.psm1
## Description: Node Subsystem Management cmdlets
##
## Created: November 2019
## Last Modified: November 2019
## History: v3.0 - Created
#####################################################################################

$Info = "INFO:"
$Debug = "DEBUG:"
$global:VSLibraries = Split-Path $MyInvocation.MyCommand.Path
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

############################################################################################################################################
## FUNCTION Test-CLIObject
############################################################################################################################################
Function Test-CLIObject 
{
Param(     
    [string]$ObjectType, 
    [string]$ObjectName ,
    [string]$ObjectMsg = $ObjectType, 
    $SANConnection = $global:SANConnection
    )

    $IsObjectExisted = $True
    $ObjCmd = $ObjectType -replace ' ', '' 
    $Cmds = "show$ObjCmd $ObjectName"
    
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmds
    if ($Result -like "no $ObjectMsg listed")
    {
        $IsObjectExisted = $false
    }
    return $IsObjectExisted
    
} # End FUNCTION Test-CLIObject

##########################################################################
######################### FUNCTION Find-Node #########################
##########################################################################
Function Find-Node()
{
<#
  .SYNOPSIS
   Find-Node - Locate a node by blinking its LEDs.

  .DESCRIPTION
   The Find-Node command helps locate a particular node or its components by
   illuminating LEDs on the node.

  .EXAMPLE

  .PARAMETER T
   Specifies the number of seconds to illuminate the LEDs. For HPE 3PAR 7000 and
   HPE 3PAR 8000 storage systems, the default time to illuminate the LEDs is 15
   minutes with a maximum time of one hour. For STR (Safe to Remove) systems,
   the default time is one hour with a maximum time of one week. For all
   other systems, the default time is 60 seconds with a maximum time of
   255 seconds. Issuing "Find-Node -t 0 <nodeid>" will turn off LEDs
   immediately.

  .PARAMETER Ps
   Only the service LED for the specified power supply will blink.
   Accepted values for <psid> are 0 and 1.

  .PARAMETER Pci
   Only the service LED corresponding to the PCI card in the specified slot
   will blink. Accepted values for <slot> are 0 through 8.

  .PARAMETER Fan
   Only the service LED on the specified node fan module will blink.
   Accepted values for <fanid> are 0 and 1 for HPE 3PAR 10000 systems.
   Accepted values for <fanid> are 0, 1 and 2 for HPE 3PAR 20000 systems.

  .PARAMETER Drive
   Only the service LED corresponding to the node's internal drive will
   blink.

  .PARAMETER Bat
   Only the service LED on the battery backup unit will blink.

  .PARAMETER NodeID
    Indicates which node the locatenode operation will act on. Accepted
    values are 0 through 7.

   
  .Notes
    NAME: Find-Node
    LASTEDIT 22/11/2019
    KEYWORDS: Find-Node
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [System.String]
    $T,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $Ps,

    [Parameter(Position=2, Mandatory=$false)]
    [System.String]
    $Pci,

    [Parameter(Position=3, Mandatory=$false)]
    [System.String]
    $Fan,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $Drive,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $Bat,

    [Parameter(Position=6, Mandatory=$True)]
    [System.String]
    $NodeID,

    [Parameter(Position=7, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Find-Node - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Find-Node since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Find-Node since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " locatenode "

 if($T)
 {
    $Cmd += " -t $T "
 }

 if($Ps)
 {
    $Cmd += " -ps $Ps "
 }

 if($Pci)
 {
    $Cmd += " -pci $Pci "
 }

 if($Fan)
 {
    $Cmd += " -fan $Fan "
 }

 if($Drive)
 {
    $Cmd += " -drive "
 }

 if($Bat)
 {
    $Cmd += " -bat "
 }

 if($NodeID)
 {
    $Cmd += " $NodeID "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Find-Node command -->" INFO: 
 
 Return $Result
} ## End-of Find-Node

##########################################################################
######################### FUNCTION Find-System #######################
##########################################################################
Function Find-System()
{
<#
  .SYNOPSIS
    Locate a system by illuminating or blinking its LEDs.

  .DESCRIPTION
    The Find-System command helps locate a storage system by illuminating the
    blue UID LEDs or by alternating the node status LEDs amber and green on all
    nodes of the storage system. By default, the LEDs in all connected cages
    will illuminate blue or will oscillate green and amber, depending on the
    system or cage model.
    
  .PARAMETER T
    Specifies the number of seconds to illuminate or blink the LEDs.
    default may vary depending on the system model. For example, the
    default time for HPE 3PAR 7000 and HPE 3PAR 8000 storage systems is 15
    minutes, with a maximum time of one hour. The default time for 9000 and
    20000 systems is 60 minutes, with a maximum of 604,800 seconds (one
    week).
  
  .PARAMETER NodeList
    Specifies a comma-separated list of nodes on which to illuminate
    or blink LEDs. The default is all nodes.
    
  .PARAMETER NoCage
    Specifies that LEDs on the drive cages should not illuminate
    or blink. The default is to illuminate or blink LEDs for all cages in the
    system.
  
  .EXAMPLE
    In the following example, a storage system is identified by illuminating
    or blinking the LEDs on all drive cages in the system for 90 seconds.
    Find-System -T 90

  .Notes
    NAME: Find-System
    LASTEDIT 22/11/2019
    KEYWORDS: Find-System
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
    param(
    [Parameter(Position=0, Mandatory=$false)]
    [System.String]
    $T,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $NodeList,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $NoCage,
    
    [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Find-System - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Find-System since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Find-System since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

 $Cmd = " locatesys "

 if($T)
 {
    $Cmd += " -t $T "
 }

 if($NodeList)
 {
    $Cmd += " -nodes $NodeList "
 }

 if($NoCage)
 {
    $Cmd += " -nocage "
 }
 
 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Find-System command -->" INFO: 
 
 Return $Result
} ## End-of Find-System

#######################################################################################################
## FUNCTION Get-System
#######################################################################################################
Function Get-System{
<#
  .SYNOPSIS
    Command displays the Storage system information.
  
  .DESCRIPTION
    Command displays the Storage system information.
        
  .EXAMPLE
    Get-System
    Command displays the Storage system information.such as system name, model, serial number, and system capacity information.
    
  .EXAMPLE
    Get-System -SystemCapacity
    Lists Storage system space information in MB(1024^2 bytes)

  .EXAMPLE
    Get-System -DevType FC
  
  .PARAMETER Detailed
    Specifies that more detailed information about the system is displayed.

  .PARAMETER SystemParameters
    Specifies that the system parameters are displayed.

  .PARAMETER Fan
    Displays the system fan information.

  .PARAMETER SystemCapacity
    Displays the system capacity information in MiB.

  .PARAMETER vvSpace
    Displays the system capacity information in MiB with an emphasis on
    VVs.

  .PARAMETER Domainspace
    Displays the system capacity information broken down by domain in MiB.

  .PARAMETER Descriptor
    Displays the system descriptor properties.

  .PARAMETER DevType FC|NL|SSD
    Displays the system capacity information where the disks must have a
    device type string matching the specified device type; either Fast
    Class (FC), Nearline (NL), Solid State Drive (SSD). This option can
    only be issued with -space or -vvspace.
        
  .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
  .Notes
    NAME: Get-System
    LASTEDIT: 22/11/2019
    KEYWORDS: Get-System
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0

 #>
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory = $false)]
        [switch]
        $Detailed,

        [Parameter(Position = 1, Mandatory = $false)]
        [switch]
        $SystemParameters,
        
        [Parameter(Position = 2, Mandatory = $false)]
        [switch]
        $Fan,
        
        [Parameter(Position = 3, Mandatory = $false)]
        [switch]
        $SystemCapacity,
        
        [Parameter(Position = 4, Mandatory = $false)]
        [switch]
        $vvSpace,
        
        [Parameter(Position = 5, Mandatory = $false)]
        [switch]
        $DomainSpace,
        
        [Parameter(Position = 6, Mandatory = $false)]
        [switch]
        $Descriptor,
        
        [Parameter(Position = 7, Mandatory = $false)]
        [System.String]
        $DevType,
        
        [Parameter(Position = 8, Mandatory = $false, ValueFromPipeline = $true)]
        $SANConnection = $global:SANConnection       
    )
    
    Write-DebugLog "Start: In Get-System - validating input values" $Debug 

    #check if connection object contents are null/empty
    if (!$SANConnection) {                
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if ($Validate1 -eq "Failed") {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if ($Validate2 -eq "Failed") {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Get-System since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Get-System since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $cliresult1 = Test-PARCli -SANConnection $SANConnection
    if (($cliresult1 -match "FAILURE :")) {
        write-debuglog "$cliresult1" "ERR:" 
        return $cliresult1
    }
    $sysinfocmd = "showsys "
    
    if ($Detailed) {
        $sysinfocmd += " -d "        
    }
    if ($SystemParameters) {
        $sysinfocmd += " -param "        
    }
    if ($Fan) {
        $sysinfocmd += " -fan "        
    }
    if ($SystemCapacity) {
        $sysinfocmd += " -space "        
    }
    if ($vvSpace) {
        $sysinfocmd += " -vvspace "        
    }
    if ($DomainSpace) {
        $sysinfocmd += " -domainspace "        
    }
    if ($Descriptor) {
        $sysinfocmd += " -desc "        
    }
    if ($DevType) {
        $sysinfocmd += " -devtype $DevType"        
    }
    write-debuglog "Get system information " "INFO:" 
    write-debuglog "Get system fan information cmd -> sysinfocmd " "INFO:"
    $Result3 = Invoke-CLICommand -Connection $SANConnection -cmds  $sysinfocmd    
    if ($Fan -or $DomainSpace -or $sysinfocmd -eq "showsys ") {
        $incre = "True"
        $FirstCnt = 1
        $rCount = $Result3.Count
        $noOfColumns = 0        

        if ($Fan) {
            $FirstCnt = 0
        }
        if ($DomainSpace) {
            $rCount = $Result3.Count - 3
        }
        $tempFile = [IO.Path]::GetTempFileName()
        
        if ($Result3.Count -gt 1) {
            foreach ($s in  $Result3[$FirstCnt..$rCount] ) {                
                $s = [regex]::Replace($s, "^ +", "")
                if (!$DomainSpace) {
                    $s = [regex]::Replace($s, "-", "")
                }                
                $s = [regex]::Replace($s, " +", ",")

                if ($noOfColumns -eq 0) {
                    $noOfColumns = $s.Split(",").Count;
                }
                else {
                    $noOfValues = $s.Split(",").Count;
                    if ($noOfValues -ge $noOfColumns) {                        
                        [System.Collections.ArrayList]$CharArray1 = $s.Split(",");

                        if ($noOfValues -eq 12) {
                            $CharArray1[2] = $CharArray1[2] + " " + $CharArray1[3];
                            $CharArray1.RemoveAt(3);
                            $s = $CharArray1 -join ',';
                        }
                        elseif ($noOfValues -eq 13) {
                            $CharArray1[2] = $CharArray1[2] + " " + $CharArray1[3] + " " + $CharArray1[4];
                            $CharArray1.RemoveAt(4);
                            $CharArray1.RemoveAt(3);
                            $s = $CharArray1 -join ',';
                        }
                    }
                }
                if ($DomainSpace) {
                    if ($incre -eq "True") {                        
                        $sTemp = $s.Split(',')                                            
                        $sTemp[1] = "Used_Legacy(MiB)"                
                        $sTemp[2] = "Snp_Legacy(MiB)"
                        $sTemp[3] = "Base_Private(MiB)"                
                        $sTemp[4] = "Snp_Private(MiB)"
                        $sTemp[5] = "Shared_CPG(MiB)"                
                        $sTemp[6] = "Free_CPG(MiB)"
                        $sTemp[7] = "Unmapped(MiB)"    
                        $sTemp[8] = "Total(MiB)"
                        $sTemp[9] = "Compact_Efficiency"
                        $sTemp[10] = "Dedup_Efficiency"
                        $sTemp[11] = "Compress_Efficiency"
                        $sTemp[12] = "DataReduce_Efficiency"
                        $sTemp[13] = "Overprov_Efficiency"
                        
                        $newTemp = [regex]::Replace($sTemp, "^ ", "")            
                        $newTemp = [regex]::Replace($sTemp, " ", ",")                
                        $newTemp = $newTemp.Trim()
                        $s = $newTemp                            
                    }
                }                
                
                Add-Content -Path $tempFile -Value $s                
                $incre = "False"
            }
            
            Import-Csv $tempFile            
            del $tempFile
        }
        else {
            del $tempFile
            write-host""
            return    $Result3            
        }
    }        
    else {
        write-host""
        return    $Result3    
    }    
}
### END Get-System

############################################################################################################################################
## FUNCTION Ping-RCIPPorts
############################################################################################################################################
Function Ping-RCIPPorts
{
<#
  .SYNOPSIS
    Verifying That the Servers Are Connected

  .DESCRIPTION
    Verifying That the Servers Are Connected.
    
  .EXAMPLE
    Ping-RCIPPorts -IP_address 192.168.245.5 -NSP 0:3:1

  .EXAMPLE
    Ping-RCIPPorts -count 2 -IP_address 192.168.245.5 -NSP 0:3:1

  .EXAMPLE
    Ping-RCIPPorts -wait 2 -IP_address 192.168.245.5 -NSP 0:3:1

  .EXAMPLE
    Ping-RCIPPorts -size 2 -IP_address 192.168.245.5 -NSP 0:3:1

  .EXAMPLE
    Ping-RCIPPorts -PF -IP_address 192.168.245.5 -NSP 0:3:1
 
  .PARAMETER IP_address
    IP address on the secondary system to ping
    
  .PARAMETER NSP
    Interface from which to ping, expressed as node:slot:port
    
  .PARAMETER pf
    Prevents packet fragmentation. This option can only be used with the
    rcip ping subcommand.
    
  .PARAMETER size
    Specifies the packet size. If no size is specified, the option defaults
    to 64. This option can only be used with the rcip ping subcommand.

  .PARAMETER wait
    Specifies the maximum amount of time to wait for replies. The default is
    the number of requested replies plus 5. The maximum value is 30. This
    option can only be used with the rcip ping subcommand.
    
  .PARAMETER count
    Specifies the number of replies accepted by the system before
    terminating the command. The default is 1; the maximum value is 25.
    
  .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
  .Notes
    NAME: Ping-RCIPPorts
    LASTEDIT: 22/11/2019
    KEYWORDS: Ping-RCIPPorts
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0
 #Requires HPE 3par cli.exe
 #>
 
[CmdletBinding()]
    Param(            
            [Parameter(Position=0, Mandatory=$false, ValueFromPipeline=$true)]
            [System.String]
            $IP_address,
            
            [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
            [System.String]
            $NSP,
            
            [Parameter(Position=2, Mandatory=$false, ValueFromPipeline=$true)]
            [System.String]
            $count,
            
            [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]
            [System.String]
            $wait,
            
            [Parameter(Position=4, Mandatory=$false, ValueFromPipeline=$true)]
            [System.String]
            $size,
            
            [Parameter(Position=5, Mandatory=$false, ValueFromPipeline=$true)]
            [switch]
            $PF,
            
            [Parameter(Position=6, Mandatory=$false, ValueFromPipeline=$true)]
            $SANConnection = $global:SANConnection 
        )

    Write-DebugLog "Start: In Ping-RCIPPorts - validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {            
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Ping-RCIPPorts since connection object values are null/empty" $Debug
                return
            }
        }
    }
    $plinkresult = Test-PARCli -SANConnection $SANConnection 
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }
        
    $Cmds="controlport rcip ping "
    
    if($count)
    {
        $Cmds +=" -c $count "
    }
    if($wait)
    {
        $Cmds +=" -w $wait "
    }
    if($size)
    {
        $Cmds +=" -s $size "
    }
    if($PF)
    {
        $Cmds +=" -pf"
    }
    
    if($IP_address)
    {
        $Cmds +=" $IP_address "
    }
    else
    {
        return "IP_address required "
    }
    
    if($NSP)
    {
        $Cmds +=" $NSP "
    }
    else
    {
        return "NSP required Ex: 1:1:1 "
    }
    
    $result = Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds    
    return $result
    
} # End Function Ping-RCIPPorts

##########################################################################
######################### FUNCTION Set-Battery #######################
##########################################################################
Function Set-Battery()
{
<#
  .SYNOPSIS
   Set-Battery - set a battery's serial number, expiration date, reset test
   logs or reset recharge time.

  .DESCRIPTION
   The Set-Battery command may be used to set battery information such as
   the battery's expiration date, its recharging time, and its serial number.
   This information gives the system administrator a record or log of the
   battery age and battery charge status.

  .EXAMPLE
    The following example resets the battery test log and the recharging time
    for a newly installed battery on node 2, power supply 1, and battery 0, with
    an expiration date of July 4, 2006:
    
    Set-Battery -X " 07/04/2006" -Node_ID 2 -Powersupply_ID 1 -Battery_ID 0

  .PARAMETER S
   Specifies the serial number of the battery using a limit of 31
   alphanumeric characters. This option is not supported on HPE 3PAR
   10000 and 20000 systems.

  .PARAMETER X
   Specifies the expiration date of the battery (mm/dd/yyyy). The
   expiration date cannot extend beyond 2037.

  .PARAMETER L
   Specifies that the battery test log is reset and all previous test log
   entries are cleared.

  .PARAMETER R
   Specifies that the battery recharge time is reset and that 10 hours of
   charging time are required for the battery to be fully charged.
   This option is deprecated.
   
  .PARAMETER Node_ID
    Specifies the node number where the battery is installed. Node_ID is
    an integer from 0 through 7.

  .PARAMETER Powersupply_ID
    Specifies the power supply number on the node using either 0 (left
    side from the rear of the node) or 1 (right side from the rear of
    the node).

  .PARAMETER Battery_ID
    Specifies the battery number on the power supply where 0 is the first
    battery.

  .Notes
    NAME: Set-Battery
    LASTEDIT 22/11/2019
    KEYWORDS: Set-Battery
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [System.String]
    $S,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $X,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $L,

    [Parameter(Position=3, Mandatory=$false)]
    [switch]
    $R,

    [Parameter(Position=4, Mandatory=$True)]
    [System.String]
    $Node_ID,

    [Parameter(Position=5, Mandatory=$True)]
    [System.String]
    $Powersupply_ID,

    [Parameter(Position=6, Mandatory=$True)]
    [System.String]
    $Battery_ID,

    [Parameter(Position=7, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Set-Battery - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
  #check if connection object contents are null/empty
  $Validate1 = Test-CLIConnection $SANConnection
  if($Validate1 -eq "Failed")
  {
    #check if global connection object contents are null/empty
    $Validate2 = Test-CLIConnection $global:SANConnection
    if($Validate2 -eq "Failed")
    {
        Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
        Write-DebugLog "Stop: Exiting Set-Battery since SAN connection object values are null/empty" $Debug 
        Return "Unable to execute the cmdlet Set-Battery since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
    }
  }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " setbattery "

 if($S)
 {
    $Cmd += " -s $S "
 }

 if($X)
 {
    $Cmd += " -x $X "
 }

 if($L)
 {
    $Cmd += " -l "
 }

 if($R)
 {
    $Cmd += " -r "
 }

 if($Node_ID)
 {
    $Cmd += " $Node_ID "
 }

 if($Powersupply_ID)
 {
    $Cmd += " $Powersupply_ID "
 }

 if($Battery_ID)
 {
    $Cmd += " $Battery_ID "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Set-Battery command -->" INFO: 
 
 Return $Result
} ## End-of Set-Battery

############################################################################################################################################
## FUNCTION Set-FCPorts
############################################################################################################################################

Function Set-FCPorts
{
<#
    .SYNOPSIS
     Configure FC ports

    .DESCRIPTION
     Configure FC ports

    .PARAMETER Port
     Use syntax N:S:P

    .PARAMETER DirectConnect
     If present, configure port for a direct connection to a host
     By default, the port is configured as fabric attached

    .EXAMPLE
     Set-FCPorts -Ports 1:2:1
     Configure port 1:2:1 as Fibre Channel connected to a fabric
     
    .EXAMPLE
     Set-FCPorts -Ports 1:2:1 -DirectConnect
     Configure port 1:2:1 as Fibre Channel connected to host ( no SAN fabric)
     
    .EXAMPLE
     Set-FCPorts -Ports 1:2:1,1:2:2
     Configure ports 1:2:1 and 1:2:2 as Fibre Channel connected to a fabric
        
  .Notes
    NAME: Set-FCPorts
    LASTEDIT: 22/11/2019
    KEYWORDS: Set-FCPorts
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0
 #Requires HPE 3par cli.exe
 #>
 
[CmdletBinding()]
    Param(
            [Parameter(Position=0, Mandatory=$false)]
            [System.String]
            $Ports,
            
            [Parameter(Position=1, Mandatory=$false)]
            [Switch]
            $DirectConnect,
            
            [Parameter(Position=2, Mandatory=$false)]
            [Switch]
            $Demo,
            
            [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]
            $SANConnection = $global:SANConnection 
        )
    $Port_Pattern = "(\d):(\d):(\d)"    

    foreach ($P in $Ports)
    {
        if ( $p -match $Port_Pattern)
        {
            Write-DebugLog "Set port $p offline " $Info
            $Cmds = "controlport offline -f $p"
            Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
            
            $PortConfig = "point"
            $PortMsg    = "Fabric ( Point mode)"
            
            if ($DirectConnect)
            {
                $PortConfig = "loop"
                $PortMsg    = "Direct connection ( loop mode)"
            }
            Write-DebugLog "Configuring port $p as $PortMsg " $Info
            $Cmds= "controlport config host -ct $PortConfig -f $p"
            Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds

            Write-DebugLog "Resetting port $p " $Info
            $Cmds="controlport rst -f $p"
            Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds    
            
            Write-DebugLog "FC port $P is configured" $Info
            return 
        }
        else
        {
            Write-DebugLog "Port $p is not in correct format N:S:P. No action is taken" $Info
            return "FAILURE : Port $p is not in correct format N:S:P. No action is taken"
        }    
    }
    
} # END FUNCTION Set-FCPorts

############################################################################################################################################
## FUNCTION Set-HostPorts
############################################################################################################################################
Function Set-HostPorts
{
<#
  .SYNOPSIS
   Configure settings of the array
  
  .DESCRIPTION
    Configures with settings specified in the text file
        
  .EXAMPLE
    Set-HostPorts -FCConfigFile FC-Nodes.CSV
    Configures all FC host controllers on array
    
  .EXAMPLE
    Set-HostPorts -iSCSIConfigFile iSCSI-Nodes.CSV
    Configures all iSCSI host controllers on array
    
  .EXAMPLE
    Set-HostPorts -LDConfigFile LogicalDisks.CSV
    Configures logical disks on array
    
  .EXAMPLE
    Set-HostPorts -FCConfigFile FC-Nodes.CSV -iSCSIConfigFile iSCSI-Nodes.CSV -LDConfigFile LogicalDisks.CSV
    Configures FC, iSCSI host controllers and logical disks on array
        
  .EXAMPLE
    Set-HostPorts -RCIPConfiguration -Port_IP 0.0.0.0 -NetMask xyz -NSP 1:2:3>
    for rcip port
    
  .EXAMPLE
    Set-HostPorts -RCFCConfiguration -NSP 1:2:3>
    For RCFC port
 
  .PARAMETER FCConfigFile
    Specify the config file containing FC host controllers information
        
  .PARAMETER iSCSIConfigFile
    Specify the config file containing iSCSI host controllers information
        
  .PARAMETER LDConfigFile
    Specify the config file containing Logical Disks information
        
  .PARAMETER Demo
    Switch to list the commands to be executed
        
  .PARAMETE RCIPConfiguration
    Go for RCIP Configuration
        
  .PARAMETE RCFCConfiguration
    Go for RCFC Configuration
        
  .PARAMETE Port_IP
    port ip address
        
  .PARAMETE NetMask
    Net Mask Name
        
  .PARAMETE NSP
    NSP Name
            
  .Notes
    NAME: Set-HostPorts
    LASTEDIT: 22/11/2019
    KEYWORDS: Set-HostPorts
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0
 #Requires HPE 3par cli.exe
 #>
 
[CmdletBinding()]
    Param(
            [Parameter()]
            [System.String]
            $FCConfigFile,
            
            [Parameter()]
            [System.String]
            $iSCSIConfigFile,        
            
            [Parameter()]
            [System.String]
            $LDConfigFile,

            [Parameter()]
            [switch]
            $RCIPConfiguration,
            
            [Parameter()]
            [switch]
            $RCFCConfiguration,
            
            [Parameter()]
            [System.String]
            $Port_IP,
            
            [Parameter()]
            [System.String]
            $NetMask,
            
            [Parameter()]
            [System.String]
            $NSP,
            
            [Parameter()]
            [_SANConnection]
            $SANConnection = $global:SANConnection,
            
            [Parameter(Position=2)]
            [switch]$Demo

        )

    Write-DebugLog "Start: In Set-HostPorts- validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {    
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Set-HostPorts since SAN connection object values are null/empty" $Debug
                return " Unable to execute the cmdlet Set-HostPorts since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli -SANConnection $SANConnection 
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }

    # ---------------------------------------------------------------------
    # FC Config file here
    if (!(($FCConfigFile) -or ($iSCSIConfigFile) -or ($LDConfigFile) -or ($RCIPConfiguration) -or ($RCFCConfiguration))) 
    {
        return "FAILURE : No config file selected"
    }
    if ($RCIPConfiguration)
    {
        $Cmds="controlport rcip addr -f "
        if($Port_IP)
        {
            $Cmds=" $Port_IP "
        }
        else
        {
            return "port_IP required with RCIPConfiguration Option"
        }
        if($NetMask)
        {
            $Cmds=" $NetMask "
        }
        else
        {
            return "NetMask required with RCIPConfiguration Option"
        }
        if($NSP)
        {
            $Cmds=" $NSP "
        }
        else
        {
            return "NSP required with RCIPConfiguration Option"
        }
        $result = Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
        return $result
    }
    if ($RCFCConfiguration)
    {
        $Cmds="controlport rcfc init -f "    
        if($NSP)
        {
            $Cmds=" $NSP "
        }
        else
        {
            return "NSP required with RCFCConfiguration Option"
        }
        $result = Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
        return $result
    }
    if ($FCConfigFile)
    {
        if ( -not (Test-Path -path $FCConfigFile)) 
        {
            Write-DebugLog "Configuring FC hosts using configuration file $FCConfigFile" $Info
            
            $ListofFCPorts = Import-Csv $FCConfigFile
            foreach ( $p in $ListofFCPorts)
            {
                $Port = $p.Controller 

                Write-DebugLog "Set port $Port offline " $Info
                $Cmds = "controlport offline -f $Port"
                Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
                
                Write-DebugLog "Configuring port $Port as host " $Info
                $Cmds= "controlport config host -ct point -f $Port"
                Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds

                Write-DebugLog "Resetting port $Port " $Info
                $Cmds="controlport rst -f $Port"
                Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
            }
        }    
        else
        {
            Write-DebugLog "Can't find $FCConfigFile" "ERR:"
        }    
    }

    # ---------------------------------------------------------------------
    # iSCSI Config file here
    if ($iSCSIConfigFile)
    {
        if ( -not (Test-Path -path $iSCSIConfigFile)) 
        {
            Write-DebugLog "Configuring iSCSI hosts using configuration file $iSCSIConfigFile" $Info
            
            $ListofiSCSIPorts = Import-Csv $iSCSIConfigFile        
        
            foreach ( $p in $ListofiSCSIPorts)
            {
                $Port         = $p.Controller
                $bDHCP         = $p.DHCP
                $IPAddr     = $p.IPAddress
                $IPSubnet     = $p.Subnet
                $IPgw         = $p.Gateway        
                if ( $bDHCP -eq "Yes")
                    { $bDHCP = $true }
                else
                    { $bDHCP = $false }
                
                if ($bDHCP)
                {
                    Write-DebugLog "Enabling DHCP on port $Port " $Info
                    $Cmds = "controliscsiport dhcp on -f $Port"
                    Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds            
                }
                else
                {
                    Write-DebugLog "Setting IP address and subnet on port $Port " $Info
                    $Cmds = "controliscsiport addr $IPAddr $IPSubnet -f $Port"
                    Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
                    
                    Write-DebugLog "Setting gateway on port $Port " $Info
                    $Cmds = "controliscsiport gw $IPgw -f $Port"
                    Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds
                }    
            
            }
        }    
        else
        {
            Write-DebugLog "Can't find $iSCSIConfigFile" "ERR:"
            return "FAILURE : Can't find $iSCSIConfigFile"
        }    
    }            
} # End Function Set-HostPorts

##########################################################################
######################### FUNCTION Set-NodeProperties ################
##########################################################################
Function Set-NodeProperties()
{
<#
  .SYNOPSIS
   Set-NodeProperties - set the properties of the node components.

  .DESCRIPTION
   The Set-NodeProperties command sets properties of the node components such as serial
   number of the power supply.

  .EXAMPLE
   Set-NodeProperties -PS_ID 1 -S xxx -Node_ID 1

  .PARAMETER S
   Specify the serial number. It is up to 8 characters in length.

  .PARAMETER PS_ID
   Specifies the power supply ID.

  .PARAMETER Node_ID
   Specifies the node ID.
   
  .Notes
    NAME: Set-NodeProperties
    LASTEDIT 22/11/2019
    KEYWORDS: Set-NodeProperties
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param( 
    [Parameter(Position=0, Mandatory=$True)]
    [System.String]
    $PS_ID,
    
    [Parameter(Position=1, Mandatory=$True)]
    [System.String]
    $S,
    
    [Parameter(Position=2, Mandatory=$True)]
    [System.String]
    $Node_ID,    

    [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Set-NodeProperties - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Set-NodeProperties since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Set-NodeProperties since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
   write-debuglog "$plinkresult"
   Return $plinkresult
 }

 $Cmd = " setnode ps "
 
 if($PS_ID)
 {
    $Cmd += " $PS_ID "
 }

 if($S)
 {
    $Cmd += " -s $S "
 } 

 if($Node_ID)
 {
    $Cmd += " $Node_ID "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Set-NodeProperties command -->" INFO:
 
 Return $Result
} ## End-of Set-NodeProperties

##########################################################################
######################### FUNCTION Set-NodesDate ##########################
##########################################################################
Function Set-NodesDate()
{
<#
  .SYNOPSIS
   Set-NodesDate - Sets date and time information.

  .DESCRIPTION
   The Set-NodesDate command allows you to set the system time and date on all nodes.

  .EXAMPLE
    The following example displays the timezones with the -tzlist option:
    Set-NodesDate -Tzlist
    
  .EXAMPLE
    The following example narrows down the list to the required timezone of Etc:
    Set-NodesDate -Tzlist -TzGroup Etc
    
  .EXAMPLE
    The following example shows the timezone being set:
    Set-NodesDate -Tzlist -TzGroup "Etc/GMT"

  .PARAMETER Tzlist
   Displays a timezone within a group, if a group is specified. If a group
   is not specified, displays a list of valid groups.
   
  .PARAMETER TzGroup
   Displays a timezone within a group, if a group is specified. it alwase use with -Tzlist.
   
  .Notes
    NAME: Set-NodesDate
    LASTEDIT 22/11/2019
    KEYWORDS: Set-NodesDate
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Tzlist,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $TzGroup,

    [Parameter(Position=2, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Set-NodesDate - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Set-NodesDate since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Set-NodesDate since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " setdate "

 if($Tzlist)
 {
    $Cmd += " -tzlist "
    if($TzGroup)
     {
        $Cmd += " $TzGroup "
     }
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Set-NodesDate command -->" INFO: 
 
 Return $Result
} ## End-of Set-NodesDate

##########################################################################
######################### FUNCTION Set-SysMgr ########################
##########################################################################
Function Set-SysMgr()
{
<#
  .SYNOPSIS
   Set-SysMgr - Set the system manager startup state.

  .DESCRIPTION
   The Set-SysMgr command sets the system manager startup state.

  .EXAMPLE

  .PARAMETER Wipe
    Requests that the specified system be started in the new system state.
    Warning: This option will result in the loss of data and configuration info.

  .PARAMETER Tocgen
    Specifies that the system is to be started with the specified table
    of contents generation number.

  .PARAMETER Force_iderecovery
    Specifies that the system starts the recovery process from the IDE disk
    even if all virtual volumes have not been started.

  .PARAMETER Force_idewipe
    Specifies that the system wipes the IDE power fail partition. The system
    is shutdown and restarted, during which time all logical disks and
    virtual volumes are checked.

  .PARAMETER Export_vluns
    If the AutoExportAfterReboot option has been set to no, after a power
    failure or uncontrolled shutdown vluns will not be automatically
    exported, and host ports will be in a suspended state. This command
    will reexport the luns and enable the host ports after this happens.

  .PARAMETER System_name
    Specifies the name of the system to be started, using up to 31
    characters.

  .PARAMETER Toc_gen_number
    Specifies the table of contents generation number for the system to
    start with.

    
  .Notes
    NAME: Set-SysMgr
    LASTEDIT 22/11/2019
    KEYWORDS: Set-SysMgr
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Wipe,

    [Parameter(Position=1, Mandatory=$false)]
    [switch]
    $Tocgen,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $Force_iderecovery,

    [Parameter(Position=3, Mandatory=$false)]
    [switch]
    $Force_idewipe,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $Export_vluns,

    [Parameter(Position=5, Mandatory=$false)]
    [System.String]
    $System_name,

    [Parameter(Position=6, Mandatory=$false)]
    [System.String]
    $Toc_gen_number,

    [Parameter(Position=7, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Set-SysMgr - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Set-SysMgr since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Set-SysMgr since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " setsysmgr -f "

 if($Wipe)
 {
    $Cmd += " wipe "
    if($System_name)
    {
        $Cmd += " $System_name "
    }
    else
    {
        Return "System_name is require with -Wipe option."
    }
 }

 if($Tocgen)
 {
    $Cmd += " tocgen "
    if($Toc_gen_number)
    {
        $Cmd += " $Toc_gen_number "
    } 
 }
 
 if($Force_iderecovery)
 {
    $Cmd += " force_iderecovery "
 } 
 
 if($Force_idewipe)
 {
    $Cmd += " force_idewipe "
 }
 
 if($Export_vluns)
 {
    $Cmd += " export_vluns "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Set-SysMgr command -->" INFO: 
 Return $Result
} ## End-of Set-SysMgr

##########################################################################
######################### FUNCTION Show-Battery ######################
##########################################################################
Function Show-Battery()
{
<#
  .SYNOPSIS
   Show-Battery - Show battery status information.

  .DESCRIPTION
   Displays battery status information such as serial number, expiration
   date and battery life, which could be helpful in determining battery
   maintenance schedules.

  .EXAMPLE

  .PARAMETER Listcols
   List the columns available to be shown with the -showcols option
   described below .

  .PARAMETER Showcols
   Explicitly select the columns to be shown using a comma-separated list
   of column names. For this option, the full column names are shown in
   the header.

  .PARAMETER D
   Specifies that detailed battery information, including battery test
   information, serial numbers, and expiration dates, is displayed.

  .PARAMETER Log
   Show battery test log information. This option is not supported on
   HPE 3PAR 7000 nor on HPE 3PAR 8000 series systems.

  .PARAMETER I
   Show battery inventory information.

  .PARAMETER State
   Show detailed battery state information.

  .PARAMETER S
   This is the same as -state.
   This option is deprecated and will be removed in a future release.

  .PARAMETER Svc
   Displays inventory information with HPE serial number, spare part etc.
   This option must be used with -i option and it is not supported on
   HPE 3PAR 10000 systems.
   
  .PARAMETER Node_ID
    Displays the battery information for the specified node ID(s). This
    specifier is not required. Node_ID is an integer from 0 through 7.

  .Notes
    NAME: Show-Battery
    LASTEDIT 22/11/2019
    KEYWORDS: Show-Battery
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Listcols,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $Showcols,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $D,

    [Parameter(Position=3, Mandatory=$false)]
    [switch]
    $Log,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $I,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $State,

    [Parameter(Position=6, Mandatory=$false)]
    [switch]
    $Svc,

    [Parameter(Position=7, Mandatory=$false)]
    [System.String]
    $Node_ID,

    [Parameter(Position=8, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-Battery - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-Battery since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-Battery since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " showbattery "

 if($Listcols)
 {
    $Cmd += " -listcols "
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
    return $Result
 }

 if($Showcols)
 {
    $Cmd += " -showcols $Showcols "
 }

 if($D)
 {
    $Cmd += " -d "
 }

 if($Log)
 {
    $Cmd += " -log "
 }

 if($I)
 {
    $Cmd += " -i "
 }

 if($State)
 {
    $Cmd += " -state "
 }

 if($Svc)
 {
    $Cmd += " -svc "
 }

 if($Node_ID)
 {
  $Cmd += " $Node_ID "
 }
 
$Cmd
 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-Battery command -->" INFO: 

 if($Result.count -gt 1)
 {            
    if($D)
    {    
        Return  $Result    
    }
    else
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count   
        
        foreach ($S in  $Result[0..$LastItem] )
        {
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s,"^ ","")
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s,"^ ","")        
            $s= [regex]::Replace($s," +",",")            
            $s= [regex]::Replace($s,"-","")            
            $s= $s.Trim()
            
            if($Log)
            {
                $temp1 = $s -replace 'Time','Date,Time,Zone'            
                $s = $temp1
            }
            
            Add-Content -Path $tempfile -Value $s                
        }
        Import-Csv $tempFile 
        del $tempFile
    }
 }
 else
 {            
    Return  $Result
 }
 
} ## End-of Show-Battery

##########################################################################
######################### FUNCTION Show-EEProm ################
##########################################################################
Function Show-EEProm()
{
<#
  .SYNOPSIS
   Show-EEProm - Show node EEPROM information.

  .DESCRIPTION
   The Show-EEProm command displays node EEPROM log information.

  .EXAMPLE
    The following example displays the EEPROM log for all nodes:
    Show-EEProm
    
  .EXAMPLE
    Show-EEProm -Node_ID 0
    
  .EXAMPLE
    Show-EEProm -Dead
    
  .EXAMPLE
    Show-EEProm -Dead -Node_ID 0

  .PARAMETER Dead
   Specifies that an EEPROM log for a node that has not started or
   successfully joined the cluster be displayed. If this option is used, it
   must be followed by a non empty list of nodes.
   
  .PARAMETER Node_ID
    Specifies the node ID for which EEPROM log information is retrieved.
    Multiple node IDs are separated with a single space (0 1 2). If no
    specifiers are used, the EEPROM log for all nodes is displayed.
        
  .Notes
    NAME: Show-EEProm
    LASTEDIT 22/11/2019
    KEYWORDS: Show-EEProm
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Dead,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $Node_ID,

    [Parameter(Position=2, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-EEProm - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-EEProm since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-EEProm since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " showeeprom "

 if($Dead)
 {
    $Cmd += " -dead "
 }
 
 if($Node_ID)
 {
  $Cmd += " $Node_ID "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-EEProm command -->" INFO: 
 
 Return $Result
} ## End-of Show-EEProm

#######################################################################################################
## FUNCTION Get-SystemInformation
########################################################################################################
Function Get-SystemInformation
{
<#
  .SYNOPSIS
    Command displays the Storage system information.
  
  .DESCRIPTION
    Command displays the Storage system information.
        
  .EXAMPLE
    Get-SystemInformation
    Command displays the Storage system information.such as system name, model, serial number, and system capacity information.
    
  .EXAMPLE
    Get-SystemInformation -Option space
    Lists Storage system space information in MB(1024^2 bytes)
      
  .PARAMETER Option
    space
    Displays the system capacity information in MB (1024^2 bytes)
    
    domainspace
    Displays the system capacity information broken down by domain in MB(1024^2 bytes)
    
    fan
    Displays the system fan information.
    
    date
    command displays the date and time for each system node
    
  .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
  .Notes
    NAME: Get-SystemInformation
    LASTEDIT: 22/11/2019
    KEYWORDS: Get-SystemInformation
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0

 #>
[CmdletBinding()]
    param(
        [Parameter(Position=0, Mandatory=$false)]
        [System.String]
        $Option,
        
        [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
        $SANConnection = $global:SANConnection 
       
    )        
    $Option = $Option.toLower()
    Write-DebugLog "Start: In Get-SystemInformation - validating input values" $Debug 

    #check if connection object contents are null/empty
    if(!$SANConnection)
    {                
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Get-SystemInformation since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Get-SystemInformation since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $cliresult1 = Test-PARCli -SANConnection $SANConnection
    if(($cliresult1 -match "FAILURE :"))
    {
        write-debuglog "$cliresult1" "ERR:" 
        return $cliresult1
    }
    $sysinfocmd = "showsys "
    
    if ($Option)
    {
        $a = "d","param","fan","space","vvspace","domainspace","desc","devtype","date"
        $l=$Option
        if($a -eq $l)
        {
            $sysinfocmd+=" -$option "
            if($Option -eq "date")
            {
                $Result = Invoke-CLICommand -Connection $SANConnection -cmds  "showdate"
                write-debuglog "Get system date information " "INFO:"
                write-debuglog "Get system fan information cmd -> showdate " "INFO:"
                $tempFile = [IO.Path]::GetTempFileName()
                Add-Content -Path $tempFile -Value "Node,Date"
                foreach ($s in  $Result[1..$Result.Count] )
                {
                    $splits = $s.split(" ")
                    $var1 = $splits[0].trim()
                    #write-host "var1 = $var1"
                    $var2 = ""
                    foreach ($t in $splits[1..$splits.Count])
                    {
                        #write-host "t = $t"
                        if(-not $t)
                        {
                            continue
                        }
                        $var2 += $t+" "
                        
                        #write-host "var2 $var2"
                    }
                    $var3 = $var1+","+$var2
                    Add-Content -Path $tempFile -Value $var3
                }
                Import-Csv $tempFile
                del $tempFile
                return
            }    
            else
            {
                $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $sysinfocmd
                return $Result
            }
        }
        else
        { 
            Write-DebugLog "Stop: Exiting Get-SystemInformation since -option $option in incorrect "
            Return "FAILURE : -option :- $option is an Incorrect option [d,param,fan,space,vvspace,domainspace,desc,devtype] can be used only . "
        }
    }
    else
    {    
        $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $sysinfocmd
        return $Result 
    }        
}
##### END Get-SystemInformation

##########################################################################
##################### FUNCTION Show-FCOEStatistics ###################
##########################################################################
Function Show-FCOEStatistics()
{
<#
  .SYNOPSIS
   Show-FCOEStatistics - Display FCoE statistics

  .DESCRIPTION
   The Show-FCOEStatistics command displays Fibre Channel over Ethernet statistics.

  .EXAMPLE

  .PARAMETER D
   Looping delay in seconds <secs>. The default is 2.

  .PARAMETER Iter
   The command stops after a user-defined <number> of iterations.

  .PARAMETER Nodes
   List of nodes for which the ports are included.

  .PARAMETER Slots
   List of PCI slots for which the ports are included.

  .PARAMETER Ports
   List of ports which are included. Lists are specified in a
   comma-separated manner such as: -ports 1,2 or -ports 1.

  .PARAMETER Counts
   Shows the counts. The default is to show counts/sec.

  .PARAMETER Fullcounts
   Shows the values for the full list of counters instead of the default
   packets and KBytes for the specified protocols. The values are shown in
   three columns:
       Current - Counts since the last sample.
       CmdStart - Counts since the start of the command.
       Begin - Counts since the port was reset.

  .PARAMETER Prev
   Shows the differences from the previous sample.

  .PARAMETER Begin
   Shows the values from when the system was last initiated.

  .Notes
    NAME: Show-FCOEStatistics
    LASTEDIT 22/11/2019
    KEYWORDS: Show-FCOEStatistics
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [System.String]
    $D,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $Iter,

    [Parameter(Position=2, Mandatory=$false)]
    [System.String]
    $Nodes,

    [Parameter(Position=3, Mandatory=$false)]
    [System.String]
    $Slots,

    [Parameter(Position=4, Mandatory=$false)]
    [System.String]
    $Ports,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $Counts,

    [Parameter(Position=6, Mandatory=$false)]
    [switch]
    $Fullcounts,

    [Parameter(Position=7, Mandatory=$false)]
    [switch]
    $Prev,

    [Parameter(Position=8, Mandatory=$false)]
    [switch]
    $Begin,

    [Parameter(Position=9, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-FCOEStatistics - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-FCOEStatistics since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-FCOEStatistics since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

 $Cmd = " statfcoe "

 if($D)
 {
    $Cmd += " -d $D "
 }

 if($Iter)
 {
    $Cmd += " -iter $Iter "
 }

 if($Nodes)
 {
    $Cmd += " -nodes $Nodes "
 }

 if($Slots)
 {
    $Cmd += " -slots $Slots "
 }

 if($Ports)
 {
    $Cmd += " -ports $Ports "
 }

 if($Counts)
 {
    $Cmd += " -counts "
 }

 if($Fullcounts)
 {
    $Cmd += " -fullcounts "
 }

 if($Prev)
 {
    $Cmd += " -prev "
 }

 if($Begin)
 {
    $Cmd += " -begin "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-FCOEStatistics command -->" INFO:
 
 Return $Result
} ## End-of Show-FCOEStatistics

##########################################################################
######################### FUNCTION Show-Firmwaredb ###################
##########################################################################
Function Show-Firmwaredb()
{
<#
  .SYNOPSIS
   Show-Firmwaredb - Show database of current firmware levels.

  .DESCRIPTION
   The Show-Firmwaredb command displays the current database of firmware levels
   for possible upgrade. If issued without any options, the firmware for all
   vendors is displayed.

  .EXAMPLE
   Show-Firmwaredb
   
  .EXAMPLE
   Show-Firmwaredb -VendorName xxx
   
  .EXAMPLE
   Show-Firmwaredb -All
   
  .EXAMPLE
   Show-Firmwaredb -L

  .PARAMETER VendorName
   Specifies that the firmware vendor from the SCSI database file is
   displayed.

  .PARAMETER L
   Reloads the SCSI database file into the system.

  .PARAMETER All
   Specifies current and past firmware entries are displayed. If not
   specified, only current entries are displayed.

  .Notes
    NAME: Show-Firmwaredb
    LASTEDIT 22/11/2019
    KEYWORDS: Show-Firmwaredb
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [System.String]
    $VendorName,

    [Parameter(Position=1, Mandatory=$false)]
    [switch]
    $L,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $All,
    
    [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-Firmwaredb - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-Firmwaredb since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-Firmwaredb since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " showfirmwaredb "

 if($VendorName)
 {
    $Cmd += " -n $VendorName "
 }

 if($L)
 {
    $Cmd += " -l "
 }

 if($All)
 {
    $Cmd += " -all "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-Firmwaredb command -->" INFO:
 
 Return $Result
} ## End-of Show-Firmwaredb

##########################################################################
################## FUNCTION Show-TOCGen ####################
##########################################################################
Function Show-TOCGen()
{
<#
  .SYNOPSIS
   Show-TOCGen - Shows system Table of Contents (TOC) generation number.

  .DESCRIPTION
   The Show-TOCGen command displays the table of contents generation number.

  .EXAMPLE
   None.

  .Notes
    NAME: Show-TOCGen
    LASTEDIT 22/11/2019
    KEYWORDS: Show-TOCGen
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )
Write-DebugLog "Start: In Show-TOCGen - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-TOCGen since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-TOCGen since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

 $Cmd = " showtocgen "

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-TOCGen command -->" INFO: 
 
 Return $Result
} ## End-of Show-TOCGen

####################################################################################################################
## FUNCTION Show-iSCSISessionStatistics
####################################################################################################################
Function Show-iSCSISessionStatistics
{
<#
  .SYNOPSIS
    The Show-iSCSISessionStatistics command displays the iSCSI session statistics.

  .DESCRIPTION
    The Show-iSCSISessionStatistics command displays the iSCSI session statistics.

  .EXAMPLE
    Show-iSCSISessionStatistics

  .EXAMPLE
    Show-iSCSISessionStatistics -Iterations 1
    
  .EXAMPLE
    Show-iSCSISessionStatistics -Iterations 1 -Delay 2
    
  .EXAMPLE
    Show-iSCSISessionStatistics -Iterations 1 -NodeList 1
    
  .EXAMPLE
    Show-iSCSISessionStatistics -Iterations 1 -SlotList 1
    
  .EXAMPLE
    Show-iSCSISessionStatistics -Iterations 1 -PortList 1
    
  .EXAMPLE
    Show-iSCSISessionStatistics -Iterations 1 -Prev
    
  .PARAMETER Iterations
     The command stops after a user-defined <number> of iterations.
     
  .PARAMETER Delay
     Looping delay in seconds <secs>. The default is 2.

  .PARAMETER NodeList
    List of nodes for which the ports are included.

  .PARAMETER SlotList
    List of PCI slots for which the ports are included.

  .PARAMETER PortList
    List of ports for which the ports are included. Lists are specified
    in a comma-separated manner such as: -ports 1,2 or -ports 1.

  .PARAMETER Previous
    Shows the differences from the previous sample.
    
  .PARAMETER Begin
    Shows the values from when the system was last initiated.
    
  .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection

  .Notes
    NAME: Show-iSCSISessionStatistics
    LASTEDIT: 22/11/2019
    KEYWORDS: Show-iSCSISessionStatistics

  .Link
    http://www.hpe.com
 
 #Requires PS -Version 3.0
 #>
[CmdletBinding()]
    param(
        [Parameter(Position=0, Mandatory=$false)]
        [System.String]
        $Iterations,
        
        [Parameter(Position=1, Mandatory=$false)]
        [System.String]
        $Delay,        
        
        [Parameter(Position=2, Mandatory=$false)]
        [System.String]
        $NodeList,
        
        [Parameter(Position=3, Mandatory=$false)]
        [System.String]
        $SlotList,
        
        [Parameter(Position=4, Mandatory=$false)]
        [System.String]
        $PortList,        
        
        [Parameter(Position=5, Mandatory=$false)]
        [Switch]
        $Previous,    
        
        [Parameter(Position=6, Mandatory=$false)]
        [Switch]
        $Begin,
            
        [Parameter(Position=7, Mandatory=$false, ValueFromPipeline=$true)]
        $SANConnection = $global:SANConnection 
       
    )        
    Write-DebugLog "Start: In Show-iSCSISessionStatistics - validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {    
            
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Show-iSCSISessionStatistics since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Show-iSCSISessionStatistics since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }    
    $cmd= "statiscsisession "    
    
    if($Iterations)
    {
        $cmd+=" -iter $Iterations "
    }
    else
    {
        return " Iterations is mandatory "
    }
    if($Delay)
    {
        $cmd+=" -d $Delay "
    }    
    if($NodeList)
    {
        $cmd+=" -nodes $NodeList "
    }
    if($SlotList)
    {
        $cmd+=" -slots $SlotList "
    }
    if($PortList)
    {
        $cmd+=" -ports $PortList "
    }    
    if($Previous)
    {
        $cmd+=" -prev "
    }
    if($Begin)
    {
        $cmd+=" -begin "
    }
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $cmd
    write-debuglog " Executing Show-iSCSISessionStatistics command that displays information iSNS table for iSCSI ports in the system " "INFO:"    
    if($Result -match "Total" -and $Result.Count -gt 5)
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count - 3 
        $Flag = "False"
        $Loop_Cnt = 2    
                
        foreach ($s in  $Result[$Loop_Cnt..$LastItem] )
        {            
            if($Flag -eq "true")
            {
                if(($s -match "statiscsisession") -or ($s -match "----PDUs/s---- --KBytes/s--- ----Errs/s----") -or ($s -match " port -------------iSCSI_Name-------------- TPGT Cmd Resp Total Tx Rx Total Digest TimeOut VLAN") -or ($s -match " port -iSCSI_Name- TPGT Cmd Resp Total Tx Rx Total Digest TimeOut VLAN"))
                {
                    if(($s -match " port -------------iSCSI_Name-------------- TPGT Cmd Resp Total Tx Rx Total Digest TimeOut VLAN") -or ($s -match " port -iSCSI_Name- TPGT Cmd Resp Total Tx Rx Total Digest TimeOut VLAN"))
                    {
                        $temp="=============================="
                        Add-Content -Path $tempFile -Value $temp
                    }
                }
                else
                {
                    $s= [regex]::Replace($s,"^ ","")            
                    $s= [regex]::Replace($s," +",",")    
                    $s= [regex]::Replace($s,"-","")
                    $s= $s.Trim()                    
                    if($s.length -ne 0)
                    {
                        $sTemp1=$s                
                        $sTemp = $sTemp1.Split(',')                            
                        $cnt = $sTemp.count            
                        if($cnt -gt 8)
                        {
                            $sTemp[5]="Total(PDUs/s)"                
                            $sTemp[8]="Total(KBytes/s)"
                        }
                        $newTemp= [regex]::Replace($sTemp,"^ ","")            
                        $newTemp= [regex]::Replace($sTemp," ",",")                
                        $newTemp= $newTemp.Trim()
                        $s=$newTemp
                    }                    
                    Add-Content -Path $tempFile -Value $s    
                }
            }
            else
            {
                $s= [regex]::Replace($s,"^ ","")            
                $s= [regex]::Replace($s," +",",")    
                $s= [regex]::Replace($s,"-","")
                $s= $s.Trim()                
                $sTemp1=$s                
                $sTemp = $sTemp1.Split(',')                            
                $cnt = $sTemp.count            
                if($cnt -gt 8)
                {
                    $sTemp[5]="Total(PDUs/s)"                
                    $sTemp[8]="Total(KBytes/s)"
                }
                $newTemp= [regex]::Replace($sTemp,"^ ","")            
                $newTemp= [regex]::Replace($sTemp," ",",")                
                $newTemp= $newTemp.Trim()
                $s=$newTemp                            
                
                Add-Content -Path $tempFile -Value $s    
            }
            $Flag = "true"            
        }
        Import-Csv $tempFile 
        del $tempFile
    }
    if($Result -match "Total" -and $Result.Count -gt 5)
    {    
        return  " Success : Executing Show-iSCSISessionStatistics"
    }
    else
    {
        if($Result.Count -lt 5)
        {                    
            return  $Result
        }
        else
        {
            return  "No Data Found while Executing Show-iSCSISessionStatistics"    
        }
    }
    
} # End Show-iSCSISessionStatistics

####################################################################################################################
## FUNCTION Show-iSCSIStatistics
####################################################################################################################
Function Show-iSCSIStatistics
{
<#
    .SYNOPSIS
        The Show-iSCSIStatistics command displays the iSCSI statistics.
   
    .DESCRIPTION
        The Show-iSCSIStatistics command displays the iSCSI statistics.
   
    .EXAMPLE
        Show-iSCSIStatistics
    
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -Delay 2
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -NodeList 1
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -SlotList 1
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -PortList 1
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -Fullcounts
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -Prev
        
    .EXAMPLE
        Show-iSCSIStatistics -Iterations 1 -Begin
        
    .PARAMETER Iterations
         The command stops after a user-defined <number> of iterations.
         
    .PARAMETER Delay
         Looping delay in seconds <secs>. The default is 2.
    
    .PARAMETER NodeList
        List of nodes for which the ports are included.
    
    .PARAMETER SlotList
        List of PCI slots for which the ports are included.

    .PARAMETER PortList
        List of ports for which the ports are included. Lists are specified
        in a comma-separated manner such as: -ports 1,2 or -ports 1.
        
    .PARAMETER Fullcounts
        Shows the values for the full list of counters instead of the default
        packets and KBytes for the specified protocols. The values are shown in
        three columns:

          o Current - Counts since the last sample.
          o CmdStart - Counts since the start of the command.
          o Begin - Counts since the port was reset.

        This option cannot be used with the -prot option. If the -fullcounts
        option is not specified, the metrics from the start of the command are
        displayed.
        
    .PARAMETER Prev
        Shows the differences from the previous sample.
        
    .PARAMETER Begin
        Shows the values from when the system was last initiated.

    .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
    .Notes
        NAME: Show-iSCSIStatistics
        LASTEDIT: 22/11/2019
        KEYWORDS: Show-iSCSIStatistics
        
   
    .Link
        http://www.hpe.com
 
 #Requires PS -Version 3.0
 #>
[CmdletBinding()]
    param(
        [Parameter(Position=0, Mandatory=$false)]
        [System.String]
        $Iterations,
        
        [Parameter(Position=1, Mandatory=$false)]
        [System.String]
        $Delay,        
        
        [Parameter(Position=2, Mandatory=$false)]
        [System.String]
        $NodeList,
        
        [Parameter(Position=3, Mandatory=$false)]
        [System.String]
        $SlotList,
        
        [Parameter(Position=4, Mandatory=$false)]
        [System.String]
        $PortList,
        
        [Parameter(Position=5, Mandatory=$false)]
        [Switch]
        $Fullcounts,
        
        [Parameter(Position=6, Mandatory=$false)]
        [Switch]
        $Prev,
        
        [Parameter(Position=7, Mandatory=$false)]
        [Switch]
        $Begin,
            
        [Parameter(Position=8, Mandatory=$false, ValueFromPipeline=$true)]
        $SANConnection = $global:SANConnection 
       
    )        
    Write-DebugLog "Start: In Show-iSCSIStatistics - validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {    
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Show-iSCSIStatistics since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Show-iSCSIStatistics since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }    
    
    $cmd= " statiscsi "    
    if($Iterations)
    {
        $cmd+=" -iter $Iterations "
    }
    else
    {
        return " Iterations is mandatory "
    }
    if($Delay)
    {
        $cmd+=" -d $Delay "
    }    
    if($NodeList)
    {
        $cmd+=" -nodes $NodeList "
    }
    if($SlotList)
    {
        $cmd+=" -slots $SlotList "
    }
    if($PortList)
    {
        $cmd+=" -ports $PortList "
    }
    if($Fullcounts)
    {
        $cmd+=" -fullcounts "
    }
    if($Prev)
    {
        $cmd+=" -prev "
    }
    if($Begin)
    {
        $cmd+=" -begin "
    }    
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $cmd
    write-debuglog " Executing Show-iSCSIStatistics command that displays information iSNS table for iSCSI ports in the system " "INFO:"    
    if($Result -match "Total" -or $Result.Count -gt 1)
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count 
        $Flag = "False"
        $Loop_Cnt = 2    
        if($Fullcounts)
        {
            $Loop_Cnt = 1
        }        
        foreach ($s in  $Result[$Loop_Cnt..$LastItem] )
        {            
            if($Flag -eq "true")
            {
                if(($s -match "From start of statiscsi command") -or ($s -match "----Receive---- ---Transmit---- -----Total-----") -or ($s -match "port Protocol Pkts/s KBytes/s Pkts/s KBytes/s Pkts/s KBytes/s Errs/") -or ($s -match "Counts/sec") -or ($s -match "Port Counter Current CmdStart Begin"))
                {
                    if(($s -match "port Protocol Pkts/s KBytes/s Pkts/s KBytes/s Pkts/s KBytes/s Errs/") -or ($s -match "Port Counter Current CmdStart Begin"))
                    {
                        $temp="=============================="
                        Add-Content -Path $tempFile -Value $temp
                    }
                }
                else
                {
                    $s= [regex]::Replace($s,"^ ","")            
                    $s= [regex]::Replace($s," +",",")    
                    $s= [regex]::Replace($s,"-","")
                    $s= $s.Trim() -replace 'Pkts/s,KBytes/s,Pkts/s,KBytes/s,Pkts/s,KBytes/s','Pkts/s(Receive),KBytes/s(Receive),Pkts/s(Transmit),KBytes/s(Transmit),Pkts/s(Total),KBytes/s(Total)'     
                    if($s.length -ne 0)
                    {
                        if(-not $Fullcounts)
                        {
                            $s=$s.Substring(1)    
                        }
                    }                
                    Add-Content -Path $tempFile -Value $s    
                }
            }
            else
            {
                $s= [regex]::Replace($s,"^ ","")            
                $s= [regex]::Replace($s," +",",")    
                $s= [regex]::Replace($s,"-","")
                $s= $s.Trim() -replace 'Pkts/s,KBytes/s,Pkts/s,KBytes/s,Pkts/s,KBytes/s','Pkts/s(Receive),KBytes/s(Receive),Pkts/s(Transmit),KBytes/s(Transmit),Pkts/s(Total),KBytes/s(Total)'     
                if($s.length -ne 0)
                {                    
                    if(-not $Fullcounts)
                    {
                        $s=$s.Substring(1)    
                    }                    
                }                
                Add-Content -Path $tempFile -Value $s    
            }
            $Flag = "true"            
        }
        Import-Csv $tempFile 
        del $tempFile
    }
    else
    {
        return  $Result
    }
} # End Show-iSCSIStatistics

##########################################################################
######################### FUNCTION Show-NetworkDetail ################
##########################################################################
Function Show-NetworkDetail()
{
<#
  .SYNOPSIS
   Show-NetworkDetail - Show the network configuration and status

  .DESCRIPTION
   The Show-NetworkDetail command displays the configuration and status of the
   administration network interfaces, including the configured gateway and
   network time protocol (NTP) server.

  .EXAMPLE
   The following example displays the status of the system administration
   network interfaces:
   Show-NetworkDetail -D

  .PARAMETER D
   Show detailed information.

  .Notes
    NAME: Show-NetworkDetail
    LASTEDIT 22/11/2019
    KEYWORDS: Show-NetworkDetail
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $D,

    [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-NetworkDetail - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-NetworkDetail since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-NetworkDetail since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " shownet "

 if($D)
 {
    $Cmd += " -d "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-NetworkDetail command -->" INFO: 
 
 Return $Result
} ## End-of Show-NetworkDetail

##########################################################################
################ FUNCTION Show-NodeEnvironmentStatus #################
##########################################################################
Function Show-NodeEnvironmentStatus()
{
<#
  .SYNOPSIS
   Show-NodeEnvironmentStatus - Show node environmental status (voltages, temperatures).

  .DESCRIPTION
   The Show-NodeEnvironmentStatus command displays the node operating environment status,
   including voltages and temperatures.

  .EXAMPLE
    The following example displays the operating environment status for all nodes
    in the system:

    Show-NodeEnvironmentStatus

  .PARAMETER Node_ID
   Specifies the ID of the node whose environment status is displayed.
   Multiple node IDs can be specified as a series of integers separated by
   a space (1 2 3). If no option is used, then the environment status of
   all nodes is displayed.

  .Notes
    NAME: Show-NodeEnvironmentStatus
    LASTEDIT 22/11/2019
    KEYWORDS: Show-NodeEnvironmentStatus
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [System.String]
    $Node_ID,

    [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-NodeEnvironmentStatus - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-NodeEnvironmentStatus since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-NodeEnvironmentStatus since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " shownodeenv "

 if($Node_ID)
 {
    $Cmd += " -n $Node_ID "
 } 

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-NodeEnvironmentStatus command -->" INFO: 
 
 Return $Result
} ## End-of Show-NodeEnvironmentStatus

####################################################################################################################
## FUNCTION Show-iSCSISession
####################################################################################################################
Function Show-iSCSISession
{
<#
    .SYNOPSIS
         The Show-iSCSISession command shows the iSCSI sessions.
   
    .DESCRIPTION
         The Show-iSCSISession command shows the iSCSI sessions.
   
    .EXAMPLE
        Show-iSCSISession
        
    .EXAMPLE
        Show-iSCSISession -NSP 1:2:1
        
    .EXAMPLE
        Show-iSCSISession -Detailed -NSP 1:2:1

    .PARAMETER Detailed
        Specifies that more detailed information about the iSCSI session is
        displayed. If this option is not used, then only summary information
        about the iSCSI session is displayed.

    .PARAMETER ConnectionState
        Specifies the connection state of current iSCSI sessions.
        If this option is not used, then only summary information about
        the iSCSI session is displayed.
    
    .PARAMETER NSP
        Requests that information for a specified port is displayed.
     
    .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
    .Notes
        NAME: Show-iSCSISession
        LASTEDIT: 22/11/2019
        KEYWORDS: Show-iSCSISession
   
    .Link
        http://www.hpe.com
 
 #Requires PS -Version 3.0
 #>
[CmdletBinding()]
    param(
        [Parameter(Position=0, Mandatory=$false)]
        [switch]
        $Detailed,
        
        [Parameter(Position=1, Mandatory=$false)]
        [switch]
        $ConnectionState,

        [Parameter(Position=2, Mandatory=$false)]
        [System.String]
        $NSP ,
            
        [Parameter(Position=3, Mandatory=$false, ValueFromPipeline=$true)]
        $SANConnection = $global:SANConnection 
       
    )        
    Write-DebugLog "Start: In Show-iSCSISession - validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {        
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Show-iSCSISession since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Show-iSCSISession since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }    
    $cmd= "showiscsisession "
    
    if ($Detailed)
    {        
        $cmd+=" -d "            
    }
    if ($ConnectionState)
    {        
        $cmd+=" -state "            
    }
    if ($NSP)
    {
        $cmd+=" $NSP "
    }
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $cmd
    write-debuglog " Executing Show-iSCSISession command that displays iSCSI ports in the system " "INFO:"
    if($Result -match "total")
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count -2         
        foreach ($s in  $Result[0..$LastItem] )
        {        
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s," +",",")
            $s= [regex]::Replace($s,"-","")
            $s= $s.Trim() -replace 'StartTime','Date,Time,Zone'     
            Add-Content -Path $tempFile -Value $s
            #Write-Host " only else statement"
        }            
        Import-Csv $tempFile 
        del $tempFile
    }
    if($Result -match "total")    
    {
        return  " Success : Executing Show-iSCSISession"
    }
    else
    {            
        return  $Result
    }
    
} # End Show-iSCSISession

##########################################################################
#################### FUNCTION Show-NodeProperties ####################
##########################################################################
Function Show-NodeProperties()
{
<#
  .SYNOPSIS
   Show-NodeProperties - Show node and its component information.

  .DESCRIPTION
   The Show-NodeProperties command displays an overview of the node-specific properties
   and its component information. Various command options can be used to
   display the properties of PCI cards, CPUs, Physical Memory, IDE drives,
   and Power Supplies.

  .EXAMPLE
    The following example displays the operating environment status for all
    nodes in the system:
    
    Show-NodeProperties
    
  .EXAMPLE
    The following examples display detailed information (-d option) for the
    nodes including their components in a table format. The shownode -d command
    can be used to display the tail information of the nodes including their
    components in name and value pairs.

    Show-NodeProperties - Mem
    Show-NodeProperties - Mem -Node_ID 1
    
   The following options are for node summary and inventory information:

  .PARAMETER Listcols
   List the columns available to be shown with the -showcols option
   described below (see 'clihelp -col Show-NodeProperties' for help on each column).
   By default (if none of the information selection options below are
   specified) the following columns are shown:
   Node Name State Master InCluster LED Control_Mem Data_Mem Available_Cache
   To display columns pertaining to a specific node component use
   the -listcols option in conjunction with one of the following
   options: -pci, -cpu, -mem, -drive, -fan, -ps, -mcu, -uptime.

  .PARAMETER Showcols
    Explicitly select the columns to be shown using a comma-separated list
    of column names. For this option, the full column names are shown in
    the header.
    Run 'shownode -listcols' to list Node component columns.
    Run 'shownode -listcols <node_component>' to list columns associated
    with a specific <node_component>.

    <node_component> can be one of the following options: -pci, -cpu, -mem,
    -drive, -fan, -ps, -mcu, -uptime.

    If a specific node component option is not provided, then -showcols expects
    Node columns as input.

    If a column (Node or specific node component) does not match either the Node
    columns list or a specific node component columns list, then
    'shownode -showcols <cols>' request is denied.

    If an invalid column is provided with -showcols, the request is denied.

    The -showcols option can also be used in conjunction with a list of node IDs.

    Run 'clihelp -col shownode' for a description of each column.

  .PARAMETER I
   Shows node inventory information in table format.

  .PARAMETER D
   Shows node and its component information in table format.
   
   The following options are for node component information. These options
   cannot be used together with options, -i and -d:

  .PARAMETER VerboseD
   Displays detailed information in verbose format. It can be used together
   with the following component options.

  .PARAMETER Fan
   Displays the node fan information.

  .PARAMETER Pci
   Displays PCI card information

  .PARAMETER Cpu
   Displays CPU information

  .PARAMETER Mem
   Displays physical memory information.

  .PARAMETER Drive
   Displays the disk drive information.

  .PARAMETER Ps
   Displays power supply information.

  .PARAMETER Mcu
   Displays MicroController Unit information.

  .PARAMETER State
   Displays the detailed state information for node or power supply (-ps).
   This is the same as -s.

  .PARAMETER S
   Displays the detailed state information for node or power supply (-ps).
   This option is deprecated and will be removed in a subsequent release.

  .PARAMETER Uptime
   Show the amount of time each node has been running since the last shutdown.

  .PARAMETER Svc
   Displays inventory information with HPE serial number, spare part etc.
   This option must be used with -i option and it is not supported on
   HPE 3PAR 10000 systems
   
  .PARAMETER Node_ID
    Displays the node information for the specified node ID(s). This
    specifier is not required. Node_ID is an integer from 0 through 7.

  .Notes
    NAME: Show-NodeProperties
    LASTEDIT 22/11/2019
    KEYWORDS: Show-NodeProperties
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Listcols,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $Showcols,

    [Parameter(Position=3, Mandatory=$false)]
    [switch]
    $I,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $D,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $VerboseD,

    [Parameter(Position=6, Mandatory=$false)]
    [switch]
    $Fan,

    [Parameter(Position=7, Mandatory=$false)]
    [switch]
    $Pci,

    [Parameter(Position=8, Mandatory=$false)]
    [switch]
    $Cpu,

    [Parameter(Position=9, Mandatory=$false)]
    [switch]
    $Mem,

    [Parameter(Position=10, Mandatory=$false)]
    [switch]
    $Drive,

    [Parameter(Position=11, Mandatory=$false)]
    [switch]
    $Ps,

    [Parameter(Position=12, Mandatory=$false)]
    [switch]
    $Mcu,

    [Parameter(Position=13, Mandatory=$false)]
    [switch]
    $State,

    [Parameter(Position=15, Mandatory=$false)]
    [switch]
    $Uptime,

    [Parameter(Position=16, Mandatory=$false)]
    [switch]
    $Svc,

    [Parameter(Position=17, Mandatory=$false)]
    [System.String]
    $Node_ID,

    [Parameter(Position=18, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-NodeProperties - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-NodeProperties since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-NodeProperties since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

 $Cmd = " shownode "

 if($Listcols)
 {
    $Cmd += " -listcols "
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
    return $Result
 }

 if($Showcols)
 {
    $Cmd += " -showcols $Showcols "
 }

 if($I)
 {
    $Cmd += " -i "
 }

 if($D)
 {
    $Cmd += " -d "
 }

 if($VerboseD)
 {
    $Cmd += " -verbose "
 }

 if($Fan)
 {
    $Cmd += " -fan "
 }

 if($Pci)
 {
    $Cmd += " -pci "
 }

 if($Cpu)
 {
    $Cmd += " -cpu "
 }

 if($Mem)
 {
    $Cmd += " -mem "
 }

 if($Drive)
 {
    $Cmd += " -drive "
 }

 if($Ps)
 {
    $Cmd += " -ps "
 }

 if($Mcu)
 {
    $Cmd += " -mcu "
 }

 if($State)
 {
    $Cmd += " -state "
 }

 if($Uptime)
 {
    $Cmd += " -uptime "
 }

 if($Svc)
 {
    $Cmd += " -svc "
 }

 if($Node_ID)
 {
    $Cmd += " $Node_ID "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-NodeProperties command -->" INFO: 
 if($Result.count -gt 1)
 {    
    if($I -Or $D -Or $VerboseD)
    {
        Return  $Result
    }
    else
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count
        $FirstCount = 0
        $oneTimeOnly = "True"
        
        if($Cmd -eq " shownode " -Or $Node_ID)
        {
            $FirstCount = 1
        }
        if($Node_ID -and $Showcols)
        {
            $FirstCount = 0
        }
        if($Showcols -or $Fan -or $Pci -or $Cpu -Or $Drive -Or $Mem -Or $Mcu -Or $Ps -Or $State -Or $Uptime -Or $Svc)
        {
            $FirstCount = 0
        }
        foreach ($S in  $Result[$FirstCount..$LastItem] )
        {
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s,"^ ","")
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s,"^ ","")        
            $s= [regex]::Replace($s," +",",")            
            $s= [regex]::Replace($s,"-","")            
            $s= $s.Trim()
            
            if($Cmd -eq " shownode "  -Or $Node_ID)
            {
                if($Showcols -or $Fan -or $Pci -or $Cpu -Or $Drive -Or $Mem -Or $Mcu -Or $Ps -Or $State -Or $Uptime -Or $Svc)
                {
                }
                else
                {
                    if($oneTimeOnly -eq "True")
                    {                
                        $sTemp1=$s                
                        $sTemp = $sTemp1.Split(',')                            
                        $sTemp[6] = "Control_Mem(MB)"
                        $sTemp[7] = "Data_Mem(MB)"
                        $sTemp[8] = "Cache_Available(%)"            
                        $newTemp= [regex]::Replace($sTemp,"^ ","")            
                        $newTemp= [regex]::Replace($sTemp," ",",")                
                        $newTemp= $newTemp.Trim()
                        $s=$newTemp            
                    }
                }
            }
            Add-Content -Path $tempfile -Value $s
            $oneTimeOnly = "False"                
        }
        Import-Csv $tempFile 
        del $tempFile
    }    
 }
 else
 {            
    Return  $Result
 }
} ## End-of Show-NodeProperties

##########################################################################
######################## FUNCTION Show-Portdev #######################
##########################################################################
Function Show-Portdev()
{
<#
  .SYNOPSIS
   Show-Portdev - Show detailed information about devices on a port.

  .DESCRIPTION
   The Show-Portdev command displays detailed information about devices
   on a specified port.

  .EXAMPLE
  
  .PARAMETER Loop
    Specifies that information is returned for arbitrated loop devices
    that are attached to the specified port. This subcommand is only
    for use with Fibre Channel arbitrated loop ports.
    
  .PARAMETER All
    Specifies that information for all devices attached to the specified
    port is returned.
    
  .PARAMETER NS
    Specifies that information for the switch name server database is
    returned. This subcommand is only for use with fabric-attached
    topologies.
    
  .PARAMETER Fcf
    Specifies that information for all Fibre Channel over Ethernet
    forwarders (FCFs) known to the specified port is returned. This
    subcommand is for use only with Fibre Channel over Ethernet (FCoE)
    ports.
    
  .PARAMETER Sas
    Specifies that information for all devices in the SAS topology
    attached to the specified port is returned. This subcommand is
    only for use with SAS ports.
    
  .PARAMETER Fcswitch
    Specifies that a list of all switches in the Fibre Channel fabric
    is returned. This subcommand is only for use with fabric-attached
    Fibre Channel ports.
    
  .PARAMETER Fcfabric
    Specifies that a description of the Fibre Channel fabric is
    returned. This subcommand is only for use with fabric-attached
    Fibre Channel ports.
    
  .PARAMETER Findport
    Searches the Fibre Channel fabric attached to the specified
    port for information on the supplied WWN. Supplying the term "this"
    in place of a WWN indicates that the port WWN of the specified
    Storage System host port should be used. This subcommand is only for
    use with fabric-attached Fibre Channel ports.
    
  .PARAMETER Tzone
    Without the <node:slot:port>, this command will return a list of all
    the current target-driven zones for any port. If the <node:slot:port> is
    provided, then detailed information about the target-driven zone for
    this port will be provided. This command is only used with
    fabric-attached Fibre Channel ports.
    
  .PARAMETER UNS
    Specifies that information for all initiators from the switch unzoned
    name server database is returned. This subcommand is only for use with
    fabric-attached topologies.
    
  .PARAMETER Lldp
    Specifies available Link Layer Discovery Protocol information for each
    iSCSI port physically connected is returned. If the <node:slot:port>
    is provided, then only information for this port will be displayed.
    This subcommand is only used with iSCSI QLogic 83XX series ports.
    
  .PARAMETER Dcbx
    Specifies available Data Center Bridging Exchange Protocol information
    for each iSCSI port physically connected is returned. If the
    <node:slot:port> is provided, then only information for this port will
    be displayed. This subcommand is only used with iSCSI QLogic 83XX
    series ports.

  .PARAMETER Pel
   Includes the SAS Phy Error Log (PEL) data for each phy in the SAS
   topology. This option is only valid when using the sas subcommand.

  .PARAMETER D
   Includes detailed initiator information: HBA Manufacturer, HBA Model,
   HBA Firmware Version, HBA OS Name/Version, the HBA port's supported
   and current speeds, HBA port's OS device name, hostname, alias name(s),
   and whether the Smart SAN QoS and Security features are supported. When
   used with the tzone or uns subcommand.
   When used with the lldp or dcbx subcommand, this option will return
   relevant detailed information on the LLDP and DCBX information received
   from the peer device. This option is only valid when using either the
   tzone, uns, lldp or dcbx subcommand.

  .PARAMETER App
   Includes detailed information provided from the DCBX Application
   Protocol TLV configured on the peer device.

  .PARAMETER Pfc
   Includes detailed information from the DCBX Priority Flow Control TLV
   configured on the peer device.

  .PARAMETER Pg
   Includes detailed information from the DCBX Priority Groups TLV
   configured on the peer device.

   .PARAMETER NSP
    Specifies the port for which information about devices on that port are
    displayed.

      node
        Specifies the node.
      slot
        Specifies the PCI bus slot in the specified node.
      port
        Specifies the Fibre Channel port number of the PCI card in the
        specified PCI bus slot.

   .PARAMETER WWN
    Specifies the Fibre Channel worldwide port name of an attached port.
   
  .Notes
    NAME: Show-Portdev
    LASTEDIT 22/11/2019
    KEYWORDS: Show-Portdev
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Loop,

    [Parameter(Position=1, Mandatory=$false)]
    [switch]
    $All,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $NS,

    [Parameter(Position=3, Mandatory=$false)]
    [switch]
    $FCF,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $SAS,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $Fcswitch,

    [Parameter(Position=6, Mandatory=$false)]
    [switch]
    $Fcfabric,

    [Parameter(Position=7, Mandatory=$false)]
    [switch]
    $Findport,

    [Parameter(Position=8, Mandatory=$false)]
    [switch]
    $Tzone,

    [Parameter(Position=9, Mandatory=$false)]
    [switch]
    $UNS,

    [Parameter(Position=10, Mandatory=$false)]
    [switch]
    $Lldp,

    [Parameter(Position=11, Mandatory=$false)]
    [switch]
    $Dcbx,
    
    [Parameter(Position=12, Mandatory=$false)]
    [switch]
    $PEL,

    [Parameter(Position=13, Mandatory=$false)]
    [switch]
    $Detail,
    
    [Parameter(Position=14, Mandatory=$false)]
    [switch]
    $App,

    
    [Parameter(Position=15, Mandatory=$false)]
    [switch]
    $PFC,

    
    [Parameter(Position=16, Mandatory=$false)]
    [switch]
    $PG,
    
    [Parameter(Position=17, Mandatory=$false)]
    [System.String]
    $NSP,
    
    [Parameter(Position=18, Mandatory=$false)]
    [System.String]
    $WWN,

    [Parameter(Position=19, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-Portdev - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-Portdev since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-Portdev since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " showportdev "
        
 if($Loop)
 {
     $Cmd += " loop "
 }
 elseif($All)
 {
     $Cmd += " all "
 }
 elseif($NS)
 {
     $Cmd += " ns "
 }
 elseif($FCF)
 {
     $Cmd += " fcf "
 }
 elseif($SAS)
 {
     $Cmd += " sas "
 }
 elseif($Fcswitch)
 {
     $Cmd += " fcswitch "
 }
 elseif($Fcfabric)
 {
     $Cmd += " fcfabric "
 }
 elseif($Findport)
 {
     $Cmd += " findprort "
     if($WWN)
     {
         $Cmd += " $WWN "
     }
     else
     {
         Return "WWN name required with Findprort.."
     }
 }
 elseif($Tzone)
 {
     $Cmd += " tzone "
 }
 elseif($UNS)
 {
     $Cmd += " uns "
 }
 elseif($Lldp)
 {
     $Cmd += " lldp "
 }
 elseif($Dcbx)
 {
     $Cmd += " dcbx "
 }
 else
 {
     Return "Select at list one sub command..."
 }
 
 if($PEL)
 {
     $Cmd += " -pel "
 }
 if($Detail)
 {
     $Cmd += " -d "
 }
 if($App)
 {
     $Cmd += " -app "
 }
 if($PFC)
 {
     $Cmd += " -pfc "
 }
 if($PG)
 {
     $Cmd += " -pg "
 }
 if($NSP)
 {
     $Cmd += " $NSP "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-Portdev command -->" INFO: 
 
 Return $Result
} ## End-of Show-Portdev

####################################################################################################################
## FUNCTION Show-PortISNS
####################################################################################################################
Function Show-PortISNS
{
<#
    .SYNOPSIS
        The Show-PortISNS command shows iSNS host information for iSCSI ports in the system.
        
    .DESCRIPTION
        The Show-PortISNS command shows iSNS host information for iSCSI ports in the
    system.
   
    .EXAMPLE
        Show-PortISNS
        
    .EXAMPLE
        Show-PortISNS -NSP 1:2:3
        
    .PARAMETER NSP
         Specifies the port for which information about devices on that port are
        displayed.
    
    .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
    .Notes
        NAME: Show-PortISNS
        LASTEDIT: 22/11/2019
        KEYWORDS: Show-PortISNS
   
    .Link
        http://www.hpe.com
 
 #Requires PS -Version 3.0
 #>
[CmdletBinding()]
    param(
        
        [Parameter(Position=0, Mandatory=$false)]
        [System.String]
        $NSP ,
            
        [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
        $SANConnection = $global:SANConnection 
       
    )        
    Write-DebugLog "Start: In Show-PortISNS - validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Show-PortISNS since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Show-PortISNS since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }    
    $cmd= "showportisns "    
    if ($NSP)
    {
        $cmd+=" $NSP "
    }
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $cmd
    write-debuglog " Executing Show-PortISNS command that displays information iSNS table for iSCSI ports in the system " "INFO:"
    if($Result -match "N:S:P")
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count -2         
        foreach ($s in  $Result[0..$LastItem] )
        {        
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s," +",",")
            $s= [regex]::Replace($s,"-","")
            $s= $s.Trim()     
            Add-Content -Path $tempFile -Value $s                
        }            
        Import-Csv $tempFile 
        del $tempFile
    }
    if($Result -match "N:S:P")
    {
        return  " Success : Executing Show-PortISNS"
    }
    else
    {            
        return  $Result
    }
    
} ## End- of Show-PortISNS

##########################################################################
################### FUNCTION Show-SysMgr #######################
##########################################################################
Function Show-SysMgr()
{
<#
  .SYNOPSIS
   Show-SysMgr - Show system manager startup state.

  .DESCRIPTION
   The Show-SysMgr displays startup state information about the system manager.

  .EXAMPLE

  .PARAMETER D
   Shows additional detailed information if available.

  .PARAMETER L
   Shows field service diagnostics for System Manager specific Config Locks
   and MCALLs, and system-wide ioctl system calls.

  .Notes
    NAME: Show-SysMgr
    LASTEDIT 22/11/2019
    KEYWORDS: Show-SysMgr
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $D,

    [Parameter(Position=1, Mandatory=$false)]
    [switch]
    $L,

    [Parameter(Position=2, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-SysMgr - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-SysMgr since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-SysMgr since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " showsysmgr "

 if($D)
 {
    $Cmd += " -d "
 }

 if($L)
 {
    $Cmd += " -l "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-SysMgr command -->" INFO:
 
 Return $Result
} ## End-of Show-SysMgr

##########################################################################
############ FUNCTION Show-SystemResourcesSummary ####################
##########################################################################
Function Show-SystemResourcesSummary()
{
<#
  .SYNOPSIS
   Show-SystemResourcesSummary - Show system Table of Contents (TOC) summary.

  .DESCRIPTION
   The Show-SystemResourcesSummary command displays the system table of contents summary that
   provides a summary of the system's resources.

  .EXAMPLE
   None.

  .Notes
    NAME: Show-SystemResourcesSummary
    LASTEDIT 22/11/2019
    KEYWORDS: Show-SystemResourcesSummary
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )
Write-DebugLog "Start: In Show-SystemResourcesSummary - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-SystemResourcesSummary since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-SystemResourcesSummary since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

 $Cmd = " showtoc "

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-SystemResourcesSummary command -->" INFO: 
 
 Return $Result
} ## End-of Show-SystemResourcesSummary

##########################################################################
######################### FUNCTION Start-NodeRescue ##################
##########################################################################
Function Start-NodeRescue()
{
<#
  .SYNOPSIS
   Start-NodeRescue - Starts a node rescue.

  .DESCRIPTION
   Initiates a node rescue, which initializes the internal node disk of the
   specified node to match the contents of the other node disks. Progress is
   reported as a task.

  .EXAMPLE
    Start-NodeRescue -Node 0
  
  .PARAMETER Node
    Specifies the node to be rescued. This node must be physically present in the system and powered on, but not part of the cluster.

  .Notes
    NAME: Start-NodeRescue
    LASTEDIT 22/11/2019
    KEYWORDS: Start-NodeRescue
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
     [Parameter(Position=0, Mandatory=$True)]
     [System.String]
     $Node,

     [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
     $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Start-NodeRescue - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Start-NodeRescue since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Start-NodeRescue since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " startnoderescue "

 if($Node)
 {
    $Cmd += " -node $Node "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Start-NodeRescue command -->" INFO:
 
 Return $Result
} ## End-of Start-NodeRescue

############################################################################################################################################
## FUNCTION Get-HostPorts
############################################################################################################################################

Function Get-HostPorts
{
<#
  .SYNOPSIS
    Query to get all ports including targets, disks, and RCIP ports.

  .DESCRIPTION
    Get information for Ports
    
  .PARAMETER I
    Shows port hardware inventory information.

  .PARAMETER C
    Displays all devices connected to the port. Such devices include cages
    (for initiator ports), hosts (for target ports) and ports from other
    storage system (for RCFC and peer ports).

  .PARAMETER PAR
    Displays a parameter listing such as the configured data rate of a port
    and the maximum data rate that the card supports. Also shown is the
    type of attachment (Direct Connect or Fabric Attached) and whether the
    unique_nwwn and VCN capabilities are enabled.

  .PARAMETER RC
    Displays information that is specific to the Remote Copy ports.

  .PARAMETER RCFC
    Displays information that is specific to the Fibre Channel Remote Copy
    ports.

  .PARAMETER PEER
    Displays information that is specific to the Fibre Channel ports for
    Data Migration.

  .PARAMETER RCIP
    Displays information specific to the Ethernet Remote Copy ports.

  .PARAMETER ISCSI
    Displays information about iSCSI ports.

  .PARAMETER ISCSINAME
    Displays iSCSI names associated with iSCSI ports.

  .PARAMETER ISCSIVLANS
    Displays information about VLANs on iSCSI ports.

  .PARAMETER Fcoe
    Displays information that is specific to Fibre Channel over Ethernet
    (FCoE) ports.

  .PARAMETER SFP
    Displays information about the SFPs attached to ports.

  .PARAMETER DDM
    Displays Digital Diagnostics Monitoring (DDM) readings from the SFPs if
    they support DDM. This option must be used with the -sfp option.

  .PARAMETER D
    Displays detailed information about the SFPs attached to ports. This
    option is used with the -sfp option.

  .PARAMETER FAILED
    Shows only failed ports.

  .PARAMETER STATE
    Displays the detailed state information. This is the same as -s.

  .PARAMETER Detailed
    Displays the detailed state information.
    This option is deprecated and will be removed in a subsequent release.

  .PARAMETER IDS
    Displays the identities hosted by each physical port.

  .PARAMETER FS
    Displays information specific to the Ethernet File Persona ports.
    To see IP address, netmask and gateway information on File Persona,
    run "showfs -net".
    
  .PARAMETER NSP
    Nede sloat poart
      
  .EXAMPLE
    Get-HostPorts
        Lists all ports including targets, disks, and RCIP ports
        
  .EXAMPLE
    Get-HostPorts -I

  .EXAMPLE
    Get-HostPorts -I -NSP 0:0:0

  .EXAMPLE
    Get-HostPorts -PAR

  .EXAMPLE
    Get-HostPorts -PAR -NSP 0:0:0

  .EXAMPLE
    Get-HostPorts -RC

  .EXAMPLE
    Get-HostPorts -RC -NSP 0:0:0

  .EXAMPLE
    Get-HostPorts -RCFC

  .EXAMPLE
    Get-HostPorts -RCFC -NSP 0:0:0

  .EXAMPLE
    Get-HostPorts -RCIP
                
  .Notes
    NAME: Get-HostPorts
    LASTEDIT: June 2012
    KEYWORDS: Get-HostPorts
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0
 #Requires HPE 3par cli.exe
 #>
 
[CmdletBinding()]
    Param(                
            [Parameter(Position=0 , Mandatory=$false)]
            [switch]$I,
            
            [Parameter(Position=1 , Mandatory=$false)]
            [switch]$PAR,
            
            [Parameter(Position=2 , Mandatory=$false)]
            [switch]$RC,
            
            [Parameter(Position=3 , Mandatory=$false)]
            [switch]$RCFC,
            
            [Parameter(Position=4 , Mandatory=$false)]
            [switch]$RCIP,
            
            [Parameter(Position=5 , Mandatory=$false)]
            [switch]$PEER,
            
            [Parameter(Position=6 , Mandatory=$false)]
            [switch]$ISCSI,
            
            [Parameter(Position=7 , Mandatory=$false)]
            [switch]$ISCSINAME,
            
            [Parameter(Position=8 , Mandatory=$false)]
            [switch]$ISCSIVLANS,
            
            [Parameter(Position=9 , Mandatory=$false)]
            [switch]$FCOE,
            
            [Parameter(Position=10 , Mandatory=$false)]
            [switch]$SFP,
            
            [Parameter(Position=11 , Mandatory=$false)]
            [switch]$FAILED,
            
            [Parameter(Position=12 , Mandatory=$false)]
            [switch]$STATE,
            
            [Parameter(Position=13 , Mandatory=$false)]
            [switch]$Detailed,
            
            [Parameter(Position=14 , Mandatory=$false)]
            [switch]$IDS,
            
            [Parameter(Position=15 , Mandatory=$false)]
            [switch]$FS,
            
            [Parameter(Position=16, Mandatory=$false)]
            [System.String]
            $NSP,
            
            [Parameter(Position=17, Mandatory=$false)]
            [switch]
            $D,
            
            [Parameter(Position=18, Mandatory=$false, ValueFromPipeline=$true)]
            $SANConnection = $global:SANConnection            
        )

    Write-DebugLog "Start: In Get-HostPorts- validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {            
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or Connection object username, password, IPAaddress are null/empty. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Get-HostPorts since the connection object values are null/empty" $Debug
                return
            }
        }
    }
    $plinkresult = Test-PARCli -SANConnection $SANConnection 
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }

    $Cmds = "showport"
    
    if($I)
    {
        $Cmds+=" -i "
    }
    if($C)
    {
        $Cmds+=" -c "
    }
    
    if($PAR)
    {
        $Cmds+=" -par "
    }
    
    if($RC)
    {
        $Cmds+=" -rc "
    }
    
    if($RCFC)
    {
        $Cmds+=" -rcfc "
    }
    
    if($RCIP)
    {
        $Cmds+=" -rcip "
    }
    
    if($PEER)
    {
        $Cmds+=" -peer "
    }
    
    if($ISCSI)
    {
        $Cmds+=" -iscsi "
    }
    
    if($ISCSINAME)
    {
        $Cmds+=" -iscsiname "
    }
    
    if($ISCSIVLANS)
    {
        $Cmds+=" -iscsivlans "
    }
    
    if($FCOE)
    {
        $Cmds+=" -fcoe "
    }
    
    if($SFP)
    {
        $Cmds+=" -sfp "        
    }
    
    if($FAILED)
    {
        $Cmds+=" -failed "
    }
    
    if($STATE)
    {
        $Cmds+=" -state "
    }
    
    if($Detailed)
    {
        $Cmds+=" -s "
    }
    
    if($IDS)
    {
        $Cmds+=" -ids "
    }
    
    if($FS)
    {
        $Cmds+=" -fs "
    }    
    
    if($D)
    {
        if($SFP)
        {
            $Cmds+=" -d "
        }
        else
        {
            return " -d can only be used with -sfp"
        }
    }
    
    if($NSP)
    {
        $Cmds+=" $NSP"
    }
        
    $Result=Invoke-CLICommand -Connection $SANConnection  -cmds $Cmds     
    
    $LastItem = $Result.Count -2  
    
    if($SFP -and $D)
    {
        return $Result
    }
    
    if($Result -match "N:S:P")
    {
        $tempFile = [IO.Path]::GetTempFileName()
        foreach ($s in  $Result[0..$LastItem] )
        {        
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s," +",",")    
            $s= [regex]::Replace($s,"-","")
            $s= [regex]::Replace($s,"\s+",",")         
            $s= [regex]::Replace($s,"/HW_Addr","") 
            $s= [regex]::Replace($s,"N:S:P","Device")
            $s= $s.Trim()     
            Add-Content -Path $tempFile -Value $s                
        }
        
        Import-Csv $tempFile
        del $tempFile
    }
    else
    {
        return  $Result
    }
    
    if($Result -match "N:S:P")
    {
        return  " Success : Executing Get-HostPorts"
    }
    else
    {        
        return  $Result
    }    

} # END FUNCTION Get-HostPorts

##########################################################################
######################### FUNCTION Get-Node ##########################
##########################################################################
Function Get-Node()
{
<#
  .SYNOPSIS
    Get-Node - Show node and its component information.

  .DESCRIPTION
    The Get-Node command displays an overview of the node-specific properties
    and its component information. Various command options can be used to
    display the properties of PCI cards, CPUs, Physical Memory, IDE drives,
    and Power Supplies.

  .EXAMPLE
   The following options are for node summary and inventory information:

  .PARAMETER Listcols
    List the columns available to be shown with the -showcols option
    described below (see 'clihelp -col Get-Node' for help on each column).
    By default (if none of the information selection options below are
    specified) the following columns are shown:
    Node Name State Master InCluster LED Control_Mem Data_Mem Available_Cache
    To display columns pertaining to a specific node component use
    the -Listcols option in conjunction with one of the following
    options: -pci, -cpu, -mem, -drive, -fan, -ps, -mcu, -uptime.

  .PARAMETER Showcols
    Explicitly select the columns to be shown using a comma-separated list
    of column names. For this option, the full column names are shown in
    the header.
    Run 'shownode -listcols' to list Node component columns.
    Run 'shownode -listcols <node_component>' to list columns associated
    with a specific <node_component>.

    <node_component> can be one of the following options: -pci, -cpu, -mem,
    -drive, -fan, -ps, -mcu, -uptime.

    If a specific node component option is not provided, then -showcols expects
    Node columns as input.

    If a column (Node or specific node component) does not match either the Node
    columns list or a specific node component columns list, then
    'shownode -showcols <cols>' request is denied.

    If an invalid column is provided with -showcols, the request is denied.

    The -showcols option can also be used in conjunction with a list of node IDs.

    Run 'clihelp -col shownode' for a description of each column.

  .PARAMETER I
    Shows node inventory information in table format.

  .PARAMETER D
    Shows node and its component information in table format.

    The following options are for node component information. These options
    cannot be used together with options, -i and -d:

  .PARAMETER Verbose_D
    Displays detailed information in verbose format. It can be used together
    with the following component options.

  .PARAMETER Fan
    Displays the node fan information.

  .PARAMETER Pci
    Displays PCI card information

  .PARAMETER Cpu
    Displays CPU information

  .PARAMETER Mem
    Displays physical memory information.

  .PARAMETER Drive
    Displays the disk drive information.

  .PARAMETER Ps
    Displays power supply information.

  .PARAMETER Mcu
    Displays MicroController Unit information.

  .PARAMETER State
    Displays the detailed state information for node or power supply (-ps).
    This is the same as -s.

  .PARAMETER S_State
    Displays the detailed state information for node or power supply (-ps).
    This option is deprecated and will be removed in a subsequent release.

  .PARAMETER Uptime
    Show the amount of time each node has been running since the last shutdown.

  .PARAMETER Svc
    Displays inventory information with HPE serial number, spare part etc.
    This option must be used with -i option and it is not supported on
    HPE 3PAR 10000 systems
   
  .PARAMETER NodeID
    Displays the node information for the specified node ID(s). This
    specifier is not required. Node_ID is an integer from 0 through 7.

  .Notes
    NAME: Get-Node
    LASTEDIT 16-05-2019 09:47:37
    KEYWORDS: Get-Node
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Listcols,

    [Parameter(Position=1, Mandatory=$false)]
    [System.String]
    $Showcols,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $I,

    [Parameter(Position=3, Mandatory=$false)]
    [switch]
    $D,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $Verbose_D,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $Fan,

    [Parameter(Position=6, Mandatory=$false)]
    [switch]
    $Pci,

    [Parameter(Position=7, Mandatory=$false)]
    [switch]
    $Cpu,

    [Parameter(Position=8, Mandatory=$false)]
    [switch]
    $Mem,

    [Parameter(Position=9, Mandatory=$false)]
    [switch]
    $Drive,

    [Parameter(Position=10, Mandatory=$false)]
    [switch]
    $Ps,

    [Parameter(Position=11, Mandatory=$false)]
    [switch]
    $Mcu,

    [Parameter(Position=12, Mandatory=$false)]
    [switch]
    $State,

    [Parameter(Position=13, Mandatory=$false)]
    [switch]
    $S_State,

    [Parameter(Position=14, Mandatory=$false)]
    [switch]
    $Uptime,

    [Parameter(Position=15, Mandatory=$false)]
    [switch]
    $Svc,    

    [Parameter(Position=16, Mandatory=$false)]
    [System.String]
    $NodeID,

    [Parameter(Position=17, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Get-Node - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Get-Node since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Get-Node since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " shownode "

 if($Listcols)
 {
    $Cmd += " -listcols "
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
    return $Result
 }

 if($Showcols)
 {
    $Cmd += " -showcols $Showcols "
 }

 if($I)
 {
    $Cmd += " -i "
 }

 if($D)
 {
    $Cmd += " -d "
 }

 if($Verbose_D)
 {
    $Cmd += " -verbose "
 }

 if($Fan)
 {
    $Cmd += " -fan "
 }

 if($Pci)
 {
    $Cmd += " -pci "
 }

 if($Cpu)
 {
    $Cmd += " -cpu "
 }

 if($Mem)
 {
    $Cmd += " -mem "
 }

 if($Drive)
 {
    $Cmd += " -drive "
 }

 if($Ps)
 {
    $Cmd += " -ps "
 }

 if($Mcu)
 {
    $Cmd += " -mcu "
 }

 if($State)
 {
    $Cmd += " -state "
 }

 if($S_State)
 {
    $Cmd += " -s "
 }

 if($Uptime)
 {
    $Cmd += " -uptime "
 }

 if($Svc)
 {
    $Cmd += " -svc "
 }

 if($NodeID)
 {
  $Cmd += " $NodeID "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing Function : Get-Node Command -->" INFO: 
 
 if($Result.count -gt 1)
 {    
    $Cnt = $Result.count
        
     $tempFile = [IO.Path]::GetTempFileName()
    $LastItem = $Result.Count -1  
    $incre = "True"
    foreach ($s in  $Result[1..$LastItem] )
    {
        $s= [regex]::Replace($s,"^ ","")
        $s= [regex]::Replace($s,"^ ","")
        $s= [regex]::Replace($s,"^ ","")        
        $s= [regex]::Replace($s," +",",")        
        $s= [regex]::Replace($s,"-","")        
        $s= $s.Trim()        
        
        ## Replace Mem(MB) with Control and data Mem(MB)
        if($incre -eq "True")
        {            
            $sTemp1=$s                
            $sTemp = $sTemp1.Split(',')                            
            $sTemp[6] = "Control-Mem(MB)"
            $sTemp[7] = "Data-Mem(MB)"
            $newTemp= [regex]::Replace($sTemp,"^ ","")            
            $newTemp= [regex]::Replace($sTemp," ",",")                
            $newTemp= $newTemp.Trim()
            $s=$newTemp
        }
                
        Add-Content -Path $tempfile -Value $s
        $incre = "False"        
    }
    Import-Csv $tempFile 
    del $tempFile    
 }
 
 if($Result.count -gt 1)
 {
    return  " Success : Executing Get-Node"
 }
 else
 {            
    return  $Result
 }
} ## End-of Get-Node

##########################################################################
######################### FUNCTION Get-Target ########################
##########################################################################
Function Get-Target()
{
<#
  .SYNOPSIS
   Get-Target - Show information about unrecognized targets.

  .DESCRIPTION
   The Get-Target command displays information about unrecognized targets.
   
  .EXAMPLE
    Get-Target
    
  .EXAMPLE
    Get-Target -Lun -Node_WWN 2FF70002AC00001F
    
  .EXAMPLE
    Get-Target -Lun -All
    
  .EXAMPLE
    Get-Target -Inq -Page 0 -LUN_WWN 50002AC00001001F
    
  .EXAMPLE
    Get-Target -Inq -Page 0 -D -LUN_WWN 50002AC00001001F
    
  .EXAMPLE
    Get-Target -Mode -Page 0x3 -D -LUN_WWN 50002AC00001001F

  .PARAMETER Lun
   Displays the exported Logical Unit Numbers (LUNs) from the unknown
   targets. Use the "all" specifier to display the exported LUNs from all
   of the unknown targets.

  .PARAMETER Inq
   Display SCSI inquiry page information.

  .PARAMETER Mode
   Display SCSI mode page information.

  .PARAMETER Page
   Specify the SCSI page number for the inquiry and mode information.
   <num> is a hex number. For SCSI inquiry information, the valid <num>
   is 0, 80, 83, and c0. For SCSI mode information, the valid <num> is 3
   and 4. This option needs to be used together with -inq or -mode. If
   this option is not specified, the default <num> is 0.

  .PARAMETER D
   Display the detail information of SCSI inquiry or mode page information.

  .PARAMETER Force
   Specifies that the rescan is forced. If this option is not used,
   the rescan will be suppressed if the peer ports have already
   been rescanned within the last 10 seconds.

  .PARAMETER Rescan
   Rescan the peer ports to find the unknown targets.

  .Notes
    NAME: Get-Target
    LASTEDIT 21-05-2019 10:42:31
    KEYWORDS: Get-Target
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
     [Parameter(Position=0, Mandatory=$false)]
     [switch]
     $Lun,

     [Parameter(Position=1, Mandatory=$false)]
     [switch]
     $Inq,

     [Parameter(Position=2, Mandatory=$false)]
     [switch]
     $Mode,

     [Parameter(Position=3, Mandatory=$false)]
     [System.String]
     $Page,

     [Parameter(Position=4, Mandatory=$false)]
     [switch]
     $D,

     [Parameter(Position=5, Mandatory=$false)]
     [switch]
     $Force,

     [Parameter(Position=6, Mandatory=$false)]
     [switch]
     $Rescan,

     [Parameter(Position=7, Mandatory=$false)]
     [System.String]
     $Node_WWN,

     [Parameter(Position=8, Mandatory=$false)]
     [System.String]
     $LUN_WWN,
     
     [Parameter(Position=9, Mandatory=$false)]
     [switch]
     $All,

     [Parameter(Position=10, Mandatory=$false, ValueFromPipeline=$true)]
     $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Get-Target - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Get-Target since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Get-Target since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
    write-debuglog "$plinkresult"
    Return $plinkresult
 }

    $Cmd = " showtarget "
    
 if($Lun)
 {
    $Cmd += " -lun "
 } 
 if($All)
 {
    $Cmd += " all "
 }
 if($Inq)
 {
    $Cmd += " -inq "
 }
 if($Mode)
 {
    $Cmd += " -mode "
 } 
 if($Page)
 {
    $Cmd += " -page $Page "
 } 
 if($D)
 {
    $Cmd += " -d "
 }
 if($Force)
 {
    $Cmd += " -force "
 }
 if($Rescan)
 {
    $Cmd += " -rescan "
 }
 
 if($Node_WWN)
 {
    $Cmd += " $Node_WWN "
 }

 if($LUN_WWN)
 {
    $Cmd += " $LUN_WWN "
 }

 write-host "$Cmd"
 
 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Get-Target command -->" INFO: 
 
 Return $Result
} ## End-of Get-Target

##################################################################################
########################### FUNCTION Show-PortARP ################################
##################################################################################
Function Show-PortARP
{
<#
    .SYNOPSIS
        The Show-PortARP command shows the ARP table for iSCSI ports in the system.
        
    .DESCRIPTION
        The Show-PortARP command shows the ARP table for iSCSI ports in the system.
        
    .EXAMPLE
        Show-PortARP
        
    .EXAMPLE
        Show-PortARP -NSP 1:2:3
        
    .PARAMETER NSP
        Specifies the port for which information about devices on that port are displayed.

    .PARAMETER SANConnection
    Specify the SAN Connection object created with New-CLIConnection or New-PoshSshConnection
    
    .Notes
        NAME: Show-PortARP
        LASTEDIT: 01/03/2017
        KEYWORDS: Show-PortARP
   
    .Link
        http://www.hpe.com
 
 #Requires PS -Version 3.0
 #>
[CmdletBinding()]
    param(
        
        [Parameter(Position=0, Mandatory=$false)]
        [System.String]
        $NSP ,
            
        [Parameter(Position=1, Mandatory=$false, ValueFromPipeline=$true)]
        $SANConnection = $global:SANConnection 
       
    )        
    Write-DebugLog "Start: In Show-PortARP - validating input values" $Debug 
    #check if connection object contents are null/empty
    if(!$SANConnection)
    {        
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if($Validate1 -eq "Failed")
        {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if($Validate2 -eq "Failed")
            {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Show-PortARP since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Show-PortARP since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli
    if($plinkresult -match "FAILURE :")
    {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }    
    $cmd= "showportarp "    
    if ($NSP)
    {
        $cmd+=" $NSP "
    }
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $cmd
    write-debuglog " Executing Show-PortARP command that displays information ARP table for iSCSI ports in the system " "INFO:"
    if($Result.Count -gt 1)
    {
        $tempFile = [IO.Path]::GetTempFileName()
        $LastItem = $Result.Count         
        foreach ($s in  $Result[0..$LastItem] )
        {        
            $s= [regex]::Replace($s,"^ ","")            
            $s= [regex]::Replace($s," +",",")
            $s= [regex]::Replace($s,"-","")
            $s= $s.Trim()     
            Add-Content -Path $tempFile -Value $s                
        }            
        Import-Csv $tempFile 
        del $tempFile
    }    
    else
    {
        return $Result
    }
    if($Result.Count -gt 1)
    {
        return  " Success : Executing Show-PortARP"                
    }
    else
    {            
        return  $Result
    }
    
} # End Show-PortARP

##########################################################################
############### FUNCTION Show-UnrecognizedTargetsInfo ###############
##########################################################################
Function Show-UnrecognizedTargetsInfo()
{
<#
  .SYNOPSIS
   Show-UnrecognizedTargetsInfo - Show information about unrecognized targets.

  .DESCRIPTION
   The Show-UnrecognizedTargetsInfo command displays information about unrecognized targets.

  .EXAMPLE

  .PARAMETER Lun
   Displays the exported Logical Unit Numbers (LUNs) from the unknown
   targets. Use the "all" specifier to display the exported LUNs from all
   of the unknown targets.

  .PARAMETER Inq
   Display SCSI inquiry page information.

  .PARAMETER Mode
   Display SCSI mode page information.

  .PARAMETER Page
   Specify the SCSI page number for the inquiry and mode information.
   <num> is a hex number. For SCSI inquiry information, the valid <num>
   is 0, 80, 83, and c0. For SCSI mode information, the valid <num> is 3
   and 4. This option needs to be used together with -inq or -mode. If
   this option is not specified, the default <num> is 0.

  .PARAMETER D
   Display the detail information of SCSI inquiry or mode page information.

  .PARAMETER Force
   Specifies that the rescan is forced. If this option is not used,
   the rescan will be suppressed if the peer ports have already
   been rescanned within the last 10 seconds.

  .PARAMETER VerboseE
   Display any errors during rescan over the peer ports.

  .PARAMETER Rescan
   Rescan the peer ports to find the unknown targets.

  .PARAMETER Sortcol
   Sorts command output based on column number (<col>). Columns are
   numbered from left to right, beginning with 0. At least one column must
   be specified. In addition, the direction of sorting (<dir>) can be
   specified as follows:
       inc
        Sort in increasing order (default).
       dec
        Sort in decreasing order.
   Multiple columns can be specified and separated by a colon (:). Rows
   with the same information in them as earlier columns will be sorted
   by values in later columns.

  .PARAMETER Node_WWN
   Indicates the World Wide Name (WWN) of the node.

  .PARAMETER LUN_WWN
   Indicates the World Wide Name (WWN) of a LUN exported from an unknown target.
   
  .Notes
    NAME: Show-UnrecognizedTargetsInfo
    LASTEDIT 28-06-2019 10:25:56
    KEYWORDS: Show-UnrecognizedTargetsInfo
  
  .Link
    http://www.hpe.com

 #Requires PS -Version 3.0
#>
[CmdletBinding()]
 param(
    [Parameter(Position=0, Mandatory=$false)]
    [switch]
    $Lun,

    [Parameter(Position=1, Mandatory=$false)]
    [switch]
    $Inq,

    [Parameter(Position=2, Mandatory=$false)]
    [switch]
    $Mode,

    [Parameter(Position=3, Mandatory=$false)]
    [System.String]
    $Page,

    [Parameter(Position=4, Mandatory=$false)]
    [switch]
    $D,

    [Parameter(Position=5, Mandatory=$false)]
    [switch]
    $Force,

    [Parameter(Position=6, Mandatory=$false)]
    [switch]
    $VerboseE,

    [Parameter(Position=7, Mandatory=$false)]
    [switch]
    $Rescan,

    [Parameter(Position=8, Mandatory=$false)]
    [System.String]
    $Sortcol,

    [Parameter(Position=9, Mandatory=$false)]
    [System.String]
    $Node_WWN,

    [Parameter(Position=10, Mandatory=$false)]
    [System.String]
    $LUN_WWN,

    [Parameter(Position=11, Mandatory=$false, ValueFromPipeline=$true)]
    $SANConnection = $global:SANConnection
 )

 Write-DebugLog "Start: In Show-UnrecognizedTargetsInfo - validating input values" $Debug 
 #check if connection object contents are null/empty
 if(!$SANConnection)
 {
    #check if connection object contents are null/empty
    $Validate1 = Test-CLIConnection $SANConnection
    if($Validate1 -eq "Failed")
    {
        #check if global connection object contents are null/empty
        $Validate2 = Test-CLIConnection $global:SANConnection
        if($Validate2 -eq "Failed")
        {
            Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" " ERR: "
            Write-DebugLog "Stop: Exiting Show-UnrecognizedTargetsInfo since SAN connection object values are null/empty" $Debug 
            Return "Unable to execute the cmdlet Show-UnrecognizedTargetsInfo since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
        }
    }
 }

 $plinkresult = Test-PARCli -SANConnection $SANConnection
 if($plinkresult -match "FAILURE :")
 {
   write-debuglog "$plinkresult"
   Return $plinkresult
 }

    $Cmd = " showtarget "
    
 if($Lun)
 {
    $Cmd += " -lun "
 }

 if($Inq)
 { 
    $Cmd += " -inq "
 }

 if($Mode)
 {
    $Cmd += " -mode "
 }

 if($Page)
 {
    $Cmd += " -page $Page "
 }

 if($D)
 {
    $Cmd += " -d "
 }

 if($Force)
 {
    $Cmd += " -force "
 }

 if($VerboseE)
 {
    $Cmd += " -verbose "
 }

 if($Rescan)
 {
    $Cmd += " -rescan "
 }

 if($Sortcol)
 {
    $Cmd += " -sortcol $Sortcol "
 }

 if($Node_WWN)
 {
    $Cmd += " $Node_WWN "
 }

 if($LUN_WWN)
 {
    $Cmd += " $LUN_WWN "
 }

 $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $Cmd
 Write-DebugLog "Executing function : Show-UnrecognizedTargetsInfo command -->" INFO: 
 Return $Result
} ## End-of Show-UnrecognizedTargetsInfo

####################################################################################################################
## FUNCTION Test-Port
####################################################################################################################
Function Test-Port {
    <#
  .SYNOPSIS
    Perform loopback tests on Fibre Channel ports.
                                                                                                            
  .SYNTAX
    checkport [options <arg>] <node:slot:port>
                                                                                                            .
  .DESCRIPTION
     The checkport command performs loopback tests on Fibre Channel ports.

  .PARAMETER Time <seconds_to_run>
    Specifies the number of seconds for the test to run using an integer from 0 to 300.
   
  .PARAMETER Iter <iterations_to_run>
    Specifies the number of times for the test to run using an integer from 1 to 1000000.

  .PARAMETER PortNSP
     Specifies the port to be tested.

  .PARAMETER Node
     Specifies the node using a number from 0 through 7.

  .PARAMETER Slot
     Specifies the PCI slot in the specified node. Valid range is 0 - 9.

  .PARAMETER Port
     Specifies the port using a number from 1 through 4.

  .EXAMPLES
    Test-Port test is performed on port 0:0:1 a total of five times:

    Test-Port -iter 5 0:0:1
    Starting loopback test on port 0:0:1
    Port 0:0:1 completed 5 loopback frames in 0 seconds Passed
  
  .NOTES
    Access to all domains is required to run this command.

    When both the -time and -iter options are specified, the first limit
    reached terminates the program. If neither are specified, the default is
    1,000 iterations. The total run time is always limited to 300 seconds even
    when not specified.
    The default loopback is an ELS-ECHO sent to the HBA itself.

    NAME: Test-Port
    LASTEDIT: 25/04/2021
    KEYWORDS: Test-Port
   
  .Link
     http://www.hpe.com
 
 #Requires PS -Version 3.0

 #>
    [CmdletBinding()]
    param(

        [Parameter(Position = 0, Mandatory = $false, HelpMessage = "Number of seconds for the test to run using an integer from 0 to 300")]
        [System.String]
        $TimeInSeconds,        

        [Parameter(Position = 1, Mandatory = $false, HelpMessage = "Number of times for the test to run using an integer from 1 to 1000000")]
        [System.String]
        $Iter,

        [Parameter(Position = 2, Mandatory = $false, HelpMessage = "Specify the port to be tested <node:slot:port>")]
        [System.String]
        $PortNSP,

        [Parameter(Position = 3, Mandatory = $false, HelpMessage = "Specifies the node using a number from 0 through 7")]
        [System.String]
        $Node,        
        
        [Parameter(Position = 4, Mandatory = $false, HelpMessage = "Specifies the PCI slot in the specified node. Valid range is 0 - 9")]
        [System.String]
        $Slot,        

        [Parameter(Position = 5, Mandatory = $false, HelpMessage = "Specifies the port using a number from 1 through 4")]
        [System.String]
        $Port,        

        [Parameter(Position = 6, Mandatory = $false, ValueFromPipeline = $true)]
        $SANConnection = $global:SANConnection        
    )    
    
    Write-DebugLog "Start: In Test-Port - validating input values" $Debug 
    #check if connection object contents are null/empty
    if (!$SANConnection) {
        #check if connection object contents are null/empty
        $Validate1 = Test-CLIConnection $SANConnection
        if ($Validate1 -eq "Failed") {
            #check if global connection object contents are null/empty
            $Validate2 = Test-CLIConnection $global:SANConnection
            if ($Validate2 -eq "Failed") {
                Write-DebugLog "Connection object is null/empty or the array address (FQDN/IP Address) or user credentials in the connection object are either null or incorrect. Create a valid connection object using New-CLIConnection or New-PoshSshConnection" "ERR:"
                Write-DebugLog "Stop: Exiting Test-Port since SAN connection object values are null/empty" $Debug
                return "Unable to execute the cmdlet Test-Port since no active storage connection session exists. `nUse New-PoshSSHConnection or New-CLIConnection to start a new storage connection session."
            }
        }
    }
    $plinkresult = Test-PARCli
    if ($plinkresult -match "FAILURE :") {
        write-debuglog "$plinkresult" "ERR:" 
        return $plinkresult
    }        
    $cmd = "checkport "    
    
    if ($TimeInSeconds) {
        $cmd += " -time $TimeInSeconds"    
    }
    if ($Iter) {
        $cmd += " -iter $Iter"    
    }

    if ($PortNSP) {
        $cmd += "$PortNSP"        
    }
    elseif (($Node) -and ($Slot) -and ($Port)) {
        $cmd += "$($Node):$($Slot):$($Port)"
    }
    else {        
        Return "Node, slot and plot details are required"
    }
    
    $Result = Invoke-CLICommand -Connection $SANConnection -cmds  $cmd

    write-debuglog " The Test-Port command perform loopback tests on Fibre Channel ports" "INFO:" 
    return     $Result    

} # End Test-Port

Export-ModuleMember Find-Node , Find-System , Get-System , Ping-RCIPPorts , Set-Battery , Set-FCPorts , Set-HostPorts , 
Set-NodeProperties , Set-NodesDate , Set-SysMgr , Show-Battery , Show-EEProm , Get-SystemInformation , Show-FCOEStatistics , 
Show-Firmwaredb , Show-TOCGen , Show-iSCSISessionStatistics , Show-iSCSIStatistics , Show-NetworkDetail , Show-NodeEnvironmentStatus ,
Show-iSCSISession , Show-NodeProperties , Show-Portdev , Show-PortISNS , Show-SysMgr , Show-SystemResourcesSummary , Start-NodeRescue , 
Get-HostPorts , Get-Node , Get-Target , Show-PortARP , Show-UnrecognizedTargetsInfo , Test-Port
# SIG # Begin signature block
# MIIhEAYJKoZIhvcNAQcCoIIhATCCIP0CAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDS87/+5MpuLV2n
# DysKmsnJ0BVirK+ka6h+46s4UtR5WqCCEKswggUpMIIEEaADAgECAhB4Lu4fcD9z
# xUgD+jf1OoqlMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAkdCMRswGQYDVQQI
# ExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcTB1NhbGZvcmQxGDAWBgNVBAoT
# D1NlY3RpZ28gTGltaXRlZDEkMCIGA1UEAxMbU2VjdGlnbyBSU0EgQ29kZSBTaWdu
# aW5nIENBMB4XDTIxMDUyODAwMDAwMFoXDTIyMDUyODIzNTk1OVowgZAxCzAJBgNV
# BAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMRIwEAYDVQQHDAlQYWxvIEFsdG8x
# KzApBgNVBAoMIkhld2xldHQgUGFja2FyZCBFbnRlcnByaXNlIENvbXBhbnkxKzAp
# BgNVBAMMIkhld2xldHQgUGFja2FyZCBFbnRlcnByaXNlIENvbXBhbnkwggEiMA0G
# CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDmclZSXJBXA55ijwwFymuq+Y4F/quF
# mm2vRdEmjFhzRvTpnGjIYtVcG11ka4JGCROmNVDZGAelnqcXn5DKO710j5SICTBC
# 5gXOLwga7usifs21W+lVT0BsZTiUnFu4hEhuFTlahJIEvPGVgO1GBcuItD2QqB4q
# 9j15GDI5nGBSzIyJKMctcIalxsTSPG1kiDbLkdfsIivhe9u9m8q6NRqDUaYYQTN+
# /qGCqVNannMapH8tNHqFb6VdzUFI04t7kFtSk00AkdD6qUvA4u8mL2bUXAYz8K5m
# nrFs+ckx5Yqdxfx68EO26Bt2qbz/oTHxE6FiVzsDl90bcUAah2l976ebAgMBAAGj
# ggGQMIIBjDAfBgNVHSMEGDAWgBQO4TqoUzox1Yq+wbutZxoDha00DjAdBgNVHQ4E
# FgQUlC56g+JaYFsl5QWK2WDVOsG+pCEwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB
# /wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUHAwMwEQYJYIZIAYb4QgEBBAQDAgQQMEoG
# A1UdIARDMEEwNQYMKwYBBAGyMQECAQMCMCUwIwYIKwYBBQUHAgEWF2h0dHBzOi8v
# c2VjdGlnby5jb20vQ1BTMAgGBmeBDAEEATBDBgNVHR8EPDA6MDigNqA0hjJodHRw
# Oi8vY3JsLnNlY3RpZ28uY29tL1NlY3RpZ29SU0FDb2RlU2lnbmluZ0NBLmNybDBz
# BggrBgEFBQcBAQRnMGUwPgYIKwYBBQUHMAKGMmh0dHA6Ly9jcnQuc2VjdGlnby5j
# b20vU2VjdGlnb1JTQUNvZGVTaWduaW5nQ0EuY3J0MCMGCCsGAQUFBzABhhdodHRw
# Oi8vb2NzcC5zZWN0aWdvLmNvbTANBgkqhkiG9w0BAQsFAAOCAQEAY+1n2UUlQU6Z
# VoEVaZKqZf/zrM/d7Kbx+S/t8mR2E+uNXStAnwztElqrm3fSr+5LMRzBhrYiSmea
# w9c/0c7qFO9mt8RR2q2uj0Huf+oAMh7TMuMKZU/XbT6tS1e15B8ZhtqOAhmCug6s
# DuNvoxbMpokYevpa24pYn18ELGXOUKlqNUY2qOs61GVvhG2+V8Hl/pajE7yQ4diz
# iP7QjMySms6BtZV5qmjIFEWKY+UTktUcvN4NVA2J0TV9uunDbHRt4xdY8TF/Clgz
# Z/MQHJ/X5yX6kupgDeN2t3o+TrColetBnwk/SkJEsUit0JapAiFUx44j4w61Qanb
# Zmi0tr8YGDCCBYEwggRpoAMCAQICEDlyRDr5IrdR19NsEN0xNZUwDQYJKoZIhvcN
# AQEMBQAwezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3Rl
# cjEQMA4GA1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQx
# ITAfBgNVBAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczAeFw0xOTAzMTIwMDAw
# MDBaFw0yODEyMzEyMzU5NTlaMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKTmV3
# IEplcnNleTEUMBIGA1UEBxMLSmVyc2V5IENpdHkxHjAcBgNVBAoTFVRoZSBVU0VS
# VFJVU1QgTmV0d29yazEuMCwGA1UEAxMlVVNFUlRydXN0IFJTQSBDZXJ0aWZpY2F0
# aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIAS
# ZRc2DsPbCLPQrFcNdu3NJ9NMrVCDYeKqIE0JLWQJ3M6Jn8w9qez2z8Hc8dOx1ns3
# KBErR9o5xrw6GbRfpr19naNjQrZ28qk7K5H44m/Q7BYgkAk+4uh0yRi0kdRiZNt/
# owbxiBhqkCI8vP4T8IcUe/bkH47U5FHGEWdGCFHLhhRUP7wz/n5snP8WnRi9UY41
# pqdmyHJn2yFmsdSbeAPAUDrozPDcvJ5M/q8FljUfV1q3/875PbcstvZU3cjnEjpN
# rkyKt1yatLcgPcp/IjSufjtoZgFE5wFORlObM2D3lL5TN5BzQ/Myw1Pv26r+dE5p
# x2uMYJPexMcM3+EyrsyTO1F4lWeL7j1W/gzQaQ8bD/MlJmszbfduR/pzQ+V+DqVm
# sSl8MoRjVYnEDcGTVDAZE6zTfTen6106bDVc20HXEtqpSQvf2ICKCZNijrVmzyWI
# zYS4sT+kOQ/ZAp7rEkyVfPNrBaleFoPMuGfi6BOdzFuC00yz7Vv/3uVzrCM7LQC/
# NVV0CUnYSVgaf5I25lGSDvMmfRxNF7zJ7EMm0L9BX0CpRET0medXh55QH1dUqD79
# dGMvsVBlCeZYQi5DGky08CVHWfoEHpPUJkZKUIGy3r54t/xnFeHJV4QeD2PW6WK6
# 1l9VLupcxigIBCU5uA4rqfJMlxwHPw1S9e3vL4IPAgMBAAGjgfIwge8wHwYDVR0j
# BBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYDVR0OBBYEFFN5v1qqK0rPVIDh
# 2JvAnfKyA2bLMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MBEGA1Ud
# IAQKMAgwBgYEVR0gADBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3JsLmNvbW9k
# b2NhLmNvbS9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDA0BggrBgEFBQcBAQQo
# MCYwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmNvbW9kb2NhLmNvbTANBgkqhkiG
# 9w0BAQwFAAOCAQEAGIdR3HQhPZyK4Ce3M9AuzOzw5steEd4ib5t1jp5y/uTW/qof
# nJYt7wNKfq70jW9yPEM7wD/ruN9cqqnGrvL82O6je0P2hjZ8FODN9Pc//t64tIrw
# kZb+/UNkfv3M0gGhfX34GRnJQisTv1iLuqSiZgR2iJFODIkUzqJNyTKzuugUGrxx
# 8VvwQQuYAAoiAxDlDLH5zZI3Ge078eQ6tvlFEyZ1r7uq7z97dzvSxAKRPRkA0xdc
# Ods/exgNRc2ThZYvXd9ZFk8/Ub3VRRg/7UqO6AZhdCMWtQ1QcydER38QXYkqa4Ux
# FMToqWpMgLxqeM+4f452cpkMnf7XkQgWoaNflTCCBfUwggPdoAMCAQICEB2iSDBv
# myYY0ILgln0z02owDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpOZXcgSmVyc2V5MRQwEgYDVQQHEwtKZXJzZXkgQ2l0eTEeMBwGA1UEChMV
# VGhlIFVTRVJUUlVTVCBOZXR3b3JrMS4wLAYDVQQDEyVVU0VSVHJ1c3QgUlNBIENl
# cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTE4MTEwMjAwMDAwMFoXDTMwMTIzMTIz
# NTk1OVowfDELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3Rl
# cjEQMA4GA1UEBxMHU2FsZm9yZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSQw
# IgYDVQQDExtTZWN0aWdvIFJTQSBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3
# DQEBAQUAA4IBDwAwggEKAoIBAQCGIo0yhXoYn0nwli9jCB4t3HyfFM/jJrYlZilA
# hlRGdDFixRDtsocnppnLlTDAVvWkdcapDlBipVGREGrgS2Ku/fD4GKyn/+4uMyD6
# DBmJqGx7rQDDYaHcaWVtH24nlteXUYam9CflfGqLlR5bYNV+1xaSnAAvaPeX7Wpy
# vjg7Y96Pv25MQV0SIAhZ6DnNj9LWzwa0VwW2TqE+V2sfmLzEYtYbC43HZhtKn52B
# xHJAteJf7wtF/6POF6YtVbC3sLxUap28jVZTxvC6eVBJLPcDuf4vZTXyIuosB69G
# 2flGHNyMfHEo8/6nxhTdVZFuihEN3wYklX0Pp6F8OtqGNWHTAgMBAAGjggFkMIIB
# YDAfBgNVHSMEGDAWgBRTeb9aqitKz1SA4dibwJ3ysgNmyzAdBgNVHQ4EFgQUDuE6
# qFM6MdWKvsG7rWcaA4WtNA4wDgYDVR0PAQH/BAQDAgGGMBIGA1UdEwEB/wQIMAYB
# Af8CAQAwHQYDVR0lBBYwFAYIKwYBBQUHAwMGCCsGAQUFBwMIMBEGA1UdIAQKMAgw
# BgYEVR0gADBQBgNVHR8ESTBHMEWgQ6BBhj9odHRwOi8vY3JsLnVzZXJ0cnVzdC5j
# b20vVVNFUlRydXN0UlNBQ2VydGlmaWNhdGlvbkF1dGhvcml0eS5jcmwwdgYIKwYB
# BQUHAQEEajBoMD8GCCsGAQUFBzAChjNodHRwOi8vY3J0LnVzZXJ0cnVzdC5jb20v
# VVNFUlRydXN0UlNBQWRkVHJ1c3RDQS5jcnQwJQYIKwYBBQUHMAGGGWh0dHA6Ly9v
# Y3NwLnVzZXJ0cnVzdC5jb20wDQYJKoZIhvcNAQEMBQADggIBAE1jUO1HNEphpNve
# aiqMm/EAAB4dYns61zLC9rPgY7P7YQCImhttEAcET7646ol4IusPRuzzRl5ARokS
# 9At3WpwqQTr81vTr5/cVlTPDoYMot94v5JT3hTODLUpASL+awk9KsY8k9LOBN9O3
# ZLCmI2pZaFJCX/8E6+F0ZXkI9amT3mtxQJmWunjxucjiwwgWsatjWsgVgG10Xkp1
# fqW4w2y1z99KeYdcx0BNYzX2MNPPtQoOCwR/oEuuu6Ol0IQAkz5TXTSlADVpbL6f
# ICUQDRn7UJBhvjmPeo5N9p8OHv4HURJmgyYZSJXOSsnBf/M6BZv5b9+If8AjntIe
# Q3pFMcGcTanwWbJZGehqjSkEAnd8S0vNcL46slVaeD68u28DECV3FTSK+TbMQ5Lk
# uk/xYpMoJVcp+1EZx6ElQGqEV8aynbG8HArafGd+fS7pKEwYfsR7MUFxmksp7As9
# V1DSyt39ngVR5UR43QHesXWYDVQk/fBO4+L4g71yuss9Ou7wXheSaG3IYfmm8SoK
# C6W59J7umDIFhZ7r+YMp08Ysfb06dy6LN0KgaoLtO0qqlBCk4Q34F8W2WnkzGJLj
# tXX4oemOCiUe5B7xn1qHI/+fpFGe+zmAEc3btcSnqIBv5VPU4OOiwtJbGvoyJi1q
# V3AcPKRYLqPzW0sH3DJZ84enGm1YMYIPuzCCD7cCAQEwgZAwfDELMAkGA1UEBhMC
# R0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9y
# ZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSQwIgYDVQQDExtTZWN0aWdvIFJT
# QSBDb2RlIFNpZ25pbmcgQ0ECEHgu7h9wP3PFSAP6N/U6iqUwDQYJYIZIAWUDBAIB
# BQCgfDAQBgorBgEEAYI3AgEMMQIwADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB
# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg
# p26e6TKMbUo1Kj0C/kyGYOVSA0v16TlDVsvf2cCftscwDQYJKoZIhvcNAQEBBQAE
# ggEApftMZMlG1tPj4tGIb6QtxEy9xVoypTnr35OE9GYoP9iJ8j78NJeumM2WBTv8
# hyaF9LPKXL8N/DJ86U0Pg0CnYH7DqrQS7sw5nvB7eosDP47RNvt1gFBZ8mWco6cU
# 6kO6m8BTfFDfBMUcCiJGQ+ofbC8kV+0vQ/3eFSqmyRPC4SiTG+H6pf+mqQ/x25vQ
# xQHsQOIrIr1RvGJHmj4uqyPqKtMdxZNr68EvDEwzEgBZNNnJHiIt1v7WINOVHwyW
# t91U8OlneOnHGwz7ywiI/BjAO9Ffe1CxpChppsCknpHVVo5386eS9ADZcqm6cHFZ
# zKhd/jCXkdkUG9Rk6zGRyji/nqGCDX0wgg15BgorBgEEAYI3AwMBMYINaTCCDWUG
# CSqGSIb3DQEHAqCCDVYwgg1SAgEDMQ8wDQYJYIZIAWUDBAIBBQAwdwYLKoZIhvcN
# AQkQAQSgaARmMGQCAQEGCWCGSAGG/WwHATAxMA0GCWCGSAFlAwQCAQUABCBiVrol
# /Y9TWK2F582U0SyACn9I1uggu7SRT7x0aPc9NgIQWiJmz7nUX36jqTfhbI/lpRgP
# MjAyMTA2MTkwNDE5MjFaoIIKNzCCBP4wggPmoAMCAQICEA1CSuC+Ooj/YEAhzhQA
# 8N0wDQYJKoZIhvcNAQELBQAwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lD
# ZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGln
# aUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBDQTAeFw0yMTAxMDEw
# MDAwMDBaFw0zMTAxMDYwMDAwMDBaMEgxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5E
# aWdpQ2VydCwgSW5jLjEgMB4GA1UEAxMXRGlnaUNlcnQgVGltZXN0YW1wIDIwMjEw
# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDC5mGEZ8WK9Q0IpEXKY2tR
# 1zoRQr0KdXVNlLQMULUmEP4dyG+RawyW5xpcSO9E5b+bYc0VkWJauP9nC5xj/TZq
# gfop+N0rcIXeAhjzeG28ffnHbQk9vmp2h+mKvfiEXR52yeTGdnY6U9HR01o2j8aj
# 4S8bOrdh1nPsTm0zinxdRS1LsVDmQTo3VobckyON91Al6GTm3dOPL1e1hyDrDo4s
# 1SPa9E14RuMDgzEpSlwMMYpKjIjF9zBa+RSvFV9sQ0kJ/SYjU/aNY+gaq1uxHTDC
# m2mCtNv8VlS8H6GHq756WwogL0sJyZWnjbL61mOLTqVyHO6fegFz+BnW/g1JhL0B
# AgMBAAGjggG4MIIBtDAOBgNVHQ8BAf8EBAMCB4AwDAYDVR0TAQH/BAIwADAWBgNV
# HSUBAf8EDDAKBggrBgEFBQcDCDBBBgNVHSAEOjA4MDYGCWCGSAGG/WwHATApMCcG
# CCsGAQUFBwIBFhtodHRwOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwHwYDVR0jBBgw
# FoAU9LbhIB3+Ka7S5GGlsqIlssgXNW4wHQYDVR0OBBYEFDZEho6kurBmvrwoLR1E
# Nt3janq8MHEGA1UdHwRqMGgwMqAwoC6GLGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNv
# bS9zaGEyLWFzc3VyZWQtdHMuY3JsMDKgMKAuhixodHRwOi8vY3JsNC5kaWdpY2Vy
# dC5jb20vc2hhMi1hc3N1cmVkLXRzLmNybDCBhQYIKwYBBQUHAQEEeTB3MCQGCCsG
# AQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wTwYIKwYBBQUHMAKGQ2h0
# dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFNIQTJBc3N1cmVkSURU
# aW1lc3RhbXBpbmdDQS5jcnQwDQYJKoZIhvcNAQELBQADggEBAEgc3LXpmiO85xrn
# IA6OZ0b9QnJRdAojR6OrktIlxHBZvhSg5SeBpU0UFRkHefDRBMOG2Tu9/kQCZk3t
# aaQP9rhwz2Lo9VFKeHk2eie38+dSn5On7UOee+e03UEiifuHokYDTvz0/rdkd2Nf
# I1Jpg4L6GlPtkMyNoRdzDfTzZTlwS/Oc1np72gy8PTLQG8v1Yfx1CAB2vIEO+MDh
# XM/EEXLnG2RJ2CKadRVC9S0yOIHa9GCiurRS+1zgYSQlT7LfySmoc0NR2r1j1h9b
# m/cuG08THfdKDXF+l7f0P4TrweOjSaH6zqe/Vs+6WXZhiV9+p7SOZ3j5Npjhyyja
# W4emii8wggUxMIIEGaADAgECAhAKoSXW1jIbfkHkBdo2l8IVMA0GCSqGSIb3DQEB
# CwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNV
# BAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNVBAMTG0RpZ2lDZXJ0IEFzc3VyZWQg
# SUQgUm9vdCBDQTAeFw0xNjAxMDcxMjAwMDBaFw0zMTAxMDcxMjAwMDBaMHIxCzAJ
# BgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5k
# aWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBU
# aW1lc3RhbXBpbmcgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9
# 0DLuS82Pf92puoKZxTlUKFe2I0rEDgdFM1EQfdD5fU1ofue2oPSNs4jkl79jIZCY
# vxO8V9PD4X4I1moUADj3Lh477sym9jJZ/l9lP+Cb6+NGRwYaVX4LJ37AovWg4N4i
# Pw7/fpX786O6Ij4YrBHk8JkDbTuFfAnT7l3ImgtU46gJcWvgzyIQD3XPcXJOCq3f
# QDpct1HhoXkUxk0kIzBdvOw8YGqsLwfM/fDqR9mIUF79Zm5WYScpiYRR5oLnRlD9
# lCosp+R1PrqYD4R/nzEU1q3V8mTLex4F0IQZchfxFwbvPc3WTe8GQv2iUypPhR3E
# HTyvz9qsEPXdrKzpVv+TAgMBAAGjggHOMIIByjAdBgNVHQ4EFgQU9LbhIB3+Ka7S
# 5GGlsqIlssgXNW4wHwYDVR0jBBgwFoAUReuir/SSy4IxLVGLp6chnfNtyA8wEgYD
# VR0TAQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYB
# BQUHAwgweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5k
# aWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0
# LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4
# oDaGNGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJv
# b3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2Vy
# dEFzc3VyZWRJRFJvb3RDQS5jcmwwUAYDVR0gBEkwRzA4BgpghkgBhv1sAAIEMCow
# KAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCwYJYIZI
# AYb9bAcBMA0GCSqGSIb3DQEBCwUAA4IBAQBxlRLpUYdWac3v3dp8qmN6s3jPBjdA
# hO9LhL/KzwMC/cWnww4gQiyvd/MrHwwhWiq3BTQdaq6Z+CeiZr8JqmDfdqQ6kw/4
# stHYfBli6F6CJR7Euhx7LCHi1lssFDVDBGiy23UC4HLHmNY8ZOUfSBAYX4k4YU1i
# RiSHY4yRUiyvKYnleB/WCxSlgNcSR3CzddWThZN+tpJn+1Nhiaj1a5bA9FhpDXzI
# AbG5KHW3mWOFIoxhynmUfln8jA/jb7UBJrZspe6HUSHkWGCbugwtK22ixH67xCUr
# RwIIfEmuE7bhfEJCKMYYVs9BNLZmXbZ0e/VWMyIvIjayS6JKldj1po5SMYIChjCC
# AoICAQEwgYYwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZ
# MBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNlcnQgU0hB
# MiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBDQQIQDUJK4L46iP9gQCHOFADw3TAN
# BglghkgBZQMEAgEFAKCB0TAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwHAYJ
# KoZIhvcNAQkFMQ8XDTIxMDYxOTA0MTkyMVowKwYLKoZIhvcNAQkQAgwxHDAaMBgw
# FgQU4deCqOGRvu9ryhaRtaq0lKYkm/MwLwYJKoZIhvcNAQkEMSIEIKARtwyifpnJ
# R+Fp2zOF697scLCdRvt2gRLon2joAojSMDcGCyqGSIb3DQEJEAIvMSgwJjAkMCIE
# ILMQkAa8CtmDB5FXKeBEA0Fcg+MpK2FPJpZMjTVx7PWpMA0GCSqGSIb3DQEBAQUA
# BIIBAAS6Wo6hjgSilS8Aoo31Gnv8vuYaHdM3Lb7Kwp1iSDTPGEJEdGNWQfitVQM1
# 7eHm0IKLjFZ0JDA6QdDalQ1+iBME3nj5CFEFubX2yFloqOux/o4+rMbSyrtCE79z
# dV3tvJ46ipaAKPjZpUZR39gVXJVSRB3nMHDqPRu5GsEb7wo3K38iQ5jzFsRogJRy
# CpZgXf3qYVjWisQkusAgm9RM8aEZsqtoccBYLgUaj60eehpE9VayX9NU3OBbCeU3
# UVMlK6cpsMuCXpH+ArHRgSF/kJLo1mlMCMal4edAKhVO9o79EbjGeCrH2PsjgcU6
# ldcjSVBj2RC72xqiScWwFKLHA+8=
# SIG # End signature block