Sun Mainframe Transaction Processing Software, Release 8.0.1
Updated User Documentation

This file contains updates to the user documentation
released with MTP 8.0.1. If there are no documentation
updates for a patch release, it is so noted.

--------------------------------
MTP 8.0.1p4    -   117627-04
--------------------------------
Note: The acronym CR followed by a number stands for Change Request.

1. MTP now supports LU Type1 (SCS) printers (CR 5021365). In the Sun MTP
   environment, communication between the region and the LU Type 1 printer is
   managed by the TN3270 server.

   LU Type 1 printers are supported for data sent on the EXEC CICS SEND command.
   If you attempt to use other SEND commands, such as EXEC CICS SEND MAP or
   EXEC CICS SEND TEXT, the output might be unintelligible.

   To Configure an LU Type 1 Printer

   1. Configure the TN3270 server. Refer to the MTP Configuration Guide for
      instructions on configuring the TN3270 server.

   2. Using a local client or TN3270 client, display the Standard Tables menu
      by typing CTBL on a blank transaction screen, then pressing PF4.

   3. Open the TCT by pressing PF8, then press PF9 to display the 3270 Devices
      screen.

   4. On the 3270 Devices screen, press PF4 to display the Insert screen.

   5. Type values in the following fields for each printer you are defining:

     a. In the Term ID field, type the four-character identifier of the printer.
        This is the name of the printer as it is known to the application. It
        must be a unique name.

     b. In the LU Name field, type the logical unit name.

     c. In the Device field, type the value SCSPRINT. No other value is allowed.

   6. Press Enter to insert and validate the entry or entries.
      The Auto Log and In Svc fields are automatically filled in with Y(es).

   7. Press PF3 to return to the TCT menu.

   8. Press PF2 to save the changes to the disk.

   9. Press PF3 to exit the TCT.

  10. Exit Table Manager and restart the region so that your changes take
      effect.

2. A fix to CR 4992004, which related to an unexpected region shutdown, resulted
   in a change to the text of error message KIX6694E. The changed error message
   and description are as follows:

   KIX6694E Orphaned message found for terminal %s pid %d, discarded

    Description: Sun MTP has discarded an input message, typically a transaction
    request, sent by the specified terminal. The PID in the error message is the
    process ID of the terminal handler at the time the request was submitted.

    Cause: The terminal was disconnected after submitting the request, but
    before Sun MTP could process the request and return a reply. If the terminal
    does not reconnect, if the terminal reconnects as a different identifier, or
    if the terminal reconnects through a terminal handler different from the one
    the terminal had originally connected through, Sun MTP discards the original
    terminal transaction request. New transaction requests from the reconnected
    terminal are processed.

    Solution:  Resubmit the transaction request.

3. The kixsnap utility has been enhanced to capture additional diagnostic
   information.
   As a result, the utility takes longer to run. Please wait for the message
   that is displayed showing the name of the snapshot file to ensure that the
   kixsnap data collection has finished. (CR 6190308)

4. A debugging enhancement, which must be used under the direction of
   your authorized service provider, resulted in several new error
   messages. (CR 4650747)

    KIX3820E core file directory: %s

      Description: This message, which is written to the unikixmain.err file,
      identifies the directory where the UNIX core file was written.

      Solution: Examine the core file to determine the cause of the problem,
      or provide the file to your authorized service provider.

    KIX4719I Debug option to create user application core files is set

      Description: This message indicates that core files will be generated
      under certain conditions when this debug option is set.


      Solution: Informational message; no user action needed.


--------------------------------
MTP 8.0.1p3    -   117627-03
--------------------------------
None
 
 
--------------------------------
MTP 8.0.1p2    -   117627-02
--------------------------------
1. The following kixview documentation replaces the description in the
   Sun MTP Reference Guide, which was incomplete (BugId 4950784).
   
   The kixview program displays the contents of a file in a dump format with 
   the hexadecimal representation of the contents on the left side of the
   display and the text contents on the right side of the display. kixview 
   can display both ASCII and EBCDIC files. For EBCDIC files, kixview converts
   the bytes into ASCII before displaying the file.
   
   Format:
   
   kixview [-e|-E] [-A conversion-table] <file1>, [<file2>, <filen>]

   where:
   
   -e|-E                  Specifies that the input files are EBCDIC files.
   -A <conversion-table>  Specifies the EBCDIC to ASCII conversion table to use.
                          If you are viewing EBCDIC files and do not specify a
                          conversion table, the default conversion table is 
                          used (IBM-1047 to ISO8859-1).
   <file1> [<file2>]      Identifies the names or full path names of the files.
                          If you are supplying multiple file names and
                          incorrectly type a file name, or type the name of a
                          non-existent file, kixview issues an error message 
                          and displays the next file in the list.

   To navigate within the file, position the cursor in either the hex or text
   display area. Then use the following keys to move the cursor:
   
   Key           Action
   j             Moves the cursor down one line.
   k             Moves the cursor up one line.
   l             Moves the cursor one character to the right.
   h             Moves the cursor one character to the left.
   Ctrl-f        Scrolls down by a full screen.
   Ctrl-b        Scrolls up by a full screen.
   Ctrl-d        Scrolls down by half a screen.
   Ctrl-u        Scrolls up by half a screen.
   L             Moves the cursor to the beginning of the last line on the
                  screen.
   H             Moves the cursor to the beginning of the first line on the
                  screen.
   ^             Moves the cursor to the beginning of the current line.
   $             Moves the cursor to the end of the current line.
   #             Moves the cursor to the beginning of the other screen
                  area. For example, if the cursor is in the hex area, it 
                  moves to the beginning of the text area. 
   %             Moves the cursor to the end of the other screen area. For
                  example, if the cursor is in the hex area, it moves to the
                  end of the text area.
   B             Moves the cursor to the first position in the file.
   G             Moves the cursor to the last position in the file.
   g             Displays the prompt File Position (hex). Type the hex value 
                  of the file position and press Return. The line containing 
                  the value is moved to the top of the screen.
   /             Displays the prompt (A)scii or (H)ex. Type the search pattern
                  and press Return. kixview searches forward in the file, and
                  moves the line containing the next instance of the value to
                  the top of the screen.
   ?             Displays the prompt (A)scii or (H)ex. Type the search pattern
                  and press Return. kixview searches backward in the file, and
                  moves the line containing the next instance of the value to
                  the top of the screen.
   n             Searches forward for the next instance of the search pattern.
   N             Searches backward for the next instance of the search pattern.
   Ctrl-L        Refreshes the screen display.
   e             Displays the prompt Edit File. Type the name of another file 
                  to view and press Return. You can specify only one file name.
   q             Quits kixview and returns to the command prompt.

   Note - When viewing EBCDIC files, kixview converts the input ASCII pattern 
          into EBCDIC before matching it with characters in the file.

2. The following message has been modified for clarity (BugId 5077890)

   KIX0462I Sign-on transaction CSSN/CESN cancelled
   
     Description: This message is displayed if you terminate either the CSSN 
     or the CESN transaction.
     
     Solution: Informational message; no user action is needed.

3. A fix to BugId 5078396 changed the size of the terminal buffer from 
   7,000 bytes per user to 32,000 bytes per user. The description for the
   following error message has changed:
   
   KIX0401T TIOA overflow 
   
     Description: The application attempted to send too much data to a
     terminal. The maximum amount of data that can be sent is 32,000 bytes.
     
     Solution: Modify your application program so that no more than 32,000
     bytes of data per SEND request is sent to a terminal.
   
--------------------------------
MTP 8.0.1p1    -   117627-01
--------------------------------
None
