                      
                      Information relating to fixpack 3 (UQ45081)
                      -------------------------------------------

This CD contains fixpack 3 (UQ45081) for CICS for OS/2 v3.1 (part of Transaction 
Server for OS/2 v4.1) and Visual Age CICS on both the OS/2 and NT platforms.

Please ensure the README.TXT file is also read as it contains the information
available when the product was originally shipped.


Future Service
--------------

This is the last scheduled fixpack for this product/level.  The timing, and format, 
of any future service delivery will depend on customer demand.


Contents
--------

    o Compiling and executing sample programs
    o Use of the FAAPDPSI Interface
    o User Exit 33 (PQ21183 and PQ27151)
    o APARS included in this fixpack


Compiling and executing sample programs
---------------------------------------

A README.TXT file, which describes the process for compiling and executing the 
various sample programs supplied with CICS for OS/2, has been added to the 
TOOLS sub-directory.



Use of the FAAPDPSI Interface.
------------------------------

When using the FAAPDPSI function in C to control tracing, ensure that
the CLRequestSys field in the PDREQBLK structure is set to the Appl ID.
If it is not, the function will return an ERROR_FILE_NOT_FOUND
return code of 2.


User Exit 33 (PQ21183 and PQ27151)
----------------------------------

The readme for fixpack 2 contained information on the documentation updates
which would be made as a consequence PQ21183 which added userexit33. This should
be replaced by the following information which incorporates the documentation
changes due to PQ27151. PQ27151 added extra functionalilty to userexit33.

|  User Exit 33 (PQ21183 and PQ27151):
|
|    The CICS for OS/2 Customization Guide (SC33-1581-01) will be updated as
|    follows:
|
|    Chapter 10 will have a new section added following the User exit 32
|    section:
|      User exit 33 - Dynamic Resource Definition
|        You can use user exit 33 to view resources as they are installed,
|        modified or deleted through CEDA or EXEC CICS FEPI commands.
|
|        See "User exit 33-Dynamic Resource Definition" on page xxx for more
|        information.
|
|    Chapter 11 will be changed as follows:
|      On the table listing the user exits add:
|        o User exit 33-dynamic resource definition
|
|      After the user exit 32 sections, the following will be added:
|
|      User exit 33 - Dynamic resource definition
|
|        User exit 33 uses entry point FAAEXP33
|
|        User exit 33 can be used to view resources as they are dynamically
|        installed, modified or deleted through either CEDA or EXEC CICS FEPI
|        commands.
|
|        The user exit provides information on the resource name, type and the
|        action being performed.
|
|        Userexit 33 will not be driven whilst CICS is starting up.
|        Therefore terminals which are installed on startup such as
|        V123 will not result in userexit 33 being driven.
|        Userexit 33 is only driven if a TCT or TCS operation
|        is visible via CEMT INQUIRE.
|
|        Implementation in COBOL
|          User exit 33 uses the EXIT-33 structure, defined in FAAEXW33.CBL to
|          pass parameters:
|
|          01 EXIT-33.
|             03 EXIT-33-BLOCK.
|                05 EXIT-33-ACTION                 PIC X.
|                05 EXIT-33-RESOURCE-TYPE          PIC S9(4) COMP-5.
|                05 EXIT-33-RESOURCE-NAME          PIC X(255).
|
|          Where the (EXIT-33-) parameters are as follows:
|           ACTION          The action being performed on this resource.
|                           This will be set to one of:
|                       ACTION-INSTALL - Resource is being installed
|                       ACTION-DISCARD - Resource is being discarded
|                       ACTION-MODIFY  - Resource is being modified
|           RESOURCE-TYPE   The type of resource.
|                           This will be set to one of:
|                       PPT-RECORD               - PPT entry
|                       PCT-RECORD               - PCT entry
|                       FCT-RECORD               - FCT entry
|                       DCT-RECORD               - DCT entry
|                       TST-RECORD               - TST entry
|                       FEPI-PROPERTYSET-RECORD  - FEPI Propertyset
|                       FEPI-POOL-RECORD         - FEPI Pool
|                       FEPI-NODELIST-RECORD     - FEPI Nodelist
|                       FEPI-TARGETLIST-RECORD   - FEPI Targetlist
|                       FEPI-CONNECTION-RECORD   - FEPI Connection
|                       TCT-MODEL-RECORD         - TCT model entry
|                       TCT-TERMINAL-RECORD      - local TCT entry
|                       TCT-REMOTE-RECORD        - remote TCT entry
|                       TCS-SESSION-RECORD       - TCS session entry
|                       TCS-RECORD               - TCS entry
|
|           See the 'TCT and TCS resource types' sub-section below for
|           details about what the various TCT and TCS resource types
|           signify.
|
|           RESOURCE-NAME   The name of the resource.
|
|        Implementation in C
|
|          The C header file for user exit 33 is FAAEXH33.H. It includes the
|          function prototype:
|
|            faaret_t FAAEXPENTRY FAAEXP33(faap_exit_33_t);
|
|          and it defines the input structure, faap_exit_33_t:
|
|            typedef struct exit_33_input
|            {
|                char  exit_33_action;
|                short exit_33_resource_type;
|                char  exit_33_resource_name[255];
|            }S_EXIT_33_INPUT, FAAVERPTR faap_exit_33_t;
|
|          The meanings of these variables can be inferred from the descriptions
|          of the equivalent variables in the COBOL structure, above.
|
|          Derived data types are defined in FAASTHDF.H, which is included in
|          FAAEXH33.H.
|
|          A C example of user exit 33 is provided in FAAEXP33.C. You may use
|          CICSCEXI to build this user exit.
|
|        Implementation in PL/I
|
|          The PL/I include file for user exit 33 is FAAEXI33.INC, and it
|          defines the input structure, S_EXIT_33_INPUT:
|
|          define structure
|             1 S_EXIT_33_INPUT               unaligned,
|               2 exit_33_action              char(1),
|               2 exit_33_resource_type       fixed bin(15),
|               2 exit_33_resource_name       char(255),
|               2 exit_33_filler              char(255);
|
|          The meanings of these variables can be inferred from the descriptions
|          of the equivalent variables in the COBOL above structure.
|
|          A PL/I example of user exit 33 is provided in FAAEXP33.PLI.
|          You may use CICSPEXI to build this user exit.
|
|        TCT and TCS resource types
|
|          The meaning of each of the TCT and TCS resource types and
|          the circumstances when they are set is explained below.
|
|          EXIT_33_TCT_MODEL_RECORD
|            Set when a model terminal definition is installed.
|
|          EXIT_33_TCT_TERMINAL_RECORD
|            Set when a local terminal is installed or terminated.
|            For example it is called in the following circumstances.
|            1. an ETI terminal is started. The terminal which is
|            installed via the install terminal icon in the CICS folder is
|            ETI.
|            2. an ETI terminal is terminated.
|            3. a terminal is installed via CEDA dynamic install where no
|            Remote Sysid has been specified.
|
|          EXIT_33_TCT_REMOTE_RECORD
|            Set when a remote terminal is installed, or terminated.
|            For example it is set in the following circumstances:
|            1. a CICS client terminal is installed or detached.
|            2. a CEDA dynamic TCT install is performed, with Remote Sysid
|            specified to a sysid different to the local server's sysid.
|            3. a CICS client EPI terminal is installed or detached.
|
|          EXIT_33_TCS_SESSION_RECORD
|            Set if a session is acquired from a TCS connection entry.
|            For example:
|            1. a CICS client runs a transaction. These session entires are
|            visible via CEMT INQUIRE TERMINAL. For non-conversational
|            transactions the sessions are normally installed and deleted
|            too quickly for them to be visible via CEMT.
|
|          EXIT_33_TCS_RECORD
|            Set when a TCS connection is added or terminated.
|            For example:
|            1. A CICS client is attached or detached.
|            2. A CEDA dynamic TCS install
|


APARS included in this fixpack
------------------------------

+---------+------------------------------------------------------------------------------------------------------------------------------------+
: Apar No : Brief Description                                                                                                                  :
+---------+------------------------------------------------------------------------------------------------------------------------------------+
: PQ24748 : MSGFAA5595W TASK FAILED IN PROGRAM FAAMIR LAST FUNCTION 91                                                                         :
: PQ25496 : CANNOT ISSUE SHUTDOWN IMMEDIATE ON FAAPMPCL                                                                                        :
: PQ25557 : TD TRIGGER LEVEL FOR A TRANSACTION WITH NO TERMINAL FACILITY DOES NOT OPERATE IF TASK IS DEFINED IN A CLASS WITH CMXT=1 .          :
: PQ25984 : A DPL WITH SYSID TRANSID SYNCONRETURN RESULTS IN ABENDAEY9 WHEN ALL SESSIONS ARE BUSY INSTEAD OF BEEING QUEUED .                   :
: PQ26057 : INCORRECT EURO PROCESSING ON NT LEADS TO CICS FOR NT TREATING EVERY SYSTEM AS IF IT SUPPORTS EURO.                                 :
: PQ27151 : APAR RAISED TO ALLOW TCT AND TCS INSTALLS TO DRIVER USEREXIT 33                                                                    :
: PQ27738 : CICS FOR OS/2 HANG AT SHUTDOWN, MSGFAA5513E PROCESS 286 TERMINATED ABNORMALLY, RC = 20, ON AN IMMEDIATE SHUTDOWN                   :
: PQ27931 : WHEN THE CONNECTION FROM A COMMS PERSPECTIVE IS ACTIVE & THE DISPLAY COMMANDS DETERMINED THIS, CICS DOES NOT USE THE CONNECTION    :
: PQ28322 : INCORRECT DATE ON SOME FILES AFTER INSTALLATION OF UQ26330                                                                         :
: PQ29853 : AFTER AN ABNORMALLY TERMINATION, FILE BTRVLOG.RCV WAS NOT DELETED. CICS/OS2 CAN NOT BE RESTARTED.                                  :
: PQ29856 : CICS HUNG: THE TERMINAL AND THE CICSMSG.LOG DISAPPEARS FROM THE SCREEN, NO CICS FUNCTION IS FUTHER POSSIBLE.                       :
: PQ31083 : NON-ENGLISH CHRACTERS REDISPLAYED INCORRECTLY WITH VISUAL AGE CICS                                                                 :
: PQ32249 : FAACLNT USING LOOPING AT 99% CPU WITH VISUALAGE CICS ADE AT SHUTDOWN                                                               :
: PQ32478 : CICS FOR OS/2 V3.1 PERFORMANCE ENHANCEMENTS                                                                                        :
: PQ32847 : OS/390 RE-IPL, VTAM RESTART LU0 CONNECTIONS ARE NOT RECOVERED UNDER CICS OS/2.                                                     :
: PQ33195 : MSGFAA0129E EXPECTED ')' IS MISSING. HAPPENS IF BLANKS SURROUND THE SUBSCRIPT                                                      :
: PQ33309 : ECI COMMAREA NEVER REACHES THE CLIENT                                                                                              :
: PQ35432 : ACCENTED CHARACTERS NOT DISPLAYED WITH CICSTELD                                                                                    :
: PQ35904 : FEPI RETURNS NORMAL INSTEAD OF INVREQ                                                                                              :
: PQ36819 : PERFORMANCE PROBLEM WITH MULTIBLE TCS ENTRIES                                                                                      :
: PQ36959 : CEDA PROBLEM CREATING CVT TEMPLATES                                                                                                :
: PQ36989 : CICSREAD AND CICSLOAD PROBLEM                                                                                                      :
: PQ37258 : EDF OF EBCDIC PROGRAMS CORRUPTS DISPLAY                                                                                            :
: PQ38049 : MSGFAA1620W GLOBAL TASK WAITING FOR SEMAPHORE, RC 187                                                                              :
: PQ38917 : FAAPMPSM TRANS=CEDA WITH USERID AND PASSWORD FAILS                                                                                 :
+---------+------------------------------------------------------------------------------------------------------------------------------------+
