LEVL Position on operand array

The LEVL function enables the user to position on an operand array belonging to a structure description (see section “Format of the standardized transfer area”).

When the INIT function is called, the system positions on the operand array of the highest level, in other words on the operand array whose operand was defined with the SDF-A statement ADD-OPERAND ...,RESULT-OPERAND-LEVEL=1.

The LEVL function always refers to the current operand array. This can be the operand array of a structure description, if the LEVL function has already been called beforehand.

The structure description can also be an element in a list. In this case, the user must specify both the position of the list in the current operand array and the position of the structure description in the list.
If the structure description is not an element in a list, the user needs to specify only the position of the structure description in the operand array.

To return to the operand array of the highest level, enter 0 for the position.

Call

---

CALL SDF('LEVL',area,error,pos[,lst])

---

Description of the parameter list

Parameter	Data type (length)	Input/ output	Meaning
LEVL	char(4)	in	Function name: keyword LEVL
area	char()	in	Buffer in which the standardized transfer area was stored (see INIT)
error	integer	out	Return code
pos	integer	in	Position of the structure description in the current operand array or position of the list containing the structure description pos=0 positions on the operand array of the highest level.
lst	integer	in	Relevant only if the structure description is an element in a list: position of the structure description in the list

Direct access to operand array positions greater than 2 is not possible.

Reverse positioning by the system is only possible on the operand array of the highest level. It is the responsibility of the user to trace the path to reverse-position on an intermediate level.