MAG KEY VALIDATE

TITLEVALUE
NAMEMAG KEY VALIDATE
DESCRIPTIONThis is a an interface to the Database Server (DBS) utility:
Key Validator

The Key Validator extrinsic function verifies that new values contained
in the FDA do not produce an invalid key. All keys in which any field in
the FDA participates are checked. If the value for a field in a key being
checked is not present in the FDA, the value used to verify the key is
obtained from the previously filed data.
TAGKVAL
ROUTINEMAGQBUT4
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERFLAGS
DESCRIPTION(Optional) Flags to control processing. The possible values are:

Q Quit when the first problem in the FDA is encountered.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH9

INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERFDA
DESCRIPTIONThe root of the FDA that contains the data to be checked. The array can
be a local or global one. See the Database Server Introduction for
details of the structure of the FDA.
The value of fields in the FDA must be the internal value. Do not pass
external (e.g., unresolved pointer values, non-FileMan dates) in the FDA.
No action is taken on fields in the referenced FDA if those fields do not
participate in a Key defined in the KEY file.
PARAMETER TYPELIST
REQUIREDYES
MAXIMUM DATA LENGTH99

RETURN VALUE TYPESINGLE VALUE
RETURN PARAMETER DESCRIPTIONThis Boolean function returns a 1 if key integrity is not violated by any
value in the FDA and a -1 followed by a carat delimiter and an error
message describing the nature of an invalid key that was produced by any
of the values.

740 A duplicate key is produced by a field's new value.
742 A value for a field in a key is being deleted.
744 Not all fields in a key have a value.
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ON
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED