13.18.14 PACKAGING_INFORMATION (setting package attribute information)
In the PACKAGING_INFORMATION tag, sets the information to identify a package. This tag is used for the dcminst, dcmpack, dcmpkget, and dcmpkrm commands.
The following table shows the parameters that can be specified, and their corresponding command arguments:
Parameter |
Content |
Command argument |
---|---|---|
Package name |
/p package-name |
|
Package ID |
/I package-ID |
|
Version/revision |
/v version/revision |
|
Generation number |
/G generation-number |
|
Cabinet name |
/c cabinet-name |
|
Cabinet ID |
/C cabinet-ID |
|
Code type |
/KP |
- Organization of this subsection
(1) Format
PACKAGING_INFORMATION{ package_name=package-name package_id=package-ID version_revision=version/revision generation=generation-number cabinet_name=cabinet-name cabinet_id=cabinet-ID package_code=code-type }
(2) Description
-
package_name=package-name
Specify the name of the user program and data to be packaged. A package name can consist of a maximum of 50 characters. You cannot use the character \ and space in a package name.
-
package_id=package-ID
Assign a unique ID to each package. JP1/IT Desktop Management 2 identifies packages with their package IDs. A package ID must consist of 1 to 44 characters. You can use single-byte alphanumeric characters (alphabetic characters are limited to uppercase letters), hyphen (-), and underscore (_).
-
version_revision=version/revision
Set the version/revision number in this parameter. The version/revision number can consist of a maximum of six digits, and single-byte alphanumeric characters (alphabetic characters are limited to uppercase letters) and forward slash (/) can be used for the number. When \increment [:start-value] is specified, the version/revision number can be incremented automatically when the dcmpack command is executed. In that case, you can write a single-byte alphanumeric character string immediately before \. Note, however, that the total size of the character string and the number set in \increment must not exceed six digits.
Automatic incrementing starts with the specified start value, and increments the version/revision number by the value of increment until the package is registered successfully. (In other words, incrementing continues until the version/revision number becomes unique among those of already registered packages). If the start value is not specified, incrementing starts with 0. If the value exceeds six digits, an error occurs.
When automatic incrementing is specified in the parameter file, the current start value immediately after : is overwritten with a next start value (registered value + increment) each time packaging is executed by the dcmpack command. When the start value exceeds six digits, it is reset to 0. When automatic incrementing is specified by using a command argument, the start value is reset to the initial value each time a package is registered.
-
generation=generation-number
Assign a generation number in addition to the version/revision number. The packages of the same version/revision can be classified by using the generation number.
A generation number must be a string of single-byte alphanumeric characters (alphabetic characters are limited to uppercase letters) of up to four digits. When \increment [:start-value] is specified, the generation number can be incremented automatically when the dcmpack command is executed. In that case, you can write a single-byte alphanumeric character string immediately before \. Note, however, that the total size of the character string and the number set in \increment must not exceed four digits.
Automatic incrementing starts with the specified start value, and increments the generation number by the value of increment until the package is registered successfully. (In other words, incrementing continues until the generation number becomes unique among those of already registered packages). If the start value is not specified, incrementing starts with 0. If the value exceeds six digits, an error occurs.
When automatic incrementing is specified in the parameter file, the current start value immediately after : is overwritten with a next start value (registered value + increment) each time packaging is executed by the dcmpack command. When the start value exceeds four digits, it is reset to 0. When automatic incrementing is specified by using a command argument, the start value is reset to the initial value each time a package is registered.
-
cabinet_name=cabinet-name
Specify a unique cabinet name. You can specify a cabinet name that consists of a maximum of 32 characters. You cannot use \, /, *, ", :, ;, and space character in a cabinet name.
-
cabinet_id=cabinet-ID
Specify a two-digit string of single-byte alphanumeric characters (alphabetic characters are limited to uppercase letters) as a unique ID for each cabinet.
-
package_code=code-type
Specify P (for the PC) to indicate the type of package to be installed remotely. When using a command argument for specification, write P immediately after /K.
When this parameter is not specified for the dcminst command, specification of P (for the PC) is assumed. When this parameter is not specified for the dcmpkget command, specification of P (for the PC) is assumed. For the dcmpkrm command, this parameter must always be specified. For the dcmpack command, this parameter is invalid even when specified.
-
P
Indicates that the package is intended for the PC.
-
(3) Specifiable reserved words
The reserved words that can be used in this tag are \CY, \CM, \CD, \CH, \CN, \CS, \BY, \BM, \BD, \BH, \BN, \BS, \VERSION, \PKGID, \FILE, \SIZE, and \BASE. Note, however, that there are the following restrictions placed on the usage of the reserved words.
-
The reserved words can be used only when this tag or arguments are used for the dcmpack command. The reserved words cannot be used for the dcminst, dcmpkget, and dcmpkrm commands.
-
\VERSION and \PKGID cannot be used for the package_id parameter (argument /I).
-
\VERSION cannot be used for the version_revision parameter (argument /v).
-
\increment and a reserved word cannot be specified together in the version_revision parameter (argument /v) and generation parameter (argument /G).
(4) Notes
-
To specify multiple packages for the dcminst or dcmpkget command, you can specify the package information parameters for multiple packages in one PACKAGING_INFORMATION tag. In that case, enclose the package information on each tag in curly brackets ({ }). The following shows an example of specifying multiple packages in one PACKAGING_INFORMATION tag.
PACKAGING_INFORMATION{ {* Information on package 1 package_name=PACKAGE1 package_id=PACK01 : } {* Information on package 2 package_name=PACKAGE2 package_id=PACK02 : } }
-
When automatic incrementing is required for a package for which <, <=, >, or >= is specified in place of an equal sign in the package condition for comparison purposes, specify the start value of the following parameters as shown below.
- Version/revision
-
100,000 or more (Specify a value in this range so that there are six significant digits.)
- Generation number
-
1,000 or more (Specify a value in this range so that there are four significant digits.)