FWRITELABEL

Syntax

               I16V     UDS     I16V    I16V
  FWRITELABEL (filenum, buffer, length, labelid);

Parameters

filenum

16-bit signed integer by value (required)

Passes the file number of the file to be labeled.

buffer

user-defined structure (required)

Passes the label to be written. If the file is a labeled magnetic tape file, this label must be 40 halfwords in length.

length

16-bit signed integer by value (optional)

Passes the number of halfwords or bytes to be written. A positive value is in halfwords; a negative value is in bytes.

labelid

16-bit signed integer by value (optional)

Passes the number of the label to be written. The first label is zero. This parameter is ignored for labeled tapes. The next sequential tape label is written. The default is zero.

Operation Notes

Condition Codes

CCE

Request granted.

CCG

Request denied. The calling process attempted to write a label beyond the limit specified in the FOPEN/HPFOPEN intrinsic when the file was created.

CCL

Request denied. An error occurred.