[logon] – Request server authentication with client

Use this server command to request client authentication based on specific credentials defined by your system administrator in the client authentication user exit. Client authentication is the confident identification of a client by a server; that is, client authentication allows a server to confirm a client's identity.

Format

Read syntax diagramSkip visual syntax diagram[logon  credential1credential2credential3credential4credential5credential6credential7credential8credential9credential10 ]
credential1...credential10
specifies the credentials used for client authentication as defined by your system administrator in the client authentication user exit, where credentia1 through credentia10 could include a user ID, password, and a social security number, for example.

Additional information

  • You can enter the [logon] command from a connected TPF Operations Server client.
  • You can use this command only if authentication was turned on initially by setting the Require Authentication parameter to ON in the host interface configuration (HOSTCFG.DAT) file.
  • The [logon] command is not valid when the client is already authenticated.
  • The [logon] command supports no more than 10 credentials, each separated by a space.
  • You can configure any credentials to be masked by using the hide_char and hide_stringx parameters so that they do not display when you enter the [logon] command from the console command area.

Examples

The following example shows a [logon] command formatted for an authentication user exit that is implemented to expect an e-mail address and password. The command echo and output from the [logon] command follows.
[logon tpfoper password]
The following example shows the command echo and output from the previous command.
AAES0011I tpfoper 11 ==> [logon ...]
AAES4806I 10.54.46 AUTHENTICATION SUCCESSFUL

Related information