Intermec 5055 Reference Guide

Page of 216
Converting Trakker Antares, 6400, and JANUS Applications to 5055 Applications
4-5
4
Compatible Functions (continued)
im_free_space
im_set_display_mode
im_get_config_info
im_set_input_mode
im_get_cursor_xy
im_set_time_event
im_get_display_mode
im_sound
im_get_display_size_physical
im_standby_wait
im_get_display_size_virtual
im_status_line
im_get_display_type
im_transmit_buffer
im_get_input_mode
im_xm_receive_file
im_get_label_symbology
im_xm_transmit_file
im_get_label_symbologyid
im_xm1k_receive_file
im_get_length
im_xm1k_transmit_file
im_get_tx_status
im_input_status
Note: Incompatible functions and suggested alternatives are listed later in this chapter.
For more information, see “Converting Trakker Antares and 6400 Applications to
5055 Applications” and “Converting JANUS Applications to 5055 Applications” later
in this chapter.
Using Status Code Macros
Each PSK library function returns a specific status value. The PSK provides status code
macros that determine the success of the function without testing for an explicit value.
For most functions, you only need to know if the result was success or failure. Your
program is easier to maintain, update, and port to another terminal type when you check
for success or failure instead of a specific value.
This example tests for success or failure and then provides an action for each condition.
/* This segment requests label input, then checks for success */
/* If successful, then retrieve the label symbology           */
/* If an error occurred, display the error message            */
/* Request input */
status = im_receive_input(IM_LABEL_SELECT, IM_INFINITE_TIMEOUT,
&source, input);
if ( IM_ISSUCCESS(status))
im_get_label_symbology( &symbol);
if ( IM_ISERROR(status))
im_message(status);