Using User Index APIs

A user index is an object that allows search functions for data in the index and automatically sorts data based on the value of the data. User indexes are permanent objects in the user domain or in the system domain. They have an object type of *USRIDX and a maximum size of 1 terabyte (1 099 511 627 776 bytes). They help streamline table searching, cross-referencing, and ordering of data. In general, if your table is longer than 1000 entries, an index performs faster than a user-sorted table.

You can use user indexes to:

• Provide search functions
• Do faster insert operations than in a database file
• Do faster retrieve operations than in a database file
• Create an index by name, such as a telephone directory
• Use order entry programs
• Look up abbreviations in an index
• Sort data automatically based on the hexadecimal value of a key

User index entries cannot contain a pointer. You can save and restore all the data in an index. You can also save and restore user indexes to another system. For more information about user index considerations, refer to the User index considerations in API concepts.

In addition to the user index APIs, you can work with user indexes through the following:

• ILE C programming language
• Machine interface (MI) instructions
• Delete User Index (DLTUSRIDX) command

For details about MI instructions, refer to the iSeries Machine Interface Instructions, which provides detailed descriptions of the iSeries^(TM) machine interface instruction fields and the formats of those fields. For details about the DLTUSRIDX command, see the Control Language (CL) topic.