value_len
INPUT:BINARY(4)
The length of the value string. The length must be greater than or equal to 1.
position
INPUT:BINARY(4)
The number indicating the insertion position for the new directive. See Table3
for more information.
reldir
INPUT:BINARY(4)
The handle to a main directive or subdirective, or a NULL (omitted). See
Table3 for more information.
newdir
OUTPUT:BINARY(4)
The handle of the newly added main directive or subdirective.
errcode
I/O:CHAR(*)
The structure in which to return error information.
The position and reldir parameters must be considered together. The combination
of these parameters determine whether the directive being added is a main
directive or subdirective and where in the configuration file it is to be added.
Table3 shows the behavior for the various combinations of these parameters.
Table3. Using the reldir and position parameters.
reldir value Position 0
(Before)
Position 1
(After) Position 2 (At front) Position 3 (At end) Position 4
(Automatic)
NULL (omitted) Notvalid Not valid Inserted as a main
directive at the
beginning of the file.
Inserted as a main
directive at the end
of the file.
Inserted as a main
directive at a
location
determined by
internal rules of
directive ordering.
Use this mode
when you are not
sure where to
insert.
Main directive Inserted as a
main directive
directly
proceeding
redir.
Inserted as a
main directive
directly
following reldir.
Inserted as a
subdirective at the
front of this
directive’s
subdirective list.
Inserted as a
subdirective at the
end of this
directive’s
subdirective list,
but proceeding the
close brace
subdirective ″}″.
Inserted as a
subdirective at a
location in this
directive’s
subdirective list as
determined by
internal rules of
subdirective
ordering. Use this
mode when you
are not sure
where to insert.
Chapter2. Application Programming Interfaces 53