System object attributes

Most attributes are not changeable after a successful signon has occurred using either cwbCO_Signon or cwbCO_Connect. The only two attributes that are changeable after a successful signon are the Window Handle and the Connect Timeout attributes. Calling an API to change the value of other attributes, after a successful signon, fails with return code CWB_INV_AFTER_SIGNON.

Some values and the ability to change them may be controlled via policies. Policies are controls that a systems administrator can set up to mandate default attribute values, and to prohibit changes to attributes. The default values that are specified in the System object attributes list topic (link below) are used under the following conditions:

• If policies do not specify or suggest different values
• If a value for such an attribute has not been configured explicitly for the system that is named in the system list

If an attribute's default value may be set by policy, this also is noted. If changing an attribute's value can be prohibited by policy, then:

• An API is provided to check for the attribute's modifiability.
• A specific return code is provided by the attribute's set method if the set fails because of such a policy.