Create Product Definition (CRTPRDDFN)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Create Product Definition (CRTPRDDFN) command creates a product definition object. This object contains common information for the product.

Top

Parameters

Keyword Description Choices Notes
PRDDFN Product definition Qualified object name Required, Positional 1
Qualifier 1: Product definition Name
Qualifier 2: Library Name, *CURLIB
PRDID Product ID Character value, *SER Required, Positional 2
RLS Release level Character value Required, Positional 3
RGSID Registration identifier Element list Required, Positional 4
Element 1: Registration type *PHONE, *CUSTOMER
Element 2: Registration value Character value
MSGF Message file Name Required, Positional 5
PRDOPT Product options Values (up to 100 repetitions): Element list Required, Positional 6
Element 1: Product option 1-99, *BASE
Element 2: Message identifier Name
Element 3: Allow dynamic naming *NODYNNAM, *ALWDYNNAM
Element 4: Language load ID Single values: *NONE, *IBMLNG, *BASEOPT
Other values (up to 51 repetitions): Character value
Element 5: Code load ID Character value, *CODEDFT
CPYRGTFST Copyright first year Character value, *CURRENT, *NONE Required, Positional 7
CPYRGTCUR Copyright current year Character value, *CURRENT, *NONE Optional
ALWMLTRLS Allow multiple releases *NO, *YES Optional
PRDIDSFX Product ID suffix Character value Optional
RLSDATE Release date Date, *NONE Optional
TEXT Text 'description' Character value, *BLANK Optional
AUT Authority *LIBCRTAUT, *USE, *ALL, *CHANGE, *EXCLUDE Optional
Top

Product definition (PRDDFN)

Specifies the qualified name of the product definition object being created.

The name of the product definition can be qualified by one of the following library values:

*CURLIB
The current library for the job is used to create the product definition. If no current library entry exists in the library list, QGPL is used.
library-name
Specify the name of the library where the product definition is to be created.
Top

Product ID (PRDID)

Specifies the 7-character ID of the product for which a product definition is being created. The product identifier must be in the format nlxxxxx, where n is any numeric character 0 through 9, l is any upper-case letter A through Z, and x is any numeric character 0 through 9 or upper-case letter A through Z.

The possible values are:

*SER
The serial number of the system, together with the product identifier suffix (PRDIDSFX) parameter, is used as the product ID. This does not guarantee a unique product ID.
product-ID
Specify the 7-character ID of the product for which a product definition is being created.
Top

Release level (RLS)

Specifies the version, release, and modification level of the product being created.

release-level
Specify the release level in the format VxRyMz, where x and y are 0 through 9, and z is 0 through 9 and A through Z.
Top

Registration identifier (RGSID)

Specifies the registration ID of the organization developing the product.

The possible Registration Type values are:

*PHONE
The 14-character registration value consists of a country or region code, city code, and telephone number.
*CUSTOMER
The registration value consists of a country or region code and an IBM customer number.

The possible Registration Value values are:

registration-value
Specify the 14-character value to be used as the registration ID.
Top

Message file (MSGF)

Specifies the name of the message file to contain the messages which describe the product and its options. The message ID for the base option is the message ID for the product. The message IDs are listed in the PRDOPT parameter. This message file must be in the base option of the product.

Note: If the base product has language features, the message file must be an object in the language load's object list rather than the code load. This allows for a message file to be created for each language and for the message files to be installed in the correct libraries.

Top

Product options (PRDOPT)

Specifies the options allowed for this product.

A product requires the first option defined to be the base option. The option for the base option is *BASE. Specify additional options by selecting Options 1 through 99. Additional options do not have to be specified in sequential order. Specify up to 100 options (the base option and up to 99 additional options). Product options must be listed in the product definition before they can be packaged using the Package Product Option (PKGPRDOPT) command.

The possible Product Option values are:

*BASE
The base option information is created.
product-option
Specify the option number of the product option to which the information applies. Valid values range from 1 through 99.

The possible message ID value is:

message-ID
Specify the message ID of the message that describes the product option.

The possible Allow Dynamic Naming values are:

*NODYNNAM
Libraries and root folders are not dynamically named at installation time. The primary library and primary folder names are used except when a secondary language library name is used.
*ALWDYNNAM
Libraries and root folders can be dynamically named at installation time.

The possible Language Load ID values are:

*NONE
No language loads are used.
*IBMLNG
The product option is available in all IBM languages.
*BASEOPT
The language IDs specified for the base option are used for the language load IDs.
language-load-ID
Specify the languages (29xx) in which the option is available.

The possible Code Load ID values are:

*CODEDFT
The default code load ID, 5001, is used.
code-load-ID
Specify the code load ID for this product option. Valid values range from 5001 through 9999.
Top

Copyright first year (CPYRGTFST)

Specifies the first copyright year for the product. The year must be specified as a four-digit number, such as 1990.

The possible values are:

*CURRENT
The current year is retrieved from the system.
*NONE
No first copyright year is specified. The value is stored as 4 blanks.
first-copyright-year
Specify the four-digit year of the first copyright.
Top

Copyright current year (CPYRGTCUR)

Specifies the current copyright year for the product.

Note: If neither CPYRGTCUR(*NONE) nor CPYRGTFST(*NONE) is specified, CPYRGTCUR must be greater than or equal to CPYRGTFST. When both copyright years are specified, the CPYRGTCUR must be greater than or equal to the CPYRGTFST.

The possible values are:

*CURRENT
The current year is retrieved from the system.
*NONE
No current copyright year is specified.
current-copyright-year
Specify the copyright year as a four-digit number, such as 1991.
Top

Allow multiple releases (ALWMLTRLS)

Specifies whether more than one release of the product can exist on the system at the same time.

The possible values are:

*NO
Only one release of the product is allowed on a system at a time.
*YES
The product can be installed more than once if the release levels are distinct.
Top

Product ID suffix (PRDIDSFX)

Specifies the suffix to be used with the product ID when PRDID(*SER) is specified. Valid characters are uppercase letters A through Z and numbers 0 through 9.

Top

Release date (RLSDATE)

Specifies the release date of the product.

The possible values are:

*NONE
No release date is associated with the product.
release-date
Specify the release date in the format determined by the job description.
Top

Text 'description' (TEXT)

Specifies text that briefly describes the object. More information on this parameter is in "Commonly used parameters" section in the CL topic in the iSeries Information Center (http://www.ibm.com/eserver/iseries/infocenter).

The possible values are:

*BLANK
Text is not specified.
'description'
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Authority (AUT)

Specifies the authority given to users who do not have specific authority to the product definition, who are not on the authorization list, and whose user group has no specific authority to the product definition.

The possible values are:

*LIBCRTAUT
The public authority for the product definition is taken from the CRTAUT value of the target library (the library that is to contain the product definition). This value is determined when the product definition is created. If the CRTAUT value for the library changes after the product definition is created, the new value does not effect any existing objects.
*USE
You can perform basic operations on the product load, such as running a program or reading a file. You cannot change the product load. *USE authority provides operational authority and read authority to the object, and *EXCLUDE authority to the library.
*ALL
The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user cannot transfer ownership of the product definition.
*CHANGE
The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can run and debug the program, but cannot change it. Change authority provides object operational authority and all data authority.
*EXCLUDE
The user cannot access the product definition.
Top

Examples

CRTPRDDFN   PRDDFN(TESTLIB/TEST01)  PRDID(9XYZ123)  RLS(V5R2M0)
            RGSID(*PHONE 1234567)  MSGF(TSTMSGF)
            PRDOPT((*BASE MSG0001 *NODYNNAM 2924 *CODEDFT)
            CPYRGTFST(2001)  CPYRGTCUR(2002)  ALWMLTRLS(*NO)
            RLSDATE(*NONE)  TEXT('product TEST01')
            AUT(*LIBCRTAUT)

This command creates product definition TEST01 in library TESTLIB. The product ID is 9XYZ123, the release level of the product is V5R2M0, and the registration telephone number is 1234567. The message file TSTMSGF in library TESTLIB will contain the messages to describe the product. The base option is used with a language load ID 2924. The remaining parameters are included to further define the object.

Top

Error messages

*ESCAPE Messages

CPF9899
Error occurred during processing of command.
Top