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

rdsafind

The rdsafind command registers, executes, displays and deletes jobs.

Description

Registers a job in the job management file of JP1/Software Distribution Client, and executes it.

Executes a job already registered in the job management file.

Displays job execution status. Two display methods are available: simplified display (specified by the -c option) and detailed display (specified by the -l option).

Deletes jobs registered in a job management file. Using the -r option, you can also cancel the already distributed jobs that remain in a distribution-destination system for a reason such as a distribution-destination name specification error.

You can narrow down jobs for display or deletion by combining options. Omitting all options for narrowing down jobs displays or deletes all jobs.

Format

Registering and executing a job

rdsafind -d
     {-a distribution-destination-name
     [ distribution-destination-name ...]
     |-N distribution-destination-IP-address
     [ distribution-destination-IP-address...]
     |-i ID-group[ ID-group...]}
     -s full-package-ID[full-package-ID...]
    [-p installation-timing or installation-method]
    [-t installation-date/time]
    [-f installation-target-directory-name]
    [-o installation-target-directory-owner]
    [-g installation-target-directory-group]
    [-m installation-target-directory-mode]
    [-P installation-script-file-name]
    [-R computer-restart-yes/no]
    [-I prerequisite-version]
    [-D]

Executing a job already registered
```
rdsafind -x
```

Displaying a job execution status

rdsafind {-c[I][D][i][R]|-l}
    [{-a distribution-destination-name
     [ distribution-destination-name...]
     |-N distribution-destination-IP-address
     [ distribution-destination-IP-address...]
     |-i ID-group[ ID-group...]}]
    [ -s full-package-ID [full-package-ID...]]

Deleting a job

rdsafind -r
    [{-a distribution-destination-name
     [ distribution-destination-name...]
     |-N distribution-destination-IP-address
     [ distribution-destination-IP-address...]
     |-i ID-group[ ID-group...]}]
    [-s full-package-ID[full-package-ID...]]
    [-n serial-job-number-in-managing-server]
    [-e job-status]
    [-p installation-timing]
    [-F]

Options

-a distribution-destination-name

Specify a distribution-destination name for command execution. When you specify the -n option, be sure to specify the -a option or the -N option as well.

If you specify this option together with the -i option, the -i option takes priority.

-c[I][D][i][R]

This option displays job execution status (simplified display). This option displays the following information:

Distribution-destination name (If you specify a job with an IP address, the IP address is displayed.)

Full package ID

Job type

Installation timing

Installation method

Job status

Installation date/time

Specifying an operand listed below adds the corresponding information to information displayed:

I

Prerequisite version

D

Delete option (At the time of execution of a job that specifies an ID group and has 000000 specified as the prerequisite version, this option specifies whether to delete a job with the same package ID stored in the temporary job storehouse.)

i

ID group name

R

This option displays whether or not the system must be restarted after installation, when the distribution-destination system is a Windows system. This option displays REBOOT when restarting is required. Otherwise, * is displayed.

-D

You may need to perform unconditional original file distribution (with 000000 specified as the prerequisite version operand) in an operation that distributes an original file and its differing-components versions with an ID group specified. In such a case, this option eliminates the need to distribute intermediate differing-component versions. If you specify the -D option with 000000 specified as the prerequisite version operand (-I option), this option deletes jobs with the same package ID stored in the temporary job storehouse at the time of job execution.

-d

This option specifies the registration and execution of a job.

-e job-status ~ ((C, D, E, F, I, L, P, W, X, V))

Specify the status of a job you want to delete.

C

Activation failure

D

Job being deleted

E

Execution failure

F

Execution completed

I

Waiting for installation

L

Occurrence of a communication error

P

Installation failure

W

Waiting for execution

X

Being executed

V

Distribution job specifying an ID group disabled

-F

This option immediately deletes the job in a job management file, regardless of the job status.

If you omit this option, the system deletes the job in a job management file after deleting any jobs remaining in the distribution-destination system.

-f installation-target-directory-name ~ <alphanumeric characters>((1 to 64 characters))

When modifying the installation target directory name specified at the time of packaging, specify a directory installing user data and user programs. You can specify this option if you have registered a package by relative path specification from the hard disk. If the distribution-destination system does not contain a specified directory, the system creates the directory for installation at the time of package installation. Specify a directory name in the format below, depending on the type of distribution-destination system.

When the distribution-destination system is a UNIX
Name that starts with / (absolute pathname)

When the distribution-destination system is a Windows
Name that starts with \ (absolute pathname) or with a drive name enclosed in single quotation marks (')

-g installation-target-directory-group ~ <unsigned integer>((0 to 59999))

Specify this option to modify the directory group specified at the time of packaging. By using a group number, specify a group in the case where the distribution-destination system does not contain an installation target directory specified with the -f option (the time of packaging). If a specified group number is undefined, the system assumes sys (group number 3).

You can specify this option to distribute registered packages from a UNIX machine.

-I prerequisite-version ~ </ and alphanumeric characters> ((1 to 6 characters))

Specify this option to modify the prerequisite version of a package you want to distribute. When you specify 000000, the system distributes a package unconditionally.

For another company's software, the -I option has no effect.

-i ID-group

Specify an ID group subject to command execution at a distribution destination. Be sure to specify this option when using the -r option to delete a job with an ID group specified. When you specify the -a option and the -N option together with this option, this option takes priority, and the system ignores the -a option and the -N option.

-l

This option displays the distribution job status and execution status (detailed display). The system displays the following information in addition to information shown in the case of simplified display:

Execution status
Host status, end codes for external program processing for installation, end status, end status 2, or user status

Serial job number in managing server

-m installation-target-directory mode ~ <octal number>((700 to 777))

Specify this option to modify a directory mode specified at the time of packaging. Specify a file mode in the case where the distribution-destination system does not contain an installation target directory specified with the -f option (the time of packaging). When specifying a file mode, specify only the permission mode bit as an absolute value.

You can specify this option to distribute registered packages from a UNIX machine.

-N distribution-destination-IP-address

Specify the IP address of a distribution-destination system.

When you specify the -n option, be sure to specify the -a option or the -N option. If you specify this option together with the -i option, the -i option takes priority.

-n serial-job-number-in managing-server

Specify the serial job number in the managing server of a job you want to delete. Specify this option together with the -a option.

When you specify this option, you can specify only one distribution-destination name in the -a option, and only one full package ID in the -s option. An error results if you specify multiple entries in any of these options.

-o distribution-destination-directory-owner ~ <unsigned integer>((0 to 59999))

Specify this option to modify the directory owner specified at the time of packaging. By using a user number, specify an owner in the case where the distribution-destination system does not contain an installation target directory specified with the -f option (the time of packaging). If a specified user number is undefined, the system assumes root (user number 0).

You can specify this option to distribute registered packages from a UNIX machine.

-P installation-script-file-name ~ <alphanumeric characters>

By using an absolute pathname, specify the name of an installation script file to be added at the time of distribution of a shared package without an installation script file to a Windows machine. You can specify this option when the distribution-destination system is a Windows machine.

-p installation-timing or installation-method

Specify this option to modify the installation timing specified at the time of packaging or to specify an installation method.

installation-timing ~ ((B, S, E, U))

Specify the installation timing of a distributed package. The specifiable options depend on the type of distribution-destination system as indicated below.

When the distribution-destination system is a UNIX: B, S, E

When the distribution-destination system is a Windows: B, E, U
B:Performs installation at the time of distribution-destination system activation processing.
S:Performs installation at the time of distribution-destination system termination processing.
E:Performs installation at the time of remote installation while the distribution-destination system is operating.
U:Performs installation according to the instruction of the UAP.

installation-method ~ ((F))

Specify this option to specify an overwrite installation. If you do not specify F, the system does not perform an overwrite installation. Note, however, that for the Solaris version of another company's software, an overwrite installation is not performed even when F is specified. To perform an overwrite installation of the software, you must edit the installation management file. For details, see the documentation for the OS.

F:Performs an overwrite installation of a package already distributed.

-R computer-restart-yes/no

When the distribution-destination system is a Windows system, this option specifies whether or not to restart the computer after installing the package.

Y: Restarts the computer after the package is installed.

N: Does not restart the computer after the package is installed.

Restart will not occur if the specification is omitted. However, if the restart of the computer is specified at the time of packaging from the Windows system, restart is performed.

-r

This option specifies the deletion of a job.

When you delete a job with an ID group specified, be sure to specify the -i option.

-s full-package-ID

Specify the full package ID of a package subject to command execution.

-t installation-date/time

Specify the new installation date and time in the following format when you want to change the installation date and time specified during packaging. If the distribution-destination system is a UNIX machine, you can specify this option only for user programs and user data.

YYYYMMDDHHmm

YYYY

Year

MM

Month

DD

Day

HH

Hours

mm

Minutes

-x

This option specifies the execution of a job registered in the execution management file.

Display format

Example 1

This example displays job execution status in the simplified display format.

Example 2

This example displays job execution status in the detailed display format.

End code

End code Meaning

0 Command processing terminated normally.

1 An attempt to register, execute, or delete a part or all of the jobs failed.

3 The registration of a job with the rdsafind -d command was successful, but an attempt to execute a part or all of the jobs failed.

98 The system rejected a command request.

99 JP1/Software Distribution Client has not started yet.

249 Attribute file access error

250 Activation file send error

251 The job management file is full.

252 Job management file access error

253 System error

254 The user who entered the command is not the system administrator.

255 A specified option is invalid.

End code	Meaning
0	Command processing terminated normally.
1	An attempt to register, execute, or delete a part or all of the jobs failed.
3	The registration of a job with the rdsafind -d command was successful, but an attempt to execute a part or all of the jobs failed.
98	The system rejected a command request.
99	JP1/Software Distribution Client has not started yet.
249	Attribute file access error
250	Activation file send error
251	The job management file is full.
252	Job management file access error
253	System error
254	The user who entered the command is not the system administrator.
255	A specified option is invalid.

Notes

After executing a distribution job, you need to check the result of distribution execution by displaying the job status. If the job status is ERROR (execution error), check the fault information about remote installation by seeing the relevant manual of each distribution-destination system.

With the rdsafind -d command, the system disables the execution of all jobs if the registration of a part of the jobs fails (with end code 1). So, you need to use the rdsafind -x command to execute jobs that were registered successfully.

If you attempt to delete jobs with the rdsafind -r command, the system deletes not only the jobs in the job management file, but also the already distributed jobs remaining in the distribution-destination system, depending on the job status. At this time, the system usually deletes jobs in the job management file after deleting jobs in the distribution-destination system. Specify the -F option to delete jobs in the job management file immediately after command input (without waiting for jobs on the distribution-destination system to be deleted) for reasons such as insufficient disk space.

[Contents][Back][Next]

[Trademarks]