HP 3000 Manuals HP 3000 Manuals
FREADC NM and CM callable. FREADC returns records in physical sequence, not chronological sequence. For KSAM/XL files with the REUSE option, physical is not equal to chronological sequence and FREADC reads the file in physical sequence. Deleted records are not returned using the FREADC intrinsic, the FREADDIR intrinsic must be used if deleted records are required.
NOTE For KSAM files only.
Syntax _____________________________________________ | | | I16V I16V LA I16V | | length:=FREADC(filenum,target,tcount);| _____________________________________________ Functional Return length 16-bit signed integer by value (assigned functional return) Returns the length of the information transferred. If tcount is positive, it is a word count; if negative, it is a byte count. Parameters filenum 16-bit signed integer by value (required) Passes the file number of the file to be read in chronological sequence. target logical array (required) Returns the transferred record. It must be large enough to hold all the information to be read. tcount 16-bit signed integer by value (required) Passes the number of words or bytes to be transferred. If tcount is positive, it is the length in words; if negative, it is the length in bytes. If tcount is less than the size of the record to be transferred, only the first tcount words are transferred from the record. If the tcount is larger than the physical record size, only the physical record length is transferred. Condition Codes CCE (2) Request granted. CCG (0) Request denied. The logical end-of-data or beginning-of-data was encountered during the read. CCL (1) Request denied. An error occurred. Related Information Intrinsics None Commands None Manuals Using KSAM XL (32650-90168) and KSAM/3000 Reference Manual (30000-90079)