HPlogo Using KSAM XL: 900 Series HP 3000 Computer Systems > Chapter 9 KSAM XL Intrinsics

FGETKEYINFO
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

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

[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

[FGETKEYINFO Control Parameter Format]

Figure 9-5 FGETKEYINFO Control Parameter Format (continued)

[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.



FGETINFO
  		 


FLABELINFO