Job Management Partner 1/Software Distribution Client Description and User's Guide

3.2.1 Creating the collection-information file

Write the collection information of the collected resources in the collection-information file. To create the collection-information file, use a text editor using the same format as the settings file.

Organization of this subsection

(1) Description format of the collection-information file

(2) Details about the collection-information file

(1) Description format of the collection-information file

The description format of the collection-information file is as follows:
attribute-name value
Where, indicates a tab code and indicates that you should press the Enter key.

attribute-name

Specify the item to be specified in the collection-information file.

value

Specify the value to be set for an item in the collection-information file.

Create the collection-information file according to the following rules:

You can specify a blank instead of a tab ().

To include a blank in a set value, enclose the set value between double quotation marks (").

If you specify # in the first column, that line is treated as a comment.

The maximum length of a line in the collection-information file is 256 bytes including the code () for the pressed Enter key.

If you specify more than one attribute with the same name, the set value that is specified last is validated and the preceding set values are ignored.

(2) Details about the collection-information file

(a) Format
ResourceName package-ID
PathName resource-file-name or collection-path-file-name
[PathType {RESOURCE|PASSFILE}]
[Version version]
[Generation generation-number]
[UserName owner-name]
[ProgramName program-name]
[CollectType {STANDARD|COMMON|COPY}]
[Compress {NO|COMPRESS|PACK|COMMON}]
[UpdateMode {ADD|UPDATE}]
[LifeofResource package-storage-period]
[APbeforeCollect external-program-processing-before-collection]
[APafterCollect external-program-processing-after-collection]
[CollectTiming {BOOT|EXEC|SHUTDOWN}]
(b) Explanation

ResourceName package-ID ~ <uppercase alphabetic characters, numerics, hyphens, or underscores> <<1 to 24 characters>>

Specify the name of the collected resource. This name must be unique in the managing server.

PathName resource-file-name or collection-path-file-name ~ ((1 to 63 characters))

Use the absolute path to specify the file name or the directory name of the collected resource. When you use the collection path file, specify the file name of the collection path file using the absolute path. When you collect resources from the Windows distribution-destination system, the collection path file name cannot be specified.

PathType ~ {RESOURCE|PASSFILE} <<RESOURCE>>

Specify the method of specifying the collected resources.

RESOURCE

Specify this item when you specify the file name or the directory name of the collected resource in PathName.

PASSFILE

Specify this item when you specify the file name of the collection path file in PathName. When you collect resources from the Windows distribution-destination system, PASSFILE cannot be specified.

Version version ~ <uppercase alphabetic characters, numerics, or slants> ((1 to 6 characters))

Specify the version of the collected resource. If you do not specify this value, 000000 is assumed.

Generation generation-number ~ <uppercase alphabetic characters or numerics> ((4 digits))

Specify the generation number of the collected resource. If you do not specify this value, 0000 is assumed.

UserName owner-name ~ ((1 to 14 characters))

Specify the owner name of the collected resource. If you do not specify this value, a blank is assumed.

ProgramName program-name ~ ((1 to 50 characters))

Specify the general name to be assigned to the collected resource. Specify this name if you want to assign a common name besides the package ID. If you do not specify this item, a blank is assumed.

CollectType ~ {STANDARD|COMMON|COPY} <<STANDARD>>

Specify the format for collecting files.

STANDARD

Use the cpio format to archive files and collect them in the managing server.

COMMON

Use the common format to archive files and collect them in the managing server.

COPY

Collect files in the managing server without archiving them. COPY is available only for single files. When you specify COPY to collect resources and then distribute them, the distribution-destination system uses the generator tools to install them. If the program version of the distribution-destination system is old (JP1/Software Distribution Workstation), JP1/Software Distribution Workstation Generator is required.

To collect resources from the Windows distribution-destination system, specify COMMON or COPY.

To convert the resources collected from the UNIX distribution-destination system into packages and distribute them to both the UNIX and Windows distribution-destination systems, specify COMMON.

Compress ~ {NO|COMPRESS|PACK|COMMON} <<NO>>

Specify the method of compressing the collected resources.

NO

Compression is not performed.

COMPRESS

Use the compress command to compress.

PACK

Use the pack command to compress.

COMMON

Use the common format to compress.

If you specify COMMON for CollectType, you must specify COMMON or NO in this operand.

UpdateMode ~ {ADD|UPDATE} <<ADD>>

Specify the storage mode for the collected resources.

ADD

When a resource with the same name as the existing resource is collected, store the collected resource as a different resource.

UPDATE

When a resource with the same name as the existing resource is collected, overwrite the collected resource.

To change the storage mode after you register the collection-information file, delete the registered collection-information file, change the storage mode, and re-register the file.

LifeofResource package-storage-period ~ <alphanumerics> ((8 digits)) <<1>>

Use the YYYYMMDD format to specify the expiration date until which the collected resource that is distributed is stored in the temporary package storehouse of a relay system.

YYYY

Specify the year (YYYY: current year to 2089).

MM

Specify the month using two digits (MM: 01 to 12).

DD

Specify the day using two digits (DD: 01 to 31).

If you do not specify this value, the storage expires in a day.

APbeforeCollect external-program-processing-before-collection ~ ((1 to 64 characters))

To perform user-specific processing before remote collection, use the absolute path to specify the program name of the external program processing before collection. For the method of creating the external program processing before collection using JP1/Software Distribution Client, see 3.2.3 Creating a UAP that executes during collection.

APafterCollect external-program-processing-after-collection ~ ((1 to 64 characters))

To perform user-specific processing after remote collection, use the absolute path to specify the program name of the external program processing after collection. For the method of creating the external program processing after collection using JP1/Software Distribution Client, see 3.2.3 Creating a UAP that executes during collection.

CollectTiming ~ {BOOT|EXEC|SHUTDOWN} <<EXEC>>

Specify the occasion to collect files.

BOOT

Collect files when the system starts.

EXEC

Collect files while the system is operating.

SHUTDOWN

Collect files when the system is stopped. This item cannot be specified when you collect resources from the Windows distribution-destination system.

When both the collection of resources and the installation of packages are executed at system stop or system startup, the two processes are executed in the following sequence:

When the system is stopped:
Resources are collected and then packages are installed.

When the system is started:
Packages are installed and then resources are collected.

[Contents][Back][Next]

[Trademarks]