FCOPY Reference Manual (32212-90008)

90 Chapter5
FCOPY Functions
NOUSERLABELS
NOUSERLABELS
Lets you omit user labels when copying from a tape or disk file to another file.
Syntax
;NOUSERLABELS
Operation
If you do not specify NOUSERLABELS and both the fromfile and tofile are labeled, FCOPY
copies the fromfile labels to the tofile labels.
Use NOUSERLABELS when copying from tape to disk, or disk to tape, to prevent FCOPY
from changing the user label. A disk file's user label is 256 bytes long, while a tape file's
user label is 80 bytes long. If you omit NOUSERLABELS when copying from disk to tape,
FCOPY copies only the first 80 bytes of the disk file's user label. If you omit NOUSERLABELS
when copying from tape to disk, FCOPY pads the additional 176 bytes with zeros. FCOPY
issues a warning message whenever you copy user labels from a disk file to a tape file or
from tape to disk.
Examples
All the files in the examples below have at least one user label.
The command below copies the first file on TAPEA to a disk file named MYFILE1 without
copying the user label of the tape file.
>FROM=*TAPEA;TO=MYFILE1;NOUSERLABELS
The command below copies the second file on TAPEA, including user labels, to the disk file
MYFILE2. The last 176 bytes of MYFILE2's user label are zeros.
>FROM=*;TO=MYFILE2;SKIPEOF=2
The command below copies the first 80 bytes of the disk file DLBLD's user label to the tape
file *TAPE1's user label and then copies the file.
>FROM=DLBLD;TO=*TAPE1