aud_select_host()
Warning
The functions and macros listed below must not be used anymore. Using them in BaanERP 5.0c or higher releases may result in less reliable data. Know that there is a new set of functions that you can use for retrieval of audit information. Refer to Audit Management Overview
Syntax
long aud_select_host(
const string table_name(), long compno, long
user_interaction, ref string host_name() )
Description
Audit files can be located on more than one host (for example, on the local host and a remote host, or on two or more remote hosts). The system maintains a list of hosts where audit files for particular table and company number combinations are located. When accessing audit files, this host list is used to select the particular host on which the files are to be accessed.
aud_select_host() selects and returns the name of the host on which the audit files for a specified table and company are to be accessed. You can use this host name as input to aud_open_audit()<_A>, aud_read_info_hdr(), and aud_write_info_hdr().
Arguments
|
table_name
|
The name of the table for which audit files are to be accessed. This takes the form ppmmfff, where pp is the package code, mmm is the module code, and fff is the file number. |
|
compno
|
The company number. |
| user_interaction |
Specifies whether or not user interaction is required. Possible values are: |
|
USR_INTACTION_YES
USR_INTACTION_NO
|
If there is more than one host in the host list for the specified table and company number, the user is prompted to select the host to be used. The function then returns the name of that host. If there is only one host in the list, that host is returned automatically, without user interaction.
No user interaction. The 4GL library automatically selects the host. It returns the name of the first host in the host list. If there is only one host in the list, it returns the name of that host.
|
|
host_name
|
This returns the name of the selected host. |
Notes
If the AUD_HOST_NAME environment variable is set, aud_select_host() always returns the host name stored in this variable, regardless of the user_interaction setting specified by the function. For example, the application will use the audit file on the remote host 'ed5c21', if the environment variable has been set as follows:
AUD_HOST_NAME=ed5c21
Note that this environment variable applies to all tables. If it is set, it is used for accessing the audit files of all tables.
Return values
|
Success
|
|
Error; Possibly unable to find host list or auditing not enabled for the specified table and company.
|
Context
3GL library function.
Related topics
|
