This command specifies updates to the WIN-OS/2 configuration file. It has no counterpart in DDINSTAL. Like the :OS2INI keyword, the :WININI key is followed by the name or complete path name of a WIN-OS/2 configuration file. If a simple file name is provided, it is assumed that the file resides in the \OS2\MDOS\WINOS2 directory on the system's startup drive.

The file name line is followed by a series of lines that will be placed in the specified WIN-OS/2 configuration file. Each WIN-OS/2 configuration line consists of three fields: <section>, <keyword>, and <value>. The section field identifies a section within the WIN-OS/2 configuration file.

In a similar manner to the :CONFIG command, an attempt is made to replace corresponding lines in the file rather than simply appending the lines to the specified section of the file. WIN-OS/2 configuration lines are typically of the form:

    <keyword string> = <value string>

where the <value string> can actually be several substrings that are divided by spaces. Any field (section, keyword, value) can contain spaces if the field is enclosed in double quotation marks. The :WININI command operates by replacing lines in the specified section that match <command string> fields, or (if no match is found) by appending the new line at the end of the specified section.

The following example illustrates the DSP file command lines that can follow the :WININI command line:

    :WININI :MODE=PRIMARY :MODE=WINDOWS
    SYSTEM.INI
    BOOT DISPLAY.DRV VGA.DRV
    BOOT SDISPLAY.DRV SWINVGA.DR