Reference Guide › Command Reference › TAG command

TAG command

Use the TAG command to add or manipulate the TAG comment record. The form of the tag comment record is defined as an ‘*’ followed by the name of the tag followed by a colon. This distinguishes the tag record from a comment record or a special record.

TAG { "Parms" } 

Parms:

  DEFine      tagname nnn               
| REVoke      tagname                   
| Query       {tagname | ALL}  [ ("Options"]
| SET         {userid |*}  tagname data 
| DELete      {userid |*}  tagname 
| SHOW        {userid |*}  {tagname | ALL} [("Options"]

Options:

[MSG | NOMSG ]
[STACK [FIFO|LIFO]]
[FIFO]
[LIFO]
[FILE [filename]]

Note: Options can be specified in any order.

The default for filename is TAG. The value for filetype is always RESULTS. These options are explained in the Common API Command Options.

Authorizations

You must be authorized for the TAG command in the AUTHORIZ CONFIG.

Definitions

DEFine

Define the name of the TAG and the ordinal to the system.

REVoke

Delete an existing tag definition.

Query

Display the tag name and the associated sort ordinal.

SET

Set the value of a user’s tag.

DELete

Delete the value of a tag from a user’s directory entry.

SHOW

Display the tag name and the value of the tag.

tagname

Specifies the name of the tag. The tagname can be up to 8 alphanumeric characters long.

ALL

Specifies all tag name definitions in the system.

nnn

A variable specifying the value of the tag sort ordinal; this value is relative to the other defined local tags. Value can be 0-999. The ordinal is used when adding or updating TAG values. The TAG comment records are placed into a user directory entry in ordinal number order.

userid

The user ID whose TAG records you are manipulating.

*

Means the issuer of the command.

data

Specifies the value of the TAG. This value consists of tokens of data separated by blanks. The total length of all tokens plus the blanks separating them may not exceed 240.

Important! The TAG command creates a file on VMDIRECT 191 called TAG CONFIG. Do not modify this file in any way.

Return Codes and Error Messages

The table, TAG Command: Return Codes and Error Messages, lists return codes and error messages for the TAG command.

The TAG command may also generate CMS messages.

Note: For information about these messages, use the CMS help or see the IBM messages and codes documentation.