Parameters

REQUEST=REGISTER: Specifies that you are identifying a product for which you want to collect usage data, and specifies the level of data you want to collect for that product.
,PRODOWNER=product owner: Specifies the name or address of a required 16-byte input field into which you place the product owner's name. IBM® products use the character string “IBM CORP.”
,PRODNAME=product name: Specifies the name or address of a required 16-byte input field into which you place the product's name.
,PRODVERS=product version: Specifies the name or address of an optional 8-byte input field into which you place the product version identification.
,PRODQUAL=product qualifier: Specifies the name or address of an optional 8-byte input field into which you place the qualifier of the product. You might wish to use this parameter when there are several iterations of the same product running on one system and you want to record usage data for each iteration, rather than grouping all product usage together. If a product is running multiple times on a specific system, you can record usage based on individual system use of the product. A subsystem product could use as the qualifier the subsystem name under which each copy of the product runs.
Note: The Usage Reporting Program (IFAURP) will not consider the product qualifier as part of the product ID when the product name is "DB2®".
,PRODID=product id: Specifies the name or address of an optional 8-byte input field into which you place the product identifier. IBM products use the product's order number.
,DOMAIN=ADDRSP
,DOMAIN=TASK: Specifies whether IFAUSAGE attributes all CPU time for the address space or for the current task to the product. The actual amount of task CPU time attributed to the product is defined by the SCOPE parameter. The default is DOMAIN=ADDRSP.
,SCOPE=ALL
,SCOPE=FUNCTION: Specifies the level of data that IFAUSAGE collects within the current task and attributes to the specified product. ALL specifies that IFAUSAGE is to track all CPU time in the current task for the specified product. FUNCTION specifies that IFAUSAGE is to track CPU time for parts of the current task defined as the periods between the time you issue REQUEST=FUNCTIONBEGIN and REQUEST=FUNCTIONEND for the specified product.
,PRTOKEN=product token: Specifies the name or address of an optional 8-character output field into which IFAUSAGE returns a product token. You can use this product token as input on other requests. Using the token as input on other requests eliminates the need to specify PRODNAME, PRODVERS, PRODOWNER, PRODQUAL, and PRODID on each invocation.
,LINKAGE=SVC
,LINKAGE=BRANCH: Specifies the type of linkage used in IFAUSAGE processing. LINKAGE=BRANCH indicates branch entry. You may specify LINKAGE=BRANCH if you are in supervisor state. LINKAGE=SVC indicates the linkage is by non-branch entry, and is the default.
,RETCODE=return code: Specifies an optional fullword location into which IFAUSAGE stores the return code. The return code is also in GPR 15.