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 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

Rate this page:

(0 users)Average rating

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

Machine Translation

Content navigation