<emphasis>ibm,set-dynamic-indicator</emphasis> 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 . <emphasis>ibm,set-dynamic-indicator</emphasis> Argument Call Buffer 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