                      Information relating to fixpack 2
                      ---------------------------------

This CD contains fixpak 2 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.


  CICS for OS/2 and VisualAge CICS Information

    o Euro Support
    o New Userexit 33
    o New Environment Variables
    o Documentation Updates
    o APARS included in this fixpack
    o Known problem using the take backup feature of the installer (EPFIE132)
    o Changes to CICSENV.CMD

  VisualAge CICS for Windows/NT information only
    o IBM COBOL ECI/EPI/ETI and DB/2 samples
    o Communications server support
    o DBCS Support (Added in fixpak 1)

  Service Fixes contained in this product
    o APARS included in this fixpack

Euro Support
------------

  CICS for OS/2 and VisualAge CICS has extended it's codepage support to
  include code pages 00858, 01250, 01252, 01254, 05348, 01140, 01141, 01142,
  01143, 01144, 01145, 01146, 01147 + 01149.

  CICS for OS/2 and VisualAge CICS for NT can now deal with the above code
  pages in the following scenarios (providing that the operating system fully
  supports these code pages) :

  1.Allows CEDA definition of a TCT with new codepages. The effect of which is
    to allow the Euro symbol to be entered on a CICS terminal.
  2.Allows CEDA definition of a TCS with new codepages. This allows outbound
    transaction routing flows to be able to handle Euro character.
  3.Allows CEDA definition of a CVT with new codepages. Allowing conversion to
    occur using the new codepages. This allows inbound function shipping flows
    to be converted using the new codepages.

  OS/2 Version 4 needs to have fixpack 9 applied in order for CICS for OS/2 to
  support the Euro codepage. (OS/2 Version 3 and OS/2 Warp Server v4 need to
  have fixpack 38)

  Windows/NT provides Euro support in service pack 4, or there is a hotfix
  which can be applied onto service pack 3.


New Userexit 33
---------------

    A new userexit has been added into CICS which can be used for monitoring
  the dynamic installation, discarding or modification of certain resources.
  This user exit is called for these resources when CEDA INSTALL or EXEC CICS
  FEPI INSTALL commands are called for new definitions being installed, or when
  definitions are being changed by reinstalling. It is also called when
  definitions are being discarded through the EXEC CICS FEPI DISCARD command.


New Environment Variables
-------------------------

  Two new environment variables have been added into CICS with this fixpack:

o NOLOCALCLIENTTRACE - When CICS is active and tracing is turned on, the local
    client also traces. If this environment variable is set to any value, then
    local client tracing is not turned on when server tracing is started.

o CICSACTLINK - The CICS APPC allocate logic used to verify that a link which
    an allocate is about to use is active, thus ensuring that the allocate will
    not hang if the link is not active. Under certain circumstances (e.g. using
    2 adapters), there is no easy way for CICS to determine which link the
    allocate will use. This default behaviour has been changed so that the link
    with not be activated prior to allocate.

    However, if environment variable 'CICSACTLINK' is set then CICS will
    attempt to activate the link prior to any APPC allocate, restoring the old
    default behaviour.


Documentation Updates
---------------------

  Euro Changes (PQ20626):

    The customization Guide (sc33-1581-01) will be updated to include the
    following code pages in Chapter 3. 'Using the CEDA transaction to define
    resources' in the CVT list of ascii local codepages and in the list of
    ebcdic remote codepages:
       00858, 01250, 01252, 01254, 05348, 01140, 01141, 01142, 01143,
       01144, 01145, 01146, 01147 + 01149.

  PQ19489:

    The Customization guide in the CICS for OS/2 security chapter in the
    External Security section will be updated with the following information :

    Please be aware that User exits 07,08 and 09 are only passed userids and
    passwords when either
    - there is an associated terminal
    or
    - for exits 7 and 9, for inbound function shipping requests

  User Exit 33 (PQ21183):

    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.

        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
           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.


Known problem using the take backup feature of the installer (EPFIE132)
-----------------------------------------------------------------------

When upgrading and the 'Save backup copy' option is selected, a backup of
each file is kept so a restore can be performed later.  However, if a
backup already exists then you might receive an error EPFIE132.

To overcome this problem, remove the directory *.$BK inside the CICS for
OS/2 or CICS Client for OS/2 main directory.
Eg.  If CICS for OS/2 is installed into C:\CICS300 then the directory
C:\CICS300\CICS300.$BK should be removed prior to upgrading again.


Changes to CICSENV
------------------

The above command file has been changed by this fixpak.  In order not
to overwrite any changes you may have made to this file, the new version
has been placed in a subdirectory called UPDATES.CSD, eg. CICS310\UPDATES.CSD.

The change needs to be migrated back into the .CMD version of these
files in order for them to be effective. Specific change is line 415 has been added.


IBM COBOL ECI/ETI/EPI and DB2 Samples (VisualAge CICS on Windows/NT only)
-------------------------------------------------------------------------
  Samples have been shipped to build the sample ECI, EPI, ETI and DB2 programs
  using IBM COBOL. To build:

    ecostate.cbl - run mecostat.cmd
    ecosyn.cbl   - run mecosyn.cmd
    episamp.cbl  - run mepisamp.cmd
    etisamp.cbl  - run metisamp.cmd
    db/2 samples - run mfaadb2.cmd

 Please be aware the latest fixpack for DB/2 may be required to run the
 supplied DB/2 samples.

Communications server support (VisualAge CICS on Windows/NT only)
-----------------------------------------------------------------
  Communications server support is provided for IBM eNetwork Communications
  Server, IBM Communications Server and Microsoft SNA Server.

  To select which communications server is to be used the environmental
  variable CICSCOMMSSERVER must be set in CICSENV.CMD,
  where:
    SET CICSCOMMSSERVER=IBM    for IBM eNetwork Communications Server, or
                                   IBM Communications Server.
    SET CICSCOMMSSERVER=MSSNA  for Microsoft SNA Server
  the default setting is IBM.

  To allowing inbound transaction programs using IBM eNetwork Communications
  Server, TP definitions have to be configured. Definitions need to be done
  for the CICS transactions CRTE, CCIN, CTIN, CPMI, CVMI, CRSR plus any user
  transactions which could be started via inbound FMH-5's.

  The following is a sample TP definition:
      - Conversation type = Mapped
      - Synchronization level = Any
      - Conversation security required = no
      - receive_allocate timeout = 0
      - Incoming  allocate timeout = default
      - TP Instance = 1
      - PIP Allowed = Yes
      - For SNA Client Use = No
      - Dynamically loaded = Yes
      - Full Duplex support = No
      - TP queued = No
      - Background Task = Yes

DBCS Support (VisualAge CICS on Windows/NT only)
------------------------------------------------

  DBCS Terminals
  --------------
      DBCS terminal support is provided by use of the CICS Client terminal
      emulator. DBCS terminals must be started using the Start Menu item
      or using the IBM CICS Client. A permanent DBCS terminal cannot be
      defined using CEDA.


  Debugging a DBCS transaction program
  ------------------------------------

      As the Client terminal emulator is being used the actual transaction
      program is running under a non-facility task. To debug an application
      you will need to start the debugger for that non-facility task.
      In a standard system the non-facility used to run the program will
      usually be the first one available, which is the next task after the
      permanent facilities. So if V123 is the only permanent facility then
      the first non-facility will be the second task which is called @02@,
      so start your debugger for that facility, ie.
         CICSRUN /d-@02@(idbug)
      A better way is to ensure only one non-facility task can be used. This
      can be achieved by doing the following:
        1) Start CICS
        2) Using CEDA SIT add a new SIT entry called SITDEBUG with:
             Maximum number of tasks = 1
             Minimum free tasks      = 1
        3) Shutdown CICS
        4) Start CICS under the debugger with no permanent facilities using:
             CICSRUN /o-SITDEBUG /n /d-@01@(idbug)

  Restrictions for DBCS systems
  -----------------------------

      The following restrictions exist for DBCS systems:

      1. The CICS Telnet daemon does not support DBCS.
         When the CICS Telnet daemon is started the client and server
         codepages will default to 37 and 437 respectively.

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

+---------+------------------------------------------------------------------------------------------------------------------------------------+
: Apar No : Brief Description                                                                                                                  :
+---------+------------------------------------------------------------------------------------------------------------------------------------+
: PQ20330 : TRANSACTION SERVER FOR OS/2 V4.1 AND VISUAL AGE CICS FIXPAK 2                                                                      :
: PQ12413 : WHEN CUSTOMER LOSES ONE OF TWO CONNECTIONS, HE CANNOT USE EITHE CONNECTION GOING OUT OF CICS OS/2.                                 :
: PQ13313 : SUPPORT FOR ANSI COBOL DECLARATIVES AND D FLAG.                                                                                    :
: PQ13486 : SYS3175 IN MFRTS32                                                                                                                 :
: PQ13700 : LOCAL CLIENT TRACE FAACLI.TRC CAN NOT BE TURNED OFF IF CICS OS/ TRACING IS ON.                                                     :
: PQ14672 : EXIT 10 NOT DRIVEN IN CICS FOR OS/2                                                                                                :
: PQ15307 : CICSTRAN CUTTING OFF END FOR FILE LEAVING OFF THE PROCEEDURE DIVISION                                                              :
: PQ15373 : NEED TRACEPOINTS IN FAAMIR FOR CAUSE OF DEALLOCATE ON DETACH                                                                       :
: PQ15614 : IOERROR INCORRECTLY GIVEN FOR AN AFCF FAILURE.                                                                                     :
: PQ17120 : EXEC CICS LOAD OF A DATA TABLE RETURNS NULL POINTER                                                                                :
: PQ17152 : HANDLE ABEND DOES NOT WORK CAUSING APPLICATION LOOP                                                                                :
: PQ17200 : TRAP IN A CICS LINK'ED TO MODULE WHEN THE TASK IS CICS PURGE'ED                                                                    :
: PQ17504 : THE COMMAND CICSMAP DOES NOT SUPPORT DIRECTORY NAMES WITH HYPHENS SUCH AS "CICSMAP C: JUNK TEST-1 FAADCMA"                         :
: PQ17982 : FAAREGISTERRM UNRESOLVED DURING LINK OF VISUALAGE CICS SAMPLE PROGRAM FAARMDBM                                                     :
: PQ18345 : CONNECTING A TERMINAL GETS FAA5794E RC1                                                                                            :
: PQ18574 : FAA6204E DURING A CCIN ATTACH                                                                                                      :
: PQ19145 : SYS3175 IN FAAOTPTK.EXE (FAASIPTC.DLL) UNDER HIGH LOAD SITUATIO S CICS LOG HAS: FAA5595W MSG TRAP W/ PRGM FAATPPCI IN CTRL         :
: PQ19275 : SECURITY SUBFIELDS NOT RETURNED ON CCIN RESPONSE                                                                                   :
: PQ19278 : ECI/EPI SAMPLE APPLICATIONS AND DOCUMENTATION MISSING FOR CICS ON THE WINDOWS NT PLATFORM                                          :
: PQ19489 : NO USERID IN EXIT 8 AND EXIT 9 ON AN ECI CALL.                                                                                     :
: PQ19972 : FAATCPCT FAILS WITH SYS3175                                                                                                        :
: PQ19976 : SHARED MEMORY IS LEAKED WHEN CSMT LOG FILLS UP.                                                                                    :
: PQ20090 : EXEC CICS SEND TEXT GIVES BAD EBCDIC                                                                                               :
: PQ20626 : MORE CODEPAGES NEEDED                                                                                                              :
: PQ20707 : EXEC CICS DELAY FAILS WITH INVREQ                                                                                                  :
: PQ20845 : IMPLEMENT COBOL CURRENCY PICTURE BMS TRANSLATOR SUPPORT                                                                            :
: PQ21022 : TRAP IN FAAOTPTK ON WARP SERVER                                                                                                    :
: PQ21183 : ADD NEW DYNAMIC RESOURCE DEFINITION USEREXIT 33 TO CICS FOR OS/                                                                    :
: PQ21808 : FAATPSIN GETS A SYS3175 ON A RECIEVE LESS THAN 4 BYTES                                                                             :
: PQ22564 : FAA5595W TASK @02@: TRAP WITH PROGRAM FAAMIR IN CONTROL WHEN NT ORKSTATION POWERED OFF DURING ECI PROCESSING                       :
: PQ22985 : CEDA/FCT BACKSLASH CANNOT BE ENTERED                                                                                               :
+---------+------------------------------------------------------------------------------------------------------------------------------------+
