product introduction - information design · copyright 2001-2006, information design, inc. all...

Information Design, Inc. 1

Copyright, 2001 - 2006

Information Design, Inc.

All rights Reserved.

Product IntroductionProduct Introduction

Copyright 2001-2006, Information Design, Inc. All Rights ReservedCONFIDENTIAL 2

Overview

n Concepts

n What is ObjectQ?

n Management Information Base (MIB)

n Administration

n Legacy System Support

n Future


Basic Concepts

n Client / ServerThe Client/Server model divides the application into Client and Server components. Most business applications can be decomposed into a set of Client and Server Programs.

Client Server

Client sends request to server...

Server sends response to client...

ClientA Client is a software module that in the course of doing its function, requests services from a “Service Provider” (server)

ServerA Server is a software module that provides responses for specific types of requests.


Basic Components Of an Application

n User Interface component handles user input and presentation

n Application component handles Business Rules

n Data Server component provides access to persistent storage

User Interface

Application Processing

Data Management


Multi-Tier Client/Server

n Multi-Tier Logical Architecture

n Physical Architecture Flexible

n Scalable

UserInterface

UserInterface

UserInterface

UserInterface

ApplicationProcessing

ApplicationProcessing

Data Management

Data Management


IPC Communication Mechanisms

Common Object Request Broker Architecture (CORBA)

Remote Procedure Call (RPC)

Message Oriented Middleware (MOM)

On Line Transaction Processing (OLTP)


Message Oriented Middleware

Common Object Request Broker Architecture (CORBA)

Remote Procedure Call (RPC)

On Line Transaction Processing (OLTP)

Message Oriented Middleware (MOM)


Message Queuing

n Processes attach to one or more queues and a “Queuing Engine” in order to send and receive messages.

n Messages are placed in queues which belong to the messaging system rather than passed directly to the receiver.

n The queues store the messages until they can be processed by a receiver.

queue

queue


Advantages of Message Queuing

n Allows independent execution of sending and receiving processes

n Tolerant of process or network failures

n Non-blocking or blocking

n Highly scalable

n Multiple delivery options

n Loosely coupled interconnections


Synchronous Messaging

Client Server

time

line

Send Request 1

Process Request 1

Send Response 1Receive Response 1

Send Request 2

Waiting

Receive Response 2

Process Request 2Waiting

Processing

ProcessingSend Response 1

The client makes a request from the server and then “blocks” waiting for the server’s response.


Asynchronous Messaging

Client Server

time

line

Send Request 1

Send Request 2

Process Request 1

Send Response 1Process Request 2

Receive Response 1

Receive Response 2 Send Response 2

Processing

Processing

The client makes a request from the server but does not wait for the server’s response.


Processing Asynchronous Messages

– If a client process is expecting a response from a server to an asynchronous request, the client process periodically checks to see if a response has been received.

Client ServerSend Request

Process Request

Send Response

ProcessingRequest

time line

Checking for aresponse

n Polling


Processing Asynchronous Messages

– Instead of explicitly checking for a response to an asynchronous request, the client may receive an event or signal that indicates that a response has been received.

Client Server

Send RequestProcess Request

Send Response

ProcessingRequesttim

e lin

e

Receive Response

Event sent to client to indicate that a message

has been received

Client continuesprocessing...

n EventDriven


What is ObjectQ?


Concepts

n ObjectQ objectivesn What is ObjectQ?n Featuresn Management Information Base (MIB)n Message Setn ObjectQ on the Web


Objectives

n To replace the myriad of disparate, pair-wise negotiated, tightly-coupledIPC models with a general purpose, common, loosely-coupledcommunications platform that supports distributed client-server applications


What is ObjectQ?

ObjectQ ObjectQClient Server

Request

Response


What is ObjectQ?

n C++ Library and object-oriented methodologyn Message Based Transport

– External Vendor supplied

n Simple Six Verb API– get, set, create, delete, action, notify

n Management Information Base– Published Interface


ProductFeatures

n Loose coupling– Decouples changes in Clients from Servers and vice

versa

n Transport independence

n Supports different architectures

n MIB defines a standard interface


Architectures

n Client/Server

n Peer-to-peer

n Load balancing

n Synchronous/Asynchronous

n Subscription/Event Notification

n Conversations


Architectures

1

2CClient/

Server

C S1 2

3

Forwarding Server

S

S


Architectures

1 2C S1

Hybrid Server

S

S2

6

53

4


Architectures

12

C

S1Load

Balancing Server

S

S25

43


Architectures

1

2

C SListening

Server

S `3

Fork


Architectures

1

S

Multiple Servers

S`

4

3

S``

2C

C


Architectures

1

2SConversation

S`

4

3

S``

C


MIB

Admin Commands

Class

Service

Attributes

Types

Errors

n MIB is the external specification of a service


Message Set

n Get– Retrieves attributes of a

class

n Set– Modifies attributes of a

class

n Create– Constructs a new

instance of a class

n Delete– Removes an instance of

a class

n Action– Performs an operation on

an instance of a class


On the Web

n ObjectQ Home Page– http://www.idi-middleware.com/objectq/– On-line training and registration– Software distribution– Man pages and other documentation– Sample code– Reference guide– Contact list


Management Information Base

(MIB)


MIB Definition

n Specifies an interface to a ObjectQ service

n Any service that needs to be made available via ObjectQ must provide a MIB


Service

n A service provides access to a collection of objects

n A service is specified in terms of a MIB


Naming

n Names are of the form:“domain_name.entity_name”

n A domain is a scope for names

n Categories that are named:- attribute definitions - classes - services - administrative commands - user types - errors

n Names are unique in a category

customer.nameDomain

PartEntityPart


Registered Names

n Registered names are in the form: a.b.c.d– Each of the letters a,b,c and d represent a

number (0-255)

– a.b represents the domain and c.d represents the unique registered name of the entity

a.b.c.dDomain

PartEntityPart


MIB

n Attribute definitions

n User defined types

n Classes

n Services

n Administrative commands

n Errors

Attributes

Types

Class

Service

Admin

Errors

The map shown below will indicate which sections of the MIB

a slide pertains to by highlighting the correct box.

MAP

Look for this map

in the lowerright-hand corner

of each slide.


Object Model for Demo Service

An aggregation

0 or more

Exactly one

Customer

Account

Bill

Order

Location

generates

processes

ships tobills to


What is an Attribute Definition?

n Has a name and a registered name

n References an associated type

n Can contain a default value (5+)

n Can have a constraint (5+)

Attributes

Types

Class

Service

Admin

Errors


Primitive User Types

n CHAR - One byte character value

n SHORT - Two byte numeric value

n LONG - Four byte numeric value

n STRING - String of characters

n OCTETSTRING - Blobs of data that do not fit into one of the standard types easily

Attributes

Types

Class

Service

Admin

Errors


Non-Primitive User Types

n Constrained Type (5+)

Attributes

Types

Class

Service

Admin

Errors

1. Value must be between a minimumand a maximum supplied value. Max

Min

Value

2. Value must be one of a list of the values.

Value 1

Value 2

Value 3

Value 4

Value n

.

.

.

Value

- Constrains a primitive or constrained type- Constraint is a list of values or minimum

maximum values



n COMPLEX– Unordered aggregate of heterogeneous

attribute definitions

Attributes

Types

Class

Service

Admin

Errors

Date-type

month day year



n ARRAY– Ordered aggregate of homogeneous attribute definitions

Attributes

Types

Class

Service

Admin

Errors

Problem Codes

problem problem


User Defined Types

Name Subtype Associated Typeor AttributeDefinition

Constraints orSymbols

Description Comments

account STRINGitem COMPLEX Demo.product,

Demo.quantity,Demo.price

items ARRAY Demo.itemconstrType1 CONSTR SHORT MIN=1,

MAX=100ConstrainedType

Example 1

constrType2 CONSTR Demo.constrType1 VALUES=10,20 ConstrainedType

Example 2

Domain: Demo

Attributes

Types

Class

Service

Admin

Errors


Attribute Definitions

Name RegisteredName

Type DefaultValue

Constraints Description Comments

account 1.1 Demo.accountamountDue 2.1 LONG 0 in dollarsitem 3.1 Demo.item COMPLEX

valueconstrValue 4.1 Demo.constrType1 VALUES=50 Long

IntegerConstant

ConstantExample

Attributes

Types

Class

Service

Admin

Errors

Domain: Demo


Class Definition

n Attributes

n Instance ID

n Operations

n Instance filters

n Triggers

Attributes

Types

Class

Service

Admin

Errors


Class Definition

Name Registered NameAccount 2.1

Domain: DemoDescription: Defines a customer account

Attributes

Types

Class

Service

Admin

Errors


Attribute

n References an attribute definition

n Can have a default value (5+)

n Can have a constraint (5+) Attributes

Types

Class

Service

Admin

Errors


Instance ID

n The instance id is an attribute that uniquely identifies an instance of a class

n Has to be an attribute of the class or a complex consisting of attributes of the class Attributes

Types

Class

Service

Admin

Errors


Class Attribute Definitions

AttributeDomain

AttributeName

InstanceVariables

DefaultValue

Constraints Comments

Demo accountID XDemo billingLocationDemo billsDemo status ‘A’ VALUES=’A’, ‘I’,

‘C’Active(A)Inactive(I)Closed(C)

DSAP date

Instance ID: Demo.accountID

Attributes

Types

Class

Service

Admin

Errors


Operations On a Class

n Get– Retrieves attributes of

a class

n Set– Modifies attributes of

a class

n Create– Constructs a new

instance of a class

Attributes

Types

Class

Service

Admin

Errors

n Delete– Removes an instance of a

class

n Action– Performs an operation on

an instance of a class


Get Operation

Attribute Domain Attribute Name M/O Constraints CommentsDemo accountID MDemo billingLocation ODemo bills ODemo customer ODemo status ODSAP date O

Confirmed: ALWAYS

Where:M = MandatoryO = Optional

Attributes

Types

Class

Service

Admin

Errors


Create Operation

AttributeDomain

AttributeName

M/O Default DefaultValue


Demo billID MDemo account MDemo amountDue MDemo status O X

Confirmed: ALWAYS


Attributes

Types

Class

Service

Admin

Errors


Actions

n Operations that can be performed on a class

n Assigned a unique positive number

n Optional list of input and output attributesAttributes

Types

Class

Service

Admin

Errors


Action Definition

Name: payBillNumber: 1Description: Pay a customer billConfirmed: Always

AttributeDomain

AttributeName

M/O Default Value Constraints Comments

Demo datePaid O VALUE=TODAYDemo amountPaid M

Inputs

OutputsAttribute Domain Attribute Name M/O Constraints CommentsDemo balance M


Attributes

Types

Class

Service

Admin

Errors


Instance Filters

n Used to specify a subset of instances of a classn Similar to a SQL “where” statementn Each instance filter has a unique positive number

used for identificationn Has an optional list of attributes associated with itn Used with get, set, delete, or action

Attributes

Types

Class

Service

Admin

Errors


Instance Filter Definition

AttributeDomain

AttributeName

Operator M/O DefaultValue


Demo status = M

Number: 1Description: Selection based on bill status


Attributes

Types

Class

Service

Admin

Errors


What are Triggers?

n A client can request to be notified when a particular event occurs. This is referred to as subscribing to an event.

n When an event is triggered, the server notifies the subscriber by sending an “Event Report”. This is referred to as event notification.

1. 2.Client subscribes to an event

When the event occurs, server notifies clientClient

Server Server

Client

Excuse me…“this” just happened

Please tell me when“this” happens


Triggers

n Specifies what event is being subscribed to for a subscription request (action request)

n Has a unique positive number used for identification

n Two types of triggers– Class– Attribute

Attributes

Types

Class

Service

Admin

Errors


Trigger Definition

AttributeDomain

AttributeName

Operator M/O Default Value Constraints Comments

Demo overdueDays >= O 60 MIN=1

Number: 1Type: Attribute TriggerDescription: Notify when bill overdue threshold met or exceeded.


Attributes

Types

Class

Service

Admin

Errors


Trigger Definition

Number: 2Type: Class TriggerDescription: Notify when an instance of “bill” is createdCause: Create


Event Report Request

n Event report request defines the information that is returned when a subscribed-to event, specified in a trigger, occurs.

Client

Server

Event Report Request

Event Report Response (optional)

“Hello client,“this” just occurred...

“Thank-you server”

Attributes

Types

Class

Service

Admin

Errors


Event Report Request Definition

Attribute Domain Attribute Name M/O Constraints CommentsDemo billID MDemo amountDue ODemo dateDue M

Applies to Attribute Trigger(s): 1


Attributes

Types

Class

Service

Admin

Errors


Service Definition

n Specifies classes supported by the service

n Containment trees

n Actions on containment trees

n Instance filters on containment trees

n Triggers on containment trees

n Conversations

Attributes

Types

Class

Service

Admin

Errors


Service Definition

Name Registered NameSales 1.1

Name Registered NameAccount 2.1

Bill 4.1Customer 1.1

Order 3.1

Classes:

Domain: Demo

Attributes

Types

Class

Service

Admin

Errors


Containment Tree

n Specifies traversability between classes

n Has a unique positive number that identifies it

Class 1

Class 2 Class 3

1

1

1

n Attributes

Types

Class

Service

Admin

Errors


Containment Tree Definition

Customer

Account

Order Bill

n

nn

1

1 1

Number: 1

Attributes

Types

Class

Service

Admin

Errors


Service Actions, Instance Filters and Triggers

n Actions, instance filters, and triggers work against one or more containment trees

Attributes

Types

Class

Service

Admin

Errors


Service Action Definition

ClassDomain

ClassName

AttributeDomain

AttributeName

M/O DefaultValue


Demo Customer Demo customerID MDemo Order Demo status O ‘B’

Name: numOrdersNumber: 3Applies to Tree(s): 1Description: Determine the number of orders with a specified order status for a given customerConfirmed: Always

Inputs

OutputsClass

DomainClassName

AttributeDomain

AttributeName

M/O Constraints Comments

Demo numOrders M


Attributes

Types

Class

Service

Admin

Errors


Service Instance Filter Definition

ClassDomain

ClassName

AttributeDomain

AttributeName

Operator M/O

DefaultValue


Demo Customer Demo customerID = MDemo Account Demo status = O ‘A’

Applies to Tree(s): 1Number: 2Description: Find customer accounts by customer ID with a specified account status


Attributes

Types

Class

Service

Admin

Errors


Service Trigger Definition

Type: Attribute TriggerNumber: 3Applies to Tree(s): 3Description: Notify when bill overdue threshold met or exceeded

ClassDomain

ClassName

AttributeDomain

AttributeName

Op M/O DefaultValue


Demo overdueDays

>= O 60 MIN=1


Attributes

Types

Class

Service

Admin

Errors


Service Event Report Definition

ClassDomain

Class Name AttributeDomain

AttributeName


Demo Bill Demo billID MDemo Bill Demo amountDue ODemo Bill Demo dateDue MDemo Account Demo accountID MDemo Customer Demo customerID MDemo Customer Demo name O

Applies to Attribute Trigger(s): 1


Attributes

Types

Class

Service

Admin

Errors


Conversations

n A sequence of messages between the same client and server, during which the server maintains state

Attributes

Types

Class

Service

Admin

Errors


Conversation Definition

MessageNumber

ClassDomain

ClassName

TreeNumber

Get Set Create Delete ActionNumber

Comments

1 1 1 One2 Demo Customer X One3 Demo Account X One or More4 1 2 One

Number: 1Description: Create a customer with one or more accounts

Attributes

Types

Class

Service

Admin

Errors


Administrative Commands

n Used to support commands for non-service related activities

Attributes

Types

Class

Service

Admin

Errors

Client Server

Normal Message Flow

Administrative Command Flow

Out of Band


Administrative Command Definition

AttributeDomain

AttributeName

M/O Default Value Constraints Comments

DSAP echoAttr M

AttributeDomain

AttributeName


DSAP echoAttr M

Name: echoRegistered Name: 100.1Description: A message is sent with an attribute. The receiver replies to the sender,“echoing back” the attribute it receivedConfirmed: Always

Inputs

OutputsAttributes

Types

Class

Service

Admin

Errors


Errors

n Error codes are used to return additional information in the event of a request failure

Attributes

Types

Class

Service

Admin

Errors


Error Definitions

Name RegisteredName

Description Get Set Create Delete Action

101 1.1 No such customer or no customerfound

X X X X

102 1.2 No such account or no accountfound

X X X X

103 1.3 No such order or no order found X X X X104 1.4 No such bill or no bill found X X X XINVSTCODE 1.5 Invalid Status Code X X X X X

Attributes

Types

Class

Service

Admin

Errors


Administration


Administration

n Log files

n Trace files

n regdomain file

n MIB files

n Transaction definition files

n Service Name Resolution files


Log and TraceFiles

n Error logs in cpLOGFILE.<pid>

n Debug trace in cpTRACEFILE.<pid>

n Location controlled by environment variable cpTRACEDIR

n Existence controlled by cpInit() parameter


regdomainFile

n Master list of domain names:

DSAP 1.1

DSTS 2.1

ESCAP 3.1

etc.


MIB Files

n Contained in directory path specified by cpInit()parameter

n .adf Attribute Definition Files (5+ .att, .typ)

n .sdf Service Definition Files (5+ .svc)

n .cdf Class Definition Files (5+ .cls)

n .edf Error Definition Files (5+ .err)


Transaction Definition Files

n .xdf file extension

n Specify attribute-transaction mapping for legacy system access


Service Name Resolution Files

n .snr file extension

n Specify service characteristics:– version number– transport vendor– maximum message size– location(s)– public key for encryption


Legacy Support


Legacy System Support

n ObjectQ supports communications with MVS systems

– Supports IBM side transaction messages

– Provides three transport alternatives:� MQSeries as the underlying transport

� BEA MessageQ to LU6.2 into an IMS region

� QmsgBridge, an MQSeries to DECmessageQ Bridge


MQ Series Transport

UNIX IBM

ObjectQMQ Series

Client Server


BEA MessageQ to LU6.2

IBM

IMS

Server

UNIX

ObjectQ LU6.2Gateway

LU6.2BEA MessageQ

Client


IBM

ObjectQ

Server

QmsgBridge

QmsgBridge

UNIX

ObjectQ

ClientBEA MessageQ MQSeries


Support Hotline

n Phone: (203) 245-3085

n Beeper: (203) 867-3120

n Email: [email protected]

Work Smarter not Harder - - - Call IDI Today!

IDI’s Help Desk:


Future

n Web connectivity

n GUI MIB builder/browser

n Application builders / “Visual ObjectQ”

product introduction - information design · copyright 2001-2006, information design, inc. all...

Documents