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

rdsiddefine

The rdsiddefine command registers an ID group definition file, displays ID groups, and clears ID group definition.

Description

Registers an ID group definition file.

Displays the contents of the ID group definition files registered on an upper-level relay system.

Outputs the ID group definitions of the relay systems or clients connected to your own UNIX machine to the standard output.

Clears all ID group definitions.

Clears ID group definition files.

Format

Registering an ID group definition file
rdsiddefine -s[-dID-group-name][-k[password]]
       [-mpackaging-type][-grelay-system-name]
Displaying the contents of ID group definition files
rdsiddefine -ll[-a]
Outputting the ID group definition files of relay systems and clients
rdsiddefine -lc
Clearing ID group definitions
rdsiddefine -dl[-r]
Clearing ID group definition files
rdsiddefine -dm -hhost-name[-dID-group-name][-r]

Options

-a

Displays all ID groups registered from the local system with the groups classified by relay system. If you omit this option, JP1/Software Distribution Client displays only the ID groups registered with the relay systems specified for ManagingHost in the settings file for client services.

-dID-group-name

1 to 32 characters except !, ", %, ', *, ., /, <, >, ?, @, \, | for an ID group registered from the managing server

1 to 8 characters uppercase alphabetic characters and numerics for an ID group registered from a distribution-destination system

Specify this option and parameter to add an ID group definition of your own UNIX machine. Do not assign a name beginning with networkID_ to the ID-group-name argument.

If you omit this option, JP1/Software Distribution Client registers an ID group specified in the ID group definition file (/NETMRDS/rdsprm/DMWIDUPM). However, if you add definition to an ID group registered from the managing server, register it by using this option. You cannot add it by other means.

To define ID groups from the managing server, match the character set between platforms. Using different kinds of character sets may result in packages not being distributed.

If you omit this option when you specify option -dm, JP1/Software Distribution Client clears all ID group definitions relevant to the host name specified in option -h.

-dl

This option deletes the local system name from all ID groups in which the local system is registered. The ID groups from which the local system name is deleted are those being managed either by the relay system that is specified in the client services settings file, or by the relay system in which the local client has been registered. You cannot delete the local system definition by specifying a specific relay system.

To delete the local system name from the reserved ID group as well, specify the -r option together with this option.

-dm

Clears the defined ID group definition files.

-grelay-system-name

Specify the host name or IP address of the relay system on which you want to register the ID group. If this option is omitted, the ID group is registered in the relay system specified in ManagingHost of the client services settings file. Therefore, do not specify the relay system specified in ManagingHost in the -g option.

-hhost-name

Specify a host name to clear the ID group definitions relevant to the host name from among those registered on your own UNIX machine.

-kpassword

Specify a password of the ID group you want to add. If the ID group specified in the -d option is the ID registered from the managing server and has no password setting, specify -k only.

-lc

Outputs the ID group definitions of the relay systems or clients connected to your own UNIX machine to the standard output. If you have registered the following ID group definition file, as appropriate, on your UNIX machine, this option also enables JP1/Software Distribution Client to display the file contents.

For systems other than HP-UX:/NETMRDS/rdsprm/DMWIDLCM

For HP-UX:/etc/opt/NETMDMW/rdsprm/DMWIDLCM

-ll

Displays the contents of the ID group definition files registered with an upper-level relay system in the same format as for the ID group definition file. You cannot this option for the relay system directly connected to the managing server.

-mpackaging-type ~ ((u|l))<<u>>

Specify the type of the relay system on which you want to register the ID group. This option is effective if the specified setting of ConnectionKind is MASTER in the settings file for client services. If you specify this option together with option -g, you can specify u only.

u

Registers the ID group with an upper-level relay system.

l

Registers the ID group with the local relay system.

-r

Clears the default ID definition of your own UNIX machine.

-s

Registers an ID group definition file.

Display format

Example 1

The rdsiddefine -ll command with the -a option specified displays ID-group definitions as follows:

Example 2

The rdsiddefine -lc command displays ID-group definitions as follows:

End code

End code Meaning

0 Terminated normally.

1 The ID group definition file does not exist.

2 Interface is incorrect. Alternatively, the user who issued the command is not a superuser.

3 You specified simultaneous execution of the rdsiddefine and rdsidexec commands.

253 Communication error occurred.

254 System error occurred.

255 Error other than the above occurred.

End code	Meaning
0	Terminated normally.
1	The ID group definition file does not exist.
2	Interface is incorrect. Alternatively, the user who issued the command is not a superuser.
3	You specified simultaneous execution of the rdsiddefine and rdsidexec commands.
253	Communication error occurred.
254	System error occurred.
255	Error other than the above occurred.

Notes

If you omit both the -m and -g options when entering the command for registering an ID group definition file, JP1/Software Distribution Client registers the ID group on the relay systems specified for ManagingHost in the settings file for client services.

Should a communication error or some other error occur during the operation of registering an ID group definition file, JP1/Software Distribution Client saves the ID group definition file as is. By re-executing the rdsiddefine command or restarting the system, you can register the ID group definition file.

Once you have changed the ID group definition by means of the rdsiddefine command, execute the rdsidexec command. By executing the rdsidexec command, JP1/Software Distribution Client executes the jobs relevant to the added ID group.

When clearing an ID group, JP1/Software Distribution Client cancels the installation awaiting jobs on the distribution-destination systems that belong to the cleared ID group.

When JP1/Software Distribution Client displays ID group definitions by executing the rdsiddefine -lc command, it may display the same ID group twice.

If an ID group defined from a client workstation or relay system is overwritten with overwrite registration specified for the managing server's ID registration facility, you cannot cancel the ID group definition by specifying the -s option from the client workstation or relay system in which the ID group was defined. To cancel the ID group definition, you must specify the -dm option at the definition-destination relay system.

[Contents][Back][Next]

[Trademarks]