PH34824: ALIGN LITERALS WITH RELATIVE-IMMEDIATE REFERENCES TO A HALF WORD BOUNDARY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A relative addressing instruction (like LARL) with reference to
  an odd length literal can result in message "ASMA058E Invalid
  relative address" if the literal happens to be stored at an odd
  address.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of HLASM for z/OS, z/VM, z/VSE and     *
  *                 Linux                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Align relative immediate literals to a  *
  *                      half word boundary                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An odd length literal that ends up being aligned to an odd
  boundary cannot be referenced by a relative address, because a
  relative address can only be represented by an even address
  (multiple of half words). This is causing relative addressing
  instructions to fail with "ASMA058E Invalid relative address".
  

Problem conclusion

• Changes made to allow relative addressing instructions that
  reference odd length literals to work by aligning the literals
  to a half word boundary.
  
  DOCUMENTATION UPDATES:
  
  In the HLASM Language Reference, SC26-4941-08, the topic
  "Literal Pool" within the "LTORG section" documentation is
  modified as follows.
  
  The following text:
  The fifth segment contains all the remaining literal constants
  whose assembled lengths are odd.
  
  is changed to:
  The fifth segment contains all the remaining literal constants
  whose assembled lengths are odd. Any literal in this segment
  that is referenced by relative address (for example using the
  LARL instruction) is aligned to a halfword boundary to ensure a
  valid relative address.
  
  and the paragraph immediately following is changed as follows
  
  The following sentence:
  
  No space is wasted except, possibly, at the origin of the pool,
  and in aligning to the start of the statement following the
  literal pool.
  
  is changed to:
  Apart from any alignment padding for literals referenced by
  relative address, no space is wasted except, possibly, at the
  origin of the pool, and in aligning to the start of the
  statement following the literal pool.
  
  END OF DOCUMENTATION UPDATES
  

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:

  UI74481 UI74482 UI74483

Modules/Macros

•    ASMAINFO ASMA1A   ASMA15   ASMA16   ASMA26
  ASMA9Z
  

Fix information

• Fixed component name

  HLASM MVS, VM &

• Fixed component ID

  569623400

Applicable component levels

• R160 PSY UI74482

     UP21/03/18 P F103

• R360 PSY UI74481

     UP21/03/17 P 2103

• R689 PSY UI74483

     UP21/03/18 I 1000

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.