Managing Ensemble Productions - InterSystems Documentation

More documents

Recommendations

Info

What to Manage Event Log Task Filter event log entries for the currently running production by entering search criteria such as time of day or session identifier. Purge event log entries. Quickly view the real-time status of the event log. View the event log entries generated by the currently running production. Sequence of Portal Commands Event Log, Filter Event Log, Purge System Monitor Event Log Not all errors or activities should necessarily generate an event log entry. Developers of custom code determine which abnormal occurrences a host class will write to the event log. Once a production is running, only those events can be monitored. It is up to the developer to choose which occurrences will be of interest to enterprise system administrators. The only way to cause the production to report additional new types of event is to rewrite its host classes using Ensemble Studio. However, you can use the Ensemble Management Portal to control what you see in the event log in another way: You can filter the event log to exclude all entries except those of special interest to you. 3.8 Working with the I/O Archive All business services and business operations have a configuration setting called Archive IO. If True, the adapter associated with this business host logs in the Ensemble I/O archive each input and output communication it shares with the external system. I/O Task Configure the Archive IO setting for a business operation. Configure the Archive IO setting for a business service. Sequence of Portal Commands Productions, Configure, Business Operation Productions, Configure, Business Service To retrieve information from the Ensemble I/O archive, you must execute an SQL query, as follows: 1. Start the System Management Portal. 2. Navigate to the [Home] > [SQL] page. 3. Choose the namespace where you want to execute the query. 4. Click Execute SQL Statement. The [Home] > [SQL] > [Execute SQL Query] page displays. 5. In the SQL Query field, type: SELECT * FROM Ens_Util.IOLog Where the table name identifies Ens.Util.IOLog or one of its subclasses. The choice of subclass depends on the type of data. Options include Ens.Util.IOLogFile, Ens.Util.IOLogObj, Ens.Util.IOLogStream and Ens.Util.IOLogXMLObj. 6. Click Execute Query. The results display in the bottom half of the page. 7. If there are no results, or if the results do not match your expectations, check to see that the Archive IO option is enabled for the business service or business operation that you want to investigate. 34 Managing Ensemble Productions
Working with Jobs 3.9 Working with Jobs Jobs are CPU processes that host the work done by an Ensemble production. This terminology is intended to avoid confusion between CPU processes (“jobs”) and business processes (“processes”). From a low-level, system viewpoint, an Ensemble production consists almost entirely of jobs waiting to wake up to perform work. When a request arrives on the queue of a business host, the item claims a job from its pool of available jobs. The job then hosts the work that needs to be done. If no job is available in the pool of jobs for that business host, it must wait for a job to become available, so that it can do the work. The job returns to the pool after the work is done, or whenever the next task is to wait for something to happen. A job always returns to the same pool from which it came. The choice of Actor Pool Size for the production, and Pool Size for each business host, determines how many jobs are available to perform which types of work for the production. These numbers are an essential part of the production design and are unlikely to need adjustment once the production is deployed live. Larger numbers are not necessarily helpful; most pool sizes are best set to either 0 or 1. For a full discussion of appropriate values for different types of production, see the Pool Size section in the “Production Concepts” chapter of Developing Ensemble Productions. The following portal commands are available to configure and monitor job use in a production. Job Task Configure the number of jobs allocated to a specific business operation within a production. Configure the number of jobs allocated to a specific business process within a production. Configure the number of jobs allocated to a specific business service within a production. Configure the number of jobs allocated to be shared publicly by business processes. Monitor status of system jobs associated with various production activities. Sequence of Portal Commands Productions, Configure, Business Operation Productions, Configure, Business Process Productions, Configure, Business Service Productions, Configure, Production Jobs 3.9.1 Jobs Page The [Ensemble] > [Jobs] page allows you to match each Ensemble configuration item with the underlying system job(s) that are hosting its activities. The Jobs page lists the system Job ID number for each configuration item. You can use this information to look up detailed information about the job in the System Management Portal. The same Process ID number appears in the left-most column of the System Management Portal [Home] > [Processes] page. To display the Jobs page, click Jobs in the Ensemble Management Portal main menu. There is no menu on the Jobs page. You can return to the home page by clicking [Ensemble] in the title bar navigation path. At far right, the title bar provides a Namespace list that you can use to switch to a different Ensemble namespace. There is also a Go to list that you can use to return to previously visited pages in the Ensemble Management Portal or System Management Portal. Under the Jobs page title bar is a table called Current Ensemble Processes. Each row of the table lists one of the system jobs that is doing work for the currently running Ensemble production. Each row has the following columns: • Job — The system process ID for the job. • Configuration Name — This is the name assigned to the business host during configuration using the [Ensemble] > [Productions] configuration display. It may be different from the host class name. Managing Ensemble Productions 35
Page 1 and 2: Managing Ensemble Productions Versi
Page 3 and 4: Table of Contents About This Book .
Page 5 and 6: 9.1 Business Process List .........
Page 7: List of Tables Table 1-1: Ensemble
Page 11 and 12: 1 Ensemble Management Portal This c
Page 13 and 14: Login 1.3 Login The Ensemble Manage
Page 15 and 16: Ensemble Home Page • Jobs — lis
Page 17 and 18: Ensemble Home Page If you click the
Page 19 and 20: Portal Command Summary Page or Comm
Page 21: Portal Command Summary Page or Comm
Page 24 and 25: Management Tasks Task View Alternat
Page 26 and 27: Management Tasks Monitor... Message
Page 28 and 29: Management Tasks 2.9 Viewing Items
Page 30 and 31: What to Manage Production Task Purg
Page 32 and 33: What to Manage • Business process
Page 34 and 35: What to Manage the item to be stopp
Page 36 and 37: What to Manage For example, an item
Page 38 and 39: What to Manage Each dashboard is as
Page 40 and 41: What to Manage At far right, the ti
Page 44 and 45: What to Manage • Mode — The exe
Page 46 and 47: What to Manage 3.10.2 Messages in P
Page 48 and 49: What to Manage Workflow Task Manage
Page 50 and 51: Productions • Last Stop Time —
Page 52 and 53: Productions If you click this comma
Page 54 and 55: Configuration • Configuration Dia
Page 56 and 57: Configuration The Copy command is u
Page 58 and 59: Configuration 5.1.4 Status Indicato
Page 60 and 61: Configuration When you click Apply
Page 62 and 63: Configuration Column Value Source D
Page 64 and 65: Configuration Beneath the row of co
Page 66 and 67: Configuration From the Production C
Page 68 and 69: Configuration Adapter Class The cla
Page 70 and 71: Configuration Adapter SETTINGS Belo
Page 73 and 74: 6 System Monitor The [Ensemble] > [
Page 75 and 76: 7 Event Log The [Ensemble] > [Event
Page 77: Event Log Purge • Click Reset to
Page 80 and 81: Message Browser • Session — The
Page 82 and 83: Message Browser Some business opera
Page 84 and 85: Message Browser • The segment nam
Page 86 and 87: Message Browser When you have selec
Page 88 and 89: Message Browser If the Color By sel
Page 90 and 91: Message Browser Table 8-2: Options
Page 92 and 93:
Message Browser Operator > >= < , >
Page 94 and 95:
Message Browser 8.3.1 Resend Editor
Page 96 and 97:
Business Processes 9.2 BPL Viewer T
Page 98 and 99:
Business Processes - Includes — A
Page 100 and 101:
Business Processes • SessionId
Page 103 and 104:
10 Host Monitor The [Ensemble] > [H
Page 105 and 106:
Monitor Instances To the right of e
Page 107 and 108:
11 Queues The [Ensemble] > [Queues]
Page 109 and 110:
Message Details this value is the s
Page 111 and 112:
12 Maintenance The [Ensemble] > [Ma
Page 113 and 114:
Purge Management Data To the right
Page 115 and 116:
Credentials • Do not purge most r
Page 117 and 118:
Lookup Settings When the Run Archiv
Page 119 and 120:
Enterprise Message Bank Click Save
Page 121 and 122:
Enterprise Message Bank • The Mes
Page 123:
Enterprise Message Bank Pattern cha
Page 126 and 127:
Testing Service Enable Testing If t
Page 129 and 130:
14 EDI / HL7 Manager The [Ensemble]
Page 131 and 132:
Index A actor pool and jobs, 35 and
Page 133 and 134:
starting, 4 tasks to perform, 15 En
Page 135 and 136:
R Reply Code Actions field, 61, 62
show all

Managing Ensemble Productions - InterSystems Documentation

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?