Starting the dialog terminal process by the user

The user must start the dialog terminal process after he or she has signed on to the operating system.

• The user enters the following command on Unix and Linux systems to start the process:

  utmpath /ex/utmdtp [-S[username ]] [-Aapplicationname ] [-Pptermname ] [-D]

  It is also possible to have the dialog terminal process started by Unix and Linux systems (see "Starting the dialog terminal process through Unix and Linux system").

• On Windows systems, proceed as follows:

  • First set the correct utmpath if necessary:
    SET UTMPATH= utmpath

  • Start a prompt window and enter the following command:

    utmpath \ex\utmdtp [-S[username ]] [-Aapplicationname ] [-Pptermname ]

  The command prompt may only be closed after the user has signed off from the application.

Legend

The specifications in square brackets represent switches that can be specified but do not have to be specified. The switches are explained below:

-S[username]

Using this switch, you interactively control the sign-on check (system access control) carried out by openUTM after a connection has been successfully established to the UTM application.

Dialog terminal process with -S switch:
If you start the dialog terminal process with the -S switch, you must transfer a UTM login username to openUTM for the sign-on check. With -Susername, you can specify the UTM login directly at the start of the dialog terminal process. If -S is specified without username, then openUTM interactively requests the UTM login after the connection has been established.

If you specify a UTM login for which a password is generated, openUTM queries the corresponding data interactively; see the description starting on "Standard sign-on dialog".

Dialog terminal process without -S switch:
If you start the dialog terminal process without the -S switch, then the dialog terminal process passes the system login for the authorization check. The password is not transferred to openUTM. A password can be assigned to the login in the UTM application; the user is then requested to enter this password, as when the login is specified explicitly.

If the check on the system login is negative, then an explicit authorization dialog is run as when the -S switch is used.

A description of the authorization dialog can be found in section "Standard sign-on dialog".

The -S switch and username form a string and must not be separated by any character.

-Aapplicationname

You use this switch to specify the application with which you want to be connected. applicationname is the name of the application generated in MAX APPLINAME. If -Aapplicationname is not specified at the start of the dialog terminal process, the user is asked to enter the application name.

The -A switch and applicationname form a string and must not be separated by any character.

-Pptermname

ptermname is the name of the terminal through which the user establishes the connection to openUTM. This name must be generated in a PTERM statement or an LTERM pool must be defined for local terminals (TPOOL PTYPE=TTY, LTERM=ltermprefix,NUMBER=number). If such an LTERM pool is generated, the -P switch can always be omitted. Otherwise the following is true:

• Unix or Linux systems

  If there is no such LTERM pool generated on Unix or Linux systems, the -P switch can be omitted, except for in the case described below, because on Unix and Linux systems openUTM uses the last part of the output of the tty command as the ptermname. This refers to the term after the last slash, and corresponds to the output of basename `tty`.

  The -P switch is only necessary when the default ptermname assignment by openUTM is not unique, e.g. when there are several pseudo-terminals where the last term of the tty command (after the last slash) are the same.

  Example
  The ttys /dev/pts/12 and /dev/inet/12 both exist at the same time. These ttys are generated with PTERM pts/12 and PTERM inet/12. In this case the user must start the dialog terminal process with the -P switch as follows, for example:
  utmpath /ex/utmdtp ... -Ppts/12.

• Windows systems

  If there was no LTERM pool generated on Windows systems, then the user must always specify -Pptermname because openUTM uses the value tty nnnnn, where nnnnn=PID, by default on Windows systems for the ptermname.

  Example:
  If the local terminal is generated with PTERM console,PTYPE=TTY,... , the user must start the dialog terminal process with utmpath\ex\utmdtp ... -Pconsole.

The -P switch and ptermname form a string and must not be separated by a character of any kind.

-D    This switch only applies to Unix and Linux systems.

With this switch, the user determines the response of the dialog terminal process to the DEL key on Unix and Linux systems.

If the -D switch is specified: The DEL key is ignored by the dialog terminal process.

If the -D switch is not specified: Pressing the DEL key disconnects the user from the application and results in the termination of the dialog terminal process.

Example
The user wants to sign on to the sample application under the UTM login user1; the DEL key is to be ignored. The user must therefore enter the following command:

utmpath/ex/utmdtp -Suser1 -Asample -D