IBM AS/400E manual Position INPUTBINARY4, Reldir INPUTBINARY4, Newdir OUTPUTBINARY4

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 Table 3 for more information.

reldir INPUT:BINARY(4)

The handle to a main directive or subdirective, or a NULL (omitted). See

Table 3 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. Table 3 shows the behavior for the various combinations of these parameters.

Table 3. Using the reldir and position parameters.

reldir value	Position 0	Position 1	Position 2 (At front)	Position 3 (At end)	Position 4
	(Before)	(After)			(Automatic)
NULL (omitted)	Not valid	Not valid	Inserted as a main	Inserted as a main	Inserted as a main
			directive at the	directive at the end	directive at a
			beginning of the file.	of the file.	location
					determined by
					internal rules of
					directive ordering.
					Use this mode
					when you are not
					sure where to
					insert.
Main directive	Inserted as a	Inserted as a	Inserted as a	Inserted as a	Inserted as a
	main directive	main directive	subdirective at the	subdirective at the	subdirective at a
	directly	directly	front of this	end of this	location in this
	proceeding	following reldir.	directive’s	directive’s	directive’s
	redir.		subdirective list.	subdirective list,	subdirective list as
				but proceeding the	determined by
				close brace	internal rules of
				subdirective ″}″.	subdirective
					ordering. Use this
					mode when you
					are not sure
					where to insert.

Chapter 2. Application Programming Interfaces 53