nca_set_connect_opt

Example: nca_set_connect_optConnection Functions

Sets the connection options for an Oracle NCA server.

int nca_set_connect_opt( eConnectionOption option, ... );
option One of the following connection options:
  • SCALE_INFO—reduce or enlarge the scale of data provided by the server.
  • REQUIRED_LIST—disable or enable server attachments.
  • INITIAL_RESOLUTION—set the initial resolution for the connection.
  • FONT_FACE—set the font face for the connection.
  • FONT_SIZE—set the font size for the connection.
  • INITIAL_DISP_SIZE—set the screen resolution for the connection.
  • JS_Object_Format_Type_n—set the JavaScript object exchange format.
< option values > One or more parameters in accordance with option.
  • When option is SCALE_INFO, specify 2 additional x and y coordinate integers.
  • When option is REQUIRED_LIST, send one additional integer parameter: 0 to disable or 1 to enable.
  • When option is INITIAL_RESOLUTION, send one additional integer parameter: 0 to disable or 1 to enable.
  • When option is FONT_FACE, send one additional integer parameter: the font face name.
  • When option is FONT_SIZE, send one additional integer parameter: the font size.
  • When option is INITIAL_DISP_SIZE, send two additional integer parameters: the width and the height of the screen.
  • When option is JS_Object_Format_Type_n, send either "0" or "1".

Vugen inserts nca_set_connect_opt prior to nca_connect_server, when it recognizes that the recorded values for the server connection differ from the default values. Saving the recorded values ensures that the connection to the server is exactly the same during script run as during the recording of the script.

In general, do not edit a recorded nca_set_connect_opt step.

Return Values

Oracle NCA Error Codes

Parameterization

All arguments of this function may be parameterized using standard parameterization.