Re: Which message is causing which RC

ANS4987E - should be generating RC 4, not RC 12.

ANS1115W - should be generating RC 4, not RC 8.

ANS1448E - should be generating RC 4, not RC 12. You are correct about
this one, it is indeed broken in 5.1, and is fixed in 5.2. This problem is
described in APAR IC36305.

The return codes associated with each message are not configurable, nor
are there any plans to make them configurable.

The specific messages that result in RC 4 are undocumented, and there are
no plans to document them. Rather, we rely on the description of the
behavior, as you quoted from the client manual. On the surface, it may
seem desirable to document the messages. On the other hand, even if I
could point you to a document that says ANS1448E causes return code 'x',
that would not be very helpful to you. The fact is, documented or not, the
actual behavior contradicts the documented behavior of the return codes,
and thus is a bug.

If you are finding that ANS4987E and ANS1115W are not behaving as I
described above AND/OR you require a 5.1-based fix for IC36305, the please
contact IBM support. Note that other warning or error level messages
unrelated to skipped files (except for ANS4987E) may be causing the "> 4"
return code. If you are getting ANS1448E in the same operation as ANS1115W
or ANS4987E, then that is why you are getting RC 12.

Regards,

Andy

Andy Raibeck
IBM Software Group
Tivoli Storage Manager Client Development
Internal Notes e-mail: Andrew Raibeck/Tucson/IBM@IBMUS
Internet e-mail: storman AT us.ibm DOT com

The only dumb question is the one that goes unasked.
The command line is your friend.
"Good enough" is the enemy of excellence.




Radoslav Bendik <bendik AT NS.HTC DOT SK>
Sent by: "ADSM: Dist Stor Manager" <ADSM-L AT VM.MARIST DOT EDU>
08/25/2003 09:29
Please respond to "ADSM: Dist Stor Manager"

        To:     ADSM-L AT VM.MARIST DOT EDU
        cc:
        Subject:        Re: Which message is causing which RC


Hi,

I have same problem and question as mentioned bellow.

This is written in client manual about return codes:
====================================================
RC=4    The operation completed successfully, but some files were not
        processed. There were no other errors or warnings. This return
code is
        very common. Files are not processed for various reasons. The most
        common reasons are:

    * The file is in an exclude list.
    * The file was in use by another application and could not be accessed
      by the client.
    * The file changed during the operation to an extent prohibited by the
      copy serialization attribute. See "Copy serialization".
====================================================

The obvious message causing RC=4 is ANS4987E (file in use) and ANS1115W
(file excluded).

Let's have a file skipped during backup because of permissions (message
ANR1448E). Based on the explanation in client manual, also this message
should cause RC=4, but is causing RC=12 (general error).

I want to know, which messages (exactly) are causing RC=4. Is it
configurable or can it be changed in next releases?

--
rado b
        Why Did You Reboot That Machine?



On Sat, 26 Jul 2003, Andrew Raibeck wrote:

> See the client manual chapter on "Automating tasks". There is a section
> therein that discusses the return codes.and their meanings. Let me know
if
> there is something there that needs clarification.
>
> Regards,
>
> Andy
>
> Andy Raibeck
> IBM Software Group
> Tivoli Storage Manager Client Development
> Internal Notes e-mail: Andrew Raibeck/Tucson/IBM@IBMUS
> Internet e-mail: storman AT us.ibm DOT com
>
> The only dumb question is the one that goes unasked.
> The command line is your friend.
> "Good enough" is the enemy of excellence.
>
>
>
>
> Uwe Schreiber <Uwe.Schreiber AT DAIMLERCHRYSLER DOT COM>
> Sent by: "ADSM: Dist Stor Manager" <ADSM-L AT VM.MARIST DOT EDU>
> 07/26/2003 06:01
> Please respond to "ADSM: Dist Stor Manager"
>
>
>         To:     ADSM-L AT VM.MARIST DOT EDU
>         cc:
>         Subject:        Re: Which message is causing which RC
>
>
>
> yes, thats right.
> but there's no detailed information which messages will cause RC 4.
> thats my major problem.
>
> regards Uwe
>
>
>
>
>
> rbs AT BU DOT EDU
> Sent by: ADSM-L AT VM.MARIST DOT EDU
> 26.07.2003 14:06
> Please respond to
> ADSM-L AT VM.MARIST DOT EDU
>
>
> To
> ADSM-L AT VM.MARIST DOT EDU
> cc
>
> Subject
> Re: Which message is causing which RC
>
>
>
>
>
> >i'am searching a documentation for the TSM client 5.x, which TSM
message
> >is causing which returncode for the TSM client commandline interface.
> >within the available messages-documentation there is no info about the
> >resulting RC (0 or 4 or 8 or 12).
> >does someone know where i can find such a docu.
>
> The B/A client manual explains that the return code is based upon the
> severity code letter (last letter of the message id).
>
> Richard Sims, BU
>