CHANGEOWNER: Changing owner information

Purpose

Before you begin: To use the RMM CHANGEOWNER subcommand:

You need READ access to the STGADMIN.EDG.MASTER resource profile to change your own owner information.
You need CONTROL access to the STGADMIN.EDG.MASTER resource profile to update information for any OWNER.

Use the CHANGEOWNER subcommand to update information about an owner or group of owners defined to DFSMSrmm by an owner ID. You must supply the owner ID for which you want to change information.

Format


>>-+-CHANGEOWNER-+--owner_ID--+-----------------------+--------->
   '-CO----------'            '-ADDR1(address_line_1)-'   

>--+-----------------------+--+-----------------------+--------->
   '-ADDR2(address_line_2)-'  '-ADDR3(address_line_3)-'   

>--+---------------------------------+-------------------------->
   |                             (1) |   
   '-+-DEPARTMENT-+-(department)-----'   
     '-DEPT-------'                      

>--+-----------------------+------------------------------------>
   '-EMAIL(id@domain_name)-'   

>--+----------------------------------+--+-----------------+---->
   '-EXTEL(external_telephone_number)-'  '-FNAME(forename)-'   

>--+----------------------------------+--+----------------+----->
   '-INTEL(internal_telephone_number)-'  '-SNAME(surname)-'   

>--+-----------------------+------------------------------------>
   '-TZ({+|-}HH[:MM[:SS]])-'   

>--+-------------------------------+---------------------------><
   |                           (2) |   
   '-USER(user_ID)--NODE(node)-----'

Notes:

The DEPARTMENT operand must contain at least one non-blank character.
The values you specify for USER(user_ID) and NODE(node) work together; if you delete one, you must also delete the other.

Parameters

ADDR1(address_line_1)

Specifies the first address line of the owner's address. An address line is one to forty characters enclosed in single quotation marks if it contains any special characters or blanks.

ADDR2(address_line_2)

Specifies the second address line of the owner's address. An address line is one to forty characters enclosed in single quotation marks if it contains any special characters or blanks.

ADDR3(address_line_3)

Specifies the third address line of the owner's address. An address line is one to forty characters enclosed in single quotation marks if it contains any special characters or blanks.

DEPARTMENT/DEPT(department)

Specifies the name of the owner's department. A department name is one to forty characters and must not be all blanks. Enclose the department name in single quotation marks if it contains any special characters or blanks.

EMAIL(id@domain_name)

Specifies an Internet identifier for the user represented by this owner record. An Internet identifier specifies the path address of the mail recipient. The format of recipient is equivalent to the path syntax, as described in RFC 821, without the (<) and (>) delimiters. See z/OS Communications Server: IP User's Guide and Commands for details.

This EMAIL operand has one of these formats:

user_id@host_name.domain - User on a host in a specified domain.
user_id%nje_host_name@ gateway_name.domain - User on an NJE or RSCS node connected to a TCP network at gateway_name.

There is no default value. When you specify EMAIL, the USER and NODE values are ignored by NOTIFY processing, and any notify messages are sent using your system's SMTP server.

The maximum length of the value supported by DFSMSrmm is 63 characters.

EXTEL(external_telephone_number)

Specifies the owner's external telephone number. An external telephone number is one to twenty characters enclosed in single quotation marks if it contains any special characters or blanks.

FNAME(forename)

Specifies the owner's forename, or first name. A forename is one to twenty characters enclosed in single quotation marks if it contains any special characters or blanks.

INTEL(internal_telephone_number)

Specifies the owner's internal telephone number. An internal telephone number is one to eight characters enclosed in single quotation marks if it contains any special characters or blanks.

NODE(node)

Specifies the owner's node name, to be used to notify the owner of any change in the status of owned volumes. A node name is one-to-eight alphanumeric characters or $, #, @. Use both NODE() and USER() to clear an electronic address.

owner_ID

Specifies the ID of the owner for which you are changing information. An owner ID consists of one-to-eight alphanumeric characters, $, #, or @. The first character cannot be a number. This operand is required and must immediately follow the CHANGEOWNER subcommand.

SNAME(surname)

Specifies the owner's surname, or last name. A surname is one to twenty characters enclosed in single quotation marks if it contains any special characters or blanks.

TZ({+|-}HH[:MM[:SS]])

Specifies the time zone offset when date and time values are specified. The format is {+|-}HH[:MM[:SS]] where:

+|- is the offset direction. Specify + to indicate that the offset is East of the zero median (UT). Specify - to indicate that the offset is West of the zero median (UT). The offset direction is required.
HH is hours
MM is minutes
SS is seconds

An optional colon (:) separates hours from optional minutes and optional seconds.

You can specify a time in the range between 00:00:00 to 15:00:00 for HH:MM:SS. MM and SS value range is 00 to 59.

USER(user_ID)

Specifies the owner's user ID, to be used to notify the owner of any change in the status of owned volumes. This can be different than the owner ID used to identify the owner. A user ID is one-to-eight alphanumeric characters. Use both USER() and NODE() to clear an electronic address.

Task: Change these details for the owner whose owner ID is MAXWELL: new internal telephone number is 321 4567; user ID and node are ALYN at NODEUK.

Command:

  RMM CHANGEOWNER MAXWELL INTEL('321 4567') -
       USER(ALYN) NODE(NODEUK)

Task: Delete the user ID and node for the owner whose owner ID is AVISM.

Command:

  RMM CHANGEOWNER AVISM USER() NODE()

Return codes

See DFSMSrmm return codes and reason codes for DFSMSrmm reason codes.

0: Subcommand completed normally.
4: Warning. Subcommand completed but some operands could have been ignored or modified. DFSMSrmm sets a reason code.
8: User not authorized.
12: Subcommand ended with an error. DFSMSrmm sets a reason code.
16: Error. The DFSMSrmm subsystem is not active.
20: Error. The data is incomplete or incorrect and the TSO user has set NOPROMPT.
24: The TSO subcommand is not APF authorized.
28: The user pressed the attention key.