Sun Mainframe Transaction Processing Software, Release 7.2.0
Updated User Documentation

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

--------------------------------
Sun MTP 7.2.0p7    -   112271-07
--------------------------------

1. The following sections in Appendix A of the Sun MTP Software Configuration
Guide incorrectly identify the keypad multiply key as a lowercase j (j).
The correct symbol is the asterisk (*). (BugId 4778203)

  NCD-101 Key Keyboards
  VT-type Keyboards
  Sun Keyboards
  Default X Keyboards
  Desktop Terminal Keyboards

2. The following restriction applies when using a Sybase database (BugId 
4783228).

  A Sun MTP region connecting to a Sybase database can only provide Sybase
  interface support for either COBOL or C. If you need to access a Sybase 
  database from both C and COBOL programs, you must create two regions, 
  one for C and one for COBOL.

3. The documentation for the EXEC CICS INQUIRE TASK command (documented 
in the updated_user_doc.txt file for patch 112476-01) and for the 
EXEC CICS INQUIRE TASK LIST command (documented in the Sun MTP Developer's 
Guide) contains errors (BugId 4787620). The corrected documentation is as 
follows:

INQUIRE TASK(data-value)
        [FACILITY(data-area)]
        [FACILITYTYPE(cvda)]
        [PROCESSID(data-area)]
        [RUNSTATUS(cvda)]
        [STARTCODE(data-area)]
        [TRANSACTION(data-area)]
        [USERID(data-area)]

  This command retrieves information about a specified user 
  task. User tasks are those associated with user-defined 
  transactions or with MTP-supplied transactions that are 
  usually invoked by an operator.

  FACILITY - Returns a 4-character string representing the 
  name of the facility associated with the named task. If the 
  task was initiated from a terminal, the name of the terminal 
  is returned. If the task was initiated by a destination 
  trigger level, the name of the associated transient data 
  queue is returned. Otherwise, a null value is returned.

  FACILITYTYPE - Returns a CVDA value indicating the type of 
  facility that initiated the task. Possible values are:

    DEST - tast was initiated by a destination trigger level
    
    TASK - task was initiated by another task

    TERM - task was initiated from a terminal

  PROCESSID - Returns a 32-bit binary value indicating the 
  process id of the process (unikixtran) running the 
  transaction associated with the task. Sun MTP-specific option.
  
  RUNSTATUS - Returns a CVDA value indicating whether the task 
  is running. The only supported value is RUNNING.

  STARTCODE - Returns a 2-character string indicating how the 
  task was started. Possible values are:

    D  - DPL request. Program cannot issue I/O requests against 
         its principal facility, nor issue any syncpoint requests.
    DS - DPL request. Same as above, except program can issue 
         syncpoint requests.
    QD - Transient data trigger level
    S  - START command without data
    SD - START command with data
    TD - Terminal input
    QB - Batch request

  TASK - Specifies the sequence number that identifies the task, in 4-byte
  packed-decimal format.

  TRANSACTION - Returns a 4-character string containing the 
  name of the transaction (if any) associated with the task. 
  Blanks are returned if there is no associated transaction.

  USERID - An 8-character string identifying the user 
  currently associated with the task.

  The TASKIDERR condition occurs if the specified task cannot 
  be found.

INQUIRE TASK LISTSIZE(fullword binary data-area)
        [RUNNING]
        [SUSPENDED]
        [SET(pointer)]

  The INQUIRE TASK LIST command returns a list of user tasks as defined 
  to the system. Task states must be specified explicitly.
  
  LISTSIZE - Returns a fullword binary field giving the number of tasks 
  in the categories you included in your inquiry. Required parameter.
  
  RUNNING - Lists only tasks that are actually running (not suspended).
  This includes the issuing task.
  
  SUSPENDED - Lists only tasks that are currently suspended (tasks waiting
  for some event or condition). This excludes the issuing task.
  
  SET - Address of a list of 4-byte packed-decimal task numbers. Each 
  entry in the list identifies a task in one of the requested categories. 
  If there are no tasks in the requested categories, the SET pointer 
  contains a null value.
  
  Note: If neither RUNNING nor SUSPENDED is supplied in the command, all
  tasks are included in the task list.

    
4. The Sun MTP Installation Guide for Release 7.2.0 contains errors in 
Chapter 5, Verifying the Installation (BugId 4789453). It states that 
there are two versions of the Primer application: the COBOL version 
is located in $UNIKIX/test/primer/cobol, and the C version is located 
in $UNIKIX/test/primer/C. This is incorrect. Both versions are located 
in $UNIKIX/test/primer. 

The document also incorrectly states that the kixprimer script, which is 
used to set the environment for running the sample applications, is 
located in each of of respective directories. The kixprimer script is 
actually located in $UNIKIX/bin. You can execute this script from the 
$UNIKIX/bin directory to set the environment for both the COBOL and C 
sample applications.

5. A fix to BugId 4787102 requires a documentation addition. When 
configuring terminals in the 3270 Devices portion of the Terminal 
Control Table, be aware that the Host Name and Port Number fields 
on the Host & Port screen are applicable only for terminals that 
access the region by means of the TPS PU4/5 server software 
(unikixtrin process). These fields are ignored for all other 
terminal definitions.

6. Sun MTP has been enhanced to include a new unikixmain (kixstart) 
startup option (BugId 4781305). The option is implemented as follows:

   -O TDINTRA=[NOEMPTY|EMPTY]
   
   Specifies whether recoverable intrapartion TD queues are to be 
   discarded at region startup. If the option is not specified, 
   the default is NOEMPTY.
   
   Valid arguments are:
   
     EMPTY - Indicates to discard the queues.
     
     NOEMPTY - Indicates that the records on the queues are to be 
     retained. This is the default.
   
Three error messages have been added as part of this enhancement.

   KIX0730F Invalid -O option keyword: %s
   
     Description: An invalid keyword was specified on the command line.
   
     Solution: Resubmit the command using a valid keyword. Currently 
     TDINTRA is the only valid keyword.
     
   KIX0731F Invalid -O option usage: -O TDINTRA=[NOEMPTY|EMPTY]
   
     Description: There is a syntax error in the -O TDINTRA=<value> 
     option.
     
     Solution: Resubmit the command using the correct syntax, which 
     is displayed in the error message.
     
   KIX0732F Invalid value: %s for -O option keyword: %s
   
     Description: An invalid value was supplied to the -O option keyword.
     
     Solution: Resubmit the command using a valid value to the specified
     keyword. The supported values for the TDINTRA keyword are NOEMPTY 
     and EMPTY.
     
7. If double-byte character set support (DBCS) was enabled for the
region, and the following error message was written to the unikixmain.err 
file:

   KIX3656E [cvlwrupr] mblen failed, return code = -1 , errno = 88

running the kixclt utility on your COBOL application programs and
recompiling them should eliminate the problem. (BugId 4782622 and 4772318)


 
--------------------------------
Sun MTP 7.2.0p6    -   112271-06
--------------------------------

1. Added support for the KEYLENGTH(data-area) and KEYPOSITION(data-area) 
parameters to the EXEC CICS INQUIRE FILE command. (BugId 4744167)

2. New error message (BugId 4751419). See also #3 in the section
   Sun MTP 7.2.0p4.1 for information about the -A and the -B options
   to unikixmain.

0557W Both "-A" and "-B" specified in MTP startup parameters. Possible conflict.

Description: Warning message indicating that you used both the -A and -B 
options to unikixmain (or kixstart) when starting the region.

Cause: When a DBCS conversion table file is specified at region startup (using 
-B), the first 256 entries in the file represent the single-byte character set 
(SBCS) conversion characters. Therefore, if you also specify the -A option, the 
SBCS conversion table built from the DBCS file will be overwritten. This can 
cause a mismatch between the double-byte and single-byte character sets.

Solution: Do not use both the -A and -B options when starting a region.

3. The Sun Mainframe Transaction Processing Developer's Guide for Release 7.2.0 
incorrectly stated that the COMMAREA parameter of the EXEC CICS ADDRESS command 
was not supported. The COMMAREA parameter is, in fact, supported.(BugID 4754923)

4. Table 3.1 in the Sun Mainframe Transaction Processing Administrator's Guide 
did not include descriptions for the last two fields of the ASCII VSAM catalog 
format. (BugID 4750737) Those fields are defined as follows:

1st flag - Batch Read-locking field

Y - Lock VSAM records when READ is issued for this file from batch.
N - Do not lock VSAM records when READ is issued for this file from batch.

2nd flag - Reuse Allowed field

Y - Reuse is allowed for this file
N - Reuse is not allowed for this file

5. The size of the Filename field in the Intrapartition & Extrapartition 
screens of the Destination Control Table has been changed to accept only 
10 characters. (BugID 4657804)

6. Documentation did not include information about compiling C++ programs. 
   (BugID 4767661). The following is the documentation.

The Sun MTP application run unit is built using the C compiler and loader. 
If an application program is written in C++, you must use the C++ compiler 
(usually the CC command), and the required loader to build shared objects 
that can be loaded by the transaction servers. The include files provided 
in the $UNIKIX/src/CICS_structures directory are the same for C++ programs.

For example, to build a C++ shared object from the acct00.ccs program, execute 
the following commands:

        kixclt acct00.ccs
        CC -Bdynamic -Kpic -c -Xt -I$UNIKIX/src/CICS_structures -o acct00.0
                 acct00.c
        ld -G -o acct00.so acct00.o

7. If your region contains .lst files for the SNT, PCT, PPT, and FCT that were 
created with versions of Sun MTP prior to this release, AND you do not use 
groups, do not import the .lst files into this release. To ensure that your 
.lst files work with this release, do either of the following:

 - In the Table Manager, open each of these tables and export them using
 this release of the software.
        
 OR
        
 - Open each of the existing .lst files (snt.lst, pct.lst, ppt.lst,fct.lst) 
 in a text editor. Locate the group name field. If it does not contain a 
 group name, type at least one space between the back-to-back commas. Do this
 for each entry. Then save the .lst file. Examples are as follows:
        
 In the snt.lst file, the group field is the fourth from the left:
 aaabco,aaabco,abc,,F~YkoiqvotH_\,8000000000000000,0f0f3f,hi ,D,88,,X,11984,N
 Correct it to:
 aaabco,aaabco,abc, ,F~YkoiqvotH_\,8000000000000000,0f0f3f,hi ,D,88,,X,11984,N

 In the fct.lst file, the group field is the eighth from the left:
 TEMPSTG,TEMPSTG,KIXSYS,VSAM,KSDS,C,V,,Y,N,N,,0,0,
 Correct it to:
 TEMPSTG,TEMPSTG,KIXSYS,VSAM,KSDS,C,V, ,Y,N,N,,0,0,

 In the pct.lst file, the group field is the 11th from the left:
 BATCH000,,CBCH,0,1,DEF,N,0,,,,Y,,KIXDFLT
 Correct it to:
 BATCH000,,CBCH,0,1,DEF,N,0,,, ,Y,,KIXDFLT 

 In the ppt.lst file, the group field is the sixth from the left:
 BATCH000,B,,,,,,,F,
 Correct it to:
 BATCH000,B,,,, ,,,F,

(BugId 4744995, and duplicate bug 4744609)

--------------------------------
Sun MTP 7.2.0p5    -   112271-05
--------------------------------

1. Transactional Support for MQSeries
-------------------------------------

Sun MTP has been enchanced to allow MQSeries updates to be synchronized with
Sun MTP SYNCPOINT/ROLLBACK.

When the user executes the following command:

EXEC CICS SYNCPOINT

Changes done in the transaction for MQSeries are committed.


When the user executes the following command:

EXEC CICS SYNCPOINT ROLLBACK

Changes done in the transaction for MQSeries are rolled back.


When the user completes the transaction, an implicit SYNCPOINT is done 
by Sun MTP that commits all the changes done to MQSeries.

With this feature, the user can synchronize updates to MQSeries with VSAM and
databases such as ORACLE and SYBASE.

Limitations :

1. MQSeries server and the Sun MTP region must be on the same host.
2. Transactional support cannot be used with the trigger mechanism.

The Third Party Packages screen in the kixinstall configuration utility 
now has the option:

        MQSeries with transactional support

If the user chooses this option, transactional support is provided for 
MQSeries resources.

MQSeries applications can be used within MTP without trigger mechanism.

If the applications know the MQSeries Queue Manager name and Queue name, 
and the applications do not need transactional support, the user can choose 
the MQSeries option.

2. kixclt Changes for C Language Transactions
----------------------------------------------

The kixclt changes apply to the following data types:

Data type                   Usage                Comments


Character String            Data-area (R)        Translator was prefixing
variable                                         the name of the variable
                                                 with &

                                                 Now it does not prefix it
                                                 with &

Structure or                Data-area (R)        Translator was prefixing
union                                            the name of the variable
                                                 with &

                                                 Now it does not prefix it
                                                 with &

Array (of                   Data-area (R)        Translator was prefixing
Anything)                                        the name of the variable
                                                 with &

                                                 Now it does not prefix it
                                                 with &

Array (of                   Data-area (R)        Translator was prefixing
Anything)                                        the name of the variable
                                                 with &

                                                 Now it does not prefix it
                                                 with &

Retranslate the source files and test them before putting them into production.



--------------------------------
Sun MTP 7.2.0p4.1  -   112686-01
--------------------------------

1. Support for files greater than 2 gigabytes in size.

   If using mfrcd record format for input or output with unikixbld
   and files are greater thatn 2 GB, Server Express Cobol must be used.
   Please refer to the "File Handler Configuration" section in the
   Server Express "Programmer's Guide for File Handling" and read about
   the handler configuration file. This configuration file must
   contain, at a minimum, the following statements :

        [XFH-DEFAULT]
        FILEMAXSIZE=8

   Depending on your application, this file may contain other
   statements.

   In the region setup file, define the EXTFH environment variable,
   which specifies the location of the handler configuration file.

2. Support for the OUTLINE paramater in BMS maps.

3. Enhancements to DBCS support.

   a. Changes to unikixmain options.

      The unikixmain command has been changed to only accept a single byte 
      conversion table in the -A option. The -B option has been modified to 
      accept a double byte conversion table.

      The new usage is:
	
	-A <single byte conversion table> 
	-B <double byte conversion table>

	The single byte conversion table is a 256-byte file representing 
	EBCDIC to ASCII conversion of characters 0x00 thru 0xff.

	The double byte conversion table is a 131072 byte file representing
	EBCDIC to ASCII conversion of characters 0x00 0x00 thru 0xff 0xff.

	-B continues to specify that DBCS is ON.

	Table names               language               size

        IBM-290toJIS-Roman.table   Japanese              SBCS
        IBM-1027toJIS-Roman.table   Japanese             SBCS


  b. Support for dtterm

     The xxxunikix command now supports dttermunikix.
     
     The dtterm.key file is shipped in $UNIKIX/lib.
     
     3270 Function	Keyboard Legend
     UP			Up arrow
     DOWN		Down arrow
     LEFT		Left arrow
     LEFT		Backspace
     RIGHT		Right arrow
     TAB		Tab
     BTAB		Shift - Tab
     ERAEOF		Page Down
     ERAINP		Page Up
     INSMODE		Insert
     DEL		Delete
     ENTER		Keypad Enter
     CLEAR		Keypad add (+)
     RESET		Keypad subtract (-)
     REFRESH		Control - lower case L
     PF1 through PF10	F1 through F10
     PA1		Keypad divide (/)
     PA2		Keypad multiply (j)
     PRINT		End 



--------------------------------
Sun MTP 7.2.0p4    -   112271-04
--------------------------------

1. Support for Secure Sockets Layer (SSL) clients using Network 
   Security Services software (version 3.4). Refer to the PDF 
   file ssl.pdf in the doc directory.

2. Support for Oracle 9i.

3. KIX2925F: Process %s is not built using thread library on Solaris

   Description: The specified process was not built using the thread library.

   Solution: If the process is supplied by Sun MTP, contact your authorized Sun 
   service provider with the information. If the process was created by the
   user, for example, using the C-ISAM library, then the user must create 
   the executables with the thread library. Alternatively the user can disable
   the -j option during startup, but this might affect performance

--------------------------------
Sun MTP 7.2.0p3    -   112271-03
--------------------------------

No documentation updates



--------------------------------
Sun MTP 7.2.0p2    -   112476-01
--------------------------------

1. Support for a Sybase C-only version of user exits. The 
kixinstall utility has been enhanced to include the C user 
exit module for Sybase. The module name is $UNIKIX/src/
rdbms/kxsybase.cp.

2. Enhancement to the kixinstall utility to allow a user to 
specify compiler/linker options that will be used when 
compiling/linking user objects into the Sun MTP executables. 
This allows a user, for example, to specify the -misalign 
compiler option, which allows single-byte packed structures.

3. Support for the INQUIRE TASK CICS command:

The EXEC CICS INQUIRE TASK API with the following options is 
supported. Unsupported options are listed at the end of this 
summary.

INQUIRE TASK(...)
        [FACILITY(...)]
        [FACILITYTYPE(...)]
        [PROCESSID(...)]
        [RUNSTATUS(...)]
        [STARTCODE(...)]
        [TRANSACTION(...)]
        [USERID(...)]

This command retrieves information about a specified user 
task. User tasks are those associated with user-defined 
transactions or with MTP-supplied transactions that are 
usually invoked by an operator.

FACILITY - Returns a 4-character string representing the 
name of the facility associated with the named task. If the 
task was initiated from a terminal, the name of the terminal 
is returned. If the task was initiated by a destination 
trigger level, the name of the associated transient data 
queue is returned. Otherwise, a null value is returned.

FACILITYTYPE - Returns a CVDA value indicating the type of 
facility that initiated the task. Possible values are:

TASK - task was initiated by another task

TERM - task was initiated from a terminal

DEST - tast was initiated by a destination trigger level

RUNSTATUS - Returns a CVDA value indicating whether the task 
is running. The only supported value is RUNNING.

PROCESSID - Returns a 32-bit binary value indicating the 
process id of the process (MTP unikixtran) running the 
transaction associated with the task.

STARTCODE - Returns a 2-character string indicating how the 
task was started. Possible values are:

D - DPL request. Program cannot issue I/O requests against 
its principal facility, nor issue any syncpoint requests.
DS - DPL request. Same as above, except program can issue 
syncpoint requests.
QD - Transient data trigger level
S - START command without data
SD - START command with data
TD - Terminal input
QB - Batch request

TASK - 32-bit binary value indicating the task identifier.

TRANSACTION - Returns a 4-character string containing the 
name of the transaction (if any) associated with the task. 
Blanks are returned if there is no associated transaction.

USERID - An 8-character string identifying the user 
currently associated with the task.

The TASKIDERR condition occurs if the specified task cannot 
be found.

Unsupported parameters:

UOWSTATE
TCLASS

4. Support for the AT and AFTER parameters of the START CICS 
command:

The EXEC CICS START command now supports the AFTER and AT 
parameters

AFTER - Along with one or more of the HOURS, MINUTES, and 
SECONDS arguments, specifies the interval of time that must 
elapse before the new tast is started. For C/C++ programs, 
this option must be used instead of INTERVAL. 

AFTER HOURS(0) is the default.

AT - Along with one or more of the HOURS, MINUTES, and 
SECONDS arguments, specifies the time when the new task is 
to start. For C/C++ programs, this option must be used 
instead of TIME.

HOURS - A 32-bit binary value indicating the number of 
hours. The value must be in the range 0 through 99.

MINUTES - A 32-bit binary value indicating the number of 
minutes. The value must be in the range 0 through 59 if 
HOURS or SECONDS is also specified, or in the range 0 
through 5999 otherwise.

SECONDS - A 32-bit binary value indicating the number of 
seconds. The value must be in the range 0 through 59 if 
HOURS or MINUTES is also specified, or in the range 0 
through 359999 otherwise.

5. Support for the APPLID parameter of the EXEC CICS INQUIRE 
SYSTEM command:

The INQUIRE SYSTEM [APPLID(data-area)] parameter is now 
supported. APPLID will return an 8-character string that is 
the value of the Application Name field in the System 
Initialization Table (SIT).


--------------------------------
Sun MTP 7.2.0p1    -   112271-02
--------------------------------

No documentation updates

