14.19.10 JOB_DESTINATION_ID (specifying an ID group)
In the JOB_DESTINATION_ID tag, specify the name of an ID group as the job destination. This tag is used for the dcmcoll, dcminst, and dcmsusp commands.
The following table shows the parameters that can be specified, and their corresponding command arguments:
Parameter |
Content |
Command argument |
---|---|---|
ID group name |
/X ID-group-name |
- Organization of this subsection
(1) Format
JOB_DESTINATION_ID{ destination_id=ID-group-name }
(2) Description
-
destination_id=ID-group-name
Specify a created ID group name. You can also specify an ID-management relay computer to restrict the relay systems or management relay servers on which to execute the ID group job. When specifying the name of an ID-management relay computer, begin the name with a backslash (\). Also, begin the ID group name with \, and the character % immediately before the ID name.
If you do not specify an ID-management relay computer, the job is executed on all the ID-management relay computers that are registered in the specified ID group.
The following shows an example of specifying an ID group name.
destination_id=\dmp202\%ID0001
Note that the name of an ID-management relay computer must be specified according to the ID key for operations defined for that ID-management relay computer.
When specifying multiple ID groups, separate their names by a semicolon (;).You can specify multiple ID groups also by writing destination_id= on multiple lines. You can specify a maximum of 200 ID groups.
(3) Notes
-
You cannot specify the JOB_DESTINATION tag together with the JOB_DESTINATION_ID tag. Also, when using command arguments, you cannot specify /g and /h together with /X.
-
When a parameter file is used for the dcmcoll or dcmsusp command, you cannot specify an ID-management relay computer in the parameter file. If you execute these commands with an ID-management relay computer specified, an error will result.
-
When you specify an ID-management relay computer, make sure that the length of the destination name (including the ID group name) is no more than 256 bytes.
-
If a command is executed with a nonexistent relay system or management relay server specified, a job is created but is not executed.
-
The dcmcoll and dcmsusp commands handle the ID group specified in the destination_id parameter, and create a normal job for the destinations registered in the ID group.