Job Management Partner 1/Software Distribution Administrator's Guide Volume 2
The PACKAGING_INFORMATION tag specifies information for the identification of a package. This tag can be used in the following commands: dcminst, dcmpack, dcmpkget, and dcmpkrm.
The following shows the contents of specifiable parameters and the correspondence between parameters and command arguments:
- Organization of this subsection
- (1) Format
- (2) Explanation
- (3) Specifiable reserved words
- (4) Notes
(1) Format
PACKAGING_INFORMATION{
package_name=package-name
package_id=package-id
version_revision=version/revision
generation=generation
cabinet_name=cabinet-name
cabinet_id=cabinet-id
package_code=package-code
}
(2) Explanation
- package_name=package-name
Specify the user program and the name of the data to be packaged. You can code a package name in up to 50 characters. The character \ and a space cannot be used.
- package_id=package-id
Assign a unique package ID. JP1/Software Distribution identifies packages based on these IDs. Use 1 to 44 uppercase alphanumeric characters (uppercase only for alphabetic characters), hyphens (-), or underscores (_).
- version_revision=version/revision
Code version/revision information about the package in up to 6 alphanumeric characters (uppercase only for alphabetic characters) and / (slash). In addition, by specifying an \increment [:starting-value], you can cause the system to automatically count up when the dcmpack command is executed. In this case, you can specify any alphanumeric character before \increment, provided that the total number of digits in those characters and the numeric characters assigned in \increment do not exceed 6.
In the operation of the automatic count-up process, beginning with the starting value, the system increments each count by the specified increment until the registration is successful (until the version/revision value of the new package is different from that of the previously registered package). The default starting value is 0. A value exceeding 6 digits may result in an error.
If automatic counting is specified in the parameter file, each time packaging is executed by the dcmpack command, the next starting value (registered value + increment) is overwritten after the :. A starting value exceeding 6 digits is reset to 0. If automatic counting is specified in a command argument, the starting value is reset to the initial value each time.
- generation=generation
In addition to version/revision information, you can assign a generation number. Using a generation number, you can distinguish packages with the same version/revision.
Code generation information in up to 4 alphanumeric characters (uppercase only) and / (slash). In addition, by specifying an \increment [:starting-value], you can cause the system to automatically count up when the dcmpack command is executed. In this case, you can specify any alphanumeric character before \increment, provided that the total number of digits in those characters and the numeric characters assigned in \increment does not exceed 4.
In the operation of the automatic count-up process, beginning with the starting value, the system increments each count by the specified increment until the registration is successful (until the generation value of the new package is different from that of the previously registered package). The default starting value is 0. A value exceeding 4 digits may result in an error.
If automatic counting is specified in the parameter file, each time packaging is executed by the dcmpack command, the next starting value (registered value + increment) is overwritten after the :. A starting value exceeding 4 digits is reset to 0. If automatic counting is specified in a command argument, the starting value is reset to the initial value each time.
For packages that are distributed to UNIX clients, you must set a 4-digit value. Otherwise, although the packaging will succeed, an error may result during remote installation.
- cabinet_name=cabinet-name
Specify a unique cabinet name in up to 32 characters. The following characters cannot be used: \ / * " : ; and space.
- cabinet_id=cabinet-id
For each cabinet, assign a unique ID consisting of two alphanumeric characters (uppercase only).
- package_code=package-code
If you omit this parameter when executing the dcminst command, P (PC) is assumed but you can perform remote installation on a UNIX client. To perform remote installation of a package created with JP1/Software Distribution for UNIX systems, you must specify W (WS). If you omit this parameter when executing the dcmpkget command, P (PC) is assumed. This is a required item in the dcmpkrm command. In the dcmpack command, this item, if specified, is ignored.
- P
A PC package.
- W
A WS package.
(3) Specifiable reserved words
The following reserved words can be used in this tag: \CY, \CM, \CD, \CH, \CN, \CS, \BY, \BM, \BD, \BH, \BN, \BS, \VERSION, \PKGID, \FILE, \SIZE, and \BASE, subject to the following restrictions:
- A reserved word can be used only when this tag or argument is used in the dcmpack command. Reserved words cannot be used in the dcminst, dcmpkget, or dcmpkrm command.
- The reserved words \VERSION and \PKGID cannot be used in package_id (/I).
- \VERSION cannot be used in place of version_revision (/v).
- \increment and a reserved word cannot be used together with version_revision (/v) and generation (/G).
If you want to specify more than one package in the dcminst or dcmpkget command, you can specify more than one package parameter set in a PACKAGING_INFORMATION tag. Enclose each package parameter set in a pair of braces ({}).
The following is an example of specifying multiple packages in a PACKAGING_INFORMATION tag.
PACKAGING_INFORMATION{
{* Information about package 1
package_name=PACKAGE1
package_id=PACK01
:
}
{* Information about package 2
package_name=PACKAGE2
package_id=PACK02
:
}
}
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.