JBoss

JMX MBean View
Back to Agent View Refresh MBean View

MBean description:

Query based Forward Service.
Provides auto-routing of DICOM objects to a remote DICOM application that fulfills criteria defined by an SQL Query.

The SQL statement must be defined with following rules:

1) Series.series_iuid and Series.retrieve_aets must be the first columns of the select statement.
2) The where clause should contain a Series.updated_time.

List of MBean attributes:

Name Type Access Value Description
CalledAETitle java.lang.String RW AE title of the STORE SCP, to which the Dicom objects should be forwarded.
PollInterval java.lang.String RW Interval for polling for series to forward. The interval can be specified in seconds (##s) or minutes (##m). NEVER = disable Forwarding of Dicom objects.
Query java.lang.String RW SQL statement to filter series for forwarding.

Default Query to find series that are stored (series_status=0) and not forwarded (ext_retr_aet is null) and has associated Request Attributes (a reference in series_req):
SELECT DISTINCT series.series_iuid, series.retrieve_aets, series.pk FROM series INNER JOIN series_req ON series.pk = series_req.series_fk WHERE series.series_status = 0 AND series.ext_retr_aet IS NULL AND series.updated_time < ? ORDER BY series.pk
Mote: The first three columns in the SELECT statement must be: series_iuid, retrieve_aets and pk (Series table)!
If limit > 0 the SQL statement is extended with:
1) a database specific LIMIT
2) a 'series.pk > ?' as first criteria in WHERE clause (if sql hasn't already a 'pk > ?')
3) an 'ORDER BY series.pk' (if sql hasn't already a 'ORDER BY')
LastQueryCheckResult java.lang.String R NOT CHECKED Result of last check of Query statement.
If there is an error no automatic forward will be perfromed until the Query is corrected.
Delay java.lang.String RW Delay in seconds (##s), minutes (##m) or hours (##h) for which a series must be unchanged before forward is triggered. Use NONE to disable parameter setting of Prepared Statement! (This would be necessary if your SQL statement doesn't contain a '?')
Limit int RW Limit number of series for forwarding in one step.
This will add database specfic limit statements to the Query! Set this to 0 if the query already contains a limitation.
isRunning boolean R False Current state if a forward task is running. Used to avoid concurrency!
LastSeriesPk long R 0 Last used Series.pk. Used as additional query parameter (SERIES.pk > lastPk) if a Limit > 0 is specified!
ForwardPriority java.lang.String RW Forwarding priority. Enumerated Values: LOW, MEDIUM, HIGH.
TimerIDForwardByQuery java.lang.String RW Used internally. Do NOT modify.
MoveScuServiceName javax.management.ObjectName RW View MBean Used internally. Do NOT modify.
SchedulerServiceName javax.management.ObjectName RW View MBean Used internally. Do NOT modify.
Name java.lang.String R ForwardByQueryService The class name of the MBean
State int R 3 The status of the MBean
StateString java.lang.String R Started The status of the MBean in text form

List of MBean operations:

void create()

Standard MBean lifecycle method

void start()

The start lifecycle operation

void stop()

The stop lifecycle operation

void destroy()

The destroy lifecycle operation

void jbossInternalLifecycle()

The detyped lifecycle operation (for internal use only)

Param ParamType ParamValue ParamDescription
method java.lang.String The lifecycle operation

int checkForward()

Check for series to forward and schedule MOVE requests for these.
Return number of series that are scheduled to be sent to calledAET.

java.lang.String showSQL()

Show actual SQL statement as it will be used to find series.