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

Method of command input

Two methods of command input are available:

Direct input through the keyboard

Calling from user programs (including shells)

Command format

The following shows an example of the command input format. % indicates the prompt of the shell.

Follow the instructions for individual command syntax explained hereafter. Enter all commands in alphanumeric characters according to the standard UNIX format.

Command name

Indicates the file name of the command to execute.

Option

An option is an alphabetical character, starting with a hyphen (-). An error occurs if multiple hyphens or a hyphen alone is entered for an option.

The option may be specified with a character string called an operand to clarify the attribute of options.

When specifying options, note the following:

Specify the options in the order they appear in the Format section in each command description.

If the same option is specified more than once, the command may result in an error or the last specified option may become valid, depending on the characteristics of the command.

When entering a blank in the character string of the operand, enclose the character string in double quotations (").
The following shows an example of option -d with operands 1 and 2.
%Command name -d "1 2"

Specifying options

The following explains how to specify names to be set in the options of a command.

When an option allows the specification of multiple entries such as distribution-destination names and full package IDs, delimit those entries from each other with one or more spaces.

When specifying the managing server or relay system, only use the distribution-destination name or distribution-destination IP address to specify the system.
Distribution-destination name

The distribution-destination name is the name of a destination for remote installation. Specify a distribution-destination name in the following format:
host-name₁[host-name...]
host-name

Specify the host name of a UNIX or Windows machine set at network setup time. For details on host names, see the relevant manual of each network (TCP/IP).
Distribution-destination IP address

As the distribution-destination IP address, specify the IP address(es) of the package distribution route. The distribution route indicates which networks connect the distribution destination to the managing server.

Whereas you specify a distribution-destination name with a host name(s), you specify a distribution-destination IP address with an IP address(es).

Use an exclamation mark (!) to delimit each IP address. An example follows:
IP-address-1!IP-address-2!IP-address-3
Full package ID

The full package ID is the name of a package registered in JP1/Software Distribution Client, and is unique in the system. Specify a full package ID using the following format:
package-type-code.cabinet-ID.package-ID[.[version][.generation-number]]
package-type-code ~ {C | D}

Select the type of the system that registered the package. Select C (UNIX) or D (Windows).

cabint-ID ~ <uppercase alphabetic characters and numerics>((2 characters))

Specify the cabinet ID of a package.

package-ID ~ <uppercase alphabetic characters, numerics, hyphens, and underscores>((1 to 44 characters))

Specify the name of a package.

version ~ <uppercase alphabetic characters, numerics, and slant >((1 to 8 characters))

Specify the version of a package. If you omit the version information, all packages that match the conditions other than the version are subject to processing.

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

Specify the generation number of a package. If you omit the generation number information, all packages that match the conditions other than the generation number are subject to processing.
Full cabinet ID

The full cabinet ID is the name, in a package storehouse, of a cabinet specified at packaging time. Specify a full cabinet ID in the following format:
package-type-code.cabinet-ID
Information to be specified is the same as for package-type-code and cabinet-ID of a full package ID.
Serial job number in managing server

The serial job number in the managing server is a number assigned for JP1/Software Distribution Client to manage a job. With the rdsafind command (-l option) for displaying job execution status, you can check this number. Specify a serial job number in the managing server using the following format:
serial-job-number-in-managing-server
serial-job-number-in-managing-server ~ <hexadecimal number>((16 digits))

Specify the serial job number in the managing server of a job subject to processing.
ID group

In a distribution job, specify an ID group, that is, the name of a group of a distribution-destination system. Specify an ID group using the following format:
ID-group
ID-group ~ <alphanumeric characters>((1 to 32 characters))

You can use characters excluding the following for the ID group.

! (Exclamation mark), " (double quotations), %, ' (single quotes), *, . (periods), /, : (colon), < (less than), > (greater than), ?, @, \, | (stroke).

Default ID groups can also be specified.

When defining an ID group with a system that contains a mixture of different platforms, ensure character codes match among the platforms. Otherwise, distribution may fail.

[Contents][Back][Next]

[Trademarks]