z/OS Using REXX and z/OS UNIX System Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


v_readdir

z/OS Using REXX and z/OS UNIX System Services
SA23-2283-00

Read syntax diagramSkip visual syntax diagram
>>-v_readdir--vntoken--stem--start--+--------------+-----------><
                                    '-access_check-'   

Function

v_readdir invokes the v_readdir callable service to accept a vnode token representing a directory and return directory entries from this directory.

Parameters

vntoken
A variable name that contains the vnode token for the directory to be read.
stem
The name of a stem variable used to return the directory entries. Upon return, stem.0 contains the number of directory entries returned. stem.1 through stem.n (where n is the number of entries returned) each contain a directory entry.
Note: Only small directories can be read in a single call. To ensure that you read to the end of the directory, make calls to v_readdir until no entries are returned.
start
The number of the first directory entry to be returned. The numbers 0 and 1 both indicate that the read should start at the beginning of the directory.
access_check
Specify a 0 for no access_check, or 1 to specify that the system is to check the user for read access to the file. The user is defined by the effective UID and GID. Setting the effective GID does not affect supplemental groups. Also, there is no support for altering the MVS™ user identity of the task using the ACEE.

Example

In the following example, assume that dirtok was assigned a value earlier in the exec:
"v_readdir dirtok dir. 0"

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014