9/25/2018 IBM Knowledge Center - DSNTIAR

The assembler subroutine DSNTIAR helps you to obtain a formatted form of the SQLCA and a
text message that is based on the SQLCODE field of the SQLCA.

DSNTIAR can run either above or below the 16-MB line of virtual storage. The DSNTIAR object
module that comes with Db2® has the attributes AMODE(31) and RMODE(ANY). At installation
time, DSNTIAR links as AMODE(31) and RMODE(ANY). DSNTIAR runs in 31-bit mode if any of
the following conditions is true:

• DSNTIAR is linked with other modules that also have the attributes AMODE(31) and
RMODE(ANY).

• DSNTIAR is linked into an application that specifies the attributes AMODE(31) and
RMODE(ANY) in its link-edit JCL.

• An application loads DSNTIAR.

When loading DSNTIAR from another program, be careful how you branch to DSNTIAR. For
example, if the calling program is in 24-bit addressing mode and DSNTIAR is loaded above the
16-MB line, you cannot use the assembler BALR instruction or CALL macro to call DSNTIAR,
because they assume that DSNTIAR is in 24-bit mode. Instead, you must use an instruction
that is capable of branching into 31-bit mode, such as BASSM.

You can dynamically link (load) and call DSNTIAR directly from a language that does not
handle 31-bit addressing. To do this, link a second version of DSNTIAR with the attributes
AMODE(24) and RMODE(24) into another load module library. Alternatively, you can write an
intermediate assembler language program that calls DSNTIAR in 31-bit mode and then call
that intermediate program in 24-bit mode from your application.

For more information on the allowed and default AMODE and RMODE settings for a particular
language, see the application programming guide for that language. For details on how the

Please note that DISQUS operates this forum. When you sign in to comment, IBM will provide your
email, first name and last name to DISQUS. That information, along with your comments, will be
governed by DISQUS’ privacy policy. By commenting, you are accepting the DISQUS terms of service.

Sign In

https://www.ibm.com/support/knowledgecenter/en/SSEPEK_11.0.0/apsg/src/tpc/db2z_dsntiar.html 2/3