|
Required Parameter Group:
|
The Select Product (QSZSLTPR) API displays a list of products. One or more products can then be selected from the prompt screen. The list of selected products is then returned to the caller of the API. The list of products displayed can be:
Alternatively, the QSZSLTPR API can return a list of products without displaying a list of products. The result is as if the list of products had been displayed and all products in the list had been selected.
If the job is in batch mode, the number of products to select field must be *ALL.
Note: A product can be supported and unsupported by using the Work with Supported Products (WRKSPTPRD) command. This command is part of the System Manager for AS/400 licensed program.
A defined product is one which is known to the system. This includes all installed products, but also includes products which are known to the system without the products being installed. For example, V3R1M0 of the System Manager for AS/400 licensed program (5763SM1) is known to the system once V3R1M0 of the operating system is installed. Therefore V3R1M0 of 5763SM1 is a defined product once V3R1M0 of the operating system is installed.
A product is also a defined product when a product definition (*PRDDFN) object exists for that product on the system.
An array where you will receive one or more product records.
All the records of this array will have the same size. The size is returned in the record size field of the output information parameter.
When the number of products to select field of the input information parameter is:
For information about the layout of this parameter, see PRDS0100 Format and PRDS0200 Format.
Specifies:
The content and format of the information returned. The possible format names are:
An array containing the records used to determine which products that are defined to the system are displayed or returned. The Input list is ignored unless the Product field is equal to *LIST. The format of the data for the input list is described in Input List Format.
The following information is returned:
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Number of records to return |
| 4 | 4 | CHAR(10) | Number of products to select |
| 14 | E | CHAR(1) | Initial panel view |
| 15 | F | CHAR(1) | Allow exit |
| 16 | 10 | CHAR(10) | Product options to display |
| 26 | 1A | CHAR(10) | Product |
| 36 | 24 | BINARY(4) | Records in list |
When *LIST is specified for Product, then a list of product records must be specified for the Input List parameter.
Allow exit. Whether the exit action is allowed from the display. The valid values are:
Initial panel view. Whether the first view of the display shows the release level.
If the release level is shown on the first view, the description is not shown until the view is changed by pressing the appropriate key. If the first view does not show the release level, the appropriate key can be pressed to change the view and show the release level. The valid values are:
Number of products to select. The number of products that are allowed to be selected on the display. This field controls whether a panel is displayed or not. The valid values are:
Number of records to return. The number of records that can be put in the output list array.
Product. If the Number of products to select parameter is *ALL, this field specifies which products to return. Otherwise, this field specifies which products to put in the list of products to display. The valid values are:
Product options to display. Whether only the base option of each product is to be displayed or whether all options are to be displayed. The valid values are:
Records in list. The number of records in the Input List array. This is used only when the Product field is equal to *LIST.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Record size |
| 4 | 4 | BINARY(4) | Records available |
| 8 | 8 | BINARY(4) | Action |
Action. What action was performed on the display. If no display was shown, 0 is returned. The possible values are:
Records available. The number of records that are available to be returned.
If a panel is displayed and either the exit or cancel action is performed, (so no records were selected) this number is 0.
If no records are shown on the display, or no records are returned in the output array, this number will be equal to minus 1.
*ANY may be specified for the Number of products to select parameter. If so, in case of an error, this number indicates the necessary size of the output array. More storage is required for the API and no list is returned.
*ALL may be specified for the Number of products to select parameter. If so, this number indicates whether there were more records to return in the output array; a partial list may have been returned.
Record size. The length of the records of the output array.
The output list parameter can be in one of two formats. See PRDS0100 Format, and PRDS0200 Format for information.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(7) | Product ID |
| 7 | 7 | CHAR(5) | Product option |
| 12 | C | CHAR(6) | Release level |
When *LIST is specified for the Product parameter, then a list of product records must be specified for the Input List parameter. The API builds a list of product ID, product option, release level combinations from the Input List parameter. All product ID, product option, release level combinations defined to the system, which match a record in the Input List, are put into a list. The list is displayed or returned.
Any combination of the product ID, product option, and release level fields can be left blank. A blank field matches all values for that field. For example, a product ID and product option are specified. But if the release level field is left blank, all available releases of the specified product option are displayed or returned.
If the Product ID, Product option, and Release level are all blank, all available products at all release levels are displayed or returned.
Product ID. The product IDs to display or return. The product ID must be a valid product ID for a defined product or blank. If the API does not find a valid product ID from the defined products, an error is returned.
Product option. The product option to display or return. The product option must be blank or a valid product option must be specified. Valid values are *BASE (00000), 00001, 00002, 00003, and so on. Leading zeros are required.
Release level. The release level of the product. The release level must be either blank or in the format VxRxMy. Valid values for x are 0 through 9. Valid values for y are 0 through 9 and A through Z.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(7) | Product ID |
| 7 | 7 | CHAR(5) | Product option |
| 12 | C | CHAR(6) | Release level |
| 18 | 12 | CHAR(2) | Reserved |
| 20 | 14 | CHAR(7) | Description text message ID |
| 27 | 1B | CHAR(10) | Description text object name |
| 37 | 25 | CHAR(46) | Description text |
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(7) | Product ID |
| 7 | 7 | CHAR(5) | Product option |
| 12 | C | CHAR(6) | Release level |
| 18 | 12 | CHAR(2) | Reserved |
| 20 | 14 | CHAR(7) | Description text message ID |
| 27 | 1B | CHAR(10) | Description text object name |
| 37 | 25 | CHAR(10) | Description text library name |
| 47 | 2F | CHAR(1) | Installed flag |
| 48 | 30 | CHAR(1) | Supported flag |
| 49 | 31 | CHAR(2) | Registration type |
| 51 | 33 | CHAR(14) | Registration value |
| 65 | 41 | CHAR(132) | Description text |
Description text. Text in the message that describes the product option selected. To retrieve the message text, the library list is searched for the specified message file. If the message file is not found, then the description text library name is used to try to retrieve the message text. If the message file is not found, blanks are returned.
Note: This field is only 46 characters long for format PRDS0100 because product descriptions typically should not be longer than 46 characters. Product descriptions should not be longer than 46 characters because some system commands display a maximum of 46 characters for each product description.
Description text library name. The name of the library for the message file that contains the messages which describe the product and its options.
Description text message ID. A seven character alphanumeric identifier assigned to the message that describes the product option selected. The message ID for the base option is the message ID for the product.
Description text object name. The name of the message file that contains the messages which describe the product and its options.
Installed flag. Whether the code load for this product option is installed or not. A load is installed if a product load (*PRDLOD) object is loaded on the system by the Restore Licensed Program (RSTLICPGM) command. The possible values are:
Product ID. The product ID selected.
Product option. The product option of the product selected.
Registration type. The registration type associated with the product. The registration type and registration value together make up the registration ID for the product.
Registration value. The registration value associated with the product. The registration type and registration value together make up the registration ID for the product.
Release level. The release level of the product selected.
Reserved. This field will contain blanks.
Supported flag. Whether this load is currently supported. A load can be supported by using the Work with Supported Products (WRKSPTPRD) command in the System Manager licensed program. The possible values are:
|
Top
| Software Product APIs
Software Product API list | APIs by category |
| [ Information Center Home Page ] | [ Legal | AS/400 Glossary ] |