SERVICE

SERVICE

Used in: Application Server RESPONSE Application Server Administration
Parent elements: SERVICES

<SERVICE	Attribute Description Table
When parent element is SERVICES in ADMINCMD while adding a Feature Service: *axl ="string"* *name ="string"* type ="add" *vsname ="string"* When parent element is SERVICES in ADMINCMD while adding an Image or ArcMap Image Service: *axl ="string"* *cleanup ="integer"* *imgloc ="string"* *imgurl ="string"* *vsname ="string"* imgtype ="JPG \| PNG8 \| PNG \| GIF" [JPG] When parent element is SERVICES in ADMINCMD while adding an Image Service: imagememory ="1-NNN" *name ="string"* type ="add" When parent element is SERVICES in ADMINCMD while removing, starting, or stopping an ArcIMS service: *name ="string"* type ="remove \| start \| stop" When parent element is SERVICES in Application Server RESPONSE: access ="PUBLIC \| PRIVATE" *name ="string"* *servicegroup ="string"* status ="ENABLED \| DISABLED" *type ="string"* > When parent element is SERVICES in ADMINCMD: No Child Elements When parent element is SERVICES in Application Server RESPONSE: <CLEANUP... /> <ENVIRONMENT... /> </SERVICE >
Bold: Attribute or child element is required.

Description:

In an application server RESPONSE, SERVICE returns information for each ArcIMS service on the specified host or server.
When used in application server administration, SERVICE contains the information needed to start a service from a command line.

Restrictions:

None

Notes:

SERVICE inside of ADMINCMD is used to administer ArcIMS services from the command line. To do this, two files are used:
- An ADMINCMD XML file.
- A batch file or script.
The ADMINCMD XML file contains the instructions for adding, starting, stopping, and removing services. See the examples for proper construction of an ADMINCMD XML file.

On Windows, the batch file contains one line:

java com.esri.aims.admincore.cmd.Exec http://mymachine.domain.com Username Password file filename

Where:
- http://mymachine.domain.com is the host machine.
- Username is the user name used to log into ArcIMS Administrator or Manager.
- Password is the password used to log into ArcIMS Administrator or Manager.
- Filename is the full pathname and name of the ADMINCMD XML file, for example, c:\arcims\axl\admincmd.xml.
- Note: the parameter "file" must be included before the filename.
The above command can also be typed on the command line in lieu of using the batch file.

On UNIX, a script file is used. An example script is:
#!/bin/csh

setenv JARHOME $AIMSHOME/Manager/lib
setenv AIMSHOST $argv[1]

java -cp
$JARHOME/jaxp.jar:$JARHOME/parser.jar:$JARHOME/esri_mo10.jar: $JARHOME/esri_mo10res.jar:$JARHOME/arcims_admincore.jar:$JARHOME/arcims_admin.jar: $JARHOME/jcert.jar:$JARHOME/jnet.jar:$JARHOME/jsse.jar:$JARHOME/arcims_resadmin.jar com.esri.aims.admincore.cmd.Exec http://$AIMSHOST admin admin file $argv[2]

Where:
- $argv[1] is the hostname.
- $argv[2] is the name of the ADMINCMD XML file, for example, admincmd.xml.
- Note: the parameter "file" must be included before $argv[2].

Attribute Descriptions for SERVICE:

When parent element is SERVICES in ADMINCMD while adding a Feature Service:

Attribute	Usage	Back to Top
axl	1 Full pathname to map configuration file.
name	2 Name of ArcIMS service. Service names are case sensitive.
type	3 Type of action on service.
vsname	4 Virtual Server name for assigning ArcIMS service.

When parent element is SERVICES in ADMINCMD while adding an Image or ArcMap Image Service:

Attribute	Usage	Back to Top
axl	1 Full pathname to map configuration file or ArcMap document.
cleanup	2 Interval for the number of minutes between the deletion of image files from the Output directory.
imgloc	3 Full pathname to Output directory for generated map and legend images.
imgtype	4 Image format for the output map images.
imgurl	5 URL to Output directory for generated map and legend images.
vsname	6 Virtual Server name for assigning ArcIMS service.

When parent element is SERVICES in ADMINCMD while adding an Image Service:

Attribute	Usage	Back to Top
imagememory	1 Maximum size of map image allowed in megabytes. A one megabyte image is approximately 512 x 512 pixels, or 262144 pixels total.
name	2 Name of ArcIMS service. Service names are case sensitive.
type	3 Type of action on service.

When parent element is SERVICES in ADMINCMD while removing, starting, or stopping an ArcIMS service:

Attribute	Usage	Back to Top
name	1 Name of ArcIMS service. Service names are case sensitive.
type	2 Type of action on service.

When parent element is SERVICES in Application Server RESPONSE:

Attribute	Usage	Back to Top
access	1 Access type of the Virtual Server. PUBLIC means that the Virtual Server and ArcIMS service can be accessed directly by requests from a client. By default, Image, Feature, ArcMap, and Metadata Servers are public. When access is PRIVATE, Virtual Servers are accessed by redirecting requests from a public server to a private one. Private virtual servers include Geocode, Query, and Extract Servers.
name	2 Name of service running on host machine.
servicegroup	3 Virtual Server name to which the specified ArcIMS service belongs.
status	4 Identifies if service is currently running or not.
type	5 Virtual Server type to which the specified ArcIMS service belongs.

Examples for SERVICE:

Example 1: An ADMINCMD XML file for adding and starting an ArcIMS service from the command line.

Back to Top

<?xml version="1.0"?>
<ADMINCMD version="1.0">
  <SERVICES>
    <SERVICE type="add" name="world_image"
          axl="c:\arcims\axl\world.axl"
          vsname="ImageServer1"
          imgloc="c:\arcims\output"
          imgurl="http://mycomputer.domain.com/output"
          imagememory="4"
          cleanup="20"
          imgtype="JPG" />

    <SERVICE type="start" name="world_image" />

    <SERVICE type="add" name="world_arcmap"
          axl="c:\arcims\axl\world.mxd"
          vsname="ImageServerArcMap1"
          imgloc="c:\arcims\output"
          imgurl="http://mycomputer.domain.com/output"
          imagememory="4"
          cleanup="20"
          imgtype="JPG" />

    <SERVICE type="start" name="world_arcmap" />

    <SERVICE type="add" name="world_feature"
          axl="c:\arcims\axl\world.axl"
          vsname="FeatureServer1"
/>

    <SERVICE type="start" name="world_feature" />

  </SERVICES>
</ADMINCMD>

Example 2: An ADMINCMD XML file for stopping and deleting an ArcIMS service from the command line.	Back to Top
<?xml version="1.0"?> <ADMINCMD version="1.0"> <SERVICES> <SERVICE type="stop" name="world_image" /> <SERVICE type="remove" name="world_image" /> </SERVICES> </ADMINCMD>

Example 3: When in an application server RESPONSE to GETCLIENTSERVICES.

Back to Top

<?xml version="1.0"?>
<ARCXML version="1.1">
<RESPONSE>
  <SERVICES>
    <SERVICE name="world_feature" servicegroup="FeatureServer1" access="PUBLIC" type="FeatureServer" desc=""  status="ENABLED" >
      <ENVIRONMENT>
        <LOCALE country="US" language="en" />
        <UIFONT name="Arial" />
      </ENVIRONMENT>
      <CLEANUP interval="20" />
    </SERVICE>
    <SERVICE name="world_image" servicegroup="ImageServer1" access="PUBLIC" type="ImageServer" desc=""  status="ENABLED" >
      <ENVIRONMENT>
        <LOCALE country="US" language="en" />
        <UIFONT name="Arial" />
      </ENVIRONMENT>
      <CLEANUP interval="20" />
    </SERVICE>
  </SERVICES>
</RESPONSE>
</ARCXML>