home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR10 / CMINFO.ZIP / II06554.CM < prev    next >
Text File  |  1993-04-27  |  20KB  |  243 lines

  1.                                                                                 
  2. PRINT SELECTION FOR APAR - II06554 93/04/27                                     
  3.            PIN INFO-PC-LIB-100 II06554-IN-INCORROUT                             
  4. F   -     -     -                                                               
  5. DEBUGGING TIPS FOR VSE FILE TRANSFER AND ANY PC 3270 EMULATOR                   
  6. OS2 COMMUNCATION MANAGER PERSONAL COMMUNICATIONS 3270 PERCOM                    
  7. END OF ABSTRACT   FESN5NFO000-000                                               
  8. REPORTED RELEASE    R001                                                        
  9. ERROR DESCRIPTION:                                                              
  10. DEBUGGING TIPS FOR FILE TRANSFER TO A VSE HOST FROM ANY                         
  11. IBM OR OEM 3270 EMULATOR FOR THE PC INCLUDING:                                  
  12. PERSONAL COMMUNICATIONS 3270  (PERCOM)                                          
  13. PC3270 EMULATION PROGRAM, ENTRY LEVEL                                           
  14. OS2 COMMUNICATIONS MANAGER                                                      
  15. HCON RS6000                                                                     
  16. 1) What release of VSE are you running?                                         
  17.    If the customer is not sure tell them to use                                 
  18.    LIBRARIAN to list SPLEVEL.PROC in IJSYSRS.SYSLIB                             
  19.    This is a list of the current releases:                                      
  20.    566634500 B72  VSE/SP Unique 3.1.X, 3.2.2, 3.2.3                             
  21.    568600600 C72  VSE/SP Unique 4.1.1, 4.1.2, 4.1.4                             
  22.    568602801 F10  VSE/SP Unique VSE ESA 1.1.X, 1.2.2, 1.2.3                     
  23.                                                                                 
  24.    VSE file transfer is not called IND$FILE.  It is shipped                     
  25.    with the above package component id and it consists of                       
  26.    a phase called INWPCCOM.  Some customers refer to the VSE                    
  27.    file transfer function as IWS (Intelligent Workstation                       
  28.    Support), or IUI file transfer.  They may also refer to it                   
  29.    as CICS file transfer, but if they are running VSE then                      
  30.    they are using INWPCCOM and VSE supplied transactions                        
  31.    IND$ or INW7.  Both of these transactions will invoke                        
  32.    INWPCCOM.                                                                    
  33. 2) What messages are received on the PC side?                                   
  34. 3) What messages are received on the Host side?                                 
  35. 4) Is the VSE release the most current one available?                           
  36.    The most current VSE releases are 3.2.3, 4.1.4, ESA 1.2.3.                   
  37.    Even if the release is current there may be some outstanding                 
  38.    apars.  Search on the symtoms in the PA library for VSE                      
  39.    apars.  For more messages or symptoms ask the customer to                    
  40.    recreate the error and then display the bottom of the                        
  41.    INSPECT MESSAGE LOG DIALOG.                                                  
  42.    If any VSE apars are required PLEASE have someone from the                   
  43.    VSE level2 group order the apar as there are special                         
  44.    ordering procedures.                                                         
  45. 5) Do both the SEND and RECEIVE fail?                                           
  46. 6) What is the exact SEND or RECEIVE command that was entered                   
  47.    including any options.                                                       
  48.    For example:                                                                 
  49.     SEND PC.FIL FILENAME (FILE=HTF ASCII CRLF REPLACE                           
  50.     RECEIVE PC.FIL (FILE=LST KEEP                                               
  51. 7) Where is the send or receive directed to or from?                            
  52.    File transfer can be performed to or from:                                   
  53.                                                                                 
  54.    VSE Host Transfer File (HTF)                                                 
  55.      This file is a large VSAM file that contains seperate                      
  56.      entries for each file that a user sends to it.  The entries                
  57.      are connected to a directory within the HTF for that                       
  58.      user.  VSE provides dialogs to move the files from this                    
  59.      large HTF to other VSAM files or ICCF members.                             
  60.                                                                                 
  61.    CICS Temporary Storage                                                       
  62.      A CICS appication can then manipulate the TS queue.                        
  63.                                                                                 
  64.    VSE/POWER queues                                                             
  65.      A file can be sent or received from the POWER LIST                         
  66.      queue (output from HOST jobs).                                             
  67.      A file containing a VSE job can be sent to the POWER                       
  68.      RDR queue.                                                                 
  69.      A file can be received from the POWER PUNCH queue.                         
  70. 8) How is the PC attached to the HOST?                                          
  71. 9) If attached through a 3174, hardware configuration question                  
  72.    125 bit 6, File Transfer aid must be set on.                                 
  73.    The 9370 Workstation adaptors also have a file transfer aid                  
  74.    bit and this will not be turned on if all defaults are taken.                
  75.    If this bit is not on the VTAM buffer trace will show empty                  
  76.    buffers and a TRANS10 will be issued at the PC.                              
  77.    Customers may need assistance from their CE to set this bit                  
  78.    on.                                                                          
  79. 10)Is EXTDS defined in the CICS terminal definition?  If it is                  
  80.    not on, this can cause the file transfer to hang and a                       
  81.    TRANS10 will be issued by the emulator on the PC side.                       
  82. 11)Examine a trace, either VTAM BUFFER, SIO/IO, or the                          
  83.    trace provided by the emulator and make sure that                            
  84.    the emulator is following proper protocol for the                            
  85.    mode that the PC is configured in (CUT or DFT).                              
  86. 12)Here is a list of VSE apars that may be applicable                           
  87.    depending on the symptoms.  Please have someone from                         
  88.    VSE level2 order the apars if necessary as there are                         
  89.    special ordering procedures:                                                 
  90. V3.X.X  V4.X.X  V1.X.X  SYMPTOM                 EMULATOR                        
  91. ------  ------  ------  -------                 --------                        
  92. PN22379 NONE    PN10293 STORAGE VIOLATION/AEIV  OS/2 COMM.MAN.                  
  93.                 PN14880                                                         
  94. PN13042 PN12904 PN09743 COMFTR08 (try NOCLEAR)  PERCOM 3270                     
  95. PN09132 PN01653 PN05134 TRANS10                 ANY IBM/OEM                     
  96. II02492 II02492 II02492 SETUP PROBLEMS          ANY IBM/OEM                     
  97.                                                                                 
  98. 13)DOCUMENTATION NEEDED TO PURSUE FAILURES:                                     
  99. ===============================================================                 
  100. One of the following traces will be required to determine if                    
  101. the error is being caused by the VSE software of the emulator.                  
  102. For abends in VSE code a CICS AUX trace may also be required.                   
  103.    IWS TRACE:                                                                   
  104.    ---------                                                                    
  105.    This is available as an option on the SEND/RECEIVE command                   
  106.    after VSE/SP 3.2.0.  It is documented in the VSE Guide For                   
  107.    Solving Problems.                                                            
  108.                                                                                 
  109.    VTAM BUFFER TRACE:                                                           
  110.    -----------------                                                            
  111.    The VTAM buffer trace can be started and stopped by entering                 
  112.    the following commands at the VSE system console:                            
  113.       'F NET,TRACE,TYPE=BUF,ID=TERMID'                                          
  114.       'F NET,NOTRACE,TYPE=BUF,ID=TERMID'                                        
  115.    For TERMID use the entire VTAM NETNAME.  Use TPRINT to print                 
  116.    the trace.  The following messages will be issued:                           
  117.    IST907A - SNAPSHOT MODE TPRINT ENTER Y OR N                                  
  118.    Reply 'NO' to this message.                                                  
  119.    IST905A - ENTER TRACE PRINT OPTIONS OR 'CANCEL'                              
  120.    Reply 'PRINT BUF=ALL'                                                        
  121.                                                                                 
  122.    SDAIDS SIO/IO TRACE WITH CCWD:                                               
  123.    -----------------------------                                                
  124.    This job will set up the SDAIDS trace:                                       
  125.    // JOB SDAID                                                                 
  126.    // EXEC SDAID                                                                
  127.    OUTDEV T=tcuu                                                                
  128.    TRACE SIO AR=Fn UN=cuu OUTP=(TOD CCWD=2000)                                  
  129.    TRACE IO AR=Fn UN=cuu OUTP=(TOD CCWD=2000)                                   
  130.    /*                                                                           
  131.    /&                                                                           
  132.    Fn is the CICS/ICCF partition. tcuu=tape device for trace out                
  133.    UN=cuu is the line, terminal, or controller being traced.                    
  134.    If controller is being traced be sure to reduce the traffic.                 
  135.    Submit the above job.  Enter STRTSD.  Recreate the error.                    
  136.    Enter STOPSD then ENDSD.  Use DOSVSDMP to print the trace.                   
  137.                                                                                 
  138. ============================================================                    
  139. COMMON USER ERRORS, CONFIGURATION ERRORS, OR EMULATOR PROBLEMS                  
  140. =============================================================                   
  141. A) MSGINW0002I from a module name ending with '0' and                           
  142.    customer indicates the PC is connected in DFT Mode.                          
  143.    This is a generation and tailoring error, the module                         
  144.    names ending in '0' are used in CUT (Control Unit Terminal)                  
  145.    Mode.  The customer needs to make certain that the PC,                       
  146.    controller, VTAM tables, and the CICS terminal entries are                   
  147.    configured for EXTENDED DATA STREAMING when using the PC as                  
  148.    a DFT (Distributed Function Terminal).                                       
  149. B) MSGINW0002I with RC=0001 and the error description for                       
  150.    the affected module is 'INVALID REPLY (NO AID ENTER)'.                       
  151.    This means the response buffer did not begin with X'7D'                      
  152.    (7D is the 3270 AID byte for an Enter Key).                                  
  153.    This message will also be issued if the user tries to                        
  154.    toggle back to the host or if they use Ctrl-Break to break a                 
  155.    hang before file transfer is complete.  The Ctrl-Break will                  
  156.    send in data that will not begin with x'7D'.  The reason for                 
  157.    the hang should be investigated.                                             
  158. C) FILE TRANSFER AID BIT PROBLEMS: MSGINW0002I TRANS10 HANGS                    
  159.    MSGINW0002I TRANS10 hangs can occur if the 3174 Control Unit                 
  160.    Hardware configuration Question #125 bit 6, 'FILE TRANSFER                   
  161.    AID', is not set on.  Without this bit turned on a RECEIVE                   
  162.    will work but SEND will fail.  A VTAM Buffer Trace will show                 
  163.    empty data buffers.                                                          
  164.                                                                                 
  165.    9370 Work Station Adaptors can have the same problem if                      
  166.    all defaults are taken.                                                      
  167.                                                                                 
  168.    Hardware configuration Question #125 also applies to                         
  169.    D/T9221.  See 'Planning For Your Workstation Subsystem.'                     
  170.                                                                                 
  171.    MSGINW002I TRANS10 HANG                                                      
  172.    This particular customer was running VSE/SP 4.1.x, EE                        
  173.    (Entry Emulator) 1.1,1.2,2.0 on a PS/2 and attached through                  
  174.    a 3299 multiplexer which also contains a 6120 or 6020 WSA.                   
  175.    This could probably happen with any version of VSE and hangs                 
  176.    could occur with any emulator but with EE the RECEIVES would                 
  177.    work but sends fail.  The file was actually transferred on                   
  178.    the SEND but the session would hang at the end and multiple                  
  179.    TRANS10's were issued.  This problem is described in APAR                    
  180.    IR87131. The FILE TRANSFER AID BIT needs to be set in the                    
  181.    Work Station Adaptor. See PLANNING FOR YOUR WORKSTATION                      
  182.    SUBSYSTEM GA24-4223 p.2-9.   This customer's CE also found                   
  183.    that the WORKSTATION CONTROLLER FEATURE 6120 card in the                     
  184.    9370 expansion cage in the 9221 system was not properly                      
  185.    configured to operate with 3270 emulation.  It must be                       
  186.    set to communicate with a 3174 not a 3274.                                   
  187.                                                                                 
  188. D) 3274 CONTROL UNIT - Customer was experiencing a file transfer                
  189.    hang at the same exact byte count every time.  The problem                   
  190.    was intermittent and occurred mostly with larger files.                      
  191.    SOLUTION: Hardware Configuration Question #164 PS TERMINAL                   
  192.    BIT must be turned off to work correctly.                                    
  193.                                                                                 
  194. E) HANG WAIT or HUNG condition on PS/2 using 4300 ICA and                       
  195.    the 3270 Emulation Version 3 Control Program caused by                       
  196.    not having EXTDS, Extended Data Streaming in the TCT and                     
  197.    VTAM was not configured for DFT Mode.                                        
  198. F) FTTERM CONFIGURATION PROBLEMS:                                               
  199.    MSGTRANS10 TIMEOUT on PC running FTTERM with a D/T3174 AEA.                  
  200.    If the 3174 AEA ports are configured as either                               
  201.    FC (FTERM COLOR) or FM (FTTERM MONO)                                         
  202.    then answer '1' to 'USE SPECIFIC KEYBOARD MAP (1=YES 0=NO)                   
  203.    prompt on the FTTERM configuration.  See the 3174 Terminal                   
  204.    User's Reference.  There was not IND$FILE coming in from                     
  205.    the emulator on the PC.                                                      
  206.                                                                                 
  207. G) ABENDAICA AICA USER EXIT ROUTINE.                                            
  208.    If a user tries to expand a record in their user exit                        
  209.    routine they have to do a GETMAIN and more the record                        
  210.    before they expand it. See SP/Administration Manual                          
  211.    SC33-6306-00, Page 248, Your Exit Routine Should Perform                     
  212.    The Following Steps: STEP 4.                                                 
  213. H) When RECEIVE is used from PS/2 TRANS10 TIMEOUT                               
  214.    0 BYTES RECEIVED and when you Hotkey back to the host                        
  215.    and hit Enter Key, MSGINW0002I INWPRCVE RC1 is                               
  216.    issued.  The TRANS10 was due to not having EXTDS coded.                      
  217.    The INW0002I INWPRCVE RC1 was due to Hotkeying back to the                   
  218.    and hitting the Enter Key.  The problem is resolved by                       
  219.    coding EXTDS in the TCT.                                                     
  220. I) HANG OR MSGINW0002I INWPGET1 RC=0002 when using PERCOM                       
  221.    Personal Communications 3270 V2 under Windows.  The                          
  222.    customer signed on to the IUI and used PF6 to get into                       
  223.    native CICS.  They opened a window and sent a file to the                    
  224.    host.  They received MSGINW0001I File Transfer Complete at                   
  225.    the PC but it did not show up on the host screen as it does                  
  226.    in DOS Mode.  They hit enter or PF3 on the host session and                  
  227.    INW0002I INWPGET1 RC=0002 was issued.  The RC2 means that no                 
  228.    acknowledgement was received from the PC.  The trace showed                  
  229.    normal DFT protocol flow up until the host sent out the                      
  230.    Insert Request + Data (msg) and then the PC never responded                  
  231.    with an Insert Data acknowledgement positive.  The customer                  
  232.    found that by increasing the TIMEOUT option from 30 to 60                    
  233.    on the windows panel the INW0001I would appear at the host                   
  234. ADDITIONAL KEYWORDS AND COMPONENT IDS:                                          
  235. MSGINW0002I INW00002I TRANSMISSION ERROR HOST IS NOT RESPONDING                 
  236. PERCOM V2 DOS 562123900 V3 DOS 562142601 cminfo OS2 ES1                         
  237. PERCOM V2 WINDOWS 562123901 V3 WINDOWS 562142602                                
  238. COMMENTS:                                                                       
  239. Closing to retain in the database.                                              
  240. 93/03/08,ENDICOTT                                                               
  241.                                                                                 
  242.                                                                                 
  243.