Guardian Procedure Calls Reference Manual

current-keyvalue
output
STRING:ref:*
returns the value of the current key for current-keylen bytes. This parameter is invalid when
you specify the file-name parameter; use filenum. This parameter 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 parameter 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
parameter 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 parameter is invalid when you
specify the file-name parameter; use filenum.
partition-in-error
output
INT:ref:1
returns a number that indicates the partition in which the latest error occurred for this file. In
H06.28/J06.17 RVUs with specific SPRs and later RVUs, returns a number from 0 through
127. (For a list of the required H06.28/J06.17 SPRs, see SPR Requirements for Increased
Enscribe Limits for the H06.28/J06.17 Release (page 31).) For earlier RVUs, returns a number
from 0 through 63. This parameter is invalid when you specify the file-name parameter;
use filenum.
specifier-of-key-in-error
output
INT:ref:1
returns the key specifier associated with the latest error occurring with this file. This parameter
is invalid when you specify the file-name parameter; use filenum.
These parameters are the only parameters returned when you specify file-name:
606 Guardian Procedure Calls (F)