Функция Pos как уже было сказано возвращает именно целочисленное значение. Если не найдено то 0.
showmessage(pos); конечно будет ошибка, так как ShowMessage требует в качестве параметра строку, нужно число преобразовать в строку, воспользовавшись например функцией IntToStr();
Пример:
Код:
ShowMessage(IntToStr(pos('ек', 'Текст')));
Должен сказать 2.