This repository has been archived by the owner on Nov 16, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 38
/
Copy pathrfp-0003-Log_service.html
211 lines (166 loc) · 5.94 KB
/
rfp-0003-Log_service.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Generator" content="Lotus Word Pro">
<meta name="GENERATOR" content="Mozilla/4.6 [en] (WinNT; I) [Netscape]">
<title>RFP-0003 Log Service RFP (1999-09-16)</title>
</head>
<body bgcolor="#FFFFFF">
<center><table CELLSPACING=0 CELLPADDING=0 WIDTH="719" >
<tr>
<td ALIGN=LEFT VALIGN=CENTER WIDTH="29%"> </td>
<td ALIGN=LEFT VALIGN=CENTER WIDTH="43%"> </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=CENTER>Java Expert Group </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
<td ALIGN=LEFT VALIGN=CENTER>Hargrave </td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=CENTER>Request for Proposal: 0003 </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
<td ALIGN=LEFT VALIGN=CENTER>IBM Corporation </td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=CENTER>Expires 20 days after: (tbd) </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
<td ALIGN=LEFT VALIGN=CENTER>1999-09-16 </td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=CENTER>rfc-0003.html </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=CENTER> </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
<td ALIGN=LEFT VALIGN=CENTER> </td>
</tr>
</table></center>
<center>
<h2>
Java Log Service RFP</h2></center>
<h3>
Status of this Memo</h3>
This document suggests the following extension to the OSGi specification
for the Open Services Gateway Initiative, and requests discussion. Distribution
of this document is unlimited.
<h3>
Abstract</h3>
A key component of the Open Services Gateway Initiative Services Framework[1]
is a Log Service which will provide a Java API to allow Java programs running
in the Framework to write information to the log and also to read entries
from the log. This RFP provides some general goals and guidelines and solicits
technical submissions that will lead to defining a Log Service API for
the Services Framework.
<h3>
Acknowledgment</h3>
The author wants to acknowledge the contributions of the members of the
Connected Alliance and OSGi.
<h3>
Introduction</h3>
The Log Service API defines the set of capabilities needed to allow Java
programs written to run in the Services Framework to write entries to the
log containing various information and for entries to be read from the
log.
<h3>
Motivation and Rational</h3>
For diagnostic and reliability purposes, Java programs written to run on
the Services Framework will wish to write information to a log that can
be examined, if necessary, for problem determination.
<h3>
Technical Discussion</h3>
The Log Service must provide, at a minimum, the following capabilities
and features:
<ul TYPE="disc">
<li>
Ability to record the system time in a log entry.</li>
<li>
Ability to record severity levels in a log entry.</li>
<li>
Ability to record a text message in a log entry.</li>
<li>
Ability to record a Java Throwable object in a log entry.</li>
<li>
Ability to record the identity of the Java program running in the Services
Framework that is related to a log entry.</li>
<li>
The Log Service must provide the ability to read entries from the log by
enumeration and/or subscription.</li>
<li>
The Log Service must capture and convert Services Framework events into
log entries.</li>
</ul>
<h3>
Security Considerations</h3>
As a request for specification proposals, this document has no direct security
considerations. However, the resulting Log Service API may undergo
a security review before approval of the API.
<h3>
References</h3>
[1] Jim Mathis, "Services Framework RFP", OSGi RFP-0001, 1999-09-16, rfp-0001.html
<h3>
Author's Address</h3>
<table CELLSPACING=0 CELLPADDING=5 WIDTH="440" >
<tr>
<td ALIGN=LEFT VALIGN=TOP WIDTH="231">First Name:</td>
<td ALIGN=LEFT VALIGN=TOP WIDTH="179">BJ </td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>Last Name: </td>
<td ALIGN=LEFT VALIGN=TOP>Hargrave</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>Company Name: </td>
<td ALIGN=LEFT VALIGN=TOP>IBM Corporation</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>Company Division: </td>
<td ALIGN=LEFT VALIGN=TOP>Pervasive Computing</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>Street Address: </td>
<td ALIGN=LEFT VALIGN=TOP>11400 Burnet Road</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>City, State, Country, Postal Code: </td>
<td ALIGN=LEFT VALIGN=TOP>Austin, TX USA 78758</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>voice: </td>
<td ALIGN=LEFT VALIGN=TOP>+1 512 838 9938</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>fax: </td>
<td ALIGN=LEFT VALIGN=TOP>+1 512 838 2087</td>
</tr>
<tr>
<td ALIGN=LEFT VALIGN=TOP>e-mail:</td>
<td ALIGN=LEFT VALIGN=TOP>[email protected]</td>
</tr>
</table>
<h3>
Full Copyright Statement</h3>
Copyright (C) The Open Services Gateway Initiative (1999).
<p>All Rights Reserved.
<p>This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it may
be prepared, copied, published and distributed, in whole or in part, without
restriction of any kind, provided that the above copyright notice and this
paragraph are included on all such copies and derivative works. However,
this document itself may not be modified in any way, such as by removing
the copyright notice or references to the Open Services Gateway Initiative.
<p>The limited permissions granted above are perpetual and will not be
revoked by the Open Services Gateway Initiative or its successors or assigns.
<p>This document and the information contained herein is provided on an
"AS IS" basis and THE OPEN SERVICES GATEWAY INITIATIVE DISCLAIMS ALL WARRANTIES,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE
USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
<hr>
<p>Expires 20 days after: (tbd)
</body>
</html>