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

4.4.3 ID group definition (distributor tools)

If you create an ID group created by using the distributor tools, the system that creates the ID group manages it. The ID group of the distributor tools is defined in the following procedure.

Execute the command to create the ID group.

Register the distribution destination system that will belong to the created ID group.

Organization of this subsection

(1) ID group creation

(2) Registering distribution-destination systems

(3) Manipulating an ID group

(4) Note on using ID groups

(1) ID group creation

To create a new ID group, create the Register ID group job. To delete an existing ID group, create the Delete ID group job. These jobs are generically called the Register or delete ID group job.

To create the Register ID group job, use the rdsafgid command (specify the -e option). As an ID group, a character string consisting of up to 32 characters can be defined.

When an ID group is created, the following can also be specified using command options:

Definition of a password

By setting a password for the ID group that is created in the managing server, you do not need to enter a password when registering from a distribution-destination system, thus avoiding belonging to an invalid group.

Overwriting an existing ID group

If the ID group that you attempt to register is already registered in the local system, specify the -F option in the rdsafgid command to continue registering the ID group. If you do not specify the -F option, the ID group is not created and processing ends normally. Even if you specify the -F option, the distribution-destination names already registered in the ID group are valid.

To change the defined password, use this method to overwrite the information.

(2) Registering distribution-destination systems

To register a distribution-destination system into the created ID group, use the rdsafcdef command (specify the -e option). To register many distribution-destination systems in a batch, prepare the client list that describes the names of distribution-destination systems.

For procedures on how to create the client list file, see 10. Command Operations for Distributor Tools under rdsafcdef command (Registration/deletion of the distribution-destination system of the ID group, Executing jobs specifying the ID group) in PART 3.

(3) Manipulating an ID group

JP1/Software Distribution Client manages the information about ID groups in the ID group definition file. The ID group definition file manages the information about ID groups that are created in the upper-level managing server (JP1/Software Distribution Manager), the lower-level relay systems, or the lower-level distribution-destination systems as well as the information about the ID groups that are created using the distributor tools of JP1/Software Distribution Client.

The distributor tools of JP1/Software Distribution Client perform the following operations on the ID groups that are created in the local system and the upper-level managing server:

Displaying ID groups

Deleting ID groups

Maintaining ID groups

Reporting to the upper-level managing server

(a) Displaying ID groups

To display the information about ID groups, use the rdsafgid command (specify the -o option). The target ID groups include the ID groups that are defined in distribution-destination systems as well as the ID groups that are defined in the managing server.

(b) Deleting ID groups

To delete an ID group, use the rdsdmgid command (specify the -r option) to create the Delete ID group job. To delete only the distribution-destination systems registered in the ID group that is created in the managing server, use the rdsdmcdef command (specify the -r option).

(c) Maintaining ID groups

Although ID groups can be created either in the managing server or the distribution-destination systems, the managing server can maintain ID groups (registering distribution-destination systems and referencing information) only if the ID groups are created in the managing server. The managing server cannot manipulate the ID groups that are created in distribution-destination systems.

For the managing server to manipulate an ID group that is created in a distribution-destination system, overwrite the same ID group using the -F option and create that ID group again. This overwrites the management information and you can change the ID group that is created in a distribution-destination system to an ID group that is created in the managing server. Even if the management information is overwritten, the information about the registered distribution-destination systems is inherited.

(d) Reporting to the upper-level managing server

If there is a managing server in the upper level, the definition or the deletion of ID groups is reported to that managing server. To report to the upper-level managing server, specify HighEndManagementHost (for upper-level managing host) in the settings file of distributor tools.

(4) Note on using ID groups

Note the following when using ID groups:

How a distribution-destination system is treated when it is added to an ID group after a job is executed
A job is automatically executed for a distribution-destination system that is added after the job is executed only when the distribution-destination system registers itself into the group. If the managing server adds a distribution destination in an ID group, you need to specify the distribution target and then re-execute the job that is already executed, if necessary.

Relationship between the packages in the package storehouse and the jobs in the temporary job storehouse
When the upper-level managing server executes a job specified with an ID group, the relay system relates the relevant package in the temporary package storehouse and the corresponding job in the temporary job storehouse. Therefore, if a package is deleted from the temporary package storehouse, the corresponding job is usually deleted from the temporary job storehouse of the relay system. However, if you use a JP1/Software Distribution Client distributor tool command to delete a package from the package storehouse, the corresponding job in the temporary job storehouse is not deleted.

[Contents][Back][Next]

[Trademarks]