PL/I argument values
In PL/I, you can replace the argument values of the CICSPlex® SM API with any PL/I data reference of the correct data type, provided the reference is to connected storage.
- data-value
- Can be replaced by any PL/I expression that can be converted to
the correct data type for the argument. The table that follows indicates
how to define the correct data type:
data-value includes data-ref as a subset.
Data type PL/I definition Halfword binary FIXED BIN(15) Fullword binary FIXED BIN(31) Doubleword binary FIXED BIN(63) Pointer POINTER Character string CHAR(n) where n is the number of bytes UTF-8 character string CHAR(n) where n is the number of bytes Packed decimal (n decimal digits) FIXED DEC(n,0) - data-ref
- Can be replaced by any PL/I data reference that has the correct
data type for the argument. The table that follows indicates how to
define the correct data type:
If the data type is unspecified, data-ref can refer to an element, array, or structure; for example, FROM(P–>STRUCTURE) LENGTH(LNG). The reference must be to connected storage.
Data type PL/I definition Halfword binary FIXED BIN(15) Fullword binary FIXED BIN(31) Doubleword binary FIXED BIN(63) Pointer POINTER Character string CHAR(n) where n is the number of bytes UTF-8 character string CHAR(n) where n is the number of bytes Packed decimal (n decimal digits) FIXED DEC(n,0) The data area must also have the correct PL/I alignment attribute: ALIGNED for binary items, and UNALIGNED for strings.
If you use a varying data string without an explicit length, the data passed begins with two-byte length fields, and its length is the maximum length declared for the string. If you explicitly specify a length in the command, the data passed has this length; that is, the two-byte length fields followed by data up to the length you specified.
- data-area
- Can be replaced by any named variable with a data type of halfword binary (FIXED BIN(15)), fullword binary (FIXED BIN(31)), or character string (CHAR(n)).
- ptr-ref
- Can be replaced by any PL/I reference of type POINTER ALIGNED.
- cpsm-token
- Can be replaced by any named variable with a data type of fullword binary (FIXED BIN(31)).