UNIX-DIRECTORY

File 97
Statement FIND
Task This view makes it possible to display directory information related to a z/OS UNIX file system.

Fields

Dictionary Field Name F/L Mu DE Remarks
NODE N5.0   D D Node ID (DBID).
ERROR-CODE N3.0      
ERROR-TEXT A58      
NODE-NAME A16   D  
SYSTEM-MESSAGE-CODE A10      
PATH A54   D Fully qualified path name.
FILE A54   D File name.
TYPE A1   D File type D = directory 3 standard file, see also below.
ACCESS-USER A3   D Access rights of the user.
ACCESS-GROUP A3   D Access rights of the group.
ACCESS-OTHER A3   D Access rights for someone neither being the user nor a member of the group.
OWNER A8   D File owner.
OWNER-GROUP A8   D Group of the file owner.
FILE-SIZE N8.0   D Size in bytes.

Relevant Error Codes

Code Text
530 Access denied by Security Facility.
568 File not found.
893 Getmain failed.
899 I/O error on file.
993 Cannot open file.

Field Descriptions

Field Name Type/Length
NODE (N5.0)

D Node ID (DBID).

Field Name Type/Length
ERROR-CODE (N3.0)

Message code.

Field Name Type/Length
ERROR-TEXT (A58)

Text describing error.

Field Name Type/Length
NODE-NAME (A16)

LPAR where node is running.

Field Name Type/Length
SYSTEM-MESSAGE-CODE (A10)

Code of system message.

Field Name Type/Length
PATH (A54)

Path of directory to be read.

Field Name Type/Length
FILE (A253)

Name of file or directory.

Field Name Type/Length
TYPE (A1)

Directory or file.

Values Explanation
D  Directory.
3  Standard file.
Field Name Type/Length
ACCESS-USER (A3)

Access rights of user.

Values Explanation
R  Read
W  Write
X Execute
Field Name Type/Length
ACCESS-GROUP (A3)

Access rights of group.

Values Explanation
R  Read
W  Write
X Execute
Field Name Type/Length
ACCESS-OTHER (A3)

Access rights of others.

Values Explanation
R  Read
W  Write
X Execute
Field Name Type/Length
OWNER (N8)

Owner of file/directory.

Field Name Type/Length
OWNER-GROUP (N8)

Group of owner.

Field Name Type/Length
FILE-SIZE (N8.0)

Size of file in bytes.