(SYSLIB) Programming Reference Manual - Public Support Login ...

GETPSF$–Get a Scratch File Routine
Normal Return
If the normal return is taken, the requested files are assigned to the run as track granular,
sector-addressable mass storage files with a maximum size of 3,000 granules. The
GETPSF$ routines do not reassign PSF files. If a PSF file is already assigned and
GETPSF$ is called to assign it again, the normal return is taken and the file remains
exactly as it was before the call to GETPSF$.
The first three characters of all files assigned by the GETPSF$ routines are always PSF.
The last three characters vary, depending on how the GETPSF$ routine was called.
These three characters are returned to the calling program in H1 of register A1 on a
normal return.
On a normal return from GETPSF$ when func-code=GETPSF$, H1 of register A1
contains "$∆∆" if only the file PSF$ was requested or "n$∆", where "n" is the highest
numbered PSF$ file requested. The symbol "∆" represents a blank.
On a normal return from GETPSF$ when func-code=GETPSFN$, H1 of register A1
contains "n$∆", where "n" is the number of the file requested or "$∆∆" if file PSF$ is
requested.
After a normal return, the calling program can store the content of register A1 into a
Fieldata string that can be submitted by ER CSF$ to attach an internal file name to the
PSF file using the @USE command. See the example.
Error Return
When the error return is taken, register A0 contains an error code with auxiliary
information in other registers. The error codes are as follows:
A0 = 0
A0 = 1
A0 = 2
The input value n is negative or exceeds 9. Register A1 contains the value.
A file is assigned to the run that is not in sector-addressable format. Register A1
points to the FACIL$ packet.
A CSF$ request was rejected. Register A1 points to the FACIL$ packet. Register A2
contains the status bits returned by CSF$.
10–4 7833 1733–004