# System Functions

RCD( ) | Return Next Record

## Format

RCD(chan[,fileopt])
Where:

chan | Channel or logical file number of the file from which to read the data.
fileopt | Supported file options (see File Options):
| BSY=stmtref | Traps Error #0: Record/file busy |
| DIR=num | Direction indicator (not supported with [WDX] tag) |
| DOM=stmtref | Missing record transfer |
| END=stmtref | End-of-File transfer |
| ERR=stmtref | Error transfer |
| IND=num | Record index |
| KEY=string$/num | Record key |
| KNO=num | name$ | File access key number (num) or name (name$) |
| REC=name$ | Record prefix (REC=VIS(string$) can also be used) |
| RNO=num | Record number |
| RTY=num | Number of retries (one second intervals) |
| SIZ=num | Number characters to read |
| TBL=stmtref | Data translation table |
| TIM=num | Maximum time-out value in integer seconds |
| stmtref | Program line number or statement label to which to transfer control |

## Returns

Contents of next or given record.

## Description

The RCD( ) function returns the contents of either the next record in the given file or of the record identified in a KEY=, RNO=, or IND= option. PxPlus effectively issues a READ RECORD directive when it encounters this function and returns the contents of the given record.

## See Also

READ RECORD Read Record from File

## Example

0010 open (13)"\CONFIG.SYS"
0020 print rcd(13,end=0040)
0030 goto 0020
0040 stop
->run
rem device=c:\other\tools\ziptools\aspippm1.sys
FILE=NIBBLE.ILM
SPEED=10
QUIET