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

More documents

Recommendations

Info

ASSEMBLER Parameter ListNote: General Register 1 points to the parameter list.Table 11. SMTP Commands ASSEMBLER Exit Parameter ListOffset inDecimalLen In/Out Type Description+0 4 Input Char Exit type+4 4 Input Int Version number+8 4 Input Int Mail record ID+12 4 Input Int Port number of SMTP server+16 4 Input Int IP address of SMTP server+20 4 Input Int Port number of client+24 4 Input Int IP address of client+28 4 Input Int Address of SMTP command string+32 4 Input Int Length of SMTP command string+36 4 Input Int Address of HELO name+40 4 Input Int Length of HELO name+44 4 Input Int Address of client domain name+48 4 Input Int Length of client domain name+52 4 Input Int Address of MAIL FROM string+56 4 Input Int Length of MAIL FROM string+60 8 Input Char File name of note on disk+68 4 Input Int Verify Client status+72 4 Output Int Address of Return String+76 4 Output Int Length of Return String+80 4 Input Int Maximum length of Return String+84 8 Input Char Batch VM user ID+92 4 Input/ Char User Word 1Output+96 4 Input/ Char User Word 2Output+100 4 Output Int Return code from exitParameter DescriptionsExit typeA four-character field used to indicate the type of exit called. For the SMTP commands exit, this willbe CMDX.Version numberThe parameter list version number; if the parameter list format is changed, the version number willchange. Your exit should verify it has received the version number it is expecting. The currentversion number is 1.Mail record IDA number that uniquely identifies a piece of mail so that multiple exit calls can be correlated to thesame piece of mail. A value of 0 indicates a mail record ID is not available.Port number of SMTP serverThe port number used by the SMTP server for this connection.IP address of SMTP serverFor the REXX exit, a dotted-decimal format IP address is provided; for the assembler exit, this is an IPaddress in decimal integer form. For multi-homed hosts, this address can be compared with the clientIP address to determine in which part of the network the client host resides.SMTP Commands Exit 32
Port number of clientIf the connection no longer exists, or if the command was received over a batch (BSMTP) connection,-1 is supplied. Otherwise, this is the port number used by the foreign host for this connection.IP address of clientFor the REXX exit, a dotted-decimal format IP address is provided; for the assembler exit, this is an IPaddress in decimal integer form. If the relevant SMTP command was received over a batch SMTP(BSMTP) connection, this field will be 0.File name of note on diskName of the file created after the EOD command or a period ('.') is received. Prior to either of theseconditions, the file name is not defined; in this case, an asterisk (*) will be supplied.Verify Client statusA number that indicates client verification results. Possible values and their meaning are:0 Client verification passed.1 Client verification failed.2 Client verification was not performed.3 Client verification results are unknown.SMTP command stringContains the current command and parameters; the string has been converted to uppercase. Forexample, if this exit was called for the MAIL FROM: command, this string might contain: MAIL FROM:.HELO nameA string that contains the name specified on the HELO command; this string may be either: a domain name an IP address in decimal integer form that is prefixed by the number or (US) pound sign (“#” orX'7B'0) an IP address in dotted-decimal form, enclosed in brackets.For example, if the command HELO #123456 is provided by an SMTP client, this parameter wouldcontain: #123456.The name has already been verified to have the correct syntax.MAIL FROM stringContains the name specified on the MAIL FROM command. The sender path, enclosed in anglebrackets (< and >), is included. The sender path may be in any valid path format; it has already beenverified to have the correct syntax. Because the sender address has been resolved, this string maynot exactly match the data provided with the MAIL FROM command.For example, if the following has been specified by the SMTP client:MAIL FROM: the SMTP command string might contain: Client domain nameThe domain name that corresponds to the client IP address. This field will be a null string if: client verification was not performed the results of client verification are unknown a reverse lookup failedIn all other cases, this will be a domain name.SMTP Commands Exit 33
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: REXX Parameter ListInputsTable 10.
Page 37 and 38: Table 12. SMTP Commands Exit Return
Page 39: ►►──SMSG──server_id─

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

Create successful ePaper yourself

Delete template?

Save as template?