D.39 tarantella object new_charapp

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


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


The following table shows the available options for this command.



More Information


The common name of the object in the SGD datastore.

Section C.2.87, “Name”


The type of emulation required for the application.

Section C.2.47, “Emulation Type”


The terminal type required for the application.

Section C.2.111, “Terminal Type”


The width of the application, in pixels.

Section C.2.134, “Window Size: Width”


The height of the application, in pixels.

Section C.2.128, “Window Size: Height”


A text description of the object.

Section C.2.29, “Comment”


Full path name of the application.

Section C.2.4, “Application Command”


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

Section C.2.11, “Arguments for Command”


The application servers that can run the application.

Section C.2.61, “Hosting Application Servers Tab”


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

Section C.2.32, “Connection Method”


Resumability behavior for the application.

Section C.2.6, “Application Resumability”


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

Section C.2.88, “Number of Sessions”


How the application is displayed to the user.

Section C.2.135, “Window Type”


The initial size of the application.

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


The number of columns in the terminal window.

Section C.2.127, “Window Size: Columns”


The number of lines in the terminal window.

Section C.2.129, “Window Size: Lines”


Workspace icon for the application.

Section C.2.64, “Icon”


String containing additional name-value data for the application.

Section C.2.59, “Hints”


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

Section C.2.52, “Font Family”


Defines the font size in the terminal window.

Section C.2.53, “Font Size”


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

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


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

Section C.2.70, “Line Wrapping”


Cursor style used for the application.

Section C.2.38, “Cursor”


Specifies the type of status line.

Section C.2.108, “Status Line”


The scroll behavior of the terminal window.

Section C.2.100, “Scroll Style”


The border style for the terminal window.

Section C.2.18, “Border Style”


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

Section C.2.3, “Answerback Message”


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

Section C.2.67, “Keyboard Codes Modification”


Specifies the behavior of the cursor keys.

Section C.2.89, “Numpad Codes Modification”


Specifies the behavior of the cursor keys.

Section C.2.39, “Cursor Key Codes Modification”


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

Section C.2.50, “Escape Sequences”


The code page to use for the emulator.

Section C.2.23, “Code Page”


Assigns the application to the specified LDAP users.

Section C.2.13, “Assigned User Profiles Tab”


Assigns the application to the specified LDAP groups.

Section C.2.13, “Assigned User Profiles Tab”


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

Section C.2.13, “Assigned User Profiles Tab”


Load balancing algorithm to use.

Section C.2.5, “Application Load Balancing”


Whether the AIP protocol compresses commands for transmission.

Section C.2.27, “Command Compression”


Environment variable settings needed to run the application.

Section C.2.49, “Environment Variables”


The login script used to start the application.

Section C.2.75, “Login Script”


Path name of a keyboard map file.



The attribute map to use for the application.

Section C.2.14, “Attribute Map”


The color map to use for the application.

Section C.2.25, “Color Map”


Number of minutes the application is resumable for.

Section C.2.7, “Application Resumability: Timeout”


Effect on application session of closing the main application window.

Section C.2.121, “Window Close Action”


Command-line arguments for the ssh client.

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


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.


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" \