status = s.peek(kpx, segment, offset [, vector, words])
S.PEEK is a routine for snapping the address space of other programs in the system. It is built on top of .SNOOP and the JIO routines. Unlike .SNOOP, if the process being examined is currently swapped out, S.PEEK will read the information from the swap file rather than returning an unsuccessful status.
Because S.PEEK uses the JIO routines, it may not be used in batch. Also you must call J.FREE before calling another subsystem.
When examining another process, only type 0 or 1 segments which use workspace register 7 may be examined. Because of the extra overhead involved, S.PEEK is not recommended for examining system segments or segments within the current process (i.e. kpx=0 or -1). Since being swapped is not the only normal reason for the system to deny a .SNOOP request of another process, the status return from S.PEEK should always be checked.
S.PEEK depends on DRL T.PEEK being installed in the system. This means it will not run at most sites.
Copyright © 1996, Thinkage Ltd.