System object attributes

Most attributes can be changed until a successful signon has occurred (either as the result of a successful call to cwbCO_Signon or to cwbCO_Connect). After the signon has taken place successfully, calling the API that tries to change the value of such an attribute will fail with return code CWB_INV_AFTER_SIGNON. The only two attributes that can be changed after a successful signon are the Window Handle and Connect Timeout.

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 iSeries system 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.