D.37 tarantella object new_3270app

Creates one or more 3270 application objects. See Section C.1.1, “3270 Application Object”.


tarantella object new_3270app {
  --name obj
  --width pixels
  --height pixels 
[ --description text ]
[ --args args ]
[ --method telnet|ssh ]
[ --resumable never|session|always ]
[ --endswhen lastclient|windowmanager|windowmanageralone|
[ --maxinstances 0|instances ]
[ --displayusing clientwm|independent|kiosk]
[ --maximize true|false ]
[ --xrandr true|false ]
[ --scalable true|false ]
[ --icon icon_name ]
[ --hints hint...]
[ --hostname host ]
[ --portnumber tcp ]
[ --3270tnclose 0|1|2|3 ]
[ --3270kt pc|sun4|sun5|hp ]
[ --3270bl 0|1|2|3|4 ]
[ --3270ma true|false ]
[ --3270mb true|false ]
[ --3270si true|false ]
[ --3270fg color ]
[ --3270bg color ]
[ --roottype default|custom ]
[ --rootcolor color ]
[ --compression automatic|on|off ]
[ --execution automatic|inorder|optimized ]
[ --interlaced automatic|on|off ]
[ --accel true|false ]
[ --delayed true|false ]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
[ --env setting... ]
[ --login script ]
[ --winmgr command... ]
[ --resumetimeout mins ]
[ --middlemouse ms ]
[ --windowclose notifyapp|killapp|suspendsession|endsession ]
[ --dpi monitordpi ]
[ --keepopen true|false ]
[ --ssharguments args ]
[ --share true|false ]
} | --file file


SGD uses the third-party TeemTalk for Unix emulator for 3270 applications. See the TeemTalk for Unix User's Guide supplied with SGD for details.

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 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”


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

Section C.2.11, “Arguments for Command”


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”


When the application session ends.

Section C.2.104, “Session Termination”


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”


Enables the RANDR X extension.

Section C.2.132, “Window Size: RandR Extension”


The initial size of the application.

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


Scale the application to fit the window in which it is displayed.

Section C.2.133, “Window Size: Scale to Fit Window”


Workspace icon for the application.

Section C.2.64, “Icon”


String containing additional name-value data for the application.

Section C.2.59, “Hints”


The 3270 host that runs the application.

Section C.2.102, “Server Address”


The TCP port number used to connect to the 3270 host.

Section C.2.103, “Server Port”


Behavior when telnet connection to the 3270 host is closed.

Section C.2.30, “Connection Closed Action”


Layout to use for mapping the keyboard to the terminal being emulated.

Section C.2.68, “Keyboard Type”


Number of “soft button” levels to display.

Section C.2.44, “Displayed Soft Buttons”


Maximizes the emulator window.

Section C.2.130, “Window Size: Maximized”


Enables the application's menu bar.

Section C.2.83, “Menu Bar”


Enables the File and Settings menu items.

Section C.2.51, “'File' and 'Settings' Menus”


Text color in the application's text window.

Section C.2.56, “Foreground Color”


Background color of the application's text window.

Section C.2.16, “Background Color”


Appearance of the root window.

Section C.2.122, “Window Color”


Color of the root window.

Section C.2.123, “Window Color: Custom Color”


Whether the Adaptive Internet Protocol (AIP) protocol compresses commands for transmission.

Section C.2.27, “Command Compression”


Whether the AIP protocol always executes commands in order, or optimizes commands for performance reasons.

Section C.2.28, “Command Execution”


Enables interlaced image transmission.

Section C.2.66, “Interlaced Images”


Enables graphics acceleration for the application's display.

Section C.2.58, “Graphics Acceleration”


Enables delayed updates of the application's display.

Section C.2.42, “Delayed Updates”


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”


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”


The Window Manager to use for the application.

Section C.2.125, “Window Manager”


Number of minutes the application is resumable for.

Section C.2.7, “Application Resumability: Timeout”


Timeout for emulating a middle mouse button click using a two-button mouse.

Section C.2.84, “Middle Mouse Timeout”


Effect on application session of closing the main application window.

Section C.2.121, “Window Close Action”


Monitor resolution that SGD reports to X applications.

Section C.2.85, “Monitor Resolution”


Keep open the connection used to start the application.

Section C.2.76, “Maintain Connection”


Enables resource sharing for similar application sessions.

Section C.2.106, “Share Resources Between Similar Sessions”


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 new 3270 application object for the application 3270cat. The emulator connects to the 3270 host warsaw.example.com.

$ tarantella object new_3270app \
--name "o=applications/ou=Finance/cn=3270cat" \
--width 1000 --height 800 \
--app /3270cat \
--hostname warsaw.example.com