PI84514: GETSYSWORD builtin function enhancement

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• -
  

Local fix

• -
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Enterprise PL/I for z/OS users who use       *
  *                 the GETSYSWORD built-in function.            *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR adds a new keyword PROCSTEP   *
  *                      for the GETSYSWORD built-in-function    *
  *                      that returns the value of the job step  *
  *                      name that calls the JCL procedure       *
  *                      which contains the step that calls      *
  *                      the PL/I program.                       *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  *                                                              *
  ****************************************************************
  This APAR provides Enterprise PL/I library support for a new
  keyword PROCSTEP for the GETSYSWORD built-in function. The
  built-in function returns the value of the job step name that
  calls the JCL procedure.
  

Problem conclusion

Temporary fix

Comments

• The GETSYSWORD built-in function is modified to add the new
  keyword PROCSTEP that returns the value of the job step name
  that calls the JCL procedure.
  
  
  The Enterprise PL/I Language Reference manual, SC27-8940-00,
  will be updated as follows:
  
  In chapter "Built-in functions, pseudovariables, and
  subroutines"
    section "Descriptions of individual built-in functions,
             pseudovariables, and subroutines"
  
    Modify the built-in function GETSYSWORD with the following:
    - add a new keyword PROCSTEP after the STEPNAME keyword.
  
    - add the following paragraphs:
      The STEPNAME keyword returns the step name that calls the
      PL/I program.
      The PROCSTEP keyword returns the job step name that calls
      the JCL procedure which has the step that executes the
      PL/I program. If it is not called from a JCL procedure,
      a null string is returned.
  
  PUBS CLOSING CODE: DEVCHNG
  

APAR Information

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

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

  UI49014 UI49015

Modules/Macros

• IBMPBGSW
  

Fix information

• Fixed component name

  LE VA PL/I

• Fixed component ID

  568819806

Applicable component levels

• R7A0 PSY UI49014

     UP17/07/26 P F707

• R790 PSY UI49015

     UP17/07/26 P F707

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.