CRTPRDDFN (Create Product Definition)

Note: To use this command, have the 5722-SM1 (System Manager for iSeries) licensed program installed.

CRTPRDDFN Command syntax diagram

 

Purpose

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

 

Required Parameters

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 product definition is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library where the product definition is created.

product-definition-name: Specify the name of the product definition object.

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 character 0 through 9, l is any uppercase character A through Z, and x is any character 0 through 9 or A through Z.

*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.

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.

RGSID

Specifies the registration ID used to determine which products can share libraries.

Element 1: Registration Type

*PHONE: The 14-character registration value consists of a country or region code, city code or area code, and telephone number.

*CUSTOMER: The registration value is a country or region code with an IBM customer number appended to the end.

Element 2: Registration Value

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

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.

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.

Element 1: Product Option

*BASE: The base option information is created.

product-option-number: Specify the option number of the product option to which the information applies. Valid values range from 1 through 99.

Element 2: Message ID

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

Element 3: Allow Dynamic Naming

*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.

Element 4: Language Load ID

*NONE: No language loads are used.

*BASEOPT: The language IDs used for the base option are used for the language load IDs.

*IBMLNG: The product option is available in all IBM languages.

load-ID: Specify the languages (29xx) in which the option is available.

Element 5: Code Load ID

*CODEDFT: The default code load ID, 5001, is used.

code-load-ID: Specify the code load ID for the option. Valid values are from 5001 through 9999.

CPYRGTFST

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

*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.

 

Optional Parameters

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.

*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.

ALWMLTRLS

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

*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.

RLSDATE

Specifies the release date of the product.

*NONE: No release date is associated with the product.

release-date: Specify the release date in the format determined by the job description.

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.

TEXT

More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

AUT

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

*LIBCRTAUT: The public authority for the product definition is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the product definition). The public authority 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 affect 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 also can change 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, debug and change the program. Change authority provides object operational authority and all data authority.

*EXCLUDE: The user cannot access the product definition.

Example for CRTPRDDFN

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.

Error messages for CRTPRDDFN

*ESCAPE Messages

CPF9899

Error occurred during processing of command.