Xpi syntax – IBM SC34-6814-04 User Manual

Page 341

Advertising
background image

OUT,

*

ADDRESS((R6)),

*

RESPONSE(*),

*

REASON(*)

Important

You must set your parameters using only the XPI functions.

XPI syntax

The XPI functions use special syntax. The description of each function defines only
the options that are specific to that call. Options that are applicable to all function
calls are described in “Making an XPI call” on page 308. The following argument
types are used:

name1, name2,....

Each of these refers to the name of a field of the given size in bytes.
“name1” means that the name you specify should be that of a 1-byte field.

literalconst

A number in the form of a literal, for example B'00000000', X'FF', X'FCF4',
"0", or an equate symbol with a similar value.

expression

A valid assembler-language expression: a decimal integer, or any arithmetic
expression (including symbolic values) valid in assembler language; for
example:

20; L’AREA; L’AREA+10; L’AREA+X’22’; SYMB/3+20 .

(Rn)

A register reference. The parentheses shown here are required in addition
to those that surround the argument. For example: OPTION((R5)).

block-descriptor

Represents a source of both the data address and the data length fields. A
block-descriptor can be either a single value or a double value. The
following is the single-value form:

OPTION(blkdname)

blkdname

The name of a block-descriptor. A pair of contiguous fullwords, in
which the first word contains the address of the data, and the
second word contains the length in bytes of the data, as a fullword
binary value. Register notation is not accepted for this single-value
form.

The following is the double-value form:

OPTION(addr,len)

addr

The data address as {namea | (Ra) | aliteral}:

namea

The name of a location containing the data address

(Ra)

A register containing the data address

aliteral

An address constant literal; for example: A(data).

Chapter 3. The user exit programming interface (XPI)

319

Advertising