F.GSP - perform a get specific sector.

Usage:

mem_addr = f.gsp( device, sector, buffer );

Where:

device

is the right-justified, zero-filled, three-character BCD name of the device from which the sector is to be read.

sector

is the disk address of the desired sector.

buffer

is the address of a 380 word buffer, into which the desired llink will be read.

mem_addr

is the memory address of the desired sector.

Description:

F.GSP performs a DRL FILACT or MME GEFSYE, with a Get Specific Catalog Sector subfunction code. The selected sector is read into memory, and a pointer to it is returned.

You must check the FMS status words in "f.stat" to determine if the sector was successfully read. If it failed, "f.stat" will have the pointer to the FMS error message and the value returned by F.GSP will be undefined.

Note that F.GSP should not normally be called by a user program. The user should call F.GSEC instead.

See Also:

expl b syslib f.gsec

for the user routine with this functionality.

expl file system status

for a description of file system status values.

Copyright © 1996, Thinkage Ltd.