XT (REXX Variable to Tape) -- REXX only

Purpose
Copy a REXX stem variable to a tape file.
Usage notes
Each variable is copied, starting with stem.1 and finishing with stem.nnn, where nnn is the value of stem.0.

For example, if stem is VARXX. and VARXX.0 has the value 3, the variables VARXX.1, VARXX.2, and VARXX.3 are copied to a tape file.

This function is available only from a REXX procedure.

Related function
TX
Copy tape records into a REXX stem variable
Read syntax diagramSkip visual syntax diagram
Syntax

>>-XT--VARNAME=stem--+-----------+--OUTPUT=ddname--------------->
                     '-LABEL=BLP-'                  

                .-RECFMOUT=U--------.                        
>--+---------+--+-------------------+--+-----------------+-----><
   '-DENS=mm-'  '-RECFMOUT=recfmout-'  '-BLKSIZE=blksize-'   

blksize
If recfmout contains F, the actual block size; otherwise, the maximum block size. If recfmout contains B or S, blksize is required; otherwise, it is optional. The maximum is 65 535 (for V), 9 999 (for D), or 9 999 999 (otherwise). If the tape is processed by other utilities or standard access methods, you must also consider the operating system limits.
ddname
Refers to a DD or TSO ALLOC statement.
LABEL=BLP
Specifies that bypass label processing is used. This parameter must be specified with the first Z Data Tools function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the Z Data Tools Customization Guide.
mm
A 2-byte tape mode as shown in Tape density and mode values.
recfmout
Record format for the output. Each value is a combination of the following letters:
B
Blocked
D
Variable-length ISO/ANSI tape records
F
Fixed length
S
Spanned format
U
Undefined length
V
Variable length
The possible values are: U, F, FB, V, VB, VBS, VS, D, DB, DBS, and DS.
stem
A REXX stem variable name. The maximum length is 44 characters.