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

Subscribe

You can track all active APARs for this component.

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 number

    PK02493

  • Reported component name

    COMP FOR REXX Z

  • Reported component ID

    569501303

  • Reported release

    140

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2005-03-15

  • Closed date

    2005-11-23

  • Last modified date

    2007-10-12

  • 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



Document information


More support for:

Compiler and Library for REXX on zSeries

Software version:

140

Reference #:

PK02493

Modified date:

2007-10-12

Translate my page

Content navigation