Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-216
FILERECINFO Procedure (Superseded by
FILE_GETINFOLISTBYNAME_ Procedure )
Parameters
filenum input
INT:value
is the number of an open file that identifies the file whose characteristics are to be
returned. You must specify either
filenum or file-name; specifying both
causes a CCL condition code.
current-keyspecifier output
INT:ref:1
returns the current key field’s key specifier. This is invalid when you specify the
file-name parameter; use filenum.
current-keyvalue output
STRING:ref:*
returns the value of the current key for
current-keylen bytes. This is invalid
when you specify the
file-name parameter; use filenum. This value is not valid
for queue files. Also, this parameter cannot be used with a non-key-sequenced file
opened with 64-bit primary keys open flag. If an attempt is made, the call will fail
with condition code CCL.
current-keylen output
INT:ref:1
returns the current key length in bytes. This is invalid when the
file-name
parameter is specified; use
filenum.
current-primary-keyvalue output
STRING:ref:*
returns the value of the current primary key for
current-primary-keylen
bytes. This is invalid when you specify the
file-name parameter; use filenum.
This parameter cannot be used with a non-key-sequenced file opened with a 64-bit
primary keys open flag. If an attempt is made, the call will fail with condition code
CCL.
current-primary-keylen output
INT:ref:1
returns the length, in bytes, of the current primary key. This is invalid when you
specify the
file-name parameter; use filenum.