 |
» |
|
|
|
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 (32650-90168) for a
complete description of this parameter. For KSAM/3000 files, refer to the KSAM/3000 Reference Manual (30000-90079) 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 | |
- Intrinsics
None - Commands
None - Manuals
Using KSAM XL (32650-90168) and KSAM/3000 Reference Manual (30000-90079)
|
