C H A P T E R  5

Client Utilities

This chapter describes the Sun MTP local client. Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for descriptions of all the supported client processes.


unikix - Local Client Process

The unikix program starts the local client process unikixl.

Format:

unikix [-4] [-5] [-a] [-A] [-B] [-c] [-C] [-d transid]
[-f
filename] [-J] [-k keyfile] [-L filename] [-m filename] [-n]
[-t
string] [-T termid] [-x suffix]

where:

-4

Overrides the normal screen size selection. With this parameter specified, client attempts to simulate a 3270 Model 4, regardless of the screen size. If the screen size is smaller than 43 lines and 80 columns, an error is generated. If you do not specify this parameter, the client simulates a Model 4 only if the screen is large enough.

-5

Functions the same as the -4 option, but for 3270 Model 5 support (27 lines x 132 columns).

-a

Disables autotab on map screens, preventing the cursor from automatically jumping to the next field.

-A

Sets the terminal to AS IS mode, preserving the case of characters coming from the terminal.

-B

Accepts spaces, the dollar sign character ($), and the left bracket character ([) as valid input for unprotected numeric fields. This option enables users to edit numeric fields.

-c

Formats the decimal point as a comma in numeric fields on maps, accommodating different national standards.

-C

Enables color on an ASCII terminal.

-d transid

Default transaction. The specified transaction occurs whenever users attempt to activate a transaction by pressing Enter on a Sun MTP screen.

The default transaction overrides any transaction identifier the user types. This forces the user to work within a menu system or with designated transactions.

-f script-file

Reads a script file before reading from the terminal.

Create a script-file by executing unikix with the command:

tee script-file | unikix

which saves all keystrokes in the file script-file. The -f option replays script-file.

For this option to work, you must use the same terminal type to replay the script that was used to create it.

-J

Indicates that the data returned by an EXEC CICS RECEIVE BUFFER command includes extended attributes. When a subsequent EXEC CICS SEND is performed to send the receive buffer to the terminal, the extended attributes are redisplayed.

The default (no -J option) ignores the extended attributes when processing an EXEC CICS RECEIVE BUFFER.

-k keyfile

Overrides the normal keyboard definition file. This file defines which keys to use to simulate a standard 3270 keyboard.

This option is useful when using multiple terminal types for the local client and the terminal types use the same TERM variable, but have different keyboard configurations.

When this option is omitted, unikix uses a file that is defined by the TERM and UNIKIX environment variables for its key definition file. By default, this is the $UNIKIX/lib/$TERM.key file.

If the specified file contains an absolute path (one that starts with a slash /), it is used as is. If it contains a relative path, unikix looks for the file $UNIKIX/local/lib/keyfile. If this file is not found, it then looks for $UNIKIX/lib/keyfile.

-L filename

Allows logging of output screens. The specified file contains text copies of the screens that were accessed by the user. This is a diagnostic tool; do not use it under normal operating conditions.

-m filename

Allows logging of input and output messages. The specified file contains the text of the input from the user. This is a diagnostic tool; do not use it under normal operating conditions.

-n

Allows users to type nonnumeric data in an unprotected, numeric field. This emulates the behavior of 3270 terminals that do not have the keyboard numeric lock feature installed.

-t string

Executes the specified string as if a transaction were typed in the upper- left corner of the screen.

If parameters are required, string can be longer than a transaction code. If blanks or special characters are included, you must enclose the string in quotes. If a transaction is entered, the Sun MTP copyright and user PLT processing are bypassed.

-T termid

Specifies a terminal ID for the connection to Sun MTP. Normally, a terminal ID is automatically generated each time you start. This parameter enables you to set your terminal ID when necessary.

-x suffix

Allows specification of a one-character suffix, which is appended to mapsets specified in BMS commands.


See Also

The Sun Mainframe Transaction Processing Software Configuration Guide for information about starting a local client.

The Sun Mainframe Transaction Processing Software Developer's Guide for information about BMS support.

The Sun Mainframe Transaction Processing Software Configuration Guide for the format of the key file.