D.38 tarantella object new_5250app

Creates one or more 5250 application objects. See Section C.1.2, “5250 Application Object”.


tarantella object new_5250app {
  --name obj
  --width pixels
  --height pixels 
[ --description text ]
[ --args args ]
[ --method telnet|ssh ]
[ --resumable never|session|always ]
[ --endswhen lastclient|windowmanager|windowmanageralone|
    nowindows|loginscript|loginscriptnowindows ]
[ --maxinstances 0|instances ]
[ --displayusing clientwm|independent|kiosk ]
[ --xrandr true|false ]
[ --maximize true|false ]
[ --scalable true|false ]
[ --icon icon_name ]
[ --hints hint...]
[ --hostname host ]
[ --portnumber tcp ]
[ --tnclose 0|1|2|3 ]
[ --kt pc|sun4|sun5|hp ]
[ --bl 0|1|2|3|4 ]
[ --ma true|false ]
[ --mb true|false ]
[ --si true|false ]
[ --fg color ]
[ --bg 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 ]
[ --share true|false ]
[ --ssharguments args ]
} | --file file


SGD uses the third-party TeemTalk for Unix emulator for 5250 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 AS/400 host that runs the application.

Section C.2.102, “Server Address”


The TCP port number used to connect to the AS/400 host.

Section C.2.103, “Server Port”


Behavior when telnet connection to the AS/400 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 AIP protocol compresses commands for transmission.

Section C.2.27, “Command Compression”


Whether the AIP 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 5250 application object for the application 5250cat. The emulator runs on the application server prague, and connects to the AS/400 host warsaw.example.com.

$ tarantella object new_5250app \
--name "o=applications/ou=Finance/cn=5250cat" \
--width 400 --height 300 \
--app /5250cat \
--appserv "o=appservers/cn=prague" \
--hostname warsaw.example.com