Function

lstat invokes the lstat callable service to obtain status information about a file.

Parameters

pathname

A pathname for the file.

stem

The name of a stem variable used to return the information. Upon return, stem.0 contains the number of variables returned. To obtain the desired status information, you can use a numeric value (see REXX predefined variables) or the predefined variables beginning with ST_ used to derive the numeric value. See fstat for a list of those variables.

Usage notes

1. If the pathname specified is a symbolic link, the status information returned relates to the symbolic link, rather than to the file to which the symbolic link refers.
2. All time values returned are in POSIX format. Time is in seconds since 00:00:00 GMT, January 1, 1970. You can use gmtime to convert it to other forms.