PK02493: THE REXX ON ZSERIES USER'S GUIDE AND REFERENCE V1R4 SH19-8160-05 MUST INCORPORATE READERS' COMMENTS.

APAR status

• Closed as documentation error.

Error description

• The REXX on zSeries User's Guide and Reference V1R4
  SH19-8160-05 received Readers' Comments. The comments provide a
  list of misspelt names, incorrect sentences and questions topics
  for more clarity in the description. All the comments have been
  reviewed by REXX C/T and are accepted to be incorporated in the
  User's Guide. This APAR must describe all updates.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users referencing the REXX User's *
  * Guide. *
  ****************************************************************
  * PROBLEM DESCRIPTION: The User's Guide must incorporate the *
  * received Readers' Comments. *
  ****************************************************************
  * RECOMMENDATION: This DOC_APAR provides improvements and *
  * corrections for the IBM Compiler and Library *
  * for REXX on zSeries Version 1 Release 4: *
  * User's Guide and Reference, SH19-8160-05. *
  * Any references to chapters or text parts *
  * described in the following refer to this *
  * book. *
  ****************************************************************
  NAVIGATION:
  -----------
  Chapter 6. Using Object Modules and TEXT Files
  Section: Improving Packaging and Performance, page 75
  Second bullet: Replace the paragraph starting
  with "In this example you must ... "
  NEW INFORMATION:
  ----------------
  In the following example the %STUB directive is inserted
  into the REXX source code. It defines the use of the CPPL
  stub and after compilation a simple link step is
  sufficient. You may consider the use of REXXL to
  link-edit REXX objects created with or without a stub
  directive:
  
  /* REXX - Example for use of the %STUB directive */
  /*%STUB CPPL */
  Parse source allsrc
  Say 'Hello world, I am' allsrc
  Exit
  
  The compile step remains the same as before:
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 1. Overview
  Section: Stream I/O for TSO/E REXX Function Package,
  page 7
  Insert the following paragraph after the second
  paragraph:
  NEW INFORMATION:
  ----------------
  If the Stream I/O REXX Function Package is integrated
  into TSO/E REXX, you can use it for interpreted REXX
  and compiled REXX.
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 7. Converting CEXEC Output between Operating
  Systems, page 87
  Add the following note after the second
  paragraph:
  
  NEW INFORMATION:
  ----------------
  Note:
  Use REXXF EXEC to change the record format and/or
  record length.
  Any other copy mechanism may harm the CEXEC
  output and may cause unpredictable results.
  
  ------------------------------------------------------------
  
  NAVIGATION:
  -----------
  Chapter 15. Installing the Function Package
  Section: Preparation, page 133
  Replace section text as follows:
  
  NEW INFORMATION:
  ----------------
  1. The z/OS TSO/E REXX Stream I/O function package is
  shipped together with the IBM Library for REXX on
  z/Series and installed with SMP/E. The executable
  load libraries are in the data set prefix.SEAGFUP.
  
  2. To activate the function package you must
  assemble and link-edit the TSO/E parameter modules
  IRXPARMS and IRXTSPRM.
  
  Customize the JCL job EAGSIOAS, which is in data set
  prefix.SEAGSAM. It contains predefined steps to
  automate the assembly of the TSO/E parameter modules.
  You must customize the PROC section as follows:
  * Specify the load library data set that has already
  been allocated. Replace the uid.REXX with the
  appropriate naming.
  
  * Ensure that SYS1.MACLIB is referenced in your SYSLIB
  concatenation. Modules IEANTRT, IEANTCR, and IEANTDL
  are required and possibly referenced in SYS1.CSSLIB.
  They are the stubs for z/OS Name/Token Services that
  the stream I/O functions require to share data with
  TSO/E REXX.
  
  3. The parameter modules IRXPARMS and IRXTSPRM provided
  with this function package are modified exclusively for
  the needs of the REXX Stream I/O function package.
  They are assembled in job EAGSIOAS and used by
  verification job EAGSIOVE.
  
  ------------------------------------------------------------
  
  NAVIGATION:
  -----------
  Chapter 15. Installing the Function Package
  Section: Assembly, Link-Edit, and Verification, page 155
  Replace the beginning of list item 2 as follows:
  
  NEW INFORMATION:
  ----------------
  2. For the functional verification of the z/OS TSO/E REXX
  Stream I/O function package customize job EAGSIOAS:
  
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 15. Installing the Function Package
  Section: Installations with Multiple Function Packages,
  page 134
  Replace list item 4 as follows:
  
  NEW INFORMATION:
  ----------------
  4. Consider to add prefix.SEAGFUP to the LPA list.
  LPA is APF authorized. Make sure that you do not loose
  APF authorization when concatenating prefix.SEAGFUP.
  The relevant modules for the Stream I/O function
  package are EAGEFSIO and EAGIOHKP. Make sure that the
  updated TSO/E parameter modules IRXPARMS and IRXTSPRM
  are first in the search order.
  
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 16. Understanding the Stream I/O Concept
  Section: The Basic Elements of Stream I/O, page 135
  Use "access method" instead of "storage media".
  Correct words in second bullet as follows:
  
  NEW INFORMATION:
  ----------------
  A sequence of lines that can be read or written line
  by line. A line in this context is defined as a sequence
  of characters that are terminated by means of any
  special character, or by means of the organizational form
  of the access method.
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 16. Understanding the Stream I/O Concept
  Section: The TSO/E REXX Stream I/O Implementation,
  page 136
  Add the following note at the end of the second
  paragraph:
  
  NEW INFORMATION:
  ----------------
  Note:
  The REXX Stream I/O concept shipped together with the REXX
  Runtime Library only applies to z/OS data sets.
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 16. Understanding the Stream I/O Concept
  Section: The TSO/E REXX Stream I/O Implementation
  Subsection: Stream Formats, page 140
  Add the following note at the end of the second
  paragraph:
  
  NEW INFORMATION:
  ----------------
  Note:
  In VB organized data sets Stream I/O functions read and
  write only the data portions. Control characters as
  necessary for VB data sets need not be maintained by
  the Stream I/O functions.
  
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 17. Stream I/O Functions
  Section: CHAROUT
  Subsection: Examples, page 149
  Replace last line of example as follows:
  
  NEW INFORMATION:
  ----------------
  CHAROUT(V20,'29 BYTES FOR a V20 FILE LRECL') -> 1
  /* Variable format */
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 17. Stream I/O Functions
  Section: STREAM (Operations)
  Subsection: Parameters, page 155
  Add the following paragraph to description of name
  
  NEW INFORMATION:
  ----------------
  Note:
  If you specify a preallocated ddname, it must be
  prefixed with an ampersand (&) to distinguish between
  ddnames and data set names. Names that are specified
  without & are treated as data set names.
  
  ------------------------------------------------------------
  NAVIGATION:
  -----------
  Chapter 2. Invoking the Compiler
  Section: Standard Data Sets Provided for the Compiler
  Subsection:Table 4,Data Sets Required by the Compiler (z/OS)
  Change the SYSTERM Record Size LRECL Recommended sizes
  NEW INFORMATION:
  ----------------
  Change the SYSTERM Record Size LRECL recommendations to the
  following:
  F, FB 120 (Recommended)
  FA, FBA 121 (Recommended)
  V, VB 124 (Recommended)
  VA, VBA 125 (Recommended
  
  
  
  
  ------------------------------------------------------------
  

Problem conclusion

• The next documentation update must have incorporated the
  changes.
  

Temporary fix

Comments

APAR Information

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

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

Publications Referenced

SH19816005

Fix information

Applicable component levels