Previous Topic Next topic Print topic


CBL_AUDIT_CONFIG_PROPERTY_SET

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.

On Exit:

Nothing.

Return Codes:

78-AUD-RET-SUCCESS
78-AUD-RET-NOT-ENOUGH-MEMORY
78-AUD-RET-INVALID-PROPERTY-NAME

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.

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
...
Previous Topic Next topic Print topic