1. ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
  2. Wireless Markup Language (WML)
  3. Troubleshooting Scenarios
  • ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
Troubleshooting Scenarios

Troubleshooting Scenarios

Problem Scenario
Corrective Actions
I loaded a WML menu structure on the printer, but the Factory menu structure is displaying.
  • The WML files may have syntax errors. Reconfirm that the correct syntax has been used. When creating WML files it is recommended to start with a simple structure, validate that it's functional and build additional content onto the "known good" example.
  • Power cycle the printer and watch the start-up sequence - if a "WML ERROR" message displays during the start-up, the
    index.wml
     file has a syntax error that needs to be corrected.
  • The
    index.wml
     file may not have been successfully transferred to the printer. Use a terminal emulation program and the following command to retrieve the
    index.wml
     file to the PC for examination:
! U1 setvar "file.type" "E:INDEX.WML"
  • The
    index.wml
     file may not be present in the E: memory location. Validate that the file is present and correctly named.
  • Confirm that straight quotes were used in all instances where the quote character was used (use the " character - not " or ?). SGD commands require the use of the straight quote.
  • Confirm that the "WML Menu Cancel" buttons, (Setup and Cancel or Cancel and Setup/Exit or Select) were not held down during start up. These actions will cause the standard menu to display.
Some characters in the menu are cut off or some lines are not displaying at all.
  • Characters that extend past the width of the display are truncated, reposition the field as needed.
  • Check that you have not exceeded that maximum number of lines the display allows (5 lines on ZM and Xi4 series units, 4 lines on the GX series).
My WML menu structure is displaying, but one of the “cards” is not displaying or is unreachable.
  • The missing "card" may not have been linked to from any of the visible "cards". Review you WML content to ensure that the correct links exist.
  • The WML files may have syntax errors, reconfirm that the correct syntax has been used. When creating WML files it is recommended to start with a simple structure, validate that it’s functional and build additional content onto a known good example.
  • If the missing card content is contained in a separate
    .wml file
    , confirm that the necessary
    .wml
     files have been transferred to the printer.
My WML menu structure uses SGD commands to display current settings, but the settings are not displaying.
  • Validate that the correct syntax was used for the SGD command.
  • Check the manual page for the command being used. Confirm that the command is supported by the printer & firmware. Use a terminal emulation program to send just the command being used to validate it functions outside the WML menu structure.
  • Confirm that straight quotes were used in all instances where the quote character was used (use the " character – not “ or ̋ ). SGD commands require the use of the straight quote.
  • Characters that extend past the width of the display are truncated, reposition the field as needed.
  • Check that you have not exceeded that maximum number of lines the display allows (5 on ZM and Xi4 series units).
My WML menu structure used SGD commands to allow the user to alter printer settings, but the settings are not getting changed as expected.
  • Validate that the value being used in the value= parameter of the <do> tag is supported by the SGD command.
  • Validate that the correct syntax was used for the SGD command.
  • Check the manual page for the command being used. Confirm that the command is supported by the printer & firmware. Use a terminal emulation program to send just the command being used to validate it functions outside the WML menu structure.
  • Confirm that straight quotes were used in all instances where the quote character was used (use the " character – not “ or ̋ ). SGD commands require the use of the straight quote.
My WML menu structure uses .nrd files to send commands to the printers ZPL or SGD engine, but the commands don’t seem to be getting sent when the user selects the on-screen link for the action.
  • Confirm that the .nrd files are present in E: memory and named as expected. Resend or rename the files if necessary.
  • Confirm that the WML menu structure is using the correct file name(s).
  • Confirm that the commands in the files work as expected, independently of the WML menu or
    .nrd
     file.
  • Validate that ZPL and SGD commands have not been interlaced.
I am using the
CISDFCRC16
 command to transfer files, but the files are either not being transferred to the printer or are showing up with a zero (0) byte size.
  • Confirm that the Hexadecimal value used for the File Size parameter is correct. This value must be an eight digit file size specified in hexadecimal which indicates the number of bytes in the <data> section of the command. See the full manual page on the CISDFCRC16 command for additional details.
  • Validate that the CRC and Checksum parameters are correct (using the "0000" value for these parameters is recommended).
  • Confirm that the WML file name and extension are in upper case characters.
  • Confirm that the exclamation mark (!) was included before the command name (
    "! CISDFCRC16"
    ).