Understanding and Replacing Deprecated Jam5 Syntax
with Jam7 Syntax

Widget Length and Contents Functions

• sm_length

  sm_length(field_number)
sm_n_length(field_name)


  Status

  Jam5 & Jam6 Function
  Deprecated & Undocumented in Jam7/Prolifics
  Functional Through Jam7/Panther (Prolifics 4)
  

  Description

  The sm_length function was used to determine the maximum length of a field. This can be replaced by directly accessing the max_data_length property.

  JPL Examples

  cut_off = sm_n_length("address1_lne")
cut_off = @widget("address1_lne")->max_data_length

  See Also

  The displayed length can, of course, be less than the maximum data length. To access or change the displayed length, use the length property. To determine the length of the current data in a field use the sm_dlength() function.

  ---

• sm_t_shift

  sm_t_shift(field_number)


  Status

  Jam5 & Jam6 Function
  Deprecated & Undocumented in Jam7/Prolifics
  Functional Through Jam7/Panther (Prolifics 4)
  

  Description

  The sm_t_shift function returned 1 if the field could shift horizinontally, 0 otherwise. Any widget that has it's displayed length less than it's maximum data length, is horizontally shiftable. This function call can be replaced by comparing the length and the max_data_length properties. If they are equal than the field is not shiftable, if there are not, then the field is shiftable.

  JPL Examples

  not_all_displayed = sm_t_shift(:cur_fld)
  

       vars len = @field_num(:cur_fld)->length, \
            max_len = @field_num(:cur_fld)->max_data_length
       if (len < max_len)
           not_all_displayed = 1
       else
           not_all_displayed = 0

  ---

• sm_oshift

  sm_oshift(field_number, shift_offset)
sm_n_oshift(field_name, shift_offset)

  Status

  Jam5 & Jam6 Function
  Deprecated & Undocumented in Jam7/Prolifics
  Functional Through Jam7/Panther (Prolifics 4)
  

  Description

  The sm_oshift function horizontally shifted the data in a shiftable widget. Any widget that has it's displayed length less than it's maximum data length, is horizontally shiftable. The shift offset could be positive or negative, which would shift the field left or right, respectively. If the maximum width of the field would be exceeded by the shift, then only a portion of the shift in the respective direction would occur. The return value for the function is the number of positions actually shifted.

  This function call can be replaced by directly modifying the current_offset property. However, when using the property, the user does need to check to see if the shift would cause the maximum widgth of the field to be exceeded. If the shift is too large, then a jpl error will occur, which would not have occurred when using the sm_oshift function.

  JPL Examples

  call sm_n_oshift("test", shift_over)
  

       vars old_offset = @widget("test")->current_offset,  \
            max_len = @widget("test")->max_data_length,    \
            len = @widget("test")->length
  
       if (shift_over < 0)
           if (old_offset + shift_over > 0)
               @widget("test")->current_offset = old_offset + shift_over
           else
               @widget("test")->current_offset = 1
      else
          if ((old_offset + shift_over + len) < max_len)
              @widget("test")->current_offset = old_offset + shift_over
          else
             @widget("test")->current_offset = max_len - len
  
      /* Check if offset is 0 or 1 at beginning!!! */
  

  ---