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