DmiMgmtCommand

All commands issued through the MI start with a DmiMgmtCommand block. Each outstanding command requires a separate DmiMgmtCommand block. Typically, a command consists of the DmiMgmtCommand block, with additional parameters appended to specify such things as the target of a request or the key data for a table, for example.

The format for the command block is: ┌──────────────────────────────────────────────────────────────────────────────┐
│ Table 13. DmiMgmtCommand Command Block │
├───────────────┬───────────────┬───────────────┬──────────────────────────────┤
│ OFFSET │ SIZE │ TYPE │ VARIABLE NAME │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 0 │ 4 │ INT │ iLevelCheck │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 4 │ 4 │ INT │ iCommand │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 8 │ 4 │ INT │ iCmdLen │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 12 │ 4 │ INT │ iMgmtHandle │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 16 │ 4 │ INT │ iCmdHandle │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 20 │ 4 │ OFFSET │ osLanguage │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 24 │ 4 │ OFFSET │ oSecurity │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 28 │ 4 │ INT │ iCnfBufLen │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 32 │ 4 │ PTR │ pCnfBuf │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 36 │ 4 │ INT │ iRequestCount │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 40 │ 4 │ INT │ iCnfCount │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 44 │ 4 │ INT │ iStatus │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 48 │ 16 │ STRUCT │ DmiCiCommand │
└───────────────┴───────────────┴───────────────┴──────────────────────────────┘

Variable Name

Variable Description
iLevelCheck
A 4-octet integer with a code value of 0x444d3131 and an ISO 8859-1 value of DMI1. This value indicates the revision level of the DMI specification used by the code issuing the command and also functions as a check, so that the receiver can be confident the pointer is pointing to a valid command block.
iCommand
A code specifying which command to execute. The standard command codes are listed in the description of each command.
iCmdLen
Length in octets of the entire command, including the DmiMgmtCommand block, all appended blocks, and any values stored at the end of the buffer for Set Attribute commands.
iMgmtHandle
A value that uniquely identifies the management application. This value is assigned to the management application by the service layer in response to the DmiRegisterMgmtCmd command. This value is ignored when sending the DmiRegisterMgmtCmd command itself.
iCmdHandle
Optional integer set by the management application to a value unique to all other outstanding commands from that management application. The handle can later be used to cancel the command.
osLanguage
Offset to a string indicating the desired human language for the response. The format of the string is specified in Language Statement. If the management application sets this field to zero, the language specified by the first MIF installed for this component is used.
oSecurity
Offset to an optional security credentials block, as defined in DmiSecurity Command Block, If no block is specified, this value is zero. The service layer and component instrumentation can use the information in this block to implement local security policies.
iCnfBufLen
Length of the confirm buffer, in octets of contiguous memory. The management application sets this to inform the service layer of the maximum size of the response.

Note: The length of the confirm buffer for DmiListComponentCmd commands should be at least 2K to ensure adequate space for the class strings.

pCnfBuf
Pointer to the buffer where the management application wants the confirm response to go. The management application must supply this buffer; it is not provided by the service layer or component instrumentation. The buffer must be a minimum of 512 octets.
iRequestCount
The number of requests in this command. This count does not include the DmiMgmtCommand block itself.
iCnfCount
Number of valid confirm blocks in pCnfBuf. This value is set on the return of the response.
iStatus
Return status of this command. In the case of an error, where iCnfCount contains the number of valid confirms, iStatus refers to the request represented by (iCnfCount + 1). This value is set on the return of the response.
DmiCiCommand
Command block with information for component instrumentation. Read DmiCiCommand Command Block for a description of the DmiCiCommand command block.

The format of the DmiSecurity block is: ┌──────────────────────────────────────────────────────────────────────────────┐│Table14 .DmiSecurityCommandBlock │
├───────────────┬───────────────┬───────────────┬──────────────────────────────┤
│ OFFSET │ SIZE │ TYPE │ VARIABLE NAME │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 0 │ 4 │ INT │ iSecurityLen │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 4 │ 4 │ INT │ iSecurityType │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 8 │ x │ STRUCT │ SecurityData │
└───────────────┴───────────────┴───────────────┴──────────────────────────────┘


Variable Name

Variable Description
iSecurityLen
Length of the security block, in octets of contiguous memory.
iSecurityType
Type of security block being passed in SecurityData. Standard security blocks are not provided in version 1.0 of the DMI. The service layer can accept non-standard security blocks, if provided. These blocks are defined by the service layer implementation and exist in the range above 0x80000000 (the high bit of the type is set).
SecurityData
A block that contains the details of the security credentials. The size and structure of the security data depend on the value of iSecurityType.

---

[Back: Common Command Blocks]
[Next: DmiCiCommand]