Understanding status codes

Current Jobs View

Status	Meaning
Opening	The report is being opened for execution.
Processing Page n	The job is running and page n is being formatted.
Executing <trigger name>	The job is running and the specified trigger is being executed.
1,2,3,	The job is in the queue where 1 means that the job will run next.
Canceled	The job has been canceled at the user’s request and will be removed when the engine running it has responded.
Past Jobs View

Status	Meaning
Finished	The job finished successfully.
Terminated with Error	The job finished, but there was an error.
Engine terminated unexpectedly	The job finished, but the engine unexpectedly quit.
Server Shutdown	The job was canceled because the server is shutting down.
Canceled	The job was canceled at the users' request.


Changing queues

To change queues:

1	Choose Queue [image] Go to Queue.

2	Type in the name of the queue or select it from the list.

3	Click OK.


Launching a new job via ActiveX control

To launch a new job:

  Choose Job [image] New.


Removing jobs

To remove a job:

1	Select the job that you want to remove.

2	Choose Job [image] Remove.

3	Accept the confirmation dialog box, if it appears.


Reordering jobs

To reorder a job:

1	Select the job that you want to move.

2	Choose Job [image] Move Up, Move to Top, Move Down, or Move to Bottom.


Rescheduling jobs

To reshedule a job:

1	Select the job that you want to reschedule.

2	Choose Job [image] Reschedule and fill out the Reschedule Job dialog box.

3	Click OK.


jobs,;jobs,copying output
Copying output

To copy output:

1	Select the job for which you want to copy the output.

2	Choose Job [image] Copy Output to and fill out the Copy Job Output To dialog box.

3	Click OK.

Usage Notes

•	You can only copy output for jobs in the Past Jobs view (i.e., jobs that have finished running) that had a Destination of Cache (DESTYPE=CACHE).  Otherwise, the Copy Output to menu item is disabled.


Logging in as the queue administrator

To log in as the queue administrator:

1	Choose Options [image] Privileges [image] Administrator.

2	Type the administrator user ID.

3	Type the administrator password.

4	Click OK.


Configuring the queue

To configure the queue:

1	Log in as the administrator.

2	Choose Queue [image] Properties.

3	You can do the following from Queue Properties:

•	Increase the Max value under Simultaneous Running Engines to maximize the number of runtime engines available.  The more runtime engines available to the Reports Server, the more jobs it can handle.

•	Decrease the Min value under Simultaneous Running Engines to minimize the number of runtime engines being used.  The more runtime engines available to the Reports Server, the more system resources it uses.

•	Decrease the Max idle time setting to shut down unused runtime engines more quickly.

•	If you expect to store the output of many of your reports in the Reports Server cache, you may want to increase the Cache Size setting.  If you do not expect to store a lot of output in the cache and have limited system resources, you may want to reduce the size of the cache.

4	Click OK.


Changing the administrator password

To change the administrator password:

1	Log in as the administrator.

2	Choose Options [image] Change Password.

3	Type the old password.

4	Type the new password.

5	Type the new password again for confirmation.

6	Click OK.


Logging on as another user

To log on as another user:

1	Choose Options [image] Change User.

2	Type the user name.

3	Type the password.

4	Click OK.


Shutting down the queue

To shut down the queue:

1	Log in as the administrator.

2	Choose Queue [image] Shutdown.

3	Choose how you want to shut down (Normal or Immediate).

4	Click OK.


Reports Server Cache

The Reports Server cache can dramatically improve performance.  When you run a report with a destination of cache or tolerance=, a copy of the report output is kept in the Reports Server's cache.  Subsequently, if the same report is run again within a specified amount of time, the output from the cache can be used instead of executing the report again.  For each request to run a report, the tolerance command line argument specifies that if the same report has been started with the same parameters within the specified time tolerance, the current request is recognized as a duplicate job.  When the other job is finished, or if it is already finished, the cached output will be reused.


Opens a new instance of the queue manager.


Displays the Go to Queue dialog box from which you can select a queue to view.


Shuts down the current queue.  You must be logged in as the administrator to shutdown the queue.


Displays the Queue Properties of the current queue.  Unless you are the administrator, the properties are read-only.


Exits the queue manager.


Launches the Reports Server ActiveX control, which enables you to run a report.


Removes the selected job from the queue.


Displays the Copy Job Output To dialog box.  From this dialog box, you can copy the output of the selected job somewhere else.


Displays the output of the selected job.


Displays the Reschedule Job dialog box from which you can specify a new start time and repeat interval for the job.


Submits the selected job to the Reports Server to be re-executed.


Displays the Job Details dialog box for the selected job.  The details include the name, owner, destination, current status, as well as when the job was queued, started, and finished.


Moves the selected job up one spot in the queue.


Moves the selected job to the top of the queue.


Moves the selected job to the bottom of the queue.


Moves the selected job down one spot in the queue.


Displays the jobs that are still waiting in the queue.


Displays the jobs that have already been completed within the interval specified in your preferences.


Displays everyone’s jobs in the current queue.


Displays only your jobs in the current queue.


Displays those jobs that are scheduled to run at certain times.


Displays the owner for each job in the queue.


Displays the destination for each job in the queue (e.g., printer or file).


Displays the name of the destination for each job in the queue (e.g., printer name or filename).


Displays the status information for each job in the queue.


Displays the time when the job was entered in the queue.


Displays the time when the job began execution.


Displays the time when the job completed execution.


Displays the interval at which the job is scheduled to run.


Displays the time when the job was last run.


Displays the time when the job is next scheduled to run.


Sorts the jobs by their name.


Sorts the jobs by their owner.


Sorts the jobs by their destination (e.g., printer or file).


Sorts the jobs by the name of their destination (e.g., printer name or filename).


Sorts the jobs by their status.


Sorts the jobs by when they were entered in the queue.


Sorts the jobs by when they began execution.


Sorts the jobs by when they finished execution.


Sorts the jobs by the interval at which they are scheduled to run.


Sorts the jobs by when they were last run.


Sorts the jobs by when they are next scheduled to run.


Forces the queue manager to contact the server and refresh the information about the jobs in the queue.


Displays the User Preferences dialog box where you can set your preferences for the queue manager.


Specifies that you have normal (non-administrator) privileges in the queue manager.


Displays the Administrator Login dialog box where you can log in as the administrator of the queue.


Displays the Change Administrator’s Password dialog box.


Hides the column your cursor is currently on when you invoke the menu.


Displays the owner for each job in the queue.


Displays the destination for each job in the queue (e.g., printer or file).


Displays the name of the destination for each job in the queue (e.g., printer name or filename).


Displays the status information for each job in the queue.


Displays the time when the job was entered in the queue.


Displays the time when the job began execution.


Displays the time when the job completed execution.


Displays the interval at which the job is scheduled to run.


Displays the time when the job was last run.


Displays the time when the job is next scheduled to run.


About the Reports Queue Manager

This dialog box displays version information about the Reports Queue Manager.


Administrator Login dialog box

This dialog box enables the administrator to log on to the Reports Server queue.  When you have administrator privileges enabled, you can perform administration tasks such as:

•	Change queue configuration.

•	Change administrator password.

•	Shutdown the queue.


Is the administrator password for the Reports Server queue.


Is the administrator username for the Reports Server queue.


Queue Properties dialog box

This dialog box contains the properties for the queue.  If you are not the administrator, this dialog box is solely for informational purposes.  If you are logged in as the administrator, you can change the configuration of the queue.


Is the status of the current queue.


Is the machine on which the current queue is running.


Is the number of jobs currently running.


Is the number of runtime engines available to the Reports Server.


Is the minimum number of runtime engines available to the Reports Server at any time.


Is the date and time that the current queue was started.


Is the amount of the Reports Server's cache that is currently being used in megabytes.


Is the maximum number of runtime engines available to the Reports Server at any time.


Is the amount of time that a runtime engine can be idle before the Reports Server will shut it down.


Is the size of the cache (in megabytes) in which the Reports Server stores output from past jobs.


Immediately empties the Reports Server cache.


Change Administrator Password dialog box

This dialog box enables you to change the administrator password for the Reports Server queue that you are currently viewing.  You must:

•	Enter your current password.

•	Enter your new password.

•	Enter your new password again for confirmation.


Is the old administrator password.


Is the new administrator password.


Is the new administrator password again for confirmation.


View Queue dialog box

This dialog box enables you to specify the queue that you want to view.  This Is useful if you have multiple Reports Server queues and want to switch between them.  You specify a queue by typing a name or choosing from the list.  When you accept the View Queue dialog box, the Reports Queue Manager will contact the specified queue and display its contents.


Is the queue you want to view.


Shutdown Queue dialog box

This dialog box shuts down the current queue.  You have the option of shutting down the queue immediately, but you should only use this option if you don’t care whether queued jobs are not completed and temporary files are not removed.


Shuts down the queue normally.


Shuts down the queue immediately.


Remove Confirmation dialog box

This dialog box comes up when you have requested to delete a job from the queue.  You can accept the dialog box, which will remove the selected job from the queue, or cancel it, which will leave the job in the queue.  If you choose not to have the Remove Confirmation dialog box appear in future, then jobs will be removed as soon as you choose Job [image] Remove.


Means that this dialog box should be displayed in the future when you delete jobs.  If you do not want to see this dialog box when you remove a job, uncheck this setting.


View Queue dialog box

This is the startup dialog box for the Reports Queue Manager.  You can specify the name of the queue you want to view by typing or choosing from the list.  If you do not want to view a queue at startup, click the Skip button.  If you specify a queue, the queue manager will appear with that queue’s contents displayed.  If you do not, the queue manager will appear without a queue’s contents displayed.


Is the queue that you want to view.


Displays this dialog box at startup.  Deselect this to suppress the dialog box in future.


Job Details dialog box

This dialog box provides job information for the selected job.


Is the name of the job.


Is the owner of the job.


Is the destination of the job (e.g., printer or file).


Is the name of the destination of the job (e.g., printer name or filename).


Is the status of the job and, if it is running, what part is currently being executed (e.g., a page number or "Executing Before Report trigger").


Displays additional messages about the job from the Reports Server.


Is the time when the job was entered in the queue.


Is time when the job began execution.


Is when the job completed execution.


Scheduled Job Properties dialog box

This dialog box provides job information for the selected job.


Is the name of the job.


Is the owner of the job.


Is the destination of the job (e.g., printer or file).


Is the destination name of the job (e.g., printer name or filename).


Is the time when the job was last executed.


Is the time when the job will next run.


Is the interval at which the job is run.


Queue Page of Preferences dialog box

This page specifies preferences for the queue.


Is the interval at which the queue manager refreshes the queue information.


Means that you want to be prompted for which queue to view when the queue manager is opened.


Means that the last queue viewed is the one you want displayed when the queue manager is opened.


Means you want to enter a queue name and connect to that queue when the queue manager is started in future.


Past Jobs Page of Preferences dialog box

This page specifies preferences for past jobs that you want displayed in the queue.


Means that all past jobs should be shown in the queue.


Means that only past jobs completed in the last n days should appear in the queue.


Means that only the last n past jobs should be displayed in the queue.


Confirmations Page of Preferences dialog box

This page specifies which warnings you want to see in the queue manager when removing jobs.


Means that a confirmation dialog box should be raised before removing a job from the queue.


Means that a confirmation dialog box should be raised before removing scheduled jobs.


Reschedule Job dialog box

This dialog box enables you to change the parameters of a currently scheduled job or submit a new scheduled job.  If you accept the dialog box, your changes will be applied to the existing job, or, for new jobs, used to create a new one.  If you cancel the dialog box, your changes will be ignored.


Means that you want to schedule the job to run now.


Means that you want to schedule the job to run at the specified date and time.


Is the time when the report will run.  Enter a time or use the up/down buttons to choose one.


Is the date when the report will run.  Enter a date or use the up/down buttons to choose one.


Means the job will run once.


Means that the report will be scheduled to run at a specified interval.


Is the number of times the job will run per unit of time (e.g., if the unit of time is hours and you specify two times, the report will be run every two hours).  Use the up/down arrows to choose a number.


Is the unit of time used to define the interval at which the report will be run (e.g., hours). Use the up/down arrows to choose a unit of time.


Means the job will run monthly on the specified day (e.g., the first Monday of each month).


Is the occurrence of the specified day in which the job will run (e.g., first). Use the up or down arrows to choose the week.


Is the day on which the job will run (e.g., Monday). Use the up or down arrows to choose the day.


Means that the job will run on the last day of each month on or before the specified date (e.g., the last weekday of each month on or before the 15th).


Is the last day in which the job will run (e.g., Monday, weekday). Use the up or down arrows to choose a day.


Is the date on or before which the job will run (e.g., 15th). Enter a date or use the up or down arrows to one.


Is the date on or before which the job will run (e.g., 15th). Enter a date or use the up or down arrows to one.


Means that the server will attempt to rerun a failed job at a specified interval.


Is the number of times to retry running a job after it has failed. Enter a number or use the up or down arrows to choose one.


Is the number of times to retry running a job after it has failed. Enter a number or use the up or down arrows to choose one.


Is the time between scheduled retries that the server will attempt to rerun a job (e.g., 1 hour). Enter a number or use the up or down arrows to choose one.


Is the time between scheduled retries that the server will attempt to rerun a job (e.g., 1 hour). Enter a number or use the up or down arrows to choose one.


Is the unit of time at which the server will attempt to rerun the report (e.g., hours). Use the up or down arrows to choose the unit of time.


User Login dialog box

This dialog box enables you to log on to this restricted Reports Server. Once logged on, you can run and view reports to which you have access privileges.


Is your WebDB username that logs you on to the restricted Reports Server. See your DBA if you are unable to log on.


Is your password. See your DBA if you unable to log on.


Internal Errors

An internal error is an unusual error that could not be diagnosed.  Contact the queue administrator or any system administrators for the machine that the Reports Server is running on to determine the cause of the message, such as a user error or a system problem.  If you determine that the message was not the result of a user error or a system problem, then you should take the following steps:

1	Write down the text of the error or warning message.

2	Write down the circumstances that lead up to the message.  Try to recall the actions you took, the objects involved (if any), and the exact sequence of operations you did prior to the message.

3	Contact Oracle Customer Support.


Invalid username or password

Cause:  The specified username and/or password were incorrect.

Action:  Try retyping the username and password.


Unable to contact the Queue '%1'. It is possible that the Queue is not running or that it is busy. View this queue anyway?

Cause:  The queue could not be contacted.  It may not be running, it may have too many connections, or there may have been a network error.

Action:  To retry the queue, click on Yes and then refresh the viewer (View menu).


Unable to locate the Queue '%1'. Check that it has an entry in your TNSNAMES.ORA file or in Oracle Names.

Cause:  The name of the queue was not found in TNSNAMES.ORA or Oracle Names.  The viewer cannot contact a queue unless it is found in TNSNAMES.ORA or Oracle Names.

Action:  Retype the queue name or contact your system administrator to ensure that the queue is in TNSNAMES.ORA or Oracle Names.


The new and confirmed passwords do not match. Please try typing them again.

Cause:  You have typed two passwords that are not the same.

Action: Please retype both passwords again carefully.


The old password is incorrect.  Password is unchanged.

Cause:  The password could not be changed.  You may have specified an incorrect old password or there was a network error.

Action:  Try retyping the old password again.


Command-line options incorrect. The Queue Manager could not understand your command-line.

Cause:  The command-line options could not be parsed.  The syntax is:

rwqmu60.exe [/q QueueName [/u AdminUsername /w AdminPassword]]

where:

QueueName is the name of the queue you want to view.

AdminUsername is the username of the queue's administrator.

AdminPassword is the administrator's password.

Action:  Check that your command-line fits the above syntax.


The maximum number of engines must be greater than the minimum.

Cause:  The maximum number of engines you typed in is less than the minimum.

Action:  Adjust the minimum or maximum number of engines so that the maximum is larger than the minimum.


Please type the name of the queue you wish to go to or choose one from the list.

Cause:  You did not type or select a queue.

Action:  Choose a queue from the list or type in the name of a queue.


Please enter the name of the queue you wish to open initially or choose one from the list.

Cause:  You did not type or select a queue.

Action:  Choose a queue from the list of most recently visited queues or type in the name of a queue.


Please select only one job.

Cause:  The operation is only valid on a single job.

Action:  Select one job.


Are you sure you want to remove the selected job(s) from the queue?

Cause:  You have selected one or more job(s) to be removed from the queue.

Action:  If you are sure you want to remove them click Yes, otherwise click No.  Clicking on No will return you to the viewer without taking any action.


Are you sure you want to remove the scheduled job(s) from the queue?

Cause:  You have selected one or more scheduled job(s) to be removed from the queue.

Action:  If you are sure you want to remove them click Yes, otherwise click No.  Clicking on No will return you to the viewer without taking any action.


Failed to remove the job from the queue.

Cause:  The job you selected could not be removed from the queue.  The queue may no longer be running, there may have been a network error, or the job may no longer be in the queue.

Action:  To check whether the job is still in the queue click OK and then refresh the viewer (View menu).


Failed to remove the scheduled job from the queue.

Cause:  The scheduled job you selected could not be deleted.  The queue may no longer be running, there may have been a network error, or the job is no longer in the queue.

Action:  To check whether the job is still in the queue click OK and then refresh the viewer (View menu).


At least one of the jobs could not be removed from the queue.  You may want to check that you have permission to remove the...

Cause:  One or more of the jobs you selected could not be removed from the queue.  This may be because the queue is no longer running, there was a network error, you did not have permission to remove the job, or the job(s) are no longer in the queue.

Action:  To check whether the job(s) are still in the queue refresh the viewer (View menu).


At least one of the scheduled jobs could not be removed from the queue.  You may want to check that you have permission to ...

Cause:  One or more of the scheduled jobs you selected could not be removed from the queue.  This may be because the queue is no longer running, there was a network error, you did not have permission to remove the job(s) or the job(s) are no longer in the queue.

Action:  To check whether the job(s) are still in the queue refresh the viewer (View menu).


Attempt to logout as administrator failed. You can retry, go to a different queue, or you can quit the application to ensure...

Cause:  The queue was unable to log you out as administrator.  This may be because the queue is no longer running or there was a network error.

Action:  To ensure that you are logged out you can quit the application.


The administrator's password has been changed.

Cause:  You have successfully change the administrator's password.

Action:  None.


Failed to copy job output.  You should check that the job has finished running without error, and that the destination for ...

Cause:  The job's output could not be copied.  This could be because there was a network error, there was no output for the job (e.g., it must have been run to file to generate an output file), the job's output has been deleted, or you do not have permission to copy it.

Action:  None.


One or more jobs could not be resubmitted to the queue.  You may wish to check that you have permission to resubmit the ...

Cause:  One or more of the jobs you selected could not be resubmitted.  This could be because there was a network error or you do not have permission to resubmit the job(s).

Action:  None.


The connection to Queue '%1'  has been lost.  Either there is a network problem or the queue has been shutdown.

Cause:  The viewer has lost contact with the queue.

Action:  To try re-contacting the queue, refresh the viewer (View menu).


The queue has reached the maximum number of connections.  Either try again later or close an active connection.

Cause:  A queue can only maintain a fixed number of connections.  If another connection, is attempted it will fail.

Action:  You can wait until a connection is dropped by another viewer or you can drop an existing one to which you have access.


An unspecified internal error occurred. This application will terminate.

Cause:  An internal error occurred that could not be handled.  The application will quit when you click OK.

Action:  If the error persists please contact your system administrator.


An unspecified error occurred while the application was initializing.  This application will terminate.

Cause:  An error occurred while the application was initializing that could not be handled.  The application will quit when you click OK.

Action:  If this error persists please contact your system administrator.


One or more jobs could not be moved.  You may wish to check that they are still in the queue and that moving them makes any ...

Cause:  One or more of the jobs you selected could not be moved.  The most likely cause is that they are already at the top or bottom of the queue.  It is also possible that the job is now already running or that it is no longer in the queue.

Action: To check the current position of the jobs in the queue refresh the viewer (View menu).


The job could not be rescheduled.  You may wish to check that it is still in the queue.

Cause:  The job you selected could not be rescheduled.  It is possible that the job is now already running or that it is no longer in the queue.

Action:  To check the current position of the job in the queue refresh the viewer (View menu).


The date and time you specified has already past.  Please specify a later date and time.

Cause:   The date and time specified for the job to run next has already past.  You must specify a starting time that is in the future.

Action:  Edit the time and/or date so that the time is in the future.


Failed to set new queue properties.  One of the values is probably out of range.

Cause:  The Reports Queue Manager tried to set the minimum and maximum number of simultaneous running jobs, and the maximum idle time before engine shutdown, but failed.  It is likely that one of the values is out of range for this queue.

Action:  Retry the operation.  Ask the system administrator for the maximum number of simultaneous running jobs.


The listener at the TNS name is not a Report Server.  Check the entry in the TNSNAMES.ORA file or in Oracle Names.

Cause:  The specified TNS name does not correspond to a Reports Server.

Action:  Check that the TNS name you are using is a Reports Server.


The queue at the specified TNS name is using a different character set you are using, and different enough that conversion ...

Cause:   The NLS_LANG that you are using is sufficiently incompatible with the one that the queue is using that a connection to the queue is not possible.

Action:  Choose a NLS_LANG that enables character-set conversion.


Could not empty cache because you do not have permission to empty it.

Cause:  You attempted to empty the cache, but you do not have administrator privileges.  You must have administrator privileges to empty the cache.

Action:  If you are the administrator, log in as such and empty the cache.


The job could not be rescheduled because of an internal syntax error.

Cause:  An internal syntax error occurred during rescheduling.

Action:  Try submitting a new job via Job [image] New.


Failed to remove the schedule job because you do not have permission to remove it.

Cause:  You tried to remove a job that you do not own and you are not logged in as the administrator.  You must own the job or have administrator privileges to remove the job.

Action:  If you are the administrator, log in as such and remove the job.


Failed to remove the job from the queue because it could not be found on the queue.

Cause:  The job you chose is no longer in the queue.  It may have finished or has been canceled.

Action:  Try checking the Past Jobs view to see if the job is there.


The job could not be rescheduled because of an internal error.

Cause:  The job was not rescheduled because of an unknown internal error.

Action:  None.


Failed to copy job output because either you do not have permission to copy the job output, the job's output was not ...

Cause:  You can only copy the job output if you own the job.  The job's output is stored only if the job's destination was File, Printer, Mail or Cache.  However, if the cache has been emptied or the output of the job has not been accessed recently, the output may have been deleted.

Action:  If you are the owner of the job you can rerun the job to regenerate the output.  If not, you will need to obtain the output from the owner or have them rerun the job.


Could not resubmit one or more jobs because they were not found on the queue.

Cause:  The job was not found in the queue.

Action:  Submit a new job via Job [image] New.


Could not set the Queue properties because of an internal error.

Cause:  The properties could not be set due to an unknown internal error.

Action:  None.


One or more jobs could not be moved because they could not be found on the queue.

Cause:  The job(s) are no longer in the queue.  They may have finished or have been canceled.

Action:  Try checking the Past Jobs view to see if the jobs are there.


Could not set the Queue properties because you do not have permission to set them.

Cause:  You tried to change the queue properties, but you do not have the necessary privileges.  You must have administrator privileges to set the queue properties.

Action:  If you are the queue administrator, log in as such and make the changes.  If you are not the queue administrator, contact the administrator.


Failed to copy job output because the job could not be found on the queue.

Cause:  The job you chose is no longer in the queue and any previous output is no longer accessible.

Action:  Rerun the job to regenerate the output.


Could not resubmit one or more jobs because of an internal syntax error.

Cause:  An internal syntax error occurred during resubmission of the job.

Action:  Submit a new job via Job [image] New.


Failed to copy job output because either the job terminated with an error, it was cancelled or the job has not finished yet.

Cause:  You tried to copy job output that does not exist.  The job does not have any output because it terminated with an error, was canceled, or has not finished running yet.

Action:  If the job is still running, wait for it to finish.


The job could not be rescheduled.  The job may already be running.

Cause:  You attempted to reschedule a job and it could not be done, probably because it is currently running.

Action:  Check the Current Jobs view to see if the job is running.  If it is, wait until it is finished before rescheduling it.


Could not resubmit one or more jobs because you do not have permission to resubmit them.

Cause:  You tried to resubmit a job(s), but you do not have the necessary privileges.  You must own the job or have administrative privileges to resubmit the job.

Action:  If you are the administrator, login as such and resubmit the job.  If not, ask the owner or the administrator to resubmit the job for you.


Login failed because of an internal error.

Cause:  Login could not be completed due to an unknown internal error.

Action:  None.


Could not empty cache because of an internal error.

Cause:  The cache could not be emptied due an unknown internal error.

Action:  None.


Could not resubmit one or more jobs because the queue is shutting down.

Cause:  You tried to resubmit a job while the queue was shutting down.

Action:  When the queue is restarted, submit the job.


Failed to remove the job from the queue because you do not have permission to remove it.

Cause:  You tried to remove a job that you do not own and you are not logged in as the administrator.  You must own the job or have administrator privileges to remove the job.

Action:  If you are the administrator, log in as such and remove the job.  Otherwise, contact the administrator or the owner to have the job removed.


Failed to move one or more jobs because of an internal error.

Cause:  The job could not be moved because of an internal error.

Action:  None.


Could not move requested jobs because only an administrator has permission to move jobs.

Cause:  You tried to move a job in the queue, but you do not have administrator privileges.  You must have administrator privileges to move the job.

Action:  If you are the administrator, log in as such and move the job.  Otherwise, contact the administrator.


The job could not be rescheduled because you do not have permission to reschedule it.

Cause:  You tried to reschedule a job that you do not own and you are not logged in as the administrator.  You must own the job or have administrator privileges to reschedule it.

Action:  If you are the administrator, log in as such and reschedule the job.  Otherwise, contact the administrator.


Failed to copy job output because of an internal error.

Cause:  The job's output could not be copied because of an internal error.

Action:  Contact the administrator for additional help.


The job could not be rescheduled because the queue is shutting down.

Cause:  You tried to reschedule a job while the queue was being shut down.  Jobs cannot be rescheduled while a queue is shutting down.

Action:  Wait until the queue is restarted to reschedule the job.


Could not change the password due to an internal error.

Cause:  The password could not be set due to an unknown internal error.

Action:  None.


Could not resubmit one or more jobs because of an internal error.

Cause:  The job was not resubmitted because of an unknown internal error.

Action:  None.


The job could not be rescheduled because it was not found on the queue.

Cause:  You tried to reschedule a job that was not found in the queue.

Action:  None.


Job could not be removed for an unknown reason.

Cause:  The job could not be removed for a cause that is unknown.

Action:  Contact the administrator for additional help.


About the Reports Queue Manager

The Reports Queue Manager enables you to monitor and manipulate job requests that have been sent to the Reports Server.


Reports Server

The Reports Server is provide to implement a multi-tier architecture for running your reports. The Reports Server enables you to run reports on a remote server.  It can be installed on Windows NT, Windows 95, or Unix.  The Reports Server handles client requests to run reports by entering all requests into a job queue.  When one of the server's runtime engines becomes available, the next job in the queue is dispatched to run.  As the number of jobs in the queue increases, the server can start more runtime engines until it reaches the maximum limit specified when the server process was started. Similarly, idle engines are shut down after having been idle for longer than a specified period of time.

You can also use the Reports Server to run reports automatically.  The Reports Server's scheduling command enables you to specify a time and frequency for the report.  Only non-interactive reports (i.e., a report that is not run to the screen and has the Runtime Parameter Form suppressed) can be submitted to the Reports Server.

The Reports Server keeps track of a predefined maximum number of past jobs.  The time stamps of when they are queued, started, and finished are all kept, as well as the final status of the report.  This information can be retrieved and reviewed from the Reports Queue Manager.


UNICODE

rwqmu60.exe is the UNICODE build of the Reports Queue Manager and should be run when you are in a double-byte environment.  Note that this build will also run in a single-byte environment, but the double-byte environment is where it is actually needed.

Usage Notes

•	Use UNICODE builds of the Reports Queue Manager and the Reports ActiveX control conistently.  For example, if you are using the UNICODE build of the Reports ActiveX control (rwsxu60.ocx), you should also use the UNICODE build of the Reports Queue Manager.  Otherwise, you must ensure that the USER_NLS_LANG environment variable is specified.  If you are using the default US configuration, these restrictions do not apply.

•	UNICODE builds run on Windows NT 4.0 but not on Windows 95.