CA Dynam for VSE User Guide

Using CA Dynam/T
TLBL Parameters
The following list describes the parameters for each of the TLBL fields.
filename(dtfname)
Required parameter, 1 to 7 alphanumeric characters long. The file name must
be the same as the name specified for the file in the program's DTF.
file-id This parameter is required for CA Dynam/T to control the file. It is up to 44
alphanumeric characters long and must be enclosed in single quotation marks.
The file-ID must also be identical to the data set name as it appears in the
CA Dynam Catalog. Additionally, it can contain relative generation information
to call for a particular version of an input file and alphabetic option codes to
control various processing options.
If you are including relative generation information or alphabetic codes, then
there are additional requirements for the data set name format. They are as
follows:
• Data set name field
−
−
It can contain only alphabetic and numeric characters, and blanks.
It cannot exceed 59 characters in total length, including relative
generation and options.
• Relative generation must be appended to the data set name, enclosed in
parentheses and preceded by a period.
• Comma must precede each alphabetic option.
• Parentheses are supported.
• Relative generation must precede alphabetic options if you specify both.
For example,
// TLBL filename,'FILEID.(-1),W,H,D'
Version 2 of the data set FILEID is requested. At CLOSE, the REWIND, HOLD,
and DROP options are performed.
Note: If the actual data set name field length is greater than 17 (after the
options have been stripped) the LAST 17 significant characters are written to
the HDR1 label on the tape.
ret
Specify exceptional retention for output files in this field with any one of the
following:
• A Julian date (yy/ddd or yyyy/ddd)
• A 1- to 4-digit number, 0—9999
Omit this field for input files.
volser
Request a specific volume for input files in this field with a 1- to 6- character
alphanumeric volume serial number. Omit this field for output files.
Chapter 2: Maintaining Tape Files 2–31