License Monitoring Console

Form ID: (SM604000)

You can use this form to view the limits for system resources specified in your MYOB Advanced license, to monitor the statistics of system resource utilization, and to view warnings, which are displayed if the system exceeds any of the license limits.

License Tab

On this tab, you can view your license status and the limits specified in your license for system resources, according to your license tier.

Element Description
License Status The current status of your MYOB Advanced license. In this box, the system displays one of the following statuses:
  • Invalid: The instance is not licensed and is running in trial mode.
  • Valid: The instance is licensed and has been activated.
  • Expires Soon: The license will expire soon. The number of days before expiration, when this status starts to display, depends on your license settings.
  • Expired: The license and the grace period have both expired, and the instance is running in trial mode.
  • Rejected: The activation of the current instance was canceled because the number of activated instances exceeded the maximum number of instances permitted by the license.
  • Grace Period: The license has expired, but during this time, you can use the instance. The grace period depends on your license settings.
License Tier

The current level of resources specified in your license.

A license tier regulates the amount of system resources that your MYOB Advanced instance can utilize during its use.

Table 1. License Details SectionIn this section, you can find the limitations that are defined by your license tier. If your MYOB Advanced instance regularly exceeds these limitations, you need to discuss an upgrade of your license tier with your MYOB Advanced provider. If any limitations in this section are exceeded, the system displays a warning on the License tab of this form.
Element Description
Monthly Number of Commercial Transactions

The monthly limit specified in your license for commercial transactions conducted in the MYOB Advanced database.

The system counts the number of commercial transactions for each document type and finds the total count among all types for each day. Then the system accumulates the daily commercial transaction count during the calendar month and displays a warning on the Statistics tab if the number of conducted transactions exceeds the license limit. The counter is reset when the next month starts.

Tip: The system regards a transaction as commercial when the transaction creates any of the following entities: sales orders, shipments, accounts receivable invoices, payments, purchase orders, purchase receipts, and accounts payable bills. All requests generated by using the web services API that create data in these documents are also considered commercial transactions.
Monthly Number of ERP Transactions

The monthly limit specified in your license for ERP transactions conducted in the MYOB Advanced database.

An ERP transaction is any transaction in the system that is conducted when a user changes an entity. For example, a user clicks Save on any MYOB Advanced form or initiates mass processing of documents. The system counts each entity change as separate ERP transaction.

The system accumulates the daily ERP transaction count during the calendar month and displays a warning if the number of conducted transactions exceeds the license limit. The counter is reset when the next month starts.

Database Storage Included (GB) The maximum space in the MYOB Advanced database that can be used by your instance. If a user performs an operation that requires a lot of database space (such as creating a snapshot), the system estimates the free database space, and if it is not enough to perform the operation, the system displays an error message and interrupts the operation. For details, see Maintaining Database by Using the Web Interface.
Table 2. Recommended Maximums SectionIn this section, you can find maximum values for system settings, which we recommend you to adhere to for optimal system performance within your license tier.
Element Description
Daily Commercial Transactions

The recommended maximum number of commercial transactions that can be conducted in the MYOB Advanced database per day.

The system counts the number of commercial transactions for each document type and finds the total count among all types. Then the system compares the maximum count of commercial transactions with the limit and displays a warning on the Statistics tab if this count exceeds the license limit. The counter is reset when the next day starts.

Tip: The system regards a transaction as commercial when the transaction creates any of the following entities: sales orders, shipments, accounts receivable invoices, payments, purchase orders, purchase receipts, and accounts payable bills. All requests generated by using the web services API that create data in these documents are also considered commercial transactions.
Daily ERP Transactions

The recommended maximum number of ERP transactions that can be conducted in the MYOB Advanced database per day.

An ERP transaction is any transaction in the system that is conducted when a user changes an entity. For example, a user clicks Save on any MYOB Advanced form or initiates mass processing of documents. The system counts each entity change as separate ERP transaction.

The system counts ERP transactions daily and displays a warning on the Statistics tab if the number of conducted transactions exceeds the maximum number of ERP transactions per day, as specified in your license. The counter is reset when the next day starts.

Concurrent Users

The maximum number of simultaneous user sessions in the system. This limit includes users who sign in by using the mobile app, and does not include API users that are client applications connected to the MYOB Advanced instance.

If multiple user sessions for each user are permitted, each user session is counted.

If this limit has been reached, when an extra user signs in to the system, the user with the earliest sign-in time is forcibly signed out.

Table 3. System Constraints SectionThe constraints listed in this section are regulated by your license tier. The system will prevent users or processes of your MYOB Advanced instance from exceeding the limitations displayed in this section.
Element Description
Maximum Number of Web Services API Users

The maximum number of simultaneously signed-in users whose accounts are used by external applications that may connect to MYOB Advanced by using the web services API.

When an additional user tries to sign in to the system, an error message is displayed and the sign-in process is interrupted.

Maximum Number of Concurrent Web Services API Requests

The maximum number of web services API requests that can be run concurrently by external applications that connect to MYOB Advanced.

Note: Requests that retrieve the status of long operations are not included in this number.

If the limit for the number of concurrent web services API requests has been reached, the next concurrent request is queued and is processed when any previous requests has completed. The request will be declined only if the number of requests in the queue is greater than 20 or the request remains in the queue for more than 10 minutes.

One queue is used for processing of the limit of the number of concurrent requests and the limit of the number of request per minute.

The statistics of the delayed and declined requests can be viewed on the Statistics tab of the form.

Maximum Number of Web Services API Requests per Minute

The maximum number of requests per minute that external applications can send to MYOB Advanced by using the web services API (including sign-in and sign-out requests).

Note: Requests that retrieve the status of long operations are not included in this number.

If the number of requests that have been done in a particular minute reaches 50% of the limit specified for the license, the subsequent requests during this minute are added to the queue and delayed for the following time: 60 seconds minus the number of seconds that have passed since the beginning of the current minute, divided by the remaining number of requests that can be processed in the minute.

For example, suppose that in a particular license, the limit of the number of web services API requests per minute is 50. Since the beginning of the current minute, if the system has already processed 23 requests in 40 seconds and the system receives another request, this request is delayed for (60 – 40) / 27 seconds. After the delay, the request will be processed.

One queue is used for processing of the limit of the number of concurrent requests and the limit of the number of requests per minute.

The request will be declined only if the number of requests in the queue is greater than 20, or the request remains in the queue for more than 10 minutes.

The statistics of the delayed and declined requests can be viewed on the Statistics tab of the form.

Maximum Number of Lines per Transaction

The maximum number of document lines that the system can process within one transaction.

If the number of document lines within a transaction exceeds the limit, the system displays a warning on the Statistics tab.

Maximum Number of Serial Numbers per Document

The maximum number of items with serial numbers that can be included in a document processed by the system.

If the number of items with serial numbers per document exceeds the limit, the system displays a warning on the Statistics tab.

Maximum Number of Employees Paid by Month

The maximum number of employees that can receive paychecks within any month.

If the number of paid employees is approaching or has exceeded the limit, the system displays a warning or an error message on the Warnings tab and on the Constraint History tab next to the value in the Employees Paid by Month (% of Limit) column.

Maximum Number of Staff Members and Vehicles

The maximum number of staff members and vehicles in the MYOB Advanced database permitted for each tenant.

If the number of staff members and vehicles exceeds the limit, the system displays a warning on the Statistics tab.

Maximum Number of Appointments per Month

The maximum number of appointments per month in the MYOB Advanced database permitted for each tenant.

If the number of appointments per month exceeds the limit, the system displays a warning on the Statistics tab.

Maximum Number of Expense Receipts Recognized per Month

The maximum number of pages sent to the recognition service within a month for the MYOB Advanced instance.

If the number of recognized receipts per month exceeds the limit, the system displays a warning on the Statistics tab.

This box is displayed if the Image Recognition for Expense Receipts feature is enabled on the Enable/Disable Features form.

Maximum Number of AP Documents Recognized per Month (pages)

The maximum number of pages sent to the recognition service within a month for the MYOB Advanced instance.

If the number of recognized pages per month exceeds the limit, the system displays a warning on the Statistics tab.

This box is displayed if the AP Document Recognition Service feature is enabled on the Enable/Disable Features (CS100000) form.

Maximum Number of Business Cards Recognized per Month

The maximum number of cards sent to the recognition service within a month for the MYOB Advanced instance.

If the number of recognized cards per month exceeds the limit, the system displays a warning on the Statistics tab.

This box is displayed if the Image Recognition for Business Cards feature is enabled on the Enable/Disable Features form.

Maximum Number of Bank Feed Accounts

The maximum number of cash accounts mapped to bank accounts (in all bank feeds for all tenants) that is supported by the current license.

If the number of the bank feed accounts exceeds the limit of the current license, the system displays a warning message on the Warnings tab.

This box is displayed if the Bank Feed Integration feature is enabled on the Enable/Disable Features form.

Statistics Tab

On this tab, you can see detailed statistics of system resource use by month and by day. If any value exceeds a license limit, the system displays a warning for this parameter. To see statistics by day for a particular month, you can click the month in the Monthly Statistics table. To open the Transaction Details dialog box, you double-click the needed row in the table.

Table 4. Monthly Statistics TableIn this table, you can see statistics for commercial and ERP transactions by month.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Column Description
Month The calendar month and year. You can click a row with a month to display information about that month in the Daily Statistics table.
Commercial Transactions (% of Limit) The current number of commercial transactions conducted in the month. The percentage of the monthly limit is displayed in parentheses.
ERP Transactions (% of Limit) The current number of ERP transactions conducted in the month. The percentage of the monthly limit is displayed in parentheses.
Table 5. Daily Statistics TableIn this table, you can find daily statistics for transactions and API requests for the month selected in the Monthly Statistics table. (When you initially open the form, the current month is selected in the Monthly Statistics table, so the Daily Statistics table shows the days of the current month.)

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Element Description
Date The calendar date for which daily statistics are displayed.
Commercial Transactions (% of Limit) The current number of commercial transactions conducted during the day. The percentage of the daily limit is displayed in parentheses.
ERP Transactions (% of Limit) The current number of ERP transactions conducted during the day. The percentage of the daily limit is displayed in parentheses.
Peak Number of Web Services API Requests per Hour (% of Limit) The peak number of requests per hour generated by external applications that connect to MYOB Advanced by using the web services API during the day. The percentage of the daily limit is displayed in parentheses.
Declined API Requests (% of All) The number of web service API requests that were declined by the system during the day because the license limit was exceeded. The percentage of delayed API requests among all API requests per day is shown in parentheses.
Total Delayed API Requests (% of All) The total number of web service API requests that were delayed by the system during the day because the license limit was exceeded. The percentage of delayed API requests among all API requests per day is shown in parentheses.
API Requests Delayed Due to Concurrency (% of All) The number of web service API requests that were delayed by the system during the day because the license limit for concurrent API requests was reached. The percentage of delayed due to concurrency API requests among all API requests per day is shown in parentheses.
API Requests Delayed Due to Frequency (% of All) The number of web service API requests that were delayed by the system during the day because 50% of the license limit for the number of API requests processed per minute was reached. The percentage of delayed due to frequency API requests among all API requests per day is shown in parentheses.
Table 6. Transaction Details Dialog BoxIn this dialog box, you can see detailed information about commercial and ERP transactions conducted in the system for the date selected in the Daily Statistics table or for the month selected in the Monthly Statistics tab.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Element Description
Selection area
Period Type The type of period for which detailed information about transactions is displayed in the table, which can be one of the following: Daily or Monthly.
Transaction Type The type of transactions to display in the table for the selected period, which can be one of the following: Commercial or ERP.
From The start date of the date range for which the system displays the list of transactions in the table.
To The end date of the date range for which the system displays the list of transactions in the table.
Statistics per Screen tab: Table columns
Period The exact date of the transaction, if the Daily option is selected in the Period Type box, or the month when the transaction occurred if the Monthly option is selected in the Period Type box.
Screen The MYOB Advanced form that generated commercial transactions. The following forms generate commercial transactions:
Action Type The type of the action that occurred, which can be one of the following: UI, API, Import/Export scenarios, or Automation Schedule.
Transaction Count The number of commercial transactions generated by the form displayed in the Data Type column during the selected day.

Document Details tab

The tab is available if the ERP option is selected in the Transaction Type box.

Upper table columns

The table displays the number of transactions generated by user action that occurred at particular day and time on a form.

Registered At (UTC) The date and time when the action occurred.
Screen ID The MYOB Advanced form where the action that generated ERP transactions occurred.
Action The action that generated ERP transactions.
Action Type The type of the action that occurred, which can be one of the following: UI, API, Import/Export scenarios, or Automation Schedule.
Number of Transactions The number of ERP transactions generated by the action.

Lower table columns

The table displays the list of records affected by the transactions in the row selected in the upper table.

Document Type The type of the record affected by the transactions in the row selected in the upper table.
Document Link The identifier of the affected record. You can cllick the link to review the record's settings.

Warnings Tab

On this tab, you can view the warnings that have appeared when the system has exceeded the limits for resources specified in your license. Warning messages are also displayed on the Statistics tab.

Note: If you see a number of warnings on this tab, this means that you need to raise your license tier. To do this, please contact your license provider.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Column Description
Status The status of the license tier excess. In this column, the system displays one of the following values:
  • Active: The excess has not been dismissed.
  • Dismissed: The excess has been dismissed on the license server.
Note: Excesses can be dismissed by your license provider on the licensing server.
Date The date when the license tier excess has been logged.
Limit Type The type of license limit that has been exceeded.
Data Type The type of data whose limit has been exceeded.
License Limit The limit that was specified in your license at the time the license tier excess was logged.
Dismissed On The date when the license tier excess was dismissed. This column is empty for active excesses.
Comment Additional information about the license tier excess, such as the reason it was dismissed. This information is filled in automatically by the system.

Constraint History Tab

On this tab, you can view daily statistics for constraints (such as fixed assets and business accounts) divided by tenants, with one row per tenant per day.

Table 7. Table Toolbar

The table toolbar includes standard buttons and buttons that are specific to this table. For the list of standard buttons, see Table Toolbar. The table-specific buttons are listed below.

Element Description
Per Tenant A check box that indicates (if selected) that the system displays metrics split by tenants. If the check box is selected, you can view the tenant identifier in the Tenant ID column, which appears in the table.
Recognition History

Navigates to the Recognition History (SM604015) inquiry form with the time period filled in by the system. On the form, you can review the history of the recognized operations.

The button is available if any of the following features are enabled on the Enable/Disable Features (CS100000) form:

  • Image Recognition for Business Cards
  • Image Recognition for Expense Receipts
  • AP Document Recognition Service
Table 8. Table ColumnsIn these columns, you can view the system-inserted constraints.
Column Description
Date The date when the system calculated statistics for constraints. The system calculates constraint statistics once a day.
Tenant ID The identifier of the tenant for which the constraint metrics are listed.
Fixed Assets (% of Limit) The number of fixed assets that exist in the MYOB Advanced database for the tenant on this day. The percentage of the limit in your license for fixed assets is displayed in parentheses.
Inventory Items (% of Limit) The number of inventory items that exist in the MYOB Advanced database for the tenant on this day. The percentage of the limit in your license for inventory items is displayed in parentheses.
Business Accounts (% of Limit) The number of business accounts that exist in the MYOB Advanced database for the tenant on this day. The percentage of the limit in your license for business accounts is displayed in parentheses.
Employees Paid by Month (% of Limit)

The number of employees paid during the current calendar month. The percentage of the limit in your license for paid employees is displayed in parentheses.

If the number of paid employees is approaching or has exceeded the license limit, a warning or an error message is displayed next to the value.

AP Documents Recognized by Month (% of Limit)

The number of recognized AP documents during the current calendar month. The percentage of the limit in your license for recognized documents is also displayed in parentheses.

You can click the Recognition History button on the table toolbar to review the history of recognition operations on the Recognition History form.

If the number of recognized documents is approaching or has exceeded the license limit, a warning or an error message is displayed next to the value.

Expense Receipts Recognized by Month (% of Limit)

The number of recognized expense receipts during the current calendar month. The percentage of the limit in your license for recognized receipts is also displayed in parentheses.

You can click the Recognition History button on the table toolbar to review the history of recognition operations on the Recognition History form.

If the number of recognized receipts is approaching or has exceeded the license limit, a warning or an error message is displayed next to the value.

Maximum Number of Business Cards Recognized per Month (% of Limit)

The number of recognized business cards during the current calendar month. The percentage of the limit in your license for recognized cards is displayed in parentheses.

You can click the Recognition History button on the table toolbar to review the history of recognition operations on the Recognition History form.

If the number of recognized cards is approaching or has exceeded the license limit, a warning or an error message is displayed next to the value.

Active Bank Feeds (% of Limit)

The number of cash accounts mapped to bank accounts in the bank feeds per tenant (if the Per Tenant check box is selected) or for all tenants (if the Per Tenant check box is cleared). In parentheses, the percentage of the limit from the applicable license is shown.

This column appears on the form if the Bank Feed Integration feature is enabled on the Enable/Disable Features form.