ADDPRODUCT: Adding software product information

Purpose

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

Use the ADDPRODUCT subcommand to define a software product to DFSMSrmm. You must enter the product number and name when adding a software product to DFSMSrmm.

After you have defined the software product to DFSMSrmm, use the ADDVOLUME subcommand to associate one or more volumes with the software product. You must define the software product to DFSMSrmm before you associate one or more volumes with it. The volumes must not be already defined to DFSMSrmm. Use the ADDVOLUME subcommand to define new volumes. See ADDVOLUME: Adding volume information for more information.

If you are adding a newer release of the software product and the volume you use has the same volume serial number as a volume already defined to DFSMSrmm, consider disposing of the older release and deleting the volume information from DFSMSrmm. To keep the older release and avoid duplicate volume serial numbers, you must redefine the old software product volume before you can add the new software product volume. See Redefining a volume already defined to DFSMSrmm for more information on redefining volumes.

Use the CHANGEPRODUCT subcommand to change or add missing information about the software product. See CHANGEPRODUCT: Changing software product information for more information.

If your installation has set up the NOTIFY option, DFSMSrmm notifies the designated product owner when a program product volume is added. The owner record must contain a valid user ID and node ID.

Format


>>-+-ADDPRODUCT-+--software_product_number---------------------->
   '-AP---------'                            

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

                               (1)   
>--NAME(software_product_name)---------------------------------->

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

>--+--------------------------------+--------------------------->
   |        .-command_issuer_ID-.   |   
   '-OWNER(-+-owner_ID----------+-)-'   

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

Notes:

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

Parameters

DESCRIPTION(software_product_description)

Specifies descriptive text about the software product. The descriptive text is 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. Supply 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, Version 1, Release 1, Modification 0.

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. This operand is required and must not be all blanks.

You can use the value you specify for NAME with the SEARCHPRODUCT subcommand 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 @; normally a RACF® user ID or RACF group name. The first character must not be a number. The default is the user ID of the command issuer.

software_product_number

Specifies the software product's number or ID. 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 ADDPRODUCT 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: Add details of the z/OS® software product with product number 5650-ZOS, version 2.1.0.

Command:

  RMM ADDPRODUCT '5650-ZOS' NAME('z/OS') LEVEL(V02R01M00)

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.