HP 3000 RFA Calls

You can issue calls from your NSARPA/1000 application programs to a set of compatible HP 3000 RFA intrinsics. These intrinsics provide file access at NS/3000 and DS/3000 nodes. Only a brief description of the HP 3000 intrinsics is shown in the following pages. Refer to the appropriate MPE intrinsics manual for a complete description of these calls. In addition, HP 3000 to HP 1000 RFA is discussed in the DS/3000 HP 3000 to HP 1000 Reference Manual.

 

 

Table 104. HP 3000 Intrinsics

 

 

 

HP 1000

Equivalent

Description

Intrinsic

MPE Intrinsic

 

 

 

 

FCHEK

FCHECK

Obtains file I/O error information. It can be used when a call to a file intrinsic

 

 

returns a condition code value that indicates an I/O error.

 

 

 

FCLOS

FCLOSE

Terminates access to a file by your program. When FCLOS is executed,

 

 

buffers and control blocks through which you accessed the file are deleted

 

 

and the device on which the file resides is deallocated. If you do not issue a

 

 

call to the FCLOS intrinsic for each file opened during your session, MPE will

 

 

issue FCLOS calls automatically when your session is terminated.

 

 

 

FCNTL

FCONTROL

Performs special control operations on a file or device.

 

 

 

FINFO

FGETINFO

Obtains file access and status information. Once a file is opened, a call to

 

 

FINFO can be issued to obtain this information.

 

 

 

FLOCK

FLOCK

Dynamically locks a file for exclusive access by your program.

 

 

 

FOPEN

FOPEN

Opens an HP 3000 file for access by your program. When FOPEN is executed,

 

 

a file number is returned. This file number must be used by your program in

 

 

all subsequent file references in order to access the proper file. You must

 

 

explicitly declare FOPEN as an integer function in your FORTRAN 77 and

 

 

Pascal/1000 programs.

 

 

 

FPOIN

FPOINT

Sets the logical record pointer to any record within a disk file. The file must

 

 

have only fixed6length records.

 

 

 

FRDIR

FREADDIR

Performs a read operation on a specified logical record from a disk file to the

 

 

user's buffer. The file must have only fixed6length or undefined6length records.

 

 

 

FRDSK

FREADSEEK

Seeks out and performs a transfer of a specific logical record from a disk file

 

 

to a buffer prior to a call to the FRDIR intrinsic. The file referenced must allow

 

 

I/O buffering and have fixed6length or undefined6length records.

 

 

 

FREAD

FREAD

Performs a read operation of a logical record from a file on any device to the

 

 

user's buffer. The record read is determined by the current position of the

 

 

logical record pointer. This intrinsic returns an integer value representing the

 

 

number of words or bytes read. You must explicitly declare FREAD as an

 

 

integer function in your FORTRAN 77 and Pascal/1000 programs.

 

 

 

FRLAB

FREADLABEL

Performs a read operation on your disk file label.

 

 

 

FRLAT

FRELATE

Obtains information about the interactive/duplicative attributes of a specified

 

 

file pair. A value is returned that represents the current attributes of the files.

 

 

You must explicitly declare FRLAT as an integer function in your FORTRAN 77

 

 

and Pascal/1000 programs.

 

 

 

FRNAM

FRENAME

Renames a disk file.

 

 

 

FSPAC

FSPACE

Performs forward or backward spacing over a specified number of logical

 

 

records on a disk file, or physical records on a magnetic tape file. The file

 

 

must have fixed6length or undefined6length records.

 

 

 

FSTMD

FSSETMODE

Sets or resets file access modes such as automatic error recovery, critical

 

 

output verification, and user terminal control. Any file access mode set by a

 

 

call to FSTMD remains in effect until either reset by another call to FSTMD or

 

 

until the file is closed.

 

 

 

FUNLK

FUNLOCK

Dynamically unlocks a file that was previously locked via a call to FLOCK.

 

 

 

FUPDT

FUPDATE

Performs a write update of a logical record to a disk file.

 

 

 

FWDIR

FWRITEDIR

Performs a write operation of a specified logical record to a disk file from a

 

 

user's buffer. The file must have only fixed6length or undefined6length records.

 

 

 

FWLAB

FWRITELABEL

Performs a write operation of your label to a disk file. FWLAB overwrites any

 

 

existing label.

 

 

 

FWRIT

FWRITE

Performs a write operation of a logical record from a user's buffer to a file on

 

 

any device. Following FWRIT execution, the logical record pointer is set to the

 

 

record immediately following the record written.

Remote File Access 1017