AzStackHciStandaloneObservability/package/scripts/ReportStatus.ps1

##------------------------------------------------------------------
## <copyright file="ReportStatus.ps1" company="Microsoft">
## Copyright (C) Microsoft. All rights reserved.
## </copyright>
##------------------------------------------------------------------

<#
.SYNOPSIS
    Generate json file for recording current status
 
.EXAMPLE
    PS C:\>ReportStatus.ps1 -Name $Name `
                            -Operation $Operation `
                            -Status $Status `
                            -Code $Code `
                            -Message $Message
 
    Generate a json file with transitioning status
 
.OUTPUTS
    Sample output of json status (currently not entire status is outputted as of now)
 
    With Localization support:
    [
        {
            "version": 1.0,
            "timestampUTC": "<current utc time>",
            "status" : {
                "name": "<Handler workload name>",
                "operation": "<name of the operation being performed>",
                "configurationAppliedTime": "<UTC time indicating when the configuration was last successfully applied>",
                "status": "<transitioning | error | success | warning>",
                "code": <Valid integer status code>,
                "message": {
                    "id": "id of the localized resource",
                    "params": [
                        "MyParam0",
                        "MyParam1"
                    ]
                },
                "formattedMessage": {
                    "lang": "Lang[-locale]",
                    "message": "formatted user message"
                },
                "substatus": [
                    {
                        "name": "<Handler workload subcomponent name>",
                        "status": "<transitioning | error | success | warning>",
                        "code": <Valid integer status code>,
                        "message": {
                            "id": "id of the localized resource",
                            "params": [
                                "MyParam0",
                                "MyParam1"
                            ]
                        },
                        "formattedMessage": {
                            "lang": "Lang[-locale]",
                            "message": "formatted user message"
                        },
                    }
                ]
            }
        }
    ]
 
    Without Localization support:
 
    [
        {
            "version": 1,
            "timestampUTC": "2013-11-17T16:05:14Z ",
            "status": {
                "name": "enable wordpress",
                "operation": "installing wordpress",
                "status": "transitioning",
                "formattedMessage": {
                    "lang": "en",
                    "message": "Enable IIS on the VM."
                },
                "substatus": [
                    {
                        "name": "Wordpress plugin",
                        "status": "success",
                        "code": 0,
                        "formattedMessage": {
                            "lang": "en-US",
                            "message": "Successfully downloaded wordpress plugin."
                        }
                    },
                    {
                        "name": "Enable IIS",
                        "status": "transitioning",
                        "message": "Turning windows feature for enabling IIS on."
                    }
                ]
            }
        }
    ]
#>


param (
    [Parameter(Mandatory)]
    [System.String] $Name,

    [Parameter(Mandatory)]
    [System.String] $Operation,

    [Parameter(Mandatory)]
    [ValidateSet("transitioning", "error", "success", "warning")]
    [System.String] $Status,

    [Parameter(Mandatory)]
    [System.Int16] $Code,

    [Parameter(Mandatory)]
    [System.String] $Message
)

$ErrorActionPreference = "Stop"
$functionName = $MyInvocation.MyCommand.Name

# region Imports
Import-Module (Join-Path -Path $PSScriptRoot -ChildPath 'ExtensionHelper.psm1') `
    -NoClobber `
    -DisableNameChecking `
    -Verbose:$false

$gmaPackageContentPath = Get-GmaPackageContentPath
Import-Module (Join-Path -Path $gmaPackageContentPath -ChildPath 'GMATenantJsonHelper.psm1') `
    -DisableNameChecking `
    -Verbose:$false

$configSeqNum = $null
$statusFilePath = $null
$statusJson = $null
$statusList = @()
$logFile = Get-HandlerLogFile

try {
    $level = $MiscConstants.Level.Info

    if ($Status -eq $MiscConstants.Status.Warning) {
        $level = $MiscConstants.Level.Warning
    }
    elseif ($Status -eq $MiscConstants.Status.Error) {
        $level = $MiscConstants.Level.Error
    }

    Write-Log `
        -Message "$functionName`: Name: $Name, Operation: $Operation, Status: $Status, Code: $Code, Message: $Message" `
        -LogFile $logFile `
        -Level $level

    $configSeqNum = Get-ConfigSequenceNumber

    $statusFolder = Get-StatusFolderPath

    $statusFilePath = "$statusFolder\$configSeqNum.status"

    $status_report = [ordered]@{}
    $status_report.version = "1.0"
    $status_report.timestampUTC = [System.DateTime]::UtcNow.ToString("s") + "Z" 
    $status_report.status = [ordered]@{}
    $status_report.status.name = $Name
    $status_report.status.operation = $Operation
    $status_report.status.status = $Status
    $status_report.status.code = $Code
    $status_report.status.formattedMessage = [ordered]@{}
    $status_report.status.formattedMessage.lang = "en-US"
    $status_report.status.formattedMessage.message = $Message
    $status_report.status.substatus = $null

    $statusList += $status_report
    $statusJson = ConvertTo-Json $statusList -Depth 10
    $retryCount = 1
    $isStatusWritten = $false
    while (-not (Test-Path $statusFilePath) -or `
            (-not $isStatusWritten -and $retryCount -le 3)) {

        Write-Log `
            -Message "$functionName : Attempt #$retryCount : Writing to status file at $statusFilePath" `
            -LogFile $logFile

        Out-File `
            -FilePath $statusFilePath `
            -InputObject $statusJson `
            -Encoding utf8 `
            -ErrorAction $MiscConstants.ErrorActionPreference.SilentlyContinue `
            -ErrorVariable WriteError `
            -Verbose:$false `
            | Out-Null

        if ($WriteError) {
            $message = "$functionName : Writing to status file failed with error: $WriteError"    
            Write-Log `
                -Message $message `
                -LogFile $logFile `
                -Level $MiscConstants.Level.Error

            $retryCount++
            Start-Sleep 2
        }
        else {
            $isStatusWritten = $true
        }
    }
}
catch {
    if ($null -eq (Get-Command Get-ExceptionDetails -ErrorAction SilentlyContinue)) {
        Import-Module (Join-Path -Path $gmaPackageContentPath -ChildPath 'GMATenantJsonHelper.psm1') `
            -Force `
            -DisableNameChecking `
            -Verbose:$false
    }

    $exceptionDetails = Get-ExceptionDetails -ErrorObject $_

    $errorMessage = "$functionName : Failed to write to status file $statusFilePath with contents ($statusJson). Exception is as follows: $exceptionDetails"
    Write-Log `
        -Message $errorMessage `
        -LogFile $logFile `
        -Level $MiscConstants.Level.Error
        
    exit $ErrorConstants.DefaultErrorMessage.Code
}
# SIG # Begin signature block
# MIInwAYJKoZIhvcNAQcCoIInsTCCJ60CAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBfq+nqVqYcb4yh
# ik49IaMmOePOGX+f80Y+pKU9j5FaB6CCDXYwggX0MIID3KADAgECAhMzAAADTrU8
# esGEb+srAAAAAANOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjMwMzE2MTg0MzI5WhcNMjQwMzE0MTg0MzI5WjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQDdCKiNI6IBFWuvJUmf6WdOJqZmIwYs5G7AJD5UbcL6tsC+EBPDbr36pFGo1bsU
# p53nRyFYnncoMg8FK0d8jLlw0lgexDDr7gicf2zOBFWqfv/nSLwzJFNP5W03DF/1
# 1oZ12rSFqGlm+O46cRjTDFBpMRCZZGddZlRBjivby0eI1VgTD1TvAdfBYQe82fhm
# WQkYR/lWmAK+vW/1+bO7jHaxXTNCxLIBW07F8PBjUcwFxxyfbe2mHB4h1L4U0Ofa
# +HX/aREQ7SqYZz59sXM2ySOfvYyIjnqSO80NGBaz5DvzIG88J0+BNhOu2jl6Dfcq
# jYQs1H/PMSQIK6E7lXDXSpXzAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUnMc7Zn/ukKBsBiWkwdNfsN5pdwAw
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwMDUxNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAD21v9pHoLdBSNlFAjmk
# mx4XxOZAPsVxxXbDyQv1+kGDe9XpgBnT1lXnx7JDpFMKBwAyIwdInmvhK9pGBa31
# TyeL3p7R2s0L8SABPPRJHAEk4NHpBXxHjm4TKjezAbSqqbgsy10Y7KApy+9UrKa2
# kGmsuASsk95PVm5vem7OmTs42vm0BJUU+JPQLg8Y/sdj3TtSfLYYZAaJwTAIgi7d
# hzn5hatLo7Dhz+4T+MrFd+6LUa2U3zr97QwzDthx+RP9/RZnur4inzSQsG5DCVIM
# pA1l2NWEA3KAca0tI2l6hQNYsaKL1kefdfHCrPxEry8onJjyGGv9YKoLv6AOO7Oh
# JEmbQlz/xksYG2N/JSOJ+QqYpGTEuYFYVWain7He6jgb41JbpOGKDdE/b+V2q/gX
# UgFe2gdwTpCDsvh8SMRoq1/BNXcr7iTAU38Vgr83iVtPYmFhZOVM0ULp/kKTVoir
# IpP2KCxT4OekOctt8grYnhJ16QMjmMv5o53hjNFXOxigkQWYzUO+6w50g0FAeFa8
# 5ugCCB6lXEk21FFB1FdIHpjSQf+LP/W2OV/HfhC3uTPgKbRtXo83TZYEudooyZ/A
# Vu08sibZ3MkGOJORLERNwKm2G7oqdOv4Qj8Z0JrGgMzj46NFKAxkLSpE5oHQYP1H
# tPx1lPfD7iNSbJsP6LiUHXH1MIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg
# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03
# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr
# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg
# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy
# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9
# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh
# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k
# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB
# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn
# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90
# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w
# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o
# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD
# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa
# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny
# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG
# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV
# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG
# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl
# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb
# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l
# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6
# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0
# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560
# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam
# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa
# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah
# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA
# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt
# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr
# /Xmfwb1tbWrJUnMTDXpQzTGCGaAwghmcAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEILwb1TO8lLmcOk7lFdxii5oF
# +LnR3UtknxfbmyGGO1wZMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAzVKLqg2ysagPAf94RYO49QJTb3KizTcDK7DbhA9tmziPiHMHiTKjFIVb
# ETXrDLdJ9+cATUEkNdgBSL6dpWZCzSRsrH8wM6vC4z2ylXhvygruJ/NdDZARES4j
# H9YKNYkV5RfLjIAbxRvxYY/LfmD4NH/qPIA8i8GYb11epWKRg1GqAEI7pzI7J9sJ
# z/USh0fKnW7TztdgxAZC87a2WYrC4aUVWncCOduyR5+c2lrXZlbbEW7aeob+7MdD
# l2YJaqn8ftImS0oHRbxXHfDknr/jPGszIzdkqS6/WJsmEJMHzwHGt5gx6LWTSuq5
# IhAuNKFS8L1TbkNVtr0zSmf1y/EIuqGCFyowghcmBgorBgEEAYI3AwMBMYIXFjCC
# FxIGCSqGSIb3DQEHAqCCFwMwghb/AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFXBgsq
# hkiG9w0BCRABBKCCAUYEggFCMIIBPgIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCDnItcr9JtV9wUI9edENxIVng8VqxuTDag61dJpSybyRgIGZD/UapP/
# GBEyMDIzMDUxMDE3MDA1Ni40WjAEgAIB9KCB2KSB1TCB0jELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh
# bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjoz
# QkQ0LTRCODAtNjlDMzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaCCEXswggcnMIIFD6ADAgECAhMzAAABtPuACEQF0i36AAEAAAG0MA0GCSqG
# SIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTIyMDky
# MDIwMjIwOVoXDTIzMTIxNDIwMjIwOVowgdIxCzAJBgNVBAYTAlVTMRMwEQYDVQQI
# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv
# ZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh
# dGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046M0JENC00Qjgw
# LTY5QzMxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi
# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0R6aeZQcyQh+86K7bsrzplvBa
# GSwbBXvYOXW4Z2qvakqb6Z/OhP5ieCSr1osR/5cO0APID7YohlTSI7xYbv14mPPP
# b1+VmkEpsqDzGXY/c712uV65DDdOc1803j5AiCMxekTe3E8XszshEspkyI63cV+Q
# VZWaJckADsTc4jAmCmGDT22HdO/OnwxPz4c60bdt2tF3/La7xWtCxBMtmJXBNnqo
# Ngo1Pw9BmXvEWtJI7dDNdr3UuKlmdg6XeyIYkMJ57UFrtfWLXd1AUfEqXkV/gnMN
# 244Fnzl7ZWunIXLVrdrIZTMGsjDn2OExuMjD1hVxC32RRae3IKY2TXlbJsJL6Fek
# QMMtWPVflb2yeahbWq7Tf66emtCNZBpW47sF9y9B01V3IpKoB4rLV5PYdxzmfVoB
# V5cWbqxtUmZnM9ARBHcmvtbxhxOOSoLmFPaqti4hxgY5/c+Pg6p1ebVCqG7C2yTG
# +K/vLLdn4/EmnErH7Z7rMZFqhCYiUt+D9rjZc1UdN/pbOvmTtDXDu/S4D+wWyDIq
# YjsfModfTzEMNKYmihcDlu0PoHSXH8uqzpBvgq2GcDs3YgR0nmyMwiHIdnAGvt/M
# OyRT/5KCnZSd+qs3VV1r+Bv6maVsnCLwymG8SVjONPs9krYObh6ityPHtPZBV7cQ
# h6Uu4ZvHPJtuVmhFOQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFMtEheXxlLg6nLsS
# KLdO3jjMMtl+MB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud
# HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js
# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr
# BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv
# bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw
# MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw
# DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAS0Q8FjCm3gmKhKrSO
# gbPCphfpKg0fthuqmACt2Wet23q7e6QpESW4oRWpLZdqNfHHRSRcZzheL12nZtLG
# m7JCdOSr4hDCSDunV0qvABra92Zo3PPeatJp5QS7jTIJOEfCq5CTB6gbh6pFFl7X
# 061VKYMM0LdlDoiDSrPv2+K9eDLl0VaTienEDkvFIZHjAFpdoi5WGgRrTq93/3/Z
# ixD31sKJHtLElG3VetDmQkYdSLQWGDPXnyq9eB+aruo2p+p9NKaxBGu1t7hm/9f6
# o+j+Xpp75KsuRyNF+vQ41XS8VW40rHoJv3QPkuA2lz3HxX+ogcSv4ldtZdbqYBFV
# Wo1AKZeVUeNMGOFxfBKZp1HU6i1w3+wqnYQ4z0k9ivzo71j8kBkL3O6D2qWMpOuh
# lN9gDssh1yY+vr27UVIP/qK8vodEdl3+TYQvsW1nDM1xFF0UX9WCmQ7Ech+q+Ndq
# ZvCgyhP6+0ZO2qCiu6GFKTRszUX+kGmL+c9m1U0sZM1orxa3qSxxsL0bp/T2DP/A
# EEk4Ga9Ms845P/e1oIZKgmgMAFacr4N7mmJ7gpfwHHEpBsm/HPu9GxUnlHqYbH4G
# 9q/kCOzG9lnDp5CaQjS89FyTEv1MJUJ9ZLS7IgqbKjpN2iydsE7+iyt7uvSNL0Af
# yykSpWWEVylA186D8K91LbE1UzCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA
# AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg
# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl
# IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow
# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA
# A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX
# 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q
# UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d
# q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN
# pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k
# rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d
# Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS
# Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8
# QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm
# gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF
# ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID
# AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU
# KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1
# GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0
# bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA
# QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL
# j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p
# Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w
# Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3
# Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz
# LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU
# tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN
# 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU
# 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5
# KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy
# qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6
# 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE
# AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp
# AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd
# FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb
# atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd
# VTNYs6FwZvKhggLXMIICQAIBATCCAQChgdikgdUwgdIxCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k
# IE9wZXJhdGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046M0JE
# NC00QjgwLTY5QzMxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp
# Y2WiIwoBATAHBgUrDgMCGgMVAGWc2JDzm5f2c3gpEm3+AeQnHgkIoIGDMIGApH4w
# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQACBQDo
# BgCAMCIYDzIwMjMwNTEwMTkzNzM2WhgPMjAyMzA1MTExOTM3MzZaMHcwPQYKKwYB
# BAGEWQoEATEvMC0wCgIFAOgGAIACAQAwCgIBAAICDzICAf8wBwIBAAICFTwwCgIF
# AOgHUgACAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQAC
# AwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQBWauEl67kXeOWLfqH0
# jezpdJ83qrk2tyXdINWGDG+26i5THl3gudhMejl2DwhObtic6bFEPlMegammWc9j
# D1Gsm0D++YZzlqG4EgW/VRyfkQlRs3YmdT3ThDBHZjjCLYs+smXvrTTBAmdwEGsY
# TSFagOW4Lt9Plslwc6wMtDEKizGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVT
# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l
# LVN0YW1wIFBDQSAyMDEwAhMzAAABtPuACEQF0i36AAEAAAG0MA0GCWCGSAFlAwQC
# AQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkE
# MSIEIGYbeZ7h6BIyX11wO2An6Lx5/65L8Gl4FJZ9pe7AeoltMIH6BgsqhkiG9w0B
# CRACLzGB6jCB5zCB5DCBvQQg08j3e+ajMHAGUXG9+v+sSWt4U9Hi7Hu9crHaeLcB
# 9wYwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQ
# MA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9u
# MSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAbT7
# gAhEBdIt+gABAAABtDAiBCB0gP1SgqqWPmVnvAYHH4QjvLLZYetG/wonsa0ZTXf4
# rDANBgkqhkiG9w0BAQsFAASCAgBruyCAqWWxMuA73sWvmhXdrNOB0qmm1CB0LDDp
# okUdHEBQT17SU+U6EVxAR0JoR89UoUwAJ/LVQOEDVKE/NHpRtEnJWYmsB0jAnZUk
# rP3b+mXPsxfIL1D5hKuhH6RpzXg0RRRLrLJWkzQGcWeAwMlL3uGDxKmtJzfRkXpx
# RFw1hLS9nYnCNqT/YZrDZZwfCSL7HuBRaIQXFZKZAyJ227d/etLdCkngq7v0uvXg
# rO939eQf00Kzk42y/lWxeIddvprGCN/crIU0U8UyJ6L84FZRoVnhp4uMjfk4u2ap
# y/umPqPqAzSgOcWUQsQvcw2eOfcnkEzJ9OvGK/h3SiKPDepQfqRCojIfuh5ueJev
# hAuRs3+orKrAKf2mgaFaH5k0SXY7HFiP2NBg4mMUXvValJ1w3b7FhRFHUxNXoaQ7
# hYX2bDKk/ZFKqB0oDchBPK6JW4YJzDGnLhGUmtEcT6EyutB36ij72TSK7EsPF2ic
# zFq9IJQXq8eK8wlqzqo2lintXPQ4MRgJQ117QXE11EipJC/2MW4nDEKX7S6uaKZ/
# CwM14vBaTwe35KTv+R3v4L+Hj4xtiwBcv6gUSbzhblCNBfntsiH3C7ZS45HoUcc2
# EvgFvQnlV/wLof9RAlIQHNtawQPbsZecTrOHzZvPsRsk7qgIhJzWLhw31WgE3z/T
# PlCB9Q==
# SIG # End signature block