rdsiddefine

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

Organization of this page

Description
Format
Options
Display format
End code
Notes

Description

Registers an ID group definition file.
Displays the contents of the ID group definition files registered on an upper-level relay system.
Clears all ID group definitions.

Format

Registering an ID group definition file

rdsiddefine -s[-dID-group-name][-k[password]]
              [-grelay-system-name]

Displaying the contents of ID group definition files
```
rdsiddefine -ll[-a]
```
Clearing ID group definitions
```
rdsiddefine -dl
```

To Page Top

Options

-a

Displays all ID groups registered from the local system with the groups classified by relay system. If you omit this option, JP1/IT Desktop Management 2 - Agent 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/IT Desktop Management 2 - Agent 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.

-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.

-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.

-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.

-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. This option displays only the group ID registered by the rdsiddefine -s command from the distribution destination system. This option does not display any group ID registered from the upper-level system.

-s

Registers an ID group definition file.

To Page Top

Display format

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

[Figure]

To Page Top

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.

To Page Top

Notes

Should a communication error or some other error occur during the operation of registering an ID group definition file, JP1/IT Desktop Management 2 - Agent 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/IT Desktop Management 2 - Agent executes the jobs relevant to the added ID group.
When clearing an ID group, JP1/IT Desktop Management 2 - Agent cancels the installation awaiting jobs on the distribution-destination systems that belong to the cleared ID group.
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.

To Page Top