Schema seven-config.xsd


schema location:  seven-config.xsd
targetNamespace:  http://www.cheiron.org/seven-config
 
Elements  Complex types  Simple types 
container  bind-address  log-level 
ext-configuration  configuration 
jsc-unit  connector 
console-handler 
context-filter 
discovery 
file-handler 
forward-handler 
grant 
jarserver 
jeri-connector 
jeri-http 
jeri-tcp 
join-scope 
level-filter 
locator 
log-filter 
log-handler 
logger 
mail-handler 
message-filter 
permission 
proxy-preparer 
service-group 
service-instance 
socket-handler 
syslog-handler 
throwable-filter 


schema location:  http://www.cheiron.org/schema/jsc.xsd
targetNamespace:  http://www.cheiron.org/jsc
 
Elements  Complex types  Simple types 
jsc-descriptor  config-def  expr-category 
description  numeric-oid 
description-group  version-number 
display-name 
entry 
expr 
expr-ref 
expr-value 
grant-def 
help-message 
i18n-content 
icon 
permission 
service-def 
service-group-def 


schema location:  http://www.w3.org/2001/xml.xsd
targetNamespace:  http://www.w3.org/XML/1998/namespace
 
Attr. groups 
specialAttrs 


element container
diagram
namespace http://www.cheiron.org/seven-config
properties
content complex
children help config-def jarserver logger connector proxy-preparer discovery join-scope expr-value jsc-unit-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
version  NMTOKEN      
documentation 
Version number for schema that defines this container configuration.
instance-id  NCName  master    
documentation 
Identifier of container service instance.

In case the container installation is shared between multiple configurations, as allowed by the start scripts. Each configuration must have a container service with an identifier that is unique within the context of the installed container.
file-poll  unsignedShort  3    
documentation 
Time in seconds the configuration files are checked to see whether they have been updated by external means.

Checking the configuration file for updates by external means can be disabled by setting the poll time to 0 seconds.
install-uri  normalizedString      
documentation 
URI to root of the location the container will install the service definitions and that can be used to place SAR files in that needs to installed when Seven starts.

The URI has to be a file URI, or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in is consider the root directory for resolving purposes.	
log-uri  normalizedString      
documentation 
URI to the root of the location the container will store log files for the service instances.

The URI has to be a file URI, or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in is consider the root directory for resolving purposes.	
data-uri  normalizedString      
documentation 
URI to the root of the location the container will write the runtime data for the service instances.

The URI has to be a file URI, or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in is consider the root directory for resolving purposes.	
platform  NCName  jsc    
documentation 
Platform API expected to be available at clients using services deployed by the container.
security-level    MEDIUM    
documentation 
Controls the security level used when grants are configured by the XML configuration plugin when new service group definitions and service instances are created.

This attribute doesn't control inherent security of the container, only the default values for the configuration elements created by the plugin.
secure-random  boolean  true    
documentation 
Controls whether a cryptographically strong pseudo-random number generator will be used for creating unique IDs.

The main reason to set this attribute to false is to minimize startup times for development purposes in case the OS doesn't have a random device.
shutdown-time  unsignedShort  120    
documentation 
Time in seconds the container is willing to wait to let the shutdown sequence finish in case of a container destroy.

In case the shutdown sequence hasn't finished within time a forced JVM exit will take place.
codebase-uri-prefix  anyURI      
documentation 
Absolute URI prefix used for the codebase annotation URL when marshalling objects and when not overridden at another level.

The service specific part will be added to the prefix provided. If the prefix doesn't end with a path separator the container will add one before adding the service specific part.

If not specified the codebase annotation will be based on the data provided for the configured JAR file server, if any.
annotation-protocol    http    
documentation 
Protocol used in codebase annotation when marshalling objects.

Setting this value to httpmd enables JAR file integrity verification to be performed by the receiving party. When the codebase-uri-prefix is set this attribute will enable httpmd for codebase annotations when the scheme of the codebase-uri-prefix equals 'http'.
annotation-algorithm  NMTOKEN  sha1    
documentation 
Name of message digest algorithm used for calculating of a message digest for the download JAR files.

The default algorithm being used in case of httpmd is SHA-1. The container will support all algorithms listed in the Java Cryptography Architecture API Specification and Reference, others can be obtained by installing the right crypto plugins for your J2SE platform.

Note: algorithm names are not case-sensitive.
annotation
documentation 
Jini Service Container configuration, provides access to all service definitions and instances.

element container/help
diagram
namespace http://www.cheiron.org/seven-config
type jsc:help-message
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
ref-id  NCNamerequired      
documentation 
Identifier refering to element this is a help message for.
annotation
documentation 
Help messages for expressions introduced at this level.

element container/config-def
diagram
namespace http://www.cheiron.org/seven-config
type jsc:config-def
properties
isRef 0
content complex
mixed true
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
annotation
documentation 
Provides configurable objects for container.

element container/jarserver
diagram
namespace http://www.cheiron.org/seven-config
type seven:jarserver
properties
isRef 0
content complex
children bind-address alias
attributes
Name  Type  Use  Default  Fixed  Annotation
port  unsignedShort  0    
documentation 
Port number the JAR file server will accept incomming request on, if the port number is '0' the container will use a free random port number.

Note that a random port number won't provide durable codebase annotations, i.e. download JAR files won't be accessible after a restart of the container. You are advised to pick a fixed and free port number for long lived deployments.
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the codebase annotation URL to be used when marshalling classes and when not overridden at another level.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for the codebase annotation URL. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to this JAR file server and for non LAN environments.
inbound-port  unsignedShort      
documentation 
Port number to use in the codebase annotation URL to be used when marshalling classes.

If not specified the container will use the port number the JAR file server has been bound to. This option can be used in case JAR file serving must be performed by a proxy web server that proxies to the internal JAR file server.
annotation
documentation 
Internal JAR file server wil be used for serving the download JAR files of the installed services.

If no JAR file server is configured you must specify the codebase-uri-prefix at the container or service level.

element container/logger
diagram
namespace http://www.cheiron.org/seven-config
type seven:logger
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter console-handler file-handler socket-handler syslog-handler mail-handler forward-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
name  string      
documentation 
Name for this logger, if not specified it will serve as the root logger within the context this logger is being used.
level  seven:log-level      
documentation 
Minimum log level this logger should take care of.

In case no level is specified the level of the logger must be inherited from its nearest ancestor with a specific (non-null) log level.
delegate  boolean  true    
documentation 
Indicates whether this logger should send its output to it's parent logger.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
protected  boolean  true    
documentation 
Indicates whether the logger accepts forwarded log records from a forward handler or is protected.

True doesn't allow for forwarding from a forward handler in another namespace, only allows forwarding from within the same namespace. False does allow for forwarding from another namespace.
annotation
documentation 
Provides logger configuration for the container and sets basic logging behaviour for any deployed services.

Many third party libraries used within JSC Services don't have the notion of the JSC logging API but use fixed named loggers, this allows to control them.

element container/connector
diagram
namespace http://www.cheiron.org/seven-config
type seven:connector
properties
isRef 0
content complex
children jeri-tcp jeri-http free-connector
attributes
Name  Type  Use  Default  Fixed  Annotation
durable  boolean  false    
documentation 
Indicates whether the connector is durable, meaning that even after restarts of the service clients that have a reference are able to talk to that service.

This attribute only has a meaning effect when the port number is fixed, or in general when existing endpoints will be able to connect to the server endpoint when the service restarts.
annotation
documentation 
Connector that serves as the default connector for a service when not overridden at the service level.

For the standard connectors there are no additional grants required, these are taken care of by the container.

element container/proxy-preparer
diagram
namespace http://www.cheiron.org/seven-config
type seven:proxy-preparer
properties
isRef 0
content complex
children constraints grant
attributes
Name  Type  Use  Default  Fixed  Annotation
verify-trust  boolean  false    
documentation 
Indicates whether to verify if proxies are trusted.
annotation
documentation 
General proxy preparer that serves as the default proxy preparer when not overridden at the service level that is used for proxy preparation of service proxies obtained through ServiceFinder.

This proxy preparer can be overridden at the service level and programmatically by the JSC Service.

element container/discovery
diagram
namespace http://www.cheiron.org/seven-config
type seven:discovery
properties
isRef 0
content complex
children multicast-interfaces constraints proxy-preparer
attributes
Name  Type  Use  Default  Fixed  Annotation
protocol-version  int      
documentation 
Controls the version of the multicast request and unicast discovery protocol used, if not specified the protocol version used will depend on whether there are any required or preferred constraints specified.

Setting the protocol version is only recommended in case the lookup services to contact don't support particular versions of the discovery protocol, otherwise the most efficient protocol will be selected.
multicast-request-host  NMTOKEN      
documentation 
The host name to include in multicast requests if participating in version 2 of the multicast request protocol.
multicast-ttl  int      
documentation 
The time to live (TTL) value set on outgoing multicast request packets.
unicast-socket-timeout  int  15000    
documentation 
The read timeout in milliseconds set on sockets over which unicast discovery is performed.
unicast-connection-timeout  int  15000    
documentation 
The connection timeout in milliseconds set on sockets over which unicast discovery is performed.
annotation
documentation 
Controls the discovery protocols, both multicast as unicast, that serves as the default when not overridden at the service level, that is used by service finders as well as for the join management.

element container/join-scope
diagram
namespace http://www.cheiron.org/seven-config
type seven:join-scope
properties
isRef 0
content complex
children member-group locator-uri locator constrainable-locator
annotation
documentation 
Scope for lookup services the service will be registered with that serves as the default when not overridden at the service level.

In case no scope is provided here this is equivalent to DiscoveryScope.VOID.

element container/expr-value
diagram
namespace http://www.cheiron.org/seven-config
type jsc:expr-value
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
expr-id  NCNamerequired      
annotation
documentation 
Provides expressions values for configuration and connector definitions.

element container/jsc-unit-ref
diagram
namespace http://www.cheiron.org/seven-config
type jsc:numeric-oid
properties
isRef 0
content simple
facets
pattern [0-9]+(\.[0-9]+)+
annotation
documentation 
Collection of OIDs for JSC Service Definitions and Instances.
documentation 
Collection of OIDs for JSC Service Definitions and Instances.

element ext-configuration
diagram
namespace http://www.cheiron.org/seven-config
properties
content complex
children config-def
annotation
documentation 
Defines an external configuration source.

element ext-configuration/config-def
diagram
namespace http://www.cheiron.org/seven-config
type extension of jsc:config-def
properties
isRef 0
content complex
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
annotation
documentation 
Configuration source that provides additional entries.

element jsc-unit
diagram
namespace http://www.cheiron.org/seven-config
properties
content complex
children service-group
attributes
Name  Type  Use  Default  Fixed  Annotation
oid  jsc:numeric-oidrequired      
documentation 
Refers to the OID of the JSC deployment descriptor.
version  NMTOKEN      
documentation 
Version number for schema that defines the JSC unit configuration.
annotation
documentation 
Defines the deployment unit of a JSC deployment descriptor.

element jsc-unit/service-group
diagram
namespace http://www.cheiron.org/seven-config
type seven:service-group
properties
isRef 0
content complex
children help jar-pool grant configuration service-instance
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNamerequired      
documentation 
Identifier of service group, must be unique within context of JSC unit.
security-domain-ref  NCName      
documentation 
Identifier of security domain the service group is associated with.
version  jsc:version-number      
documentation 
Version number of service group definition this service group is associated with.

If this attribute is not specified this latest version will be determined at start-up time and written to file.
annotation-protocol    http    
documentation 
Protocol used in codebase annotation when marshalling objects.

Setting this value to httpmd enables JAR file verification to be performed by the receiving party.
annotation-algorithm  NMTOKEN  sha1    
documentation 
Name of message digest algorithm used for calculating of a message digest for the download JAR files.

The default algorithm being used in case of httpmd is SHA-1. The container will support all algorithms listed in the Java Cryptography Architecture API Specification and Reference, others can be obtained by installing the right crypto plugins for your J2SE platform.

Note: algorithm names are not case-sensitive.
annotation
documentation 
Deployment configuration data for service group, contains all the configured service instances.

A service group is associated with a single class loader, therefore placing multiple service instances within one group allows them to share resources.

complexType bind-address
diagram
namespace http://www.cheiron.org/seven-config
type extension of NMTOKEN
properties
base NMTOKEN
used by
elements jarserver/bind-address jeri-connector/bind-address jeri-tcp/bind-address jeri-http/bind-address discovery/multicast-interfaces/bind-address
annotation
documentation 
IPv4 / IPv6 number, or the host name of interface to bind on.

complexType configuration
diagram
namespace http://www.cheiron.org/seven-config
children config-def ext-config expr-value
used by
elements service-group/configuration service-instance/configuration
annotation
documentation 
Represents a configuration object that allows for expression substitution and provides additional configuration sources to that of the configuration of the JSC Deployment Descriptor or container configuration.

element configuration/config-def
diagram
namespace http://www.cheiron.org/seven-config
type extension of jsc:config-def
properties
isRef 0
content complex
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
disabled  boolean  false    
documentation 
Indicates whether this configuration is disabled, i.e. is not taken into account for the aggregated configuration.
annotation
documentation 
Configuration source that provides additional entries.

element configuration/ext-config
diagram
namespace http://www.cheiron.org/seven-config
type extension of normalizedString
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
disabled  boolean  false    
documentation 
Indicates whether this configuration is disabled, i.e. is not taken into account for the aggregated configuration.
annotation
documentation 
URI to an external configuration file with syntax as specified by net.jini.config.ConfigurationFile with additional expression support, i.e. XML elements expr and expr-ref are allowed.

The URI has to be a file, http, httpmd or resources URI (not supported at container level), or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in is considered the root directory for resolving purposes.

element configuration/expr-value
diagram
namespace http://www.cheiron.org/seven-config
type jsc:expr-value
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
expr-id  NCNamerequired      
annotation
documentation 
Value for expression as defined within the configuration definition.

complexType connector
diagram
namespace http://www.cheiron.org/seven-config
children jeri-tcp jeri-http free-connector
used by
elements container/connector service-instance/connector
attributes
Name  Type  Use  Default  Fixed  Annotation
durable  boolean  false    
documentation 
Indicates whether the connector is durable, meaning that even after restarts of the service clients that have a reference are able to talk to that service.

This attribute only has a meaning effect when the port number is fixed, or in general when existing endpoints will be able to connect to the server endpoint when the service restarts.
annotation
documentation 
Connector configuration for implementing the RMI programming model.

element connector/jeri-tcp
diagram
namespace http://www.cheiron.org/seven-config
type seven:jeri-tcp
properties
isRef 0
content complex
children bind-address
attributes
Name  Type  Use  Default  Fixed  Annotation
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the service proxy to use for setting up a socket connection.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for establishing a client-server connection. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to the service dispatcher and for non LAN environments.
port  unsignedShort  0    
documentation 
Port number the connector will listen on for inbound requests, if the port number is '0' the container will use a free random port number.
nio-server  boolean      
documentation 
If set a custom server socket factory will be part of the ServerEndpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the seven.jeri.nio system property.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created.
nio-client  boolean      
documentation 
If set a custom socket factory will be part of the Endpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the implementation/configuration of the Jini Platform of the client.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created. In most cases one should not specify this attribute.
annotation
documentation 
Configures net.jini.jeri.tcp endpoints.

element connector/jeri-http
diagram
namespace http://www.cheiron.org/seven-config
type seven:jeri-http
properties
isRef 0
content complex
children bind-address
attributes
Name  Type  Use  Default  Fixed  Annotation
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the service proxy to use for setting up a socket connection.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for establishing a client-server connection. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to the service dispatcher and for non LAN environments.
port  unsignedShort  0    
documentation 
Port number the connector will listen on for inbound requests, if the port number is '0' the container will use a free random port number.
inbound-uri  anyURI      
documentation 
Absolute URI used for the Endpoint to connect back to the server, setting this attribute will override host:port combination derived from the inbound-host and port attribute.

The scheme of the absolute URI must be 'http', if the URI contains a path the HttpRequestUriEndpoint will be used.
nio-server  boolean      
documentation 
If set a custom server socket factory will be part of the ServerEndpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the seven.jeri.nio system property.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created.
nio-client  boolean      
documentation 
If set a custom socket factory will be part of the Endpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the implementation/configuration of the Jini Platform of the client.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created. In most cases one should not specify this attribute.
annotation
documentation 
Configures net.jini.jeri.http endpoints.

element connector/free-connector
diagram
namespace http://www.cheiron.org/seven-config
type NCName
properties
isRef 0
content simple
annotation
documentation 
Reference to (free format) connector definition that adheres to the RMI programming model.

complexType console-handler
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-handler
properties
base seven:log-handler
children level-filter message-filter throwable-filter context-filter
used by
element logger/console-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
annotation
documentation 
Publish log records to System.err.

complexType context-filter
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-filter
properties
base seven:log-filter
used by
elements logger/context-filter log-handler/context-filter forward-handler/context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
oid  jsc:numeric-oidrequired      
documentation 
Unique OID (Object Identifier) for the service group definition to apply the filter to.
						
group-id  NCName      
documentation 
Optional identifier of service group to apply the filter to, in case filtering at the service level is required use the instance-id attribute.

If the instance-id attribute is set this attribute will be ignored, as the combination of the OID with the instance-id uniquely identifies a service instance.
instance-id  NCName      
documentation 
Optional identifier of service instance identifier to apply the filter to.
annotation
documentation 
Will only log, or reject, records that originate from a service that has the specified OID, or is part of a service group for the specified OID.

The discriminator for whether a log record is logged or rejected is based on the context class loader. Therefore there is no 100% guarantee that this filter is accurate.

complexType discovery
diagram
namespace http://www.cheiron.org/seven-config
children multicast-interfaces constraints proxy-preparer
used by
elements container/discovery service-instance/discovery
attributes
Name  Type  Use  Default  Fixed  Annotation
protocol-version  int      
documentation 
Controls the version of the multicast request and unicast discovery protocol used, if not specified the protocol version used will depend on whether there are any required or preferred constraints specified.

Setting the protocol version is only recommended in case the lookup services to contact don't support particular versions of the discovery protocol, otherwise the most efficient protocol will be selected.
multicast-request-host  NMTOKEN      
documentation 
The host name to include in multicast requests if participating in version 2 of the multicast request protocol.
multicast-ttl  int      
documentation 
The time to live (TTL) value set on outgoing multicast request packets.
unicast-socket-timeout  int  15000    
documentation 
The read timeout in milliseconds set on sockets over which unicast discovery is performed.
unicast-connection-timeout  int  15000    
documentation 
The connection timeout in milliseconds set on sockets over which unicast discovery is performed.

element discovery/multicast-interfaces
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
nillable true
children bind-address interface-name
annotation
documentation 
Network interfaces used to send and receive multicast packets when this service is participating in the multicast discovery process.

An empty element indicates no interface must be used for sending and receiving multicast packets, effectively disables multicast discovery. An empty element that has the xsi:nil attribute set to true indicates the interface to which the operating system defaults must be used. If no multicast-interface element is specified all supported interfaces on the host will be used.

element discovery/multicast-interfaces/bind-address
diagram
namespace http://www.cheiron.org/seven-config
type seven:bind-address
properties
isRef 0
content complex
annotation
documentation 
Interface that has the specified IP address bound to it.

element discovery/multicast-interfaces/interface-name
diagram
namespace http://www.cheiron.org/seven-config
type NCName
properties
isRef 0
content simple
annotation
documentation 
Interface that is specified by the given name, such as: eth0, hme0, le0.

element discovery/constraints
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
children server-authentication-yes server-authentication-no integrity-yes integrity-no confidentiality-yes confidentiality-no client-authentication-no
annotation
documentation 
Specifies the constraints effective for discovery.

element discovery/constraints/server-authentication-yes
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Authenticate the server to the client.

element discovery/constraints/server-authentication-no
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Do not authenticate the server to the client, so that the server remains anonymous.

element discovery/constraints/integrity-yes
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Detect when message contents (both requests and replies) have been altered by third parties, and if detected, refuse to process the message and throw an exception.

element discovery/constraints/integrity-no
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Do not detect when message contents have been altered by third parties.

element discovery/constraints/confidentiality-yes
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Transmit message contents so that they cannot easily be interpreted by third parties, typically by using encryption.

element discovery/constraints/confidentiality-no
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Transmit message contents in the clear, i.e. no use of encryption.

element discovery/constraints/client-authentication-no
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Do not authenticate the client to the server, so that the client remains anonymous.

element discovery/proxy-preparer
diagram
namespace http://www.cheiron.org/seven-config
type seven:proxy-preparer
properties
isRef 0
content complex
children constraints grant
attributes
Name  Type  Use  Default  Fixed  Annotation
verify-trust  boolean  false    
documentation 
Indicates whether to verify if proxies are trusted.
annotation
documentation 
Lookup service proxy preparer and related secondary proxies.

This proxy preparer will also be used for preparing leases associated with the registrations for receiving service discovery events from a lookup service. or the registration of a service with a lookup service and for the lease associated with that registration from maintaining the registration with the lookup service.

complexType file-handler
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-handler
properties
base seven:log-handler
children level-filter message-filter throwable-filter context-filter
used by
element logger/file-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
append  boolean  true    
documentation 
Indicates whether log files will be appended between restarts of a service or that they are overwritten.	
limit  int  8192    
documentation 
Maximum size of file in KBytes before rotating the log files.
count  short  2    
documentation 
Maximum number of files used for rotating, after reaching the limit it will start to overwrite old log files.
annotation
documentation 
Publish log records to file.

complexType forward-handler
diagram
namespace http://www.cheiron.org/seven-config
children level-filter message-filter throwable-filter context-filter
used by
element logger/forward-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
logger-name  normalizedStringrequired      
documentation 
Name of the logger on which the log record must be logged as well. The scope of the loggers is that of the enclosed logger, it is possible to redirect to fixed named loggers (as defined at the container level) by preceding it with the '/' character. Only loggers that have their 'unprotected' attribute set to true are able to accept redirected log records from another namespace.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
annotation
documentation 
Forward the log record to the specifies named logger.

element forward-handler/level-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:level-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
start  seven:log-levelrequired      
documentation 
Start level of range to be logged, inclusive.

In case no end attribute has been specified the start value will serve as the singel level this filter will allow the records to be published of.
end  seven:log-level      
documentation 
End level of range to be logged, inclusive.
annotation
documentation 
Will only log records that are within the specified log level range.

element forward-handler/message-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:message-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
reject  boolean  false    
documentation 
Indicates whether a log record has to be rejected or logged when the conditions are met for this filter.

		By default the filter will return true if the conditions are met.
annotation
documentation 
Will only log records that have a message field that matches the specified regular expression.

element forward-handler/throwable-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:throwable-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
class  string      
documentation 
Class name of Throwable or subclass that will be filtered.

All records for which instanceof 'class' returns true will be filtered. If not provided all records containing a Throwable will be filtered.
annotation
documentation 
Will only log records that contain a throwable, of a specific type if needed.

element forward-handler/context-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:context-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
oid  jsc:numeric-oidrequired      
documentation 
Unique OID (Object Identifier) for the service group definition to apply the filter to.
						
group-id  NCName      
documentation 
Optional identifier of service group to apply the filter to, in case filtering at the service level is required use the instance-id attribute.

If the instance-id attribute is set this attribute will be ignored, as the combination of the OID with the instance-id uniquely identifies a service instance.
instance-id  NCName      
documentation 
Optional identifier of service instance identifier to apply the filter to.
annotation
documentation 
Will only log records that originate from a specific context, OID and optional service group identifier.

complexType grant
diagram
namespace http://www.cheiron.org/seven-config
children permission
used by
elements service-group/grant service-instance/grant proxy-preparer/grant
attributes
Name  Type  Use  Default  Fixed  Annotation
class-loader-bound  boolean  true    
documentation 
If true the grant only applies to the protection domains that are associated with the class loader of the JSC Service. If false then the grant applies across all protection domains that are associated with the JSC Service.
annotation
documentation 
Collection of permission that needs to be granted to give access to system resources.

element grant/permission
diagram
namespace http://www.cheiron.org/seven-config
type seven:permission
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
class  NCNamerequired      
documentation 
Full qualified class extending the java.security.Permission object or one of its subclasses.
actions  normalizedString      
documentation 
Action list telling the actions permitted.
annotation
documentation 
Permission to be granted.

Property expansion for system properties and the file seperator is supported through the notation of ${some.property} and ${/}, nesting is not allowed. 

complexType jarserver
diagram
namespace http://www.cheiron.org/seven-config
children bind-address alias
used by
element container/jarserver
attributes
Name  Type  Use  Default  Fixed  Annotation
port  unsignedShort  0    
documentation 
Port number the JAR file server will accept incomming request on, if the port number is '0' the container will use a free random port number.

Note that a random port number won't provide durable codebase annotations, i.e. download JAR files won't be accessible after a restart of the container. You are advised to pick a fixed and free port number for long lived deployments.
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the codebase annotation URL to be used when marshalling classes and when not overridden at another level.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for the codebase annotation URL. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to this JAR file server and for non LAN environments.
inbound-port  unsignedShort      
documentation 
Port number to use in the codebase annotation URL to be used when marshalling classes.

If not specified the container will use the port number the JAR file server has been bound to. This option can be used in case JAR file serving must be performed by a proxy web server that proxies to the internal JAR file server.
annotation
documentation 
Internal JAR file server configuration. If no explicit bind-address is specified the JAR server will bind to all interfaces.

element jarserver/bind-address
diagram
namespace http://www.cheiron.org/seven-config
type seven:bind-address
properties
isRef 0
content complex
annotation
documentation 
Addresses the JAR server must bind on.

element jarserver/alias
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
url-path  anyURIrequired      
documentation 
Absolute URL path, without the file, part, that maps to a local directory and identifies this alias.

An absolute URL path should have a leading '/' character.
dir-uri  normalizedStringrequired      
documentation 
File URI to directory containing the files to be served by the webserver.

The URI has to be a file URI, or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in	is consider the root directory for resolving purposes.	
annotation
documentation 
Aliasses defined for this JAR server, allows the serving of JAR files for services not being deployed under this container instance.

Overlapping aliasses are not supported!

complexType jeri-connector
diagram
namespace http://www.cheiron.org/seven-config
children bind-address
attributes
Name  Type  Use  Default  Fixed  Annotation
transport    tcp    
documentation 
Request/response communication mechanism used for the transport layer of the RMI programming model.
port  unsignedShort  0    
documentation 
Port number the connector will listen on for inbound requests, if the port number is '0' the container will use a free random port number.
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the service proxy to use for setting up a socket connection.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for establishing a client-server connection. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to the service dispatcher and for non LAN environments.
durable  boolean  false    
documentation 
Indicates whether the connector is durable, meaning that even after restarts of the service clients that have a reference are able to talk to that service.

This attribute only has effect when the port number is fixed, that is not the 0 wildcard port number.
annotation
documentation 
Network programming model implementation used to communicate between client and service, based on a limited set of options.

This in contrast to the highly flexible connector-def, or other more advanced and flexible connector types. In case no bind-addresses are provided the connector will bind on all interfaces of the host the container is running on.

element jeri-connector/bind-address
diagram
namespace http://www.cheiron.org/seven-config
type seven:bind-address
properties
isRef 0
content complex
annotation
documentation 
Addresses this connector must bind on.

complexType jeri-http
diagram
namespace http://www.cheiron.org/seven-config
children bind-address
used by
element connector/jeri-http
attributes
Name  Type  Use  Default  Fixed  Annotation
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the service proxy to use for setting up a socket connection.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for establishing a client-server connection. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to the service dispatcher and for non LAN environments.
port  unsignedShort  0    
documentation 
Port number the connector will listen on for inbound requests, if the port number is '0' the container will use a free random port number.
inbound-uri  anyURI      
documentation 
Absolute URI used for the Endpoint to connect back to the server, setting this attribute will override host:port combination derived from the inbound-host and port attribute.

The scheme of the absolute URI must be 'http', if the URI contains a path the HttpRequestUriEndpoint will be used.
nio-server  boolean      
documentation 
If set a custom server socket factory will be part of the ServerEndpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the seven.jeri.nio system property.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created.
nio-client  boolean      
documentation 
If set a custom socket factory will be part of the Endpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the implementation/configuration of the Jini Platform of the client.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created. In most cases one should not specify this attribute.
annotation
documentation 
Network programming model implementation used to communicate between client and service, based on the net.jini.jeri.http endpoint implementations.

element jeri-http/bind-address
diagram
namespace http://www.cheiron.org/seven-config
type seven:bind-address
properties
isRef 0
content complex
annotation
documentation 
Addresses this connector must bind on.

complexType jeri-tcp
diagram
namespace http://www.cheiron.org/seven-config
children bind-address
used by
element connector/jeri-tcp
attributes
Name  Type  Use  Default  Fixed  Annotation
inbound-host  NMTOKEN      
documentation 
Host name, or IPv4/IPv6 number, for the service proxy to use for setting up a socket connection.

If not specified the container will determine the 'primary' IP number in textual representation (IPv4 or IPv6) for the host and use that for establishing a client-server connection. It is wise to provide here a DNS alias, as this would ease building security policies for Java clients that needs to connect to the service dispatcher and for non LAN environments.
port  unsignedShort  0    
documentation 
Port number the connector will listen on for inbound requests, if the port number is '0' the container will use a free random port number.
nio-server  boolean      
documentation 
If set a custom server socket factory will be part of the ServerEndpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the seven.jeri.nio system property.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created.
nio-client  boolean      
documentation 
If set a custom socket factory will be part of the Endpoint that controls whether the socket created is based on NIO or is a blocking type. If this attribute is not set the type of socket created will depend on the implementation/configuration of the Jini Platform of the client.

If true a NIO based socket will be created by the server socket factory, if set to false a blocking socket will be created. In most cases one should not specify this attribute.
annotation
documentation 
Network programming model implementation used to communicate between client and service, based on the net.jini.jeri.tcp endpoint implementations.

element jeri-tcp/bind-address
diagram
namespace http://www.cheiron.org/seven-config
type seven:bind-address
properties
isRef 0
content complex
annotation
documentation 
Addresses this connector must bind on.

complexType join-scope
diagram
namespace http://www.cheiron.org/seven-config
children member-group locator-uri locator constrainable-locator
used by
elements container/join-scope service-instance/join-scope
annotation
documentation 
Scope for Lookup Services the service will be registered with.

element join-scope/member-group
diagram
namespace http://www.cheiron.org/seven-config
type string
properties
isRef 0
content simple
nillable true
annotation
documentation 
Member group the service will be registered with.

An empty element that is not 'nil' indicates the public group (empty string in Java), an empty element that has the xsi:nil attribute set to true to discover all lookup services that are within multicast range, and which belong to any group.

element join-scope/locator-uri
diagram
namespace http://www.cheiron.org/seven-config
type anyURI
properties
isRef 0
content simple
annotation
documentation 
Unicast locator URI to Lookup Service.

element join-scope/locator
diagram
namespace http://www.cheiron.org/seven-config
type seven:locator
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
host  NMTOKENrequired      
documentation 
Host name the Lookup Service is running on.
port  unsignedShort  4160    
documentation 
Port number the Lookup Service is listing for unicast request.
annotation
documentation 
Unicast locator to Lookup Service, based on host and port number.

element join-scope/constrainable-locator
diagram
namespace http://www.cheiron.org/seven-config
type jsc:entry
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
name  NCName      
documentation 
Identifier for entry, can be useful in case of exception when unmarshalling the entry.
annotation
documentation 
ConstrainableLookupLocator to Lookup Service, represented by a marshalled object.

Base 64 encoded data, should not be configured manually, container will take care of this.

complexType level-filter
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-filter
properties
base seven:log-filter
used by
elements logger/level-filter log-handler/level-filter forward-handler/level-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
start  seven:log-levelrequired      
documentation 
Start level of range to be logged, inclusive.

In case no end attribute has been specified the start value will serve as the singel level this filter will allow the records to be published of.
end  seven:log-level      
documentation 
End level of range to be logged, inclusive.
annotation
documentation 
Will only log records that are within the specified log level range.

complexType locator
diagram
namespace http://www.cheiron.org/seven-config
used by
element join-scope/locator
attributes
Name  Type  Use  Default  Fixed  Annotation
host  NMTOKENrequired      
documentation 
Host name the Lookup Service is running on.
port  unsignedShort  4160    
documentation 
Port number the Lookup Service is listing for unicast request.
annotation
documentation 
Unicast Lookup Service locator.

complexType log-filter
diagram
namespace http://www.cheiron.org/seven-config
properties
abstract true
used by
complexTypes context-filter level-filter throwable-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
annotation
documentation 
Abstract log filter to be used for real log filter definitions.

complexType log-handler
diagram
namespace http://www.cheiron.org/seven-config
properties
abstract true
children level-filter message-filter throwable-filter context-filter
used by
complexTypes console-handler file-handler mail-handler socket-handler syslog-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
annotation
documentation 
Abstract log handler to be used for real log handler definitions.

element log-handler/level-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:level-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
start  seven:log-levelrequired      
documentation 
Start level of range to be logged, inclusive.

In case no end attribute has been specified the start value will serve as the singel level this filter will allow the records to be published of.
end  seven:log-level      
documentation 
End level of range to be logged, inclusive.
annotation
documentation 
Will only log records that are within the specified log level range.

element log-handler/message-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:message-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
reject  boolean  false    
documentation 
Indicates whether a log record has to be rejected or logged when the conditions are met for this filter.

		By default the filter will return true if the conditions are met.
annotation
documentation 
Will only log records that have a message field that matches the specified regular expression.

element log-handler/throwable-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:throwable-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
class  string      
documentation 
Class name of Throwable or subclass that will be filtered.

All records for which instanceof 'class' returns true will be filtered. If not provided all records containing a Throwable will be filtered.
annotation
documentation 
Will only log records that contain a throwable, of a specific type if needed.

element log-handler/context-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:context-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
oid  jsc:numeric-oidrequired      
documentation 
Unique OID (Object Identifier) for the service group definition to apply the filter to.
						
group-id  NCName      
documentation 
Optional identifier of service group to apply the filter to, in case filtering at the service level is required use the instance-id attribute.

If the instance-id attribute is set this attribute will be ignored, as the combination of the OID with the instance-id uniquely identifies a service instance.
instance-id  NCName      
documentation 
Optional identifier of service instance identifier to apply the filter to.
annotation
documentation 
Will only log records that originate from a specific context, OID and optional service group identifier.

complexType logger
diagram
namespace http://www.cheiron.org/seven-config
children level-filter message-filter throwable-filter context-filter console-handler file-handler socket-handler syslog-handler mail-handler forward-handler
used by
elements container/logger service-instance/logger
attributes
Name  Type  Use  Default  Fixed  Annotation
name  string      
documentation 
Name for this logger, if not specified it will serve as the root logger within the context this logger is being used.
level  seven:log-level      
documentation 
Minimum log level this logger should take care of.

In case no level is specified the level of the logger must be inherited from its nearest ancestor with a specific (non-null) log level.
delegate  boolean  true    
documentation 
Indicates whether this logger should send its output to it's parent logger.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
protected  boolean  true    
documentation 
Indicates whether the logger accepts forwarded log records from a forward handler or is protected.

True doesn't allow for forwarding from a forward handler in another namespace, only allows forwarding from within the same namespace. False does allow for forwarding from another namespace.
annotation
documentation 
Configures the object used for logging messages of a specific service or component.

Loggers are named using a hierarchical dot-separated namespace.

element logger/level-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:level-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
start  seven:log-levelrequired      
documentation 
Start level of range to be logged, inclusive.

In case no end attribute has been specified the start value will serve as the singel level this filter will allow the records to be published of.
end  seven:log-level      
documentation 
End level of range to be logged, inclusive.
annotation
documentation 
Will only log records that are within the specified log level range.

element logger/message-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:message-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
reject  boolean  false    
documentation 
Indicates whether a log record has to be rejected or logged when the conditions are met for this filter.

		By default the filter will return true if the conditions are met.
annotation
documentation 
Will only log records that have a message field that matches the specified regular expression.

element logger/throwable-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:throwable-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
class  string      
documentation 
Class name of Throwable or subclass that will be filtered.

All records for which instanceof 'class' returns true will be filtered. If not provided all records containing a Throwable will be filtered.
annotation
documentation 
Will only log records that contain a throwable, of a specific type if needed.

element logger/context-filter
diagram
namespace http://www.cheiron.org/seven-config
type seven:context-filter
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
oid  jsc:numeric-oidrequired      
documentation 
Unique OID (Object Identifier) for the service group definition to apply the filter to.
						
group-id  NCName      
documentation 
Optional identifier of service group to apply the filter to, in case filtering at the service level is required use the instance-id attribute.

If the instance-id attribute is set this attribute will be ignored, as the combination of the OID with the instance-id uniquely identifies a service instance.
instance-id  NCName      
documentation 
Optional identifier of service instance identifier to apply the filter to.
annotation
documentation 
Will only log records that originate from a specific context, OID and optional service group identifier.

element logger/console-handler
diagram
namespace http://www.cheiron.org/seven-config
type seven:console-handler
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
annotation
documentation 
Publish to console.

element logger/file-handler
diagram
namespace http://www.cheiron.org/seven-config
type seven:file-handler
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
append  boolean  true    
documentation 
Indicates whether log files will be appended between restarts of a service or that they are overwritten.	
limit  int  8192    
documentation 
Maximum size of file in KBytes before rotating the log files.
count  short  2    
documentation 
Maximum number of files used for rotating, after reaching the limit it will start to overwrite old log files.
annotation
documentation 
Publish to file.

element logger/socket-handler
diagram
namespace http://www.cheiron.org/seven-config
type seven:socket-handler
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
host  NMTOKENrequired      
documentation 
Host name or IPv4/IPv6 address of host where socket-log daemon is running.
port  shortrequired      
documentation 
Port number the socket-log daemon is listening on.
annotation
documentation 
Publish to network connection.

element logger/syslog-handler
diagram
namespace http://www.cheiron.org/seven-config
type seven:syslog-handler
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
facility  short  1    
documentation 
Well know syslog facility to use, value must be between 0 - 23.

If not set the default value is facility 1, meaning user-level messages.
tag  NCName  Seven    
documentation 
Tag to identify the process sending syslog messages.

If not set the default value is 'Seven'.
syslog-host  NMTOKEN      
documentation 
Host name or IPv4/IPv6 address of host where syslog daemon is running.

If not set the default value is the IP number of the localhost.
time-zone  NCName      
documentation 
Time zone to use for generating the time stamps in the syslog messages.

If not set the default time zone of the platform will be taken.
annotation
documentation 
Publish to syslog daemon.

element logger/mail-handler
diagram
namespace http://www.cheiron.org/seven-config
type seven:mail-handler
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
smtp-host  NMTOKEN      
documentation 
Host name or IPv4/IPv6 address of host of MTA to deliver messages at.

If not set the default value is localhost.
from  normalizedString      
documentation 
Specifies the From address header in the RFC822 address format.

If not set the handler will provide his own valid tag.
recipient  normalizedStringrequired      
documentation 
Specifies a comma separated list of recipients in the RFC822 address format.
reply-to  normalizedString      
documentation 
Specifies the Reply-To address header in the RFC822 address format.
annotation
documentation 
Mail to a list of recipients.

element logger/forward-handler
diagram
namespace http://www.cheiron.org/seven-config
type seven:forward-handler
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
logger-name  normalizedStringrequired      
documentation 
Name of the logger on which the log record must be logged as well. The scope of the loggers is that of the enclosed logger, it is possible to redirect to fixed named loggers (as defined at the container level) by preceding it with the '/' character. Only loggers that have their 'unprotected' attribute set to true are able to accept redirected log records from another namespace.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
annotation
documentation 
Forwards the log record to the specifies named logger.

complexType mail-handler
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-handler
properties
base seven:log-handler
children level-filter message-filter throwable-filter context-filter
used by
element logger/mail-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
smtp-host  NMTOKEN      
documentation 
Host name or IPv4/IPv6 address of host of MTA to deliver messages at.

If not set the default value is localhost.
from  normalizedString      
documentation 
Specifies the From address header in the RFC822 address format.

If not set the handler will provide his own valid tag.
recipient  normalizedStringrequired      
documentation 
Specifies a comma separated list of recipients in the RFC822 address format.
reply-to  normalizedString      
documentation 
Specifies the Reply-To address header in the RFC822 address format.
annotation
documentation 
Sends log records to a list of recipients.

complexType message-filter
diagram
namespace http://www.cheiron.org/seven-config
type extension of normalizedString
properties
base normalizedString
used by
elements logger/message-filter log-handler/message-filter forward-handler/message-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
reject  boolean  false    
documentation 
Indicates whether a log record has to be rejected or logged when the conditions are met for this filter.

		By default the filter will return true if the conditions are met.
annotation
documentation 
Will only log records that have a message field that matches the provided regular expression.

The syntax of the regular expression is that of java.util.regex.Pattern. For multiline messages (that contain linefeeds) it might be necessary to put '(?s)' in your expression.

complexType permission
diagram
namespace http://www.cheiron.org/seven-config
type extension of string
properties
base string
used by
element grant/permission
attributes
Name  Type  Use  Default  Fixed  Annotation
class  NCNamerequired      
documentation 
Full qualified class extending the java.security.Permission object or one of its subclasses.
actions  normalizedString      
documentation 
Action list telling the actions permitted.
annotation
documentation 
Represents a permission that can grant a particular type of access to a system resource, the name argument of a permission is represented by this XML type.

Property expansion for system properties and the file seperator is supported through the notation of ${some.property} and ${/}, nesting is not allowed. 

complexType proxy-preparer
diagram
namespace http://www.cheiron.org/seven-config
children constraints grant
used by
elements container/proxy-preparer service-instance/proxy-preparer discovery/proxy-preparer
attributes
Name  Type  Use  Default  Fixed  Annotation
verify-trust  boolean  false    
documentation 
Indicates whether to verify if proxies are trusted.
annotation
documentation 
Configuration of the proxy preparer used to perform operations on a newly unmarshalled remote proxy to prepare it for use.

element proxy-preparer/constraints
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
annotation
documentation 
Constraints to use when verifying and setting constraints.

Currently only constraints can be specified for all methods (wildcard).

element proxy-preparer/grant
diagram
namespace http://www.cheiron.org/seven-config
type seven:grant
properties
isRef 0
content complex
children permission
attributes
Name  Type  Use  Default  Fixed  Annotation
class-loader-bound  boolean  true    
documentation 
If true the grant only applies to the protection domains that are associated with the class loader of the JSC Service. If false then the grant applies across all protection domains that are associated with the JSC Service.
annotation
documentation 
Collection of permission that needs to be granted to proxies or secondary objects after they have been verified.

complexType service-group
diagram
namespace http://www.cheiron.org/seven-config
children help jar-pool grant configuration service-instance
used by
element jsc-unit/service-group
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNamerequired      
documentation 
Identifier of service group, must be unique within context of JSC unit.
security-domain-ref  NCName      
documentation 
Identifier of security domain the service group is associated with.
version  jsc:version-number      
documentation 
Version number of service group definition this service group is associated with.

If this attribute is not specified this latest version will be determined at start-up time and written to file.
annotation-protocol    http    
documentation 
Protocol used in codebase annotation when marshalling objects.

Setting this value to httpmd enables JAR file verification to be performed by the receiving party.
annotation-algorithm  NMTOKEN  sha1    
documentation 
Name of message digest algorithm used for calculating of a message digest for the download JAR files.

The default algorithm being used in case of httpmd is SHA-1. The container will support all algorithms listed in the Java Cryptography Architecture API Specification and Reference, others can be obtained by installing the right crypto plugins for your J2SE platform.

Note: algorithm names are not case-sensitive.
annotation
documentation 
Configuration for service group definition.

element service-group/help
diagram
namespace http://www.cheiron.org/seven-config
type jsc:help-message
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
ref-id  NCNamerequired      
documentation 
Identifier refering to element this is a help message for.
annotation
documentation 
Help messages for expressions introduced at this level.

element service-group/jar-pool
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
children jar-file jar-dir
annotation
documentation 
Pool of JAR files that will be added to class loader associated with this service group.

The JAR files will be appended on the classpath after the JAR files that are part of the service group definition, the order of appending is that of the order in which they are specified here.

element service-group/jar-pool/jar-file
diagram
namespace http://www.cheiron.org/seven-config
type normalizedString
properties
isRef 0
content simple
annotation
documentation 
URI to a JAR file that must be included in the pool.

The URI has to be a file, http or httpmd URI, or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in is consider the root directory for resolving purposes.

element service-group/jar-pool/jar-dir
diagram
namespace http://www.cheiron.org/seven-config
type normalizedString
properties
isRef 0
content simple
annotation
documentation 
URI to a directory for which all the JAR files (extension .jar) in that directory are included in the pool, the order for the JAR files in the directory is undefined.

The URI has to be a file URI, or in case no scheme is provided a file system path is assumed. In case of a relative filepath the directory the configuration file is in is consider the root directory for resolving purposes.

element service-group/grant
diagram
namespace http://www.cheiron.org/seven-config
type seven:grant
properties
isRef 0
content complex
children permission
attributes
Name  Type  Use  Default  Fixed  Annotation
class-loader-bound  boolean  true    
documentation 
If true the grant only applies to the protection domains that are associated with the class loader of the JSC Service. If false then the grant applies across all protection domains that are associated with the JSC Service.
annotation
documentation 
Grant required for deployment that requires permissions not part of the JSC Deployment Descriptor.

This grant will be applied to all service instances part of the service group.

element service-group/configuration
diagram
namespace http://www.cheiron.org/seven-config
type seven:configuration
properties
isRef 0
content complex
children config-def ext-config expr-value
annotation
documentation 
Configuration for service definition wide elements.

element service-group/service-instance
diagram
namespace http://www.cheiron.org/seven-config
type seven:service-instance
properties
isRef 0
content complex
children purpose help logger grant subject access-control connector proxy-preparer discovery join-scope configuration
attributes
Name  Type  Use  Default  Fixed  Annotation
inherit  boolean  true    
documentation 
Indicates whether the service must inherit configuration at the container level when not specified at the service level.
id  NCNamerequired      
documentation 
Identifier of service instance, must be unique within context of service group definition.
class  NCNamerequired      
documentation 
Full qualified class name of object implementing org.cheiron.jsc.JiniService.
mode  optional  transient    
service-id  string      
documentation 
Universal Unique Identifier for service instance. The container is responsible for assigning and maintaining this Service ID.
reference-id  NMTOKEN      
documentation 
Identifier for remote reference in the string format of the Uuid object.

This identifier is only used when the connector configured has support for durable references and durable is configured.

The identifier is unscrambled therefore make sure this file is not visible to everybody.
deployed  boolean  false    
documentation 
Indicates whether this service instance has been deployed by the container before, this attribute is managed by the container.
life-cycle  boolean  false    
documentation 
Indicates whether the container should add the life-cycle administration interfaces to the service proxy.
join-admin  boolean  false    
documentation 
Indicates whether the container should add the join administration interfaces to the service proxy.
deploy-on-startup  normalizedString  -1    
documentation 
Indicates whether the service must be deployed on startup of Seven.

If the attribute is a non-negative integer the number indicates the priority (order) in which the service must be deployed, services with a lower integer are deployed before services with a higher integer. A negative integer indicates the service must not be deployed on startup of Seven.
join-lease-duration  long  9223372036854775807    
documentation 
The maximum lease duration in milliseconds that is requested from each discovered lookup service on behalf of the service, both when the lease is initially requested, as well as when renewal of that lease is requested. The constant value for Lease.ANY and Lease.FOREVER (the default) are allowed here.

Note that as this value is made smaller, renewal requests will be made more frequently while the service is up, and lease expiration will occur sooner when the service goes down.
codebase-uri-prefix  anyURI      
documentation 
Absolute URI prefix used for the codebase annotation URL when marshalling objects, overrides the configuration at the container level.

The service specific part will be added to the prefix provided. If the prefix doesn't end with a path separator the container will add one before adding the service specific part.
annotation-protocol        
documentation 
Protocol used in codebase annotation when marshalling objects, overrides the configuration at the container level.

Setting this value to httpmd enables JAR file integrity verification to be performed by the receiving party. When the codebase-uri-prefix is set this attribute will enable httpmd for codebase annotations when the scheme of the codebase-uri-prefix equals 'http'.
annotation-algorithm  NMTOKEN      
documentation 
Name of message digest algorithm used for calculating of a message digest for the download JAR files, overrides the configuration at the container level.

The container will support all algorithms listed in the Java Cryptography Architecture API Specification and Reference, others can be obtained by installing the right crypto plugins for your J2SE platform.

Note: algorithm names are not case-sensitive.
annotation
documentation 
Deployment configuration for service instance.

complexType service-instance
diagram
namespace http://www.cheiron.org/seven-config
children purpose help logger grant subject access-control connector proxy-preparer discovery join-scope configuration
used by
element service-group/service-instance
attributes
Name  Type  Use  Default  Fixed  Annotation
inherit  boolean  true    
documentation 
Indicates whether the service must inherit configuration at the container level when not specified at the service level.
id  NCNamerequired      
documentation 
Identifier of service instance, must be unique within context of service group definition.
class  NCNamerequired      
documentation 
Full qualified class name of object implementing org.cheiron.jsc.JiniService.
mode  optional  transient    
service-id  string      
documentation 
Universal Unique Identifier for service instance. The container is responsible for assigning and maintaining this Service ID.
reference-id  NMTOKEN      
documentation 
Identifier for remote reference in the string format of the Uuid object.

This identifier is only used when the connector configured has support for durable references and durable is configured.

The identifier is unscrambled therefore make sure this file is not visible to everybody.
deployed  boolean  false    
documentation 
Indicates whether this service instance has been deployed by the container before, this attribute is managed by the container.
life-cycle  boolean  false    
documentation 
Indicates whether the container should add the life-cycle administration interfaces to the service proxy.
join-admin  boolean  false    
documentation 
Indicates whether the container should add the join administration interfaces to the service proxy.
deploy-on-startup  normalizedString  -1    
documentation 
Indicates whether the service must be deployed on startup of Seven.

If the attribute is a non-negative integer the number indicates the priority (order) in which the service must be deployed, services with a lower integer are deployed before services with a higher integer. A negative integer indicates the service must not be deployed on startup of Seven.
join-lease-duration  long  9223372036854775807    
documentation 
The maximum lease duration in milliseconds that is requested from each discovered lookup service on behalf of the service, both when the lease is initially requested, as well as when renewal of that lease is requested. The constant value for Lease.ANY and Lease.FOREVER (the default) are allowed here.

Note that as this value is made smaller, renewal requests will be made more frequently while the service is up, and lease expiration will occur sooner when the service goes down.
codebase-uri-prefix  anyURI      
documentation 
Absolute URI prefix used for the codebase annotation URL when marshalling objects, overrides the configuration at the container level.

The service specific part will be added to the prefix provided. If the prefix doesn't end with a path separator the container will add one before adding the service specific part.
annotation-protocol        
documentation 
Protocol used in codebase annotation when marshalling objects, overrides the configuration at the container level.

Setting this value to httpmd enables JAR file integrity verification to be performed by the receiving party. When the codebase-uri-prefix is set this attribute will enable httpmd for codebase annotations when the scheme of the codebase-uri-prefix equals 'http'.
annotation-algorithm  NMTOKEN      
documentation 
Name of message digest algorithm used for calculating of a message digest for the download JAR files, overrides the configuration at the container level.

The container will support all algorithms listed in the Java Cryptography Architecture API Specification and Reference, others can be obtained by installing the right crypto plugins for your J2SE platform.

Note: algorithm names are not case-sensitive.
annotation
documentation 
Configuration for service instance.

element service-instance/purpose
diagram
namespace http://www.cheiron.org/seven-config
type jsc:description
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
annotation
documentation 
Purpose of specific service instance.

element service-instance/help
diagram
namespace http://www.cheiron.org/seven-config
type jsc:help-message
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
ref-id  NCNamerequired      
documentation 
Identifier refering to element this is a help message for.
annotation
documentation 
Help messages for expressions introduced at this level.

element service-instance/logger
diagram
namespace http://www.cheiron.org/seven-config
type seven:logger
properties
isRef 0
content complex
children level-filter message-filter throwable-filter context-filter console-handler file-handler socket-handler syslog-handler mail-handler forward-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
name  string      
documentation 
Name for this logger, if not specified it will serve as the root logger within the context this logger is being used.
level  seven:log-level      
documentation 
Minimum log level this logger should take care of.

In case no level is specified the level of the logger must be inherited from its nearest ancestor with a specific (non-null) log level.
delegate  boolean  true    
documentation 
Indicates whether this logger should send its output to it's parent logger.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
protected  boolean  true    
documentation 
Indicates whether the logger accepts forwarded log records from a forward handler or is protected.

True doesn't allow for forwarding from a forward handler in another namespace, only allows forwarding from within the same namespace. False does allow for forwarding from another namespace.
annotation
documentation 
Log mechanism configured at service instance level, or any subsystem used by the service.	

element service-instance/grant
diagram
namespace http://www.cheiron.org/seven-config
type seven:grant
properties
isRef 0
content complex
children permission
attributes
Name  Type  Use  Default  Fixed  Annotation
class-loader-bound  boolean  true    
documentation 
If true the grant only applies to the protection domains that are associated with the class loader of the JSC Service. If false then the grant applies across all protection domains that are associated with the JSC Service.
annotation
documentation 
Grant required for deployment that requires permissions not part of the JSC Deployment Descriptor.

This grant complements the grant configured at the service group level and the grant specified in the JSC Deployment Descriptor.

element service-instance/subject
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
children principal
annotation
documentation 
Controls the principals the service can use to authenticate itself as server and client and that are available as part of the subject the service operates under.

When no subject is specified the subject will be populated with all X.500 principals for which a private key could be found in the key store.

element service-instance/subject/principal
diagram
namespace http://www.cheiron.org/seven-config
type extension of NCName
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
password        
documentation 
Password used to retrieve the private keys associated with this principal from the kestore, not all keystores require a password for obtaining the private key material.

Only when the configuration data is secured you should make the password part of the configuration. If not specified and a password is required the container will attempt to obtain it by a suitable mechanism.
authenticate    SERVER_CLIENT    
documentation 
Controls whether the principal can be used by the service for the purpose of server authentication, for client authentication, or for both.
annotation
documentation 
Principal identified by its alias as used in the key store.

element service-instance/access-control
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
children method
annotation
documentation 
Configures access control for remote method invocations when client authentication is supported by the endpoints for the exporter that is compatible with Jini ERI.

When no access-control is specified no access control checks are performed.

Methods identified here can only be invoked if the client subject contains the permissions for that method. Methods are identified by their fully qualified method name that provides limited support for wildcarding. The method names are those of the service provider exported by the JSC Service and some Seven specific method names used to identifiy container generated methods.

element service-instance/access-control/method
diagram
namespace http://www.cheiron.org/seven-config
properties
isRef 0
content complex
children principal
attributes
Name  Type  Use  Default  Fixed  Annotation
name  normalizedStringrequired      
documentation 
Fully qualified method name of method of service provider or container generated method for which access control must be configured, there is limited support to wildcard method names to have them match multiple methods.

The following forms to match fully qualified method names are support:

    * (matches any method, use with care)
    method (fully qualified method)
    prefix* (matches all methods that start with the prefix)
    *suffix (matches all methods that ends with the suffix)
disabled  boolean  false    
documentation 
Controls whether access control checks for this method(s) are disabled, when disabled it effectively means that all clients (including anonymous ones) can call the method(s) specified by this entry.

When access control is disabled it has no use to specify a collection of associated princiapals.
annotation
documentation 
Specifies the method(s) for which access control is effective.

When no client principals are specified all clients that are trusted by this service are allowed to call this method.

When access control is disabled for a method it can't be enabled by a subsequent method element.

element service-instance/access-control/method/principal
diagram
namespace http://www.cheiron.org/seven-config
type NCName
properties
isRef 0
content simple
annotation
documentation 
Principal identified by its alias as used in the trust store.

element service-instance/connector
diagram
namespace http://www.cheiron.org/seven-config
type seven:connector
properties
isRef 0
content complex
children jeri-tcp jeri-http free-connector
attributes
Name  Type  Use  Default  Fixed  Annotation
durable  boolean  false    
documentation 
Indicates whether the connector is durable, meaning that even after restarts of the service clients that have a reference are able to talk to that service.

This attribute only has a meaning effect when the port number is fixed, or in general when existing endpoints will be able to connect to the server endpoint when the service restarts.
annotation
documentation 
Connector configuration used to deploy service proxies.

If not specified the connector configured at the container level, if any, will be used.

For the standard connectors there are no additional grants required, these are taken care of by the container.

element service-instance/proxy-preparer
diagram
namespace http://www.cheiron.org/seven-config
type seven:proxy-preparer
properties
isRef 0
content complex
children constraints grant
attributes
Name  Type  Use  Default  Fixed  Annotation
verify-trust  boolean  false    
documentation 
Indicates whether to verify if proxies are trusted.
annotation
documentation 
General proxy preparer used for proxy preparation of service proxies obtained through ServiceFinder.

If not specified the proxy preparer configured at the container level, if any, will be used.

This proxy preparer can be overridden programmatically by the JSC Service.

element service-instance/discovery
diagram
namespace http://www.cheiron.org/seven-config
type seven:discovery
properties
isRef 0
content complex
children multicast-interfaces constraints proxy-preparer
attributes
Name  Type  Use  Default  Fixed  Annotation
protocol-version  int      
documentation 
Controls the version of the multicast request and unicast discovery protocol used, if not specified the protocol version used will depend on whether there are any required or preferred constraints specified.

Setting the protocol version is only recommended in case the lookup services to contact don't support particular versions of the discovery protocol, otherwise the most efficient protocol will be selected.
multicast-request-host  NMTOKEN      
documentation 
The host name to include in multicast requests if participating in version 2 of the multicast request protocol.
multicast-ttl  int      
documentation 
The time to live (TTL) value set on outgoing multicast request packets.
unicast-socket-timeout  int  15000    
documentation 
The read timeout in milliseconds set on sockets over which unicast discovery is performed.
unicast-connection-timeout  int  15000    
documentation 
The connection timeout in milliseconds set on sockets over which unicast discovery is performed.
annotation
documentation 
Controls the discovery protocols, both multicast as unicast, used by service finders as well as for the join management and controls proxy preparation of lookup service proxies.

If not specified the discovery configuration at the container level, if any, will be used.

element service-instance/join-scope
diagram
namespace http://www.cheiron.org/seven-config
type seven:join-scope
properties
isRef 0
content complex
children member-group locator-uri locator constrainable-locator
annotation
documentation 
Scope for lookup services the service will be registered with.

In case no scope is provided here, and also not at the container level, this is equivalent to DiscoveryScope.VOID and no joining will take place.

element service-instance/configuration
diagram
namespace http://www.cheiron.org/seven-config
type seven:configuration
properties
isRef 0
content complex
children config-def ext-config expr-value
annotation
documentation 
Configuration for service instance wide elements.

complexType socket-handler
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-handler
properties
base seven:log-handler
children level-filter message-filter throwable-filter context-filter
used by
element logger/socket-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
host  NMTOKENrequired      
documentation 
Host name or IPv4/IPv6 address of host where socket-log daemon is running.
port  shortrequired      
documentation 
Port number the socket-log daemon is listening on.
annotation
documentation 
Publish log records to a network stream connection.

complexType syslog-handler
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-handler
properties
base seven:log-handler
children level-filter message-filter throwable-filter context-filter
used by
element logger/syslog-handler
attributes
Name  Type  Use  Default  Fixed  Annotation
level  seven:log-level  ALL    
documentation 
Sets the level specifying which messages will be logged, messages lower than this level will be ignored.

By setting the level to OFF the handler can be disabled, by setting the level to ALL every message will be logged.
encoding  NCName      
documentation 
Sets the character encoding to be used.

If not specified the default character encoding of the platform will be used.
formatter    simple    
documentation 
Formatter used for formatting the log records, supported are simple, plain and xml.

Some handlers may however ignore this settings, because they have a fixed log format, e.g. syslog.
context-info  boolean  false    
documentation 
Indicates whether context information should be displayed when it is available.

The context information is the OID of the service group definition and the identifier of the service group in which the entity performed the logging.
flood-control  boolean  true    
documentation 
If enabled protects this handler from log flooding. Only the first log event will be published, and a summary for the repetition events.

Currently only log flooding is detected for events one frame deep.
match-all-filters  boolean  false    
documentation 
Indicates whether the log record tested must match all optional filters, or that it has to match only one filter.

The default is to match any optional filter.
facility  short  1    
documentation 
Well know syslog facility to use, value must be between 0 - 23.

If not set the default value is facility 1, meaning user-level messages.
tag  NCName  Seven    
documentation 
Tag to identify the process sending syslog messages.

If not set the default value is 'Seven'.
syslog-host  NMTOKEN      
documentation 
Host name or IPv4/IPv6 address of host where syslog daemon is running.

If not set the default value is the IP number of the localhost.
time-zone  NCName      
documentation 
Time zone to use for generating the time stamps in the syslog messages.

If not set the default time zone of the platform will be taken.
annotation
documentation 
Publish log records to a syslog daemon, the format of the syslog packets sent adhere to RFC 3164, see http://www.faqs.org/rfcs/rfc3164.html.

The MSG part of the syslog packet contains the log level, the (optional) class name and method that that issued the log request and the actual message, in case a stacktrace is part of the log record the message and the first stack frame will be part of the MSG part. Summarized the MSG part is formatted as follows: [log level] [source method] message <exception message at first stack frame>. As required by RFC 3164 the syslog packet is not allowed to exceed 1024 bytes and therefore the message might be truncated.

The J2SE log levels are mapped to the syslog severity levels as follows: SEVERE=2, WARNING=4, INFO=6 and all other log levels are mapped to syslog severty 7.

complexType throwable-filter
diagram
namespace http://www.cheiron.org/seven-config
type extension of seven:log-filter
properties
base seven:log-filter
used by
elements logger/throwable-filter log-handler/throwable-filter forward-handler/throwable-filter
attributes
Name  Type  Use  Default  Fixed  Annotation
negate  boolean  false    
documentation 
Indicates whether the result of the expression represented by this filter must be negated.
class  string      
documentation 
Class name of Throwable or subclass that will be filtered.

All records for which instanceof 'class' returns true will be filtered. If not provided all records containing a Throwable will be filtered.
annotation
documentation 
Will only log records that contain a throwable, of a specific type if needed.

simpleType log-level
namespace http://www.cheiron.org/seven-config
type restriction of Name
used by
attributes level-filter/@end logger/@level log-handler/@level level-filter/@start
facets
enumeration AUDIT
enumeration SEVERE
enumeration OPERATOR
enumeration WARNING
enumeration INFO
enumeration CONFIG
enumeration FAILED
enumeration HANDLED
enumeration FINE
enumeration FINER
enumeration FINEST
enumeration OFF
enumeration ALL
annotation
documentation 
All log levels defined in J2SE together with those specified for seven.

element jsc:jsc-descriptor
diagram
namespace http://www.cheiron.org/jsc
properties
content complex
children service-group-def service-def
annotation
documentation 
Deployment descriptor for JSC Service Group Definition and accompanying instance definitions.

element jsc:jsc-descriptor/service-group-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:service-group-def
properties
isRef 0
content complex
children description-group jar dl-jar grant-def connector-def config-def
attributes
Name  Type  Use  Default  Fixed  Annotation
oid  jsc:numeric-oidrequired      
documentation 
Unique OID (Object Identifier) for the service group definition.
group-shareable  boolean  false    
documentation 
Indicates whether these JSC Services are developed to be capable of having multiple instances running within a single service group (class loader).

Making a JSC Service group-shareable allows you deploy singleton services, i.e. a single service can be deployed in multiple ways while sharing the same state.
version  jsc:version-numberrequired      
documentation 
Version number that identifies the functionality offered by this service group definition.
build  unsignedInt      
documentation 
Optional number to indicate the build number associated with this version.
				
The build number can be used to distinguish between service group definitions that have exactly the same version number.
identity constraints
  Name  Refer  Selector  Field(s)  
unique  service-group-def-context    .//*  @id  
keyref  service-group-def-help-ref  jsc:service-group-def-context  .//help  @ref-id  
unique  service-group-def-expr    .//expr  @id  
keyref  service-group-def-expr-ref  jsc:service-group-def-expr  .//expr-ref  @expr-id  
annotation
documentation 
Definition of a group of related services that can be run within one name space if requested.

element jsc:jsc-descriptor/service-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:service-def
properties
isRef 0
content complex
children description-group grant-def config-def
attributes
Name  Type  Use  Default  Fixed  Annotation
class  IDrequired      
documentation 
Full qualified class name of object implementing org.cheiron.jsc.JiniService
identity constraints
  Name  Refer  Selector  Field(s)  
unique  service-def-context    .//*  @id  
keyref  service-def-help-ref  jsc:service-def-context  .//help  @ref-id  
unique  service-def-expr    .//expr  @id  
keyref  service-def-expr-ref  jsc:service-def-expr  .//expr-ref  @expr-id  
annotation
documentation 
Service definitions representing an individual JSC Service.

complexType jsc:config-def
diagram
namespace http://www.cheiron.org/jsc
properties
mixed true
children expr expr-ref
used by
elements container/config-def ext-configuration/config-def configuration/config-def jsc:service-group-def/config-def jsc:service-def/config-def jsc:service-group-def/connector-def
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
annotation
documentation 
Configuration source according to the syntax of net.jini.config.ConfigurationFile with additional expression support.

element jsc:config-def/expr
diagram
namespace http://www.cheiron.org/jsc
type jsc:expr
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNamerequired      
documentation 
Unique identifier for the expression.
category  jsc:expr-categoryoptional  REQUIRED    
documentation 
Category an expression belongs too.
type  normalizedStringoptional      
documentation 
@todo: Expected type for expression value associated with expression, allowed identifiers are: Java literals, binary class/interface name, name array class, and the JSC literal: 'string', 'multistring', 'text' and 'character'.

The JSC literal 'string' is an identifier for a Java String literal, while the JSC literal 'multistring' represents a comma separated list of Java String literals. The JSC literal 'text' can be used as a shortcut for the String literal, in a way that the double quotes around the character can be ommited in the expression value. The JSC literal 'character' can be used as a shortcut for the Character literal, in a way that the single quotes around the character can be ommited in the expression value.
annotation
documentation 
Expression to be substituted at deployment time by an expression value.

element jsc:config-def/expr-ref
diagram
namespace http://www.cheiron.org/jsc
type jsc:expr-ref
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
expr-id  NCNamerequired      
documentation 
Identifier refering to declared expression.

The scope is not limited to expressions definied in the context of grants but may refer to any expression within the same context, e.g. service group definition or service definition.
annotation
documentation 
Identifier refering to declared expression.

complexType jsc:description
diagram
namespace http://www.cheiron.org/jsc
type extension of jsc:i18n-content
properties
base jsc:i18n-content
used by
elements jsc:description-group/description service-instance/purpose
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
annotation
documentation 
The description type is used by a description element to provide text describing the parent element. The elements that use this type should include any information that the Deployment Component's Deployment File file producer wants to provide to the consumer of the Deployment Component's Deployment File (i.e., to the Deployer). Typically, the tools used by such a Deployment File consumer will display the description when processing the parent element that contains the description.

This type is also used for comments in configuration objects to provide information about the configurable entries.

The lang attribute defines the language that the description is provided in. The default value is 'en' (English).

complexType jsc:description-group
diagram
namespace http://www.cheiron.org/jsc
children description display-name icon help
used by
elements jsc:service-group-def/description-group jsc:service-def/description-group
annotation
documentation 
Provides description for parent element.

The description may consist of a human readable explanation of what the parent element servces for, as well as icons and display names for use by GUI tools.

element jsc:description-group/description
diagram
namespace http://www.cheiron.org/jsc
type jsc:description
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
annotation
documentation 
Description for parent element.

element jsc:description-group/display-name
diagram
namespace http://www.cheiron.org/jsc
type jsc:display-name
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
annotation
documentation 
Display name for use in GUI tools.

element jsc:description-group/icon
diagram
namespace http://www.cheiron.org/jsc
type jsc:icon
properties
isRef 0
content complex
children small-icon large-icon
annotation
documentation 
Icon representing the parent element in GUI tools.

element jsc:description-group/help
diagram
namespace http://www.cheiron.org/jsc
type jsc:help-message
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
ref-id  NCNamerequired      
documentation 
Identifier refering to element this is a help message for.
annotation
documentation 
Help messages for expressions and permissions defined in deployment descriptor.

complexType jsc:display-name
diagram
namespace http://www.cheiron.org/jsc
type extension of jsc:i18n-content
properties
base jsc:i18n-content
used by
element jsc:description-group/display-name
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
annotation
documentation 
The display-name type contains a short name that is intended to be displayed by tools.

The lang attribute defines the language that the display-name is provided in. The default value is 'en' (English).

complexType jsc:entry
diagram
namespace http://www.cheiron.org/jsc
type extension of base64Binary
properties
base base64Binary
used by
element join-scope/constrainable-locator
attributes
Name  Type  Use  Default  Fixed  Annotation
name  NCName      
documentation 
Identifier for entry, can be useful in case of exception when unmarshalling the entry.
annotation
documentation 
Specifies a serialized net.jini.core.entry.Entry object.

The entry is an Entry object, or an Entry contained in a java.rmi.MarshalledObject or net.jini.io.MarshalledInstance object that has been serialized as a Base64 byte stream.

complexType jsc:expr
diagram
namespace http://www.cheiron.org/jsc
type extension of string
properties
base string
used by
elements jsc:permission/expr jsc:config-def/expr
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNamerequired      
documentation 
Unique identifier for the expression.
category  jsc:expr-categoryoptional  REQUIRED    
documentation 
Category an expression belongs too.
type  normalizedStringoptional      
documentation 
@todo: Expected type for expression value associated with expression, allowed identifiers are: Java literals, binary class/interface name, name array class, and the JSC literal: 'string', 'multistring', 'text' and 'character'.

The JSC literal 'string' is an identifier for a Java String literal, while the JSC literal 'multistring' represents a comma separated list of Java String literals. The JSC literal 'text' can be used as a shortcut for the String literal, in a way that the double quotes around the character can be ommited in the expression value. The JSC literal 'character' can be used as a shortcut for the Character literal, in a way that the single quotes around the character can be ommited in the expression value.
annotation
documentation 
Describes the expression to be substituted at deployment time.

This expression may contain a valid value that can server as the default, in case it is not being substituted at deployment time.

complexType jsc:expr-ref
diagram
namespace http://www.cheiron.org/jsc
used by
elements jsc:permission/expr-ref jsc:config-def/expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
expr-id  NCNamerequired      
documentation 
Identifier refering to declared expression.

The scope is not limited to expressions definied in the context of grants but may refer to any expression within the same context, e.g. service group definition or service definition.
annotation
documentation 
Reference to declared expression.

Enables reuse of expressions within grant definitions, configuration definition, etc.

complexType jsc:expr-value
diagram
namespace http://www.cheiron.org/jsc
type extension of string
properties
base string
used by
elements container/expr-value configuration/expr-value
attributes
Name  Type  Use  Default  Fixed  Annotation
expr-id  NCNamerequired      
annotation
documentation 
Reference to id of expression.

complexType jsc:grant-def
diagram
namespace http://www.cheiron.org/jsc
children permission
used by
elements jsc:service-group-def/grant-def jsc:service-def/grant-def
annotation
documentation 
Collection of permission that needs to be granted to give access to system resources.

These grants may have unresolved expressions that have to be substituted by the deployment configuration.

element jsc:grant-def/permission
diagram
namespace http://www.cheiron.org/jsc
type jsc:permission
properties
isRef 0
content complex
mixed true
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
class  NCNamerequired      
documentation 
Full qualified class extending the java.security.Permission object or one of its subclasses.
actions  normalizedString      
documentation 
Action list telling the actions permitted.
subject  boolean  false    
documentation 
Indicates the permission is must only be granted when a non-empty subject is executing the code.
connector-id  NCName      
documentation 
Identifiers of connector definition this permission is associated with, if not don't specify it.

This permission will only be granted in case the connector definition is being deployed.
id  NCName      
documentation 
Unique identifier for permission to be referenced by help messages.
annotation
documentation 
Permission to be granted.

Content is the name component of the permission.

Property expansion for system properties and the file seperator is supported through the notation of ${some.property} and ${/}, nesting is not allowed. 

complexType jsc:help-message
diagram
namespace http://www.cheiron.org/jsc
type extension of jsc:i18n-content
properties
base jsc:i18n-content
used by
elements container/help service-group/help service-instance/help jsc:description-group/help
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
ref-id  NCNamerequired      
documentation 
Identifier refering to element this is a help message for.
annotation
documentation 
General help message for element that are related to administration tasks.

E.g. provides an explanation of the value that has to be entered for the expression, or the purpose of an permission. This element can be seen as a help or tooltip.

The lang attribute defines the language that the description is provided in. The default value is 'en' (English).

complexType jsc:i18n-content
diagram
namespace http://www.cheiron.org/jsc
type extension of string
properties
base string
abstract true
used by
complexTypes jsc:description jsc:display-name jsc:help-message
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:lang    en    
documentation 
Language used for content, defaults to 'en' (English).
annotation
documentation 
The internationalized content element can be used for creating elements that can have multiple languages attached to it.

The lang attribute defines the language that the content is provided in.

complexType jsc:icon
diagram
namespace http://www.cheiron.org/jsc
children small-icon large-icon
used by
element jsc:description-group/icon
annotation
documentation 
The icon type contains small-icon and large-icon elements that specify the file names for small and large GIF or JPEG icon images used to represent the parent element in a GUI.

element jsc:icon/small-icon
diagram
namespace http://www.cheiron.org/jsc
type anyURI
properties
isRef 0
content simple
annotation
documentation 
The small-icon element contains the name of a file containing a small (16 x 16) icon image. The file name is a relative path within the Service ARchive images directory.

The image may be either in the GIF, JPEG or PNG format, with a file extension of gif, jpg, jpeg or png.

element jsc:icon/large-icon
diagram
namespace http://www.cheiron.org/jsc
type anyURI
properties
isRef 0
content simple
annotation
documentation 
The large-icon element contains the name of a file containing a large (32 x 32) icon image. The file name is a relative path within the Service ARchive images directory.

The image may be either in the GIF, JPEG or PNG format, with a file extension of gif, jpg, jpeg or png.

complexType jsc:permission
diagram
namespace http://www.cheiron.org/jsc
properties
mixed true
children expr expr-ref
used by
element jsc:grant-def/permission
attributes
Name  Type  Use  Default  Fixed  Annotation
class  NCNamerequired      
documentation 
Full qualified class extending the java.security.Permission object or one of its subclasses.
actions  normalizedString      
documentation 
Action list telling the actions permitted.
subject  boolean  false    
documentation 
Indicates the permission is must only be granted when a non-empty subject is executing the code.
connector-id  NCName      
documentation 
Identifiers of connector definition this permission is associated with, if not don't specify it.

This permission will only be granted in case the connector definition is being deployed.
id  NCName      
documentation 
Unique identifier for permission to be referenced by help messages.
annotation
documentation 
Represents a permission that can grant a particular type of access to a system resource.

The content for this element represents the name attribute of the permission. In case there are expressions used in it these have to be resolved at deployment time, very much as with the configuration definition.

element jsc:permission/expr
diagram
namespace http://www.cheiron.org/jsc
type jsc:expr
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNamerequired      
documentation 
Unique identifier for the expression.
category  jsc:expr-categoryoptional  REQUIRED    
documentation 
Category an expression belongs too.
type  normalizedStringoptional      
documentation 
@todo: Expected type for expression value associated with expression, allowed identifiers are: Java literals, binary class/interface name, name array class, and the JSC literal: 'string', 'multistring', 'text' and 'character'.

The JSC literal 'string' is an identifier for a Java String literal, while the JSC literal 'multistring' represents a comma separated list of Java String literals. The JSC literal 'text' can be used as a shortcut for the String literal, in a way that the double quotes around the character can be ommited in the expression value. The JSC literal 'character' can be used as a shortcut for the Character literal, in a way that the single quotes around the character can be ommited in the expression value.
annotation
documentation 
Expression to be substituted at deployment time by an expression value.

element jsc:permission/expr-ref
diagram
namespace http://www.cheiron.org/jsc
type jsc:expr-ref
properties
isRef 0
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
expr-id  NCNamerequired      
documentation 
Identifier refering to declared expression.

The scope is not limited to expressions definied in the context of grants but may refer to any expression within the same context, e.g. service group definition or service definition.
annotation
documentation 
Identifier refering to declared expression.

complexType jsc:service-def
diagram
namespace http://www.cheiron.org/jsc
children description-group grant-def config-def
used by
element jsc:jsc-descriptor/service-def
attributes
Name  Type  Use  Default  Fixed  Annotation
class  IDrequired      
documentation 
Full qualified class name of object implementing org.cheiron.jsc.JiniService
annotation
documentation 
Service Instance Definition, used by JSC implementation for creating service instances.

element jsc:service-def/description-group
diagram
namespace http://www.cheiron.org/jsc
type jsc:description-group
properties
isRef 0
content complex
children description display-name icon help
annotation
documentation 
Provides a description of the purpose of this particular service definition.

element jsc:service-def/grant-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:grant-def
properties
isRef 0
content complex
children permission
annotation
documentation 
Grants required for running code specific to a service definition.

Grants for code that is common to various service definitions should be specified at the service-group-def level.

element jsc:service-def/config-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:config-def
properties
isRef 0
content complex
mixed true
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
annotation
documentation 
Template for general service configuration, expressions have to be substituted before deployment.

complexType jsc:service-group-def
diagram
namespace http://www.cheiron.org/jsc
children description-group jar dl-jar grant-def connector-def config-def
used by
element jsc:jsc-descriptor/service-group-def
attributes
Name  Type  Use  Default  Fixed  Annotation
oid  jsc:numeric-oidrequired      
documentation 
Unique OID (Object Identifier) for the service group definition.
group-shareable  boolean  false    
documentation 
Indicates whether these JSC Services are developed to be capable of having multiple instances running within a single service group (class loader).

Making a JSC Service group-shareable allows you deploy singleton services, i.e. a single service can be deployed in multiple ways while sharing the same state.
version  jsc:version-numberrequired      
documentation 
Version number that identifies the functionality offered by this service group definition.
build  unsignedInt      
documentation 
Optional number to indicate the build number associated with this version.
				
The build number can be used to distinguish between service group definitions that have exactly the same version number.
annotation
documentation 
JSC Service Group Definition, specifies a collection of JSC services.

element jsc:service-group-def/description-group
diagram
namespace http://www.cheiron.org/jsc
type jsc:description-group
properties
isRef 0
content complex
children description display-name icon help
annotation
documentation 
Provides a description of the collection of JSC Services.

element jsc:service-group-def/jar
diagram
namespace http://www.cheiron.org/jsc
type Name
properties
isRef 0
content simple
annotation
documentation 
Specifies order of jar files on the class path of the JSC Service Group Definition.

Jar files being part of the service definition and not listed here are put on the class path in a container implementation specific order, but always after the jar files listed here.

element jsc:service-group-def/dl-jar
diagram
namespace http://www.cheiron.org/jsc
type Name
properties
isRef 0
content simple
annotation
documentation 
Specifies order of download jar files on the class path of the JSC Service Group Definition.

Jar files being part of the service definition and not listed here are put on the class path in a container implementation specific order, but always after the download jar files listed here.

element jsc:service-group-def/grant-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:grant-def
properties
isRef 0
content complex
children permission
annotation
documentation 
Grants required for running code common to the various service definitions.

Grants for code that is specific to the service definition should be specified at the service-def level.

element jsc:service-group-def/connector-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:config-def
properties
isRef 0
content complex
mixed true
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
annotation
documentation 
Connector definitions defined at development time and that can be selected in the deployment configuration.

Within this definition each component represents a connector that can be selected at deployment time.

In case the connector definitions require additional grants these have to be specified at the grant definitions.

element jsc:service-group-def/config-def
diagram
namespace http://www.cheiron.org/jsc
type jsc:config-def
properties
isRef 0
content complex
mixed true
children expr expr-ref
attributes
Name  Type  Use  Default  Fixed  Annotation
id  NCNameoptional      
documentation 
Unique identifier for the connector definition, can be used as ID for help messages.
annotation
documentation 
Template for general service configuration, any expressions have to be substituted before deployment.

The syntax used for the configuration is that of net.jini.config.ConfigurationFile.

simpleType jsc:expr-category
namespace http://www.cheiron.org/jsc
type restriction of Name
used by
attribute jsc:expr/@category
facets
enumeration REQUIRED
enumeration ADVANCED
enumeration EXPERT
annotation
documentation 
All categories an expression can have.

The category is an important indicator for the deployer about the importance to provide an expression value for that particular expression.

simpleType jsc:numeric-oid
namespace http://www.cheiron.org/jsc
type restriction of NMTOKEN
used by
element container/jsc-unit-ref
attributes jsc-unit/@oid context-filter/@oid jsc:service-group-def/@oid
facets
pattern [0-9]+(\.[0-9]+)+
annotation
documentation 
Numerical object identifier as specified by the ITU (International Telecommunication union). The use of numerical OIDs will prevent from ambiguous identifiers.

One can obtain without much hasle and without any costs a OID prefix (private enterprise number) from IANA at:

    http://www.iana.org/cgi-bin/enterprise.pl

The syntax for a numerical OID is in BNF:

    numericoid ::= numericstring | numericstring '.' numericoid

    numericstring ::= digit | digit numericstring

    digit ::= '0' | '1' | '2' | '3' | '4' |
              '5' | '6' | '7' | '8' | '9'

simpleType jsc:version-number
namespace http://www.cheiron.org/jsc
type restriction of NMTOKEN
used by
attributes service-group/@version jsc:service-group-def/@version
facets
pattern [0-9]+(\.[0-9]+)*([a-z_\-]+[0-9]*)?
annotation
documentation 
Version number to keep track of evolution of service definition.

The syntax for a version number is in BNF:

    versionnumber ::= numericstring | numericstring lowercasestring |
                      numericstring lowercasestring numericstring |
                      numericstring '.' versionnumber

    numericstring ::= digit | digit numericstring

    lowercasestring ::= lower | lower lowercasestring

    lower ::= 'a' | 'b' | 'c' | 'd' | 'e' |
              'f' | 'g' | 'h' | 'i' | 'j' |
              'k' | 'l' | 'm' | 'n' | 'o' |
              'p' | 'q' | 'r' | 's' | 't' |
              'u' | 'v' | 'w' | 'x' | 'y' |
              'z' | '_' | '-'

    digit ::= '0' | '1' | '2' | '3' | '4' |
              '5' | '6' | '7' | '8' | '9'

attributeGroup specialAttrs
namespace http://www.w3.org/XML/1998/namespace
attributes
Name  Type  Use  Default  Fixed  Annotation
xml:base        
documentation 
See http://www.w3.org/TR/xmlbase/ for
                     information about this attribute.
xml:lang        
documentation 
Attempting to install the relevant ISO 2- and 3-letter
         codes as the enumerated possible values is probably never
         going to be a realistic possibility.  See
         RFC 3066 at http://www.ietf.org/rfc/rfc3066.txt and the IANA registry
         at http://www.iana.org/assignments/lang-tag-apps.htm for
         further information.

         The union allows for the 'un-declaration' of xml:lang with
         the empty string.
xml:space