DBACCT—Retrieve Accounting Records for a Member

The DBACCT service retrieves accounting records from the project database and returns the information to you. SCLM retrieves the first occurrence of the accounting record in the hierarchy, starting at the specified group. Accounting records exist for any member for which the LOCK, SAVE, or STORE service completes successfully. For more information about SCLM accounting records, see $acct_info.

Command invocation format

You cannot use command procedures to call this service.

Call invocation format


>>-lastrc--:=--FLMLNK('DBACCTbb',sclm_id--,group--,type--------->

>--,member--,found_group--,$acct_info--,$list_info-------------->

>--,$msg_array);-----------------------------------------------><

Parameters

sclm_id: An SCLM ID associated with a given project and project definition. The SCLM ID is generated by the INIT service. The maximum parameter length is 8 characters.
group: The group in which the accounting record search begins. The maximum parameter length is 8 characters.
type: The type containing the accounting record to retrieve. The maximum parameter length is 8 characters.
member: The member whose accounting record is to be retrieved. The maximum parameter length is 8 characters.
found_group: An output parameter that indicates the group in which SCLM finds the first occurrence of the member's accounting record within the hierarchy. The maximum parameter length is 8 characters.
$acct_info: An output parameter pointing to a record containing the static portion of the member's accounting record. See Pointer parameter descriptions for more details on $acct_info.
$list_info: An output parameter pointing to an array of records containing the dynamic portion of the member's accounting record. See Pointer parameter descriptions for more details on $list_info.
$msg_array: An output parameter pointing to the message array. See Pointer parameter descriptions for more information about $msg_array.

Return codes

Additional special services messages are written to the FLMMSGS ddname. See SCLM service messages for more information.

Other return codes might be produced by the FLMLNK processor. See SCLM service return codes for more information about these.

Possible return codes are:

0: Normal completion.
4: Warning condition. SCLM could not find the accounting record.
8: Error condition. The $msg_array parameter contains the error message associated with this condition.

Example of call invocation

This example shows general syntax. Call invocations are language-specific. See Sample programs using SCLM services for specific examples.

lastrc := FLMLNK('DBACCT  ',       (* service                        *)
                  sclm_id,         (* SCLM ID                        *)
                  'USER1   ',      (* group                          *)
                  'SOURCE  ',      (* type                           *)
                  'FLM01MD1',      (* member                         *)
                  found_group,     (* group found                    *)
                  $acct_info,      (* accounting information pointer *)
                  $list_info,      (* list information pointer       *)
                  $msg_array);     (* message array pointer          *)

This service call returns the first occurrence of the accounting record for the FLM01MD1 member of the SOURCE type beginning in the USER1 group. The sclm_id parameter contains a valid SCLM ID returned from the INIT service. SCLM returns all messages produced via the $msg_array.