Ensuring that the edit routine returns the right results

You must return the edited results in the ECSRSLT field, with trailing blanks for unused bytes, and ensure that the user's display device has the capability to read them.

This means that the resulting DBCS and EBCDIC characters must have the appropriate representations, and that the beginning and end of any string of DBCS characters are marked by SO and SI characters.

Overflowing the ECSRSLT field

Be careful not to overflow the ECSRSLT field, whose length is contained in the ECSRSLEN field. If your results do not fit, truncate them on the right. If the last character represented in the truncated results is a DBCS character, be certain to retain its right-most byte, and to follow that character with an SI character.

Printing the report column

QMF copies the ECSRSLT field into the corresponding report column. The result is exactly as wide as the report column. If you do not specify ALIGNMENT for data, the data is aligned exactly as you typed it.

How the report device represents what you return depends on the specific device. For many display devices, the following rules apply:
  • If the report is displayed on the screen, the SI and SO characters embedded in a user's results also appear on the display.
  • The SI and SO characters appear either as blanks or as special symbols. There is one special symbol for SI and another for SO.
  • Blanks appear instead of the symbols unless the user presses a certain combination of keys.

Any legitimate DBCS character can be returned in the ECSRSLT field.