-b SNA Server host name

Identifies the host that is acting as the SNA server. The SNA server does not have to be executing on the same host as the 3270 Client Initiator. If not specified, this option defaults to the name of the host from which unikixi is invoked.

-c P[rinter]|D[isplay]|B[oth]

Specifies end-to-end acknowledgment for messages sent to the terminal. This option applies to all devices of the specified type (printers, displays, or both) that are managed by unikixi.

If you specify this option, failure to correctly deliver a message to the terminal aborts the current transaction.

-i

Supports session-switching software on SNA 3270 terminals.

-L filename

Enables screen logging. The specified file contains text copies of all the screens that were accessed from any connected terminal. This is a diagnostic tool; do not use it under normal operating conditions.

-m filename

Enables input message logging. The specified file contains the complete text of all messages that are transmitted from any connected terminal. This is a diagnostic tool; do not use it under normal operating conditions.

-o port

Specifies the port number or port name on which the 3270 client initiator listens. This port number or name must match the value in the TCT-3270 Devices, Host & Port screen. You can use either a lowercase or uppercase o when specifying this option.

-p filename

Enables performance tracking for the 3270 Client Initiator.

-s port

Specifies the port number or port name to which the 3270 client initiator connects. Use this option to connect to a specific region. A default value of 2001 is used if no value is specified.

The value must match the value assigned to the Sun MTP server when it is started with the -s option to unikixmain (kixstart). If multiple regions are started, each one must have a unique port number or port name.

-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.

-u application name

Specifies a unique application name for the 3270 client initiator. This application name should correspond to one of the SNA server application names listed on the 3270 login screen.

If multiple applications are being executed, you must set this option to ensure that the user is connected to the correct application. If no application name is specified, the initiator defaults to the first application name configured to the SNA Server.

-w|-W

Indicates the login sequence variation for LU1 and LU2 terminal types. The w/W stands for "wait for initial input," signaling that the Sun MTP software must wait for input from the terminal. The two options indicate what the input contains:

w: Login sequence is initiated by the first input prompt from the secondary LU.

W: Login sequence is bypassed, and the first transaction is specified in the initial input from the secondary LU.

unikixmain.log

Contains information about processor initiation and termination. It also contains any information about abnormal situations.

unikixmain.err

Contains information about abnormal situations.

unikixmain.dbg

Used for debugging.

-a pnnn | tnnn

Specifies the number of entries that can be added dynamically to the resource table.

• p specifies the Processing Program Table (PPT). nnn specifies the number of PPT entries that can be added during the life of the region. Default value is 200.
• t specifies the Program Control Table (PCT). nnn specifies the number of PCT entries that can be added during the life of the region. Default value is 100.

-A conversion-table

Specifies a single-byte conversion table to use for national language support. The conversion table is a 256-byte file representing EBCDIC to ASCII conversion of characters 0x00 through 0xff. The table must be located in the $UNIKIX/lib directory.

Refer to the Sun Mainframe Transaction Processing Software Release Notes for a list of the supplied tables.

-b blksize

Specifies the systemwide VSAM block size in kilobytes. Valid values are 4K, 8K, 16K, or 32K. The default is 4K. This option applies only if there is no VSAM catalog. If the catalog exists, the VSAM block size is automatically equal to the block size of the catalog. To change the block size, refer to the Sun Mainframe Transaction Processing Software Administrator's Guide.

Files must have a block size that is equal to the block size of the catalog, or they cannot be opened.

-B

Enables support for double-byte character sets in the 3270 data stream.

Specifies a double-byte conversion table to use for national language support. The conversion table is a 131,072-byte file representing EBCDIC to ASCII conversion of characters 0x00 0x00 through 0xff 0xff.

Refer to the Sun Mainframe Transaction Processing Software Release Notes for a list of the supplied tables.

-d

Sets certain system debugging options, which have no effect on debugging options such as Animator or CEDF. Internal use only.

-D string

Indicates the system debugging options. Available string values are:

a: Writes CEDF output for every transaction to $UNIKIX/unikixmain.dbg.

dy: Produces an application dump file when a runtime error is detected, when an application program uses the CICS ABEND command, without a HANDLE ABEND command or when errors such as an out-of-storage condition occur. This is the default.

dn: Does not produce an application dump file.

-f

Writes the contents of the three log files--unikixmain.log, unikixmain.err, and unikixmain.dbg--to the terminal that initiated the region.

-G <filename>

Specifies that resources from the system resource definition file must be added. The contents of the file specified with this option is a list of group names delimited by spaces or new lines. The groups are the groups from which the resources must be added during startup.

-h string

Specifies the address to which unikixsock binds its listen socket. You must still specify the port number with the -p option. If you omit the -h option, the socket is bound to INADDR_ANY. In most cases the default is preferred. string values are:

name: Identifies the name of the host

IP address: Numeric IP address of the host.

any: Any of the host's IP addresses (INADDR_ANY). Default.

loopback: Local host only (INADDR_LOOPBACK).

The loopback argument (address) restricts the socket listener to accepting client connections from the local host.

-i #

Specifies the interval between statistics checks. The numeric value specifies the number of seconds that elapse between the generation of statistics. The default value is 60 seconds.

The statistics are used with kixdump to calculate the number of transactions per second that occur in the specified interval, and to track the maximum queue depth if you are running with transaction classes.

-I bufprcnt

Specifies a percentage of the buffer pool to reserve for VSAM index blocks, enabling the administrator to alter the way the VSAM buffer pool is managed; a value between 25 and 75.

By default, half of the buffer pool is reserved for VSAM index blocks; the remainder is used for VSAM data blocks.

-j #

Enables mutexes, overriding the default semaphore mechanism. Mutexes are used to control access to shared resources.

To enable mutexes, you must type any number, for example, -j 1.

-l directory

Specifies the location of customized executable files, such as unikixtran. Without this parameter, unikixmain searches the $UNIKIX/local/bin directory for executable files first, and then the $UNIKIX/bin directory. If this option is specified, unikixmain searches the given directory first, and then $UNIKIX/local/bin, followed by $UNIKIX/bin.

The argument must be a full path name and not an environment variable. If you use this option with the -t option, the -t option overrides the -l option for the transaction processor only. This option and the -v option are mutually exclusive.

-L descriptor#

Specifies the number of socket connections that the Sun MTP server can support for TCP/IP connections. This number represents the maximum number of file descriptors that can be opened by a process. Reduce the number to restrict the number of TCP clients that can be attached, or increase it if clients are being rejected.

The default is the current system soft limit for file descriptors.

-M tvalue
-M cvalue

Specifies the relative address where the region will attach to shared memory. Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for information about using these options.

-n

Allows COBOL programs that had been converted to manipulate ABSTIME as a COBOL COMP variable, rather than as a COMP-3 variable, to run without modification. ABSTIME is an option of the ASKTIME and FORMATTIME commands. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.

-N dumps

Specifies the maximum number of dump files that will be created. Sun MTP suppresses dumps after it reaches this number. The default is 20 dump files. If you set a lower value, a value of 20 is imposed.

This option has no effect unless you enabled dumps with unikixmain -D y. You can also enable application dumps with the kixcontrol -d y option.

-p port

Indicates the port number or name for the Sun MTP server to use as a listening port for socket clients. There is no default port, so you must supply one. The port number or port name must be unique.

-P port

Indicates the port number or name for the TCP server (unikixtcp) to use as a listening port for CICS clients running ECI and EPI applications over a TCP/IP connection or remote CICS clients performing ISC over a TCP/IP connection.When this option is used, unikixmain starts the unikixtcp server. There is no default port number or name, so you must supply one, either by name or by number, for example:

-P cicstcp
-P 5100

The port number or name must be unique.

-Q

Indicates that the region must use the terminal queue for interprocess communication. Required if you are using the local client from a user ID that is different from the user ID that started the region. You must also make sure that permissions on certain Sun MTP modules are properly set. Refer to the Sun Mainframe Transaction Processing Software Installation Guide for information about setting permissions on these modules.

-R size

Specifies the percentage ratio before sending requests to the recovery server.

This option directly affects the behavior of the recovery algorithm. Sun MTP tries to piggy-back multiple before-image write requests to the recovery server by looking at the number of currently busy transaction servers and determining the number of outstanding requests.

For example, at the default percentage of 50 percent, when there are 5 requests and 10 busy transactions, the before-image buffer is flushed. Until the before-image buffer is flushed, all servers with pending write requests are waiting.

If there are four or less busy transactions, the piggy-backing logic is turned off, and write requests to the recovery server are sent immediately.

-s port

Specifies the port number or name to be used by the remote 3270 clients (default is 2001). Remote users must use the -s option if using unikixi.

If you run multiple regions at the same time, each must have a unique port number or name.

-S size

Specifies the size of the initial dynamic VSAM shared memory area. The default value is 1 MB; Sun MTP allocates dynamic shared memory in blocks of 1 MB. The size parameter enables you to alter the block size.

Specify the size as a number or a number followed by an M for megabytes or a K for kilobytes. If this option is used, you must configure the system for the proper amount of shared memory during installation. Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for the procedures.

-t filename

Identifies an alternate transaction server. For example,
-t /mtp/finance/bin/fintran. Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for information about creating an alternate transaction server.

If you use the -t option with the -l option, the -t option overrides the -l option for the transaction processor only.

-T M|A

Controls temporary storage. The two exclusive arguments are

M: Force all CICS temporary storage to shared memory. This reduces response time for heavy temporary storage users.

A: Force all CICS temporary storage to auxiliary storage (VSAM files). This reduces the main memory requirements at the expense of response time.

-x #

Specifies the number of bytes of padding to add at the end of each block of allocated shared memory. If a program is known to overstep its allocation, the padding prevents the next block from being corrupted until the faulty program is corrected. The argument is an integer. The default value is zero.

-X port

Enables the unikixadmin server process, which allows a region to be monitored by the Sun Mainframe Administration Tool
(Sun MAT). The port number must be unique.

-Z

Keeps mapsets in shared memory only for the duration of their usage. After they are used, the memory is released.