C H A P T E R 1

Introduction

This chapter briefly describes each of the Sun Mainframe Transaction Processing software (Sun MTP) utilities and Sun MTP tables.

Sun MTP Utilities

Chapters 2 through 6 describe the Sun MTP utilities and their command-line options. Some utilities are invoked in response to a user request--for example, when a program function (PF) key is pressed--and others are invoked by the user from the command prompt or from a shell script. On a production system, restrict access to these utilities. The following table lists the utilities alphabetically.

Note - Before using any of these utilities, you must set your region environment variables, including $KIXSYS, $UNIKIX, and $TMPDIR. Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for instructions on setting your region environment.

TABLE 1-1 Sun MTP Utilities
Utility	Description
dfhusdup - Define and Report Resources	Batch utility used to define and report the resources in the system definition file, including initialization of the `DFHUSD` file.
kixasm - Sun MTP Assembler	Invoked when you press the PF4 key on the Set Assembler Options screen. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information about the Compilation menu.
kixbms - BMS Assembler	Invoked by the `kixasm` and `kixsgu` utilities when you press the PF4 key on the Set Assembler Options screen or when you press the PF12 key on the BMS Maintenance menu screen, respectively. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for information about the Screen Generation Utility (SGU).
kixbrw - Browse Files	Invoked when you select one or more files to browse on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixcat - Concatenate Files	Invoked when you select one or more files to concatenate on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixcisam - Run an External C Program	Executes a C program not defined as a Sun MTP resource that accesses Virtual Storage Access Methods (VSAM) files.
kixclean - Deallocate IPC Areas	De-allocates the operating system interprocess communication (IPC) areas that were allocated by the region and were not automatically freed.
kixclt - Common Language Translator	Sun MTP Common Language Translator for COBOL, C, and PL/I. The utility locates and includes all files before translating the program. For COBOL and PL/I programs, `kixclt` is invoked when you press the PF4 key on the Set Compiler Options screen. You can also execute `kixclt` from the command line. To translate C programs, you must use the command-line interface. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixcnvtbl80 - Convert Tables	Converts tables created with earlier versions of Sun MTP to the Release 8.0 format.
kixcnvtcat80 - Convert VSAM Catalog	Converts a VSAM catalog created with earlier versions of the software to the Release 8.0 format.
kixcob - COBOL Compiler	Invoked when you select a COBOL program and press the Compile key (PF4) on the Set Compiler Options screen. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information about the Compilation menu.
kixcontrol - Generate Dump File	Enable or disable formatted application dumps.
kixcopy - Copy Files	Invoked when you select one or more files to copy on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixdate - Change the Date/Time	Date/time configuration utility that provides a way to change the date/time for Sun MTP and Sun Mainframe Batch Manager (Sun MBM) systems. Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for additional information.
kixdlt - Delete Files	Invoked when you select one or more files to delete on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixdump - Display Region Information	Displays information about a specific region. It can display the transactions that are currently executing, table and file information, trace table information, and statistics.
kixecho - Write Messages to a Terminal	Shell program invoked to place a message on the terminal of the requestor.
kixed - Edit a File	Executed whenever a file needs editing. This allows the user to edit files prior to compilation and provides the region with the ability to display temporary files that are created by compilation.
kixeformat - Format Internal Trace Dumps	Formats internal trace dumps. Use only under the direction of your authorized service provider.
kixetrace - Trace Facility	Allows you to change the tracing option while a region is running. Use only under the direction of your authorized service provider.
kixexpcat - Export the VSAM Catalog	Displays and exports a VSAM catalog file.
kixexptbl - Export Tables	Exports a region's tables to `.lst` format.
kixfile - Change Dataset Status	Manipulates VSAM files while Sun MTP is active. Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for additional information.
kixgrep - Search Files	Invoked when you select one or more files to search on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kiximpcat - Import an ASCII Catalog File	Creates the VSAM catalog by importing two files (`.dta` and `.idx`) from a specified ASCII text file.
kiximptbl - Import Tables	Imports a region's tables from `.lst` files.
kixinstall - Configuration Utility	Configuration utility used to define application languages, third-party products, user objects, rules, and commands that are required for building Sun MTP executables for each platform.
kixjas - Extract Data From a Journal File	Converts accounting records to ASCII format records. Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for more information.
kixjob - Move Job to the Batch Queue	Called when a transaction that has written to a transient data queue (TDQ) of type JOB issues a `SYNCPOINT`. Provides the ability to copy the transient data to a directory indicated by the `KIXBTCH` environment variable.
kixjournal - Process a Journal File	Processes the journal file when it has reached its maximum size.
kixkeydef - Create or Edit a Key File	Used for creating or editing a key file.
kixlog - Write a String to the Log File	Provides an interface into the three region log files.
kixmakecnv - Create a Conversion Table	Creates a conversion table file.
kixnrfs - Configure NRFS	Configures Native Recovery File System (NRFS).
kixpl1 - PL/I Compiler	PL/I compiler. Invoked when you select a PL/I program and press the PF4 key on the Set Compiler Options screen. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixplt - PL/I Command Language Translator	Sun MTP Command Language Translator for PL/I. Invoked when you select a `*.plt` program and press the PF4 key on the Set Compiler Options screen. You can also execute `kixplt` from the UNIX command line.
kixprint - Collect Print Output on Disk	Invoked to print a file created by an online transaction. This shell script determines whether to print the file or save it to a disk. If printing the file, this program determines the actual printer on which to print.
kixprntbl - Print Table Listing	Prints a report listing a region's tables and their contents.
kixprt - Print a File	Invoked when you select one or more files to print on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixrcvdmp - Display a Recovery File	Displays the contents of the recovery file.
kixrnm - Rename a File	Invoked when you select a file to rename on the File Utilities menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixsalvage - Salvage VSAM Data	Scans and dumps all salvageable data from a corrupted VSAM file to a new file or files.
kixsgu - Create an SGU	Invoked when you press the PF12 key on the BMS Maintenance Menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixsh - Start a Shell	Invoked when you press the PF10 key (Execute in UNIX) on the Development System main menu. Refer to the Sun Mainframe Transaction Processing Software Developer's Guide for more information.
kixsnap - Take System Snapshot	Captures information about a region's transaction servers, tables, system processes, and users at the time of an abnormal shutdown.
kixstart - Start a Region	Starts a region by executing the `unikixmain` program. You can submit `kixstart` with specific `unikixmain` options. There are variations of this program specific to UNIX keyboard and X server combinations. See the description of xxx`start`.
kixstop - Shut Down a Region	Performs an orderly shutdown of a region, allowing the system to quiesce before being terminated.
kixtran - Execute a Transaction	Starts a transaction from batch or from the prompt.
kixupdateGCT - Update GCT	Updates the Group Control Table (GCT) from the command line.
kixvalfle - Validate VSAM Clusters	Validates a VSAM cluster. Use this utility whenever the structure of a VSAM file is in doubt.
kixverify - Display/Reset Activity Counts	Displays and resets the activity counts of a VSAM dataset.
kixview - Display Files	Displays the contents of a file.
unikix - Local Client Process	Starts the local client process.
unikixbld - VSAM File Builder	Manipulates VSAM files from a batch job.
unikixi - 3270 Client Initiator Process	Starts the 3270 client initiator process.
unikixmain - Sun MTP Server Process	Starts the Sun MTP main server process.
unikixvsam - COBOL Runtime System	Runtime system that executes a COBOL program from within a shell script.
xxxstart - Specify a Startup Keyboard	Shell scripts that start a region in an X server environment with a specific terminal/keyboard.
xxxunikix - Specify a Client Keyboard	Shell scripts that start a Sun MTP-related process within an xterm client for a specific keyboard type. Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for more information.

Sun MTP Tables

Chapter 7 describes the Sun MTP tables in detail. The following table lists the system tables and their contents, and indicates whether the table is opened from the Standard Tables menu or the Extended Tables menu.

TABLE 1-2 Sun MTP System Tables
Table	Contents	Menu
Data Conversion Templates Table (CVT)	Describes how to translate data during intersystem operations.	Extended
Destination Control Table (DCT)	Destination names or queues that can be processed by transient data commands.	Standard
File Control Table (FCT)	Information about VSAM data files used by the region's application programs.	Standard
Group Control Table (GCT)	Defines additional directories that contain table information.	Extended
Journal Control Table (JCT)	Defines user journals. (The SIT defines system journals.)	Extended
Monitoring Control Table (MCT)	Information to control transaction and user logging.	Extended
Processing Program Table (PPT)	Application programs, tables, and BMS mapsets that can be referenced by the region's transactions.	Standard
Program Control Table (PCT)	Control information used by the region to identify and initialize transactions.	Standard
Program List Table (PLT)	Programs that are initiated automatically on system startup, user startup, or system shutdown.	Extended
Sign-On Table (SNT)	List of users authorized to use the region's transactions.	Extended
System Initialization Table (SIT)	System initiation information; identifies the name of the region.	Standard
Temporary Storage Table (TST)	Information used to define queues that can be processed by temporary storage commands.	Extended
Terminal Control Table (TCT)	Identification information for terminals, printers, and remote system connections.	Standard
Transaction Class Table (TXC)	User-defined transaction classes.	Extended
VSAM Configuration Table (VCT)	Data that controls the operation of the region.	Standard

Sun MTP Standards

This section describes the following Sun MTP standards:

Screen Formats

Function Keys

Data Entry Validation

File Identifiers

The standards of your user applications might be different.

Screen Formats

All data entry screens have four areas.

Screen Area	Description
Header area (line 1)	Identifies the current screen and contains the current date and time.
Detail area (lines 2 through 20)	Contains menus, data entry screens, and file selection areas.
Response area (line 21)	Normally has underscores (_) across the entire line. When certain operations are performed, such as writing data to disk, this line displays a highlighted message indicating any error conditions. It also can indicate status of the operation.
Function Key Description area (lines 22 through 24)	Lists the available function keys for the screen and the operation performed when a function key is pressed.

FIGURE 1-1 Sun MTP Screen Formats--Example

Screen shot of a typical data entry screen showing the four screen areas: header area, detail area, response area, and function key description area.

Function Keys

The following function keys perform the specified operations on Sun MTP screens.

Function Key	Action
PF3	Returns to the previous screen. If you change data on a screen and press this key before saving the changes to disk, the following warning is displayed: Table has been modified. Press PF3 if modification is only temporary. Press PF3 to confirm that you do not want to save the changes, or press any other key to perform another operation.
Enter	Modifies the data for the entries currently displayed. You can modify the contents of a screen by typing over the unprotected values and pressing this key. Data is modified only if all fields pass their associated validation tests.
Clear	Clears the screen so you can type a new transaction.
Reset	Resets the system after an operator error, such as typing text in a numeric field.

Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for keyboard mapping information.

Data Entry Validation

You can type both uppercase and lowercase characters into any data field. Under most conditions, lowercase characters are converted to uppercase. Some data fields accept lowercase characters as valid data. Normally, fields that relate to CICS commands are converted to uppercase; other fields are left as typed. For example, dataset names are converted to uppercase and file names remain as they are typed.

During data entry validation, any fields containing invalid data are highlighted. The cursor is in the first field containing the erroneous data, and the following message is displayed in the response area:

Data in field invalid/required

File Identifiers

File identifiers have two parts:

A directory or environment variable that specifies one or more directories

A file name that is the last component of the file identifier

When typing a file identifier, you must conform to the specifications described in the following table.

File Identifier	Description
Directory	Absolute directory names used in Sun MTP cannot exceed 50 characters. You can use an environment variable preceded by a dollar sign ( $ ) to replace any portion of a path name. For example, the following lines are valid and designate the same directory: `mtp/mtp8/finance/sys` `$KIXSYS` The `$` symbol expands the `KIXSYS` environment variable to its complete value.
Environment variable	Name of a directory or file, or a value; 1 to 14 characters. By convention, environment variables are in uppercase.
File name	Sun MTP file names are 1 to 14 characters, including any extension.

File Identifier

Description