copy  delete

Chapter 12: Using jagtool and jagant

create

Description

Creates a new entity in the repository.

Syntax

Local mode support: Yes.

Command line:

create [ connect-args | local-args ] entity [file]

Ant build file, specifying properties from an optional file:

<jag_create entity=”entity” [ file=”file”] />

Ant build file, specifying properties directly:

<jag_create entity=”entity” >
  <property name=”name” value=”value” />
   ....
</jag_create>

Option

Description

Required

connect-args | local-args

Arguments to specify a connection to the server or run in local mode. See “Local versus connected mode”.

Yes

entity

The name of the entity being created, in the form EntityType:EntityName.

Yes

file

An optional file containing properties for the entity. The file must specify properties in the form of an EAServer repository properties file.

No

name

The property name. In an Ant build file, you may specify multiple properties as <property> elements.

When setting properties directly in Ant.

value

The property value.

When setting properties directly in Ant.

Returns

Return value

Indicates

0

The command ran successfully; the result is true/success.

2

The command did not run successfully; an exception was thrown.

Examples

Example 1

This example creates a package named NewPackage with the properties defined in the file NewPackage.props.

Example 2

This example creates a package named NewPackage2 and sets the given properties. This alternate syntax allows properties for the new entity to be specified in the command.

Example 3

This example creates a listener called MyListener for the Jaguar server:

Usage

The create command does not perform the installation steps required to run an entity in a particular server. For example, a package or application must be installed in a server before running on that server, and a listener must be installed in the server that it is associated with. Use the install command to install entities into a parent entity.

See also

delete, install, jmscreate





Copyright © 2005. Sybase Inc. All rights reserved. delete