home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / o22516d1.zip / IBMPTF29.DOC < prev    next >
Text File  |  1994-01-05  |  229KB  |  4,653 lines
  1.                                                              i
  2.                                                 README.TXT FOR
  3.                               CICS OS/2 1.2.0 SERVICE LEVEL 29
  4.  
  5.                                                28 October 1993
  6.  
  7.  
  8.   TABLE OF CONTENTS
  9.   ─────────────────
  10.  
  11.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  12.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  13.     Hints and other information.   . . . . . . . . . . . . . 1
  14.      Changes due to fix for APAR PN38509 . . . . . . . . . . 2
  15.  
  16.  
  17.  
  18.  
  19.                                                              1
  20.   INTRODUCTION
  21.   ────────────
  22.  
  23.   CURRENT LEVEL
  24.   ─────────────
  25.  
  26.   The current level of CICS OS/2 is 1.2.0. Service Level 29.
  27.  
  28.   HINTS AND OTHER INFORMATION.
  29.   ────────────────────────────
  30.  
  31.   Required PTF levels for OS/2 Versions
  32.   ─────────────────────────────────────
  33.  
  34.   ┌─────────────┬──────────┬──────────┬───────────┬───────────┐
  35.   │             │ OS/2 1.3 │ OS/2 2.0 │ OS/2 2.0+ │ OS/2 2.1  │
  36.   │             │          │          │ XR06055   │           │
  37.   ├─────────────┼──────────┼──────────┼───────────┼───────────┤
  38.   │ CICS OS/2   │          │          │           │           │
  39.   │ PTF Level   │ 4        │ 16       │ 23        │ 23        │
  40.   │             │          │          │           │           │
  41.   └─────────────┴──────────┴──────────┴───────────┴───────────┘
  42.  
  43.  
  44.   Required Import Groups
  45.   ──────────────────────
  46.  
  47.   The following is a table which indicates the import groups introduced at
  48.   each PTF level. Systems being upgraded from a previous PTF level may require
  49.   to import screen file changes. For example a customer upgrading from PTF
  50.   level 18 to the current level would require to import groups PN21505,
  51.   PN28420 and PN29610.
  52.  
  53.   ┌─────────────┬────────────────────────────────────────────────────────────┐
  54.   │  PTF level  │  Import Group(s)                                           │
  55.   ├─────────────┼────────────────────────────────────────────────────────────┤
  56.   │  1          │  PL61234, PL61239                                          │
  57.   ├─────────────┼────────────────────────────────────────────────────────────┤
  58.   │  8          │  PL71166, PL81305                                          │
  59.   ├─────────────┼────────────────────────────────────────────────────────────┤
  60.   │  17         │  PN15480                                                   │
  61.   ├─────────────┼────────────────────────────────────────────────────────────┤
  62.   │  19         │  PN21505, PN28420                                          │
  63.   ├─────────────┼────────────────────────────────────────────────────────────┤
  64.   │  21         │  PN29610                                                   │
  65.   └─────────────┴────────────────────────────────────────────────────────────┘
  66.                                                              2
  67.  
  68.  
  69.   Changes due to fix for APAR PN38509
  70.   ───────────────────────────────────
  71.  Apar PN38509 has added the following CICS OS/2 error message.
  72.  
  73.  FAA1336               HELP FOR MESSAGE FAA1336W
  74.  
  75.  Text:           FCT Max Record Length for FAAMSFSC is too small.
  76.  
  77.  
  78.  Explanation:    The Max Record Length value in the FCT definition for
  79.                  FAAMSFSC is too small for the size of map being
  80.                  imported/exported.
  81.  
  82.  System Action:  The map will not be imported/exported.
  83.  
  84.  
  85.  User Response:  Increase the Max Record Length value in the FCT definition
  86.                  for FAAMSFSC. The recommended value is 23084.
  87.  
  88.  
  89.     **************************************************************
  90.     **************************************************************
  91.     ***                                                        ***
  92.     ***                   End of PTF 29 updates.               ***
  93.     ***             Updates for previous PTFs follow.          ***
  94.     ***                                                        ***
  95.     **************************************************************
  96.     **************************************************************
  97.                                                              i
  98.                                                 README.TXT FOR
  99.                               CICS OS/2 1.2.0 SERVICE LEVEL 28
  100.  
  101.                                                  30 July  1993
  102.  
  103.  
  104.   TABLE OF CONTENTS
  105.   ─────────────────
  106.  
  107.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  108.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  109.      Changes due to fix for APAR PN38181 . . . . . . . . . . 2
  110.  
  111.  
  112.  
  113.  
  114.                                                              1
  115.   INTRODUCTION
  116.   ────────────
  117.  
  118.   CURRENT LEVEL
  119.   ─────────────
  120.  
  121.   The current level of CICS OS/2 is 1.2.0. Service Level 28.
  122.  
  123.                                                              2
  124.  
  125.  
  126.   Changes due to fix for APAR PN38181
  127.   ───────────────────────────────────
  128.  Apar PN38181 has added the following CICS OS/2 error message.
  129.  
  130.  FAA1897
  131.  
  132.  Text:           Field is defined outside of the SIZE operand parameters
  133.  
  134.  Explanation:    The combined LENGTH and POS of the given field
  135.                  would cause it to spill over the end of the map.
  136.                  The map size has been defined on the DFHMDI
  137.                  macro at the beginning of the map.
  138.  
  139.  
  140.     **************************************************************
  141.     **************************************************************
  142.     ***                                                        ***
  143.     ***                   End of PTF 28 updates.               ***
  144.     ***             Updates for previous PTFs follow.          ***
  145.     ***                                                        ***
  146.     **************************************************************
  147.     **************************************************************
  148.                                                              i
  149.                                                 README.TXT FOR
  150.                               CICS OS/2 1.2.0 SERVICE LEVEL 27
  151.  
  152.                                                  19 May   1993
  153.  
  154.  
  155.   TABLE OF CONTENTS
  156.   ─────────────────
  157.  
  158.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  159.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  160.      Changes due to fix for APAR PN30850 . . . . . . . . . . 2
  161.  
  162.  
  163.                                                              1
  164.   INTRODUCTION
  165.   ────────────
  166.  
  167.   CURRENT LEVEL
  168.   ─────────────
  169.  
  170.   The current level of CICS OS/2 is 1.2.0. Service Level 27.
  171.  
  172.                                                              2
  173.  
  174.   Changes due to fix for APAR PN30850
  175.   ───────────────────────────────────
  176.   This APAR was created to allow further error diagnosis for resource
  177.   shortage problems when using the CICS OS/2 ETI feature. A number of
  178.   new tracepoints have been included. A full list of these ETI
  179.   tracepoints follows.
  180.  
  181.  
  182.  
  183.   ┌─────────┬──────────────────────┬───────────────────────────────────┐
  184.   │ ID = 55 │ Issued by FAAOMPML   │ OS/2 Main Control Task            │
  185.   ├─────────┼──────────────────────┼─────────────────┬─────────────────┤
  186.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  187.   │ POINT   │                      │                 │                 │
  188.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  189.   │ SO H01  │No free entries in the│ 'NO3E'          │ 'NTRY'          │
  190.   │         │external request table│                 │                 │
  191.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  192.   │ SO H02  │Error opening FAACTFTB│ RC              │                 │
  193.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  194.   │ SO H03  │Error reading FAACTFTB│ RC              │                 │
  195.   │         │Starting              │                 │                 │
  196.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  197.   │ SO H04  │Error in DosAllocSeg  │ RC              │                 │
  198.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  199.  
  200.  
  201.     **************************************************************
  202.     **************************************************************
  203.     ***                                                        ***
  204.     ***                   End of PTF 27 updates.               ***
  205.     ***             Updates for previous PTFs follow.          ***
  206.     ***                                                        ***
  207.     **************************************************************
  208.     **************************************************************
  209.                                                              i
  210.                                                 README.TXT FOR
  211.                               CICS OS/2 1.2.0 SERVICE LEVEL 26
  212.  
  213.                                                  16 April 1993
  214.  
  215.  
  216.   TABLE OF CONTENTS
  217.   ─────────────────
  218.  
  219.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  220.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  221.  
  222.  
  223.                                                              1
  224.   INTRODUCTION
  225.   ────────────
  226.  
  227.   CURRENT LEVEL
  228.   ─────────────
  229.  
  230.   The current level of CICS OS/2 is 1.2.0. Service Level 26.
  231.  
  232.  
  233.     **************************************************************
  234.     **************************************************************
  235.     ***                                                        ***
  236.     ***                   End of PTF 26 updates.               ***
  237.     ***             Updates for previous PTFs follow.          ***
  238.     ***                                                        ***
  239.     **************************************************************
  240.     **************************************************************
  241.                                                              i
  242.                                                 README.TXT FOR
  243.                               CICS OS/2 1.2.0 SERVICE LEVEL 25
  244.  
  245.                                                  16 March 1993
  246.  
  247.  
  248.   TABLE OF CONTENTS
  249.   ─────────────────
  250.  
  251.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  252.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  253.     Implementation of C-SET/2 Support  . . . . . . . . . . . 2
  254.  
  255.  
  256.                                                              1
  257.   INTRODUCTION
  258.   ────────────
  259.  
  260.   CURRENT LEVEL
  261.   ─────────────
  262.  
  263.   The current level of CICS OS/2 is 1.2.0. Service Level 25.
  264.  
  265.  
  266.                                                              2
  267.   Implementation of C SET/2 Support.
  268.   ──────────────────────────────────
  269.   This PTF adds support for the 32 bit C Compiler IBM C SET/2 and the debugging
  270.   aid IPMD. The following text describes the additional features available
  271.   after the installation of this PTF.
  272.  
  273.   New features in this release
  274.   ────────────────────────────
  275.  
  276.   1) 32-bit support for OS/2 Version 2
  277.    Other required products:
  278.    IBM OS/2 V2.0; GA level or later
  279.    IBM C Set/2 V1.0 32-bit C compiler; GA level or later - CSD 22 or later
  280.    preferred
  281.  
  282.    Knowledge of how to build conventional 16-bit C programs for CICS OS/2,
  283.    and knowlege of how to build standard OS/2 .EXE and .DLL files using the
  284.    IBM C Set/2 compiler is assumed.
  285.  
  286.    This update allows 32-bit C programs to be written to run under CICS OS/2
  287.    as CICS transaction programs.  It also allows 32-bit ECI programs.  There
  288.    is no support for 32-bit C user exits, nor for 32-bit programs making ETI
  289.    calls, nor for 32-bit programs making off-line system management
  290.    (import/export/field setting) calls.
  291.  
  292.    The actual base CICS is unchanged - therefore all memory passed to or from
  293.    CICS OS/2 must not span a 64KByte boundary, so that pointers to the memory
  294.    can be converted between being either flat (0:32) for the 32-bit code,
  295.    or segmented (16:16) for the internals of CICS OS/2.  Memory which can be
  296.    referenced using either a 0:32 or a 16:16 address is known as 'tiled
  297.    memory'.  Ensure data objects are tiled by compiling with the '/Gt' option
  298.    or by using of the '#pragma seg16' directive.  All memory returned from
  299.    CICS, e.g.  with GETMAIN, or CICS commands with the SET option, or
  300.    COMMAREA, will be aligned so as not to span a 64KByte boundary.  Data
  301.    objects on the stack (automatic storage) will not span a 64K boundary as
  302.    the stack is provided by CICS OS/2.
  303.  
  304.    No memory object bigger than 64KByte may be passed to, or allocated by
  305.    CICS OS/2, as the base CICS OS/2 system is still only 16-bit.
  306.  
  307.    32-bit C CICS OS/2 programs do not have to deal with segmented (16:16)
  308.    pointers - all CICS conversions are done automatically by a 'thunk' layer.
  309.    This conversion is done automatically for pointers passed to CICS OS/2,
  310.    and for pointers returned by CICS OS/2 with the EXEC CICS commands with
  311.    the SET option and EXEC CICS ADDRESS commands.  The thunk layer is a
  312.    library module in FAACLIB.LIB which is linked into the application program
  313.    when an application program DLL is built.
  314.  
  315.    E.g.  EXEC CICS READ FILE(file1) SET(p) LENGTH(len) RIDFLD(rid1);
  316.    file1 is a flat (0:32) pointer to the file name
  317.    rid1  is a flat (0:32) pointer to the RIDFLD
  318.    p     is returned as a flat (0:32) pointer to the file data
  319.  
  320.    The one exception is pointers passed in user-defined areas, such as
  321.    COMMAREAs, storage obtained with GETMAIN SHARED, or the CWA.  CICS OS/2
  322.    has no knowledge of data in these areas and makes no conversions.  If the
  323.  
  324.                                                            3
  325.    pointers in these areas need to be used by both 16-bit and 32-bit program
  326.    then on the 32-bit side they should be declared using the '_Seg16'
  327.    qualifer.
  328.  
  329.    C integers (variables declared with 'int') and enumerations ('enum') are
  330.    different sizes in 16-bit and 32-bit code, so care should be taken passing
  331.    these between 16-bit and 32-bit code.
  332.  
  333.    Character variables default to being signed with IBM C/2 16-bit code and
  334.    unsigned with IBM C Set/2 32-bit code.
  335.  
  336.    OS/2 functions are different between OS/2 V1.3 and OS/2 V2.0.  Code using
  337.    OS/2 V1.X calls will need to be converted to use the OS/2 V2.0 calls when
  338.    the code is recompiled with IBM C Set/2, or it may be possible for the
  339.    user to supply the function declarations for OS/2 V1.X calls with
  340.    appropriate '_Far16 _Pascal' and '_Seg16' qualifiers manually.
  341.  
  342.    Structure packing is another area where care needs to be taken.
  343.    Structures aligned on 1 byte boundaries may take up less storage, but
  344.    accesses to elements which are unaligned may be slower.  Structure packing
  345.    can be controlled with a compiler option ('/Zp?', for 16-bit C; '/Sp?'
  346.    for 32-bit C), or the directive '#pragma pack(?)' or the qualifier
  347.    '_Packed'.  In these examples '?'  should be replaced by '1', '2' or '4'.
  348.  
  349.    CICS OS/2 structures (e.g.  EIB, ECI interface blocks, structures produced
  350.    by the map translator) are expected by CICS OS/2 to be packed on 1 byte
  351.    boundaries.  With 16-bit programs this is achieved by compiling with the
  352.    '/Zp' option, which is a default for the supplied command files for
  353.    program compilation (CICSCTCL & CICSCCMP).  The corresponding option for
  354.    IBM C Set/2 would be '/Sp1', but this is not now necessary and is not
  355.    automatically used by the command files for program compilation (CICS32TC
  356.    & CICS32CL), as the CICS OS/2 headers now include directives to achieve
  357.    this packing.  The map translator also now generates these directives
  358.    automatically for the header files it produces.
  359.  
  360.    The alignment of CICS OS/2 supplied structures (e.g. EIB, maps) can not
  361.    be varied, but with care, by using the '#pragma pack(?)' directive, or the
  362.    '/Sp?' option the storage alignment can be controlled for user structures.
  363.    This may be useful if different structure packing from the default is
  364.    required for other parts of a program.  Existing 16-bit programs probably
  365.    use structures aligned on 1 byte boundaries, so care would be needed if
  366.    data in the structure was also referenced in a 32-bit program, as this
  367.    would have a default alignment of 4, and would not work.
  368.  
  369.    Compiler options can be supplied using the enviroment variables ICC and
  370.    CICSICC.  ICC provides the default options for all invocations of the IBM
  371.    C Set/2 compiler, even when compiling programs which have nothing to do
  372.    with CICS OS/2.  CICSICC is used for options specifically for CICS OS/2 C
  373.    programs, and can override options given in the ICC environment variable.
  374.    An installation may wish to decide on standard compilation options.
  375.  
  376.    Some recommended compiler options are as follows:
  377.    SET CICSICC=/W3 /Kf+i-t-x- /Sa
  378.      /W3        Maximum warning level
  379.      /Kf+i-t-x- all warnings except some which may be confusing
  380.      /Sa        ANSI Standard for C
  381.                                                            4
  382.  
  383.    It is recommended that 16-bit and 32-bit modules are not statically linked
  384.    together into the same DLL.
  385.  
  386.    When a 32-bit CICS OS/2 program is running the IBM C Set/2 compiler
  387.    library handles exceptions such as page faults and segmentation faults.
  388.    This means that an OS/2 trap screen does not appear, because the IBM C
  389.    Set/2 compiler library writes out diagnostic information to file handle 2
  390.    before ending the process.  If the program is running on a full screen
  391.    terminal, then this will appear on the screen.  If it is on a PM terminal
  392.    then output from file handle 2 is normally lost.  By redirecting file
  393.    handle 2 on CICS OS/2 start-up, e.g.  with:  CICSRUN 2>>traps.log this
  394.    information will be appended to a file and will not be lost.
  395.  
  396.    ECI programs may now be written using IBM C Set/2.  The header file
  397.    FAAECIH.H has been changed to allow the existing 16-bit ECI to be called
  398.    from an IBM C Set/2 program.  The ECI parameter block and commarea must be
  399.    allocated from tiled memory - i.e.  memory which does not span a 64KB
  400.    linear address boundary and the address of which can be expressed as
  401.    either a flat 0:32 address or a segmented 16:16 address.  This is achieved
  402.    by compiling with the '/Gt' option or by using the '#pragma seg16'
  403.    directive.  The modified ECI header ensures the address of the commarea
  404.    will be converted to a segmented address when it is set up in the
  405.    parameter block and that the passed address of the ECI parameter block is
  406.    itself converted automatically to a segmented address.
  407.  
  408.    Several new/modified files are supplied:
  409.  
  410.    CICS32TC.CMD    Translates, compiles and links a 32-bit C CICS OS/2
  411.                    program
  412.    CICS32CL.CMD    Compiles and/or links a translated 32-bit C CICS OS/2
  413.                    program
  414.    FAACLIB.LIB     Modified library containing 32-bit C interface code
  415.    FAACSTRT.H      Modified C CICS OS/2 program header file
  416.    FAAECIH.H       Modified ECI header file
  417.    FAAMSPTR.EXE    Modified map translator to give packed structures
  418.  
  419.    Note that when a 32-bit CICS OS/2 transaction is built, the linker may
  420.    give a warning message:
  421.    warning L4008:  aliased fix-up to non-alias object near 2 in object
  422.     SEG16T__faaistrt
  423.    This message may safely be ignored.
  424.  
  425.    Debugging using IPMD.
  426.       This is enabled by using the following startup option:
  427.       CICSRUN /D-V123(IPMD)
  428.       where 'V123' is the name of the terminal to be debugged.
  429.  
  430.       The program to be debugged should be compiled with the '/Ti' option.
  431.       This option can be added to the 'CICSICC' environment variable, if the
  432.       program is compiled using 'CICS32TC' or 'CICS32CL'.
  433.       If it is separately linked using 'link386', the '/CO' option is also
  434.       required.
  435.                                                            5
  436.  
  437.       When the IPMD logo is displayed, 'OK' should be selected to continue.
  438.       When the disassembly window appears, at the debug session controls
  439.       window, select
  440.       'Options'
  441.          'Session Settings'
  442.             'PM Debugging Mode'
  443.                'Asynchronous'
  444.       At the disassembly window, select
  445.       'breakpoints'
  446.          'set'
  447.             'type'       'load'
  448.             'parameters' 'faalspdl.dll'
  449.             'OK'
  450.       'run'
  451.          'run'
  452.  
  453.       This sets a breakpoint on the CLOG program, and continues to run the
  454.       task to allow that terminal and the rest of CICS OS/2 to come up.  (If
  455.       IPMD were to be shut down, e.g.  by typing 'exit' in the debug terminal
  456.       window, before CICS OS/2 was shut down, and the option to save restart
  457.       information were to be chosen, then this breakpoint information and
  458.       other profile information would be saved by IPMD and would not have to
  459.       be entered each time CICS OS/2 was started using IPMD.)
  460.  
  461.       The debugger must hit a breakpoint to stop execution of the task before
  462.       further breakpoints can be set.  When a program is required to be
  463.       debugged, the debugger can be activated by running 'CLOG', which will
  464.       hit the breakpoint set on loading of the 'CLOG' program.  A further
  465.       breakpoint on loading of the user's DLL can then be selected, in a
  466.       similar fashion to the breakpoint on loading of 'faalspdl.dll'.  Once
  467.       the user program is loaded, a breakpoint on the source line can be
  468.       selected using the 'debug session controls' window.
  469.       'OK'                            (Clear the breakpoint message)
  470.       'Threads'
  471.          '2 Enabled runnable'         (Select the main thread)
  472.       'Program parts'
  473.          'userapp.dll'                (the user's dll)
  474.       'File'
  475.          'Open As'
  476.             'Source'
  477.       A breakpoint can then be set as normal on the required source line.
  478.  
  479.       Debugging then proceeds as for normal under IPMD.
  480.  
  481.       Note that a breakpoint could be set directly on the loading of the
  482.       user's program at IPMD startup, or on another program instead of
  483.       FAALSPDL.  The advantage of the indirect approach is that it is easy
  484.       to activate the debugger at any time by typing 'CLOG' on the terminal.
  485.       'CLOG' is a temporarily resident program, so is loaded each time it is
  486.       used, so a load breakpoint will be activated at this point.
  487.  
  488.       Note that no breakpoints (except 'load') should be left in a module
  489.       when the program ends if the module may be unloaded, as with the
  490.       CSD 22 version of IPMD problems may arise if the module is reloaded
  491.       with breakpoints already set inside it.
  492.                                                            6
  493.  
  494.    User exits
  495.       There is no support for user exits written using IBM C Set/2.
  496.  
  497.    External Transaction Initiation
  498.       There is no support for ETI using IBM C Set/2.
  499.  
  500.    External import/export
  501.       There is no support for the use of external import/export routines
  502.       'FAAImport' and 'FAAExport' with IBM C Set/2.
  503.  
  504.    External Field Setting
  505.       There is no support for the use of the field setting procedure
  506.       'FaaSetTableField' with IBM C Set/2.
  507.  
  508.     **************************************************************
  509.     **************************************************************
  510.     ***                                                        ***
  511.     ***                   End of PTF 25 updates.               ***
  512.     ***             Updates for previous PTFs follow.          ***
  513.     ***                                                        ***
  514.     **************************************************************
  515.     **************************************************************
  516.                                                              i
  517.                                                 README.TXT FOR
  518.                               CICS OS/2 1.2.0 SERVICE LEVEL 24
  519.  
  520.                                               19 February 1993
  521.  
  522.  
  523.   TABLE OF CONTENTS
  524.   ─────────────────
  525.  
  526.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  527.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  528.     Hints and other information.   . . . . . . . . . . . . . 1
  529.     Changes due to fix for APAR PN36110. . . . . . . . . . . 2
  530.  
  531.  
  532.  
  533.                                                              1
  534.   INTRODUCTION
  535.   ────────────
  536.  
  537.   CURRENT LEVEL
  538.   ─────────────
  539.  
  540.   The current level of CICS OS/2 is 1.2.0. Service Level 24.
  541.  
  542.   HINTS AND OTHER INFORMATION.
  543.   ────────────────────────────
  544.  
  545.   Required Import Groups
  546.   ──────────────────────
  547.  
  548.   The following is a table which indicates the import groups introduced at
  549.   each PTF level. Systems being upgraded from a previous PTF level may require
  550.   to import screen file changes. For example a customer upgrading from PTF
  551.   level 18 to the current level would require to import groups PN21505,
  552.   PN28420 and PN29610.
  553.  
  554.   ┌─────────────┬────────────────────────────────────────────────────────────┐
  555.   │  PTF level  │  Import Group(s)                                           │
  556.   ├─────────────┼────────────────────────────────────────────────────────────┤
  557.   │  1          │  PL61234, PL61239                                          │
  558.   ├─────────────┼────────────────────────────────────────────────────────────┤
  559.   │  8          │  PL71166, PL81305                                          │
  560.   ├─────────────┼────────────────────────────────────────────────────────────┤
  561.   │  17         │  PN15480                                                   │
  562.   ├─────────────┼────────────────────────────────────────────────────────────┤
  563.   │  19         │  PN21505, PN28420                                          │
  564.   ├─────────────┼────────────────────────────────────────────────────────────┤
  565.   │  21         │  PN29610                                                   │
  566.   └─────────────┴────────────────────────────────────────────────────────────┘
  567.  
  568.                                                              2
  569.   Changes due to fix for APAR PN36110
  570.   ───────────────────────────────────
  571.   As part of this APAR fix the following trace points have been
  572.   added to the product.
  573.  
  574.   ┌─────────┬──────────────────────┬───────────────────────────────────┐
  575.   │ ID = 01 │ Issued by FAASRCKC   │ Task Control                      │
  576.   ├─────────┼──────────────────────┼─────────────────┬─────────────────┤
  577.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  578.   │ POINT   │                      │                 │                 │
  579.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  580.   │ MV K01  │ Starting ENQ/DEQ.    │                 │ Function Code   │
  581.   ├─────────┼──────────────────────┼─────────────────┴─────────────────┤
  582.   │ MV K02  │ Request to gbl task. │ ENQ resource name / address       │
  583.   └─────────┴──────────────────────┴───────────────────────────────────┘
  584.  
  585.     **************************************************************
  586.     **************************************************************
  587.     ***                                                        ***
  588.     ***                   End of PTF 24 updates.               ***
  589.     ***             Updates for previous PTFs follow.          ***
  590.     ***                                                        ***
  591.     **************************************************************
  592.     **************************************************************
  593.                                                              i
  594.                                                 README.TXT FOR
  595.                               CICS OS/2 1.2.0 SERVICE LEVEL 23
  596.  
  597.                                               25 January  1993
  598.  
  599.  
  600.   TABLE OF CONTENTS
  601.   ─────────────────
  602.  
  603.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  604.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  605.     Hints and other information.   . . . . . . . . . . . . . 1
  606.      Changes due to fix for APAR PN27866 . . . . . . . . . . 2
  607.      Notes for implementation of APAR PN13891. . . . . . . . 3
  608.  
  609.  
  610.  
  611.                                                              1
  612.   INTRODUCTION
  613.   ────────────
  614.  
  615.   CURRENT LEVEL
  616.   ─────────────
  617.  
  618.   The current level of CICS OS/2 is 1.2.0. Service Level 23.
  619.  
  620.   HINTS AND OTHER INFORMATION.
  621.   ────────────────────────────
  622.  
  623.   Required Import Groups
  624.   ──────────────────────
  625.  
  626.   The following is a table which indicates the import groups introduced at
  627.   each PTF level. Systems being upgraded from a previous PTF level may require
  628.   to import screen file changes. For example a customer upgrading from PTF
  629.   level 18 to the current level would require to import groups PN21505,
  630.   PN28420 and PN29610.
  631.  
  632.   ┌─────────────┬────────────────────────────────────────────────────────────┐
  633.   │  PTF level  │  Import Group(s)                                           │
  634.   ├─────────────┼────────────────────────────────────────────────────────────┤
  635.   │  1          │  PL61234, PL61239                                          │
  636.   ├─────────────┼────────────────────────────────────────────────────────────┤
  637.   │  8          │  PL71166, PL81305                                          │
  638.   ├─────────────┼────────────────────────────────────────────────────────────┤
  639.   │  17         │  PN15480                                                   │
  640.   ├─────────────┼────────────────────────────────────────────────────────────┤
  641.   │  19         │  PN21505, PN28420                                          │
  642.   ├─────────────┼────────────────────────────────────────────────────────────┤
  643.   │  21         │  PN29610                                                   │
  644.   └─────────────┴────────────────────────────────────────────────────────────┘
  645.  
  646.                                                              2
  647.   Changes due to fix for APAR PN27866
  648.   ───────────────────────────────────
  649.  
  650.   A new version of the run-time library COBLIB.DLL V3.0.54 has been
  651.   shipped as part of this APAR fix. This is used by CICS OS/2 and by
  652.   default is placed in the CICS120\OS2DSD directory.
  653.  
  654.   NOTE:
  655.       ╔══════════════════════════════════════════════════════╗
  656.       ║ This version of the run-time library is INCOMPATIBLE ║
  657.       ║ with ANIMATOR debugger tool shipped with IBM COBOL/2 ║
  658.       ║ and some earlier versions of Micro Focus COBOL.      ║
  659.       ╚══════════════════════════════════════════════════════╝
  660.  
  661.   Your LIBPATH environment variable in CONFIG.SYS should point
  662.   to this newly shipped version of COBLIB.DLL in preference to any
  663.   earlier version of this file, for example which may be part of a
  664.   COBOL/2 or MF COBOL 2.5 directory.
  665.  
  666.   Your CICSWRK environment variable should be used to reference a COBOL
  667.   directory which contains an appropriate level of the ANIMATOR program
  668.   ANIMATE.EXE. For example with MF COBOL V3.0.54 this might be
  669.  
  670.    SET CICSWRK=D:\CICS120\OS2DSD;D:\CICS120\USERDSD;D:\COBOL\EXEDLL
  671.  
  672.   Animator/2 Support
  673.  
  674.   Animator/2 is a Presentation Manager version of Animator, available
  675.   with the MicroFocus Workbench Version 3. The PATH, LIBPATH, COBDIR,
  676.   and COBHNF environment variables must be set as described in the
  677.   MicroFocus COBOL documentation.
  678.  
  679.   To start CICS OS/2 with Animator/2, enter -
  680.  
  681.   CICSRUN /D-V123(ANIMPM)
  682.  
  683.   Restriction: The "Check" function of Animator/2 is not supported; this
  684.                function recompiles the program from within the debugger,
  685.                and results in a Trap if used under CICS OS/2.
  686.  
  687.                                                              3
  688.   Notes for implementation of APAR PN13891
  689.   ────────────────────────────────────────
  690.  
  691.   Two additional source files are shipped with PTF23 they are
  692.  
  693.                      FAAUTPUC.CCP  (Source code)
  694.                      FAAUTWUC.CBL  (Source copybook).
  695.  
  696.   They are example code to allow the conversion of data from a host
  697.   to CICS OS/2 during function shipping. This user code is called
  698.   from the CICS OS/2 system conversion routine FAAUTPSC. The default
  699.   supplied code does not translate data but may be used as a template
  700.   and changed to allow customer specific data conversion.
  701.  
  702.   To invoke the call from FAAUTPSC to this user defined routine requires
  703.   three steps:
  704.  
  705.   The supplied code FAAUTPUC.CCP must be modified as appropriate,
  706.   translated, compiled and linked.
  707.  
  708.   A user conversion table must be created using the supplied routine
  709.   CICSLCTB.CMD.  This may be a SBCS or DBCS conversion table.
  710.   Examples of this are the host DFHCCNV conversion macros.
  711.  
  712.   An appropriate SIT entry must be created to point to this
  713.   conversion table with the 'User Conversion Table' entry.  This
  714.   field should be a fully qualified file path and file name.
  715.  
  716.   For more information please see the System and Application Guide
  717.   Chapter 20 'Communications: data conversion'.
  718.  
  719.  
  720.  
  721.     **************************************************************
  722.     **************************************************************
  723.     ***                                                        ***
  724.     ***                   End of PTF 23 updates.               ***
  725.     ***             Updates for previous PTFs follow.          ***
  726.     ***                                                        ***
  727.     **************************************************************
  728.     **************************************************************
  729.  
  730.                                                              i
  731.                                                 README.TXT FOR
  732.                               CICS OS/2 1.2.0 SERVICE LEVEL 22
  733.  
  734.                                                1 January  1993
  735.  
  736.  
  737.   TABLE OF CONTENTS
  738.   ─────────────────
  739.  
  740.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  741.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  742.     Hints and other information.   . . . . . . . . . . . . . 1
  743.      Changes due to fix for APAR PN21507 . . . . . . . . . . 1
  744.  
  745.  
  746.                                                              1
  747.   INTRODUCTION
  748.   ────────────
  749.  
  750.   CURRENT LEVEL
  751.   ─────────────
  752.  
  753.   The current level of CICS OS/2 is 1.2.0. Service Level 22.
  754.  
  755.   HINTS AND OTHER INFORMATION.
  756.   ────────────────────────────
  757.                                                              2
  758.  
  759.   Changes due to fix for APAR PN21507
  760.   ───────────────────────────────────
  761.   This APAR was created to allow NetBios peer to peer communication
  762.   in an OS/2 2.0 environment. A number of new and changed tracepoints
  763.   have been included. A full list of the NetBios tracepoints follows.
  764.  
  765.  
  766.  
  767.   ┌─────────┬──────────────────────┬───────────────────────────────────┐
  768.   │ ID = 80 │ Issued by FAANBSIN   │ NetBios Listener                  │
  769.   ├─────────┼──────────────────────┼─────────────────┬─────────────────┤
  770.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  771.   │ POINT   │                      │                 │                 │
  772.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  773.   │ MN M01  │NetBIOS Listener Entry│ Mode            │ Adapter         │
  774.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  775.   │ MV M02  │Initialization        │                 │                 │
  776.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  777.   │ MV M03  │FAANBSPH Listener     │ Adapter         │ Adapter         │
  778.   │         │Starting              │                 │ direction       │
  779.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  780.   │ MV M04  │Adapter Thread Started│ OS/2 RC         │                 │
  781.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  782.   │ MV M05  │Adapter Thread Started│ OS/2 RC         │                 │
  783.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  784.   │ MO M06  │Failed to start       │ Adapter         │ OS/2 RC         │
  785.   │         │Adapter Thread        │                 │                 │
  786.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  787.   │ MV M07  │Finished Adapter      │ OS/2 RC         │ Living Adapters │
  788.   │         │Initialization        │                 │                 │
  789.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  790.   │ MV M08  │Service Thread        │ OS/2 RC         │                 │
  791.   │         │Notification          │                 │                 │
  792.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  793.   │ MV M09  │Finished              │                 │                 │
  794.   │         │Initialization        │                 │                 │
  795.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  796.   │ MV M10  │Listener Active       │                 │                 │
  797.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  798.   │ MV M11  │Failed to start       │                 │                 │
  799.   │         │Listeners             │                 │                 │
  800.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  801.   │ MV M12  │Tidy up Adapter       │                 │                 │
  802.   │         │Threads               │                 │                 │
  803.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  804.   │ MV M13  │Killing Adapter       │                 │                 │
  805.   │         │Thread                │                 │                 │
  806.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  807.   │ MV M14  │Adapter Thread Killed │                 │                 │
  808.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  809.   │ MV M15  │Adapter Threads       │                 │                 │
  810.   │         │Terminated            │                 │                 │
  811.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  812.   │ MV M16  │Stopping Adapter      │ Adapter         │                 │
  813.   │         │Thread                │                 │                 │
  814.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  815.   │ MV M17  │Adapter Thread Stopped│ OS/2 RC         │                 │
  816.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  817.   │ MV M18  │Stopping Service      │                 │                 │
  818.   │         │Thread                │                 │                 │
  819.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  820.   │ MV M19  │Service Thread Stopped│                 │                 │
  821.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  822.   │ MX M20  │NetBIOS Listener Exit │ Return Code     │ Adapter         │
  823.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  824.   │ SN M21  │Create Thread         │                 │                 │
  825.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  826.   │ MV M22  │Thread Creation       │ OS/2 RC         │                 │
  827.   │         │Completed             │                 │                 │
  828.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  829.                                                              3
  830.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  831.   │ MO M23  │Semaphore Wait Failed │ OS/2 RC         │                 │
  832.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  833.   │ MO M24  │Thread Creation Failed│ OS/2 RC         │                 │
  834.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  835.   │ MO M25  │Thread Allocation     │ OS/2 RC         │                 │
  836.   │         │Failed                │                 │                 │
  837.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  838.   │ MO M26  │Failed to set         │ OS/2 RC         │                 │
  839.   │         │thread Semaphore      │                 │                 │
  840.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  841.   │ MV M27  │Thread Creation       │ OS/2 RC         │                 │
  842.   │         │Completed             │                 │                 │
  843.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  844.   │ SX M28  │Exit from Create      │ Return Code     │                 │
  845.   │         │Thread                │                 │                 │
  846.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  847.   │ SN M29  │Adapter Thread        │ Adapter         │                 │
  848.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  849.   │ MV M30  │Adapter Thread        │ OS/2 RC         │                 │
  850.   │         │DosCreateSem          │                 │                 │
  851.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  852.   │ MV M31  │Adapter Reset Result  │ OS/2 RC         │                 │
  853.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  854.   │ MV M32  │Limited Resources     │ Connections     │ Network Request │
  855.   │         │Being Used            │                 │ Blocks          │
  856.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  857.   │ MV M33  │NetBIOS Status Result │ NetBIOS RC      │                 │
  858.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  859.   │ MV M34  │NetBIOS Name Added    │ NetBIOS RC      │                 │
  860.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  861.   │ MV M35  │Adapter Listen Primed │ NetBIOS RC      │                 │
  862.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  863.   │ MV M36  │Adapter Thread Ready  │                 │                 │
  864.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  865.   │ MV M37  │Broadcast Timer       │ OS/2 RC         │ Delay Time      │
  866.   │         │Activated             │                 │                 │
  867.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  868.   │ MV M38  │Adapter Thread        │ Index           │                 │
  869.   │         │DosMuxSemWait         │                 │                 │
  870.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  871.   │ MV M39  │Cancel Outstanding    │ NRB Index       │                 │
  872.   │         │Commands              │                 │                 │
  873.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  874.   │ MV M40  │Adapter Reset         │ NetBIOS RC      │                 │
  875.   │         │Completed             │                 │                 │
  876.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  877.   │ MV M41  │NetBIOS Add Name      │ NetBIOS RC      │                 │
  878.   │         │Completed             │                 │                 │
  879.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  880.   │ MV M42  │Adapter Listen        │ NetBIOS RC      │                 │
  881.   │         │Reprimed              │                 │                 │
  882.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  883.   │ MV M43  │Adapter Thread        │                 │                 │
  884.   │         │Finishing             │                 │                 │
  885.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  886.   │ MV M44  │Adapter Thread Stopped│                 │                 │
  887.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  888.   │ SX M45  │Adapter Thread Finish │ Adapter         │                 │
  889.   │         │Notified              │                 │                 │
  890.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  891.   │ SN M46  │Service Thread Entry  │                 │                 │
  892.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  893.   │ MV M47  │DosCreateQueue in     │ OS/2 RC         │                 │
  894.   │         │Service Thread        │                 │                 │
  895.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  896.   │ MV M48  │DosCreateSem in       │ OS/2 RC         │                 │
  897.   │         │Service Thread        │                 │                 │
  898.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  899.   │ MV M49  │Service State Started │                 │                 │
  900.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  901.                                                              4
  902.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  903.   │ MV M50  │Process Queue Elements│                 │                 │
  904.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  905.   │ MV M51  │DosReadQueue in       │ OS/2 RC         │                 │
  906.   │         │Service Thread        │                 │                 │
  907.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  908.   │ MV M52  │Processing Queue      │ Queue Element   │ Queue Element   │
  909.   │         │Element               │ Address         │ Action          │
  910.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  911.   │ MV M53  │Unimplemented Queue   │                 │ Queue Element   │
  912.   │         │Element Type          │                 │ Action          │
  913.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  914.   │ MV M54  │Queue Element         │ Return Code     │                 │
  915.   │         │Processed             │                 │                 │
  916.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  917.   │ MV M55  │Service Thread        │                 │                 │
  918.   │         │Finishing             │                 │                 │
  919.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  920.   │ MV M56  │Service Thread Stopped│                 │                 │
  921.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  922.   │ SX M57  │Service Thread        │ Return Code     │                 │
  923.   │         │Completion            │                 │                 │
  924.   │         │Notification          │                 │                 │
  925.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  926.   │ SN M58  │Reset Adapter         │                 │                 │
  927.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  928.   │ MV M59  │Reset Parameters      │ Adapter         │ Reset type      │
  929.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  930.   │ MV M60  │NetBIOS Reset Result  │ NetBIOS RC      │ Reset Type      │
  931.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  932.   │ MO M61  │Failed NetBIOS Reset  │ NetBIOS RC      │                 │
  933.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  934.   │ SX M62  │Completed NetBIOS     │ NetBIOS RC      │                 │
  935.   │         │Reset                 │                 │                 │
  936.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  937.   │ SN M63  │AddNetBIOSName Entry  │                 │                 │
  938.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  939.   │ SX M64  │Exit from AddNetBIOS  │ NetBIOS RC      │                 │
  940.   │         │Name                  │                 │                 │
  941.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  942.   │ SN M65  │PrimeAdapterListen    │ Adapter Detail  │                 │
  943.   │         │Entry                 │ Pointer         │                 │
  944.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  945.   │ SX M66  │PrimeAdapterListen    │ Return Code     │                 │
  946.   │         │Exit                  │                 │                 │
  947.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  948.   │ SN M67  │Initialise Control    │                 │                 │
  949.   │         │Entries               │                 │                 │
  950.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  951.   │ MV M68  │Local TCS Entry       │ System          │                 │
  952.   │         │Details - 1           │ Identification  │                 │
  953.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  954.   │ MV M69  │Local TCS Entry       │ Applid          │ Applid(cont.)   │
  955.   │         │Details - 2           │                 │                 │
  956.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  957.   │ MV M70  │Local TCS Entry       │ Buffer Size     │ Sessions        │
  958.   │         │Details - 3           │                 │                 │
  959.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  960.   │ MV M71  │Local TCS Entry       │ TctPrty         │ Attach Security │
  961.   │         │Details - 4           │                 │                 │
  962.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  963.   │ SX M72  │Control Initialization│                 │                 │
  964.   │         │Completed             │                 │                 │
  965.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  966.   │ SN M73  │Obtain NetBIOS Adapter│                 │                 │
  967.   │         │UAA                   │                 │                 │
  968.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  969.   │ MO M74  │Failed to Obtain      │ NetBIOS RC      │                 │
  970.   │         │Status                │                 │                 │
  971.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  972.                                                              5
  973.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  974.   │ SX M75  │Obtained Adapter      │ NetBIOS RC      │                 │
  975.   │         │Address               │                 │                 │
  976.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  977.   │ SN M76  │Initialise Network    │ Available NRBs  │                 │
  978.   │         │Request Blocks        │                 │                 │
  979.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  980.   │ SX M77  │NRB Initialization    │                 │                 │
  981.   │         │Completed             │                 │                 │
  982.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  983.   │ SN M78  │Issue Broadcast       │                 │                 │
  984.   │         │Notice to Clients     │                 │                 │
  985.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  986.   │ MV M79  │Broadcast PDU         │ Broadcast NCB   │                 │
  987.   │         │Constructed           │ Pointer         │                 │
  988.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  989.   │ MV M80  │Broadcast Datagram    │ NetBIOS RC      │                 │
  990.   │         │Result                │                 │                 │
  991.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  992.   │ MO M81  │Failed to Broadcast   │ NetBIOS RC      │                 │
  993.   │         │Datagram              │                 │                 │
  994.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  995.   │ SX M82  │Datagram Broadcast    │ NetBIOS RC      │                 │
  996.   │         │Completed             │                 │                 │
  997.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  998.   │ SN M83  │Obtain Inbound        │                 │                 │
  999.   │         │Connection            │                 │                 │
  1000.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1001.   │ MV M84  │Free Connection is    │                 │                 │
  1002.   │         │available             │                 │                 │
  1003.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1004.   │ MV M85  │Requeue as Instantiate│                 │                 │
  1005.   │         │Inbound               │                 │                 │
  1006.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1007.   │ MV M86  │Unable to accept,     │                 │                 │
  1008.   │         │Just Hanging Up       │                 │                 │
  1009.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1010.   │ SX M87  │Exit from Inbound     │                 │                 │
  1011.   │         │Connection            │                 │                 │
  1012.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1013.   │ SN M88  │Instantiate Inbound   │                 │                 │
  1014.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1015.   │ SX M89  │Inbound Instantiate   │                 │                 │
  1016.   │         │Connection            │                 │                 │
  1017.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1018.   │ SN M90  │Allocate Receive Pool │                 │                 │
  1019.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1020.   │ SX M91  │Receive Pool Allocated│ Return Code     │                 │
  1021.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1022.   │ SN M92  │Prime Receive Any     │                 │                 │
  1023.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1024.   │ SX M93  │Exit from Prime       │ NetBIOS RC      │                 │
  1025.   │         │Receive Any           │                 │                 │
  1026.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1027.   │ SN M94  │Reprime Receive Any   │ Network Control │                 │
  1028.   │         │                      │ Block Pointer   │                 │
  1029.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1030.   │ MO M95  │Failed to Reprime     │ NetBIOS RC      │                 │
  1031.   │         │Receive Any           │                 │                 │
  1032.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1033.   │ SX M96  │Exit from Reprime     │ NetBIOS RC      │                 │
  1034.   │         │Receive Any           │                 │                 │
  1035.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1036.   │ SN M97  │Tidy Adapter Resources│                 │                 │
  1037.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1038.   │ MV M98  │Found Active Session  │ Session Control │                 │
  1039.   │         │                      │ Block Pointer   │                 │
  1040.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1041.   │ SX M99  │Adapter Tidy Completed│                 │                 │
  1042.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1043.  
  1044.                                                              6
  1045.  
  1046.   ┌────────────────────────────────────────────────────────────────────┐
  1047.   │ ID = 81   Issued by FAANBSIN   NetBios Listener                    │
  1048.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  1049.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  1050.   │ POINT   │                      │                 │                 │
  1051.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1052.   │ SN M01  │ Entry to Generic     │ Queue Element   │ Queue Element   │
  1053.   │         │ Receive              │ Pointer         │ Action          │
  1054.   │         │                      │                 │ 1 Byte          │
  1055.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1056.   │ MV M02  │Inbound Version 2 PDU │ Protocol Version│ PDU Type        │
  1057.   │         │                      │                 │ 1 Byte          │
  1058.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1059.   │ MV M03  │ Old Protocol PDU     │ Protocol Version│                 │
  1060.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1061.   │ SX M04  │Exit from Generic     │ Protocol Version│                 │
  1062.   │         │Receive               │                 │                 │
  1063.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1064.   │ SN M05  │Entry to Version 2    │ Queue Element   │ Queue Element   │
  1065.   │         │Data Processing       │ Pointer         │ Action          │
  1066.   │         │                      │                 │ 1 Byte          │
  1067.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1068.   │ MV M06  │PDU Details - 1       │ PDU Type        │ Session Id      │
  1069.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1070.   │ MV M07  │PDU Details - 2       │ User Data Length│ User Send Type  │
  1071.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1072.   │ SN M08  │PDU Details - 3       │ User Data Length│ NCB Length      │
  1073.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1074.   │ SN M09  │PDU Details - 4       │ NCB RC          │ Completion RC   │
  1075.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1076.   │ MV M10  │PDU Details - 5       │ Session Pointer │                 │
  1077.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1078.   │ MV M11  │Last Flow seen,       │ Session Pointer │                 │
  1079.   │         │tidy up Session       │                 │                 │
  1080.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1081.   │ MV M12  │Data held in temp.    │ OS/2 RC         │                 │
  1082.   │         │buffer                │                 │                 │
  1083.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1084.   │ MV M13  │Unable to hold data - │ Session Pointer │                 │
  1085.   │         │DosAlloc failed       │                 │                 │
  1086.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1087.   │ MV M14  │PDU Addresses         │ PDU Pointer     │ PDU beyond      │
  1088.   │         │                      │                 │ header Pointer  │
  1089.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1090.   │ MV M15  │Data PDU has no       │ Session ID      │                 │
  1091.   │         │session               │                 │                 │
  1092.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1093.   │ SX M16  │Exit from Version 2   │ Return Code     │                 │
  1094.   │         │Data Processing       │                 │                 │
  1095.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1096.   │ SN M17  │Entry to Version 1    │ Queue Element   │ Connection Ctrl │
  1097.   │         │Data Processing       │ Pointer         │ Block Pointer   │
  1098.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1099.   │ MV M18  │Data has no Session   │                 │                 │
  1100.   │         │                      │                 │                 │
  1101.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1102.   │ MV M19  │Data PDU Details - 1  │ Flag            │ Length          │
  1103.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1104.   │ SN M20  │Data PDU Details - 2  │ PDU Length      │ NCB Length      │
  1105.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1106.   │ SN M21  │Data PDU Details - 3  │ NCB RC          │ NCB Completion  │
  1107.   │         │                      │                 │ RC              │
  1108.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1109.   │ MV M22  │Data PDU Details - 4  │ Session Pointer │                 │
  1110.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1111.   │ MV M23  │Session has completed,│ Session Pointer │                 │
  1112.   │         │Tidy up               │                 │                 │
  1113.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1114.   │ MV M24  │DosAllocSeg for       │ OS/2 RC         │                 │
  1115.   │         │temporary buffer      │                 │                 │
  1116.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1117.                                                              7
  1118.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1119.   │ MV M25  │Unable to obtain      │ Session Pointer │                 │
  1120.   │         │temporary             │                 │                 │
  1121.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1122.   │ SX M26  │Exit from Version 1   │ Return Code     │                 │
  1123.   │         │Data Processing       │                 │                 │
  1124.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1125.   │ SN M27  │Obtain Outbound       │ Queue Element   │                 │
  1126.   │         │Connection Entry      │ Pointer         │                 │
  1127.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1128.   │ MV M28  │Unable to bind to     │                 │                 │
  1129.   │         │System Context Block  │                 │                 │
  1130.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1131.   │ MV M29  │Unable to find free   │                 │                 │
  1132.   │         │System or Connection  │                 │                 │
  1133.   │         │Context Block.        │                 │                 │
  1134.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1135.   │ MV M30  │System Context Block  │ System Context  │                 │
  1136.   │         │allocated             │ Block Pointer   │                 │
  1137.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1138.   │ MV M31  │System Call is Busy   │ System Context  │                 │
  1139.   │         │                      │ Block Pointer   │                 │
  1140.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1141.   │ MV M32  │System and Connection │ System Context  │ Connection      │
  1142.   │         │Context Blocks        │ Block Pointer   │ Context         │
  1143.   │         │Allocated             │                 │ Block Pointer   │
  1144.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1145.   │ MV M33  │Queue Next Stage for  │ Queue Element   │ Queue Element   │
  1146.   │         │Connection            │ Pointer         │ Action          │
  1147.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1148.   │ SX M34  │Obtain Outbound       │                 │                 │
  1149.   │         │Connection            │                 │                 │
  1150.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1151.   │ SN M35  │Discard Connection    │ Queue Element   │                 │
  1152.   │         │                      │ Pointer         │                 │
  1153.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1154.   │ MV M36  │Found System Entry    │ System Context  │ First Connection│
  1155.   │         │                      │ Block Pointer   │ Pointer         │
  1156.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1157.   │ MV M37  │System context        │ Queue Element RC│                 │
  1158.   │         │deallocated           │                 │                 │
  1159.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1160.   │ SX M38  │Discard Connection    │                 │                 │
  1161.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1162.   │ SN M39  │Obtain Network        │ Queue Element   │ Adapter         │
  1163.   │         │Request Block         │ Pointer         │                 │
  1164.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1165.   │ MV M40  │Chain request due to  │ Queue Element   │ Queue Element   │
  1166.   │         │busy condition        │ Pointer         │ Action          │
  1167.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1168.   │ MV M41  │Requeue Queue Element │ Queue Element   │ Queue Element   │
  1169.   │         │                      │ Pointer         │ Action          │
  1170.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1171.   │ SX M42  │Obtain Network        │                 │                 │
  1172.   │         │Request Block         │                 │                 │
  1173.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1174.   │ SN M43  │Issue Call            │ Queue Element   │ Adapter         │
  1175.   │         │                      │ Pointer         │                 │
  1176.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1177.   │ MV M44  │Calling Parameters - 1│ Callname        │                 │
  1178.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1179.   │ MV M45  │Calling Parameters - 2│ Callname        │                 │
  1180.   │         │                      │ (continued)     │                 │
  1181.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1182.   │ MV M46  │NetBIOS Call Result   │ NetBIOS RC      │                 │
  1183.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1184.   │ MO M47  │Unable to queue       │ NetBIOS RC      │                 │
  1185.   │         │NetBIOS Call          │                 │                 │
  1186.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1187.   │ SX M48  │Issue Call            │                 │                 │
  1188.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1189.                                                              8
  1190.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1191.   │ SN M49  │Call Result           │ Queue Element   │                 │
  1192.   │         │                      │ Pointer         │                 │
  1193.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1194.   │ MV M50  │Command Completion    │ Queue Element   │                 │
  1195.   │         │Status Checking       │ Pointer         │                 │
  1196.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1197.   │ MV M51  │NetBIOS Call Details  │ Adapter         │ Logical Session │
  1198.   │         │                      │                 │ Number          │
  1199.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1200.   │ MV M52  │Remote Applid from    │ Applid          │                 │
  1201.   │         │Version 1 PDU         │                 │                 │
  1202.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1203.   │ MV M53  │Local System          │ System Id       │                 │
  1204.   │         │Details - 1           │                 │                 │
  1205.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1206.   │ MV M54  │Local System          │ Applid          │ Applid(cont.)   │
  1207.   │         │Details - 2           │                 │                 │
  1208.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1209.   │ MV M55  │Remote Applid from    │ Applid          │ Applid(cont.)   │
  1210.   │         │Version 2 PDU         │                 │                 │
  1211.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1212.   │ MV M56  │NetBIOS Send Result   │ NetBIOS RC      │                 │
  1213.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1214.   │ MV M57  │Call Failure          │ NetBIOS RC      │ NetBIOS NCB     │
  1215.   │         │                      │                 │ Pointer         │
  1216.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1217.   │ SX M58  │Call Result           │ Queue Element   │                 │
  1218.   │         │                      │ Pointer         │                 │
  1219.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1220.   │ SN M59  │Reject Outbound       │ Queue Element   │                 │
  1221.   │         │                      │ Pointer         │                 │
  1222.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1223.   │ SX M60  │Reject Outbound       │ Queue Element   │                 │
  1224.   │         │                      │ Pointer         │                 │
  1225.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1226.   │ SN M61  │Adapter Died          │ Queue Element   │                 │
  1227.   │         │                      │ Pointer         │                 │
  1228.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1229.   │ SX M62  │Adapter Died          │ Queue Element   │                 │
  1230.   │         │                      │ Pointer         │                 │
  1231.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1232.   │ SN M63  │Connect Termination   │ Queue Element   │                 │
  1233.   │         │                      │ Pointer         │                 │
  1234.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1235.   │ SX M64  │Connect Termination   │ Queue Element   │                 │
  1236.   │         │                      │ Pointer         │                 │
  1237.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1238.   │ SN M65  │Version 1 Connect     │ Queue Element   │ Connection      │
  1239.   │         │                      │ Pointer         │ Context Block   │
  1240.   │         │                      │                 │ Pointer         │
  1241.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1242.   │ MV M66  │Version 1 Connect     │ Applid          │ Applid(cont.)   │
  1243.   │         │Details - 1           │                 │                 │
  1244.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1245.   │ MV M67  │Version 1 Connect     │ Transid         │                 │
  1246.   │         │Details - 2           │                 │                 │
  1247.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1248.   │ MV M68  │Obtained Session      │ Session Context │                 │
  1249.   │         │Context Block         │ Block Pointer   │                 │
  1250.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1251.   │ MV M69  │Failed to queue       │                 │                 │
  1252.   │         │ICE Entry             │                 │                 │
  1253.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1254.   │ MV M70  │NetBIOS Send for      │ NetBIOS RC      │ NCB Pointer     │
  1255.   │         │Connect Response      │                 │                 │
  1256.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1257.   │ SX M71  │Version 1 Connect     │                 │                 │
  1258.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1259.   │ SN M72  │Add ICE Entry         │ Session/System  │ Session/System  │
  1260.   │         │                      │ Identification  │ Index           │
  1261.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1262.                                                               9
  1263.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1264.   │ MV M73  │ICE Entry Start Time  │ Time            │ Time(cont.)     │
  1265.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1266.   │ MV M74  │ICE Table is very busy│ Start Next      │ Start Max       │
  1267.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1268.   │ MV M75  │ICE Entry Obtained    │ Start Next      │ ICE Entry       │
  1269.   │         │                      │                 │ Pointer         │
  1270.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1271.   │ MV M76  │ICE Entry Shuffle     │ Source Pointer  │ Destination     │
  1272.   │         │                      │                 │ Pointer         │
  1273.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1274.   │ MV M77  │ICE Entry Insertion   │ OS/2 RC         │                 │
  1275.   │         │Complete              │                 │                 │
  1276.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1277.   │ SX M78  │Insert ICE Entry      │ Return Code     │                 │
  1278.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1279.   │ SN M79  │Discard Connection    │ Connection      │                 │
  1280.   │         │                      │ Context         │                 │
  1281.   │         │                      │ Block Pointer   │                 │
  1282.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1283.   │ MV M80  │Free queued elements  │ Connection      │ Session Context │
  1284.   │         │for session           │ Context         │ Block Pointer   │
  1285.   │         │                      │ Block Pointer   │                 │
  1286.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1287.   │ MV M81  │Free QElement Details │ Queue Element   │ Queue Element   │
  1288.   │         │                      │ Pointer         │ Action          │
  1289.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1290.   │ MV M82  │Drop connection       │ Context Control │ System Control  │
  1291.   │         │association           │ Block Pointer   │ Block Pointer   │
  1292.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1293.   │ MV M83  │Remove system and     │ System Control  │ First Connection│
  1294.   │         │connection association│ Block Pointer   │ Control         │
  1295.   │         │                      │                 │ Block Pointer   │
  1296.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1297.   │ MV M84  │Match at first        │ Next Connection │ First Connection│
  1298.   │         │connection            │ Control         │ Control         │
  1299.   │         │                      │ Block Pointer   │ Block Pointer   │
  1300.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1301.   │ MV M85  │Searching down        │ Next Connection │ First Connection│
  1302.   │         │connection chain - 1  │ Control         │ Control         │
  1303.   │         │                      │ Block Pointer   │ Block Pointer   │
  1304.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1305.   │ MV M86  │Searching down        │ Next Connection │ Connection      │
  1306.   │         │connection chain - 2  │ Control         │ Control         │
  1307.   │         │                      │ Block Pointer   │ Block Pointer   │
  1308.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1309.   │ MV M87  │Searching down        │ Next Connection │ Connection      │
  1310.   │         │connection chain - 3  │ Control         │ Control         │
  1311.   │         │                      │ Block Pointer   │ Block Pointer   │
  1312.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1313.   │ MV M88  │Now unlinked from     │ System first    │ Local System    │
  1314.   │         │system entry          │ Connection      │ Context         │
  1315.   │         │                      │ Context         │ Block Pointer   │
  1316.   │         │                      │ Block Pointer   │                 │
  1317.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1318.   │ SX M89  │Discard Connection    │                 │                 │
  1319.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1320.   │ SN M90  │Install System        │ Queue Element   │                 │
  1321.   │         │                      │ Pointer         │                 │
  1322.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1323.   │ MV M91  │Install System Result │ Return Code     │ Request Block   │
  1324.   │         │                      │                 │ Pointer         │
  1325.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1326.   │ MV M92  │Reply Ready           │ Return Code     │                 │
  1327.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1328.   │ MV M93  │Buffer Addresses      │ Queue Elements  │                 │
  1329.   │         │                      │ Buffer Pointer  │                 │
  1330.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1331.   │ SX M94  │Install System        │                 │                 │
  1332.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1333.   │ SN M95  │Issue Connect Response│ Queue Element   │                 │
  1334.   │         │                      │ Pointer         │                 │
  1335.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1336.                                                             10
  1337.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1338.   │ MV M96  │Send Connect Response │ Queue Element   │                 │
  1339.   │         │                      │ Action          │                 │
  1340.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1341.   │ SX M97  │Result from NetBIOS   │ NetBIOS RC      │                 │
  1342.   │         │Send                  │                 │                 │
  1343.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1344.   │ SN M98  │Sent Connect Response │ Queue Element   │                 │
  1345.   │         │                      │ Pointer         │                 │
  1346.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1347.   │ SX M99  │Sent Connect Response │                 │                 │
  1348.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1349.                                                             11
  1350.   ┌────────────────────────────────────────────────────────────────────┐
  1351.   │ ID = 82   Issued by FAANBSIN   NetBios Listener                    │
  1352.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  1353.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  1354.   │ POINT   │                      │                 │                 │
  1355.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1356.   │ SN M01  │Sent Version 1        │ Queue Element   │ Queue Element   │
  1357.   │         │Connect Response      │ Pointer         │ RC              │
  1358.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1359.   │ SX M02  │Sent Version 1        │                 │                 │
  1360.   │         │Connect Response      │                 │                 │
  1361.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1362.   │ SN M03  │Free Network Request  │ Queue Element   │                 │
  1363.   │         │Block                 │ Pointer         │                 │
  1364.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1365.   │ SX M04  │Free Network Request  │                 │                 │
  1366.   │         │Block                 │                 │                 │
  1367.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1368.   │ SN M05  │Locate System         │ Applid Pointer  │                 │
  1369.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1370.   │ SX M06  │Locate System         │ System Context  │                 │
  1371.   │         │                      │ Block Pointer   │                 │
  1372.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1373.   │ SN M07  │Insert System         │                 │                 │
  1374.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1375.   │ SN M08  │Insert System         │                 │                 │
  1376.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1377.   │ SN M09  │Sent Connect Request  │ Queue Element   │ Queue Element   │
  1378.   │         │                      │ Pointer         │ RC              │
  1379.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1380.   │ SN M10  │Sent Connect Request  │                 │                 │
  1381.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1382.   │ SN M11  │Process Version 2     │ Queue Element   │ Connection      │
  1383.   │         │Connect               │ Pointer         │ Context Block   │
  1384.   │         │                      │                 │ Pointer         │
  1385.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1386.   │ MV M12  │Connect Details - 1   │ Local System    │ Originator Type │
  1387.   │         │                      │ Details Pointer │                 │
  1388.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1389.   │ MV M13  │Connect Details - 2   │ Sessions In     │ Sessions Out    │
  1390.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1391.   │ MO M14  │Failed to queue new   │                 │                 │
  1392.   │         │ICE Entry             │                 │                 │
  1393.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1394.   │ SX M15  │Process Version 2     │                 │                 │
  1395.   │         │Connect               │                 │                 │
  1396.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1397.   │ SN M16  │Process Version 2     │ Queue Element   │ Connection      │
  1398.   │         │Connect Response      │ Pointer         │ Context Block   │
  1399.   │         │                      │                 │ Pointer         │
  1400.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1401.   │ SX M17  │Process Version 2     │ Return Code     │                 │
  1402.   │         │Connect Response      │                 │                 │
  1403.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1404.   │ SN M18  │Process Version 1     │ Queue Element   │ Connection      │
  1405.   │         │Connect               │ Pointer         │ Context Block   │
  1406.   │         │                      │                 │ Pointer         │
  1407.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1408.   │ SX M19  │Process Version 1     │ Return Code     │                 │
  1409.   │         │Connect               │                 │                 │
  1410.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1411.   │ SN M20  │Initiate Out Session  │ Queue Element   │                 │
  1412.   │         │                      │ Pointer         │                 │
  1413.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1414.   │ MV M21  │Located System and    │ System Context  │ Connection      │
  1415.   │         │Connection Blocks     │ Block Pointer   │ Context Block   │
  1416.   │         │                      │                 │ Pointer         │
  1417.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1418.   │ MV M22  │Allocated Session     │ Session Context │ Already Active  │
  1419.   │         │Blocks                │ Block Pointer   │ Indication      │
  1420.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1421.                                                             12
  1422.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1423.   │ MV M23  │Session Details       │ Index           │ Integrity       │
  1424.   │         │                      │                 │ Check           │
  1425.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1426.   │ MV M24  │Protocol Session      │ Session Id      │                 │
  1427.   │         │Identification        │                 │                 │
  1428.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1429.   │ SX M25  │Initiate Out Session  │                 │                 │
  1430.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1431.   │ SN M26  │Instantiate Version 1 │ Queue Element   │                 │
  1432.   │         │Protocol              │ Pointer         │                 │
  1433.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1434.   │ MV M27  │System Search         │ System Context  │ Connection      │
  1435.   │         │Completed             │ Block Pointer   │ Context Block   │
  1436.   │         │                      │                 │ Pointer         │
  1437.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1438.   │ MV M28  │Session Details       │ Index           │ Integrity Check │
  1439.   │         │Established           │                 │                 │
  1440.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1441.   │ SX M29  │Instantiate Version 1 │                 │                 │
  1442.   │         │Protocol              │                 │                 │
  1443.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1444.   │ SN M30  │Issue Attach          │ Queue Element   │ Queue Element   │
  1445.   │         │                      │ Pointer         │ Action          │
  1446.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1447.   │ MV M31  │NetBIOS Send Attach   │ NetBIOS RC      │                 │
  1448.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1449.   │ SX M32  │Issue Attach          │                 │                 │
  1450.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1451.   │ SN M33  │Sent Attach           │ Queue Element   │ Queue Element   │
  1452.   │         │                      │ Pointer         │ RC              │
  1453.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1454.   │ SX M34  │Sent Attach           │                 │                 │
  1455.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1456.   │ SN M35  │Issue Version 2 Abend │                 │                 │
  1457.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1458.   │ MV M36  │NetBIOS Send Abend    │ NetBIOS RC      │                 │
  1459.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1460.   │ SN M37  │Issue Version 2 Abend │                 │                 │
  1461.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1462.   │ SN M38  │Process Version 2     │ Queue Element   │ Connection      │
  1463.   │         │Attach                │ Pointer         │ Control Block   │
  1464.   │         │                      │                 │ Pointer         │
  1465.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1466.   │ MV M39  │Attach Details - 1    │ Transaction Id  │ Session Id      │
  1467.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1468.   │ MV M40  │Attach Details - 2    │ User Data Length│                 │
  1469.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1470.   │ MV M41  │Obtained Buffer from  │ OS/2 RC         │                 │
  1471.   │         │DosAllocSeg           │                 │                 │
  1472.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1473.   │ MV M42  │Obtained Session      │ Session Context │                 │
  1474.   │         │Context Block         │ Block Pointer   │                 │
  1475.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1476.   │ MV M43  │Linked Session        │ Session Context │                 │
  1477.   │         │Context Block         │ Block Pointer   │                 │
  1478.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1479.   │ MV M44  │Transfer of User Data │ PDU             │ PDU Pointer     │
  1480.   │         │                      │ Pointer         │ beyond header   │
  1481.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1482.   │ SX M45  │Version 2 Protocol    │ Return Code     │                 │
  1483.   │         │Attach                │                 │                 │
  1484.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1485.   │ SN M46  │Identify Session      │ Queue Element   │ Queue Element   │
  1486.   │         │                      │ Pointer         │ Action          │
  1487.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1488.   │ MV M47  │Found System Entry    │ System Context  │                 │
  1489.   │         │                      │ Block Pointer   │                 │
  1490.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1491.   │ MV M48  │Assume System Details │ Applid          │ Applid(cont.)   │
  1492.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1493.                                                             13
  1494.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1495.   │ SX M49  │Identify Session      │                 │                 │
  1496.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1497.   │ SN M50  │Discard Session       │ Queue Element   │ Queue Element   │
  1498.   │         │                      │ Pointer         │ Action          │
  1499.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1500.   │ SX M51  │Discard Session       │                 │                 │
  1501.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1502.   │ SN M52  │Receive Data          │ Queue Element   │ Queue Element   │
  1503.   │         │                      │ Pointer         │ Action          │
  1504.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1505.   │ MV M53  │Queue Element Details │ Index           │ Integrity Check │
  1506.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1507.   │ MV M54  │Queue Element in chain│ Queue Element   │                 │
  1508.   │         │                      │ Pointer         │                 │
  1509.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1510.   │ SX M55  │Receive Data          │                 │                 │
  1511.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1512.   │ SN M56  │Identify System       │ Queue Element   │ Queue Element   │
  1513.   │         │                      │ Pointer         │ Action          │
  1514.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1515.   │ SX M57  │Identify System       │                 │                 │
  1516.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1517.   │ SN M58  │Release System        │ Queue Element   │ Queue Element   │
  1518.   │         │                      │ Pointer         │ Action          │
  1519.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1520.   │ SX M59  │Release System        │                 │                 │
  1521.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1522.   │ SN M60  │Send Data             │ Queue Element   │ Queue Element   │
  1523.   │         │                      │ Pointer         │ Action          │
  1524.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1525.   │ SX M61  │Send Data             │                 │                 │
  1526.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1527.   │ SN M62  │Send Data             │ Queue Element   │ Queue Element   │
  1528.   │         │                      │ Pointer         │ Action          │
  1529.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1530.   │ SN M63  │Send Data Details     │ User Data Length│ Protocol Version│
  1531.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1532.   │ MV M64  │NetBIOS Send Data     │ NetBIOS RC      │ NCB Pointer     │
  1533.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1534.   │ SX M65  │Send Data             │                 │                 │
  1535.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1536.   │ SN M66  │Sent Version 1        │ Queue Element   │ Queue Element   │
  1537.   │         │Preamble              │ Pointer         │ Action          │
  1538.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1539.   │ SN M67  │ Preamble Details     │ User Data Length│                 │
  1540.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1541.   │ MV M68  │ NetBIOS Send Preamble│ NetBIOS RC      │ NCB Pointer     │
  1542.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1543.   │ SX M69  │ Send Version 1       │                 │                 │
  1544.   │         │ Preamble             │                 │                 │
  1545.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1546.   │ SN M70  │ Sent Version 1 Data  │ Queue Element   │ Queue Element   │
  1547.   │         │                      │ Pointer         │ RC              │
  1548.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1549.   │ SX M71  │ Sent Version 1 Data  │                 │                 │
  1550.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1551.   │ SN M72  │ Sent Version 2 Data  │ Queue Element   │ Queue Element   │
  1552.   │         │                      │ Pointer         │ RC              │
  1553.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1554.   │ SX M73  │ Sent Version 2 Data  │                 │                 │
  1555.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1556.   │ SN M74  │ Discard Session      │ Session Context │                 │
  1557.   │         │                      │ Block Pointer   │                 │
  1558.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1559.   │ MV M75  │ Requeue Active       │ Queue Element   │                 │
  1560.   │         │ Calling Elements     │ Pointer         │                 │
  1561.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1562.   │ SX M76  │ Discard Session      │                 │                 │
  1563.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1564.                                                             14
  1565.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1566.   │ SN M77  │ Process Version 2    │ Queue Element   │ Connection      │
  1567.   │         │ Abend                │ Pointer         │ Control Block   │
  1568.   │         │                      │                 │ Pointer         │
  1569.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1570.   │ MV M78  │ Abend Details        │ PDU Type        │ Session Id      │
  1571.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1572.   │ SX M79  │ Process Version 2    │ Return Code     │                 │
  1573.   │         │ Abend                │                 │                 │
  1574.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1575.   │ SN M80  │ Process Version 2    │ Queue Element   │ Connection      │
  1576.   │         │ Close                │ Pointer         │ Control Block   │
  1577.   │         │                      │                 │ Pointer         │
  1578.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1579.   │ MV M81  │ Close Details        │ PDU Type        │ Reason          │
  1580.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1581.   │ SX M82  │ Process Version 2    │ Return Code     │                 │
  1582.   │         │ Close                │                 │                 │
  1583.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1584.   │ SN M83  │ Output Console       │ Message Number  │                 │
  1585.   │         │ Message              │                 │                 │
  1586.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1587.   │ MV M84  │ Console Buffer       │ OS/2 RC         │                 │
  1588.   │         │ from DosAllocSeg     │                 │                 │
  1589.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1590.   │ SX M85  │ Output Console       │                 │                 │
  1591.   │         │ Message              │                 │                 │
  1592.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1593.  
  1594.                                                             15
  1595.  
  1596.   ┌────────────────────────────────────────────────────────────────────┐
  1597.   │ ID = 83   Issued by FAANBSPH   NetBios Protocol Handler            │
  1598.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  1599.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  1600.   │ POINT   │                      │                 │                 │
  1601.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1602.   │ MN M01  │NetBIOS Protocol      │ FMH Pointer     │ CSA2 Pointer    │
  1603.   │         │Handler               │                 │                 │
  1604.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1605.   │ MV M02  │DosOpenQueue Status   │ OS/2 RC         │                 │
  1606.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1607.   │ MV M03  │DosOpenSem Status     │ OS/2 RC         │                 │
  1608.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1609.   │ MV M04  │Queue Element         │ OS/2 RC         │                 │
  1610.   │         │DosAllocSeg Status    │                 │                 │
  1611.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1612.   │ MV M05  │Queue Element         │ OS/2 RC         │                 │
  1613.   │         │DosGiveSeg Status     │                 │                 │
  1614.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1615.   │ MV M06  │Scratch Buffer        │ OS/2 RC         │                 │
  1616.   │         │DosAllocSeg Status    │                 │                 │
  1617.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1618.   │ MV M07  │Scratch Buffer        │ OS/2 RC         │                 │
  1619.   │         │DosGiveSeg Status     │                 │                 │
  1620.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1621.   │ MV M08  │Allocated Queue       │ Queue Element   │                 │
  1622.   │         │Element               │ Pointer         │                 │
  1623.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1624.   │ MV M09  │Internal Primer Event │ Major Event     │ Minor Event     │
  1625.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1626.   │ MV M10  │Protocol Operation    │ FMH Pointer     │ FMH Operation   │
  1627.   │         │Required              │                 │ 1 Byte          │
  1628.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1629.   │ MX M11  │Protocol Operation    │ Conversation    │ Requested       │
  1630.   │         │Details               │ State  1 Byte   │ Operation 1 Byte│
  1631.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1632.   │ MX M12  │Fixup Status Code     │ Raw Status      │                 │
  1633.   │         │                      │ 2 Bytes         │                 │
  1634.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1635.   │ MX M13  │NetBIOS Protocol      │ Status          │                 │
  1636.   │         │Handler               │ 2 Bytes         │                 │
  1637.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1638.   │ SN M14  │Receive*              │                 │                 │
  1639.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1640.   │ MV M15  │Receive Details       │ FMH Request     │ FMH Send Type   │
  1641.   │         │                      │ Length          │ 1 Byte          │
  1642.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1643.   │ SX M16  │Receive               │ Status          │                 │
  1644.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1645.   │ SN M17  │Send Allocate         │                 │                 │
  1646.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1647.   │ MV M18  │Send Allocate         │ Applid          │ Applid(cont.)   │
  1648.   │         │Details - 1           │                 │                 │
  1649.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1650.   │ MV M19  │Send Allocate         │ Applid(cont.)   │ Applid(cont.)   │
  1651.   │         │Details - 2           │                 │                 │
  1652.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1653.   │ MV M20  │Send Allocate         │ FMH Request     │                 │
  1654.   │         │Details - 3           │ Length          │                 │
  1655.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1656.   │ MV M21  │Allocated Session     │ Index           │ Integrity Check │
  1657.   │         │Details               │                 │                 │
  1658.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1659.                                                             16
  1660.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1661.   │ SX M22  │Send Allocate         │ Status          │                 │
  1662.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1663.   │ SN M23  │Send                  │                 │                 │
  1664.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1665.   │ MV M24  │Send Details          │ FMH Request     │                 │
  1666.   │         │                      │ Length          │                 │
  1667.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1668.   │ SX M25  │Send                  │                 │                 │
  1669.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1670.   │ SN M26  │Send Last             │                 │                 │
  1671.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1672.   │ SX M27  │Send Last             │ Status          │                 │
  1673.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1674.   │ SN M28  │Send Error            │                 │                 │
  1675.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1676.   │ SX M29  │Send Error            │ Status          │                 │
  1677.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1678.   │ SN M30  │Send Abend            │                 │                 │
  1679.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1680.   │ SX M31  │Send Abend            │ Status          │                 │
  1681.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1682.   │ SN M32  │Receive Allocate      │                 │                 │
  1683.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1684.   │ MV M33  │About to identify     │ Index           │ Integrity Check │
  1685.   │         │Session               │                 │                 │
  1686.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1687.   │ SX M34  │Receive Allocate      │ Status          │                 │
  1688.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1689.   │ SN M35  │Install System        │ Queue Element   │ Queue Element   │
  1690.   │         │                      │ Pointer         │ Buffer Pointer  │
  1691.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1692.   │ MV M36  │Remote System         │ Sessions        │ Buffer Size     │
  1693.   │         │Details - 1           │                 │                 │
  1694.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1695.   │ MV M37  │Remote System         │ UAA             │ UAA             │
  1696.   │         │Details - 2           │ (First 4 Bytes) │ (Last 2 Bytes)  │
  1697.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1698.   │ MV M38  │Remote System         │ System Id       │ Originator Type │
  1699.   │         │Details - 3           │                 │ 1 Byte          │
  1700.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1701.   │ MV M39  │Remote System         │ Applid          │ Applid(cont.)   │
  1702.   │         │Details - 4           │                 │                 │
  1703.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1704.   │ MV M40  │Remote System         │ Tct Prty        │ Attach Security │
  1705.   │         │Details - 5           │                 │ 1 Byte          │
  1706.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1707.   │ MV M41  │About to call         │                 │                 │
  1708.   │         │User Exit 21          │                 │                 │
  1709.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1710.   │ MV M42  │Returned from         │                 │                 │
  1711.   │         │User Exit 21          │                 │                 │
  1712.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1713.   │ MV M43  │Result from           │ Queue Element RC│                 │
  1714.   │         │Install Attempt       │                 │                 │
  1715.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1716.   │ SX M44  │Install System        │ Status          │                 │
  1717.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1718.   │ SN M45  │Delete System         │ Queue Element   │ Queue Element   │
  1719.   │         │                      │ Pointer         │ Buffer Pointer  │
  1720.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1721.   │ MV M46  │Release System        │ Sessions        │ Buffer Size     │
  1722.   │         │Details - 1           │                 │                 │
  1723.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1724.   │ MV M47  │Release System        │ UAA             │ UAA             │
  1725.   │         │Details - 2           │ (First 4 Bytes) │ (Last 2 Bytes)  │
  1726.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1727.   │ MV M48  │Release System        │ System Id       │ Originator Type │
  1728.   │         │Details - 3           │                 │ 1 Byte          │
  1729.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1730.   │ MV M49  │Release System        │ Applid          │ Applid(cont.)   │
  1731.   │         │Details - 4           │                 │                 │
  1732.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1733.                                                              17
  1734.   ┌─────────┬──────────────────────┬─────────────────┬─────────────────┐
  1735.   │ MV M50  │Release System        │ Tct Prty        │ Attach Security │
  1736.   │         │Details - 5           │                 │ 1 Byte          │
  1737.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1738.   │ MV M51  │About to call         │                 │                 │
  1739.   │         │User Exit 21          │                 │                 │
  1740.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1741.   │ MV M52  │Returned from         │                 │                 │
  1742.   │         │User Exit 21          │                 │                 │
  1743.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1744.   │ SX M53  │Delete System         │                 │                 │
  1745.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1746.   │ SN M54  │Set Connection        │                 │                 │
  1747.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1748.   │ MV M55  │Set Connection        │ Applid          │ Applid(cont.)   │
  1749.   │         │Details - 1           │                 │                 │
  1750.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1751.   │ MV M56  │Set Connection        │ System Id       │                 │
  1752.   │         │Details - 2           │                 │                 │
  1753.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1754.   │ SX M57  │Set Connection        │ Status          │                 │
  1755.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1756.   │ SN M58  │Release Connection    │                 │                 │
  1757.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1758.   │ MV M59  │Release Connection    │ Applid          │ Applid(cont.)   │
  1759.   │         │Details               │                 │                 │
  1760.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1761.  
  1762.                                                             18
  1763.  
  1764.   ┌────────────────────────────────────────────────────────────────────┐
  1765.   │ ID = 84   Issued by FAANBSAS   NetBios Async Completion Module     │
  1766.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  1767.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  1768.   │ POINT   │                      │                 │                 │
  1769.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1770.   │ MV M01  │ Async Completion     │ Post Type       │ Return Code     │
  1771.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1772.   │ MV M02  │ NCB Details          │ NCB Pointer     │ NetBIOS Command │
  1773.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1774.   │ MV M03  │ NCB Status           │ NCB RC          │ NCB Completion  │
  1775.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1776.   │ MV M04  │Connection Termination│ Queue Element   │ Queue Element   │
  1777.   │         │                      │ Pointer         │ Action          │
  1778.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1779.   │ MV M05  │ Incoming Data        │ Queue Element   │Post Queue Handle│
  1780.   │         │ from Receive Any     │ Pointer         │                 │
  1781.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1782.   │ MV M06  │ Moved onto action    │ OS/2 Return Code│                 │
  1783.   │         │ Queue                │                 │                 │
  1784.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1785.  
  1786.                                                             19
  1787.  
  1788.  
  1789.     **************************************************************
  1790.     **************************************************************
  1791.     ***                                                        ***
  1792.     ***                   End of PTF 22 updates.               ***
  1793.     ***             Updates for previous PTFs follow.          ***
  1794.     ***                                                        ***
  1795.     **************************************************************
  1796.     **************************************************************
  1797.  
  1798.                                                              i
  1799.                                                 README.TXT FOR
  1800.                               CICS OS/2 1.2.0 SERVICE LEVEL 21
  1801.  
  1802.                                               16 November 1992
  1803.  
  1804.  
  1805.   TABLE OF CONTENTS
  1806.   ─────────────────
  1807.  
  1808.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  1809.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  1810.     Hints and other information.   . . . . . . . . . . . . . 1
  1811.      Changes due to fix for APAR PN24821 . . . . . . . . . . 1
  1812.      Changes due to fix for APAR PN29610 . . . . . . . . . . 2
  1813.      Restrictions on use of the /DOS command . . . . . . . . 3
  1814.  
  1815.  
  1816.                                                              1
  1817.   INTRODUCTION
  1818.   ────────────
  1819.  
  1820.   CURRENT LEVEL
  1821.   ─────────────
  1822.  
  1823.   The current level of CICS OS/2 is 1.2.0. Service Level 21.
  1824.  
  1825.   HINTS AND OTHER INFORMATION.
  1826.   ────────────────────────────
  1827.  
  1828.   Changes due to fix for APAR PN24821
  1829.   ───────────────────────────────────
  1830.  
  1831.   APAR PN24821 describes a problem where STARTBR and READNEXT on relative
  1832.   record data sets (RRDS files) return an incorrect record.
  1833.  
  1834.   The fix for PN24821 corrects this problem by changing the internal structure
  1835.   of RRDS files. When CICS OS/2 starts up the control file is scanned to set
  1836.   up, amongst other things, FCT entries. Should an RRDS file be encountered
  1837.   which uses old-style internal structure then a warning message is issued
  1838.   indicating that the file is out of date. To update the RRDS file use the
  1839.   RRDS file converter which is provided as part of PTF21.
  1840.  
  1841.   **WARNING**  Before using the RRDS file converter routine ensure  **WARNING**
  1842.   **WARNING**  that you have made security copies of all of your    **WARNING**
  1843.   **WARNING**  data files. ie. All files with a file type .BTR      **WARNING**
  1844.  
  1845.   The RRDS converter routine can be invoked using the new command file
  1846.   provided, CICSRRDS.CMD for an OS/2 environment or CICSRRDS.BAT for
  1847.   a DOS environment. The routine will scan the CICS OS/2 control file
  1848.   searching for RRDS file descriptions and converting these files.
  1849.  
  1850.   The format of the command for RRDS file conversion is:
  1851.  
  1852.            CICSRRDS  [/B:nnnn]  [/M:nnnn]
  1853.  
  1854.   The converter routine accepts the /B and /M (file control) parameters
  1855.   as used when starting up CICS OS/2. These options should only be used
  1856.   if they are normally used during the startup of CICS OS/2. For more
  1857.   information on these options refer to the CICS OS/2 System and Application
  1858.   Guide Chapter 11.
  1859.  
  1860.                                                              2
  1861.   CHANGES DUE TO FIX FOR APAR PN29610.
  1862.   ────────────────────────────────────
  1863.  
  1864.   This PTF adds double byte character set code page support for OS/2 T
  1865.   (Traditional Chinese) for Taiwan and OS/2 H (Hanguel) for Korea.  The
  1866.   new code pages supported are for OS/2 T:  938, 948; and
  1867.                                for OS/2 H:  934, 944.
  1868.  
  1869.   The CEDA TCT definition transaction has been enhanced to allow selection
  1870.   of the additional code pages when a DBCS terminal is defined.  A Japanese,
  1871.   Taiwanese or Korean terminal is selected using option J, for a DBCS terminal, and the
  1872.   appropriate code page.
  1873.  
  1874.   Existing Japanese users may notice that in some places in the CEDA and help
  1875.   panels the terminal type is now described as 'DBCS' rather than 'Japanese'.
  1876.   The actual definitions for Japanese terminals are unchanged, and will continue
  1877.   to work as before.
  1878.  
  1879.   Transaction routing is supported with these code pages.  Data is converted to
  1880.   EBCDIC for transmission over the link, using for OS/2 T: code page 937; and
  1881.   for OS/2 H: code page 933.
  1882.  
  1883.   Function shipping inbound to CICS OS/2 is also supported for OS/2 T and
  1884.   OS/2 H.  In the CEDA CVT definition panel there are some additional selection
  1885.   for code page pairs.  These selections are:
  1886.                   6:  For the ASCII-EBCDIC code page pair 938,937 (OS/2 T only)
  1887.                   7:  For the ASCII-EBCDIC code page pair 948,937 (OS/2 T only)
  1888.                   8:  For the ASCII-EBCDIC code page pair 934,933 (OS/2 H only)
  1889.                   9:  For the ASCII-EBCDIC code page pair 944,933 (OS/2 H only)
  1890.  
  1891.   Function shipping to Host CICS for code pages 938, 948, 934, 944 can be done
  1892.   using user defined data conversion tables on the host.
  1893.  
  1894.   Additional tracepoints:
  1895.  
  1896.   ┌────────────────────────────────────────────────────────────────────┐
  1897.   │ ID = 62   Issued by FAAO6STR   Inbound transaction routing module. │
  1898.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  1899.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  1900.   │ POINT   │                      │                 │                 │
  1901.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1902.   │ SN T21  │ Enter ASCII-EBCDIC   │ 2Byte Code Page │ 2Byte Length    │
  1903.   │         │       translation.   │       from.     │ 1Byte TCT-FLAG1 │
  1904.   │         │                      │ 2Byte Code Page │ 1Byte = zero    │
  1905.   │         │                      │       to.       │                 │
  1906.   │         │                      │                 │                 │
  1907.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  1908.   │ SX T22  │ Exit ASCII-EBCDIC    │ 2Byte Code Page │ 2Byte Input     │
  1909.   │         │      translation.    │       from.     │       Length.   │
  1910.   │         │                      │ 2Byte Code Page │ 2Byte Output    │
  1911.   │         │                      │       to.       │       Length.   │
  1912.   │         │                      │                 │                 │
  1913.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  1914.  
  1915.                                                              3
  1916.   RESTRICTIONS ON USE OF THE /DOS COMMAND
  1917.   ───────────────────────────────────────
  1918.  
  1919.   The use of the /DOS transaction, which is used from CICS OS/2 to start
  1920.   a windowed OS/2 command session, is restricted to one active window
  1921.   at any one time. That is, if a user has two CICS PM sessions only one can
  1922.   successfully invoke the /DOS transaction at one time.
  1923.  
  1924.   In addition if the user has a full screen terminal defined use of the
  1925.   /DOS command is restricted to that full screen terminal.
  1926.  
  1927.   Also, if the /DOS transaction is invoked and an OS/2 command session is
  1928.   active CICS OS/2 will wait for that session to terminate before shutting
  1929.   down when the CQIT command is used.
  1930.  
  1931.                                                              4
  1932.     **************************************************************
  1933.     **************************************************************
  1934.     ***                                                        ***
  1935.     ***                   End of PTF 21 updates.               ***
  1936.     ***             Updates for previous PTFs follow.          ***
  1937.     ***                                                        ***
  1938.     **************************************************************
  1939.     **************************************************************
  1940.  
  1941.  
  1942.                                                              i
  1943.                                                 README.TXT FOR
  1944.                               CICS OS/2 1.2.0 SERVICE LEVEL 20
  1945.  
  1946.                                              19 October   1992
  1947.  
  1948.  
  1949.   TABLE OF CONTENTS
  1950.   ─────────────────
  1951.  
  1952.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  1953.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  1954.     Hints and other information.   . . . . . . . . . . . . . 1
  1955.      Changes due to fix for APAR PN28669 . . . . . . . . . . 1
  1956.  
  1957.  
  1958.                                                              1
  1959.   INTRODUCTION
  1960.   ────────────
  1961.  
  1962.   CURRENT LEVEL
  1963.   ─────────────
  1964.  
  1965.   The current level of CICS OS/2 is 1.2.0. Service Level 20.
  1966.  
  1967.   HINTS AND OTHER INFORMATION.
  1968.   ────────────────────────────
  1969.  
  1970.   Changes due to fix for APAR PN28669
  1971.   ───────────────────────────────────
  1972.   Users experiencing the problem reported in APAR PN28669 should re-compile
  1973.   and re-link any affected 'C' applications.
  1974.  
  1975.  
  1976.                                                              2
  1977.     **************************************************************
  1978.     **************************************************************
  1979.     ***                                                        ***
  1980.     ***                   End of PTF 20 updates.               ***
  1981.     ***             Updates for previous PTFs follow.          ***
  1982.     ***                                                        ***
  1983.     **************************************************************
  1984.     **************************************************************
  1985.  
  1986.  
  1987.                                                              i
  1988.                                                 README.TXT FOR
  1989.                               CICS OS/2 1.2.0 SERVICE LEVEL 19
  1990.  
  1991.                                              16 September 1992
  1992.  
  1993.  
  1994.   TABLE OF CONTENTS
  1995.   ─────────────────
  1996.  
  1997.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  1998.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  1999.     Hints and other information.   . . . . . . . . . . . . . 1
  2000.      Changes due to fix for APAR PN21505 (DPL) . . . . . . . 1
  2001.      Changes due to fix for APAR PN27302 (CVT) . . . . . . . 3
  2002.  
  2003.                                                              1
  2004.   INTRODUCTION
  2005.   ────────────
  2006.  
  2007.   CURRENT LEVEL
  2008.   ─────────────
  2009.  
  2010.   The current level of CICS OS/2 is 1.2.0. Service Level 19.
  2011.  
  2012.   HINTS AND OTHER INFORMATION.
  2013.   ────────────────────────────
  2014.  
  2015.   Changes due to fix for APAR PN21505 (DPL Extensions)
  2016.   ────────────────────────────────────────────────────
  2017.   APAR PN21505 implements the extensions to DPL as defined in CICS/ESA 3.3;
  2018.   the new command format is -
  2019.  
  2020.   EXEC CICS LINK
  2021.             PROGRAM(name)
  2022.             [COMMAREA(data-area) [LENGTH(data-value)] [DATALENGTH(data-value]]
  2023.             [SYSID(name)] [SYNCONRETURN] [TRANSID(name)]
  2024.  
  2025.   The new options are -
  2026.  
  2027.    DATALENGTH(data-value) If a COMMAREA is passed on a distributed link, then
  2028.                           the actual data transmitted will be the length in the
  2029.                           LENGTH parameter, null-truncated; if DATALENGTH is
  2030.                           specified, however, this will be the length of the
  2031.                           data transmitted regardless of content. This is a
  2032.                           performance option. Note, the COMMAREA received by
  2033.                           the server (linked-to) program is always LENGTH bytes
  2034.                           long.
  2035.  
  2036.   SYNCONRETURN            Without this option, any updates on the server side of
  2037.                           the link will not be committed until the client trans-
  2038.                           action issues a SYNCPOINT (explicitly or implicitly).
  2039.                           This implies that the session between the 2 systems is
  2040.                           held until SYNCPOINT is issued. It also means that the
  2041.                           server program cannot issue a SYNCPOINT request.
  2042.                           When SYNCONRETURN is specified, the server mirror
  2043.                           program will automatically issue a SYNCPOINT when the
  2044.                           server program RETURNs.This commits any updates in the
  2045.                           server system, and any systems to which the server has
  2046.                           initiated communication; the SYNCPOINT does NOT flow
  2047.                           back to the client transaction. With this option in
  2048.                           force, the server program is allowed to issue its own
  2049.                           explicit SYNCPOINTs, and the session is ended when the
  2050.                           server returns control to the client.
  2051.  
  2052.   TRANSID(name)           By default, the server program runs under the mirror
  2053.                           transaction code CPMI, although EIBTRNID contains the
  2054.                           name of the client transaction. When this option is
  2055.                           specified, this is the transaction code under which
  2056.                           the server will run. This means that the transaction
  2057.                           code must be defined in the server system's PCT, and
  2058.                           it must point to the mirror program (FAAMIR in CICS
  2059.                           OS/2, DFHMIRS in mainframe CICS systems). Note that
  2060.                           COMMAREA data will NOT be automatically converted
  2061.                           between ASCII and EBCDIC if this option is used; data
  2062.                           conversion is the responsibility of the user. This
  2063.                           value overrides any TRANSID specified in the PPT entry
  2064.                           for the program.
  2065.  
  2066.                                                              2
  2067.   New/changed conditions may be raised in response to LINK -
  2068.  
  2069.   INVREQ  LENGERR  ROLLEDBACK  SYSIDERR  TERMERR
  2070.  
  2071.   Each of these can have different EIBRESP2 values; see the CICS/ESA 3.3 APR for
  2072.   details.
  2073.  
  2074.   Several commands are restricted when issued within a server environment,mostly
  2075.   related to terminal handling. If a restricted command is issued, an INVREQ
  2076.   condition will be raised, with EIBRESP2 set to 200; if the condition is not
  2077.   catered for using HANDLE CONDITION or the NOHANDLE option, then the server
  2078.   program will be abended ADPL (note, not AEIP). Restricted commands are -
  2079.  
  2080.   ADDRESS TCTUA
  2081.   ASSIGN  terminal-related options
  2082.   CONNECT PROCESS
  2083.   CONVERSE
  2084.   EXTRACT PROCESS
  2085.   FREE
  2086.   HANDLE AID
  2087.   ISSUE ABEND/CONFIRMATION/ERROR/SIGNAL CONVID
  2088.   RECEIVE
  2089.   SEND
  2090.   SIGNOFF
  2091.   SIGNON
  2092.   SYNCPOINT (ROLLBACK)
  2093.   WAIT CONVID
  2094.  
  2095.   The terminal I/O commands are not allowed to refer to the Principal Facility,
  2096.   i.e. EIBTRMID, which is the LU6.2 session; it is in order for a server program
  2097.   to, for example, initiate a DTP conversation with another system (or even back
  2098.   to the client system, but this will require a separate session).
  2099.   SYNCPOINT (ROLLBACK) is valid if SYNCONRETURN was specified on the LINK.
  2100.  
  2101.   For further information, see the CICS/ESA 3.3 APR and APG manuals.
  2102.                                                              3
  2103.   Changes due to fix for APAR PN27302
  2104.   ────────────────────────────────────
  2105.   APAR PN27302 introduces changes to the processing of CVT conversion
  2106.   templates.  Please see the text of the APAR for full details.
  2107.  
  2108.                                                              4
  2109.     **************************************************************
  2110.     **************************************************************
  2111.     ***                                                        ***
  2112.     ***                   End of PTF 19 updates.               ***
  2113.     ***             Updates for previous PTFs follow.          ***
  2114.     ***                                                        ***
  2115.     **************************************************************
  2116.     **************************************************************
  2117.  
  2118.  
  2119.                                                              i
  2120.                                                 README.TXT FOR
  2121.                               CICS OS/2 1.2.0 SERVICE LEVEL 18
  2122.  
  2123.                                                 17 August 1992
  2124.  
  2125.  
  2126.   TABLE OF CONTENTS
  2127.   ─────────────────
  2128.  
  2129.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2130.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2131.     Hints and other information.   . . . . . . . . . . . . . 1
  2132.       Supply of new ECI in PTF 18.   . . . . . . . . . . . . 1
  2133.       Supply of new File Manager in PTF18.   . . . . . . . . 1
  2134.  
  2135.                                                              1
  2136.   INTRODUCTION
  2137.   ────────────
  2138.  
  2139.   CURRENT LEVEL
  2140.   ─────────────
  2141.  
  2142.   The current level of CICS OS/2 is 1.2.0. Service Level 18.
  2143.  
  2144.   HINTS AND OTHER INFORMATION.
  2145.   ────────────────────────────
  2146.  
  2147.  
  2148.   SUPPLY OF NEW ECI VERSION IN PTF18
  2149.   ────────────────────────────────────
  2150.  
  2151.   A  new  version  of  the  Extended  Call  Interface (ECI) is
  2152.   included in this PTF (PTF18) and fixes the problems reported
  2153.   in  APARs PN20922,PN21343 and PN25443. The File ECI.DOC contains
  2154.   the information necessary to use this new version.
  2155.  
  2156.   SUPPLY OF NEW FILE MANAGER IN PTF18
  2157.   ────────────────────────────────────
  2158.  
  2159.   PTF 18 contains a new version of the CICS OS/2 File Manager which
  2160.   provides improved performance and functionality. It also guarantees
  2161.   full forward compatibility for all system and user files, however
  2162.   after the upgrade has been performed the user may not revert to
  2163.   the pre-PTF 18 version of the File Manager. Users should ensure
  2164.   that adequate backups of their existing files are taken *before*
  2165.   starting CICS with the new File Manager.
  2166.  
  2167.                                                              2
  2168.     **************************************************************
  2169.     **************************************************************
  2170.     ***                                                        ***
  2171.     ***                   End of PTF 18 updates.               ***
  2172.     ***             Updates for previous PTFs follow.          ***
  2173.     ***                                                        ***
  2174.     **************************************************************
  2175.     **************************************************************
  2176.  
  2177.                                                              i
  2178.                                                 README.TXT FOR
  2179.                               CICS OS/2 1.2.0 SERVICE LEVEL 17
  2180.  
  2181.                                                   27 July 1992
  2182.  
  2183.  
  2184.   TABLE OF CONTENTS
  2185.   ─────────────────
  2186.  
  2187.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2188.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2189.     Hints and other information.   . . . . . . . . . . . . . 1
  2190.       Changes due to fix for APAR PN00194.   . . . . . . . . 1
  2191.       Changes due to fix for APAR PN19943.   . . . . . . . . 3
  2192.  
  2193.  
  2194.                                                              1
  2195.   INTRODUCTION
  2196.   ────────────
  2197.  
  2198.   CURRENT LEVEL
  2199.   ─────────────
  2200.  
  2201.   The current level of CICS OS/2 is 1.2.0. Service Level 17.
  2202.  
  2203.   HINTS AND OTHER INFORMATION.
  2204.   ────────────────────────────
  2205.  
  2206.  
  2207.   CHANGES DUE TO FIX FOR APAR PN00194.
  2208.   ────────────────────────────────────
  2209.   This APAR introduces 'C' language sample programs.
  2210.  
  2211.   INSTRUCTION FOR THE 'C' LANGUAGE SAMPLE TRANSACTIONS.
  2212.  
  2213.   This  PTF  provides  'C' language sample transactions
  2214.   equivalent to the COBOL language samples.
  2215.  
  2216.   They are:
  2217.  
  2218.   o   FAACCALL.CCS - FILEA Add / Inquire / Update
  2219.  
  2220.   o   FAACCBRW.CCS - FILEA Browse
  2221.  
  2222.   o   FAACCCOM.CCS - FILEA Order Entry Queue Print
  2223.  
  2224.   o   FAACCMNU.CCS - FILEA Operator Instruction Menu
  2225.  
  2226.   o   FAACCREN.CCS - FILEA Order Entry
  2227.  
  2228.   o   FAACCREP.CCS - FILEA Low Balance Inquiry
  2229.  
  2230.       plus the 'C' header files:
  2231.  
  2232.   o   FAACCL86.H
  2233.  
  2234.   o   FAACCFIL.H
  2235.  
  2236.       and the corresponding BMS maps:
  2237.  
  2238.   o   FAACCMA.BMS
  2239.  
  2240.   o   FAACCMB.BMS
  2241.  
  2242.   o   FAACCMC.BMS
  2243.  
  2244.   o   FAACCMD.BMS
  2245.  
  2246.   o   FAACCMK.BMS
  2247.  
  2248.   o   FAACCML.BMS
  2249.  
  2250.                                                              2
  2251.   Proceed as follows:
  2252.  
  2253.   1.  Run the BMS map  translator  against  each  of  the  map
  2254.       files.
  2255.  
  2256.         For example: CICSMAP FAACCMA
  2257.  
  2258.       This will generate the maps themselves and produce the
  2259.       the 'C' language header files FAACCG*.H.
  2260.  
  2261.   3.  Translate, compile and link each of the application pro-
  2262.       grams remembering to specify the 'MAIN' option.
  2263.  
  2264.         For example: CICSCTCL FAACCALL MAIN
  2265.  
  2266.       If   necessary   (dependent  on  your  setup)  move  the
  2267.       FAACC*.DLL files into the CICS OS/2 execution  directory
  2268.       (normally CICS120\OS2DSD).
  2269.  
  2270.   4.  Bring  up  CICS OS/2 and define the following entries in
  2271.       the PCT using CEDA:
  2272.  
  2273.       a.  PCT.
  2274.  
  2275.           o   CADD - FAACCALL
  2276.  
  2277.           o   CBRW - FAACCBRW
  2278.  
  2279.           o   CCOM - FAACCCOM
  2280.  
  2281.           o   CINQ - FAACCALL
  2282.  
  2283.           o   CMNU - FAACCMNU
  2284.  
  2285.           o   CORQ - FAACCCOM
  2286.  
  2287.           o   CREN - FAACCREN
  2288.  
  2289.           o   CREP - FAACCREP
  2290.  
  2291.           o   CUPD - FAACCALL
  2292.  
  2293.           The  detail  of the PCT entry is the same as the for
  2294.           the equivalent COBOL language entry.
  2295.  
  2296.  
  2297.   5.  Shut CICS OS/2 down using CQIT.
  2298.  
  2299.   6.  Bring  up  CICS  OS/2 (to make the PCT & PPT entries
  2300.       active).
  2301.  
  2302.                                                              3
  2303.   To run the 'C' language Sample transactions proceed as  with
  2304.   the  COBOL  language  Sample transactions but use the trans-
  2305.   action names defined above. For example:
  2306.  
  2307.   o   to get the menu use 'CMNU'.
  2308.  
  2309.   o   on the menu panel use 'CBRW', 'CADD',  'CINQ'  &  'CUPD'
  2310.       instead of 'BRWS' 'ADDS' 'INQY' & 'UPDT' to Browse / Add
  2311.       / Inquire / Update records on FILEA.
  2312.  
  2313.   o   to run Order Entry use 'CREN'.
  2314.  
  2315.   o   to run Order Entry Queue Print use 'CCOM'.
  2316.  
  2317.   o   to run Low Balance Inquiry use 'CREP'.
  2318.  
  2319.  
  2320.   CHANGES DUE TO FIX FOR APAR PN19943.
  2321.   ────────────────────────────────────
  2322.   The CICS OS/2 Translator now only processes valid COBOL STOP
  2323.   statements i.e. 'STOP RUN' or 'STOP nn' where 'nn' is an
  2324.   integer value.  The word single word 'STOP' will no longer be
  2325.   commented out by the translator.
  2326.  
  2327.                                                              4
  2328.     **************************************************************
  2329.     **************************************************************
  2330.     ***                                                        ***
  2331.     ***                   End of PTF 17 updates.               ***
  2332.     ***             Updates for previous PTFs follow.          ***
  2333.     ***                                                        ***
  2334.     **************************************************************
  2335.     **************************************************************
  2336.  
  2337.                                                              i
  2338.                                                 README.TXT FOR
  2339.                               CICS OS/2 1.2.0 SERVICE LEVEL 16
  2340.  
  2341.                                                   12 June 1992
  2342.  
  2343.  
  2344.   TABLE OF CONTENTS
  2345.   ─────────────────
  2346.  
  2347.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2348.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2349.     Hints and other information.   . . . . . . . . . . . . . 1
  2350.       Changes due to fix for APAR PN20903.   . . . . . . . . 1
  2351.       Changes due to fix for APAR PN22292.   . . . . . . . . 2
  2352.  
  2353.  
  2354.                                                              1
  2355.   INTRODUCTION
  2356.   ────────────
  2357.  
  2358.   CURRENT LEVEL
  2359.   ─────────────
  2360.  
  2361.   The current level of CICS OS/2 is 1.2.0. Service Level 16.
  2362.  
  2363.   HINTS AND OTHER INFORMATION.
  2364.   ────────────────────────────
  2365.  
  2366.  
  2367.   CHANGES DUE TO FIX FOR APAR PN20903.
  2368.   ────────────────────────────────────
  2369.  
  2370.   The following trace points were introduced / changed:
  2371.  
  2372.   ┌────────────────────────────────────────────────────────────────────┐
  2373.   │ ID = 01   Issued by FAASRSML   OS/2 Server mainline                │
  2374.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  2375.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  2376.   │ POINT   │                      │                 │                 │
  2377.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2378.   │ SV M80  │ Generate ICE Entry   │ 2byte Rec. count│ DCT queue status│
  2379.   │         │ - check.             │ 2byte Low-values│ 1byte low-value │
  2380.   │         │                      │                 │ DCT ATI status  │
  2381.   │         │                      │                 │ 1byte low-value │
  2382.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2383.   │ SV M76  │ Generate ICE Entry   │ 4byte Transid   │ DCT queue status│
  2384.   │         │ - entry.             │                 │ 1byte low-value │
  2385.   │         │                      │                 │ DCT ATI status  │
  2386.   │         │                      │                 │ 1byte low-value │
  2387.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2388.   │ SV M81  │ Generate ICE Entry   │ 2byte Retn. code│ DCT queue status│
  2389.   │         │ - result.            │ 2byte Low-values│ 1byte low-value │
  2390.   │         │                      │                 │ DCT ATI status  │
  2391.   │         │                      │                 │ 1byte low-value │
  2392.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  2393.  
  2394.   ┌────────────────────────────────────────────────────────────────────┐
  2395.   │ ID = 56   Issued by FAAOTPTK   OS/2 task control                   │
  2396.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  2397.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  2398.   │ POINT   │                      │                 │                 │
  2399.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2400.   │ SV K91  │ DCT Entry status     │ 2byte Retn. code│ DCT queue status│
  2401.   │         │                      │ 2byte DCT index │ 1byte low-value │
  2402.   │         │                      │                 │ DCT ATI status  │
  2403.   │         │                      │                 │ 1byte low-value │
  2404.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2405.   │ SV K92  │ DCT Queue status     │ 2byte Retn. code│ DCT queue status│
  2406.   │         │                      │ 2byte DCT index │ 1byte low-value │
  2407.   │         │                      │                 │ DCT ATI status  │
  2408.   │         │                      │                 │ 1byte low-value │
  2409.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2410.   │ SV K93  │ DCT Queue status     │ 2byte Start-code│ DCT queue status│
  2411.   │         │                      │ 2byte DCT index │ 1byte low-value │
  2412.   │         │                      │                 │ DCT ATI status  │
  2413.   │         │                      │                 │ Facility type   │
  2414.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  2415.  
  2416.                                                              2
  2417.  
  2418.   ┌────────────────────────────────────────────────────────────────────┐
  2419.   │ ID = 01   Issued by FAASRCTS   OS/2 Server TD and TS               │
  2420.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  2421.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  2422.   │ POINT   │                      │                 │                 │
  2423.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2424.   │         │                      │                 │                 │
  2425.   │ SV T17  │TD Lock queue entry   │ 4byte Q. handle │ Dest-id         │
  2426.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2427.   │ SV T18  │TD Lock Q.   semaphore│ 2byte Retn. code│ Low-values      │
  2428.   │         │                      │ 2byte Low-values│                 │
  2429.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2430.   │ SV T19  │TD Lock queue exit    │ 2byte Retn. code│ 2byte Retn. code│
  2431.   │         │                      │ 2byte Retn. code│ 2byte Low-values│
  2432.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  2433.  
  2434.   CHANGES DUE TO FIX FOR APAR PN22292.
  2435.   ────────────────────────────────────
  2436.   The CICS OS/2 trace taken from a system running on OS/2 (not DOS)
  2437.   will now indicate the Service level (PTF level) of the CICS system.
  2438.  
  2439.   The following trace point was changed:
  2440.  
  2441.   ┌────────────────────────────────────────────────────────────────────┐
  2442.   │ ID = 42   Issued by FAAOMPTR   OS/2 trace monitor                  │
  2443.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  2444.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  2445.   │ POINT   │                      │                 │                 │
  2446.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2447.   │         │                      │                 │                 │
  2448.   │ TV T09  │Trace block released  │ Bytes 1 - 4 of  │ Bytes 5-6 of TOD│
  2449.   │         │                      │time-of-day (TOD)│ 2byte PTF Level │
  2450.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  2451.  
  2452.                                                              3
  2453.     **************************************************************
  2454.     **************************************************************
  2455.     ***                                                        ***
  2456.     ***                   End of PTF 16 updates.               ***
  2457.     ***             Updates for previous PTFs follow.          ***
  2458.     ***                                                        ***
  2459.     **************************************************************
  2460.     **************************************************************
  2461.  
  2462.                                                              i
  2463.                                                 README.TXT FOR
  2464.                               CICS OS/2 1.2.0 SERVICE LEVEL 15
  2465.  
  2466.                                                    21 May 1992
  2467.  
  2468.  
  2469.   TABLE OF CONTENTS
  2470.   ─────────────────
  2471.  
  2472.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2473.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2474.     Hints and other information.   . . . . . . . . . . . . . 1
  2475.       Changes due to fix for APAR PN04245.   . . . . . . . . 1
  2476.       Changes due to fix for APAR PN12497.   . . . . . . . . 1
  2477.       Changes due to fix for APAR PN13710.   . . . . . . . . 1
  2478.  
  2479.  
  2480.                                                              1
  2481.   INTRODUCTION
  2482.   ────────────
  2483.  
  2484.   CURRENT LEVEL
  2485.   ─────────────
  2486.  
  2487.   The current level of CICS OS/2 is 1.2.0. Service Level 15.
  2488.  
  2489.   HINTS AND OTHER INFORMATION.
  2490.   ────────────────────────────
  2491.  
  2492.  
  2493.   CHANGES DUE TO FIX FOR APAR PN04245.
  2494.   ────────────────────────────────────
  2495.  
  2496.   The CICS OS/2 COBOL Translator has been changed.  If a $SET
  2497.   statement is encountered during translation it is inserted into
  2498.   the .CBL file before a comment line is inserted to show date
  2499.   and time.
  2500.  
  2501.   CHANGES DUE TO FIX FOR APAR PN12497.
  2502.   ────────────────────────────────────
  2503.  
  2504.   The CICS OS/2 Translator has been changed to process the
  2505.   EXEC CICS SEND MAP command correctly.  The LENGTH option
  2506.   is no longer required.
  2507.  
  2508.   CHANGES DUE TO FIX FOR APAR PN13710.
  2509.   ────────────────────────────────────
  2510.  
  2511.   The CICS OS/2 Translator has been changed to process the
  2512.   EXEC CICS RECEIVE INTO(....) command correctly.  The LENGTH
  2513.   option is no longer required.
  2514.  
  2515.  
  2516.  
  2517.     **************************************************************
  2518.     **************************************************************
  2519.     ***                                                        ***
  2520.     ***                   End of PTF 15 updates.               ***
  2521.     ***             Updates for previous PTFs follow.          ***
  2522.     ***                                                        ***
  2523.     **************************************************************
  2524.     **************************************************************
  2525.  
  2526.  
  2527.                                                              i
  2528.                                                 README.TXT FOR
  2529.                               CICS OS/2 1.2.0 SERVICE LEVEL 14
  2530.  
  2531.                                                    30 Apr 1992
  2532.  
  2533.  
  2534.   TABLE OF CONTENTS
  2535.   ─────────────────
  2536.  
  2537.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2538.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2539.     Hints and other information.   . . . . . . . . . . . . . 1
  2540.       Changes due to fix for APAR PN11097.   . . . . . . . . 1
  2541.       Changes due to fix for APAR PN13285.   . . . . . . . . 1
  2542.       Changes due to fix for APAR PN00015.   . . . . . . . . 3
  2543.       Changes due to fix for APAR PN07068.   . . . . . . . . 3
  2544.  
  2545.  
  2546.                                                              1
  2547.   INTRODUCTION
  2548.   ────────────
  2549.  
  2550.   CURRENT LEVEL
  2551.   ─────────────
  2552.  
  2553.   The current level of CICS OS/2 is 1.2.0. Service Level 14.
  2554.  
  2555.   HINTS AND OTHER INFORMATION.
  2556.   ────────────────────────────
  2557.  
  2558.  
  2559.   CHANGES DUE TO FIX FOR APAR PN11097.
  2560.   ────────────────────────────────────
  2561.  
  2562.   A  new  help panel FAAED1 which consists of 2 pages has been
  2563.   introduced to  explain  transaction  CADL  and  its  various
  2564.   options.
  2565.  
  2566.  
  2567.   CHANGES DUE TO FIX FOR APAR PN13285.
  2568.   ────────────────────────────────────
  2569.  
  2570.   PN13285 fixes the following translator problems -
  2571.  
  2572.   1.  OLDCOPY processing now works correctly, including nested
  2573.       COPY statements.
  2574.  
  2575.   2.  COPY  statements which are commented out by means of '*'
  2576.       in column 1 are ignored (this applies to all lines which
  2577.       begin '*' in column 1).
  2578.  
  2579.   3.  A   new   translator   directive   is    introduced    -
  2580.       (NO)PROCESSCOPY.  This  is  used to specify whether COPY
  2581.       statements are processed by the CICS OS/2 translator  or
  2582.       passed  through  to the COBOL Compiler. N.B. The default
  2583.       is PROCESSCOPY, i.e. COPY statements will  be  processed
  2584.       by the translator.
  2585.  
  2586.       NOPROCESSCOPY  should  not be specified in the following
  2587.       cases -
  2588.  
  2589.       ∙   Code copied into the  Linkage  Section  contains  an
  2590.           01-level definition
  2591.            which is referred to by a SERVICE RELOAD statement.
  2592.  
  2593.       ∙   Code  copied  into  the  Procedure Division contains
  2594.           EXEC CICS commands  .
  2595.  
  2596.       ∙   code  copied  into  WORKING  STORAGE  section   also
  2597.           contains LINKAGE SECTION and or
  2598.            PROCEDURE DIVISION STATEMENTS
  2599.  
  2600.   Example CCP Program using OLDCOPY:-
  2601.                                                              2
  2602.   CBL XOPTS(PROCESSCOPY OLDCOPY).
  2603.          IDENTIFICATION DIVISION.
  2604.          PROGRAM-ID. 1x310.
  2605.          ENVIRONMENT DIVISION.
  2606.          DATA DIVISION.
  2607.          WORKING-STORAGE SECTION.
  2608.          01 DATA-AREA COPY OLD1X310.
  2609.          PROCEDURE DIVISION.
  2610.              EXEC CICS RETURN END-EXEC.
  2611.  
  2612.   Example Copybook:-
  2613.  
  2614.           01 OLD-AREA.
  2615.              05 FILLER PIC X(80).
  2616.  
  2617.  
  2618.                                                              3
  2619.   CHANGES DUE TO FIX FOR APAR PN00015.
  2620.   ────────────────────────────────────
  2621.  
  2622.   The following trace points were introduced / changed:
  2623.  
  2624.   ┌────────────────────────────────────────────────────────────────────┐
  2625.   │ ID = 01   Issued by FAASRSML   OS/2 Server mainline                │
  2626.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  2627.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  2628.   │ POINT   │                      │                 │                 │
  2629.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2630.   │         │                      │                 │                 │
  2631.   │ SN M70  │Enter Rollback TD     │ Low-values      │ Low-values      │
  2632.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2633.   │ SX M71  │Exit Rollback TD      │ 2byte Retn-code │ Low-values      │
  2634.   │         │                      │ 2byte Low-values│                 │
  2635.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2636.   │ SN M72  │TD Commit - Phase  1  │ Low-values      │ Low-values      │
  2637.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2638.   │ SX M73  │TD Commit - Phase 1   │ 2byte Retn-code │ 2byte Xact count│
  2639.   │         │                      │ 2byte Retn-code │ 2byte Low-values│
  2640.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2641.   │ SN M74  │TD Commit - Phase  2  │ Low-values      │ Low-values      │
  2642.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2643.   │ SX M75  │TD Commit - Phase 2   │ 2byte Retn-code │ Low values      │
  2644.   │         │                      │ 2byte Low-values│                 │
  2645.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2646.   │ SN M76  │Generate ICE Entry    │ Low-values      │ TransId         │
  2647.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2648.   │ SX M77  │Generate ICE Entry    │ 2byte  Retn-code│ Destination     │
  2649.   │         │                      │ 2byte Low-values│                 │
  2650.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2651.   │ SN M78  │TD purge queue        │ Destination name│ Low-values      │
  2652.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2653.   │ SX M79  │TD purge queue        │ 2byte Retn-code │ Queue name      │
  2654.   │         │                      │ 2byte Low-values│                 │
  2655.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  2656.  
  2657.                                                              4
  2658.   ┌────────────────────────────────────────────────────────────────────┐
  2659.   │ ID = 01   Issued by FAASRCTS   Server TD/TS                        │
  2660.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  2661.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  2662.   │ POINT   │                      │                 │                 │
  2663.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2664.   │         │                      │                 │                 │
  2665.   │  SX T04 │After TS Get Last     │ 2byte Retn-code │Record-key       │
  2666.   │         │                      │ 2byte Rec-key   │                 │
  2667.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2668.   │  SN T10 │Lock TD Write         │ Handle          │Dest name        │
  2669.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2670.   │  SE T11 │TD Write SemRequest   │ 2byte Retn-code │Low-values       │
  2671.   │         │                      │ 2byte Low-values│                 │
  2672.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2673.   │  SX T12 │TD Write SemRequest   │ 2byte Retn-code │ 2byte Pid       │
  2674.   │         │                      │ 2byte Low-values│ 2byte Low-values│
  2675.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2676.   │  SN T13 │Lock TD Read          │ Handle          │ Dest name       │
  2677.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2678.   │  SE T14 │TD Read SemRequest    │ 2byte Retn-code │ Low-values      │
  2679.   │         │                      │ 2byte Low-values│                 │
  2680.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  2681.   │  SX T12 │TD Read SemRequest    │ 2byte Retn-code │ 2byte Pid       │
  2682.   │         │                      │ 2byte Low-values│ 2byte Low-values│
  2683.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  2684.  
  2685.   CHANGES DUE TO FIX FOR APAR PN07068.
  2686.   ────────────────────────────────────
  2687.  
  2688.   The CICS OS/2 COBOL  Translator  has been  changed to search
  2689.   for copybooks with no file  extension or a file extension of
  2690.   .CPY, in addition to .CBL.  It is no longer necessary to use
  2691.   a  file extension  of .CBL  for  files  referenced  in  COPY
  2692.   commands in a COBOL program.
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.     **************************************************************
  2701.     **************************************************************
  2702.     ***                                                        ***
  2703.     ***                   End of PTF 14 updates.               ***
  2704.     ***             Updates for previous PTFs follow.          ***
  2705.     ***                                                        ***
  2706.     **************************************************************
  2707.     **************************************************************
  2708.  
  2709.                                                              i
  2710.                                                 README.TXT FOR
  2711.                                CICS OS/2 1.20 SERVICE LEVEL 13
  2712.  
  2713.                                                  31 MARCH 1992
  2714.  
  2715.  
  2716.   TABLE OF CONTENTS
  2717.   _________________
  2718.  
  2719.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2720.     Hints and other information.   . . . . . . . . . . . . . 1
  2721.       Changes due to fix for APAR PL76806  . . . . . . . . . 1
  2722.       Changes due to fix for APAR PN16425  . . . . . . . . . 1
  2723.  
  2724.  
  2725.                                                              1
  2726.   CURRENT LEVEL
  2727.   _____________
  2728.  
  2729.   The current level of CICS OS/2 is 1.20. Service Level 13.
  2730.  
  2731.   HINTS AND OTHER INFORMATION.
  2732.   ____________________________
  2733.  
  2734.   CHANGES DUE TO FIX FOR APAR PL76806
  2735.  
  2736.   A  new  version  of  the  Extended  Call  Interface (ECI) is
  2737.   included in this PTF (PTF13) and fixes the problem  reported
  2738.   in  APAR  PL76806.    File  ECI.DOC contains the information
  2739.   necessary to use this new version.
  2740.  
  2741.  
  2742.   CHANGES DUE TO FIX FOR APAR PN16425
  2743.  
  2744.   If  you require the fix detailed in the above APAR, then all
  2745.   affected applications must be re-translated and compiled  as
  2746.   the fix is implemented in the CICS OS/2 COBOL Translator.
  2747.  
  2748.  
  2749.  
  2750.  
  2751.     **************************************************************
  2752.     **************************************************************
  2753.     ***                                                        ***
  2754.     ***                   End of PTF 13 updates.               ***
  2755.     ***             Updates for previous PTFs follow.          ***
  2756.     ***                                                        ***
  2757.     **************************************************************
  2758.     **************************************************************
  2759.  
  2760.                                                              i
  2761.                                                 README.TXT FOR
  2762.                               CICS OS/2 1.2.0 SERVICE LEVEL 12
  2763.  
  2764.                                                     3 Mar 1992
  2765.  
  2766.   TABLE OF CONTENTS
  2767.   _________________
  2768.  
  2769.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2770.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2771.     Hints and other information.   . . . . . . . . . . . . . 1
  2772.       Changes due to fix for APAR PN06725.   . . . . . . . . 1
  2773.       Changes due to fix for APAR PN06573.   . . . . . . . . 2
  2774.       Changes due to fix for APAR PN09479.   . . . . . . . . 2
  2775.       Changes due to fix for APAR PN10386.   . . . . . . . . 2
  2776.       Changes due to fix for APAR PN11715.   . . . . . . . . 3
  2777.       Changes due to fix for APAR PN12231.   . . . . . . . . 3
  2778.  
  2779.  
  2780.                                                              1
  2781.   INTRODUCTION
  2782.   ____________
  2783.  
  2784.   CURRENT LEVEL
  2785.   _____________
  2786.  
  2787.   The current level of CICS OS/2 is 1.2.0. Service Level 12.
  2788.  
  2789.   HINTS AND OTHER INFORMATION.
  2790.   ____________________________
  2791.  
  2792.   CHANGES DUE TO FIX FOR APAR PN06725.
  2793.  
  2794.   PN06725   changes   the  operation  of  the  CICS  OS/2  map
  2795.   translator as follows :-
  2796.  
  2797.   1.  The length of INITIAL data is checked against the  value
  2798.       given  for LENGTH for non-named fields - it already does
  2799.       the check for named fields.
  2800.  
  2801.   2.  In INITIAL data to obtain the character '&'  (ampersand)
  2802.       the  character '&&' (two ampersands) must be used.  This
  2803.       is  to  maintain  compatibility  with   the   host   map
  2804.       translator.
  2805.  
  2806.   3.  A  new  message  -  'FAA1900W  Unmatched  open  or close
  2807.       brackets on %1' - has been added.  This will  be  issued
  2808.       if there are missing opening '(' or closing ')' brackets
  2809.       detected while checking the map source.
  2810.  
  2811.  
  2812.                                                              2
  2813.   CHANGES DUE TO FIX FOR APAR PN06573.
  2814.  
  2815.   The following duplicate trace points have been changed.
  2816.  
  2817.   ∙   50R02 is now 50R22 Sect Error.
  2818.           Field A: HUD Xmit sequence number.
  2819.           Field B: HUD Receive sequence number.
  2820.  
  2821.   ∙   50R10 is now 50R30 Routine Error.
  2822.           Field A: HUD Header byte 9.
  2823.           Field B: Return code.
  2824.  
  2825.  
  2826.   CHANGES DUE TO FIX FOR APAR PN09479.
  2827.  
  2828.   PN09479  changes the CICS OS/2 COBOL translator to accept an
  2829.   '*' (asterisk) in column 1 of a record in  the  source  file
  2830.   and  treat  that  record  as  a  comment.    The record will
  2831.   subsequently be treated as a comment by the COBOL compiler.
  2832.  
  2833.  
  2834.   CHANGES DUE TO FIX FOR APAR PN10386.
  2835.  
  2836.   PN10386 has added the following new trace points.
  2837.  
  2838.   ∙   Major Event. 62T10. Remote Logon Details.
  2839.           Field A : USERID
  2840.           Field B : password
  2841.  
  2842.   ∙   Major Event. 62T11. Local Authorisation Details.
  2843.           Field A :  'LOCL'
  2844.           Field B :  (1:1) Local sign-on flag
  2845.                      (3:1) Authorisation flag
  2846.  
  2847.  
  2848.  
  2849.                                                              3
  2850.   CHANGES DUE TO FIX FOR APAR PN11715.
  2851.  
  2852.   PN11715 makes the following changes to trace.
  2853.  
  2854.   Tracepoint  01I04 has been modified to trace EIB-CC in field
  2855.   A and the Return Code in field B.
  2856.  
  2857.   ∙   Exit from Section. 01I04. Exit from Delay Post.
  2858.           Field A : EIB-CC
  2859.           Field B : Return Code
  2860.  
  2861.   Tracepoint 01I09 has been added  trace  DosCreateSem  errors
  2862.   where  field  A  contains  the  Return  Code and field B the
  2863.   semaphore handle returned by OS/2.
  2864.  
  2865.   ∙   Basic Error. 01I09. DosCreateSem errors.
  2866.           Field A : Return Code
  2867.           Field B : Semaphore Handle returned by OS/2
  2868.  
  2869.  
  2870.   CHANGES DUE TO FIX FOR APAR PN12231.
  2871.  
  2872.   PN12231 corrects  3270 screen  colours to match those of the
  2873.   host.  As a result,  some  BMS  maps  may  change  after the
  2874.   application of this PTF.
  2875.  
  2876.  
  2877.  
  2878.     **************************************************************
  2879.     **************************************************************
  2880.     ***                                                        ***
  2881.     ***                   End of PTF 12 updates.               ***
  2882.     ***             Updates for previous PTFs follow.          ***
  2883.     ***                                                        ***
  2884.     **************************************************************
  2885.     **************************************************************
  2886.  
  2887.  
  2888.                                                              i
  2889.                                                 README.TXT FOR
  2890.                               CICS OS/2 1.2.0 SERVICE LEVEL 11
  2891.  
  2892.                                                    08 Nov 1991
  2893.  
  2894.  
  2895.   TABLE OF CONTENTS
  2896.   _________________
  2897.  
  2898.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  2899.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  2900.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  2901.       Preventative Maintenance   . . . . . . . . . . . . . . 1
  2902.     Hints and other information.   . . . . . . . . . . . . . 1
  2903.       Changes due to fix for APAR PN01818.   . . . . . . . . 1
  2904.       Changes due to fix for APAR PL80856.   . . . . . . . . 2
  2905.       Changes due to fix for APAR PL84380.   . . . . . . . . 2
  2906.       Changes due to fixes for APAR PN02394 and PN02488.   . 2
  2907.       COMMAREA Changes.  . . . . . . . . . . . . . . . . . . 2
  2908.  
  2909.  
  2910.                                                              1
  2911.   INTRODUCTION
  2912.   ____________
  2913.  
  2914.   CURRENT LEVEL
  2915.   _____________
  2916.  
  2917.   The current level of CICS OS/2 is 1.2.0. Service Level 11.
  2918.  
  2919.   IIAPAR INFORMATION
  2920.   __________________
  2921.  
  2922.   The following is from information APAR No. II05130:
  2923.   ( The RETAIN version  of  II05130  may  contain  more recent
  2924.   information.)
  2925.  
  2926.   PREVENTATIVE MAINTENANCE
  2927.  
  2928.   Preventative maintenance for CICS OS/2 is available in SMP/E
  2929.   and  MSHP  format  only.  Preventative  maintenance  will be
  2930.   shipped under an accumulative PTF containing  multiple  APAR
  2931.   fixes. This will be known as a Service Level or PTF level.
  2932.  
  2933.   When available, corrective service for individual APAR fixes
  2934.   will  be  shipped by the change team to individual Customers
  2935.   as needed on diskette.
  2936.  
  2937.   Following is a cross reference list of  Service  Levels  for
  2938.   MVS and VSE PTF numbers:
  2939.  
  2940.     ----------------------------------------------------------------
  2941.     SERVICE/PTF                 P  T  F       N U M B E R S
  2942.     LEVEL                        MVS               VSE
  2943.     ================================================================
  2944.      4                         UL85512           UL85513
  2945.      5                         UL89760           UL89761
  2946.      6                         UL95379           UL95380
  2947.      7                         UL97427           UL97434
  2948.      8                         UN03147           UN03148
  2949.      9                         UN05594           UN05595
  2950.     10                         UN08283           UN08284
  2951.     ================================================================
  2952.     PTF LEVEL 8 IS THE MINIMUM RECOMMENDED LEVEL TO RUN CICS OS/2.
  2953.     ================================================================
  2954.  
  2955.                                                              2
  2956.   HINTS AND OTHER INFORMATION.
  2957.   ____________________________
  2958.  
  2959.   CHANGES DUE TO FIX FOR APAR PN01818.
  2960.  
  2961.   PN01818  has changed the way that inter-system communication
  2962.   sessions are handled internally.   Sessions  are  no  longer
  2963.   reserved  as  Receive or Send sessions, but are pooled to be
  2964.   used for send or receive as required.
  2965.  
  2966.   The CEDA TCS definition screen is not, however, updated with
  2967.   this APAR, so no changes to existing system definitions  are
  2968.   required.   For each system defined, the numbers of Send and
  2969.   Receive sessions specified are added  to  give  the  session
  2970.   pool  size.    Session ids are now generated internally, and
  2971.   the Send and Receive prefixes are ignored.
  2972.  
  2973.  
  2974.   CHANGES DUE TO FIX FOR APAR PL80856.
  2975.  
  2976.   If  when  CICS  OS/2  is  coming up it fails to open a file,
  2977.   error message FAA1672S is issued.  The fix for this APAR has
  2978.   made sure that the path for the file is  searched  backwards
  2979.   and just the filename.extension passed to the error message.
  2980.   This  will  avoid  ambiguous  file names being issued by the
  2981.   FAA1672S error message.
  2982.  
  2983.  
  2984.  
  2985.   CHANGES DUE TO FIX FOR APAR PL84380.
  2986.  
  2987.   This  fix  has addressed the area of bringing up a CICS OS/2
  2988.   system with a large number of  tasks.    It  is  recommended
  2989.   however  that  the highest number of free tasks specified be
  2990.   set to no greater than 30.  Please note that this will  have
  2991.   an   impact  on  system  performance  and  is  configuration
  2992.   dependant.
  2993.  
  2994.  
  2995.   CHANGES DUE TO FIXES FOR APAR PN02394 AND PN02488.
  2996.  
  2997.   If  you  require  the  fixes  detailed  in the above APAR's,
  2998.   affected transactions will  need  to  be  re-translated  and
  2999.   compiled  as  the  fixes  are  implemented  in the CICS OS/2
  3000.   translator.
  3001.  
  3002.  
  3003.   COMMAREA CHANGES.
  3004.  
  3005.   The  process of COMMAREA checking has been amended to ensure
  3006.   that more complete checking is done.  If using the  COMMAREA
  3007.   the  user  must ensure that the length specified in EIBCALEN
  3008.   is used.  If this is not done and a length greater than that
  3009.   specified in EIBCALEN is used a TRAP 000D is issued.
  3010.  
  3011.  
  3012.  
  3013.  
  3014.     **************************************************************
  3015.     **************************************************************
  3016.     ***                                                        ***
  3017.     ***                   End of PTF 11 updates.               ***
  3018.     ***             Updates for previous PTFs follow.          ***
  3019.     ***                                                        ***
  3020.     **************************************************************
  3021.     **************************************************************
  3022.  
  3023.  
  3024.                                                              i
  3025.                                                 README.TXT FOR
  3026.                               CICS OS/2 1.2.0 SERVICE LEVEL 10
  3027.  
  3028.                                                   11 Sept 1991
  3029.  
  3030.  
  3031.   TABLE OF CONTENTS
  3032.   _________________
  3033.  
  3034.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  3035.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  3036.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  3037.       Preventative Maintenance   . . . . . . . . . . . . . . 1
  3038.     Hints and other information.   . . . . . . . . . . . . . 2
  3039.       CICS OS/2 and ANIMATOR   . . . . . . . . . . . . . . . 2
  3040.       Use of CICSRGRP.   . . . . . . . . . . . . . . . . . . 3
  3041.       ECI Sample Programs.   . . . . . . . . . . . . . . . . 3
  3042.  
  3043.  
  3044.                                                              1
  3045.   INTRODUCTION
  3046.   ____________
  3047.  
  3048.   The  README  TXT  file  was NOT updated with PTF 09 (Service
  3049.   Level 09).
  3050.  
  3051.   CURRENT LEVEL
  3052.   _____________
  3053.  
  3054.   The current level of CICS OS/2 is 1.2.0. Service Level 10.
  3055.  
  3056.   IIAPAR INFORMATION
  3057.   __________________
  3058.  
  3059.   The following is from information APAR No. II05130:
  3060.  
  3061.   PREVENTATIVE MAINTENANCE
  3062.  
  3063.   Preventative maintenance for CICS OS/2 is available in SMP/E
  3064.   and MSHP  format  only.  Preventative  maintenance  will  be
  3065.   shipped  under  an accumulative PTF containing multiple APAR
  3066.   fixes. This will be known as a Service Level or PTF level.
  3067.  
  3068.   When available, corrective service for individual APAR fixes
  3069.   will be shipped by the change team to  individual  Customers
  3070.   as needed on diskette.
  3071.  
  3072.   Following  is  a  cross reference list of Service Levels for
  3073.   MVS and VSE PTF numbers:
  3074.  
  3075.     ----------------------------------------------------------------
  3076.     SERVICE/PTF                 P  T  F       N U M B E R S
  3077.     LEVEL                        MVS               VSE
  3078.     ================================================================
  3079.      4                         UL85512           UL85513
  3080.      5                         UL89760           UL89761
  3081.      6                         UL95379           UL95380
  3082.      7                         UL97427           UL97434
  3083.      8                         UN03147           UN03148
  3084.      9                         UN05594           UN05595
  3085.     10                     PTF NOT ASSIGNED    PTF NOT ASSIGNED
  3086.     ================================================================
  3087.     PTF LEVEL 4 IS THE MINIMUM RECOMMENDED LEVEL TO RUN CICS OS/2.
  3088.     ================================================================
  3089.  
  3090.                                                              2
  3091.   HINTS AND OTHER INFORMATION.
  3092.   ____________________________
  3093.  
  3094.   CICS OS/2 AND ANIMATOR
  3095.  
  3096.   The Systems and Application Guide states:
  3097.  
  3098.   "When you  compile  a  program  with  ANIMATOR  or  Advanced
  3099.   ANIMATOR,  files  with  suffixes .IDY and .INT are produced.
  3100.   ANIMATOR or Advanced ANIMATOR  must  use  these  files  when
  3101.   stepping  through  the  program. Always delete or rename the
  3102.   .DLL file before running either of these debugging tools, to
  3103.   prevent it from picking up the wrong file".
  3104.  
  3105.   The above is only true  if  you  are  using  the  MicroFocus
  3106.   Programmer's Workbench.
  3107.  
  3108.  
  3109.  
  3110.     ANIMATOR  support  for  CICS OS/2 is also available if you
  3111.   only have the MicroFocus COBOL/2 compiler,  however,  unlike
  3112.   the  Workbench the compiler does not contain a COBOL runtime
  3113.   system therefore some changes have to be made.
  3114.  
  3115.   The  following  should  be  carried  out to enable CICS OS/2
  3116.   transactions to be animated when only the compiler is  being
  3117.   used:
  3118.  
  3119.   1.  Translate the CICS program in the usual way (CICSTRAN)
  3120.  
  3121.   2.  Compile  the  program with the /ANIM option and also the
  3122.       OPT"0" option (if OPT"0" is not specified the linker  is
  3123.       implicitly  invoked  and  an  attempt  to find a library
  3124.       called OS2.LIB will fail).
  3125.  
  3126.   3.  Link  the  program  in  the  usual  way  using  CICSLINK
  3127.       (FAACLIB, DOSCALLS and COBLIB).
  3128.  
  3129.   A  IDY and a .DLL file will be produced. No INT file will be
  3130.   produced.
  3131.  
  3132.   Both the .IDY file AND the .DLL file must  be  available  to
  3133.   run  this program under ANIMATOR on a CICS DEBUG screen. The
  3134.   .DLL file will also run on a normal non-animated terminal.
  3135.  
  3136.                                                              3
  3137.   USE OF CICSRGRP.
  3138.  
  3139.   When CICS is initialised it is important to  understand  how
  3140.   control table entries are loaded.
  3141.  
  3142.   ∙     SIT  - The last entry is always used regardless of the
  3143.       number of
  3144.           entries specified.
  3145.  
  3146.   ∙    ALL OTHERS - If CICSRGRP is not specified and an  entry
  3147.       exists in
  3148.           more  than  one  group the alphabetically highest is
  3149.       loaded.
  3150.           If CICSRGRP  is  specified  the  groups  are  loaded
  3151.       alphabetically,
  3152.           regardless   of   the   order  in  which  they  were
  3153.       specified.  If
  3154.           an entry exists in more than one  of  the  specified
  3155.       groups the
  3156.           alphabetically higher is loaded.
  3157.  
  3158.   ECI SAMPLE PROGRAMS.
  3159.  
  3160.   The  ECI  sample  programs  FAADECIC.CCS  and  FAAECIP.C  as
  3161.   described in the CICS OS/2  System  and  Application  Guide,
  3162.   (SC33-0616-3), page 334, are being shipped in PTF10.
  3163.  
  3164.   Please  note  that  in the CICS OS/2 Systems and Application
  3165.   Guide (SC33-0616-3), page 334. The paragraph reading :-
  3166.  
  3167.   The sample C language program is not listed  in  this  book.
  3168.   It  is provided in the program FAADECIC.CCS.  This calls the
  3169.   OS/2 program FAAECIP.C, which is also provided.
  3170.  
  3171.   Should read :-
  3172.  
  3173.   The sample C language program is not listed  in  this  book.
  3174.   It is provided in the program FAADECIC.CCS.  This is invoked
  3175.   by the OS/2 program FAAECIP.C, which is also provided.
  3176.  
  3177.  
  3178.  
  3179.     **************************************************************
  3180.     **************************************************************
  3181.     ***                                                        ***
  3182.     ***                   End of PTF 10 updates.               ***
  3183.     ***             Updates for previous PTFs follow.          ***
  3184.     ***                                                        ***
  3185.     **************************************************************
  3186.     **************************************************************
  3187.  
  3188.                                                              i
  3189.                                                 README.TXT FOR
  3190.                                CICS OS/2 1.2.0 SERVICE LEVEL 8
  3191.  
  3192.                                                   18 July 1991
  3193.  
  3194.  
  3195.   TABLE OF CONTENTS
  3196.   _________________
  3197.  
  3198.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  3199.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  3200.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  3201.       PROBLEMS while Deleting CVT entries using CEDA   . . . 1
  3202.       Using User Trace Points to trace Application Program
  3203.        Flow  . . . . . . . . . . . . . . . . . . . . . . . . 2
  3204.       GDDM not Supported by CICS OS/2  . . . . . . . . . . . 2
  3205.       New Information APAR   . . . . . . . . . . . . . . . . 2
  3206.     Hints and other information.   . . . . . . . . . . . . . 3
  3207.       Changes due to fix for APAR PL70072  . . . . . . . . . 3
  3208.       Communications Setup   . . . . . . . . . . . . . . . . 3
  3209.       Information on User Exits 01 and 11  . . . . . . . . . 4
  3210.       Additional Trace Point Information due to fix for APAR
  3211.        PL70085   . . . . . . . . . . . . . . . . . . . . . . 6
  3212.       Information for WSU on a 3151/61 U.S Keyboard  . . . . 6
  3213.  
  3214.  
  3215.                                                              1
  3216.   INTRODUCTION
  3217.   ____________
  3218.  
  3219.   This README contains information on:
  3220.  
  3221.       changes due to fix for APAR PL70072;
  3222.  
  3223.       a new CICSCFG.INF file for assisting with Communications
  3224.       Setup;
  3225.  
  3226.       additional trace point information due to fix  for  APAR
  3227.       PL70085;
  3228.  
  3229.   plus the information from the latest information APAR.
  3230.  
  3231.   CURRENT LEVEL
  3232.   _____________
  3233.  
  3234.   The current level of CICS OS/2 is 1.2.0. Service Level 8.
  3235.  
  3236.   IIAPAR INFORMATION
  3237.   __________________
  3238.  
  3239.   The  following  is  the  latest  from  information  APAR No.
  3240.   ii04935:
  3241.  
  3242.   PROBLEMS WHILE DELETING CVT ENTRIES USING CEDA
  3243.  
  3244.   1.  Adding a key type (K) sequence number table entry can be
  3245.       done as normal
  3246.  
  3247.       a.  The message  "FAA4818I  RECORD  ADDED  SUCCESSFULLY.
  3248.           PRESS ENTER." appears.
  3249.  
  3250.               Pressing  <ENTER>  key  will  produce  a message
  3251.               "FAA4821E INCONSISTENT TABLE UPDATE"
  3252.  
  3253.               Pressing <F3> key will return the  user  to  the
  3254.               previous level of menu without error.
  3255.  
  3256.       b.  The   new   table   entry   will  not,  however,  be
  3257.           displayed!!
  3258.  
  3259.       c.  By pressing <F3> again to return to  the  main  CEDA
  3260.           menu  and then re-selecting the "CVT" option the new
  3261.           entry will be visible.
  3262.  
  3263.   2.  Deleting a key type (K) sequence number table entry  can
  3264.       be done as follows:
  3265.  
  3266.       a.  Select   the  item  to  be  deleted  using  the  "/"
  3267.           character and press <F10> to activate the option bar
  3268.           at the top of screen
  3269.                                                              2
  3270.  
  3271.       b.  Select  the  update  option.  (YES  UPDATE  AND  NOT
  3272.           DELETE!!)
  3273.  
  3274.       c.  When the table entry is displayed for updating
  3275.  
  3276.               Set "NO. OF TEMPLATE ENTRIES " to '0' (ZERO)
  3277.  
  3278.               Erase  all  "TYPE", "OFFSET" AND "LENGTH" fields
  3279.               to (BLANKS)
  3280.  
  3281.  
  3282.       d.  Press <ENTER> key to perform changes.
  3283.  
  3284.       e.  Message "FAA4819I RECORD UPDATED SUCCESSFULLY. PRESS
  3285.           ENTER..." is displayed on the screen.
  3286.  
  3287.               If  the <ENTER> key is pressed message "FAA4821E
  3288.               INCONSISTENT TABLE UPDATE" is displayed.
  3289.  
  3290.               If however <F3> is displayed  the  user  returns
  3291.               successfully to previous level of menu.
  3292.  
  3293.       f.  The table entry should have been deleted OK.
  3294.  
  3295.   USING USER TRACE POINTS TO TRACE APPLICATION PROGRAM FLOW
  3296.  
  3297.   It is possible to use the CICS OS/2 trace CTRA to trace user
  3298.   trace  points  in an application to assist de-bugging.  This
  3299.   is done by placing:
  3300.  
  3301.      EXEC CICS ENTER TRACEID(nnn) FROM(aaaabbbb)
  3302.  
  3303.   statements in the user application. These trace  points  can
  3304.   then be seen in the trace file FAATAFEN.TRC as follows:
  3305.  
  3306.      MAJ. ENTRY  01M01 0072 0000  <--- ENTER stmt
  3307.      BASIC EVENT 01M21 F      T   <--- FROM & TRACEID
  3308.      BASIC EVENT 01M22
  3309.      MAJ. EVENT  UFnnn aaaa bbbb  <-- User data
  3310.      MAJ. EXIT   01M06 .... ....
  3311.  
  3312.   If  the  RESOURCE  option is used on the ENTER statement the
  3313.   trace point is 'UR'
  3314.  
  3315.   GDDM NOT SUPPORTED BY CICS OS/2
  3316.  
  3317.   It  should  be  noted  that  although  host  CICS   supports
  3318.   transactions  containing  GDDM  calls  -  CICS OS/2 does NOT
  3319.   support the level of data stream required by GDDM  therefore
  3320.   it  is  not  possible to transaction route from CICS OS/2 to
  3321.   host CICS - run a GDDM  transaction  -  and  then  have  the
  3322.   output displayed back on the CICS OS/2 PWS.
  3323.  
  3324.   NEW INFORMATION APAR
  3325.  
  3326.   Information  APARs  will  be  entered  on RETAIN as and when
  3327.   required.
  3328.  
  3329.                                                              3
  3330.   HINTS AND OTHER INFORMATION.
  3331.   ____________________________
  3332.  
  3333.   CHANGES DUE TO FIX FOR APAR PL70072
  3334.  
  3335.   APAR PL70072 rationalises the data written to transient data
  3336.   (TD) queue 'CSCS' by transactions 'CESN' and 'CSSF' and adds
  3337.   the terminal ID to this data.
  3338.  
  3339.   The format of the data written is:
  3340.  
  3341.   1.  Transaction ID - 12 characters
  3342.  
  3343.   2.  User ID - 8 characters
  3344.  
  3345.   3.  Terminal ID - 4 characters
  3346.  
  3347.   4.  System ID - 4 characters - For LU TYPE 2 connections.
  3348.  
  3349.   5.  Date - 00YYDDD+ (packed decimal EIB format)
  3350.  
  3351.   6.  Time - 0HHMMSS+ (packed decimal EIB format)
  3352.  
  3353.   The transaction ID will be:
  3354.  
  3355.       'CESN        '
  3356.  
  3357.       'CSSF        '
  3358.  
  3359.       'CSSF LOGOFF '
  3360.  
  3361.   COMMUNICATIONS SETUP
  3362.  
  3363.   A file is provided, CICSCFG.INF, in the OS2DSD sub-directory
  3364.   that   provides  information  about  setting  up  CICS  OS/2
  3365.   communications for both APPC and NetBIOS.
  3366.  
  3367.   This file is in OS/2 IPF format and can be viewed on OS/2 EE
  3368.   1.2 or later by using the OS/2 VIEW command.
  3369.       E.G
  3370.                        VIEW CICSCFG
  3371.  
  3372.  
  3373.                                                              4
  3374.   Information on User Exits 01 and 11.      Program FAAEXP01.
  3375.   -----------------------------------------------------------
  3376.  
  3377.   This sample exit module is distributed with CICS OS/2, and
  3378.   provides a mechanism to modify the terminal name as seen by
  3379.   a remote CICS system.
  3380.  
  3381.   The sample as distributed with the base CICS OS/2 System,
  3382.   Version 1.2, only supported outbound operations and was
  3383.   invoked by Exit 01.  The sample used the first character of
  3384.   the local terminal name and the last three characters of the
  3385.   connection netname to form a new terminal name for the
  3386.   remote system.  The CICS OS/2 terminal name remained
  3387.   unchanged.
  3388.  
  3389.   With Service Level 8 the terminal renaming function has been
  3390.   extended to support both outbound and inbound operations.
  3391.   The exit is called on outbound operations, as EXIT 01, and
  3392.   modifies the terminal name as seen by the remote system.  It
  3393.   is also called on inbound operations as EXIT 11.  EXIT 11
  3394.   must be able to reverse the work performed in EXIT 01.
  3395.  
  3396.  
  3397.   EXIT 01.
  3398.  
  3399.   This exit is called for both function shipping and
  3400.   transaction routing outbound.  The supplied sample code will
  3401.   only change the outbound name if the last three characters
  3402.   of the name are '123' as in 'V123'.
  3403.  
  3404.  
  3405.   EXIT 11.
  3406.  
  3407.   This exit is called by the mirror transaction (CPMI or CVMI)
  3408.   and by the service transaction CRSR.  The supplied sample
  3409.   code will, in this case, force the last three characters of
  3410.   the inbound terminal name to '123', if the last three
  3411.   characters of the inbound target terminal name are the same
  3412.   as the last three characters of the connection netname.
  3413.   This will complete the round trip for an aliased terminal
  3414.   name.
  3415.  
  3416.  
  3417.   An example.
  3418.  
  3419.   Consider an EXEC CICS START command, with data, to terminal
  3420.   V123 for a transaction defined on a remote system with a
  3421.   connection netname of SYSXYZ.  This will invoke three
  3422.   distinct steps.
  3423.  
  3424.   Step 1 will function ship the Start request to SYSXYZ
  3425.   calling EXIT 01.  EXIT 01, in this example, will change the
  3426.   terminal ID from V123 to VXYZ and the start will be
  3427.   scheduled on the remote system.
  3428.  
  3429.                                                              5
  3430.   Step 2 occurs when the start time is reached.  The
  3431.   transaction CRSR ships the AID (Automatic Initiate
  3432.   Descriptor) to the local system to start the original
  3433.   transaction on terminal VXYZ.  EXIT 11 is called and it
  3434.   modifies the terminal ID back to V123 so that it can be
  3435.   attached locally.
  3436.  
  3437.   Step 3 is invoked when the transaction route is actually
  3438.   started locally for V123.  EXIT 01 is called and modifies
  3439.   the outbound name back to VXYZ.  When the remote system
  3440.   attaches the transaction to the remote entry for VXYZ it
  3441.   associates the original data that was function shipped and
  3442.   the transaction runs normally.
  3443.  
  3444.  
  3445.   Note in this sample EXIT the distributed local terminal id
  3446.   V124 will not be changed either inbound or outbound.  If it
  3447.   is used for communicating with other CICS systems it must
  3448.   therefore be unique, network wide, for all involved systems.
  3449.   A user exit could generate a unique alias name for any local
  3450.   terminal id involved with remote communications.
  3451.  
  3452.  
  3453.   Additional Considerations.
  3454.  
  3455.   Caution should be exercised in designing this exit program.
  3456.   On the outbound side it requires to be able to distinguish
  3457.   between terminals that must be aliased and those that
  3458.   probably should not be alaised.  Terminal definitions that
  3459.   are shipped into the local environment probably should not
  3460.   be alaised.  This would be the case if during problem
  3461.   determination a host terminal definition was shipped to the
  3462.   local system in support of a CRTE session.  On the inbound
  3463.   side EXIT 11 must recognise the names that EXIT 01 has
  3464.   shipped to remote systems and be able to convert them back
  3465.   to the correct local name.  Existing network naming
  3466.   standards and the name space constraints of four characters
  3467.   will dictate the best way to handle this EXIT set.
  3468.  
  3469.   One alternative is to not use the EXIT 01/11 set, and to
  3470.   have all terminal names unique within the CICS network.
  3471.  
  3472.                                                              6
  3473.  
  3474.   ADDITIONAL TRACE POINT INFORMATION DUE TO FIX FOR APAR
  3475.   PL70085
  3476.  
  3477.     Trace Point   :   35T11
  3478.     Data output   :   Parameter1 -  All zeroes
  3479.                       Parameter2 -  All zeroes
  3480.     Purpose       :   Enter 3270 Initialise Screen
  3481.     Type          :
  3482.  
  3483.     Trace Point   :   35T21
  3484.     Data output   :   Parameter1 - display height 4 bytes hex
  3485.                         Parameter2 - display width 4 bytes hex
  3486.     Purpose       :   Create Presentation Space
  3487.     Type          :
  3488.  
  3489.     Trace Point   :   35T22
  3490.     Data output   :   Parameter1 - format id  4 bytes hex
  3491.                       Parameter2 - display attributes 4 bytes hex
  3492.     Purpose       :   Create Presentation Space - cont.
  3493.     Type          :
  3494.  
  3495.     Trace Point   :   35T23
  3496.     Data output   :   Parameter1 - code page 4 bytes hex
  3497.                       Parameter2 - All zeroes
  3498.     Purpose       :   Specify Code Page.
  3499.     Type          :
  3500.  
  3501.     Trace Point   :   35T24
  3502.     Data output   :   Parameter1 - Cell_Size.x 2 bytes hex
  3503.                                          Cell_Size.y 2 bytes hex
  3504.                       Parameter2 - All zeroes
  3505.     Purpose       :   Device Cell Size.
  3506.     Type          :
  3507.  
  3508.     Trace Point   :   35T13
  3509.     Data output   :   Parameter1 - Return Code
  3510.                       Parameter2 - All zeroes
  3511.     Purpose       :   Exit 3270 Initialise Screen.
  3512.     Type          :
  3513.  
  3514.  
  3515.  INFORMATION FOR WSU ON A U.S 3151/61 KEYBOARD.
  3516.  
  3517.  In order to use the keyboard sequence 'CTRL' & numeric keypad
  3518.  '+' on a U.S 3151/61 keyboard under Work Station set Up (WSU),
  3519.  the following must be performed:
  3520.  Change the 'Break Signal' field on the Communications page of
  3521.  the 3151 setup to 'DISABLE'.
  3522.  This only applys to U.S 3151/61 keyboards when the 'CTRL' & '+'
  3523.  is defined under CICS OS/2 Work Station set Up.
  3524.  
  3525.  
  3526.  
  3527.  
  3528.     **************************************************************
  3529.     **************************************************************
  3530.     ***                                                        ***
  3531.     ***                   End of PTF 8 updates.                ***
  3532.     ***             Updates for previous PTFs follow.          ***
  3533.     ***                                                        ***
  3534.     **************************************************************
  3535.     **************************************************************
  3536.  
  3537.  
  3538.                                                              i
  3539.                                                 README.TXT FOR
  3540.                                CICS OS/2 1.2.0 SERVICE LEVEL 7
  3541.  
  3542.                                                  17 April 1991
  3543.  
  3544.  
  3545.   TABLE OF CONTENTS
  3546.   _________________
  3547.  
  3548.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  3549.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  3550.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  3551.       NetBios and CICS OS/2 Performance Problems   . . . . . 1
  3552.       Use of CICSRGRP  . . . . . . . . . . . . . . . . . . . 1
  3553.       New Information APAR   . . . . . . . . . . . . . . . . 2
  3554.     Hints and other information.   . . . . . . . . . . . . . 2
  3555.  
  3556.  
  3557.                                                              1
  3558.   INTRODUCTION
  3559.   ____________
  3560.  
  3561.   This README contains information from the latest information
  3562.   APAR.
  3563.  
  3564.   CURRENT LEVEL
  3565.   _____________
  3566.  
  3567.   The current level of CICS OS/2 is 1.2.0. Service Level 7.
  3568.  
  3569.   IIAPAR INFORMATION
  3570.   __________________
  3571.  
  3572.   The  following  is  the  latest  from  information  APAR No.
  3573.   ii04748:
  3574.  
  3575.   NETBIOS AND CICS OS/2 PERFORMANCE PROBLEMS
  3576.  
  3577.   Users of  CICS  OS/2  communicating  over  token  ring  with
  3578.   NetBios  may experience performance problems. the problem is
  3579.   known.
  3580.  
  3581.   The solution is to install OS/2 1.2 CSD 4098 or OS/2 1.3.
  3582.  
  3583.   USE OF CICSRGRP
  3584.  
  3585.   When CICS OS/2 is initialised,  if  a  control  table  entry
  3586.   exists  in  more  than  one group, the alphabetically higher
  3587.   entry is always used. This may cause  confusion  when  using
  3588.   CICSRGRP to control loading of tables. If an entry is in two
  3589.   groups  and  both groups are selected, the last entry in the
  3590.   control file is always loaded, regardless of the group order
  3591.   in CICSRGRP.
  3592.  
  3593.   For example:
  3594.  
  3595.                    FAACTFTB PCT entries:
  3596.  
  3597.                             Trans   Group     Sysid
  3598.                             -----   ------    -----
  3599.                             MENU    REMOTE    SYSR
  3600.                             MENU    FAAIVP
  3601.  
  3602.   If CICS OS/2 is loaded without CICSGRP set, MENU  is  loaded
  3603.   from group FAAIVP.
  3604.  
  3605.   If    CICS   OS/2   is   loaded   with   CICSRGRP   set   to
  3606.   FAASYS,...,FAAIVP,REMOTE, MENU is still loaded from FAAIVP.
  3607.  
  3608.   The only way to load MENU from the REMOTE group is to remove
  3609.   FAAIVP from to CICSRGRP list.
  3610.  
  3611.   Note. The SAG indicates that a message is issued if it finds
  3612.   an entry in more than one group, this is NOT true.
  3613.  
  3614.                                                              2
  3615.   NEW INFORMATION APAR
  3616.  
  3617.   The new information APAR is ii04935
  3618.  
  3619.  
  3620.   HINTS AND OTHER INFORMATION.
  3621.   ____________________________
  3622.  
  3623.     EXTRA TRACE POINTS
  3624.  
  3625.           The  trace  points  listed  below  are new with APAR
  3626.   PL77762
  3627.  
  3628.   ┌─────────┬────────────┬─────────────────────────────────────────────┐
  3629.   │ TRACE   │ MODULE     │ MODULE DESCRIPTION                          │
  3630.   │ ID      │ NAME       │                                             │
  3631.   │ 01      │ FAASRSML   │ Server mainline                             │
  3632.   ├─────────┼────────────┴─────────┬─────────────────┬─────────────────┤
  3633.   │ TYPE    │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  3634.   │ POINT   │                      │                 │                 │
  3635.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  3636.   │ TV M18  │ Program Stack Push   │ New program     │ COMMAREA Size   │
  3637.   │         │ Completion           │   level         │ BLL-Cell count  │
  3638.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  3639.   │ TV M19  │ Program Stack Pop    │ New program     │ COMMAREA Size   │
  3640.   │         │ Completion           │   level         │                 │
  3641.   │         │                      │                 │ HANDLE-ABEND:   │
  3642.   │         │                      │                 │ P-Program       │
  3643.   │         │                      │                 │ L-Label,        │
  3644.   │         │                      │                 │   I-Inactive    │
  3645.   │         │                      │                 │   A-Active      │
  3646.   │         │                      │                 │   D-Deactivated │
  3647.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  3648.   │ TV M45  │ Save working storage │ Length of       │ PPT Index       │
  3649.   │         │                      │ Working Storage │                 │
  3650.   │         │                      │                 │ Flag: T-temp    │
  3651.   │         │                      │ Module Handle   │      P-Resident │
  3652.   │         │                      │                 │      C-called   │
  3653.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  3654.   │ TV M46  │ Restore              │ Length of       │ PPT Index       │
  3655.   │         │      working storage │ Working Storage │                 │
  3656.   │         │                      │                 │ Flag: T-temp    │
  3657.   │         │                      │ Module Handle   │      P-Resident │
  3658.   │         │                      │                 │      C-called   │
  3659.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  3660.  
  3661.  
  3662.  
  3663.  
  3664.     **************************************************************
  3665.     **************************************************************
  3666.     ***                                                        ***
  3667.     ***                   End of PTF 7 updates.                ***
  3668.     ***             Updates for previous PTFs follow.          ***
  3669.     ***                                                        ***
  3670.     **************************************************************
  3671.     **************************************************************
  3672.  
  3673.                                                              i
  3674.                                                 README.TXT FOR
  3675.                                CICS OS/2 1.2.0 SERVICE LEVEL 6
  3676.  
  3677.                                                   3 March 1991
  3678.  
  3679.  
  3680.   TABLE OF CONTENTS
  3681.   _________________
  3682.  
  3683.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  3684.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  3685.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  3686.       New CICSRUN.CMD Environment Variable use   . . . . . . 1
  3687.       TRAP000D using CECI w/FC Commands  . . . . . . . . . . 2
  3688.       UNEXPECTED REVERSE VIDEO FIELDS IN BMS MAPS  . . . . . 2
  3689.       Using CICS OS/2 with MICROFOCUS COBOL/2 2.4.XX Level   2
  3690.       New Information APAR   . . . . . . . . . . . . . . . . 2
  3691.     Hints and other information.   . . . . . . . . . . . . . 2
  3692.  
  3693.  
  3694.                                                              1
  3695.   INTRODUCTION
  3696.   ____________
  3697.  
  3698.   Nil.
  3699.  
  3700.   CURRENT LEVEL
  3701.   _____________
  3702.  
  3703.   The current level of CICS OS/2 is 1.2.0. Service Level 6
  3704.  
  3705.   IIAPAR INFORMATION
  3706.   __________________
  3707.  
  3708.   The  following  is  the  latest  from  information  APAR No.
  3709.   ii04748:
  3710.  
  3711.   NEW CICSRUN.CMD ENVIRONMENT VARIABLE USE
  3712.  
  3713.   With the release of PTF04 (UL85512/UL85513) there is  a  new
  3714.   CICSRUN.CMD  file.  This  file  is designed to be compatible
  3715.   with the CICSRUN.CMD file released with earlier versions  of
  3716.   CICS  OS/2.  (If  you  have  made  changes  to your existing
  3717.   CICSRUN.CMD you may also need to make those changes  to  the
  3718.   new version.)
  3719.  
  3720.   This  new version of CICSRUN.CMD is designed to be used with
  3721.   two new files (CICSENV.CMD and CICSDEV.CMD) which  are  used
  3722.   to  define  all  the  environment  variables  that CICS OS/2
  3723.   requires in a run-time and development systems respectively.
  3724.  
  3725.   All new users to CICS OS/2 will use these files.
  3726.  
  3727.   Existing users  who  wish  to  take  advantage  of  the  new
  3728.   mechanism  will  need  to  perform CICSINST for the complete
  3729.   system.
  3730.  
  3731.   The new files are *NOT* created by the  application  of  the
  3732.   PTF alone (CICSINST /PTF).
  3733.  
  3734.   HOST TO CICS OS/2 COMMUNICATIONS.
  3735.  
  3736.   When  communicating from Host CICS to CICS OS/2 users should
  3737.   be aware that certain OEM (Third  Party)  Security  Products
  3738.   may prevent correct operation.
  3739.  
  3740.   Host security packages which modify ISC and MRO requests may
  3741.   have these requests rejected by CICS OS/2.
  3742.  
  3743.   If the request is not a standard CICS formatted request.
  3744.  
  3745.   For  example  some  products append a USERID Profile Message
  3746.   which causes the request to be rejected by CICS OS/2.
  3747.  
  3748.   Consult your OEM supplier for more information.
  3749.  
  3750.                                                              2
  3751.   TRAP000D USING CECI W/FC COMMANDS
  3752.  
  3753.   It  is  possible  to  get  TRAP00D  when  using   the   CECI
  3754.   transaction  with  File  Control  Commands  when routing the
  3755.   command to a remote system. This occurs due to a  too  large
  3756.   length  or  length  value  being  used  such  as data or key
  3757.   length.    The  following  circumstances  can  produce   the
  3758.   problem:
  3759.  
  3760.  
  3761.   1.  file with record length greater than 100 and &data not
  3762.          set explicitly but left to default.
  3763.  
  3764.   2.  key  length  set  incorrectly  (key  length  is  4)  for
  3765.       instance:
  3766.  
  3767.       a.  keyl(&k)
  3768.  
  3769.       b.  &k 4
  3770.  
  3771.           this results in &k being set to a large value  -  it
  3772.           should be set as follows:
  3773.  
  3774.       c.  keyl(&k)
  3775.  
  3776.       d.  &k h
  3777.  
  3778.       e.  &k +00004
  3779.  
  3780.   UNEXPECTED REVERSE VIDEO FIELDS IN BMS MAPS
  3781.  
  3782.   If  fields in your BMS maps are set to (for example) reverse
  3783.   video when you did not expect it, check that  you  have  set
  3784.   the  map  I/O  buffer  to low   values to initialise the map
  3785.   attributes before the send map command.
  3786.  
  3787.   USING CICS OS/2 WITH MICROFOCUS COBOL/2 2.4.XX LEVEL
  3788.  
  3789.   When using both CICS OS/2 and MICROFOCUS COBOL/2 at a 2.4.XX
  3790.   level, the COBLIB.DLL files provided by the 2  products  are
  3791.   different.
  3792.  
  3793.   CICS  OS/2 can run happily with the newer MICROFOCUS COBOL/2
  3794.   level of the file,  but  MICROFOCUS  COBOL/2  may  not  work
  3795.   correctly with the older level supplied with CICS OS/2.
  3796.  
  3797.   The  solution is to remove the CICS OS/2 version of the file
  3798.   from the LIBPATH, and use solely the  new  MICROFOCUS  COBOL
  3799.   version.
  3800.  
  3801.   Symptoms include a 165 Load Error from COBOL. NOTE that this
  3802.   problem is not the only possible cause of a 165 load error.
  3803.  
  3804.   NEW INFORMATION APAR
  3805.  
  3806.   The current information APAR will remain open.
  3807.  
  3808.   HINTS AND OTHER INFORMATION.
  3809.   ____________________________
  3810.  
  3811.   Nil.
  3812.  
  3813.  
  3814.     **************************************************************
  3815.     **************************************************************
  3816.     ***                                                        ***
  3817.     ***                   End of PTF 6 updates.                ***
  3818.     ***             Updates for previous PTFs follow.          ***
  3819.     ***                                                        ***
  3820.     **************************************************************
  3821.     **************************************************************
  3822.  
  3823.  
  3824.                                                              i
  3825.                                                 README.TXT FOR
  3826.                                CICS OS/2 1.2.0 SERVICE LEVEL 5
  3827.  
  3828.                                              11th January 1991
  3829.  
  3830.   TABLE OF CONTENTS
  3831.   _________________
  3832.  
  3833.     Introduction   . . . . . . . . . . . . . . . . . . . . . 1
  3834.     Current Level  . . . . . . . . . . . . . . . . . . . . . 1
  3835.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  3836.       Known Restriction with number of Files   . . . . . . . 1
  3837.       Using CICS OS22 and the Animator   . . . . . . . . . . 1
  3838.       OS/2 SE and EE VERSION 1.3   . . . . . . . . . . . . . 1
  3839.       FAA1648S Screen File Open Error  . . . . . . . . . . . 2
  3840.       MSG. L2029 on link of 'C' Application Program  . . . . 2
  3841.       New Information APAR   . . . . . . . . . . . . . . . . 2
  3842.     Hints and other information.   . . . . . . . . . . . . . 2
  3843.  
  3844.  
  3845.  
  3846.                                                              1
  3847.   INTRODUCTION
  3848.   ____________
  3849.  
  3850.   Nil.
  3851.  
  3852.   CURRENT LEVEL
  3853.   _____________
  3854.  
  3855.   The current level of CICS OS/2 is 1.2.0. Service Level 5.
  3856.  
  3857.   IIAPAR INFORMATION
  3858.   __________________
  3859.  
  3860.   The  following  is  the  latest  from  information  APAR No.
  3861.   II04598:
  3862.  
  3863.   KNOWN RESTRICTION WITH NUMBER OF FILES
  3864.  
  3865.   There is a known restriction within CICS OS/2 that:
  3866.  
  3867.       1 recoverable transaction can have a maximum 12 (twelve)
  3868.       recoverable files.
  3869.  
  3870.   this restriction does not apply to unrecoverable files.
  3871.  
  3872.   USING CICS OS22 AND THE ANIMATOR
  3873.  
  3874.   When trying to run CICS OS/2 with Animator to debug (CICSRUN
  3875.   /D-V123(ANIM)). Problems can occur if the  'COBOL.DIR'  file
  3876.   contains the statement 'ANIM'.
  3877.  
  3878.   This  is  caused by Animator becoming confused by two 'ANIM'
  3879.   statements. ie.  one  in  COBOL.DIR  and  one  part  of  the
  3880.   CICSRUN.
  3881.  
  3882.   The symptoms for this scenario vary from version to version:
  3883.  
  3884.       error: cannot specify ANIM and RNIM
  3885.  
  3886.       Animator invalid directive
  3887.  
  3888.       CICS OS/2 debug session terminates abnormally.
  3889.  
  3890.   MICROFOCUS are aware of the problem.
  3891.  
  3892.   OS/2 SE AND EE VERSION 1.3
  3893.  
  3894.   In  order  to  run  with either of the above versions of the
  3895.   operating system, CICS OS/2 must have PTF04 applied, ie:
  3896.  
  3897.       UL85512 for a MVS host;
  3898.  
  3899.       UL85513 for a VSE host.
  3900.  
  3901.                                                              2
  3902.  
  3903.   FAA1648S SCREEN FILE OPEN ERROR
  3904.  
  3905.   On initial start up of CICS  OS/2  after  installation  this
  3906.   message  may  occur  if  your  current  default  is  not the
  3907.   CICS120\OS2DSD SUB-DIRECTORY.  ie.
  3908.  
  3909.       C:> CICS120\OS2DSD\CICSRUN
  3910.  
  3911.        INSTEAD OF
  3912.  
  3913.       C:> CD CICS120\OS2DSD
  3914.  
  3915.       C:> CICSRUN
  3916.  
  3917.   To resolve this do the following:
  3918.  
  3919.       start CICS OS/2 from the correct default
  3920.  
  3921.       using  CEDA amend the FCT entry for file FAAMSFSC.BTR to
  3922.       include a full directory path name.
  3923.  
  3924.   You should then be able to start CICS from any sub-directory
  3925.   (after the next start of CICS!)
  3926.  
  3927.   MSG. L2029 ON LINK OF 'C' APPLICATION PROGRAM
  3928.  
  3929.   If the following messages are issued during the  link  phase
  3930.   when using CICSCLNK or CICSCTCL:
  3931.  
  3932.       "... ERROR L2029 : '_FAAMAIN' : UNRESOLVED EXTERNAL"
  3933.  
  3934.       "... ERROR L2029 : '_FAAINIT' : UNRESOLVED EXTERNAL"
  3935.  
  3936.   The  possibility  should  be  investigated  that  during the
  3937.   translate phase (using  CICSCTRN  or  CICSCTCL)  the  'MAIN'
  3938.   option  was  not specified for a MAIN() program. For further
  3939.   information see SC33-0616-2 SAG page 325.
  3940.  
  3941.   NEW INFORMATION APAR
  3942.  
  3943.   The new information APAR is ii04748.
  3944.  
  3945.   HINTS AND OTHER INFORMATION.
  3946.   ____________________________
  3947.  
  3948.   Nil.
  3949.  
  3950.  
  3951.  
  3952.     **************************************************************
  3953.     **************************************************************
  3954.     ***                                                        ***
  3955.     ***                   End of PTF 5 updates.                ***
  3956.     ***             Updates for previous PTFs follow.          ***
  3957.     ***                                                        ***
  3958.     **************************************************************
  3959.     **************************************************************
  3960.  
  3961.                                                              i
  3962.                                                 README.TXT FOR
  3963.                                CICS OS/2 1.2.0 SERVICE LEVEL 4
  3964.  
  3965.                                                9 November 1990
  3966.  
  3967.  
  3968.   TABLE OF CONTENTS
  3969.   _________________
  3970.  
  3971.     Introduction   . . . . . . . . . . . . . . . . . . . . . .
  3972.     Current Level  . . . . . . . . . . . . . . . . . . . . . .
  3973.     iiAPAR Information   . . . . . . . . . . . . . . . . . . 1
  3974.       Service Installation Documentation   . . . . . . . . . 1
  3975.       TRAP000C on CICSRUN start up   . . . . . . . . . . . . 1
  3976.       CICS OS/2 not releasing DLLS.  . . . . . . . . . . . . 2
  3977.       CICSHELP - F3 / 'THAT KEYSTROKE HAS NO MEANING'  . . . 2
  3978.       TRAP 000D during STARTUP / INITIALISATION of CICS OS/2 2
  3979.       MSGDFH4412 'INVALID TRANSID' when TRANSACTION ROUTING  3
  3980.       LINKEDIT MESSAGE L2022 when using CICSTCL  . . . . . . 3
  3981.       ERROR MESSAGES when starting CICS OS/2 in LAN SERVER
  3982.        ENVIRONMENT   . . . . . . . . . . . . . . . . . . . . 3
  3983.       3151 ASCII TERMINAL SUPPORT in CICS OS/2   . . . . . . 4
  3984.       3270 Data Streams (EBCDIC Coordinates)   . . . . . . . 4
  3985.       New Information APAR   . . . . . . . . . . . . . . . . 4
  3986.     Hints and other information.   . . . . . . . . . . . . . 5
  3987.       New Start-up Methodology   . . . . . . . . . . . . . . 5
  3988.       New Message (to assist with problem resolution)  . . . 6
  3989.       Reporting problems via IBM Level 1 and PMR   . . . . . 7
  3990.       Communications Setup   . . . . . . . . . . . . . . . . 7
  3991.       User Exits - FAAEXP02 and FAAEXP04 . . . . . . . . . . 7
  3992.       'Cooperative Processing with CICS OS/2'  . . . . . . . 7
  3993.     Trace Points   . . . . . . . . . . . . . . . . . . . . . 8
  3994.     Function Number  . . . . . . . . . . . . . . . . . . .  13
  3995.  
  3996.                                                              1
  3997.   INTRODUCTION
  3998.   ____________
  3999.  
  4000.   In  future  service deliverables of CICS OS/2 the README.TXT
  4001.   file  will  contain   considerably   more   information   if
  4002.   necessary.    The  README  file  will  be used as a means of
  4003.   keeping you updated with the very  latest  information  plus
  4004.   any  additional  documentary  information that the CICS OS/2
  4005.   Development team wish to release.
  4006.  
  4007.   Each README
  4008.  
  4009.       will contain a reference to an existing information APAR
  4010.       that customers and IBM SEs  may  reference  through  IBM
  4011.       level  1  support. This information APAR will be updated
  4012.       by CICS  OS/2  developers  and  Service  team  and  will
  4013.       contain  tips, hints, work-arounds and other fixes which
  4014.       may be relevant to the customer.
  4015.  
  4016.       will also contain details from the previous  information
  4017.       APAR.
  4018.  
  4019.   Each  new  information  APAR will contain a reference to the
  4020.   previous information APAR. Thus users will be able to  chain
  4021.   through the existing information APARs.
  4022.  
  4023.   CURRENT LEVEL
  4024.   _____________
  4025.  
  4026.   The current level of CICS OS/2 is 1.2.0. Service Level 4.
  4027.  
  4028.  
  4029.   IIAPAR INFORMATION
  4030.   __________________
  4031.  
  4032.   The  following  is  the  latest  from  information  APAR No.
  4033.   II04482:
  4034.  
  4035.   oo  SERVICE INSTALLATION DOCUMENTATION
  4036.  
  4037.   Chapter 9 Page 59 Point 5 for MVS host systems
  4038.    reads
  4039.  
  4040.      receive faaptfnn.cmd a:'cics120.cmd(faaptfnn)'
  4041.  
  4042.   should read
  4043.  
  4044.      receive faaptfnn.cmd a:'cics120.mts(faaptfnn)'
  4045.  
  4046.   oo  TRAP000C ON CICSRUN START UP
  4047.  
  4048.   If CONFIG.SYS contains line IOPL=NO this causes CICS OS/2 to
  4049.   trap 000c stack segment error when started with CICSRUN.
  4050.  
  4051.   solution:  SET IOPL=YES
  4052.  
  4053.                                                              2
  4054.   oo  CICS OS/2 NOT RELEASING DLLS.
  4055.  
  4056.   There  are some cases when the DLLs are not released by CICS
  4057.   OS/2 after successful completion of the transaction. This is
  4058.   because of compatibility problems between different versions
  4059.   of the COBOL compiler.  Programs compiled with the IBM COBOL
  4060.   1.02 compiler do not get unloaded after being run.
  4061.  
  4062.   oo  CICSHELP - F3 / 'THAT KEYSTROKE HAS NO MEANING'
  4063.  
  4064.   This occurs because you have run  CICSHELP  outside  of  the
  4065.   correct  directory  -  to  avoid  this run CICSHELP from the
  4066.   directory CICS120/OS2DSD - F3 will then work correctly.   If
  4067.   you  do  run  CICSHELP  outside  the  correct  directory use
  4068.   CTRL-BREAK to exit from the help panel.
  4069.  
  4070.   oo  TRAP 000D DURING STARTUP / INITIALISATION OF CICS OS/2
  4071.  
  4072.   Problems  can  arise  due  to  the  incorrect   setting   of
  4073.   environment  variables  which cause CICS OS/2 to trap during
  4074.   CICSRUN.
  4075.  
  4076.   If you are  experiencing  this  you  may  like  to  try  the
  4077.   following  to  startup  a  'vanilla' CICS system without the
  4078.   whistles and bells.
  4079.  
  4080.   1.  in CONFIG.SYS remove all CICS OS/2 environment variables
  4081.       except LIBPATH. LIBPATH should be set up to include  the
  4082.       following:
  4083.  
  4084.          ;.;X:\CICS120\OS2DSD;  where X=CICS drive.
  4085.  
  4086.       It  is  better(faster) if it appears toward the start of
  4087.       the LIBPATH string.
  4088.  
  4089.  
  4090.  
  4091.   2.  cold start the machine.
  4092.  
  4093.   3.  set default to CICS OS/2 work directory
  4094.  
  4095.           ie.  <C:\> X:
  4096.                <X:\> CD CICS120\OS2DSD
  4097.                <X:CICS120\OS2DSD> CICSRUN /C
  4098.  
  4099.   4.  try and ensure that CICS OS/2 is  started  before  other
  4100.       applications  (comms.mgr) this should give it sufficient
  4101.       memory 'elbow room'.
  4102.  
  4103.   5.  only add environment variables one at a time.
  4104.  
  4105.                                                              3
  4106.   oo  MSGDFH4412 'INVALID TRANSID' WHEN TRANSACTION ROUTING
  4107.  
  4108.   Problems can occur when attempting to transaction route from
  4109.   host to OS/2 (MSGDFH4412 invalid transid).
  4110.  
  4111.   Check your OS/2 Coms.Mgr. setup for the following:
  4112.  
  4113.       SNA  Feature - APPC Remotely Attachable Trans. Prog (TP)
  4114.       Prof.
  4115.  
  4116.       The following transactions should be defined.
  4117.  
  4118.              CVMI, CPMI, CRSR + user transactions (eg. CRTE)
  4119.  
  4120.       Note that the TP name and TP startup  parameters  *MUST*
  4121.       be in uppercase as Comms. Mgr. is case sensitive.
  4122.  
  4123.   See S.A.G Page 222 for example of CPMI etc. setup.
  4124.  
  4125.   oo  LINKEDIT MESSAGE L2022 WHEN USING CICSTCL
  4126.  
  4127.      When   using   CICSTCL  to  develop  COBOL  programs  the
  4128.   'PROGRAM-ID' statement in the COBOL source code  must  match
  4129.   the filename for the source.  ie.
  4130.  
  4131.     File   ABCDEF.CBL
  4132.  
  4133.   Must contain:
  4134.  
  4135.     PROGRAM-ID. ABCDEF.
  4136.  
  4137.   This  is  because  the  filename  is  used when creating the
  4138.   '.DEF' file used by the LINK statement.
  4139.  
  4140.   oo  ERROR MESSAGES WHEN STARTING CICS OS/2 IN LAN SERVER
  4141.       ENVIRONMENT
  4142.  
  4143.   When running CICS OS/2 on a  LAN  Requester  -  when  it  is
  4144.   resident  on  a  LAN  Server  ensure that the LAN Server has
  4145.   sufficient resources.
  4146.  
  4147.   MAXSESSOPENS and MAXOPENS defined in IBMLAN.INI need  to  be
  4148.   increased for this environment.
  4149.  
  4150.   Symptoms for this scenario will vary in their error messages
  4151.   but  occur  consistently  when  bringing  up  a  second CICS
  4152.   system.  Refer also to ASKQ 'EQUAL' item EDNF1.
  4153.  
  4154.  
  4155.                                                              4
  4156.   oo  3151 ASCII TERMINAL SUPPORT IN CICS OS/2
  4157.  
  4158.   CICS OS/2 3151 support is provided for 3151  models  51  and
  4159.   61, these will function with no modification.
  4160.  
  4161.   CICS  OS/2 can only work with models 31 and 41 if a national
  4162.   language multi user cartridge is installed in the  terminal.
  4163.   This  cartridge  has  the  necessary  logic support for CICS
  4164.  
  4165.   OS/2. The cartridges are available in a number  of  European
  4166.   languages and US English.
  4167.  
  4168.   Please  refer  to your local representative for the relevant
  4169.   part number.
  4170.  
  4171.   oo  3270 DATA STREAMS (EBCDIC COORDINATES)
  4172.  
  4173.   When   sending   native   3270    data    streams    to    a
  4174.   terminal the SBA coordinates must be in ASCII,
  4175.   not EBCDIC.         
  4176.  
  4177.   oo  NEW INFORMATION APAR
  4178.  
  4179.   The new information APAR is ii04538.
  4180.  
  4181.                                                              5
  4182.   HINTS AND OTHER INFORMATION.
  4183.   ____________________________
  4184.  
  4185.   NEW START-UP METHODOLOGY
  4186.  
  4187.   With  the  current  and future service releases the start-up
  4188.   methodology has been simplified. The aim has been to  reduce
  4189.   the reliance on the standard CONFIG.SYS and make CICS OS/2 a
  4190.   more  independent  and  stand-alone product.   The CICS OS/2
  4191.   environment variable definitions have  been  extracted  from
  4192.   the  CONFIG.SYS  and  placed  into two new files. This means
  4193.   that only one definition in CONFIG.SYS  may  require  to  be
  4194.   changed, the LIBPATH definition. To set the LIBPATH variable
  4195.   refer to page 45 in the System and Application Guide.
  4196.  
  4197.   Two  new  command  files  are  now  created  as  part of the
  4198.   installation procedures. These are CICSENV and CICSDEV.  The
  4199.   file  type is .CMD or .BAT depending on the environment (OS2
  4200.   or DOS). The sub-directory is also dependent on the type  of
  4201.   system  installed.  That is if it is a development system or
  4202.   run-time only and if it is OS2 or DOS.
  4203.  
  4204.   1.  CICSENV
  4205.  
  4206.       This file is invoked from the CICSRUN command  file  and
  4207.       is  used to set up the environment variables used during
  4208.       the  execution  of  CICS   OS/2.   By   removing   these
  4209.       environment  variables  from  CONFIG.SYS this means that
  4210.       they only exist when they are required.  ie.  when  CICS
  4211.       OS/2   is  running.  This  reduces  overhead  for  other
  4212.       applications. It will also greatly simplify the  setting
  4213.       up of CONFIG.SYS.
  4214.  
  4215.  
  4216.       By default the call to CICSENV from CICSRUN is commented
  4217.       out  (using  a  'REM'  statement)  but this 'REM' can be
  4218.       removed when the customer is satisfied he wants to use a
  4219.       specific variable.
  4220.  
  4221.       The 'SET' statements within the CICSENV command file are
  4222.       also commented out by use of the 'REM'.  Each  of  these
  4223.       commands can be un-commented when their use is required.
  4224.       This  will  avoid maintaining extra definitions that are
  4225.       not being used.
  4226.  
  4227.       So for example if the user wished to define the  CICSWRK
  4228.       environment  variable  they  would  take  the  following
  4229.       steps:
  4230.  
  4231.       o   un-comment the call to CICSENV in CICSRUN.
  4232.  
  4233.       o   un-comment the SET CICSWRK statement in CICSENV.
  4234.  
  4235.       o   if necessary modify the definition for CICSWRK.
  4236.  
  4237.       As  additional  environment  variables are required they
  4238.       need only be un-commented in CICSENV and modified  where
  4239.       necessary.
  4240.  
  4241.                                                              6
  4242.       This  system  has  the distinct advantage that CICS OS/2
  4243.       environment variables may be modified / added /  deleted
  4244.       without   the   need  to  re-boot  the  processor.  (The
  4245.       requirement to restart CICS OS/2 however will remain.)
  4246.  
  4247.   2.  CICSDEV
  4248.  
  4249.       When  developing  applications  a   different   set   of
  4250.       environment variables are required. (CICSTRL for example
  4251.       sets  the path for translator error messages and is only
  4252.       required during  application  development  never  during
  4253.       during the execution of CICS OS/2 itself.)
  4254.  
  4255.       CICSDEV  will  create the environment variables that may
  4256.       be used during application development.  It  is  advised
  4257.       that this procedure is executed before starting with the
  4258.       translation,    compilation    and   linking   of   user
  4259.       applications. Again as with the  previous  command  file
  4260.       the   statements  are  commented  out  using  the  'REM'
  4261.       command.  They can however, be  un-commented  when  they
  4262.       are required by the developer.
  4263.  
  4264.   3.  *NOTE FOR EXISTING USERS*
  4265.  
  4266.       If  you  currently  have  environment  variables defined
  4267.       within CONFIG.SYS this new method should not change  the
  4268.       way in which your system works.
  4269.  
  4270.  
  4271.       The   call  from  CICSRUN  to  CICSENV  is  deliberately
  4272.       commented out and the system will consequently  use  the
  4273.       definitions  you  have  supplied  in CONFIG.SYS. You are
  4274.       however advised to modify the definitions within CICSENV
  4275.       to match your current definitions. This will  allow  you
  4276.       to  migrate  to the new method and eventually remove the
  4277.       environment definitions from CONFIG.SYS. The  definition
  4278.       for LIBPATH *MUST* remain.
  4279.  
  4280.       For  those  users  who  invoke  CICS OS/2 with a PM menu
  4281.       option by calling the image FAAOMPSI  directly  and  now
  4282.       wish  to  take advantage of the new method the following
  4283.       is advised. Invoke CICSRUN.CMD from the menu and specify
  4284.       the application as non-PM  and  to  execute  in  a  full
  4285.       screen environment. This will avoid maintaining an extra
  4286.       window on the screen while CICS OS/2 is running.
  4287.  
  4288.   NEW MESSAGE (TO ASSIST WITH PROBLEM RESOLUTION)
  4289.  
  4290.   The  following  new  message has been added to the CICS OS/2
  4291.   message file (FAAMGFMG.BTR).
  4292.  
  4293.     FAA0000I CICS OS/2 Version %1. Service Level %2. Released %3
  4294.  
  4295.     Where      %1 = CICS OS/2 Version Number (Currently 1.20)
  4296.                %2 = CICS OS/2 Service Level  (Currently PTF3 soon to be 4)
  4297.                %3 = Date of Service Level release. (23-October-1990)
  4298.  
  4299.   This message will be displayed as the very first message  on
  4300.   the CICS log when CICS OS/2 is initialised.
  4301.  
  4302.                                                              7
  4303.   This will help to tell, at a glance, which service level you
  4304.   are running.
  4305.  
  4306.   REPORTING PROBLEMS VIA IBM LEVEL 1 AND PMR
  4307.  
  4308.   When reporting problems via IBM Level 1 and the PMR queue if
  4309.   you could include in the PMR:
  4310.  
  4311.   o   The  Service Level as noted in message FAA0000I see "New
  4312.       Message (to assist with problem resolution)" on page 5.
  4313.  
  4314.   o   The Host CICS system type and level (eg CICS/MVS 211).
  4315.  
  4316.   it would assist Level 1 and 2 to determine the problem.
  4317.  
  4318.  
  4319.  
  4320.   USER EXITS - FAAEXP02 and FAAEXP04
  4321.  
  4322.   The latest PTF includes an APAR to correct the invoking of the above
  4323.   exits. These exits are provided as samples and with the PTF the DLLs
  4324.   have been redistributed as null programs ( ie they just return ). If
  4325.   they are required the sample program should be compiled and linked to
  4326.   replace the distributed DLLs.
  4327.   Users who have coded there own copies of these exits should ensure the
  4328.   application of the PTF does not overwrite their programs.
  4329.  
  4330.  
  4331.   'COOPERATIVE PROCESSING WITH CICS OS/2'
  4332.  
  4333.   A  document  titled  'Cooperative Processing with CICS OS/2'
  4334.   will be available in the near future. You will  be  able  to
  4335.   obtain this document from your IBM System Engineer, who will
  4336.   find it on Marketing Tools.
  4337.  
  4338.   The document covers:
  4339.  
  4340.       Why - Cooperative Processing and CICS OS/2
  4341.  
  4342.       Application Design
  4343.  
  4344.       Workstation Interfaces on your Cooperative application
  4345.  
  4346.       Cooperative Processing in the LAN environment
  4347.  
  4348.       CICS OS/2 Communications
  4349.  
  4350.       Data Conversion
  4351.  
  4352.       Performance
  4353.  
  4354.       Security
  4355.  
  4356.       System Management
  4357.  
  4358.                                                              8
  4359.  
  4360.   EXTRA TRACE POINTS
  4361.  
  4362.             The trace points listed below are not listed in the
  4363.  
  4364.                  CICS OS/2 System and Application Guide.  P365
  4365.                  ───────────────────────────────────────
  4366.  
  4367.   ┌────────────────────────────────────────────────────────────────────┐
  4368.   │ ID = 01   Issued by FAASRSML   Server mainline                     │
  4369.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4370.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4371.   │ POINT   │                      │                 │                 │
  4372.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4373.   │ SN M51  │ Entry to internal    │ Resource name   │ Resource name   │
  4374.   │         │ ENQ routine          │                 │                 │
  4375.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4376.   │ TO M52  │ Error enqueuing      │ Return Code     │                 │
  4377.   │         │ on control semaphore │                 │                 │
  4378.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4379.   │ TO M53  │ Error creating       │ Return Code     │                 │
  4380.   │         │ resource semaphore   │                 │                 │
  4381.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4382.   │ TO M54  │ Error opening        │ Return Code     │                 │
  4383.   │         │ resource semaphore   │                 │                 │
  4384.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4385.   │ TO M55  │ Error releasing      │ Return Code     │                 │
  4386.   │         │ control semaphore    │                 │                 │
  4387.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4388.   │ SX M56  │ Exit from internal   │ Return Code     │                 │
  4389.   │         │ ENQ routine          │                 │                 │
  4390.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4391.   │ SN M57  │ Entry to internal    │ Resource name   │ Resource name   │
  4392.   │         │ DEQ routine          │                 │                 │
  4393.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4394.   │ SX M58  │ Exit from internal   │ Return Code     │                 │
  4395.   │         │ DEQ routine          │                 │                 │
  4396.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4397.   │ TO M59  │ Error opening        │ Return Code     │                 │
  4398.   │         │ control semaphore    │                 │                 │
  4399.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4400.  
  4401.   ┌────────────────────────────────────────────────────────────────────┐
  4402.   │ ID = 01   Issued by FAASRCFC   Server file control                 │
  4403.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4404.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4405.   │ POINT   │                      │                 │                 │
  4406.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4407.   │ MO F05  │ Transaction Log file │ File name       │ File name       │
  4408.   │         │ error                │                 │                 │
  4409.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4410.   │ SV F11  │ Aix file positioning │ Return Code     │ Function.       │
  4411.   │         │ entry.               │                 │                 │
  4412.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4413.  
  4414.                                                              9
  4415.   ┌────────────────────────────────────────────────────────────────────┐
  4416.   │ ID = 01   Issued by FAASRCFQ   Server file queue handler           │
  4417.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4418.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4419.   │ POINT   │                      │                 │                 │
  4420.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4421.   │ SV Q01  │ Reallocated file     │ Segment size    │ Return code     │
  4422.   │         │ shared segment       │                 │                 │
  4423.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4424.   │ SO Q02  │ Error writing to     │ Return code     │ Request type    │
  4425.   │         │ queue                │                 │                 │
  4426.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4427.   │ SV Q03  │ Element written to   │ Process id      │ Request type    │
  4428.   │         │ queue                │                 │                 │
  4429.   │         │                      │                 │                 │
  4430.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4431.  
  4432.   ┌────────────────────────────────────────────────────────────────────┐
  4433.   │ ID = 16   Issued by FAAOISMM   OS/2 main task initialization       │
  4434.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4435.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4436.   │ POINT   │                      │                 │                 │
  4437.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4438.   │ SV M20  │ TCT terminal entry   │ Terminal name   │ Terminal type   │
  4439.   │         │ loaded               │                 │                 │
  4440.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4441.   │ TV M71  │ File access return   │ Operation       │ Return code     │
  4442.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4443.   │ TV M72  │ File access return   │ Operation       │ Return code     │
  4444.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4445.   │ TV M73  │ File access return   │ Operation       │ Return code     │
  4446.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4447.   │ SV M74  │ Open screen file in  │ Open return     │ File index      │
  4448.   │         │ global process       │ code            │                 │
  4449.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4450.  
  4451.                                                             10
  4452.   ┌────────────────────────────────────────────────────────────────────┐
  4453.   │ ID = 16   Issued by FAAOISTT   OS/2 task control initialization    │
  4454.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4455.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4456.   │ POINT   │                      │                 │                 │
  4457.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4458.   │ SV T58  │ Obtain record from   │ FCT Index       │ Return Code.    │
  4459.   │         │ control file.        │                 │                 │
  4460.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4461.   │ SV T59  │ Open the file.       │ FCT Index       │ Return Code.    │
  4462.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4463.   │ TV T74  │ Call to File System  │ File function   │ Return code     │
  4464.   │         │ (read) completion    │                 │                 │
  4465.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4466.   │ TV T75  │ Call to File System  │ File function   │ Return code     │
  4467.   │         │ (open) completion    │                 │                 │
  4468.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4469.   │ SN T76  │ Open FCT entry.      │ FCT entry name  │                 │
  4470.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4471.   │ SN T77  │ Set FCT status       │ FCT Index       │ Return Code.    │
  4472.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4473.   │ SV T78  │ Exit setting FCT     │ Count Logically │ Return Code.    │
  4474.   │         │ status               │ open files.     │                 │
  4475.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4476.   │ SV T79  │ Located AIX file     │ FCT entry name  │                 │
  4477.   │         │ entry.               │                 │                 │
  4478.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4479.  
  4480.   ┌────────────────────────────────────────────────────────────────────┐
  4481.   │ ID = 17   Issued by FAAITS01   DOS initialization - load FCT       │
  4482.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4483.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4484.   │ POINT   │                      │                 │                 │
  4485.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4486.   │ TV 117  │ Call to File System  │ File function   │ Return code     │
  4487.   │         │ completion           │                 │                 │
  4488.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4489.   │ TV 118  │ Call to File System  │ File function   │ Return code     │
  4490.   │         │ completion           │                 │                 │
  4491.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4492.   │ SV 119  │ Locate AIX Entry     │ File name.      │                 │
  4493.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4494.  
  4495.   ┌────────────────────────────────────────────────────────────────────┐
  4496.   │ ID = 25   Issued by FAASRCRS   Remote function processor           │
  4497.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4498.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4499.   │ POINT   │                      │                 │                 │
  4500.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4501.   │ TV R05  │ Wait for free session│ Return Code     │ TCS name        │
  4502.   │         │                      │                 │                 │
  4503.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4504.  
  4505.                                                             11
  4506.   ┌────────────────────────────────────────────────────────────────────┐
  4507.   │ ID = 32   Issued by FAASRSE1   Server EDF module - Monitoring func.│
  4508.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4509.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4510.   │ POINT   │                      │                 │                 │
  4511.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4512.   │ RN M01  │ Entry to FAASRSE1    │ Data Length /   │ Command / WCC / │
  4513.   │         │                      │ Cursor Position │ Max Length      │
  4514.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4515.   │ RX M02  │ Exit to FAASRSE1     │ Data Length /   │ Command / WCC   │
  4516.   │         │                      │ Cursor Position │                 │
  4517.   │         │                      │                 │                 │
  4518.   │         │                      │                 │                 │
  4519.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4520.  
  4521.   ┌────────────────────────────────────────────────────────────────────┐
  4522.   │ ID = 32   Issued by FAASRSE2   Server EDF module - Monitored screen│
  4523.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4524.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4525.   │ POINT   │                      │                 │                 │
  4526.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4527.   │ RV L03  │ Queue entry received │ Data Length /   │ WCC / Function  │
  4528.   │         │                      │ Cursor Position │                 │
  4529.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4530.   │ RV L04  │ Screen operation     │ Data Length /   │ Command / WCC   │
  4531.   │         │ completed            │ Cursor Position │ Max Length      │
  4532.   │         │                      │                 │                 │
  4533.   │         │                      │                 │                 │
  4534.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4535.  
  4536.   ┌────────────────────────────────────────────────────────────────────┐
  4537.   │ ID = 55   Issued by FAAOMPML   OS/2 Main control task              │
  4538.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4539.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4540.   │ POINT   │                      │                 │                 │
  4541.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4542.   │ TO G00  │ Exit from message    │ Return code     │ Spaces          │
  4543.   │         │ browse               │                 │                 │
  4544.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4545.   │ SN G03  │ Enter mainline       │ Applid          │ Applid          │
  4546.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4547.   │ SN G16  │ Enter start sessions │ Session name    │ TCA entry index │
  4548.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4549.   │ TV G80  │ Queue status trace   │ Request flag,   │ Number of       │
  4550.   │         │ event.               │ Return code     │ elements        │
  4551.   │         │                      │                 │                 │
  4552.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4553.   │ TV G97  │ Coordinated startup. │ Task id.        │ Request flag    │
  4554.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4555.   │ TV G99  │ Startup waiting for  │ Count of        │ Number of tasks │
  4556.   │         │ tasks to report back.│ reported tasks  │ started         │
  4557.   │         │                      │                 │                 │
  4558.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4559.  
  4560.                                                             12
  4561.   ┌────────────────────────────────────────────────────────────────────┐
  4562.   │ ID = 56   Issued by FAAOTPTK   OS/2 Task control                   │
  4563.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4564.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4565.   │ POINT   │                      │                 │                 │
  4566.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4567.   │ MO K04  │ Terminal emulator    │ Return code     │ Spaces          │
  4568.   │         │ error.               │                 │                 │
  4569.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4570.   │ TV K18  │ Delete ICE entry     │ Term id.        │ Tran id.        │
  4571.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4572.   │ SV K71  │ Locate Module.       │ Return code     │ Spaces          │
  4573.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4574.   │ MO K72  │ Initialise terminal  │ Return code     │ Term id.        │
  4575.   │         │ thread               │                 │                 │
  4576.   │         │                      │                 │                 │
  4577.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4578.  
  4579.   ┌────────────────────────────────────────────────────────────────────┐
  4580.   │ ID = 70   Issued by FAATCPCT   TCT manager                         │
  4581.   ├─────────┬──────────────────────┬─────────────────┬─────────────────┤
  4582.   │ TYPE /  │ ENTRY DESCRIPTION    │ FIELD A         │ FIELD B         │
  4583.   │ POINT   │                      │                 │                 │
  4584.   ├─────────┼──────────────────────┼─────────────────┼─────────────────┤
  4585.   │ MO M12  │ Result of request to │ Return code     │ TCT Manager     │
  4586.   │         │ Global task.         │                 │ Return code     │
  4587.   │         │                      │                 │                 │
  4588.   │         │                      │                 │                 │
  4589.   └─────────┴──────────────────────┴─────────────────┴─────────────────┘
  4590.  
  4591.                                                             13
  4592.   FUNCTION  NUMBERS.
  4593.  
  4594.  
  4595.             The function numbers listed below are not listed in the
  4596.  
  4597.                  CICS OS/2 System and Application Guide.  P379
  4598.                  ───────────────────────────────────────
  4599.  
  4600.  
  4601.  
  4602.  
  4603.    FUNCTION               NUMBER
  4604.  
  4605.    TRANSACTION ROUTING        20.    *
  4606.    LU2 LOGON REQUEST          21.    *
  4607.    DELETE SHIPPED TERMINAL    22.    *
  4608.    INQUIRE-CONNECTION         29.
  4609.    SET-FILE                   30.
  4610.    TASK-CONTROL-WRITE         55.    *
  4611.    TASK-CONTROL-READ          56.    *
  4612.    TASK-CONTROL-ERASE         57.    *
  4613.    TERMINAL WSU INITIALISE    59.    *
  4614.    ENQ-INTERNAL               76.    *
  4615.    DEQ-INTERNAL               77.    *
  4616.    INQUIRE-SYSTEM             83.
  4617.    ASKTIME                    90.
  4618.    POP-ALL                    91.    *
  4619.    START-TRANSACTION          92.    *
  4620.    END-TRANSACTION            93.    *
  4621.    GET-MESSAGE                96.    *
  4622.    INITIAL-PROGRAM-CALL       97.
  4623.    SYNCPOINT                  98.
  4624.    INITIALISE                 99.    *
  4625.    ASSIGN                    102.
  4626.    HANDLE                    103.
  4627.    PUSH                      111.
  4628.    POP                       112.
  4629.    POP_P_TAB                 113.    *
  4630.    LOAD-PROGRAM              114.    *
  4631.    DELETE-PROGRAM            115.    *
  4632.    LOAD                      116.
  4633.    CLEAR POST                170.    *
  4634.    C INITIAL-PROGRAM-CALL    197.
  4635.    EDF-CLOSING               200.    *
  4636.    ALLOCATE                  201.
  4637.    EXTRACT                   202.
  4638.    CONNECT                   203.
  4639.    FREE                      204.
  4640.  
  4641.    *  Internal calls
  4642.  
  4643.  
  4644.     **************************************************************
  4645.     **************************************************************
  4646.     ***                                                        ***
  4647.     ***                   End of Document                      ***
  4648.     ***                                                        ***
  4649.     **************************************************************
  4650.     **************************************************************
  4651.  
  4652.  
  4653.