RFS
.-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.
