Functions and CALL Routines under z/OS

PEEKLONG Function: z/OS

Stores the contents of a memory address in a numeric variable.

Category:	Special
See:	PEEKLONG Function in SAS Language Reference: Dictionary

Syntax
Details
Comparisons
Example
See Also

Syntax

PEEKLONG(address<,length>)

address

specifies a character expression that is the memory address in binary.

length

specifies the length of the numeric data.

Default:	4
Range:	1-4

Details

If you do not have access to the memory storage location that you are requesting, the PEEKLONG function returns an "Invalid argument" error.

Comparisons

The PEEKLONG function stores the contents of a memory address in a numeric variable. It assumes that the input address refers to an integer in memory.

The PEEKCLONG function stores the contents of a memory address in a character variable. It assumes that the input address refers to character data.

Example

The following example copies the contents of the numeric variable Y to the numeric variable Z:

data _null_;    
   length y $4; 
   y=put(1,IB4.);    
   addry=addrlong(y);
   z=peeklong(addry,4);
   put z=; 
run;

The output from the SAS log is: z=1