14.19.14 PACKAGING_INFORMATION (setting package attribute information)

(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
}

To Page Top

(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 single-byte characters (or 25 double-byte 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.

  For packages to be distributed to UNIX computers, you must specify a four-digit value. If you do not specify a four-digit value, packaging will succeed, but an error will occur during remote installation.

• cabinet_name=cabinet-name

  Specify a unique cabinet name. You can specify a cabinet name that consists of a maximum of 32 single-byte characters (or 16 double-byte 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 Windows) or W (for UNIX) to indicate the type of package to be installed remotely. To specify this parameter as a command argument, specify P or W immediately after /K.

  If you omit this parameter when executing the dcminst command, specification of P (for Windows) is assumed, but packages can also be remotely installed on UNIX computers. Note that when you remotely install packages created in the UNIX version of JP1/IT Desktop Management 2 - Agent, you must specify W (for UNIX). When this parameter is not specified for the dcmpkget command, specification of P (for Windows) 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 Windows.

  • W

    Indicates that the package is intended for UNIX.

To Page Top

(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).

To Page Top

(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.)

To Page Top