Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: Set-NcQosPolicyReadAhead


NAME
Set-NcQosPolicyReadAhead

SYNOPSIS
Modify a read-ahead policy.

SYNTAX
Set-NcQosPolicyReadAhead [-Name] <String> [-AlignBlocks <Int32>] [-Default [
<Boolean>]] [-DiskResponseFactor <Int32>] [-DiskResponseWeight <Int32>] [-Ea
rlyCount <Int32>] [-ForceDump [<Boolean>]] [-ForceFull [<Boolean>]] [-ForceN
one [<Boolean>]] [-InterarrivalWeight <Int32>] [-Jitter <Int32>] [-MaxBlocks
<Int32>] [-MaxDeadline <Int32>] [-MaxDiskResponseTime <Int32>] [-MaxGap <In
t32>] [-MaxRange <Int32>] [-MetadataBlocks <Int32>] [-MinBlocks <Int32>] [-M
inDiskResponseTime <Int32>] [-MinRange <Int32>] [-Overshoot <Int32>] [-Small
fileBlocks <Int32>] [-UseAsync [<Boolean>]] [-UseFeedback [<Boolean>]] [-Use
Timing [<Boolean>]] [-MinRetireTime <Int32>] [-MaxRetireTime <Int32>] [-UseH
istogram [<Boolean>]] [-Controller <NcController[]>] [<CommonParameters>]


DESCRIPTION
Modify a read-ahead policy.


PARAMETERS
-Name <String>
Name of QoS read ahead policy.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-AlignBlocks <Int32>
Block Alignment

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Default [<Boolean>]
Default

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-DiskResponseFactor <Int32>
Disk Response Time Factor

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-DiskResponseWeight <Int32>
Weight for Disk Response Time Aging (%)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-EarlyCount <Int32>
Number of IO Operations Cautiously Predicted

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ForceDump [<Boolean>]
Force DUMP-Style Readahead

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ForceFull [<Boolean>]
Force Full-File Readahead

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ForceNone [<Boolean>]
Disable Readahead

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-InterarrivalWeight <Int32>
Weight for Interarrival Time Aging (%)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Jitter <Int32>
Threshold for Detecting Jitter (%)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MaxBlocks <Int32>
Maximum Blocks to Speculate

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MaxDeadline <Int32>
Maximum Deadline Offset (us)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MaxDiskResponseTime <Int32>
Maximum Disk Response Time (us)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MaxGap <Int32>
Maximum Speculative Blocks Outstanding

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MaxRange <Int32>
Maximum Range Used When Aging Streams (Blocks)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MetadataBlocks <Int32>
Minimum Blocks for Which Metadata is Predicted

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MinBlocks <Int32>
Minimum Blocks to Speculate

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MinDiskResponseTime <Int32>
Minimum Disk Response Time (us)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MinRange <Int32>
Minimum Range Used When Aging Streams (Blocks)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Overshoot <Int32>
Allowable Overshoot (%)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-SmallfileBlocks <Int32>
Maximum Blocks for Small-File Handling

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-UseAsync [<Boolean>]
Use Asynchronous Speculation

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-UseFeedback [<Boolean>]
Provide Cache-Miss Feedback

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-UseTiming [<Boolean>]
Use Timing Algorithms

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MinRetireTime <Int32>
Minimum Time Before a Stream is Retired (us)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-MaxRetireTime <Int32>
Maximum Time Before a Stream is Retired (us)

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-UseHistogram [<Boolean>]
If true, use Histogram-based predictions.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
DataONTAP.C.Types.Qos.QosPolicyReadAheadInfo


NOTES


Category: qos
API: qos-policy-read-ahead-modify,qos-settings-read-ahead-modify
Family: cluster

-------------- Example 1 --------------

C:\PS>Set-NcQosPolicyReadAhead test -ForceNone:$true -Overshoot 30


Set some properties on the given quality of service read ahead policy.


ReadAheadPolicyName : test
ReadAheadClass : user_defined
AlignBlocks : 64
Default : False
DiskResponseFactor : 3
DiskResponseWeight : 80
EarlyCount : 10
ForceDump : False
ForceFull : False
ForceNone : True
InterarrivalWeight : 80
Jitter : 80
MaxBlocks : 192
MaxDeadline : 1000000
MaxDiskResponseTime : 50000
MaxGap : 1024
MetadataBlocks : 64
MinBlocks : 128
MinDiskResponseTime : 1000
MinRange : 3840
Overshoot : 30
SmallfileBlocks : 16
UseAsync : True
UseFeedback : True
UseTiming : True



RELATED LINKS
Get-NcQosPolicyReadAhead
New-NcQosPolicyReadAhead
Remove-NcQosPolicyReadAhead
Update-NcQosPolicyReadAhead







 Data ONTAP® PowerShell Toolkit