HLASM Language Reference

SETAF Instruction
Alternative Statement Format: You can use the alternative statement format for
extended SETx statements. The above coding could then be written as follows:
&LIST(3) SETA 5, THIS IS X
1,, AN ARRAY X
2,25,3
SPECIFICATION
SETAF Instruction
Use the SETAF instruction to call an external function to assign any number of
arithmetic values to a SETA symbol. You can assign a large number of
parameters—the exact number depending on factors such as the size of the
program and of virtual storage—to pass to the external function routine.
The SETAF instruction can be used anywhere that a SETA instruction can be used.
►►──variable_symbol──SETAF──'function─name'
──┬─────────────────┬───►◄
│ ┌
─────────────┐
│
└── ▼ ─,expression─┴─┘
variable symbol
is a variable symbol.
A global variable symbol in the name field must have been previously declared
as a SETA symbol in a GBLA instruction. Local SETA symbols need not be
declared in a LCLA instruction. The assembler considers any undeclared
variable symbol found in the name field of a SETA instruction as a local SET
symbol.
The variable symbol is assigned a type attribute value of N.
function_name
the name of an external function load module. The name must be specified as
a character expression, and must evaluate to a valid module name no longer
than 8 bytes.
Refer to Chapter 5, “Providing External Functions for Conditional Assembly” in
the HLASM Programmer's Guide for information about external function load
modules.
expression
is an arithmetic expression evaluated as a signed 32-bit arithmetic value. The
minimum and maximum allowable values of the expression are −2 31 and
+2 31 −1, respectively.
See “SETA Instruction” on page 347 for further information about setting SETA
symbols, and ways to specify arithmetic expressions.
The function name must be enclosed in single quotes. For example:
&MAX_VAL SETAF 'MAX',7,4 Calls the external function X
MAX, passing values 7 and X
4 as operands.
388 HLASM V1R5 Language Reference