z/VM: CP Commands and Utilities Reference - z/VM - IBM

TAG
Usage Notes
tagtext
is the information you want to associate with the specified spool device or spool
file. The contents and format of this data are flexible; they are the responsibility
of the file originator and the end user.
1. If you enter the TAG command without tagtext information and without the
QUERY option, the tag area associated with the device or file is set to all
blanks.
2. Even though you have created a spool file, after you spool it to another virtual
machine, the other user owns it as soon as the file is closed. If you want to
query or change the tag data, you must first reclaim the file by issuing the
CHANGE or TRANSFER command.
Note: If an external security manager (ESM) is installed on your system, you
may not be authorized to transfer spool files with the CHANGE or
TRANSFER command.
3. You may not be authorized to enter the TAG command if an ESM is installed on
your system. For additional information, contact your security administrator.
4. The buffer that contains tag information is 136 characters long, including blanks.
However, because specific terminals may allow fewer than 136 characters, a
user may not be able to type that many characters on the command line.
5. The tag information for a file is updated when the file is opened or closed. If a
TAG command for a device is issued after a file has been opened, the tag
information is updated when the file is closed. If a file is open during system
shutdown or abend, the tag information in the file reflects the tag when the file
was opened.
6. It should be noted that in an environment where RACF NODEID protection is
implemented, TAG command data is assumed to be NODEID data when
audited/controlled by RACF. Because of this, applications such as RSCS that
regularly use the TAG command with data other than NODEID information can
be adversely affected. In these cases RACF definitions should be adjusted to
exclude these user ID’s from audit/control.
7. The RSCS control program interprets the tag information as being addressing
and control parameters. When you spool a file to the RSCS virtual machine to
be transmitted to a remote station, code the tagtext operand as follows:
►►
locid
where:
userid
1570 z/VM: CP Commands and Utilities Reference
priority
locid
is the node ID (one to eight alphanumeric characters) of the location to
which the file is being transmitted. Your system programmer can give you
the IDs of remote nodes accessible to your virtual machine.
userid
is the user ID of the virtual machine (a one– to eight–character user
identification) where a file is being transmitted. This operand is used by
remote stations when they transmit files to a virtual machine in a remote
spooling network and want the files sent to a particular virtual machine. You
can ignore this operand if you are not specifying a priority. However, if you
are specifying a priority, you must code some userid operand; it is ignored
in a remote spooling network.
►◄