PK92729: ADD USSHOME TO THE DFHSIT6$ SAMPLE SYSTEM INITIALIZATION TABLE.

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • The USSHOME system initialization parameter specifies the root
    directory for CICS TS files on z/OS UNIX. Although the default
    value of /usr/lpp/cicsts/cicsts41 will be set if the USSHOME
    system initialization parameter is not specified, it is
    considered a useful aid to migration to include this value
    explicitly in DFHSIT6$, the CICS-supplied sample SIT.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Add the USSHOME system initialization   *
    *                      parameter to the DFHSIT6$ sample system *
    *                      initialization table.                   *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The USSHOME system initialization parameter specifies the root
    directory for CICS TS files on z/OS UNIX. Although the default
    value of /usr/lpp/cicsts/cicsts41 will be set if the USSHOME
    system initialization parameter is not specified, it is
    considered a useful aid to migration to include this value
    explicitly in DFHSIT6$, the CICS-supplied sample SIT.
    .
    Also, since the USSHOME parameter will need to be specified in
    lowercase, advice has been added to the DFHPA1909, DFHPA1912,
    DFHPA1915 and DFHPA1918 messages and the Operations and
    Utilities Guide manual on how to enter lowercase values from
    SDSF.
    

Problem conclusion

  • The USSHOME system initialization parameter has been added to
    the DFHSIT6$ sample system initialization table with the default
    value of /usr/lpp/cicsts/cicsts41.
    .
    The CICS Transaction Server for z/OS V4R1 CICS Messages and
    Codes Guide manual GC34-7035-00 Section "DFHPAnnnn messages" in
    "Chapter 1. DFH messages" should be changed as follows:-
    .
    The User response for message DFHPA1909 should be changed to:
    "Enter the corrected SIT keyword and data on the console. To
    enter lowercase data, invoke the System Command Extension
    function by typing a / by itself on the SDSF command line, or by
    adding a trailing + to a / command, then enter the override
    enclosing both the keyword and data in apostrophes, remembering
    that the keyword itself must be in uppercase. The command is
    still echoed in uppercase in the job log, but SDSF processes the
    value in mixed case.
    .
    To bypass type '.END', or just supply a blank line."
    .
    .
    The User response for message DFHPA1912 should be changed to:
    "On the console enter the corrected SIT override, bypass the
    override in error and all overrides that follow by typing
    '.END', or supply a blank line to bypass only the override in
    error.
    .
    To enter lowercase data, invoke the System Command Extension
    function by typing a / by itself on the SDSF command line, or by
    adding a trailing + to a / command, then enter the override
    enclosing both the keyword and data in apostrophes, remembering
    that the keyword itself must be in uppercase. The command is
    still echoed in uppercase in the job log, but SDSF processes the
    value in mixed case."
    .
    .
    The following paragraph should be appended to the User response
    for messages DFHPA1915 and DFHPA1918:
    "To enter lowercase data, invoke the System Command Extension
    function by typing a / by itself on the SDSF command line, or by
    adding a trailing + to a / command, then enter the override
    enclosing both the keyword and data in apostrophes, remembering
    that the keyword itself must be in uppercase. The command is
    still echoed in uppercase in the job log, but SDSF processes the
    value in mixed case."
    .
    .
    The CICS Transaction Server for z/OS V4R1 Operations and
    Utilities Guide manual SC34-7002-00 Section "Entering
    corrections to parameters at the console" in "Chapter 2.
    Starting up CICS regions", section "Overriding systems
    initialization parameters during startup" should be changed as
    follows:-
    .
    If you have coded PARMERR=INTERACT, and CICS detects a parameter
    error, either in the keyword or in the value you have assigned
    to it, CICS prompts you to correct the error with message
    DFHPA1909, DFHPA1912, DFHPA1915 or DFHPA1918:
    DFHPA1909 'applid' DATA 'data' IS INVALID FOR KEYWORD 'keyword'.
                       RESPECIFY KEYWORD AND DATA.
    DFHPA1912 'applid' SIT OVERRIDE 'keyword' IS NOT RECOGNIZED.
                       SPECIFY CORRECT SIT OVERRIDE.
    DFHPA1915 'applid' INVALID DATA HAS BEEN DETECTED FOR SIT
                       OVERRIDE 'keyword'.  RESPECIFY THE OVERRIDE.
    DFHPA1918 'applid' SIT OVERRIDE DATA 'data' IS OUT OF RANGE FOR
                       KEYWORD 'keyword'. RESPECIFY THE OVERRIDE.
    .
    CICS prompts you to enter corrections to any errors it finds in
    the PARM parameter or the SYSIN data set after it has loaded the
    SIT, and as each error is detected. This means that if there is
    an APPLID parameter following the parameter that is in error,
    either in the PARM parameter or in the SYSIN data set, it is the
    APPLID coded in the SIT that CICS displays in messages
    DFHPA1909, DFHPA1912, DFHPA1915 and DFHPA1918.
    .
    To enter lowercase data, invoke the System Command Extension
    function by typing a / by itself on the SDSF command line, or by
    adding a trailing + to a / command, then enter the override
    enclosing both the keyword and data in apostrophes, remembering
    that the keyword itself must be in uppercase. The command is
    still echoed in uppercase in the job log, but SDSF processes the
    value in mixed case.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK92729

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-07-30

  • Closed date

    2009-08-25

  • Last modified date

    2010-10-18

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

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

    UK49553

Modules/Macros

  •    DFHMEPAE DFHSIT6$ DFH92729
    

Publications Referenced
GC34703500 SC34700200      

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK49553

       UP09/09/05 P F909

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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

CICS Transaction Server

Software version:

4.1

Reference #:

PK92729

Modified date:

2010-10-18

Translate my page

Machine Translation

Content navigation