z/OS Using REXX and z/OS UNIX System Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


f_settag

z/OS Using REXX and z/OS UNIX System Services
SA23-2283-00

Read syntax diagramSkip visual syntax diagram
>>-f_settag--fd--filetag---------------------------------------><

Function

f_settag can be used to directly control basic file tagging for an opened file. The setting of the file tag may be immediate or deferred until the first write, depending upon the input parameters.
fd
The file descriptor (a number) for the file. It must be a regular file, FIFO, or character special file.
filetag
The name of a 4-byte hex variable describing the file tag. The CCSID (coded character set identifier) of the file tag occupies the first 2 bytes. For more information, see BPXYSTAT — Map the Response Structure for stat in z/OS UNIX System Services Programming: Assembler Callable Services Reference, or the C header file, stat.h in z/OS XL C/C++ Runtime Library Reference.

Usage notes

  • When the file is /dev/null, /dev/zero, /dev/random, or /dev/urandom, the file tag is not hardened to disk.

Example

The following example sets a file tag for an opened file to ASCII ISO88591–1, with the text conversion flag on as well:
tag = '03338000'x
"f_settag (fd) tag"

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014