January 2012 8.12 Tables 1619
Module 9255 Read a field from a table
The module reads a data field from a table opened by Module 9240 in "record-
oriented" mode as an integer value. The data field is addressed by the field 
name and the line number.
To maintain a high processing speed, multiple lines should be read in 
ascending order.
Pay attention to the upper/lower case of field names.
If an error occurs, the number value of the result is undefined.
The function can only be used on fields containing numerical values.
If digits can be entered after the decimal point in the selected field, the 
numerical value is standardized to the last digit after the decimal point, 
meaning that for n digits after the decimal point, the value is multiplied by 
10^n.
Call:
PS D <File handle>
from Module 9240
PS B/W/D/K <Line>
0 to 65 535
PS B/W/D/K/S<String number, column name>
0 to 15
CM 9255
PL B/W/D <Result>
Error recognition: 
Marker Value Meaning
NN_GenApiModule
Error (M4203)
0 Field was read
1 Error code in NN_GenApiModuleErrorCode 
(W1022)
NN_GenApiModule
ErrorCode (W1022)
1 Line does not exist in table
2 Incorrect "file handle" or table was opened 
in "buffered" mode
3 Impermissible string numbers
7 The table could not be read from
20 Module was not called in a spawn job or 
submit job
29 The opened file is not a table (extension 
.TAB, .P)
30 Column name not found