Command Functions › REMOVE Function—Remove Resource Ownership or Resources

REMOVE Function—Remove Resource Ownership or Resources

Valid on z/OS, z/VSE, and z/VM.

Use the REMOVE command function to remove ownership of the keyword specified in the ADDTO function. Ownership cannot be removed until permitted access is revoked, if applicable. REMOVE is the functional opposite of ADDTO.

This command function has the following format:

TSS REMOVE(acid) keyword[(operand)]

ACID

Specifies the resource or attribute being removed.

keyword

Specifies the type of resource or attribute being removed.

Operand

Specifies the specific prefix, name, or value of the resource or attribute. When the keyword is assigned with a unique operand value, the operand value can be omitted. The parentheses for the operand are still required.

Examples: REMOVE function

This example adds the keywords removed by the following commands:

TSS ADD(user1) NOLCFCHK 
               TSOLPROC(proc396)
               TSOJCLASS(a)

This example removes the keywords explicitly:

TSS REMOVE(user1) NOLCFCHK
                  TSOLPROC(proc396)
                  TSOJCLASS(a)

This example removes the keywords implicitly:

TSS REMOVE(user1) NOLCFCHK
                  TSOLPROC()
                  TSOJCLASS()

Note: When removing a list of keywords, it is sometimes possible to exclude the parentheses on the last operand of the command like this:

TSS REMOVE(user1) NOLCFCHK
                  TSOLPROC()
                  TSOJCLASS

When removing a resource from a user, the resource subfield must be specified. For example, the data set name added with the following command can only be removed explicitly:

TSS ADD(user1) DSNAME(xxxxxxx.yyyyyyy.zz)

The following will remove the resource:

TSS REMOVE(user1) DSNAME(xxxxxxx.yyyyyyy.zz)

The following will not remove the resource:

TSS REMOVE(user1) DSNAME()

Avoid mixing unrelated resources, fields, and keywords in the same ADD/REMOVE command for a user, to avoid ambiguities that might not be anticipated.