Operands of values function of TEST

address

specifies the location that you want to contain a new value. You can specify address as:

An absolute address
A symbolic address
A relative address
An indirect address
An address expression
A module name and entry name (separated by a period)
An entry name (preceded by a period)
A general register
A floating point register
A vector register
A vector register element
An access register
An alternate address/data space
The vector mask register

data_type ‘value’[, data_type ‘value’,…]

specifies the type of data and the value that you want to place in the specified location. If you want to specify more than one data_type, enclose the list in parentheses, for example, (data_type 'value',data_type 'value'). You indicate the type of data by one of the following codes:

Code	Type of data	Maximum length (bytes) *	Storage boundary
			Data types must begin on specified boundary for a virtual storage address
C	Character	One line of input, continued lines permitted	C-byte
X	Hexadecimal	64	X-byte
B	Binary	64	B-byte
H	Fixed point binary (halfword)	6	H-halfword
F	Fixed point binary (fullword)	11	F-fullword
E	Floating point (single precision)	13	E-fullword
D	Floating point (double precision)	22	D-doubleword
P	Packed decimal	32	P-byte
Z	Zoned decimal	17	Z-byte
A	Address constant	11	A-fullword
S	Address (base + displacement)	8	S-halfword
Y	Address constant (halfword)	6	Y-halfword
* All characters within the quotation marks are included in the length.

Following is a list of valid entries and syntax for data type:

C: ‘character value’
X: ‘hexadecimal value’
B: ‘binary value’
H: ‘[±] decimal value’
The minimum value for H-type is -32768 and the maximum value is 32767
F: ‘[±] decimal value’
The minimum value for F-type is -2147483648 and the maximum value is 2147483647
E: ‘[+] decimal value [E[+] decimal exponent]’
A maximum of eight digits is allowed for the decimal value and a maximum of two digits is allowed for the decimal exponent
D: ‘[+] decimal value [E[+] decimal exponent]’
A maximum of 17 digits is allowed for the decimal value and a maximum of two digits is allowed for the decimal exponent
P: ‘[+] decimal value’
A maximum of 31 digits is allowed
Z: ‘[+] decimal value’
A maximum of 16 digits is allowed
A: ‘[±] decimal value’
The minimum decimal value is -2147483648 and the maximum decimal value is 2147483647
S: ‘decimal value(register number)’
The decimal value can be from 0 to 4095 and the register number must be from 0 to 15 (decimal form)
Y: ‘[+] decimal value’
The decimal value may be from 0 to 32767

You include your data following the code. Your data must be enclosed within apostrophes. Any single apostrophes within your data must be coded as two single apostrophes. Character data can be entered. If necessary, all other data types will be translated into uppercase.

A list of data can be specified by enclosing the list in parentheses. The data in the list is stored at the beginning of the location specified by the address operand.

Values assigned to general registers and access registers are placed in registers right-justified and padded with binary zeroes.

When a virtual storage address is assigned a list of data_type values, the address must reside on the appropriate boundary for the specified data_type of the first value. Storage bytes for subsequent data_type values will be skipped to align data on the appropriate boundary for the data type requested.

If the length of the value you assign to the vector mask register is greater than the length of the vector mask register, an error message is issued. If the length of the value is shorter than the vector mask register, the value is placed in the vector mask register left-justified, and the remaining bits are unchanged.

The following restrictions apply to general registers, floating-point registers, vector registers, access registers and the vector mask register.

Specify only one data_type for floating-point registers. Additional data_types are ignored.
Assign only X or E data_types to single precision floating-point registers.
Assign only X, F, or E data_types to single precision vector registers.
Assign only X or D data_types to double precision floating-point registers.
Assign only X or D data_types to double precision vector registers.
With the exception of the D-type of data, general registers and access registers can be assigned any data_type
Assign only X or B data_types to the vector mask register.

When a general register, floating point register, vector register, or vector register element is assigned a list of data_type‘values’, the first value is assigned to the specified register or register element. Subsequent data_type values are assigned to contiguous higher-numbered registers or register elements. If register 15 is reached and data_type values remain, the values are wrapped around to register 0 and subsequent registers, if needed. For more information about programming considerations for using the vector registers, see z/OS TSO/E Programming Guide.

If data is assigned to a storage area that contains a breakpoint, the breakpoint is removed and a warning message is displayed at the terminal.

ALET(alet_value): specifies the alternate address/data space where you want to change storage. You can specify from 1 to 8 hexadecimal characters to represent the alet_value.
AR(register_number): specifies the access register that contains the alet to be used to determine where you want to change storage. Valid access register numbers are 0 through 15.