13.18.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 specify also a relay managing the ID to restrict the relay systems on which to execute the target ID group job. When specifying the name of a relay managing the ID, begin the name with the character \. Also, begin the ID group name with \, and the character % immediately before the ID name.
If you do not specify a relay managing the ID, the target job is executed all the relays managing the ID 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 a relay managing the ID must be specified according to the ID key for operations defined for that relay managing the ID.
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 a relay managing the ID in the parameter file. If a relay managing the ID is specified in the parameter file for the dcmcoll or dcmsusp command and the command is executed, an error will result.
-
When specifying a relay managing the ID, the length of the destination name, including the ID group name, must not exceed 256 bytes.
-
If a command with a nonexistent relay managing the ID is executed, the target 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.