OA41576: OPTCD=J NOT HONORED FOR OUTPUT TRANSMITTED VIA NJE/TCPIP IN JES3

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• External symptoms:
  Output transmitted via NJE/TCPIP and printed has Table
  Reference Characters (TRC) displayed
  
  Impact to customer:
    Printed output invalid
  
  Analysis:
    The JCL contains OPTCD=J, this will cause flag DATOPTCD in the
  spooled record to indicate there are TRC's that should be
  recognized.  The sysout is then transmitted via the NJE/TCPIP
  interface; when printed the table reference characters are
  printed instead of interpreted.  Examination of the spooled
  records on the sending and receiving side shows bit DATOPTCD on
  on the sending side, and not on on the receiving side.
  
  Verification steps:
  1)  job containing OPTCD=J creates output on one system, output
  is transmitted via Netserv using NJE/TCPIP interface
  2)  when printed the output's control characters are visible
  3)  examining dumpcore of the spooled records on the receiving
  side shows bit DATOPTCD is not on
  
  The projected closing code for this APAR is PER for releases
  HJS7780 and above.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJS7780 and HJS7790             *
  ****************************************************************
  * PROBLEM DESCRIPTION: OPTCD=J NOT HONORED FOR OUTPUT          *
  *                      TRANSMITTED VIA NJE/TCPIP               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A job requests 3800 output using the sub-parameter "OPTCD=J" on
  the DD statement for a SYSOUT dataset.  The dataset is then
  transmitted to a remote node via TCP.  The inbound SYSOUT
  routine NXINSYOR (module IATNTTXR) gets control to receive the
  dataset.
  
  NXINSYOR calls routine ALOPCLDS to open the SYSOUT dataset,
  which checks the dataset header for the NDHAF1J flag (OPTCD=J
  flag in macro IATYNDH).  If this flag is on, ALOPCLDS then sets
  flag DSSOPCDJ in DSSFLAG4 (macro IATYDSS) in the DSS for the
  dataset and issues macro IATXSDM (module IATDMGR) to process the
  dataset open request.
  
  However, as part of its processing, IATDMGR clears DSSFLAG4.
  Control eventually returns to NXINSYOR which issues PUT requests
  (module IATDMDM) to spool the dataset records, but since the
  DSSOPCDJ flag had been previously cleared, the ACBOPTJ flag
  (macro IFGACB) and the DATOPTJ flag (macro IATYDAT) were never
  set, so the spooled records do not reflect the OPTCD=J setting,
  causing control characters to be printed along with the
  printable data.
  

Problem conclusion

• Installation On (All Processors)
               Order (Any)
  Activation   Order (Any)
               Type/JES3 restart (Hot)
               Type/IPL (Rolling/DynLPA)
               CLPA (Yes)
  (See Apar II07968 for definitions)
  
  Module IATDMGR was changed to set flag ACBOPTJ (macro IFGACB) in
  the ACB prior to clearing the DSSOPCDJ flag (macro IATYDSS).
  
  APAR OA41576 prereq's (and sup's) for FMID HJS7780:
  Pre's: * NONE *
  
  APAR OA41576 prereq's (and sup's) for FMID HJS7790:
  Pre's: * NONE *
  

Temporary fix

• *** * TEMPORARY FIX MAY BE OBTAINED FROM DLL OR INFO/ACCESS ****
  ******************* OA41576  DECK AVAILABLE ********************
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA68845 UA68846

Modules/Macros

• IATDMGR
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R780 PSY UA68845

     UP13/05/02 P F305

• R790 PSY UA68846

     UP13/05/02 P F305

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.