CICS for OS/2 Current Service Status
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 :
+---------+------------------------------------------------------------------------------------------------------------------------------------+
|
