Sort data automatically based on the hexadecimal value of a key
For more information about user index considerations, refer to “User Index
Considerations” on page 2-30. 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.
User Space APIs
You can use these APIs to:
Create and delete user spaces
Change and retrieve the contents of user spaces
Change and retrieve information about user spaces
User spaces are objects that consist of a collection of bytes used for storing user-
defined information. They are permanent objects that are located in either the
system domain or the user domain. They have an object type of *USRSPC and a
maximum size of 16MB. You can save and restore user spaces to other systems.
However, if the user spaces contain pointers, you cannot restore the pointers even
if you want to restore them to the same system.
You can use the user space APIs to:
Create user spaces to be used by list APIs to generate lists of data.
Store pointers.
Store large amounts of data. You can create a user space as large as 16MB.
You cannot create a data area larger than 2000 bytes.
Save information in user space objects, and save and restore the object with
the information in it using CL commands.
Pass data from job to job or from system to system.
Object APIs
Use of the object APIs is described as follows:
Change Library List (QLICHGLL) API
This API provides the only way to change the product libraries in the library list.
The only other way to change the product libraries is using the Create
Command (CRTCMD) or the Create Menu (CRTMNU) command. You can
also use this API to change the current library and the libraries in the user part
of the library list similar to the Change Library List (CHGLIBL) command.
Change Object Description (QLICOBJD) API
Unlike the Change Object Description (CHGOBJD) command, this can be used
on all external object types. This API supports changing more parts of the
object descriptive information than are supported using the CHGOBJD
command.
Convert Type (QLICVTTP) API
This API is the only supported way to convert a symbolic type to hexadecimal
format and vice versa.
List Objects (QUSLOBJ) API
This API returns information similar to the Display Object Description
(DSPOBJD) command. An advantage over the DSPOBJD command is that
you can perform authority checking on the objects and libraries. You can get a
8-14 System API Programming V4R1