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