- AccountIdentify
-
- retcode
- reascode
- acctid
- acctflg
Purpose
Use the AccountIdentify function to define an identifier to be associated with either an
individual thread or all the threads in a process.
Parameters
- retcode
- (output,INT,4) is a variable where the function stores the return code.
- reascode
- (output,INT,4) is a variable where the function stores the reason code.
- acctid
- (input,CHAR,16) is a variable for specifying the account identifier of the accounting data
collected for this thread or process.
- acctflg
- (input,INT,4) is a variable for specifying whether the acctid applies
only to this thread or to all the threads in this process. Valid values are as follows:
- vm_act_id_thrd
- ID for this thread only
- vm_act_id_prc
- ID for all the threads in this process
Usage Notes
- If an account identifier has not been assigned to a process or a given thread, the accounting
data collected for that thread has an account ID of 16 bytes of binary zeros.
- If an account identifier is assigned to a process, any subsequently created threads will be
assigned that identifier when they are created.
- The account identifier is included in the header of an accounting record. See Accounting Services for a description of the format of an
accounting record.
- It is suggested that the account ID not contain bytes whose values correspond to the code points
for key wildcard characters. This is so that the account ID can be used easily in an event monitor
sensitive to the VMACCOUNT or VMTRACE events. For more information, see
Tips on Constructing Keys.
Return Codes and Reason Codes
Return Code |
Reason Code |
Meaning |
vm_act_success |
vm_act_success |
AccountIdentify completed successfully |
vm_act_error |
vm_act_bad_id_flag |
acctflg is invalid |
Programming Language Bindings
Language |
Language Binding File |
C |
VMCACT H |
Assembler |
VMASMACT MACRO |
REXX |
VMREXACT COPY |