home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / o22516d1.zip / CIC2UDRN.DOC < prev    next >
Text File  |  1994-01-05  |  76KB  |  1,837 lines
  1.    =========================================================================
  2.                         C I C S   O S / 2    O P T I O N
  3.  
  4.                                      f o r
  5.  
  6.            M I C R O   F O C U S   C O B O L   W O R K B E N C H
  7.  
  8.                                     V2.5.16
  9.    =========================================================================
  10.  
  11.                                  RELEASE  NOTES
  12.                                  ==============
  13.  
  14.  
  15.    TABLE OF CONTENTS
  16.    =================
  17.        ESSENTIAL INFORMATION
  18.        INTRODUCTION
  19.        IMPORTANT NOTES
  20.            Syncpoint Coordination
  21.            Multiple Session Debugger
  22.            Changes due to Fix for APAR PN24821
  23.            Updating your System with New\Changed IBM RDO definition
  24.        ERRORS FIXED IN THIS RELEASE
  25.        ENHANCEMENTS IN THIS RELEASE
  26.        KNOWN ERRORS IN THIS RELEASE
  27.        DOCUMENTATION OMISSIONS AND ERRORS
  28.        CICS OS/2 OPTION SYNCPOINT COORDINATION
  29.            Overview
  30.            Software Requirements
  31.            Components
  32.            Using Syncpoint Coordination
  33.            Micro Focus IMSVS86 Support
  34.            IBM OS/2 Database Manager Support
  35.            XDB Systems, Inc. Extended Database System Support
  36.            Error Messages
  37.            Trace Entry Documentation
  38.        CICS OS/2 OPTION EXECUTION TIME CONTROL (MC2INIT)
  39.            Overview
  40.            Components
  41.            Using MC2INIT
  42.            Configuration File
  43.            Process Control Parameters
  44.            Example MCO2.CFG Files
  45.            Debugging PM-API Processes
  46.            Restrictions in Related Software
  47.            Error Messages
  48.        PRODUCT CHECKLIST
  49.        INSTALLATION
  50.        DISK CONTENTS
  51.  
  52.    ESSENTIAL INFORMATION
  53.    =====================
  54.     o  The method for loading debuggers in CICS OS/2 has changed. You must
  55.        insure that the CICSWRK environment variable is changed to include
  56.        the COBOL directories that contain animate.exe, xil.exe, animate.lbr
  57.        and xilerate.lbr. By default these directories are COBOL\EXEDLL and
  58.        COBOL\LBR. However, this may have been customized during installation
  59.        of your COBOL system.
  60.        -PAO14818 added V2.5.15
  61.  
  62.     o  It is essential that you read the section "Changes due to Fix for
  63.        APAR PN24821" in these Release Notes.
  64.  
  65.     o  As of PTF-23 IBM recompiled the CICS OS/2 system code with version
  66.        3.0.54 of the Micro Focus compiler.  This means that you must have
  67.        that level or higher on your machine to insure compatibility with
  68.        this update.
  69.  
  70.    INTRODUCTION
  71.    ============
  72.    This version of CICS OS/2 Option for Micro Focus COBOL/2 Workbench is a
  73.    maintenance release for version V2.5.04 of CICS OS/2 Option for Micro
  74.    Focus COBOL/2 Workbench, fixing the problems indicated below. It is
  75.    issued as an update disk rather than a full disk set, and requires the
  76.    V2.5.04 disk set for a complete installation.
  77.  
  78.    Note:  From October 1992, each new entry in Release Notes states the
  79.           reference number of the problem or enhancement request that gave
  80.           rise to it. This is to enable Product Support to help you more
  81.           quickly if you should need to call them. These numbers are usually
  82.           Product Discrepancy Report (PDR) numbers. A note of the release at
  83.           which the entry first appeared in the Release Notes appears either
  84.           with the PDR number or beneath the section heading.
  85.  
  86.           Other minor improvements in formatting are also being made
  87.           starting from October 1992.
  88.  
  89.    Note:  From January 1993, the section "Errors Fixed in This Release"
  90.           includes errors fixed by IBM PTF's, since not all such fixes are
  91.           necessarily shown in the IBMPTFnn.DOC file.
  92.  
  93.    IMPORTANT NOTES
  94.    ===============
  95.  
  96.    Syncpoint Coordination
  97.    ======================
  98.    If you have been using the Syncpoint Coordination feature, before
  99.    applying this update disk you must backup or rename files FAAOIS04.xxx
  100.    and FAAOISPT.xxx; this is because the update process automatically
  101.    restores them to their original state. Once the update process has
  102.    finished, you can replace these new files with the copies you made before
  103.    the update process was started.
  104.  
  105.    Multiple Session Debugger
  106.    =========================
  107.    If you have been using the Multiple Session Debugger, before applying
  108.    this update disk you must backup or rename the file MCO2.CFG if it has
  109.    been customized; this is because the update process restores this file so
  110.    that the Multiple Session Debugger feature is not available. Once the
  111.    update process has finished, you can replace the new MCO2.CFG file with
  112.    the copy you made before the update process was started.
  113.  
  114.    You must also replace the file FAAOMPML.EXE with the file FAAOMPML.EXA;
  115.    this is because the update process restores FAAOMPML.EXE such that it
  116.    only supports a single debugging session. Once the update process has
  117.    finished, you must rename or copy the file FAAOMPML.EXA to FAAOMPML.EXE.
  118.  
  119.    Note:  To bring CICS OS/2 into line with host CICS, access to record zero
  120.           in Relative Record (RRDS) files is no longer supported.
  121.  
  122.    Changes due to Fix for APAR PN24821
  123.    ===================================
  124.    APAR PN24821 describes a problem where STARTBR and READNEXT on relative
  125.    record data sets (RRDS files) return an incorrect record.
  126.  
  127.    The fix for PN24821 corrects this problem by changing the internal
  128.    structure of RRDS files. When CICS OS/2 starts up the control file is
  129.    scanned to set up, amongst other things, FCT entries. Should an RRDS file
  130.    be encountered which uses old-style internal structure then a warning
  131.    message is issued indicating that the file is out of date. To update the
  132.    RRDS file use the RRDS file converter which is provided as part of PTF22.
  133.  
  134.    *WARNING*  Before using the RRDS file converter routine ensure *WARNING*
  135.    *WARNING*  that you have made security copies of all of your   *WARNING*
  136.    *WARNING*  data files. ie. All files with a file type .BTR     *WARNING*
  137.  
  138.    The RRDS converter routine can be invoked using the new command file
  139.    provided, CICSRRDS.CMD for an OS/2 environment or CICSRRDS.BAT for a DOS
  140.    environment. The routine will scan the CICS OS/2 control file searching
  141.    for RRDS file descriptions and converting these files.
  142.  
  143.    The format of the command for RRDS file conversion is:
  144.  
  145.        CICSRRDS  [/B:nnnn]  [/M:nnnn]
  146.  
  147.    The converter routine accepts the /B and /M (file control) parameters as
  148.    used when starting up CICS OS/2. These options should only be used if
  149.    they are normally used during the startup of CICS OS/2. For more
  150.    information on these options refer to the "CICS OS/2 System and
  151.    Application Guide", Chapter 11.
  152.    -PN24821  added V2.5.12
  153.  
  154.    Updating your System with New\Changed IBM RDO definition
  155.    --------------------------------------------------------
  156.    Note:  If you are updating from V2.5.13 there are no additional PTF's
  157.           that need to be imported.  You can ignore this section.
  158.  
  159.    Because IBM periodically supplies maintenance to the RDO file
  160.    (FAACTFTB.BTR), you must take special action to insure your resource
  161.    definition file (FAACTFTB.BTR) picks up all IBM maintenance that required
  162.    distinct user action. After installing the CICS OS/2 V2.5.15 update, you
  163.    need to use the CAIM import transaction to pick up the maintenance.
  164.  
  165.     1. Make the DATA directory of the target CICS OS/2 system the current
  166.        directory (for example, CICS120\OS2DSD\DATA) and rename file
  167.        FAAAEFIE.BTR to FAAAEFIE.xxx, where xxx makes the filename unique.
  168.        Then rename FAAAEFIE.T01 to FAAAEFIE.BTR.  Now cold-start CICS OS/2
  169.        (note you must COLD-start it), sign-on and issue the CAIM
  170.        transaction.
  171.  
  172.     2. At the import panel, enter the appropriate PTF in the group name
  173.        field. Set all fields to N and press enter.  This transaction will
  174.        import the required maintenance introduced by this APAR.  Warning
  175.        messages will be written to temporary storage queue CEBRXXX (where
  176.        XXXX is the id of the terminal issuing the transaction.  You can
  177.        ignore these messages.
  178.  
  179.     3. The following is a list of IBM PTF's that have been introduced since
  180.        PTF-9.
  181.  
  182.            PN21505  : PTF-18
  183.            PN28420  : PTF-19
  184.            PN29610  : PTF-20
  185.            PN15480  : PTF-15
  186.  
  187.     4. Shutdown CICS OS/2 with a CQIT.  When CICS OS/2 terminates, go to the
  188.        DATA directory of the target CICS OS/2 system and rename FAAAEFIE.BTR
  189.        back to FAAAEFIE.T01 and FAAAEFIE.xxx back to FAAAEFIE.BTR.
  190.  
  191.    It is essential that you follow these procedures so that you incorporate
  192.    all required IBM maintenance to the resource definition file.
  193.    -NWB20645 added V2.5.13 amended V2.5.15
  194.  
  195.    ERRORS FIXED IN THIS RELEASE
  196.    ============================
  197.    The following errors are fixed in this release.
  198.  
  199.     o  Data item with a VALUE clause containing the text "COPY" caused
  200.        the integrated proprocessor to mistakenly assume a COPY-file had
  201.        to be expanded.
  202.        -NWB24254
  203.  
  204.    Fixed by IBM PTF 29
  205.    ----------V2.5.16--
  206.     o  EIBCONF FIELD IS NOT RESET AFTER AN ISSUE ERROR COMMAND
  207.        -PN41088
  208.  
  209.     o  CICS OS/2 ENVIRONMENT VARIABLE CICSTEXT IS NOT WORKING.
  210.        -PN32909
  211.  
  212.     o  CAEX GETS ABENDAEIV
  213.        -PN38509
  214.  
  215.     o  IF FIELDS IN A MAP NOT IN ASCENDING ORDER, A RECEIVE MAP WILL NOT
  216.        PICK UP THE OUT OF SEQUENCE FIELDS.
  217.        -PN39349
  218.  
  219.     o  SEND CONTROL CURSOR NOT RIGHT AFTER SEND MAP
  220.        -PN42673
  221.  
  222.     o  WITH EXEC CICS, ADDRESS IN DUMP IS GARBAGED
  223.        -PN43265
  224.  
  225.     o  CICS OS/2 TRANSLATOR DOES NOT CHECK FOR SPELLING ON THE PROCEDURE
  226.        DIVISION STATEMENT.
  227.        -PN44008
  228.  
  229.     o  55H0X TRACE POINTS ARE IDENTIFIED AS ENTRY TRACE POINTS INSTEAD OF
  230.        EVENT TRACEPOINTS.
  231.        -PN44445
  232.  
  233.     o  RECEIVE FUNCTION CAN'T USE CORRECTLY WITH OPTION NOTRANCATE.
  234.        -PN44826
  235.  
  236.     o  UPON COMPLETION OF TRANSACTION ROUTING FROM THE HOST, THE HOST
  237.        SYSTEM LOSES ITS EXTENDED ATTRIBUTES
  238.        -PN45744
  239.  
  240.    Fixed by IBM PTF 28
  241.    ----------V2.5.16--
  242.     o  TRANSACTION ROUTE RETURN OF MAP DOES NOT DISPLAY THE MAP
  243.        -PN18013
  244.  
  245.     o  MAPFAIL CONDITION MAY ARISE WHEN USING EDF.
  246.        -PN40951
  247.  
  248.     o  COMMAREA IS LOST WHEN PASSED TO A THIRD PROGRAM.
  249.        -PN39680
  250.  
  251.     o  EXEC CICS ABEND DOES NOT END THE PROGRAM
  252.        -PN40959
  253.  
  254.     o  AFTER INSTALLING PTF24, MSGFAA2251E OCCURS AT SIGNON
  255.        -PN39862
  256.  
  257.     o  USING A DOLLAR SIGN WITH JUSTIFY RIGHT ZERO,THE $ IS NOT HOLDING ITS
  258.        POSITION LIKE THE HOST
  259.        -PN36679
  260.  
  261.     o  SYS3175 TRAP000D IN FAASRSML WHEN ATTEMPTING TO ACCESS ANOTHER SYSTEM
  262.        ACROSS AN LU62 LINK.
  263.        -PN37466
  264.  
  265.     o  CICS OS/2 BMS MAP TRANSLATOR FAILS TO FLAG A LENGTH IF THE POS/FIELD
  266.        LENGTH EXCEEDS LINELENGTH.
  267.        -PN38181
  268.  
  269.     o  BMS GRPNAME FIELDS ARE NOT PROPERLY DISPLAYED IN CICS OS/2.
  270.        -PN39300
  271.  
  272.     o  DOSTYMERASYNC CALL RETURNING UNEXPECTED BINARY ZEROS. RESULT IS EXEC
  273.        CICS CANCEL DOES NOT CLEAR EXEC CICS DELAY
  274.        -PN43234
  275.  
  276.    Fixed by IBM PTF 27
  277.    ----------V2.5.16--
  278.     o  AFTER APPC CONFIRM FROM HOST AND CICS OS/2 XACT DOES AN EXEC CICS
  279.        ISSUE ABEND, CICS OS/2 SENDS APPC DEALLOCATE W/O ABEND.
  280.        -PN16639
  281.  
  282.     o  TRANSACTION ROUTE RETURN OF MAP DOES NOT DISPLAY THE MAP.
  283.        -PN18013
  284.  
  285.     o  CICS OS/2 V1.2 DOES NOT ALLOW DOSKILLPROCESS COMMANDS TO BRING DOWN
  286.        HUNG TASKS.
  287.        -PN41208
  288.  
  289.     o  A CICS OS/2 TASK DOING RETRIES TO ALLOCATE A SESSION THRU COMM MGR
  290.        DOES NOT RELEASE A SEMAPHORE.
  291.        -PN35314
  292.  
  293.     o  SYNCONRETURN PARM IS NOT PASSED ON A DAISY CHAINED DPL CALL.
  294.        -PN35526
  295.  
  296.     o  MAP TRANSLATOR INCORRECTLY CALCULATES LENGTH FOR PICIN='S9(8)'
  297.        INCORRECTLY AND ISSUES MSGFAA1073.
  298.        -PN35880
  299.  
  300.     o  SET 'ADDRESS OF' IS A COBOL2 STATEMENT AND SHOULD BE FLAGGED AS
  301.        INVALID IF THE COBOL2 TRANSLATOR DIRECTIVE IS NOT SET.
  302.        -PN36901
  303.  
  304.     o  WRONG TRANSLATOR OUTPUT ON COBOL EVALUATE FUNCTION.
  305.        -PN37816
  306.  
  307.     o  THE CICS COBOL TRANSLATOR WILL LOOP IF THE EXEC CICS RETURN COMMAND
  308.        DOES NOT HAVE AN END-EXEC STATEMENT.
  309.        -PN38304
  310.  
  311.    Added in V2.5.15
  312.    ================
  313.    The fixes listed in this and any following similar section(s), which were
  314.    included in earlier maintenance releases, are also in this release.
  315.  
  316.     o  This update disk includes fixes included in IBM PTF23, PTF24, PTF25
  317.        and PTF26. Details of these fixes are in the IBM on-disk document
  318.        IBMPTF26.DOC.
  319.  
  320.     o  mc2sync0 did not terminate IMS properly at system shutdown if IMS
  321.        was started by FAAOIS04 at initialization. This resulted in system
  322.        hangs during subsequent restarts.
  323.        -PAO13731
  324.  
  325.     o  Exiting to Workbench and then coming back to the CICS OS/2 Option
  326.        main menu gave a load failure on DIRECT.GNT.
  327.        -PAO11743 & PAO13532
  328.  
  329.     o  Reverse mono fields were not highlighted when set to bright.
  330.        -PAO10957
  331.  
  332.     o  You got a protection violation on MC2sync0 when animating a DBM SQL
  333.        program.
  334.        -PAO12094
  335.  
  336.     o  DFHCNV generated incorrect output if the last elementary item in a
  337.        data structure was a FILLER.
  338.        -PAOO13550
  339.  
  340.     o  During preprocessing, if the .CCP and .CBL files were found to be out
  341.        of synchronization with each other, the preprocessor stopped with a
  342.        run-time error 153 ("Subscript out of range"). This has been
  343.        corrected so that a termination message is displayed and the
  344.        compilation stops.
  345.        -PAO13395
  346.  
  347.     o  You could not set an Animator breakpoint on lines containing the
  348.        keyword DFHRESP, DFHRESP2, or DFHVALUE.
  349.        -PAO13399
  350.  
  351.     o  Checking MCCTxx demo programs with the Structured Animator toggle set
  352.        gave the error message "**dd fatal error writing to dynamic memory".
  353.        -PAO13895
  354.  
  355.     o  COPY/REPLACING did not work with an integrated preprocessor.
  356.        -PAO13078
  357.  
  358.     o  When the CICS Translator finished with a non-zero return code,
  359.        compiling continued nevertheless. This has been corrected so that the
  360.        generated COBOL source program is not compiled.
  361.        -PAO13067
  362.  
  363.     o  The ALIGN(2) directive has been removed from the supplied CICSOS2.DIR
  364.        The default of ALIGN(8) will now be in effect. The ALIGN(2) setting
  365.        is incompatible with DBM and caused large unidentifiable SQL return
  366.        codes.
  367.        -NWB23281
  368.  
  369.  
  370.    Fixed by IBM PTF 26
  371.    ----------V2.5.15--
  372.     o  AFTER APPC CONFIRM FROM HOST AND CICS OS/2 XACT DOES AN EXEC CICS
  373.        ISSUE ABEND, CICS OS/2 SENDS APPC DEALLOCATE W/O ABEND.
  374.        -PN16639
  375.  
  376.     o  EXEX CICS START TRANID=,REQID= WHICH IS THE SAME AS THE
  377.        RUNNING XACTION WILL GET INVREQ.
  378.        -PN33041
  379.  
  380.     o  OPEN RESET TO BASE FILE WITHOUT CLOSING ITS ALTERNATE INDICES
  381.        RESULTS IN INVREQ AND FILE CORRUPTION.
  382.        -PN33061
  383.  
  384.     o  IF A PEER TO PEER TRANSACTION ROUTING REQUEST FAILS, THE
  385.        INITIATING SESSION HANGS.
  386.        -PN33170
  387.  
  388.     o  MESSGAE FAA0558W IN C-TRANSLATOR.
  389.        -PN33549
  390.  
  391.     o  EXEC RECEIVE OF TERMINAL DATA UNDER CEDF IS RETURNED WITH A
  392.        LENGTH AND DATA WHICH IS 3 BYTES LONGER THAN WHEN NON CEDF.
  393.        -PN34017
  394.  
  395.     o  TRANSLATOR INCORRECTLY REPLACES DATA FOR A COPY REPLACE.
  396.        -PN35466
  397.  
  398.     o  SYNCPOINT ROLLBACK IS FAILING ON A FILE AFTER OPEN RESET.
  399.        -PN35467
  400.  
  401.     o  CICS OS/2 COBOL TRANSLATOR INCORRECTLY PARTIALLY REPLACES
  402.        DATA ON WHAT SHOULD BE A FULL COPY REPLACE.
  403.        -PN37307
  404.  
  405.    Fixed by IBM PTF 25
  406.    ----------V2.5.15--
  407.     o  REVERSE MONO FIELDS NOT HIGHLIGHTED WHEN SET BRIGHT.
  408.        -PN18314
  409.  
  410.     o  ABENDAZI4 ATTEMPTING TO USE AN LU2 LINK.
  411.        -PN20555
  412.  
  413.     o  CICS OS/2 SEND MAP ERASEAUP GENERATES A SEND MAP ERASAUP/PRING/ALARM.
  414.        -PN29974
  415.  
  416.     o  E.C.SEND MAP WITHOUT SPECIFYING A CURSOR ADDRESS,AFTER AN E.C.
  417.        SEND MAP WITH CURSOR ADDRESS:CURSOR NOT AT HOME POSITION.
  418.        -PN30330
  419.  
  420.     o  INSUFFICIENT RESOURCES ATTEMPTING TO USE ETI
  421.        -PN30850
  422.  
  423.     o  SENDING A BMS MAP IN TRANSACTION ROUTING FROM CICS/VSE TO CICS/OS2
  424.        RANDOMLY THE MAP IS PRINDED RANDOMLY ON LOCAL PRINTER.
  425.        -PN31474
  426.  
  427.     o  IF AN LU2 CONNECTION GOES DOWN, THE CICS OS/2 SESSION USING THE
  428.        CONNECTION WILL HANG.
  429.        -PN32329
  430.  
  431.     o  CICSMAP ISSUES MSGFAA1975W IN ERROR FOR A MAP WHEN THE LENGTH FIELD
  432.        FOLLOWS THE INITIAL AND ATTRB FIELDS.
  433.        -PN32860
  434.  
  435.     o  PROCEDURE DIVISION STATEMENT NOT BUILT CORRECTLY IF THE USING PARM
  436.        IS USED AND PERIOD IS ON A DIFFERENT LINE.
  437.        -PN33383
  438.  
  439.     o  AN ECI CALL WHICH LINKS TO A PROGRAM WHICH DOES NOT EXIST RETURNS
  440.        ABENDAEIO (DUPKEY) RATHER THAN ABENDAEI0(PGMIDERR).
  441.        -PN33670
  442.  
  443.     o  TRANSLATOR DOES NOT PUT OUT AN ERROR MESSAGE WHEN A PROGRAM USES AN
  444.        ALPHA LITERAL FOR THE LENGTH OPTION.
  445.        -PN33866
  446.  
  447.     o  TRANSLATOR GIVES ERROR FAA0173E INCORRECTLY WHEN USING A VARIABLE
  448.        WITH AN ALPHA CHARACTER FOR THE LENGTH OPTION.
  449.        -PN33867
  450.  
  451.     o  CICS OS/2 RELEASE 1.20 DOES NOT SUPPORT THE CSET/2 COMPILER.
  452.        -PN35770
  453.  
  454.    Fixed by IBM PTF 24
  455.    ----------V2.5.15--
  456.     o  TRANSLATOR GIVES ERROR FAA0173E INCORRECTLY WHEN USING A VARIABLE
  457.        WITH AN ALPHA CHARACTER FOR THE LENGTH OPTION.
  458.        -PN33867
  459.  
  460.     o  AN EXEC CICS ENQUEUE RESOURCE WILL HANG CICS OS/2 AT PTF23.
  461.        -PN36110
  462.  
  463.     o  SEND TEXT WITHOUT THE ERASE OPTION CAUSES THE SCREEN TO CLEAR.
  464.        -PN36202
  465.  
  466.    Fixed by IBM PTF 23
  467.    ----------V2.5.15--
  468.     o  PRINTING A 132 COLUMNS FILE UNDER CICS/OS2 THE FIELDS LENGTH ARE
  469.        NOT RESPECTED.
  470.        -PN21953
  471.  
  472.     o  SOURCE FILE IS MISSING FOR SAMPLE PROGRAM FAAUTPUC.
  473.        -PN13891
  474.  
  475.     o  EXTENDED ATTRIBUTES ARE NOT RESET WHEN REPLACED WITH AN ORDER THAT
  476.        HAS NO EXTENDED ATTRIBUTES.
  477.        -PN18313
  478.  
  479.     o  IF ATTRIBUTES ARE ENTERED INTO A BMS MAP ATTR FIELD THE ATTRIBUTES
  480.        MAY BE IGNORED ON THE MAP SEND/RECEIVE.
  481.        -PN27313
  482.  
  483.     o  DURING SHUTDOWN, VARIOUS TRAP 00D'S OCCUR.
  484.        -PN27866
  485.  
  486.     o  EIBFN SET TO X'1002' = ASKTIME AT RE ENTRY INTO A
  487.        PSEUDO-CONVERSATIONAL TRANSACTION, AFTER PTF16.
  488.        -PN28226
  489.  
  490.     o  CURSOR POSITIONING WRONG
  491.        -PN29419
  492.  
  493.     o  ON A START TRANSACTION FROM A HOST CICS 3.3 SYSTEM, AN ABENDATNI
  494.        OCCURS AFTER A DEALLOCATE NORMAL IS RETURNED.
  495.        -PN29609
  496.  
  497.     o  3270 DATASTREAM MONO FIELDS ARE BEING DISPLAYED IN 4-COLOR MODE WHEN
  498.        THERE ARE EXTENDED COLORS PLACED ON THE SCREEN AFTER PTF19.
  499.        -PN30284
  500.  
  501.     o  WRITE TO A FILE WITH SYSID GIVES OK RESPONSE TO WRITE AND THEN GETS
  502.        ABENDATNI.
  503.        -PN30412
  504.  
  505.     o  INVALID USE OF SET OPERAND OF EXEC CICS LOAD PROGRAM PRODUCES BAD
  506.        OUTPUT BUT NOT ERROR MESSAGE.
  507.        -PN30651
  508.  
  509.     o  WITH STARTRE/REQID, IF THE BROWSE IS INTERRUPTED WITH A DIRECT READ,
  510.        THE NEXT READNEXT GETS RECORD OF THE DIRECT READ +1.
  511.        -PN31179
  512.  
  513.     o  CICS OS/2 ISSUED MESSAGE FAA2220 INTERNAL COMMUNICATIONS ERROR WHILE
  514.        TRANSACTION ROUTING.
  515.        -PN31190
  516.  
  517.     o  SHUTDOWN OF OS/2 2.0 WILL NOT COMPLETE IF CICS OS/2 IS RUNNING.
  518.        -PN31864
  519.  
  520.     o  FILE THAT HAS A CLOSE WAIT AND OPEN RESET DONE CANNOT BE USED BY
  521.        ANOTHER TASK, NOTOPEN IS RETURNED.
  522.        -PN32146
  523.  
  524.     o  TRANSACTION TRIGGERED FROM TDQ WRITE FROM HOST CICS REQUIRES ENTER
  525.        KEY TO FREE TERMINAL SESSION AND RELEASE TDQ ENQUEUE.
  526.        -PN32292
  527.  
  528.     o  CICS OS/2 DOES NOT CURRENTLY SUPPORT ANIMATOR/2.
  529.        -PN32910
  530.  
  531.     o  IF A TEMPSTORE CI SIZE OF 32767 IS SET IN THE SIT, A TRAPD WILL
  532.        OCCUR WHEN YOU ATTEMPT TO RUN A TRANSACTION.
  533.        -PN33220
  534.  
  535.     o  TRANSLATOR GIVES ERROR FAA0173E INCORRECTLY WHEN USING A VARIABLE
  536.        WITH AN ALPHA CHARACTER FOR THE LENGTH OPTION.
  537.        -PN33867
  538.  
  539.     o  AN EXEC CICS ENQUEUE RESOURCE WILL HANG CICS OS/2 AT PTF23.
  540.        -PN36110
  541.  
  542.    Added in V2.5.13
  543.    ================
  544.     o  The CICS Translator reserved word DFHVALUE was not recognized by the
  545.        integrated preprocessor.
  546.        -PAO11326
  547.  
  548.     o  The DFHCNV process returned incorrect results in certain
  549.        circumstances.
  550.        -PAO12977
  551.  
  552.    Fixed by IBM PTF 22
  553.    ----------V2.5.13--
  554.     o  PEER TO PEER NETBIOS COMMUNICATIONS FAIL UNDER OS/2 2.0.
  555.        -PN21507
  556.  
  557.    Added before V2.5.13
  558.    ====================
  559.     o  This update disk includes fixes included in IBM PTF22. Details of
  560.        these fixes are in the IBM on-disk document IBMPTF22.DOC. This IBM
  561.        PTF includes enhancements made to the External Call Interface (ECI)
  562.        to CICS OS/2. Details of this enhancement can be found in the
  563.        document ECI.DOC which is in your OS2DSD subdirectory.
  564.  
  565.     o  DFHCNV macro generation has been changed to generate a data type of
  566.        PD for zoned decimal fields, for example PIC S9(4) fields.
  567.        -PAO12503 added V2.5.12
  568.  
  569.     o  If you were using Workbench V3.0, CICS OS/2 sessions sometimes hung
  570.        if you started CICS OS/2 online using the Multiple Session Debugger
  571.        facility in CICS OS/2 Option.
  572.  
  573.     o  CICSTCL.CMD used COBOL.LIB instead of COBLIB.LIB.
  574.  
  575.     o  The preprocessor imposed a limit of 80 characters on the length of a
  576.        COBOL source line. The correct limit of 255 is now used.
  577.  
  578.     o  The preprocessor returned an error if you tried to use the CICSTRL
  579.        environment variable.
  580.  
  581.     o  When in BMSSCRNS, setting the EXTATT mapset verb to YES did not
  582.        generate the attribute fields (C, P, H, and V) in the COBOL copybook.
  583.  
  584.     o  When in BMSSCRNS, map-names of seven characters were sometimes
  585.        truncated to six characters if the Insert key was on when the map
  586.        was named or renamed.
  587.  
  588.     o  When in BMSSCRNS, repeatedly saving and generating mapsets resulted
  589.        in the first map in the set being deleted and replaced with a copy of
  590.        the last map in the set.
  591.  
  592.    ENHANCEMENTS IN THIS RELEASE
  593.    ============================
  594.    The following enhancements are made in this release.
  595.  
  596.     o  The IBM CICS Translator directive NOPROCESSCOPY is now supported when
  597.        you compile using the integrated preprocessor.
  598.        -PAO11633
  599.  
  600.     o  The integrated preprocessor now supports COPY statements in the
  601.        Procedure Division, provided the COPY-files do not contain EXEC CICS,
  602.        SERVICE RELOAD, DFHRESP, DFHRESP2, or DFHVALUE statements.
  603.        -PAO11633
  604.  
  605.    Added in V2.5.13
  606.    ================
  607.    The enhancements listed in this and any following similar section(s),
  608.    which were included in earlier maintenance releases, are also in this
  609.    release.
  610.  
  611.    None.
  612.  
  613.    Added before V2.5.13
  614.    ====================
  615.     o  This update disk includes the IBM-supplied batch files CICSCOMP,
  616.        CICSTCL and CICSLINK. These .CMD files enable you to perform batch
  617.        translate, compile and links easier.
  618.  
  619.     o  This release contains a demonstration of CICS OS/2 Option working in
  620.        conjunction with the Common Communications Interface (CCI) and Dialog
  621.        System. To install this demonstration you should perform the
  622.        following steps:
  623.  
  624.         o  copy the file DSDEMO.@IP from the installation disk into a
  625.            temporary directory on your computer
  626.         o  make the temporary directory your current directory, and enter:
  627.  
  628.                pkunzip dsdemo.@ip
  629.  
  630.         o  read the file DSDEMO.DOC on how to set up and run the
  631.            demonstration suite of programs.
  632.  
  633.     o  This release of CICS OS/2 Option for Micro Focus COBOL/2 Workbench
  634.        features syncpoint coordination. This enhances CICS OS/2 interfacing
  635.        to Micro Focus IMSVS86, IBM Database Manager (DBM), and XDB Systems
  636.        Extended Database System (XDB). For further details on syncpoint
  637.        coordination see section CICS OS/2 Option Syncpoint Coordination in
  638.        this on-disk document.
  639.  
  640.     o  This release of CICS OS/2 Option for Micro Focus COBOL/2 Workbench
  641.        features CICS OS/2 Option Execution Control (MC2INIT). This provides
  642.        added control to CICS OS/2 startup, offering greater control over
  643.        debugging and the run-time environment. For further details on
  644.        MC2INIT see section CICS OS/2 Option Execution Control (MC2INIT) in
  645.        this on-disk document.
  646.  
  647.     o  The Filecopy utility can be used to convert Btrieve format files into
  648.        Micro Focus format, and vice versa.
  649.  
  650.     o  Support has been added for Call- and Exec-level DL/1 when used in
  651.        conjunction with the ASCII version of the Micro Focus IMS Option.
  652.  
  653.     o  Support has been added for the ASCII version of the XDB database,
  654.        which closely emulates the functionality of IBM's DB2 database.
  655.  
  656.     o  You can use the CICS OS/2 Option DFHCNV Generator to generate DFHCNV
  657.        macros for translating data between EBCDIC (mainframe) and ASCII
  658.        (PC).
  659.  
  660.     o  The BMS Screens utility can be used to create BMS macros. Its
  661.        powerful screen painting functions include block move, cut and paste,
  662.        as well as the ability to set text video attributes such as color,
  663.        intensity, reverse video, and blinking.
  664.  
  665.    KNOWN ERRORS IN THIS RELEASE
  666.    ============================
  667.     o  If you get a load failure 173 on DIRECT.GNT after executing certain
  668.        main menu functions, you can correct it by amending MCMENU.MNU. Add
  669.        an :OPT-LIBRARY entry as follows to the section of the menu that
  670.        returned this error:
  671.  
  672.            opt-library: $COBDIR\COBCLI.LBR
  673.  
  674.        Delete or rename the current MCMENU.MNT and restart the CICS OS/2
  675.        Micro Focus menu.
  676.        -PAO11743 & PAO13532 added V2.5.15
  677.  
  678.     o  If you are using a Beta version of COBOL Workbench V3.0, the
  679.  
  680.            ANIM:USERSESSION"PM"
  681.  
  682.        command does not work. To solve this problem you should use the
  683.  
  684.            ANIM:
  685.  
  686.        command.
  687.  
  688.     o  To use Xilerator from Micro Focus Toolset V2.5 with this CICS OS/2
  689.        Option system you must copy the file XIL.EXE to a new file name
  690.        called PXIL.EXE.
  691.  
  692.     o  If you invoke the Mainframe Development Menu Workbench from the F10
  693.        key on the CICS OS/2 Option main menu, CICS OS/2 Option functions are
  694.        not available when you return to CICS OS/2 Option.
  695.  
  696.        You can solve this problem by editing the file MCMENU.MNU. You
  697.        should change line 33 from:
  698.  
  699.            F10 :RUN: CLI
  700.  
  701.        to:
  702.  
  703.            F10 :CALL-MENU: CLI.MNU
  704.  
  705.        You should then delete the file MCMENU.MNT.
  706.  
  707.     o  A system hang occurs if you use F3=CICS+CHECK on a program that
  708.        contains either $SET SQL or COBOL/2 dynamic calls.
  709.  
  710.        To perform either of these functions you should use the separate
  711.        options F4=Trans, and F5=Compile.
  712.  
  713.     o  Before you can use the supplied FCPY transactions you must run the
  714.        FDAT.BMS file through the IBM BMS translator to generate a mapset
  715.        file.
  716.  
  717.     o  Copying a COBOL/2 file to a new CICS OS/2 VSAM file does not behave
  718.        as documented on page 9-5 of the CICS OS/2 Option for Micro Focus
  719.        COBOL/2 Workbench User Guide.
  720.  
  721.        To copy from a COBOL/2 file to a new CICS OS/2 VSAM file you should
  722.        do the following:
  723.  
  724.         -  Define the base KSDS in the FCT with any alternate keys
  725.         -  Define all the alternate keys in the FCT for the base KSDS
  726.         -  Close down CICS OS/2 using the CQIT command
  727.         -  Restart CICS OS/2
  728.         -  Issue the command:
  729.  
  730.                CECI SET FILE (file-name) OPEN RESET
  731.  
  732.            for the base KSDS
  733.         -  Issue the command:
  734.  
  735.                CECI SET FILE (file-name) CLOSED
  736.  
  737.            for all alternate indexes
  738.         -  Process the FCPY transaction to load the base KSDS
  739.         -  Issue the command:
  740.  
  741.                CECI SET FILE (file-name) CLOSED
  742.  
  743.            for the base KSDS
  744.         -  Issue the command:
  745.  
  746.                CECI SET FILE (file-name) OPEN
  747.  
  748.            for the base KSDS
  749.         -  Issue the command:
  750.  
  751.                CECI SET FILE (file-name) OPEN
  752.  
  753.            for all the alernate indexes
  754.  
  755.    DOCUMENTATION OMISSIONS AND ERRORS
  756.    ==================================
  757.    
  758.    Micro Focus CICS OS/2 Option User Guide
  759.    =======================================
  760.  
  761.    Chapter 2 (Installation and Configuration)
  762.    ------------------------------------------
  763.     o  Page 2-9. In the section "Workbench Configuration File" in the
  764.        chapter "Installation and Configuration", amend the line following
  765.        point 5 to read:
  766.  
  767.            extensions ccp cbl cpy bms trl {space}
  768.  
  769.    Chapter 9 (Filecopy)
  770.    --------------------
  771.     o  Page 9-6. Add the following new section:
  772.        
  773.            Copying Mainframe VSAM KSDS File to CICS OS/2
  774.            ----------------------------------------------
  775.            To copy a VSAM KSDS File to CICS OS/2, follow the steps below:
  776.        
  777.             1. Download the file from the mainframe. Do not specify ASCII or
  778.                CRLF on the receive command.
  779.        
  780.             2. Use the Workbench File Loader (WFL) to convert the file to
  781.                ASCII record sequential (see your Workbench Reference for
  782.                further information).
  783.        
  784.             3. In CICS OS/2, create an FCT entry for the CICS OS/2 file you
  785.                want to create with FCPY. Specify it as KSDS, and specify the
  786.                record lengths and key position(s).
  787.        
  788.             4. Take CICS OS/2 down and restart to make the new resource
  789.                definition active.
  790.        
  791.             5. Run FCPY. Set:
  792.        
  793.                    CICS file Mode:   O
  794.                    OS/2 file type:   F
  795.                    CICS file name:   file-name
  796.                    OS/2 file name:   path to file
  797.        
  798.                Press Enter to create the file.
  799.  
  800.        -NWB20682 added V2.5.13
  801.    
  802.    On-disk Document CICSOSRN.DOC (Release Notes)
  803.    =============================================
  804.     o  The following section should be added after the section
  805.        "Introduction":
  806.  
  807.            SECURITY KEYS AND ADD-ON PRODUCTS
  808.  
  809.            This section is only relevant if you have been supplied with
  810.            a security key.
  811.  
  812.            Upgradable Security Keys
  813.            ========================
  814.            In the past, each security key could be used in conjunction with
  815.            only one software package. This meant that a user running six
  816.            separate software packages, each encrypted to run with a
  817.            different security key, would need a stack of six security keys
  818.            plugged into the back of the machine. With each security key
  819.            adding approximately 2 inches to the length of this stack, this
  820.            system was often inconvenient and irritating to use.
  821.  
  822.            The problems caused by these long chains of security keys have
  823.            been solved by the development of the UPGRADABLE SECURITY KEY.
  824.            This allows several encrypted products to use the same security
  825.            key at once.
  826.  
  827.            This is how they work.
  828.  
  829.            When you received your original copy of COBOL/2 or Toolset you
  830.            also received a Security Key. This is a BASE security key.
  831.  
  832.            With your add-on product you will have been given an ADD-ON
  833.            Security key. This security key is useless on its own. However,
  834.            it contains the codes required to unscramble the
  835.            security-protected add-on, and this information can be
  836.            transferred to the BASE security key in a few easy steps. You
  837.            will simply need to plug the ADD-ON security key into the BASE
  838.            security key and run a simple utility program. Your computer will
  839.            then be able to run the add-on product, and you can remove the
  840.            ADD-ON security key.
  841.  
  842.            At this point the ADD-ON key cannot be used for another upgrade.
  843.            However, you can downgrade the BASE key again onto the ADD-ON
  844.            key. If you do this the BASE key will no longer support the
  845.            add-on, and you will be able to use the ADD-ON key to upgrade
  846.            another BASE key.
  847.  
  848.            It should be clear from this that it is impossible to have more
  849.            than one BASE key upgraded by the same ADD-ON key at the same
  850.            time. If you want to enable your product on a different machine,
  851.            you will first need to disable your product on its current
  852.            machine by downgrading onto the original key provided with your
  853.            product. So the new system retains the flexibility of the old
  854.            system. All that is lost is the inconvenience.
  855.  
  856.            Upgrading and Downgrading the Base Security Key
  857.            -----------------------------------------------
  858.            Note that if you wish to install the add-on product on another
  859.            machine, you will need to do a downgrade on the original machine,
  860.            followed by an upgrade on the new one.
  861.  
  862.            Upgrading the Base Key:
  863.  
  864.             1. Plug the Micro Focus BASE security key into the parallel port
  865.                on your computer.
  866.  
  867.             2. Plug the ADD-ON security key into the back of the BASE
  868.                security key.
  869.  
  870.             3. Check that both security keys are recognized by typing
  871.  
  872.                    INSTKEY QUERY
  873.  
  874.                at the command-line. This will display the name of the
  875.                product encoded in the ADD-ON security key. The query will
  876.                also tell you if it has not sensed either of the two security
  877.                keys.
  878.  
  879.             4. Transfer information from the ADD-ON to the BASE security key
  880.                with the command-line:
  881.  
  882.                    INSTKEY INSTALL
  883.  
  884.            The BASE security key will now support the add-on product as well
  885.            as the base product.
  886.  
  887.            Downgrading the Base Key:
  888.  
  889.            Downgrading is achieved in almost exactly the same way, except
  890.            that in step 4 you will need to type
  891.  
  892.                INSTKEY DEINSTALL
  893.  
  894.            If you perform an upgrade followed by a downgrade, both the BASE
  895.            and the ADD-ON security keys will be in exactly the same state as
  896.            they were prior to the upgrade."
  897.  
  898.     o  The following section should be added after the section "Restrictions
  899.        in the Software":
  900.  
  901.            RUNNING CICS OS/2 IN AN IBM LAN NETBIOS ENVIRONMENT
  902.            ---------------------------------------------------
  903.             o  The number of NETBIOS resources defined in Communications
  904.                Manager must be at least 40 greater than the number defined
  905.                in the IBMLAN.INI file on the LAN server. This difference
  906.                must be maintained even if extra resources are used by other
  907.                applications. Failure to maintain this difference will result
  908.                in unpredictable behavior when trying to use the server.
  909.  
  910.             o  The CICS OS/2 system on the LAN server must be on the same
  911.                PTF level as the CICS OS/2 system on the node.
  912.  
  913.    On-disk document MC2INIT.DOC
  914.    ============================
  915.     o  Add the following note at the end of the section "Using MC2INIT":
  916.  
  917.            Note:  The number of Animator or other debugger sessions you can
  918.                   run simultaneously depends on the amount of memory you
  919.                   have installed in your machine.
  920.        -PAO12010 added V2.5.12
  921.  
  922.    User Guide
  923.    ==========
  924.  
  925.    Chapter 2 (Installation and Configuration)
  926.    ------------------------------------------
  927.     o  The following text should be added at the end of the description of
  928.        the BMSMAP environment variable:
  929.  
  930.            BMSMAP is only used by the BMS mapset translator to find this
  931.            file. The CICS OS/2 online system uses the FCT to find this file.
  932.            If you move FAAMSFSC.BTR to a different directory, change its
  933.            entry in the FCT to show the new path.
  934.  
  935.    CICS OS/2 OPTION SYNCPOINT COORDINATION
  936.    =======================================
  937.  
  938.    Overview
  939.    ========
  940.    This section should be regarded as an additional section to your CICS
  941.    OS/2 Option User Guide. It describes Syncpoint Coordination, which
  942.    enhances CICS OS/2 interfacing to Micro Focus IMSVS86, IBM Database
  943.    Manager (DBM) and/or XDB Systems Extended Database System (XDB).
  944.  
  945.    It enables applications using these systems to behave like similar
  946.    370-based applications using IMS or DB2. The Syncpoint Coordination
  947.    feature also takes over connecting to and starting IMSVS86, DBM and XDB.
  948.  
  949.    It provides the following extra functions for CICS OS/2:
  950.  
  951.     o  Implicit Commit for IMS, DBM and XDB databases at end of CICS task.
  952.  
  953.     o  Rollback for IMS, DBM and XDB databases at CICS task abend.
  954.  
  955.     o  "Start database using" for a specific DBM database at CICS OS/2 start
  956.        if requested.
  957.  
  958.     o  Commit or Rollback of IMS, DBM and XDB databases at CICS Syncpoint
  959.        based on whether ROLLBACK was requested or ROLLEDBACK was signaled.
  960.  
  961.     o  Support for more than one DBM database during a single execution of
  962.        CICS OS/2.
  963.  
  964.     o  Support of DBM calls from .INT and .GNT code.
  965.  
  966.     o  Optional automatic restart of a DBM database that was not closed
  967.        properly during the previous execution.
  968.  
  969.     o  Optional user logon for XDB at CICS OS/2 start.
  970.  
  971.     o  CICS syncpoint at IMS TERM call or command
  972.  
  973.    Software Requirements
  974.    =====================
  975.    To use Syncpoint Coordination support you must have one or more of the
  976.    following:
  977.  
  978.     o  IMS 2.5.00 or later
  979.  
  980.     o  XDB version 2.4 or later
  981.  
  982.     o  IBM DBM 1.2 or later.
  983.  
  984.    Components
  985.    ==========
  986.    This section lists the files that make up the Syncpoint Coordination
  987.    feature. Update installs them all in your CICS OS/2 system directory,
  988.    \CICS120\OS2DSD.
  989.  
  990.    There are two new executable modules:
  991.  
  992.     o  MC2SYNC0.DLL Logic for Syncpoint Coordination
  993.  
  994.     o  MC2SYNC1.DLL INSTALLF and assembler subroutines
  995.  
  996.    There are two sample modules to initialize and shutdown Syncpoint
  997.    Coordination, delivered in source code form:
  998.  
  999.     o  FAAOIS04.CCA
  1000.  
  1001.     o  FAAOISPT.CCA
  1002.  
  1003.    These are replacements for the existing FAAOIS04.CCP and FAAOISPT.CCP
  1004.    files. The extensions are changed so that the existing files are not
  1005.    overwritten when you apply the update. This enables you to merge any code
  1006.    of your own with the new modules. 
  1007.  
  1008.    Also supplied is a COBOL COPY file, MC2SYNCC.CPY. You need this to
  1009.    compile FAAOIS04.CCA and FAAOISPT.CCA.
  1010.  
  1011.    Using Syncpoint Coordination
  1012.    ============================
  1013.    The Syncpoint Coordination feature must be enabled before you begin a
  1014.    CICS OS/2 session. The code to initialize MC2SYNC0.DLL (syncpoint logic)
  1015.    must be included in FAAOIS04.DLL. FAAOIS04.DLL executes at Program Load
  1016.    Table Post Initialization (PLTPI) each time you start CICS OS/2. It is
  1017.    provided by IBM as a facility for user initialization routines.
  1018.  
  1019.    MC2SYNC0.DLL registers the entry-point SQLINIT and DBM entry-points
  1020.    required to run .INT and .GNT applications using the associated database
  1021.    products. Code added to FAAOISO4 for this purpose should not be carried
  1022.    forward. Each time you close down CICS OS/2 you must also close down
  1023.    MC2SYNC0.DLL. The code to do this goes into FAAOISPT.DLL.
  1024.  
  1025.    Modules FAAOIS04 and FAAOISPT are supplied by IBM as customization
  1026.    facilitities to enable the user to insert functions into CICS OS/2
  1027.    startup and close down. FAAOIS04.DLL is executed, for each process, after
  1028.    CICS OS/2 task initialization at startup. FAAOISPT.DLL is executed, for
  1029.    each process, each time you close CICS OS/2 down.
  1030.  
  1031.    The source code for these modules is in .CCP files. The .CCA files
  1032.    provided with this update (see previous section) are intended as
  1033.    replacements for the .CCP files. If you have added your own code to these
  1034.    modules, you should merge it into .CCA files.
  1035.  
  1036.    Then, follow the steps below:
  1037.  
  1038.     1. Backup the existing FAAOIS04 and FAAOISPT .DLL and .CCP files.
  1039.  
  1040.     2. Copy FAAOIS04.CCA to FAAOIS04.CCP, and FAAOISPT.CCA to FAA0ISPT.CCP.
  1041.  
  1042.     3. Edit the code for DBM, XDB and IMS code in FAAOISPT.CCP to startup
  1043.        and connect your database system the way you want. See the sections
  1044.        Micro Focus IMSVS86 Support, IBM OS/2 Database Manager Support or XDB
  1045.        Support. You can also turn off initialization for databases you do
  1046.        not have connected. This avoids MC2SYNC0.DLL sending error messages
  1047.        to the console.
  1048.  
  1049.     4. Use CICS OS/2 Option translate, compile and link functions to
  1050.        generate FAAOIS04.DLL and FAAOISPT.DLL from the .CCP files (see your
  1051.        CICS OS/2 User Guide for details).
  1052.  
  1053.    Micro Focus IMSVS86 Support
  1054.    ===========================
  1055.    You have two choices for starting IMSVS86 with Syncpoint Control:
  1056.  
  1057.     o  Static Start
  1058.  
  1059.     o  Dynamic start.
  1060.  
  1061.    These two start options are controlled in the CICS PLT module FAAOIS04. A
  1062.    dynamic start loads the IMS support for the process but does not start
  1063.    the database engine. The database engine is started on the first
  1064.    application call to IMS. A static start loads the IMS support for the
  1065.    CICS process and starts the database engine if it is not already started.
  1066.  
  1067.    These two options (the static and dynamic start) are provided so you can
  1068.    choose when the overhead of starting the IMS engine is incurred. If it is
  1069.    possible that the IMS engine will never be used during an execution or if
  1070.    it is important to have the CICS system available for non-IMS
  1071.    transactions in advance of the IMS support, use a dynamic start. If
  1072.    degraded performance on the first IMS transaction of an execution of CICS
  1073.    is undesirable, then the use a static start.
  1074.  
  1075.    The source code for IMSVS86 support in FAAOIS04.CCP looks like this:
  1076.  
  1077.         *    - IMS control
  1078.         *    set mc2-static-IMS-start    to true
  1079.              set mc2-dynamic-IMS-start   to true
  1080.         *    set mc2-IMS-dormant         to true
  1081.  
  1082.    Comment out the lines you do not want to execute. Only one line should
  1083.    be active. Set MC2-IMS-DORMANT to TRUE if you do not want MC2SYNC0.DLL to
  1084.    start IMSVS86 at all.
  1085.  
  1086.    IBM OS/2 Database Manager Support
  1087.    =================================
  1088.    The code in FAAOIS04.CCP for Database Manager control looks like this:
  1089.  
  1090.         *    - IBM DBM control
  1091.              set mc2-support-DBM-restart to true
  1092.              move 'SAMPLE' to mc2-sync-DBM-database-name
  1093.         *    set mc2-deferred-DBM-start  to true
  1094.  
  1095.    If you are not using DBM at all, remove the comment on the line to set
  1096.    mc2-deferred-dbm-start.
  1097.  
  1098.    Remove the ALIGN(2) directive from CICSOS2.DIR when compiling CICS OS/2
  1099.    programs to work with DBM. DBM works to a system based on ALIGN(8) which
  1100.    is the default. The ALIGN(2) directive can cause large unidentifiable SQL
  1101.    codes to be returned due to an alignment mismatch between the
  1102.    application and the DBM engine.
  1103.  
  1104.    There are two ways to run CICS OS/2 with DBM.
  1105.  
  1106.    Method 1 (Recommended):
  1107.    -----------------------
  1108.    Use this method when your programs all access the same database. Specify
  1109.    the following options when checking programs that access the database.
  1110.    Change the parameter for SQLDB to the name of your database (in the
  1111.    example below it is shown as SAMPLE).
  1112.  
  1113.         CBL XOPTS(COBOL2) 
  1114.         $set ans85 
  1115.         remove"id" vsc2
  1116.         $set sql sqlaccess() sqlbind() sqldb(SAMPLE) nosqlpass 
  1117.         $set nosqlinit
  1118.  
  1119.    Edit the code in FAAOIS04.CCP (shown at the start of this section) to
  1120.    move the database name to mc2-sync-DBM-database-name. Comment out the
  1121.    line which sets mc2-deferred-DBM-start to true.
  1122.  
  1123.    If you get unexpected SQL errors at run-time which suggest that the
  1124.    program is not bound, check that you have specified the database name
  1125.    correctly.
  1126.  
  1127.    Method 2:
  1128.    ---------
  1129.    Use this method if different applications access different databases.
  1130.  
  1131.    Use the same Checker options as in method 1 (see above), but specify:
  1132.  
  1133.        $set sqlinit
  1134.  
  1135.    instead of:
  1136.  
  1137.        $set nosqlinit
  1138.  
  1139.    In FAAOIS04.CCP, set MC2-DEFERRED-DBM-START to TRUE. Comment out the line
  1140.    which supplies the database name.
  1141.  
  1142.    The DBM is started on first DBM access and the requested database will be
  1143.    connected. When an application runs requesting a different database the
  1144.    Micro Focus support code disconnects from the previous database and
  1145.    connects to the new one.
  1146.  
  1147.    XDB Systems, Inc. Extended Database System Support
  1148.    ==================================================
  1149.    The code in FAAOIS04.CCP for XDB control is shown below. If you are not
  1150.    using XDB, set MC2-XDB-DORMANT to TRUE.
  1151.  
  1152.         *     - XDB control
  1153.         *    set mc2-activate-XDB        to true
  1154.              set mc2-XDB-dormant         to true
  1155.              set mc2-normal-XDB-start    to true
  1156.         *    set mc2-foreground-XDB-only to true
  1157.         *    set mc2-background-XDB-only to true
  1158.  
  1159.    Follow the steps below to use syncpoint control with XDB:
  1160.  
  1161.     1. Do not use the LOGON, LOGOFF, or LOGOFFRUN directives when you check
  1162.        or compile XDB programs.
  1163.  
  1164.     2. Remove the ALIGN(2) directive from CICSOS2.DIR when compiling CICS
  1165.        OS/2 programs to work with DBM. DBM works to a system based on
  1166.        ALIGN(8) which is the default. The ALIGN(2) directive can cause large
  1167.        unidentifiable SQL codes to be returned due to an alignment mismatch
  1168.        between the application and the DBM engine.
  1169.  
  1170.     3. Ensure that enough named pipes are configured to support at least all
  1171.        the CICS OS/2 process (the number of foreground terminals plus
  1172.        minimum number of free tasks). This is done by executing XDBSRVCO,
  1173.        select (F5) Multi-user Configuration, select (F5) Named Pipes Option,
  1174.        set the (F1) Named Pipes Interface to ON, and set the (F2) Named
  1175.        Pipes threads to at least 4 or up to the maximum of 10.
  1176.  
  1177.     4. Set mc2-activate-XDB to true to connect to XDB at CICS OS/2 startup.
  1178.  
  1179.    Optionally you may also specify a user ID by adding to FAAOIS04.CCP
  1180.    the statement:
  1181.  
  1182.        move 'MYID' to mc2-sync-XDB-user-ID
  1183.  
  1184.    You can limit XDB support to only CICS foreground or only CICS background
  1185.    processes, reducing the XDB resources required. Set the flags
  1186.    MC2-FOREGROUND-XDB-ONLY and MC2-BACKGROUND-XDB-ONLY as appropriate.
  1187.  
  1188.    Foreground tasks are CICS terminals (for example V123 and V124), and
  1189.    background are non terminal tasks (for example @03@).
  1190.  
  1191.    Error Messages
  1192.    ==============
  1193.    Error messages are delivered to the CICS OS/2 console via EXEC CICS WRITE
  1194.    OPERATOR commands. The following error messages are currently
  1195.    implemented:
  1196.  
  1197.     MC20001I %1 database restarted successfully. 
  1198.     MC20002E %1 database start error. SQLCODE=%2 
  1199.     MC20003E Invalid syncpoint termination request. 
  1200.     MC20004E Invalid syncpoint initialize request. 
  1201.     MC20005E CICS OS/2 release level mismatch. 
  1202.     MC20006E Failed to address %1(%2). RC=%3 
  1203.     MC20007I CICS Syncpoint failed. EIBRESP=%1 
  1204.     MC20008E Failed to start Database Manager. RC=%1
  1205.     MC20009E Failed to install exit processor. RC=%1 
  1206.     MC20010E Control request not START or STOP. 
  1207.     MC20011E XDB error message MC20012E XDB libraries not found. 
  1208.     MC20013E IMS failed to activate. 
  1209.     MC20014E IMS libraries not found.
  1210.  
  1211.    Trace Entry Documentation
  1212.    =========================
  1213.    Trace entries are generated for start and stop of IMS, DBM and XDB,
  1214.    connect to DBM databases, COMMIT and ROLLBACK, and messages above.
  1215.    Messages use user trace ID 198 while the rest use trace ID 199. These
  1216.    trace entries display in the trace file as UF198 and UF199.
  1217.  
  1218.    CICS OS/2 OPTION EXECUTION CONTROL (MC2INIT)
  1219.    ============================================
  1220.  
  1221.    Overview
  1222.    ========
  1223.    This section should be regarded as an additional section to your CICS
  1224.    OS/2 Option User Guide. It describes the CICS OS/2 Option Execution
  1225.    Control (MC2INIT) feature which provides added control to CICS OS/2
  1226.    startup, offering greater control over debugging and the run-time
  1227.    environment.
  1228.  
  1229.    The major benefits of MC2INIT are:
  1230.  
  1231.     o  Debug of more than one process or terminal at a time.
  1232.  
  1233.     o  Debug of PM, Dialog Manager, or Dialog System transactions.
  1234.  
  1235.     o  Color support for Animator.
  1236.  
  1237.     o  Individual configuration for any or all processes for a given
  1238.        execution of CICS OS/2. You no longer have to reduce the number of
  1239.        CICS OS/2 background tasks to one, in order to enable animation of
  1240.        CICS tasks which run in background processes. Background processes
  1241.        support non-facility tasks, printer tasks, and tasks attached to
  1242.        future devices.
  1243.  
  1244.     o  VIO window for the operator interface to Animator.
  1245.  
  1246.     o  Use of other tools and debuggers such as Microsoft Source Profiler.
  1247.  
  1248.     o  Support for Xilerator
  1249.  
  1250.     o  Support for Microsoft CodeView and Source Profiler
  1251.  
  1252.     o  Support for any command line driven debugger or controlling tool
  1253.  
  1254.     o  A control screen size of greater than 25 lines for Animator, Advanced
  1255.        Animator, and Xilerator.
  1256.  
  1257.     o  External user control of all run time switches. This also provides
  1258.        greater consistency; CICS OS/2 as delivered from IBM starts processes
  1259.        with different switches (-F or +F) depending on the type of process.
  1260.  
  1261.    Components
  1262.    ==========
  1263.    CICS OS/2 Option Execution Time Control (MC2INIT) consists of the
  1264.    following new executable modules:
  1265.  
  1266.     MC2INIT1.EXE
  1267.     MC2INIT1.LBR
  1268.     MC2INIT2.DLL
  1269.  
  1270.    There is a replacement for an existing CICS OS/2 executable module:
  1271.  
  1272.        FAAOMPML.EXA is a replacement for FAAOMPML.EXE
  1273.  
  1274.    Before using Execution Time Control, take a backup of FAAOMPML.EXE and
  1275.    then copy the new file, FAAOMPML.EXA to FAAOMPML.EXE.
  1276.  
  1277.    There is also a sample configuration file:
  1278.  
  1279.        MCO2.CFA
  1280.  
  1281.    You can use this as a replacement for your current MCO2.CFG file. You
  1282.    may want to include any changes you have made to MCO2.CFG in MCO2.CFA.
  1283.    Then take a backup of MCO2.CFG, and copy MCO2.CFA to MCO2.CFG.
  1284.  
  1285.    Using MC2INIT
  1286.    =============
  1287.    MC2INIT modifies CICS OS/2 startup procedures to provide greater control
  1288.    over the start of debug sessions. This control is supplied through the
  1289.    CICS OS/2 Option startup file, MCO2.CFG. A number of new tags have been
  1290.    added to this file to provide individual control of CICS OS/2 tasks. A
  1291.    sample file, named MCO2.CFA is included with this update (see previous
  1292.    section).
  1293.  
  1294.    We suggest you use MCO2.CFA as a replacement for your existing MCO2.CFG,
  1295.    modifying it to suit your own needs. Read the rest of this document
  1296.    carefully before making any changes to it.
  1297.  
  1298.    The Workbench libraries must be available at startup along the path
  1299.    defined by the COBDIR environment variable. The CICSWRK environment
  1300.    variable must be set, and include the directory where the CICS OS/2 DLLs
  1301.    are located. CICSWRK must also include the directory holding
  1302.    MC2INIT1.EXE, MC2INIT2.DLL, and MCO2.CFG. MC2INIT1.LBR must be in the
  1303.    same directory with MC2INIT1.EXE.
  1304.  
  1305.    Errors are reported in a logfile in the CICS OS/2 system directory. The
  1306.    log file name is MC2INIT.LOG. Exception conditions only are normally
  1307.    placed in this file. For further information on a failure set the
  1308.    environment variable MC2TRACE to any value (for example, SET MC2TRACE=Y).
  1309.    The actual setting is irrelevant because MC2INIT only checks for the
  1310.    presence of the variable. If the environment variable is present, the
  1311.    startup module produces trace information to help with problem
  1312.    determination and places it in MC2INIT.LOG. This information is
  1313.    primarily intended for Micro Focus support personnel.
  1314.  
  1315.    Configuration File
  1316.    ==================
  1317.    The new tags for MCO2.CFG supported by MC2INIT are listed below. The
  1318.    defaults supplied in MCO2.CFA are listed below each tag.
  1319.  
  1320.  
  1321.        [MC2INIT1-ATTRIBUTES]       Control Animator screen colors
  1322.        ;SYS-ATT-4: YELLOW ON RED   Sets Animator menu key tops to red on
  1323.                                    yellow. This line is commented out.
  1324.                                    Remove the semicolon for it to take
  1325.                                    effect. See your Workbench Reference for
  1326.                                    information on colorizing screens.
  1327.  
  1328.        [MC2INIT1-TRACE]            Output trace messages for MC2INIT
  1329.        OFF                         processes. Turned off by default.
  1330.  
  1331.        [MC2INIT1-PROGRAMS]         Libraries needed by Micro Focus tools
  1332.        $CICSWRK\MC2INIT1.LBR       This is the minimum needed in MCO2.CFG.
  1333.        $COBDIR\CHECK.LBR
  1334.        $COBDIR\UTILS.LBR
  1335.        $COBDIR\COBCLI.LBR
  1336.        $COBDIR\ADVANIM.LBR
  1337.        $COBDIR\TOOLS.LBR
  1338.  
  1339.        [MC2INIT1-SWITCHES]         Sets run-time switches
  1340.        (-F+K4)                     -F turns off numeric checking. +K4
  1341.                                    causes RTS messages to remain on screen
  1342.                                    until a key is pressed. Consult online
  1343.                                    information on your COBOL system for
  1344.                                    information about run-time switches.
  1345.  
  1346.        ;[MC2-CICS-@03@]            Debugger control of background task
  1347.        ;ANIM                       @03@. Sets Animator as debugger for task
  1348.                                    @03@. Commented out in supplied file.
  1349.  
  1350.        ;[MC2-CICS-@04@]            Debugger control of background task
  1351.        ;ANIM                       @04@. Sets Animator as debugger for task
  1352.                                    @04@. Commented out in supplied file.
  1353.  
  1354.        [MC2-CICS-V124]             Debugger control of foreground task @03@
  1355.        ANIM                        Sets Animator as full-screen debugger
  1356.        CONTROL:FULL SCREEN         for terminal task V124.
  1357.  
  1358.  
  1359.    Note that tags [MC2-CICS-xxxx] provide debugger control over any CICS
  1360.    OS/2 task. Substitute the CICS OS/2 task name for xxxx. This tag accepts
  1361.    the parameters documented in the next section, Process Control
  1362.    Parameters. Naming tasks in MCO2.CFG not started by CICS OS/2 will not
  1363.    cause an error.
  1364.  
  1365.    The remainder of MCO2.CFA uses existing tags documented in your CICS
  1366.    OS/2 Option User Guide.
  1367.  
  1368.    They are set as below:
  1369.  
  1370.        [MC-STARTUP]
  1371.        APPLICATION-LIBRARY:MCO2.LBR
  1372.        INITIALIZATION-LIBRARY:$COBDIR\TOOLS.LBR
  1373.        [MC-TRACE]
  1374.        OFF
  1375.        [MC-PROGRAMS]
  1376.        MCO2.LBR
  1377.        $COBDIR\TOOLS.LBR
  1378.        [MC-INSTALL]
  1379.        $COBDIR\MFEXTMAP
  1380.        [MC-PAINTER]
  1381.        SCREENS
  1382.        [MC-MENU]
  1383.        CMENU
  1384.        [MC-ONLINE]
  1385.        /Q /Q
  1386.  
  1387.    Note that [MC-ONLINE] is no longer used to determine which task runs
  1388.    under a debugger.
  1389.  
  1390.    Process Control Parameters
  1391.    ==========================
  1392.    The session to be controlled by an entry is selected with the tag:
  1393.    [MC2-CICS-xxxx], where xxxx is the process or terminal ID. For example,
  1394.    [MC2-CICS-V123] selects terminal V123. Follow the tag with the process
  1395.    control parameters.
  1396.  
  1397.    These parameters are listed below. They are not case sensitive and can
  1398.    be entered in upper, lower, or mixed case. The colon, :, is part of the
  1399.    parameter and you must include it.
  1400.  
  1401.        ANIM:       Selects Animator for this process. Optionally, up to 75
  1402.                    characters of directives for Animator may follow (see the
  1403.                    COBOL Reference for details). The directive
  1404.                    "USER-SESSION" is noted if present and the process is
  1405.                    appropriately setup. Only one session system wide may
  1406.                    specify other than "CURRENT" (the default). The control
  1407.                    session may be either full screen or VIO windowed. The
  1408.                    default is for control to run from a VIO window. The
  1409.                    number of lines on the screen in the control session may
  1410.                    be controlled by the "LINES" parameter.
  1411.  
  1412.        GANIM:      Selects Xilerator for this process. Optionally, up to 75
  1413.                    characters of directives for Xilerator may follow. Do not
  1414.                    specify directives -P or -S. MC2INIT forces -P on and -S
  1415.                    off.
  1416.  
  1417.                    You can set the number of lines on the screen in the
  1418.                    control session with the "LINES" parameter (see below).
  1419.                    The control session is forced to be a full screen. The
  1420.                    target session will be in a PM session if that is the way
  1421.                    it is defined to CICS OS/2 or in a VIO window if it is
  1422.                    defined to CICS OS/2 as a full screen terminal.
  1423.  
  1424.        CVP:        Selects CodeView for this process. "EANIM" is also
  1425.                    accepted as an alias. Optionally, up to 75 characters of
  1426.                    directives for CodeView may follow. The control session
  1427.                    for CodeView is always started full screen.
  1428.  
  1429.        PROFILER:   Selects the Microsoft Source Profiler for this process.
  1430.                    Optionally, up to 75 characters of directives for
  1431.                    CodeView may follow.
  1432.  
  1433.        NATIVE:     Drops the Micro Focus enhancements for this process. The
  1434.                    only thing carried forward to the process is the run-time
  1435.                    switch settings (see the MC2INIT-SWITCHES tag in the
  1436.                    previous section).
  1437.  
  1438.                    Use NATIVE if you suspect that the MC2INIT enhancements
  1439.                    are causing a problem. NATIVE is not the default for a
  1440.                    process. The normal startup is to have the Micro Focus
  1441.                    Toolset Run Time Environment active without Animator.
  1442.  
  1443.        ANYPGM:     Selects the program or tool named in the parameter
  1444.                    "PROGRAM" (see below). The parameters supplied to this
  1445.                    program are given with this tag and may contain three
  1446.                    special variables (%1, %2, and %3). These special
  1447.                    variables are replaced at execution time as follows.
  1448.  
  1449.                     %1 This is the CICS OS/2 task control program
  1450.                     %2 This is the runtime SWITCHES passed to the CICS
  1451.                        OS/2 task control program.
  1452.                     %3 These are the startup variables expected by CICS
  1453.                        OS/2 task control on the command line.
  1454.  
  1455.                    If there are no parameters to pass to the PROGRAM other
  1456.                    than the CICS OS/2 startup information then this tag
  1457.                    should be coded "ANYPGM:%1 %2%3".
  1458.  
  1459.     The following parameters are modifiers:
  1460.  
  1461.        CONTROL:    This specifies the type of session for the control screen
  1462.                    of Animator. It may specify "WINDOWED" (the default),
  1463.                    "PM-API", or  "FULL-SCREEN". Note that some debuggers
  1464.                    (for example Xilerator and CodeView) override this
  1465.                    parameter and force "FULL-SCREEN".
  1466.  
  1467.        LINES:      This specifies the number of lines displayed on the
  1468.                    control screen for Animator, Advanced Animator, and
  1469.                    Xilerator. For Xilerator the lines parameter must be
  1470.                    acceptable to a full screen session for your system.
  1471.                    Acceptable parameters depend on your display hardware;
  1472.                    for VGA screens they include 25, 43 and 50
  1473.  
  1474.        PROGRAM:    This supplies the major parameter "ANYPGM" with the fully
  1475.                    qualified program-name of the controlling executable. It
  1476.                    will be this programs responsibility to start the CICS
  1477.                    OS/2 task control program and pass on the appropriate
  1478.                    switches and command line arguments.
  1479.  
  1480.    Example MCO2.CFG Files
  1481.    ======================
  1482.    This section contains some example sections from MCO2.CFG files, to show
  1483.    you how to use the tags described in the previous section. They are
  1484.    just segments of a configuration file.
  1485.  
  1486.    Example 1:
  1487.    ----------
  1488.    Start Animator on the background processes @03@ and @04@. This startup
  1489.    defaults to each Animator session running in a VIO window and the CICS
  1490.    process running in the same session as Animator. This precludes any "PM"
  1491.    type applications from running on processes @03@ and @04@. This example
  1492.    also changes the Animator key top color to yellow on red.
  1493.  
  1494.  
  1495.        [MC2INIT1-ATTRIBUTES] 
  1496.        SYS-ATT-4: YELLOW ON RED
  1497.        :
  1498.        :
  1499.        [MC2INIT1-SWITCHES]
  1500.        (-F)
  1501.        :
  1502.        :
  1503.        [MC2-CICS-@03@]
  1504.        ANIM:
  1505.        [MC2-CICS-@04@]
  1506.        ANIM:
  1507.  
  1508.    Example 2:
  1509.    ----------
  1510.    Start Animator on terminal V123 and enable "PM" applications to run on
  1511.    this terminal. Also enable numeric checking to screen the application
  1512.    for invalid numeric fields.
  1513.  
  1514.        [MC2INIT1-SWITCHES]
  1515.        (+F)
  1516.        :
  1517.        :
  1518.        [MC2-CICS-V123] 
  1519.        ANIM:USER-SESSION"PM" 
  1520.        CONTROL:WINDOWED
  1521.  
  1522.    Example 3:
  1523.    ----------
  1524.    Start Xilerator on V124. Set the control session to 50 lines to allow
  1525.    more code to be viewed. Use mixed assembler and COBOL source display.
  1526.    Control will be in a full screen session and the user session will be
  1527.    "PM" if the original TCT entry for V124 was "PM" or else it will be a
  1528.    VIO window (if the TCT specified full screen).
  1529.  
  1530.        [MC2-CICS-V124] 
  1531.        GANIM:-M
  1532.  
  1533.    Debugging PM-API Processes
  1534.    ==========================
  1535.    You must be careful when debugging PM-API processes with Xilerator or
  1536.    CodeView. Background or non-full screen 3270 processes are both PM-API.
  1537.    If you use Ctrl-Esc while the debugger is at a breakpoint or in step
  1538.    mode, OS/2 will hang and you will have to reboot the machine. This is
  1539.    not a bug, but the nature of this type of debugging under OS/2.
  1540.  
  1541.    To avoid this problem, it is suggested that at the first debugger stop
  1542.    you do whatever debugging you can. Any attempt to switch sessions will
  1543.    hang the machine. When you need to switch sessions, to provide input or
  1544.    consult reference material, set a breakpoint you can trigger from
  1545.    outside the debugger. Then "Zoom" the debugger, returning you to the PM
  1546.    desktop.
  1547.  
  1548.    You can now switch sessions. When you trigger the previously set
  1549.    breakpoint, the debugger will reclaim the screen and keyboard focus
  1550.    automatically. You can now only use the debugger until you enter "Zoom"
  1551.    mode again.
  1552.  
  1553.    Animator with USER-SESSION"PM" does not generally suffer from this
  1554.    problem, and in many cases will be more friendly than Xilerator or
  1555.    CodeView. However, if you are debugging code that is synchronous with
  1556.    the PM message queue, the same rules apply. Most CICS OS/2 applications
  1557.    do not fall into this category.
  1558.  
  1559.    Restrictions In Related Software
  1560.    ================================
  1561.     o  Animator does not recognise the size of the screen if it is changed
  1562.        after startup. This is a problem for starting Animator or Advanced
  1563.        Animator for terminals that have screen sizes larger than 25 by 80
  1564.        where USER-SESSION"PM" is not specified. Animator will detect the
  1565.        screen size and then CICS OS/2 will re-size the screen for 3270
  1566.        emulation of the larger terminal screen size. Animator will continue
  1567.        to use the original session size.
  1568.  
  1569.        To bypass this problem use the LINES parameter to set the session
  1570.        size to the same size that the CICS OS/2 terminal uses. The session
  1571.        will be resized prior to the start of Animator and when CICS OS/2
  1572.        resizes the session it is effectively ignored.
  1573.  
  1574.     o  Only one cross session occurrence of Animator may be in the system at
  1575.        a given time. This is a design limitation of Animator. The result is
  1576.        that you can only work with one CICS process at a time if you require
  1577.        PM (or Dialog System) support.
  1578.  
  1579.    Error Messages
  1580.    ==============
  1581.    This section lists MC2INIT error messages. They are displayed on the
  1582.    screen for both VIO window and full screen sessions. They are also
  1583.    written to the MC2INIT.LOG file, in the CICS OS/2 system directory.
  1584.  
  1585.     o  Start logic error.
  1586.  
  1587.        This indicates an internal logic error.
  1588.  
  1589.     o  DosGetInfoSeg failed. RC=nnnn
  1590.  
  1591.        The call to get operating system failed with the nonzero return code
  1592.        nnnn.
  1593.  
  1594.     o  DosExecPgm failed. RC=nnnn
  1595.  
  1596.        The operating system call failed with return code nnnn.
  1597.  
  1598.     o  DosStartSession failed. RC=nnnn
  1599.  
  1600.        The operating system call failed with return code nnnn.
  1601.  
  1602.     o  Control statement error=nnnn
  1603.  
  1604.        The CONTROL tag was coded but the parameter information was either
  1605.        missing or invalid. The valid entries are coded either with or
  1606.        without enclosing double quotes and include "PM", "FULL-SCREEN", and
  1607.        "WINDOWED".
  1608.  
  1609.     o  No value for PROGRAM tag.
  1610.  
  1611.        The PROGRAM tag was coded but there was no program-name supplied with
  1612.        the tag.
  1613.  
  1614.     o  Unrecognized statement=xxxxxxxxx
  1615.  
  1616.        Unrecognized control statement xxxxxxxxx was received. This indicates
  1617.        an invalid tag.
  1618.  
  1619.     o  Screen re-size failed. RC=nnnn
  1620.  
  1621.        The operating system call failed with return code nnnn. This may
  1622.        indicate that the LINES parameter is not valid for the specified
  1623.        session.
  1624.  
  1625.     o  Failed to find process for xxxxxxxxx
  1626.  
  1627.        A search of the CICS OS/2 task control table failed to find the
  1628.        process being started. This process may fail later because of CICS
  1629.        OS/2 code using the wrong 3270 screen support code.
  1630.  
  1631.     o  CICS service level mismatch.
  1632.  
  1633.        The CICS OS/2 task control table entry length does not match the
  1634.        definition in this module.
  1635.  
  1636.     o  Failed to find CICS shared segment. RC=nnnn
  1637.  
  1638.        The operating system call failed with return code nnnn. The call to
  1639.        get the named shared segment containing the CICS OS/2 CSA failed.
  1640.  
  1641.     o  Invalid SWITCH syntax: xxxx
  1642.  
  1643.        The SWITCH parameter xxxx is invalid. It must begin and end with "("
  1644.        and ")" respectively and contain no embedded blanks.
  1645.  
  1646.    PRODUCT CHECKLIST
  1647.    =================
  1648.    This delivery consists of one diskette, for applying an update to
  1649.    CICS OS/2 version v2.5.04. This diskette will be 3.5 inch high density.
  1650.  
  1651.    INSTALLATION
  1652.    ============
  1653.    The update disk(s) contains a utility called UPDPROG, which you use for
  1654.    applying the updates to your CICS OS/2 System. UPDPROG applies updates to
  1655.    only one system directory, but it is likely that you have your system
  1656.    spread across several directories. To cope with this, a batch file called
  1657.    UPDATE is also supplied.
  1658.  
  1659.    Provided you used Setup to install your CICS OS/2 System, you can use
  1660.    UPDATE to apply the updates. UPDATE automatically applies the updates to
  1661.    all the correct directories, calling Setup to establish the details and
  1662.    then calling UPDPROG for each directory in turn. If you installed your
  1663.    system manually, you will have to use UPDPROG yourself on each directory.
  1664.  
  1665.    UPDATE also checks what versions you have of the CICS OS/2 system files,
  1666.    to make sure you have 2.5.4 installed. If you have an earlier version
  1667.    installed, UPDATE calls Setup to upgrade it to 2.5.4; Setup will ask you
  1668.    to insert disks from your 2.5.4 set so it can do this.
  1669.  
  1670.    To apply the update disk using UPDATE:
  1671.  
  1672.     1. Place the diskette supplied in a disk drive, and make that drive
  1673.        current. For example, if you use your A drive, enter at the prompt:
  1674.  
  1675.            A: <Enter>
  1676.  
  1677.     2. Start the update procedure by entering:
  1678.  
  1679.            UPDATE <Enter>
  1680.  
  1681.     3. UPDATE calls Setup, which displays an introductory screen. Read this
  1682.        and then press <Enter> to get to the main menu.
  1683.  
  1684.     4. On the main menu, select the option to start the update process
  1685.        (instructions on the screen tell you how to select an option).
  1686.  
  1687.     5. Setup displays the directory structure containing your CICS OS/2
  1688.        System. You can change the directories by typing over them, but do
  1689.        this only if the directory structure shown is wrong; do not put your
  1690.        updates into different directories from your original system.
  1691.        Normally you will simply press <Enter> at this screen to confirm it
  1692.        is correct.
  1693.  
  1694.     6. Setup now finishes (it may display "installation complete"), and
  1695.        UPDATE calls Updprog.
  1696.  
  1697.     7. Updprog checks the CICS OS/2 System files in the system directories
  1698.        to see if any are from earlier versions than 2.5.4. If none are,
  1699.        steps 8 through 10 are bypassed.
  1700.  
  1701.     8. A list of the files that need to be reloaded from the 2.5.4 issue
  1702.        disks to bring your system up to 2.5.4 is displayed, and you are
  1703.        given the option of continuing or terminating. If your system
  1704.        consists mainly of files from earlier than 2.5.4 you should
  1705.        terminate, and install a 2.5.4 system before proceeding with the
  1706.        update.
  1707.  
  1708.     9. To prompt for the correct 2.5.4 disks, Updprog needs to know their
  1709.        format. It assumes they are the same format as the update disk. If
  1710.        this is not correct you can give their format by pressing one of the
  1711.        following:
  1712.  
  1713.            1   (for 5.25 inch low density diskettes)
  1714.            2   (for 3.5  inch low density diskettes)
  1715.            3   (for 5.25 inch high density diskettes)
  1716.            4   (for 3.5  inch high density diskettes)
  1717.            5   (for fixed disk)
  1718.  
  1719.        You are asked to confirm your choice by entering Y. Entering N allows
  1720.        you to select another format.
  1721.  
  1722.    10. Updprog now starts copying files from your 2.5.4 disks; it asks you
  1723.        for each disk as it needs it.
  1724.  
  1725.    11. Setup now starts copying files from your updates disk(s); it asks you
  1726.        for each disk as it needs it. First it looks for PKUNZIP.EXE in your
  1727.        existing CICS OS/2 System; if it cannot find this file the most
  1728.        likely reason is that you gave the wrong directory names. Messages
  1729.        indicating which files are being updated are displayed.
  1730.  
  1731.    12. When all the updates are complete, the files are rechecked to confirm
  1732.        that they have been updated correctly, and UPDPROG finishes.
  1733.  
  1734.    This completes the update process using UPDATE. If you installed your
  1735.    2.5.4 system manually, you apply the update disk for each directory
  1736.    individually using UPDPROG as follows:
  1737.  
  1738.     1. Place the diskette supplied in a disk drive, and make that drive
  1739.        current. For example, if you use your A drive, enter at the prompt:
  1740.  
  1741.            A: <Enter>
  1742.  
  1743.     2. Start the update procedure by entering:
  1744.  
  1745.            UPDPROG <Enter>
  1746.  
  1747.     3. You are asked to enter the name of the directory containing the CICS
  1748.        OS/2 System you wish to update. To accept the default, which is
  1749.        displayed with the prompt, just press <Enter>. Type the path-name of
  1750.        that directory followed by <Enter>.
  1751.  
  1752.    After this, the process is as from step 7 above.
  1753.  
  1754.    Notes:
  1755.  
  1756.     o  If you install any files from 2.5.4 after applying this update, you
  1757.        should reapply the update following the same procedure as above.
  1758.        UPDPROG will indicate if no further changes are needed.
  1759.  
  1760.     o  When UPDPROG is reloading files, you may get a message of the form:
  1761.  
  1762.            Unable to unzip     or     Unzip failed
  1763.  
  1764.        (On OS/2 an error code will be given too.) The most likely
  1765.        causes are that the disk is full or that the file already exists and
  1766.        is read-only.
  1767.  
  1768.     o  If you are installing on a machine with a monochrome monitor, invoke
  1769.        UPDATE with the /m option. For example, UPDATE /M.
  1770.  
  1771.     o  UPDATE will attempt to write to the disk containing the update disk
  1772.        software. If it cannot do so because the disk is write protected,
  1773.        then it will store its control files in the first directory on
  1774.        COBDIR. It will also need the path set so that you can run CICS OS/2
  1775.        System 2.5.4.
  1776.  
  1777.    DISK CONTENTS
  1778.    =============
  1779.  
  1780.    High density 3.5 inch diskettes
  1781.    -------------------------------
  1782.    Disk 1
  1783.  
  1784.     UDSETUP.EXE     CICSUD.INI      UPDPROG.@XE     CHKDRV.EXE
  1785.     UPDATE.CTL      CHKSUMS.O2      UPDINFO.O2      CIC2UDRN.DOC
  1786.     UPDATE.CMD      UPDATE.BAT      O2MASK.PCH      IBMPTF29.DOC
  1787.     MCO2.@FA        CICSCOMP.@MD    FAAOIS04.@CA    FAAOISPT.@CA
  1788.     MC2SYNCC.@PY    FAAOMPML.@XA    MC2INIT.@IP     MC2SYNC.@IP
  1789.     FAAAEWOF.@BL    FAAECIW.@BL     ECI.@OC         DSDEMO.@IP
  1790.     FAAAEFIE.T01    CICSRRDS.@MD    FAASRPTR.@XE    FAANBSIN.@LL
  1791.     UPDDEL.EXE      BTRCALLS.@LL    FAAAEPDL.@LL    FAAAEPEX.@LL
  1792.     FAAAEPIM.@LL    FAAAEPMN.@LL    FAAANPIN.@LL    FAAANPMC.@LL
  1793.     FAAATPCI.@LL    FAAATPDF.@LL    FAAATPML.@LL    FAAATSSH.@LL
  1794.     FAAATSTR.@LL    FAACEBR.@LL     FAACICS.@LL     FAACTPCM.@LL
  1795.     FAACTPCN.@LL    FAACTPDC.@LL    FAACTPED.@LL    FAACTPFC.@LL
  1796.     FAACTPKB.@LL    FAACTPPC.@LL    FAACTPPP.@LL    FAACTPSI.@LL
  1797.     FAACTPSN.@LL    FAACTPTA.@LL    FAACTPTC.@LL    FAACTPTS.@LL
  1798.     FAADCALL.@LL    FAAECPBE.@LL    FAAHLPON.@LL    FAAHLSON.@LL
  1799.     FAAHPSPH.@LL    FAALSPDL.@LL    FAALSPFL.@LL    FAALSPSF.@LL
  1800.     FAALSPSG.@LL    FAALSPSN.@LL    FAALSPTC.@LL    FAALSSSH.@LL
  1801.     FAALSSUP.@LL    FAAMGSON.@LL    FAAMIR.@LL      FAAMSPDM.@LL
  1802.     FAAMSSO4.@LL    FAAMSSOJ.@LL    FAAMSSOP.@LL    FAAMSSOT.@LL
  1803.     FAANBSPH.@LL    FAAO6SPH.@LL    FAAO6STR.@LL    FAAOIPTD.@LL
  1804.     FAAOISET.@LL    FAAOISII.@LL
  1805.  
  1806.    Disk 2
  1807.  
  1808.     FAAOISMM.@LL    FAAOISQT.@LL    FAAOISST.@LL    FAAOISTT.@LL
  1809.     FAAOMPSD.@LL    FAAOMSLV.@LL    FAAOTPED.@LL    FAAOTPTK.@LL
  1810.     FAAOTPTR.@LL    FAAPLTSD.@LL    FAASRSE1.@LL    FAASRSE2.@LL
  1811.     FAASRSML.@LL    FAATCPCT.@LL    FAAUTPSC.@LL    FAAUTPUC.@LL
  1812.     FAAUTSDM.@LL    FAAANPCB.@XE    FAACLPIN.@XE    FAACPPML.@XE
  1813.     FAAHLPOF.@XE    FAAMSPTR.@XE    FAAOMPML.@XE    MCSTAR01.@XE
  1814.     FAAOMPTR.@XE    FAAOTPTK.@XE    FAAOTXTK.@XE    FAAPMPSM.@XE
  1815.     FAAPRPML.@XE    FAAUTPLC.@XE    FAAHLFT1.PTR    FAAHLFT2.PTR
  1816.     FAAHLFT3.PTR    FAAMGFMG.@TR    ACCTSET.PMS     FAADCMB.PMS
  1817.     FAADCALL.PCP    FAAPMPSM.PC     FAACLIB.PIB     FAAPMPSM.P
  1818.     DFHAID.P        FAACSTRT.P      FAAECIH.P       BMSSCRNS.PBR
  1819.     MCO2.PXE        MCO2.@BR        MCCT01.PBL      MCCT01.PCP
  1820.     MCCT01.PNT      MCCT01.PDY      UPDATE.BAT      UPDATE.CMD
  1821.  
  1822.    =========================================================================
  1823.    Micro Focus is a registered trademark of Micro Focus Limited.
  1824.    Micro Focus COBOL Workbench, CICS OS/2 Option for Micro Focus COBOL
  1825.    Workbench, Animator, Xilerator, and Dialog System are trademarks of Micro
  1826.    Focus Limited.
  1827.    XDB is a registered trademark of XDB Systems, Inc.
  1828.    Microsoft, CodeView, and Source Profiler are registered trademarks of
  1829.    Microsoft Corporation.
  1830.    IBM is a registered trademark of International Business Machines
  1831.    Corporation.
  1832.    OS/2 and CICS OS/2 are trademarks of International Business Machines
  1833.    Corporation.
  1834.    IMSVS86 is a trademark of Stingray Software Company,Inc.
  1835.    =========================================================================
  1836.    Copyright (C) 1992-93 Micro Focus Ltd         CIC2UDRN.DOC/2.5.16/16Dec93
  1837.