Syntax:
call "CBL_AUDIT_CONFIG_PROPERTY_SET" using by value flags
by reference property-name
by reference property-value
returning status-code
Parameters:
|
Typedef
|
Picture
|
flags
|
cblt-x4-comp5
|
pic x(4) comp-5
|
property-name
|
pic x(n)
|
pic x(n)
|
property-value
|
pic x(n)
|
pic x(n)
|
On Entry:
- flags
-
Bit
|
Value
|
Meaning
|
0
|
0
|
String value. Use bit 1 to determine string terminator
|
|
1
|
Integer value. Ignore bit 1.
|
1
|
0
|
String value is space-terminated
|
|
1
|
String value is null-terminated
|
2-28
|
|
Reserved for future use (must be 0)
|
29
|
0
|
property-name is space-terminated
|
|
1
|
property-name is null-terminated
|
30-31
|
|
Reserved for future use (must be 0)
|
- property-name
- Space- or null- terminated (depending upon setting of bit 29) case-insensitive property name. Recognised property names are:
NAME
|
mfauditmgr instance name to connect, or are connected, to
|
NOSERVER_ACTION
|
indicates the desired behaviour of the CBL_AUDIT_EVENT API when the mfauditmgr process is not running. A value of "wait" indicates the API will block (the default). A value of "nowait" indicates the API will return an error.
|
SYSTEM
|
name of the system to be associated with audit events output by this process
|
Note: Other property names may be set, but they will be ignored by the facility.
Return Codes:
78-AUD-RET-SUCCESS
|
78-AUD-RET-NOT-ENOUGH-MEMORY
|
78-AUD-RET-INVALID-PROPERTY-NAME
|
Examples:
Set the audit facility's "system" property value.
copy "mfaudit.cpy ".
01 flags pic x(4) comp-5.
01 prop-string pic x(100).
...
compute flags = 78-AUD-FLAG-PROP-STRING-VALUE
move "ESDEMO" & x"00" to prop-string
call "CBL_AUDIT_EMITTER_PROPERTY_SET" using
by value flags
by reference "system "
by reference prop-string
...
Comments:
CBL_AUDIT_CONFIG_PROPERTY_SET is used to set a named property value for the audit facility's configuration for the current process. If a property with the same name already exists, its value will be replaced with the new value.
Supported properties are yet to be defined.