@KEY

@KEY KWH KWL [ SEL1 SEL2 SEL3 SEL4 SEL5 SEL6 IERR ]

Selects an access index KWH/KWL according to the CDBASE description. KWH is a 8 character identifier while KWL is an optional number (e.g. load case or section number). Values KWL and SEL1 to SEL6 are preset automatically.

For special purpose an optional filtering rule given by up to 6 integer or 4 character key values SEL1 to SEL6 may be specified. Key values which are not important or will be defined with the access-function have to be specified as -1. The keys correspond to the integer positions of the database.

The record index has to exist in the database. You will get an error otherwise. The read position is set to the beginning of the index. If you specify for IERR a number of a variable (for example 999), its value will be set to a positive value if the given key exists. If the variable #CDB_IER has been defined, it will contain the same value.

Please see cdbase.chm as reference!

  • Every command @KEY creates a rewind

  • Call this command only outside a LOOP

  • Corresponds to a selection (1. integer), that means only the selected line out of the database will be exported.

  • Illegal calls result in a CADiNP error message

+++++ error no. 10143 in program SOF_VAR
CDBASE.CDB does not contain a suitable structure for @KEY STU5

Selectors:

  • the keys ID, LC, DC, NR need always a corresponding selector KWL (name, load-case,

    number)

  • A missing selection strings KWL in a CADINP error message

Example (@key ???):

+++++ error no. 10144 in program SOF_VAR
This index @KEY requires an explicit definition of a number at KWL

  • Additional selection string (SEL1 to SEL6) can be used as additional filter for the following @NAME command

  • A maximum of 6 selection strings are possible

  • It is not necessary to use all 6 selections strings

Output of normal force in steel section 2

@KEY SECT_PLA KWL 2 SEL3 101
LET#N @WPN
//ID (=6) is defined by default via SECT_PLA,
//but counts also all sections string (=sel1)