OA47376: NF BPXWRFD ENVAR TSOCMD ADDRESS TSO

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function - BPXWRFD envar enhancement.
  z/OS UNIX tsocmd and REXX Address TSO only allows the
  environment variable BPXWRFD to have a value of "YES", which
  allows file descriptors in the range ￭10-99 to be inherited.
  There is no capability for specifying any other range.
  
  This new support will allow the high end of the range to be a
  user-specified value up to the limit of OPEN_MAX.  For example
  specifying BPXWRFD=500 will allow for file descriptors in the
  range ￭10-500.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/OS UNIX System Services for   *
  *                 HBB7780 HBB7790 and HBB77A0, using z/OS UNIX *
  *                 tsocmd or REXX Address TSO.                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using tsocmd and REXX Address TSO, *
  *                      will support passing file descriptors   *
  *                      in a user-specified range beginning at  *
  *                      10 to the TSO process, by using the     *
  *                      environment variable BPXWRFD.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  z/OS UNIX tsocmd and REXX Address TSO only allows the
  environment variable BPXWRFD to have a value of "YES", which
  allows file descriptors in the range  10-99  to be inherited.
  There is no capability for specifying any other range.
  
  This new support will allow the high end of the range to be a
  user-specified value up to the limit of OPEN_MAX.  For example
  specifying BPXWRFD=500 will allow for file descriptors in the
  range  10-500 .
  

Problem conclusion

Temporary fix

Comments

• The capabilities of using the environment variable BPXWRFD is
  extended, and is described by the following publication updates:
  
  SA23-2280 z/OS UNIX System Services Command Reference:  tsocmd .
  Run a TSO/E command from the shell (including authorized
  commands):
  
   Usage Notes (1.) will be changed to say:
  
    1. The BPXWRFD environment variable can be set to cause file
    descriptors to be inherited by the TSO command processor.  See
    the description of environment variable BPXWRFD below for
    information on which file descriptors are inherited.
  
   Under Environment Variables, the BPXWRFD description will be
   changed to say:
  
    Specifying YES in a REXX program before the TSO process is
    started causes the TSO process to inherit open file
    descriptors 10 through 99.
  
    Specifying a numeric value in a REXX program before the TSO
    process is started causes the TSO process to inherit open file
    descriptors 10 through that numeric value.  The maximum value
    that may be specified is limited by the setting of the system
    configuration (SYSCONF) value for OPEN_MAX.  If a higher value
    is specified then it will be limited by OPEN_MAX.  If a value
    lower than 10 or a non-numeric value other than "YES" is
    specified, then no additional file descriptors beginning at 10
    will be inherited.
  
  
  SA23-2283 z/OS Using REXX and z/OS UNIX System Services:  The
  TSO command environment:
  
   The paragraph beginning
   "Specifying environment variable BPXWRFD in a REXX program..."
   will be updated as follows:
  
    Specifying environment variable BPXWRFD in a REXX program
    before the TSO process is started causes the TSO process to
    inherit open file descriptors.  This inheritance stays in
    effect as long as the TSO process is active.  Removing this
    inheritance can be accomplished by unsetting BPXWRFD and
    stopping the TSO process; for example, by issuing ADDRESS TSO
    LOGOFF.  Subsequent ADDRESS TSO commands will then start with
    a new TSO process, and file descriptors will not be inherited.
  
    The open file descriptors that will be inherited by specifying
    the environment variable BPXWRFD are as follows:
    - If the value of the environment variable is "YES", open file
      descriptors 10 thru 99 will be inherited.
    - If the value of the environment variable is a numeric value
      N, open file descriptors 10 thru N will be inherited.
  

APAR Information

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

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

  UA77647 UA77648 UA77649

Modules/Macros

• BPXWREXC BPXWRREX
  

Fix information

• Fixed component name

  OPENMVS SYS SRV

• Fixed component ID

  5695SCPX1

Applicable component levels

• R7A0 PSY UA77647

     UP15/06/24 P F506

• R780 PSY UA77648

     UP15/06/24 P F506

• R790 PSY UA77649

     UP15/06/24 P F506

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.