Caché ObjectScript Reference - InterSystems Documentation

$ZPOS$ZPOSContains the current file position during the reading of a sequential file.$ZPOSDescription$ZPOS contains the current file position during sequential file reads. If no sequential fileread is in progress, $ZPOS contains 0 (zero). The current file position can be set using the$ZSEEK function.By default, Caché handles an end-of-file on a sequential file by issuing an error; it does not set $ZPOS. You can configure this end-of-file behavior in a manner compatiblewith MSM. In this case, when an end-of-file is encountered, Caché does not issue anerror, but sets $ZPOS to "" (the null string), and sets $ZEOF to -1.To configure end-of-file handling, go to the System Management Portal, select SystemConfiguration, select Advanced Settings, on the pull-down Category list select ObjectScript.View and edit the current setting of SetZEOF. When set to “true” , Caché sets $ZPOS to ""(the null string), and sets $ZEOF to -1. The default is “false” , You can also establish thisbehavior system-wide by invoking $ZUTIL(69,40,1) or on the current process by invoking$ZUTIL(68,40,1).$ZPOS is not supported on VMS systems.This special variable cannot be modified using the SET command. Attempting to do so resultsin a error.See Also• READ command• $ZSEEK function• $ZUTIL(68,40) End-of-File Handling for Sequential Files function• $ZUTIL(69,40) End-of-File Handling for Sequential Files function• $ZEOF special variable• Sequential File I/O in Caché I/O Device GuideCaché ObjectScript Reference 483