Specifies that IFAUSAGE will accumulate data based on product
specifications, that is, you can record product usage based on your
own data specifications in addition to the CPU time accumulated by
default. You must have issued REQUEST=FUNCTIONBEGIN before issuing
REQUEST=FUNCTIONDATA.
,PRTOKEN=product token
Specifies the product token that was returned on the REQUEST=REGISTER
request. You can specify either PRTOKEN or PRODOWNER, PRODNAME, PRODVERS,
PRODQUAL, and PRODID.
,PRODOWNER=product owner
Specifies the name or address of a required 16-character input
field into which you place the product owner's name. PRODOWNER is
required if you do not specify PRTOKEN.
,PRODNAME=product name
Specifies the name or address of a required 16-character input
field into which you place the name of the product for which IFAUSAGE
is to provide usage data. PRODNAME is required if you do not specify
PRTOKEN.
,PRODVERS=product version
Specifies the name or address of an optional eight-character input
field into which you place the version of the product for which IFAUSAGE
provides usage data. PRODVERS is valid only if you specify PRODOWNER.
,PRODQUAL=product qualifier
Specifies the name or address of an optional eight-character input
field into which you place the qualifier of the product for which
IFAUSAGE is to provide usage data. PRODQUAL is valid only if you specify
PRODOWNER.
,PRODID=product id
Specifies the name or address of an optional 8-byte
input field into which you place the product identifier. PRODID is
valid only if you specify PRODOWNER. IBM® products
use the product's order number.
,DATA=resource data
Specifies the name or address of a required eight-character field
where IFAUSAGE obtains the resource data you want to accumulate. Fixed
data should be right justified and padded with zeros.
,FORMAT=CPUTIME
,FORMAT=BINARY
,FORMAT=FLOAT
Specifies the format of the data specified on the DATA parameter.
The default is CPUTIME. CPUTIME indicates that the data is to be CPU
time, in TOD format (bit position 51 represents 1 micro second); the
data is reported in floating point, .01 seconds. BINARY indicates
that the data is to be in 64-bit binary format. FLOAT indicates
that the data is to be in long floating point hex format.
,CURRENTDATA=current resource
Specifies the name or address of an optional eight-character output
area into which IFAUSAGE returns data accumulated by this and previous
FUNCTIONDATA requests for the product since the REQUEST=REGISTER.
,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.