PJ33788: ENHANCE MAKETPF TO SUPPORT SABRETALK SOURCE FILES

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • APAR Type      :   E
    CMVC defect    :
    Bad APAR       :
    PE Type        :
    Functional Area:   51B
    Segment Docname:
    Symptom keyword:   maketpf   sabretalk
    4.1 APAR Number:
    DESCRIPTION:
    Enhance the MakeTPF tools to support Sabretalk source files.
    This will include converting the Sabretalk file to ASM format
    and then assembling and linking that ASM file.  The conversion
    from Sabretalk to ASM will be initiated from Linux, but will be
    performed remotely on USS.
    

Local fix

  • na
    

Problem summary

Problem conclusion

  • SOLUTION:
    The process for compiling SabreTalk source code has been
    incorporated into the MakeTPF schema. SabreTalk files can now
    be included as source files within a MakeTPF APP makefile, by
    defining the list of SabreTalk files using the new SBR_SRC
    variable. The support is similar to that for ASM_SRC variables,
    where only the base file name and extension is specified in the
    assignment statement, for example "SBR_SRC := file.sbr". The
    supported file extensions for SabreTalk source files are "sbr",
    "sbt", and "sabr".
    
    When SabreTalk files are defined, the following process occurs
    to compile the SabreTalk file and generate an elf format
    object. The process is initiated on Linux but the actual
    SabreTalk compile is run on z/OS.
    
    - Create the JCL needed to run the SabreTalk compiler on z/OS
    and convert the SabreTalk file to an assembler file.
    - Create a script that will submit and run the JCL on z/OS and
    wait for the JCL job to complete.
    - FTP the JCL, SCRIPT, and SabreTalk file to a temporary
    working directory on z/OS.
    - Issue an REXEC command from Linux to z/OS to run the SCRIPT.
    The script will submit the JCL and wait for its completion.
    - FTP the generated assembler file and JCL output (listing)
    from z/OS back to Linux once the REXEC completes and then
    delete the working files and directory from z/OS.
    - Assemble the generated assembler file to create the elf
    object. Any ASMFLAGS specified will be applied during the
    assembly.
    - Move the generated assembler file to the maketpf output
    directory for optional review.
    
    Customization of the MakeTPF tools is required during the
    install of this APAR to configure the JCL used to run the
    SabreTalk compile for the target z/OS system. Please refer to
    the tpftools/samples/README_SabreTalk file delivered in this
    APAR for details on installing and customizing the tools.
    
    To enable the FTP and REXEC commands needed by the SabreTalk
    conversion utility to automatically connect to the z/OS system,
    each user must add an entry to his .netrc file in his Linux
    home directory to define the login information for the z/OS
    system. If the user's z/OS userid is different from his Linux
    userid, the user must also define the S390USER variable in the
    maketpf.cfg settings. Details on the .netrc file can be found
    in the README_SabreTalk file as well as in the manpages for FTP
    on Linux.
    
    During testing of the SabreTalk support it was discovered that
    depending on which FTP client is available on the Linux system
    (for example netBSD or Kerberos), the parameters accepted on
    the command line and the format of the target host name can
    vary. Because of those differences, the following updates have
    also been made to generalize the ftp commands used by the
    maketpf tools so that they should work with more clients:
    - The loadtpf command has been updated to support a
    LOADTPF_USER variable that can be used when connecting to a TPF
    system. If not specified, it defaults to the Linux userid. When
    connecting, the value of the LOADTPF_USER variable is validated
    against the .netrc file. The loadtpf command continues to also
    accept the LOADTPF_IP specified in the format
    ftp://user:pwd@host (where user and pwd can be anonymous) --
    however that format is not supported by all FTP clients, and
    for those clients, the .netrc file must be used to define the
    userid and password.
    - The maketpf ftpload (and ftplib) targets have been updated to
    also recognize the S390USER variable and use the .netrc file to
    obtain the password for connection to the S390 system.
    
    Lastly, the sip assembly rule in the maketpf.rules file was
    updated to correct an error seen when the ADATA option is
    specified in ASMFLAGS during the sip assembly.
    
    COREQS: NO
    None.
    
    MIGRATION CONSIDERATIONS: YES
    Build and load process changes:
    The MakeTPF tools require customization at install time to
    enable the SabreTalk compiler support.  This solution requires
    the ability to automatically connect to a z/OS system, transfer
    files to and from that system, and submit JCL on that system.
    Details on the customization are provided in the
    tpftools/include_ztpf/README_SabreTalk file delivered in this
    APAR.
    
    
    
    BUILD COMMANDS AND INSTRUCTIONS: NO
    None.
    
    UPDATED INFORMATION UNITS: NO
    None.
    
    See your IBM representative if you need additional information.
    
    DOWNLOAD INSTRUCTIONS:
    http://www.ibm.com/software/htp/tpf/pages/maint.htm
    
    APAR URL:
    http://www.ibm.com/software/htp/tpf/ztpfmaint/put5/PJ33788.htm
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ33788

  • Reported component name

    Z/TPF

  • Reported component ID

    5748T1501

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2008-06-10

  • Closed date

    2008-07-02

  • Last modified date

    2008-07-02

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

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

Fix information

  • Fixed component name

    Z/TPF

  • Fixed component ID

    5748T1501

Applicable component levels

  • R110 PSY

       UP



Rate this page:

(0 users)Average rating

Document information


More support for:

TPF
z/TPF

Software version:

110

Reference #:

PJ33788

Modified date:

2008-07-02

Translate my page

Machine Translation

Content navigation