RFS

Read syntax diagramSkip visual syntax diagram                       .-PRIVATE-.
>>-RFS--+-AUTH--dirid--+---------+-+---------------------------><
        |              +-PUBLICR-+ |
        |              +-PUBLICW-+ |
        |              '-SECURED-' |
        +-CKDIR--dirid-------------+
        +-CKFILE--fileid-----------+
        +-COPY--fileid1--fileid2---+
        +-DELETE--fileid-----------+
        |                .-DATA.-. |
        +-DISKR--fileid--+-------+-+
        |                '-stem.-' |
        |                .-DATA.-. |
        +-DISKW--fileid--+-------+-+
        |                '-stem.-' |
        +-GETDIR--stem.--+-------+-+
        |                '-dirid-' |
        +-MKDIR--dirid-------------+
        +-RDIR--dirid--------------+
        '-RENAME--fileid1--fileid2-'
 

RFS performs file input/output to the REXX File System.

Operands

AUTH
is a command that authorizes access to RFS directories. The specified access applies to all files in this directory.
dirid
specifies a REXX File System directory identifier. This is partially or fully qualified. Refer to the CD command, section CD, for more information.
PRIVATE
specifies that only the owner of the directory has read/write access to the files. This is the default.
PUBLICR
specifies that any user has read-only access to the files in the directory.
PUBLICW
specifies that any user has read/write access to the files in the directory.
SECURED
specifies that an external security manager grants access to the files in the directory.
CKDIR
is a command that checks for an existing RFS directory level.
CKFILE
is a command that checks to see if the specified, partially or fully qualified, file ID exists.
fileid
specifies the file identifier.
COPY
is a command that copies a file, replacing any existing file.
fileid1
specifies the source file identifier, it may be a fully or partially qualified directory and file identifier.
fileid2
specifies the target file identifier, it may be a fully or partially qualified directory and file identifier.
DELETE
is a command that deletes an RFS file.
fileid
specifies the source file identifier, it may be fully or partially qualified.
DISKR
is a command that reads records from an RFS file.
stem
specifies the name of a stem. (A stem must end in a period.) Refer to section Stems for more information. The default stem is DATA.
DISKW
is a command that writes records to an RFS file.
GETDIR
is a command that returns a list of the contents of the current or specified directory into the specified REXX array.
MKDIR
is a command that creates a new RFS directory level.
RDIR
is a command that removes the specified RFS directory.
RENAME
is a command that renames an RFS file to a new name.
fileid1
specifies the source file identifier, it may be a fully or partially qualified directory and file identifier.
fileid2
specifies the source target file identifier, it may be a fully or partially qualified directory and file identifier.

Return Codes

0
Normal return
101
Invalid command
102
Invalid operand
103
File not found
104
Not authorized
105
File already exists
107
Insufficient space in file pool
110
Request failed
111
Invalid file ID
113
Directory not found
115
Directory already exists
116
Directory not specified
121
File corrupted
122
Invalid or out of range stem.0
126
Path error
127
CICS I/O error
128
Command not valid from this location
130
Directory not empty
131
Missing operand
132
Missing file pool data record. File pool is probably not formatted.
199
Internal error

Note

File access security checking is performed at the directory level, rather than the file level. If a specified file ID is not a fully qualified ID, the current directory or PATH directories are used in an attempt to resolve the partial name into a fully qualified name; in this case no further checking is necessary. If a fully qualified file ID is used, the directory it resides in is checked for proper access authorization, at file open time.