D.34. tarantella object new_3270app

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

Syntax

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
 

Description

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.

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 3270 host that runs the application.

Section C.2.96, “Server Address”

--portnumber

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

Section C.2.97, “Server Port”

--3270tnclose

Behavior when telnet connection to the 3270 host is closed.

Section C.2.30, “Connection Closed Action”

--3270kt

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

Section C.2.66, “Keyboard Type”

--3270bl

Number of “soft button” levels to display.

Section C.2.43, “Displayed Soft Buttons”

--3270ma

Maximizes the emulator window.

Section C.2.122, “Window Size: Maximized”

--3270mb

Enables the application's menu bar.

Section C.2.80, “Menu Bar”

--3270si

Enables the File and Settings menu items.

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

--3270fg

Text color in the application's text window.

Section C.2.55, “Foreground Color”

--3270bg

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 Adaptive Internet Protocol (AIP) protocol compresses commands for transmission.

Section C.2.27, “Command Compression”

--execution

Whether the AIP protocol 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 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