Performance considerations

The format specified for an API influences the performance cost of the API. In general, when more information is returned, the performance is slower.

Some list APIs, such as List Job (QUSLJOB), List Spooled Files (QUSLSPL), and List Objects (QUSLOBJ), generate the list with minimal cost. This is why the formats specified for these APIs do not retrieve very much information. Some of the APIs, such as List Record Formats (QUSLRCD) and List Fields (QUSLFLD), have only one format, because there is no additional performance cost to supply the complete information.

The retrieve APIs allow you to control the performance cost for information that you retrieve. The retrieve APIs, such as Retrieve Member Description (QUSRMBRD) and Retrieve Spooled File Attributes (QUSRSPLA), have formats that are generally ordered from the fastest performance to the slowest performance. That is, the lower-numbered formats run faster but retrieve less information, and the higher-numbered formats run slower but retrieve more information. One exception is the Retrieve Job Information (QUSRJOBI) API, where the order of the formats does not have anything to do with performance characteristics.