ibm,set-dynamic-indicator RTAS Call
This RTAS call behaves as the RTAS
set-indicator call, except that the instance of the
indicator is identified by a location code instead of a index.
R1--1.
Platforms that
implement any indicators that are identified by location code instead of
index (see Requirement
) must implement the
ibm,set-dynamic-indicator RTAS function.
R1--2.
The RTAS function
ibm,set-dynamic-indicator must implement the argument
call buffer defined by
.
Argument Call Buffer
ibm,set-dynamic-indicator
Parameter Type
Name
Values
In
Token
Token for
ibm,set-dynamic-indicator
Number Inputs
3
Number Outputs
1
Indicator
Token defining the indicator
9006: Error Log
9007: Identify Indicator
State
Desired new state; see
.
Location Code Address
Real or Logical address of a location code string, in the
format defined by Requirement
Out
Status
-1: Hardware error
-2: Busy, try again later
-3: No such indicator
0: Success
990x: Extended delay, where x is a number between 0 and
5, as described below
When 990x
Status is returned, it is suggested that software
delay for 10 raised to the power
x milliseconds (where
x is the last digit of the 990x return code), before
calling
ibm,set-dynamic-indicator with the same indicator
type and location code. However, software may call
ibm,set-dynamic-indicator again either earlier or
later than this.
R1--3.
The OS must not call
ibm,set-dynamic-indicator with a different indicator
until a non-busy return
Status has been received from the previous
ibm,set-dynamic-indicator call.
R1--4.
The location code string referenced by the
Location Code Address argument in the
ibm,set-dynamic-indicator argument call buffer must
reside in contiguous in real memory below an address of 4GB.
R1--5.
The input data
format in the work area must be as follows:
32-bit integer length of the location code string, including
NULL
Location code string, NULL terminated, identifying the sensor to
be set.
R1--6.
The platform must not modify the location
code string.
R1--7.
The OS must only use this call for
indicators which have been provided by the
ibm,get-indices RTAS call with an index value of
0xFFFFFFFF.
R1--8.
Platforms must identify all indicators
except types 9006 and 9007 by index.
R1--9.
The ibm,set-dynamic-indicator RTAS call must return A
Status of -3 for the following conditions:
Indicator type not supported
The specified location code does not identify a valid
indicator