Label Builder Behavior

The Label builder dialog box prompts the end user for information and generates a valid CMW label from the input. The input can be entered from the keyboard or by choosing options. Either way, Label builder ensures that a valid label or clearance as defined in the label_encodings(4) file for the system is built.

Label builder provides default behavior for the OK, Reset, Cancel, and Update pushbuttons. The callback passed to tsol_lbuild_create(3TSOL) is mapped to the OK pushbutton to provide application-specific behavior.

Keyboard Entry

The Update pushbutton takes the text the end user types into the Update With field and checks that the string is a valid label or clearance as defined in the label_encodings(4) file.

• If the input is not valid, Label builder raises an error to the end user.

• If the input is valid, Label builder updates the text in the Label field above and stores the value in the appropriate working label field of the ModLabelData variable returned by tsol_lbuild_create(3TSOL). See "ModLabelData Structure".

When the end user selects the OK pushbutton, the user-built value is handled according to the OK pushbutton callback implementation.

Selecting Options

The Label Settings radio button options let you build a sensitivity label or clearance from classifications and compartments, or an information label from classifications, compartments, and markings. Depending on the mode, one of these buttons might be grayed out. This approach is independent of the keyboard entry and Update pushbutton method described above.

The classifications, compartments, and markings information are from the label_encodings(4) file for the system. The combinations and constraints specified in the label_encodings file are enforced by graying out invalid combinations. The Label field updates the Label field above and stores the value in the appropriate working label field of the ModLabelData variable returned by tsol_lbuild_create(3TSOL) (see "ModLabelData Structure") when the end user chooses options. The end user can build a sensitivity label, clearance, or sensitivity label portion of a CMW label from the classifications (CLASS) and compartments (COMPS) radio buttons listed.

When the end user selects the OK pushbutton, the user-built value is handled according to the OK pushbutton callback implementation.

Reset Pushbutton

The Rest pushbutton sets the text in the Label field to what its value was when the application started.

Cancel Pushbutton

The Cancel pushbutton exits the application.