CHANGEPRODUCT: Changing software product information

Purpose

Before you begin: To use the RMM CHANGEPRODUCT subcommand, you need CONTROL access to the STGADMIN.EDG.MASTER resource profile to update a product.

Use the CHANGEPRODUCT subcommand to update information about a software product defined to DFSMSrmm. You enter the software product number and, optionally, its version. If you do not supply the version, the default is V01R01M00, Version 1, Release 1, Modification Level 0.

Use the ADDVOLUME subcommand to associate a new volume with the software product. Use the CHANGEVOLUME subcommand to associate a volume that is already defined to DFSMSrmm but not associated with the software product. Use the DELETEVOLUME subcommand to disassociate a volume with a software product and release it. See CHANGEVOLUME: Changing volume information and DELETEVOLUME: Deleting volume information for more information.

Format


>>-+-CHANGEPRODUCT-+--software_product_number------------------->
   '-CP------------'                            

>--+-------------------------------------------+---------------->
   '-DESCRIPTION(software_product_description)-'   

>--+---------------------------------------+-------------------->
   |        .-V01R01M00----------------.   |   
   '-LEVEL(-+-software_product_version-+-)-'   

>--+---------------------------------+--+-----------------+----->
   |                             (1) |  '-OWNER(owner_ID)-'   
   '-NAME(software_product_name)-----'                        

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

Notes:

The NAME operand must contain at least one non-blank character.

Parameters

DESCRIPTION(software_product_description)

Specifies the description of the software product. Descriptive text can be one to thirty characters enclosed in single quotation marks if it contains any special characters or blanks.

LEVEL(software_product_version)

Specifies the software product's version. Enter the version in the form, VnnRnnMnn, indicating the version, release, and modification level. 'nn' is two alphanumeric or national characters.

The default value is V01R01M00.

NAME(software_product_name)

Specifies the software product's name. A software product name is one to thirty characters enclosed in single quotation marks if it contains any special characters or blanks.

You can use the software product name to request lists of software products defined to DFSMSrmm. See SEARCHPRODUCT: Creating a list of software products for more information.

OWNER(owner)

Specifies the software product's designated owner. An owner ID is one-to-eight alphanumeric characters, or $, #, or @; normally a RACF® user ID or RACF group name. The first character must not be a number.

software_product_number

Specifies the number of the software product being changed. A software product number is one to eight characters enclosed in single quotation marks if it contains any special characters or blanks. This operand is required and must immediately follow the CHANGEPRODUCT subcommand.

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.

Examples

Task: Change the owner of a software product with the product number, 5665-XA3. The new owner has the owner ID, CRUMPM.

Command:

  RMM CHANGEPRODUCT '5665-XA3' OWNER(CRUMPM)

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.