TCP/IP SMTP User Exits Support APAR PQ14324 VM TCP/IP ... - IBM

More documents

Recommendations

Info

Batch VM user IDThis field is only used when SMTP commands arrive over a batch SMTP (BSMTP) connection. If thisexit is called for batch SMTP connections, this field will contain the VM User ID that originated themail. Otherwise, this field is not defined and will contain a null string.User Word 1Provided for use by the assembler exit only. The user word specified upon return from this exit will bepassed back in this field for any future calls; 0 is the initial value. The SMTP server does not use thisvalue in any way.User Word 2Provided for use by the assembler exit only. The user word specified upon return from this exit will bepassed back in this field for any future calls; 0 is the initial value. The SMTP server does not use thisvalue in any way.Return StringWhen the exit returns a return code of 1 or 5, this value is appended to the 550 reply code.Maximum length of Return StringThe current maximum is 512 bytes; ensure the Return String length is less than this value. If thereturned string is longer than the indicated maximum, the return string is truncated and the followingmessage is displayed on the SMTP sever console:Return data from exit exitname exittype too long, data truncatedNormal processing continues.SMTP Commands Exit Return CodesSMTP Commands Exit 34
Table 12. SMTP Commands Exit Return CodesReturnCodeExplanation0 Accept command, and continue normal processing.1 Reject mail with: 551 Return StringIf a return string is not provided by the exit, the following default message will be used:55 Command RejectedThis return code is valid for only the PUNCH command; if 1 is retuned for a PUNCH command exit call, itwill be handled as an invalid exit return code.2 The PUNCH command has been handled by the exit routine; therefore, bypass file delivery. This returncode is valid for only the PUNCH command; if 1 is retuned for a PUNCH command exit call, it will behandled as an invalid exit return code.4 Disable the exit. The following message will be displayed on the SMTP console:SMTPCMDS EXIT function disabledThe exit will no longer be called. The command will be attempted, and processing will continue.5 Reject this command with: 55 Return StringIf a return string is not provided by the exit, then the default message will be displayed:55 Access deniedAll future communications on this connection will be rejected with this 550 message. This return code isvalid for only the PUNCH command; if 1 is retuned for a PUNCH command exit call, it will be handled asan invalid exit return code.xAny return code other than the above causes SMTP to issue this message:Unexpected return from user exit exitname exittype, RC = rcSMTP treats this return code as if it were a return code of 0.Sample SMTP Commands ExitsSample exit routines are supplied with the APAR; the supplied samples are:SMTPCMDX SEXEC REXX exit routineSMTPCMDX ASSEMBLE assembler exit routineSMTP Commands Exit 35
Page 1 and 2: IBM®TCP/IP SMTP User Exits Support
Page 3 and 4: BackgroundAs the use of e-mail has
Page 5 and 6: ►►──QUIT──────
Page 7 and 8: SMTP Commands ExitIn addition to th
Page 9 and 10: Client Verification ExitIt is somet
Page 11 and 12: When this entry is processed, the f
Page 13 and 14: Because an identical exit parameter
Page 15 and 16: ASSEMBLER Parameter ListNote: Gener
Page 17 and 18: Table 4. Client Verification Exit R
Page 19 and 20: EXITIndicates a mail forwarding exi
Page 21 and 22: Table 5. Mail Forwarding Exit - Sam
Page 23 and 24: ASSEMBLER Parameter ListNote: Gener
Page 25 and 26: User Word 1Provided for use by the
Page 27 and 28: SMTP Commands ExitThe SMTP server c
Page 29 and 30: EXPNIndicates the exit routine is t
Page 31 and 32: VRFYIndicates the exit routine is t
Page 33 and 34: REXX Parameter ListInputsTable 10.
Page 35: Port number of clientIf the connect
Page 39: ►►──SMSG──server_id─

TCP/IP SMTP User Exits Support APAR PQ14324 VM TCP/IP ... - IBM

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?