DmiCiInstallData

To install a new MIF file, the component instrumentation fills out a DmiCiInstallData block and sends it to the service layer with the DmiInvoke() function call.

The format for the command block is: ┌──────────────────────────────────────────────────────────────────────────────┐
│ Table 41. DmiCiInstallData Command Block │
├───────────────┬───────────────┬───────────────┬──────────────────────────────┤
│ OFFSET │ SIZE │ TYPE │ VARIABLE NAME │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 0 │ 64 │ STRUCT │ DmiMgmtCommand │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 64 │ 4 │ INT │ iComponentId │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 68 │ 4 │ INT │ iFileCount │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 72 │ 8 │ STRUCT │ DmiFileData[ ] │
└───────────────┴───────────────┴───────────────┴──────────────────────────────┘

Variable Name

Variable Description
DmiMgmtCommand
The command block. The value of iCommand is 0x402. iMgmtHandle should always be set to zero.
iComponentId
The service-layer defined ID of this component. On initial install, this is set to zero. On subsequent installs, this field is set to the component's ID. In this case, the field is used to provide additional MIF data for this component, such as MIF files for additional languages.
iFileCount
Number of DmiFileData structures that follow.
DmiFileData[ ]
A list of structures, as defined in DmiFileData Command Block.

The format of the DmiFileData block is: ┌──────────────────────────────────────────────────────────────────────────────┐│Table42 .DmiFileDataCommandBlock │
├───────────────┬───────────────┬───────────────┬──────────────────────────────┤
│ OFFSET │ SIZE │ TYPE │ VARIABLE NAME │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 0 │ 4 │ INT │ iFileType │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 4 │ 4 │ OFFSET │ osFileData │
└───────────────┴───────────────┴───────────────┴──────────────────────────────┘


Variable Name

Variable Description
iFileType
Type for this component's MIF files. The type code is a 32-bit values. If the value is even, the contents of osFileData indicates a file name. If the value is odd, the contents of osFileData indicates the MIF data in memory.

The following type codes are defined:

Type code

Meaning
0
Reserved, do not use
1
Reserved, do not use
2
MIF file name
3
MIF file pointer
4
SNMP mapping file name
5
SNMP mapping file pointer
0x80000000
Start of implementation-specific types
Note that like command codes, file type codes above x80000000 are reserved for implementation-specific use.
osFileData
Offset to a string whose contents depend on the type code.

Issuing DmiCiInstallData displays an example of how to issue the DmiCiInstallData command to the CI. IssuingDmiCiInstallData


DmiLibInstallData_t *InstallMIF(char *MIF_FileName)   // Receive thread -- handles all confirm processing
{
DMI_CiInstallData_t *inst;
ULONG               reqSize,FileOffset,FileSize;
DMI_STRING          *FileName;
ULONG               RC = SLERR_OUT_OF_MEMORY;

    FileName = (DMI_STRING *)malloc((ULONG) (strlen(MIF_FileName) + sizeof(ULONG)));
    if(FileName != (DMI_STRING *)NULL){  // we got the memory we asked for
        memcpy(FileName->body,MIF_FileName,(FileName->length = strlen(MIF_FileName)));  // set up the file
                                                                                        // name string
        FileOffset = reqSize = (ULONG)sizeof(DMI_CiInstallData_t);   // install structure includes ONE
                                                                     // file structure
        reqSize += (ULONG) (FileName->length + sizeof(FileName->length));   // add length of DMI string
        inst = (DMI_CiInstallData_t *)malloc(reqSize);
        if(inst != (DMI_CiInstallData_t *)NULL){   // we've got the memory
            memset(inst,0,reqSize);   /* clear out the whole thing */
            inst->DmiMgmtCommand.iLevelCheck = DMI_LEVEL_CHECK;
            inst->DmiMgmtCommand.iCmdLen = reqSize;
            inst->DmiMgmtCommand.iCmdHandle = 1;
            inst->DmiMgmtCommand.iRequestCount = 1;
            inst->DmiMgmtCommand.iCommand = DmiCiInstallCmd;
            inst->iFileCount = 1;
            inst->DmiFileListφ0∙.iFileType = MIF_MIF_FILE_NAME_FILE_TYPE;
            inst->DmiFileListφ0∙.oFileData = FileOffset;
            FileSize = (size_t) (sizeof(FileName->length) + FileName->length);
            memcpy(((char *)inst + FileOffset),FileName, FileSize);
            RC = DmiInvoke((DMI_MgmtCommand_t *)inst);
            if(RC != SLERR_NO_ERROR) free(inst);
        }
        free(FileName);
    }
    return RC;
}

---

[Back: Component Interface (CI) Command Blocks]
[Next: DmiCiUninstallData]