INTRODUCTION
------------
This file describes the contents of the IBM AIX Entry/6000 (5765-097)
Version 1 Release 2 Modification 1 (Big 5) PTF UQ11445.
The following topics are covered in this file:
o PREREQUISITES
o ADDITIONAL SUPPORT
- Support for AIX 4.1.2 and Later
- AIX 4.2+ and Write Access for /usr/lpp (PN86428)
o INSTALLING PTF UQ11445
o MIGRATION FOR TQ TABLES (required)
o LIST OF FILES
o LIST OF APARS FIXED
o NOTES FOR UQ11445
- New Tables and Queues Utility Tool (DCR4963)
- DDMS Doc Change (PQ03833)
- Printer Binary Option Added to Print 4029-formatted File (PQ05402)
- TXE_OPT_DISCONNECT Flag Provided on CS2_TRANSACT (PN89993)
- Database/Transaction Configuration File (optional) (PQ05418)
- Txe Mirror Filtering (optional) (PQ05418)
o COMPLEMENTARY FIXES FOR CS/2 ENTRY 1.3.1 AND CS/6000 1.1.1
PREREQUISITES
-------------
Program Temporary Fix UQ11445 requires Entry/6000 (5765-097)
Release 1.2.1 (Big 5). Please ensure you are at this level before
proceeding with the installation of this PTF.
Program Temporary Fix UQ11445 has no prerequisite PTFs.
UQ11445 supercedes PTFs UN94496. UQ11445 can be applied directly
to the Entry/6000 V121 (Big 5) product or on top of PTF UN94496.
UQ11445 is cumulative, containing all fixes from UN94496,
as well as additional fixes.
PTF UQ11445 is language specific.
It is NOT to be applied to the English language version of
the AIX Entry/6000. It is for application
to only the non-English Entry/6000 Big 5 language versions:
Language Version feature numbers
-------------------- ---------------
Korean 5081, 5087
Japanese 5082, 5088
Traditional Chinese 5083, 5089
*** A prerequisite is 3251 AIX Preventive Maintenance Package ***
*** Rel. 320 Volume Z88701 which includes PTF #U493251 and others, ***
*** required to load libwms.a shipped on this PTF. ***
*** Oracle6 TxE server support is not included in this PTF. ***
*** If you are using Oracle6 TxE support, do not install ***
*** this PTF. Contact the Support Center for more ***
*** information. ***
ADDITIONAL SUPPORT
------------------
Support for AIX 4.1.2 and Later
-------------------------------
Entry/6000 1.2.1 is supported on AIX 4.1.2 and later releases with the
installation of this PTF. However, there are some inconsistencies
in AIX 4.1.* that must be fixed before installing Entry/6000 1.2.1 or
this PTF. Please follow these instructions to correct the
inconsistencies:
- Create the directory /usr/lpp/cs2/toolkit/db/cs2. Note that
you must be logged in as 'root' and create the lower level
directories first, e.g. /usr/lpp/cs2.
AIX 4.2+ and Write Access for /usr/lpp (PN86428)
------------------------------------------------
Beginning with Release 4.2 AIX installp no longer allows a product
to be installed with a subdirectory of /usr/lpp having write access
for group staff. Entry/6000 requires that /usr/lpp/cs2/sys be writable
by the user who starts Entry/6000. (PN86428)
The root user who installs Entry/6000 on AIX 4.2 should issue the
the following command after installation is complete:
chmod g+w /usr/lpp/cs2/sys
INSTALLING PTF UQ11445
----------------------
PTF UQ11445 may be installed using the AIX SMIT utility. If installing
from tape, give the tape drive name as the 'INPUT device / directory
for software'. If installing from an image of the tape (that is the
file UQ11445.bff), give the path and file name of the image file.
Follow these directions to update your system and install PTF UQ11445:
1. Shutdown the Entry/6000, if it is currently running.
2. Login as 'root' and execute /etc/slibclean to unload the
Entry/6000 shared libraries from memory.
3. Install PTF UQ11445 using SMIT.
4. This will update the files listed in the Updated Files section.
5. The PTF installation is now complete. You can restart the
Entry/6000. (If on AIX 4.2+, see note above for
PN86428 on how to give write access to the /usr/lpp/ directory
before attempting to start Entry/6000.)
6. Run the TQ migration utility. See Migration For TQ Tables section.
MIGRATION FOR TQ TABLES (required)
----------------------------------
This utility will examine the Table definitions (Queue's don't need
to be migrated) in cs2tqf00.cfs and will migrate the tables if necessary.
Note: is is VERY unlikely that any tables on OS/2 will need to be
migrated and in that case no changes will be made to the table files.
On AIX, most tables will need to be migrated, but there is little chance
of any data being lost or the table being corrupted if the table is not
migrated. The only possible result of not modifying a table would
be that it would appear to fill up before it is actually full.
To migrate the TQ tables:
1. Start DAE.
2. Execute cs2tqmig from the toolkit.
LIST OF FILES
-------------
The following are the files shipped on this PTF:
/usr/include/cs2/cs2.h
/usr/include/cs2/cs2coapi.h
/usr/include/cs2/cs2codfn.h
/usr/include/cs2/cs2db.h
/usr/include/cs2/cs2dberr.h
/usr/include/cs2/cs2dbext.h
/usr/include/cs2/cs2dbsdb.h
/usr/include/cs2/cs2dmcal.h
/usr/include/cs2/cs2ds.h
/usr/include/cs2/cs2xact.h
/usr/include/cs2/txeapi.h
/usr/include/cs2/txemsgrc.h
/usr/include/cs2/txesrv.h
/usr/lib/libcs2.a
/usr/lib/libcs2i.a
/usr/lib/libwms.a
/usr/lpp/cs2/ddms/ddmldip.h
/usr/lpp/cs2/inst_UQ11445/readme.doc.UQ11445
/usr/lpp/cs2/sys/cs2apr00
/usr/lpp/cs2/sys/cs2aptrp
/usr/lpp/cs2/sys/cs2blr00
/usr/lpp/cs2/sys/cs2dmr00
/usr/lpp/cs2/sys/cs2dsrdr
/usr/lpp/cs2/sys/cs2ecr00
/usr/lpp/cs2/sys/cs2fsr00
/usr/lpp/cs2/sys/cs2icr00
/usr/lpp/cs2/sys/cs2irr00
/usr/lpp/cs2/sys/cs2irr01
/usr/lpp/cs2/sys/cs2irr10
/usr/lpp/cs2/sys/cs2ncr02
/usr/lpp/cs2/sys/cs2psr00
/usr/lpp/cs2/sys/cs2psr01
/usr/lpp/cs2/sys/cs2scr00
/usr/lpp/cs2/sys/cs2setup
/usr/lpp/cs2/sys/cs2start
/usr/lpp/cs2/sys/cs2sura0
/usr/lpp/cs2/sys/cs2surc0
/usr/lpp/cs2/sys/cs2tccac
/usr/lpp/cs2/sys/cs2tccon
/usr/lpp/cs2/sys/cs2tciio
/usr/lpp/cs2/sys/cs2tcoio
/usr/lpp/cs2/sys/cs2tcr00
/usr/lpp/cs2/sys/cs2tmr00
/usr/lpp/cs2/sys/cs2tqr00
/usr/lpp/cs2/sys/cs2tqr01
/usr/lpp/cs2/sys/cs2uir00
/usr/lpp/cs2/toolkit/cs2blt
/usr/lpp/cs2/toolkit/cs2cbt
/usr/lpp/cs2/toolkit/cs2cuoff
/usr/lpp/cs2/toolkit/cs2cutil
/usr/lpp/cs2/toolkit/cs2fst
/usr/lpp/cs2/toolkit/cs2ftt
/usr/lpp/cs2/toolkit/cs2stt
/usr/lpp/cs2/toolkit/cs2tqmig
/usr/lpp/cs2/toolkit/cs2tqt
/usr/lpp/cs2/toolkit/cs2utt
/usr/lpp/cs2/toolkit/cs2utt.doc
/usr/lpp/cs2/toolkit/db/assets.dat
/usr/lpp/cs2/toolkit/db/crtdbase.cmd
/usr/lpp/cs2/toolkit/db/cs2db.doc
/usr/lpp/cs2/toolkit/db/cs2dbdcl
/usr/lpp/cs2/toolkit/db/cs2dbdcl.c
/usr/lpp/cs2/toolkit/db/cs2dbddl
/usr/lpp/cs2/toolkit/db/cs2dbddl.c
/usr/lpp/cs2/toolkit/db/cs2dbdml
/usr/lpp/cs2/toolkit/db/cs2dbdml.c
/usr/lpp/cs2/toolkit/db/cs2dbsmp.doc
/usr/lpp/cs2/toolkit/db/cs2dbsmp.mak
/usr/lpp/cs2/toolkit/db/cstrans
/usr/lpp/cs2/toolkit/db/cstrans.c
/usr/lpp/cs2/toolkit/db/cstrans.h
/usr/lpp/cs2/toolkit/db/ctxeodbc.c
/usr/lpp/cs2/toolkit/db/ctxeodbc.mak
/usr/lpp/cs2/toolkit/db/dbsystbl.c
/usr/lpp/cs2/toolkit/db/dbsystbl.exp
/usr/lpp/cs2/toolkit/db/dbsystbl.h
/usr/lpp/cs2/toolkit/db/dbsystbl.mak
/usr/lpp/cs2/toolkit/db/nondbase.c
/usr/lpp/cs2/toolkit/db/nondbase.exp
/usr/lpp/cs2/toolkit/db/nondbase.mak
/usr/lpp/cs2/toolkit/db/nondbase.o
/usr/lpp/cs2/toolkit/db/nonsqldb.c
/usr/lpp/cs2/toolkit/db/persons.dat
/usr/lpp/cs2/toolkit/db/sumdbl.c
/usr/lpp/cs2/toolkit/db/sumdbl.exp
/usr/lpp/cs2/toolkit/db/sumdbl.mak
/usr/lpp/cs2/toolkit/db/sumdbl.o
/usr/lpp/cs2/toolkit/db/tables.run
/usr/lpp/cs2/toolkit/db/txesutbl.c
/usr/lpp/cs2/toolkit/db/txesutbl.exp
/usr/lpp/cs2/toolkit/db/txesutbl.mak
/usr/lpp/cs2/toolkit/db/txetest2
/usr/lpp/cs2/toolkit/db/txetest2.c
/usr/lpp/cs2/toolkit/db/txetest2.mak
/usr/lpp/cs2/toolkit/db/type.dat
/usr/lpp/cs2/toolkit/db/uraixsql.c
/usr/lpp/cs2/toolkit/db/urnopdb2.sqc
/usr/lpp/cs2/toolkit/db/urnopmak.mak
/usr/lpp/cs2/toolkit/db/urnoptxn.c
/usr/lpp/cs2/toolkit/db/usrtxdb2.mak
/usr/lpp/cs2/toolkit/db/usrtxns.exp
/usr/lpp/cs2/toolkit/poolsab
Language specific files:
/usr/lib/nls/msg/Ja_JP/cs2.cat
/usr/lib/nls/msg/Ja_JP/cs2h.cat
/usr/lib/nls/msg/Zh_TW/cs2.cat
/usr/lib/nls/msg/Zh_TW/cs2h.cat
/usr/lib/nls/msg/ko_KR/cs2.cat
/usr/lib/nls/msg/ko_KR/cs2h.cat
/usr/lib/nls/msg/zh_TW/cs2.cat
/usr/lib/nls/msg/zh_TW/cs2h.cat
LIST OF APARS FIXED
-------------------
New on UQ11445:
---------------
DCR4811 NCR - to prevent heartbeat messages from appearing on session
where DAE was started add "DISP=NO" to CS2IRR01.CS2NODE ACB
start parameters in capital letters with no spaces.
DCR4900 CS2.H - allow multiple #include passes to improve usability.
DCR4927 Improved cs2cbt (Configuration Utility Tool) - allow exit
from Add request; start parameter display corrected.
DCR4963 Rewrite TQINIT to CS2TQT.
PN69492 WMS trap causes abnormal end of cs2uir00 during display panel.
PN72402 WMS performance improved for container list update.
PN75425 Semaphore number is increased incorrectly.
PN78096 DDMS used to support baud rates of only 32767 (signed integer).
Now DDMS treats baud rate as unsigned int with value of 65535.
PN78105 DDMS floating point overflow error when device data larger
than 1e+10 and percent deadbanding used on remote variable.
PN78892 cs2cutil - processor type not valid for RCB.
PN80757 DS - CLM3363 returned when DSRP l_timeout=-1.
PN81535 DB - Oracle7 via ODBC CS2_DB API support for CS/6000.
enhancement and various CS2_DB API fixes.
PN81536 NT support on other platforms.
PN81780 DB - cross-platform CS2_TRANSACT API requests are failing in
the mirrored client's path validation - CS2_TRANSACT API has
been updated to no longer require server_drive_path and
client_resp_path when not applicable.
PN83202 poolsab hangs DAE system.
PN88466 Data supply does not erase temporary files when timeout expired.
PN89938 WMS causes an entry field character validation loop.
PN89993 DB - new TXE_OPT_DISCONNECT flag provides explicit disconnect.
PN90723 Print Server - cannot start more than 10 PCBs on CS/6000.
PN91317 UI - on AIX4.2 get CSR5717 when cs2shell up and start 2nd UI app.
PN91325 TQ - cs2tqr01 core dump when message pool is full.
PQ03833 DDMS d_writervar documentation incomplete.
PQ03838 WMS notebook X-Station memory leakage.
PQ05069 CS2_TEMP_RES - create & purge multiple temporary ACBs causes hang.
PQ05402 CS2_PRINT provides invalid output of 4029-formatted file.
PQ05403 DDMS - CSR2095 - resource in use error from ModifyPoll.
PQ05404 CS2_UTIL api traps when passed invalid originator in the RDS.
PQ05406 DDMS enhancement to support d_writervar cross platform.
PQ05407 ECR - cs2ecr00 frees storage which was not malloc'd.
PQ05408 DB - CS2_TRANSACT returns CSR1391.
PQ05409 DB - CS2_TRANSACT gets timeout using TXE_OPT_OPEN_LOOP.
PQ05410 TQ - trap when 2 TQ servers close same T/Q at same time.
PQ05411 DDMS random I/O points do not update when ldit make connection.
PQ05414 DDMS change for variable msg notification (Plantworks PN84964).
PQ05416 Disk Queued messages not received correctly when CACHE LAZY:ON.
PQ05417 TQ Large tables (300,000+ members) get CSR0409 before table full.
PQ05418 Filter TXE secondary mirror requests based on configurable RCs.
PQ05419 CS2_INIT gets good return code when DAE has been shutdown.
PQ05421 Y2000 - update cs2colib and rebuild REMs for year 2000 support.
PQ05422 Time requester keeps sending requests after timeout condition.
PQ05423 TQ - toggle TQ corruption flag during update.
PQ05424 DDMS passing incorrect remote variable size.
PQ05425 TQ - RMU Verify Utility seems to run endlessly for large tables.
PQ05731 Semaphores not deleted at shutdown.
PQ06265 APPC - synchronous TP incorrectly ends after deallocate from host.
PQ07133 TQ - Occasional TQ REM core dumps on open/close of AIX image files.
PQ07271 DDMS cannot support remote variable data length greater than 32K.
PQ07611 CS/6000 applications may hang when run by root user.
From UN94496:
-------------
PN62244 TCP/IP -Coredump was issued from cs2tciio in iio_proc + 0x60.
PN62310 TCP/IP -Processes (cs2tcxxx) are not shutting down normally.
PN68216 TCP/IP -Can't establish tcp/ip session. Options tcp_keepidle,
tcp_keepalive are now used to detect link failures. Signal
handlers to deal with epipe are now installed preventing
termination of cs2tccac during high message-sending rates.
PN68740 TCP/IP -Socket remains after normal shutdown.
PN83589 TCP/IP -cs2tccac does not close unix domain socket.
------------------------------------------------------------------------------
NOTES FOR UQ11445
-----------------
New Tables and Queues Utility Tool (DCR4963)
--------------------------------------------
The cs2utt Utility Tools have a new tool added with this PTF,
the new Tables and Queues Utility Tool (cs2tqt), and a new
cs2utt.doc. Refer to the cs2\toolkit\cs2utt.doc for details.
DDMS Doc Change (PQ03833)
-------------------------
Page 11-281 of the Device Data Management Support
Book update needs the NOTE at the bottom added:
d_writevar Table 11-150 Field Descriptions
Name Type Description
bfr_sz short Variable write: Specify the size (in bytes)
integer of bfr_addr. If the data consists of multiple
elements, you must pack the elements in the
buffer. The size must be equal to or greater
than the variable's element_no field
multiplied by the element_len field. (Both
fields are defined by d_defrvar.)
.
Note: If the size is too small, an E_INVPARM
error is returned.
.
.
ADD => NOTE: For arrays and character strings,
ADD => the bfr_sz field can be less
ADD => than the variable's element_no
ADD => field multiplied by the element_len.
ADD => In such instances the E_INVPARM
ADD => DDMS error is not returned.
Printer Binary Option Added to Print 4029-formatted File (PQ05402)
------------------------------------------------------------------
The following is an update to the DAE Communication System Technical
Guide and Reference, Print and Spool Support chapter, Start Parameters
section. The parameters for printer resource continuation buffer
timeout and printer resource maximum errors remain as before.
| In order to enable optional start parameters with the menu-based
| utilities, remember to set the "Use load parameters from ACB" flag.
Printer REM Start Parameters
----------------------------
The printer REM ACB can contain the following optional start
parameters.
| Note it is also possible to configure multiple printer resources which
| need not all use the same set of start parameters. This is done by
| configuring two or more printer REMs each with a desired set of start
| parameters, then assigning each printer resource to be served by the
| printer REM with appropriate start parameters.
| Printer resource mode
|
| This start parameter specifies whether to print in text or binary
| mode. The parameter is not used on all platforms.
|
| The default print mode is text. With text mode on the OS/2 platform,
| for example, each new-line character is converted to a carriage
| return / linefeed pair.
|
| When you specify binary mode, data is sent to the printer exactly as
| received. No conversion takes place. This parameter may be useful
| to print data formatted for a specific printer. In addition, binary
| mode causes no new-line to be appended to the end of a print job. It
| causes the Printer resource append new-line parameter to default to
| not append a new-line. (This can be overridden by using the Printer
| resource append new-line parameter to explicitly force an ending
| new-line. See the Printer resource append new-line parameter
| description for details.)
|
| This parameter has the following format:
|
| PRMD=x
|
| where x specifies text or binary print mode.
|
| 0 Specifies the default of text mode.
| 1 Specifies binary mode.
Printer resource append new-line
This start parameter allows a user to choose whether or not a
new-line will be appended to the end of a print job. A new-line
consists of a carriage return and line feed control character pair in
OS/2 text file mode. This parameter has the following format.
PRAN=x
where x specifies whether or not a new-line will be appended at the
end of a print job.
0 Specifies that a new-line will not be appended.
| This becomes the default only if the Printer resource
| mode parameter is used to specify binary mode.
| 1 Specifies that a new-line will be appended. This is the default
| when the Printer resource mode parameter is not used, or when
| the printer resource mode parameter explicitly specifies text
| mode.
The appended new-line may be needed with some printers to ensure that
the last print line is flushed from the print buffer when a print job
is completed. It also ensures that no two print jobs will print on
the same line, regardless of job content.
TXE_OPT_DISCONNECT Flag Provided on CS2_TRANSACT (PN89993)
----------------------------------------------------------
Update to DAE Application Programming publication, CS2_TRANSACT chapter:
The work_opt and fail_opt fields also support the following.
work_opt You may optionally specify TXE_OPT_DISCONNECT to
disconnect from the database after this transaction
successfully completes. TXE_OPT_DISCONNECT may
be combined with other work_opt flag values, for
example TXE_OPT_COMMIT.
fail_opt You may optionally specify TXE_OPT_DISCONNECT to
disconnect from the database if this transaction fails.
TXE_OPT_DISCONNECT may be combined with other fail_opt
flag values, for example TXE_OPT_ROLLBACK.
Database/Transaction Configuration File (optional) (PQ05418)
------------------------------------------------------------
The Database/Transaction (DB/Txe) component uses an optional configuration
file, cs2dbtxe.cnf. This file is located in your Distributed Application
Environment system path on the full-function Communication System node
where the DB/Txe server resides. The file is provided by default, but may
be modified, deleted or renamed, if desired.
The DB/Txe configuration file is used to specify the following options:
* Txe mirror filtering (See "Txe Mirror Filtering" below.)
Comments and blank lines are ignored in the file. Only keywords, such as
TxeMirrorFilter, are recognized. Keywords must start in column 1 and are
case insensitive.
Txe Mirror Filtering (optional) (PQ05418)
-----------------------------------------
This optional feature applies only if DB/Txe mirroring is enabled. It is
available for both synchronous and asynchronous mirroring on the full-
function Communication System node. It is described here to document
the interface to and effect on the client.
The DB/Txe component offers the option of filtering secondary mirrored
CS2_TRANSACT requests from reissue to the secondary database exactly as
originated. Mirror filtering is configured by specifying Transaction
mirror return code pairs in the DB/Txe configuration file, cs2dbtxe.cnf, on
the node where the primary database resides. The return code pairs are
specified as a TxeMirrorFilter setting. They determine which failed
primary requests are filtered from mirroring directly to the secondary
database. Each pair consists of an error domain and error value.
cs2dbtxe.cnf is shipped on the server with one Txe mirror filter return
code pair by default:
TxeMirrorFilter = 3,-911. /* Don't mirror SQL deadlocks */
In this setting, 3 is the error domain of TXE_SQL_ERR. -911 is the error
value for the SQL error, "the current transaction has been rolled back
because of a deadlock or timeout." Although deadlock prevention is
preferred to detection, occasional database deadlocks may be unavoidable in
some applications. Here, mirrored CS2_TRANSACT requests can be filtered
from direct reissue to the secondary database to prevent creating an
out-of-synchronization condition, or further deadlock.
An example of three pairs specified is:
TxeMirrorFilter = 3,-911. 1,121. 3,100. /* RCs to filter from mirroring */
When a CS2_TRANSACT request is filtered from mirroring to the secondary
database resource, the parameters of the client's CS2_TRANSACT structure
are examined. If the fail_opt flag in the CS2_TRANSACT structure is set to
TXE_OPT_ROLLBACK (or TXE_OPT_COMMIT), the secondary database resource is
rolled back (or committed, as appropriate). This is done in an attempt to
better synchronize to the primary database.
When a CS2_TRANSACT request results in a Txe error, it returns a non-zero
error domain and value to the client. Typically, the CS2_TRANSACT CSR code
returned is CS2_TXE_ERROR (CSR2820). When mirrored requests are filtered,
the CS2_TRANSACT API returns a similar code, however, it is tailored for
mirror filtering:
CS2_TXE_ERROR_MIR_FLTR (CSR2821) - CS2_TXE_ERROR with secondary
CS2_TRANSACT request filtered from mirroring.
In addition, base log messages confirm the acceptance of the mirror filter
setting, and provide details of mirror errors and filtering. Refer to the
message help for further information.
Note that CS2_TRANSACT always returns the same value from the API as the
RDS return code (cnretcd field).
------------------------------------------------------------------------------
COMPLEMENTARY FIXES FOR CS/2 ENTRY 1.3.1 and CS/6000 1.1.1
----------------------------------------------------------
Entry/6000 1.2.1 CS/2 Entry 1.3.1
PTF UQ11445 PTF UQ11443
---------------- ----------------
DCR4811 DCR4811
DCR4900 DCR4900
DCR4927 DCR4927
DCR4963 DCR4963
PN78096 PN61268
PN78105 PN77882
PN78892 PQ05426
PN80757 PN81539
PN81535 PN80759
PN81536 PN81452
PN81780 PN81028
PN83202 PQ05427
PN88466 PQ05428
PN89993 PQ05429
PN90723 PQ05430
PQ05402 PN79627
PQ05403 PN81433
PQ05404 PN82509
PQ05406 PN82921
PQ05407 PN82927
PQ05408 PN83330
PQ05409 PN83331
PQ05410 PN83647
PQ05411 PN84356
PQ05414 PN85698
PQ05416 PN86802
PQ05417 PN88042
PQ05418 PN88060
PQ05419 PN88546
PQ05421 PN92710
PQ05422 PQ00281
PQ05423 PQ00493
PQ05424 PQ03384
PQ05425 PQ03667
PQ06265 PQ05823
PQ07133 PQ08297
PQ07271 PQ02149
ENTRY/6000 1.2.1 CS/6000 1.1.1
PTF UN94496 PTF UN94493
----------- -------------
PN62244 PN62244
PN62310 PN62310
PN68216 PN68216
PN68740 PN68740
PN88248 PN83589
END OF FILE
-----------