Xpi Syntax - IBM SC34-6814-04 Customization Manual

Cics transaction server for z/os
Table of Contents

Advertisement

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,....
literalconst
expression
(Rn)
block-descriptor
OUT,
ADDRESS((R6)),
RESPONSE(*),
REASON(*)
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.
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.
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 .
A register reference. The parentheses shown here are required in addition
to those that surround the argument. For example: OPTION((R5)).
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

Advertisement

Table of Contents
loading

Table of Contents