Creates one or more 3270 application objects. See Section C.1.1, “3270 Application Object”.
tarantella object new_3270app { --nameobj
--widthpixels
--heightpixels
[ --descriptiontext
] [ --argsargs
] [ --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 ] [ --iconicon_name
] [ --hintshint...
] [ --hostnamehost
] [ --portnumbertcp
] [ --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 ] [ --3270fgcolor
] [ --3270bgcolor
] [ --roottype default|custom ] [ --rootcolorcolor
] [ --compression automatic|on|off ] [ --execution automatic|inorder|optimized ] [ --interlaced automatic|on|off ] [ --accel true|false ] [ --delayed true|false ] [ --ldapusersuser_dn
... ] [ --ldapgroupsgroup_dn
... ] [ --ldapsearchsearch_string
... ] [ --envsetting
... ] [ --loginscript
] [ --winmgrcommand
... ] [ --resumetimeoutmins
] [ --middlemousems
] [ --windowclose notifyapp|killapp|suspendsession|endsession ] [ --dpimonitordpi
] [ --keepopen true|false ] [ --sshargumentsargs
] [ --share true|false ] } | --filefile
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 |
---|---|---|
| The common name of the object in the SGD datastore. | |
| The width of the application, in pixels. | |
| The height of the application, in pixels. | |
| A text description of the object. | |
| The command-line arguments to use when starting the application. | |
| The mechanism used by the SGD server to access the application server and start the application. | |
| Resumability behavior for the application. | |
| When the application session ends. | |
| The maximum number of instances of the application a user can run simultaneously. | |
| How the application is displayed to the user. | |
| Enables the RANDR X extension. | |
| The initial size of the application. | |
| Scale the application to fit the window in which it is displayed. | |
| Webtop icon for the application. | |
| String containing additional name-value data for the application. | |
| The 3270 host that runs the application. | |
| The TCP port number used to connect to the 3270 host. | |
| Behavior when telnet connection to the 3270 host is closed. | |
| Layout to use for mapping the keyboard to the terminal being emulated. | |
| Number of “soft button” levels to display. | |
| Maximizes the emulator window. | |
| Enables the application's menu bar. | |
| Enables the File and Settings menu items. | |
| Text color in the application's text window. | |
| Background color of the application's text window. | |
| Appearance of the root window. | |
| Color of the root window. | |
| Whether the Adaptive Internet Protocol (AIP) protocol compresses commands for transmission. | |
| Whether the AIP protocol always executes commands in order, or optimizes commands for performance reasons. | |
| Enables interlaced image transmission. | |
| Enables graphics acceleration for the application's display. | |
| Enables delayed updates of the application's display. | |
| Assigns the application to the specified LDAP users. | |
| Assigns the application to the specified LDAP groups. | |
| Assigns the application to the users that match the LDAP search criteria. | |
| Environment variable settings needed to run the application. | |
| The login script used to start the application. | |
| The Window Manager to use for the application. | |
| Number of minutes the application is resumable for. | |
| Timeout for emulating a middle mouse button click using a two-button mouse. | |
| Effect on application session of closing the main application window. | |
| Monitor resolution that SGD reports to X applications. | |
| Keep open the connection used to start the application. | |
| Enables resource sharing for similar application sessions. | |
| Command-line arguments for the ssh client. | |
| 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