Initialize input fields

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall I_INIT(window_id, [set_name], [data_area][, field_list, ...])



The ID of the input window to process. (n)


(optional) The name of the input set. (a)


(optional) The name of the data area for the input set. (a)


(optional) One or more field specifications, or *ENABLED* to initialize enabled fields only. (a)


I_INIT initializes input fields. To initialize means to clear the input field(s) in the window, fill the field(s) with the appropriate paint character, and flag the field(s) as empty. I_INIT does not affect the enabled state of the field(s).

Data_area must correspond to the structure associated with the input set. Data_area only applies if you specify a set_name. By default, Toolkit does not ensure that data_area is large enough for the fields it references. Toolkit generates an error for this condition only if g_dtkbounds is set to 1 or greater. See g_dtkbounds.

You can specify up to nine field lists (field_list arguments), each of which can have from one to nine field specifications. If a field_list has multiple field specifications, separate the field specifications with any character except alpha characters, numeric characters, dollar sign ($), underscore (_), and square brackets ( [ or ] , which are used to enclose dimension specifications for repository arrayed fields). For example:



"name, birthday, soc_sec_no, employer, phone, policy_no, conditions[2]"

The maximum length of a field_list is 99 characters. Additional characters are ignored. For information on field specifications, see Field specifications.

You can do the following:


The following examples illustrate the five specification possibilities described above.

In this example only a window ID is specified. All fields in the window whose ID is stored in inpid will be initialized.

xcall i_init(inpid)

In this example both a window ID and a set name are specified. All fields in input set cusmas will be initialized.

xcall i_init(inpid, "cusmas")

In this example a window, a set, and a data area are specified. All fields in the data area cusmas that are associated with the input set named cusmas will be initialized.

xcall i_init(inpid, "cusmas", cusmas)

In this example window and a list of fields are specified. Fld1 and fld2[2,7] will be initialized. Their associated data areas will not be modified.

xcall i_init(inpid,,, "fld1, fld2[2,7]")

The final example specifies a window, a set, a data area, and a field specification containing two fields. The I_INIT routine will initialize the fields name and addr[2] after verifying that these fields are in input set cusmas.

xcall i_init(inpid, "cusmas", cusmas, "name, addr[2]")