|
|
NM and CM callable.
Requests access and status information about a KSAM file.
 |
NOTE: For KSAM files only.
|
Syntax
I16V BA BA
FGETKEYINFO (filenum, param, control);
Parameters
- filenum
16-bit signed integer by value (required)
Passes the file number of the file about which information is
requested.
- param
byte array (required)
Returns information describing the key information for a KSAM file. The
length depends on the number of keys in the file. The file size is given
as the number of sectors.
For KSAM XL files, refer to the Using KSAM XL for a complete
description of this parameter.
For KSAM/3000 files, refer to the KSAM/3000 Reference Manual for
a complete description of this parameter.
- control
byte array (required)
Passes 128-words of control information about the key file.
Operation Notes
When a KSAM file is opened, information can be requested about it using this
intrinsic. The returned param parameter provides static
information defined for the keys at the time it was created. The
control parameter provides dynamic information about the use
of the file from the time it was created. It counts the number of times the
file was referenced by intrinsics, and the date and time it was created,
closed, updated, or written to.
Condition Codes
- CCE (2)
Request granted.
- CCG (0)
Not returned.
- CCL (1)
Request denied. An error occurred; insufficient space was declared for
param or control, an illegal file number
was specified, or the DB register is not set to the user stack.
Related Information
- Manuals
Using KSAM XL
KSAM/3000 Reference Manual
|