D.36. tarantella object new_charapp

Creates one or more character application objects. See Section C.1.4, “Character Application Object”.

Syntax

tarantella object new_charapp {
   --name obj
   --emulator scocon|vt420|wyse60
   --termtype type
   --width pixels
   --height pixels
 [ --description text ]
 [ --app pathname ]
 [ --args args ]
 [ --appserv obj... ]
 [ --method telnet|ssh ]
 [ --resumable never|session|always ]
 [ --maxinstances 0|instances ]
 [ --displayusing independent|kiosk ]
 [ --maximize true|false ]
 [ --cols cols ]
 [ --lines lines ]
 [ --icon icon_name ]
 [ --hints hint...]
 [ --font courier|helvetica|timesroman ]
 [ --fontsize points ]
 [ --fixedfont true|false ]
 [ --autowrap true|false ]
 [ --cursor off|block|underline ]
 [ --statusline none|indicator|hostmessages|standard|extended ]
 [ --scrollstyle line|multiple|smooth ]
 [ --border normal|indented|raised ]
 [ --answermsg message ]
 [ --appkeymode true|false ]
 [ --keypad numeric|application ]
 [ --cursorkeys application|cursor ]
 [ --escape 7-bit|8-bit ]
 [ --codepage 437|850|852|860|863|865|8859-1|8859-2|Multinational|Mazovia|CP852 ]
 [ --ldapusers user_dn... ]
 [ --ldapgroups group_dn... ]
 [ --ldapsearch search_string... ]
 [ --loadbal default|cpu|memory|sessions ]
 [ --compression automatic|on|off ]
 [ --env setting... ]
 [ --login script ]
 [ --keymap keymap ]
 [ --attributemap attrmap ]
 [ --colormap colormap ]
 [ --resumetimeout mins ]
 [ --windowclose suspendsession|endsession ]
 [ --ssharguments args ]
 } | --file file

Description

The following table shows the available options for this command.

Option

Description

More Information

--name

The common name of the object in the SGD datastore.

Section C.2.84, “Name”

--emulator

The type of emulation required for the application.

Section C.2.46, “Emulation Type”

--termtype

The terminal type required for the application.

Section C.2.104, “Terminal Type”

--width

The width of the application, in pixels.

Section C.2.126, “Window Size: Width”

--height

The height of the application, in pixels.

Section C.2.120, “Window Size: Height”

--description

A text description of the object.

Section C.2.29, “Comment”

--app

Full path name of the application.

Section C.2.4, “Application Command”

--args

The command-line arguments to use when starting the application.

Section C.2.11, “Arguments for Command”

--appserv

The application servers that can run the application.

Section C.2.60, “Hosting Application Servers Tab”

--method

The mechanism used by the SGD server to access the application server and start the application.

Section C.2.31, “Connection Method”

--resumable

Resumability behavior for the application.

Section C.2.6, “Application Resumability”

--maxinstances

The maximum number of instances of the application a user can run simultaneously.

Section C.2.85, “Number of Sessions”

--displayusing

How the application is displayed to the user.

Section C.2.127, “Window Type”

--maximize

The initial size of the application.

Section C.2.118, “Window Size: Client's Maximum Size”

--cols

The number of columns in the terminal window.

Section C.2.119, “Window Size: Columns”

--lines

The number of lines in the terminal window.

Section C.2.121, “Window Size: Lines”

--icon

Webtop icon for the application.

Section C.2.61, “Icon”

--hints

String containing additional name-value data for the application.

Section C.2.58, “Hints”

--font

Determines the font family used within the terminal window for the application

Section C.2.51, “Font Family”

--fontsize

Defines the font size in the terminal window.

Section C.2.52, “Font Size”

--fixedfont

Uses the font size specified by --fontsize for the terminal window.

Section C.2.53, “Font Size: Fixed Font Size”

--autowrap

Determines the behavior when a user types characters extending beyond the right edge of the terminal window.

Section C.2.68, “Line Wrapping”

--cursor

Cursor style used for the application.

Section C.2.37, “Cursor”

--statusline

Specifies the type of status line.

Section C.2.101, “Status Line”

--scrollstyle

The scroll behavior of the terminal window.

Section C.2.94, “Scroll Style”

--border

The border style for the terminal window.

Section C.2.18, “Border Style”

--answermsg

Defines the message to return when an inquiry is sent from the application server to the emulator.

Section C.2.3, “Answerback Message”

--appkeymode

Determines whether the application can change the codes generated by keys on the keyboard.

Section C.2.65, “Keyboard Codes Modification”

--keypad

Specifies the behavior of the cursor keys.

Section C.2.86, “Numpad Codes Modification”

--cursorkeys

Specifies the behavior of the cursor keys.

Section C.2.38, “Cursor Key Codes Modification”

--escape

Specifies how escape sequences are sent from the emulator to the application server.

Section C.2.49, “Escape Sequences”

--codepage

The code page to use for the emulator.

Section C.2.23, “Code Page”

--ldapusers

Assigns the application to the specified LDAP users.

Section C.2.13, “Assigned User Profiles Tab”

--ldapgroups

Assigns the application to the specified LDAP groups.

Section C.2.13, “Assigned User Profiles Tab”

--ldapsearch

Assigns the application to the users that match the LDAP search criteria.

Section C.2.13, “Assigned User Profiles Tab”

--loadbal

Load balancing algorithm to use.

Section C.2.5, “Application Load Balancing”

--compression

Whether the AIP protocol compresses commands for transmission.

Section C.2.27, “Command Compression”

--env

Environment variable settings needed to run the application.

Section C.2.48, “Environment Variables”

--login

The login script used to start the application.

Section C.2.73, “Login Script”

--keymap

Path name of a keyboard map file.

 

--attributemap

The attribute map to use for the application.

Section C.2.14, “Attribute Map”

--colormap

The color map to use for the application.

Section C.2.25, “Color Map”

--resumetimeout

Number of minutes the application is resumable for.

Section C.2.7, “Application Resumability: Timeout”

--windowclose

Effect on application session of closing the main application window.

Section C.2.113, “Window Close Action”

--ssharguments

Command-line arguments for the ssh client.

Section C.2.33, “Connection Method: SSH Arguments”

--file

Batch file used to create multiple objects within the organizational hierarchy.

 

To batch-create multiple objects, use the --file option. Use the other options to create a single object.

Examples

The following example creates a character application object for the application Pers-o-dat. The application can be run on the application servers prague and london. Application server load balancing decides which application server to use.

$ tarantella object new_charapp \
--name "o=applications/cn=Pers-o-dat" \
--emulator vt420 --termtype vt220 \
--width 400 --height 300 \
--app /bin/persodat \
--appserv "o=appservers/cn=prague" \
"o=appservers/ou=IT/cn=london"