FGETKEYINFO

Requests access and status information about a KSAM file.

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 is 162 bytes.

control

byte array (required)

Passes 256 bytes of control information about the key file.

Operation Notes

The FGETKEYINFO parameter returns an array equivalent to the array for the HPFOPEN and FOPEN intrinsics. (Refer to Figure 9-3 “FGETKEYINFO Parameter Format”.) Its length must be 162 bytes.

Figure 9-3 FGETKEYINFO Parameter Format

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 referred to by intrinsics, and the date and time it was created, closed, updated, or written to. Its format is shown in Figure 9-4 “FGETKEYINFO Control Parameter Format”.

Figure 9-4 FGETKEYINFO Control Parameter Format

Figure 9-5 FGETKEYINFO Control Parameter Format (continued)

Condition Codes

CCE: Request granted.
CCG: Not returned.
CCL: 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.

Refer to this intrinsic in the MPE/iX Intrinsics Reference Manual (32650-90028) for other codes pertaining to KSAM files.

FGETKEYINFO

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes

Condition Codes