> Date: Wed, 15 Jan 1997 13:46:29 -0500
> From: "Klein, Robert" <kleinr AT EXCHANGE.NIH DOT GOV>
> Subject: Query Event Return Codes
>
> One of the outputs of the query event f=d command is the return code if the
> scheduled event failed. The description of this field in the MVS server
> reference manual says to refer to the appropriate user's guide for more
> information on the value of this return code. When I looked in "Using the
> Microsoft Windows Backup-Archive Clients", I did not seen any reference to
> return codes. Could someone please enlighten me on what the appropriate
> users guide would be? Thanks.
Kevin,
I had the same question about a year ago. Below is the response that I
received from IBM. It is very important to note that these return codes are
NOT reliable.
" ... the return codes are not described anywhere and since they cannot
be relied upon, the text is misleading in this way."
Also note the following from apar ic11804:
"The return code from the execution of any of the ADSM
executables (except the ADSM API) cannot be relied upon, and is not
consistent and is therefore not documented. We will take this APAR as a
suggestion to make the return codes from the ADSM executables more
reliable, or to at least always return a negative return code if a
failure occurred, in a future release. We will also document that the
return codes from executables cannot be relied upon. We do log errors
in the error log and the schedule log, and these are what you should
rely upon. We want to address this in a future release, but have two
difficulties: first, the ADSM client today can return from different
layers and places in the code, and would require a significant redesign.
Second, customers have different opinions of what constitutes a failure.
If a schedule or incremental backup completes but has certain files that
failed, the DSMC SCHEDULE or INCREMENTAL commands did complete
successfully. Some customers would want a good return code, and some
would want a failure return code. It is the same if the files were
excluded. That is why we use the logs instead. The logs have all the
information, which can be used in whatever way the customer wants,
depending on the customer's interpretation of failure and success. If
we are able to implement the customer's suggestion in a future release,
the client scheduler would be the most likely area that we could
redesign in conjunction with the ADSM server and give back meaningful
return codes."
I hope this helps.
DanC
=============================================
Daniel G. Crouse
Software Information Services, Inc.
Email: Dan.Crouse AT Transquest DOT com
Vmail: 800-233-6838
Voice: 404-714-5754
Fax: 770-682-7739
=============================================
begin 640 AT000116074140
M>)\^(@H,`0:0"``$```````!``$``0>0!@`(````Y`0```````#H``$)@`$`
M(0```#<T.34P03<S1#(V140P,3%"-#%&,#`X,$0X-#`Q-C<V`.0&`06``P`.
M````S0<!`!``!P`=`#L`!`!(`0$-@`0``@````(``@`!"(`'`!@```!)4$TN
M36EC<F]S;V9T($UA:6PN3F]T90`Q"`$$@`$`'0```%)%.B!1=65R>2!%=F5N
M="!2971U<FX@0V]D97,`UPD!!)`&`$P"```"````"````!X`(#H!````%P``
M`"=!1%--+4Q`5DTN34%225-4+D5$52<```L`0#H!`````P`5#`$````>``$P
M`0```!<````G041332U,0%9-+DU!4DE35"Y%1%4G```>``,P`0```!D```!7
M5#0P,"]75#0P,%!/+T%$4TU,5DU-05(`````'@`",`$````#````35,```(!
M"S`!````'````$U3.E=4-#`P+U=4-#`P4$\O041334Q634U!4@`"`?\/`0``
M`%0``````````&"49&!!N`$(`"LKBBD```````!D`!H`.P`9`````@`G0413
M32U,0%9-+DU!4DE35"Y%1%4G`%=4-#`P+U=4-#`P4$\O041334Q634U!4@`(
M````'@`@.@$````:````)VML96EN<D!%6$-(04Y'12Y.24@N1T]6)P````L`
M0#H``````P`5#`(````>``$P`0```!H````G:VQE:6YR0$580TA!3D=%+DY)
M2"Y'3U8G````'@`#,`$````8````:VQE:6YR0$580TA!3D=%+DY)2"Y'3U8`
M'@`",`$````%````4TU44``````"`0LP`0```!T```!33510.DM,14E.4D!%
M6$-(04Y'12Y.24@N1T]6``````(!_P\!````5@``````````8)1D8$&X`0@`
M*RN**0```````&0`&@`^`!@````4`"=K;&5I;G)`15A#2$%.1T4N3DE(+D=/
M5B<`:VQE:6YR0$580TA!3D=%+DY)2"Y'3U8```#Z90$#D`8`0`H``!@````"
M`0LP`0```!````!TE0ISTF[0$;0?`(#80!9V'@!P``$````=````4D4Z(%%U
M97)Y($5V96YT(%)E='5R;B!#;V1E<P`````"`7$``0```!8````!O`.I*]9X
MP"M/;Y@1T(+1`*`DF#'/``!``#D`,`\:_:@#O`$#`/$_"00```(!1P`!````
M.0```&,]55,[[email protected]`]5')A;G-1=65S=#ML/5-!5$Q-4T=54U(P-BTY-S`Q
M,38Q,C(Y-3E:+34S-#`Q``````(!^3\!````5`````````#<IT#(P$(0&K2Y
M"``K+^&"`0`````````O3SU44D%.4U%515-4+T]5/4Y/4E1(($%-15))0T$O
M0TX]4D5#25!)14Y44R]#3CU$0U)/55-%`!X`^#\!````#````$-R;W5S92P@
M1&%N``(!^S\!````5`````````#<IT#(P$(0&K2Y"``K+^&"`0`````````O
M3SU44D%.4U%515-4+T]5/4Y/4E1(($%-15))0T$O0TX]4D5#25!)14Y44R]#
M3CU$0U)/55-%`!X`^C\!````#````$-R;W5S92P@1&%N`$``!S``B!C]J`.\
M`4``"#`P@C+]J`.\`0L`(P``````"P`I```````#`!<``0````,`-@``````
M'@`:``$````)````25!-+DY/5$4``````@$)$`$```!G!P``8P<``&,-``!,
M6D9UF5E8NO\`"@$/`A4"I`/D!>L"@P!0$P-4`@!C:`K`<V5T;C(&``;#`H,R
M`\4"`'"$<G$2(G-T96T"@RXS`\8'$P*#-`]Z:&6B;`,@1&QG`H,U%*TN?0J`
M",\)V3L9/S(U'C4"@`J!#;$+8&YG,3PP,Q20"PH4D@'0(#ZE%M!A%!`Z(!Y1
M5PF`0"P@,34@[email protected],[email protected]<>T#,Z-#8`.C(Y("TP-3`;"G8=X$8#81Y#(DML
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
+0V]D97,`````,U<$
`
end
|
