AccountIdentify — Identify an Accounting Entity

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

  1. 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.
  2. If an account identifier is assigned to a process, any subsequently created threads will be assigned that identifier when they are created.
  3. 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.
  4. 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