D.35. tarantella object new_5250app

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

Syntax

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

Description

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.

Option

Description

More Information

--name

The common name of the object in the SGD datastore.

Section C.2.84, “Name”

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

--args

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

Section C.2.11, “Arguments for Command”

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

--endswhen

When the application session ends.

Section C.2.98, “Session Termination”

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

--xrandr

Enables the RANDR X extension.

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

--maximize

The initial size of the application.

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

--scalable

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

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

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

--hostname

The AS/400 host that runs the application.

Section C.2.96, “Server Address”

--portnumber

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

Section C.2.97, “Server Port”

--tnclose

Behavior when telnet connection to the AS/400 host is closed.

Section C.2.30, “Connection Closed Action”

--kt

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

Section C.2.66, “Keyboard Type”

--bl

Number of “soft button” levels to display.

Section C.2.43, “Displayed Soft Buttons”

--ma

Maximizes the emulator window.

Section C.2.122, “Window Size: Maximized”

--mb

Enables the application's menu bar.

Section C.2.80, “Menu Bar”

--si

Enables the File and Settings menu items.

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

--fg

Text color in the application's text window.

Section C.2.55, “Foreground Color”

--bg

Background color of the application's text window.

Section C.2.16, “Background Color”

--roottype

Appearance of the root window.

Section C.2.114, “Window Color”

--rootcolor

Color of the root window.

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

--compression

Whether the AIP protocol compresses commands for transmission.

Section C.2.27, “Command Compression”

--execution

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

Section C.2.28, “Command Execution”

--interlaced

Enables interlaced image transmission.

Section C.2.63, “Interlaced Images”

--accel

Enables graphics acceleration for the application's display.

Section C.2.57, “Graphics Acceleration”

--delayed

Enables delayed updates of the application's display.

Section C.2.41, “Delayed Updates”

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

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

--winmgr

The Window Manager to use for the application.

Section C.2.117, “Window Manager”

--resumetimeout

Number of minutes the application is resumable for.

Section C.2.7, “Application Resumability: Timeout”

--middlemouse

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

Section C.2.81, “Middle Mouse Timeout”

--windowclose

Effect on application session of closing the main application window.

Section C.2.113, “Window Close Action”

--dpi

Monitor resolution that SGD reports to X applications.

Section C.2.82, “Monitor Resolution”

--keepopen

Keep open the connection used to start the application.

Section C.2.64, “Keep Launch Connection Open”

--share

Enables resource sharing for similar application sessions.

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

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