gtpm2m37Migration Guide: Program Update Tapes

TPF Internet Mail Server Enhancements for PUT 15 (APAR PJ27966)

The following section discusses the migration considerations for TPF Internet mail server enhancements for PUT 15.

Prerequisite APARs

See the APEDIT for APAR PJ27966 for information about prerequisite APARs.

Functional Overview

TPF Internet mail server enhancements for PUT 15 improve the performance and functionality of TPF Internet mail server support. See TPF Internet Mail Server Support (APARs PJ27784 and PJ27865) for more information.

The enhancements provided with APAR PJ27966 include the following:

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

There are no changes.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

There are no changes.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 1161 summarizes the general use C/C++ language header file changes. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

General use means these header files are available for your use.

Table 1161. Changes to General Use C/C++ Language Header Files for TPF Internet Mail Server Enhancements for PUT 15

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
tpf_mail.h Changed No Not Applicable

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

Table 1162 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 1162. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TPF Internet Mail Server Enhancements for PUT 15

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
tpfmail.h Changed No Not Applicable
tpfmaild.h Changed No Not Applicable

Library Interface Scripts

There are no changes.

Link-Edited Modules

Table 1163 summarizes changes to the link-edited modules shipped by IBM, which should go into a data set with attributes DCB=(RECFM=U,LRECL=80,BLKSIZE=1200). This information is presented in alphabetic order by the name of the link-edited module.

Table 1163. Changes to Link-Edited Modules for TPF Internet Mail Server Enhancements for PUT 15

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CMNA Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMNC Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMNI Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMNM New Added for TPF Internet mail server enhancements for PUT 15.
CMNP New Added for TPF Internet mail server enhancements for PUT 15.
CMNS New Added for TPF Internet mail server enhancements for PUT 15.
CMNZ Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMN0 Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMN1 Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMN2 Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMN3 Changed Updated for TPF Internet mail server enhancements for PUT 15.
CMN8 Changed Updated for TPF Internet mail server enhancements for PUT 15.
COMX Changed Updated for TPF Internet mail server enhancements for PUT 15.

Members

Table 1164 summarizes changes to members. This information is presented in alphabetic order by the name of the member.

Notes:

  1. You must recompile or reassemble a member if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 1164. Changes to Members for TPF Internet Mail Server Enhancements for PUT 15

Member DLM/DLL/LLM Name Type New, Changed, or No Longer Supported? Member Type Description of Change
C536 COMX LLM Changed C Language Updated for TPF Internet mail server enhancements for PUT 15.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

There are no changes.

Fixed File Records

There are no changes.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

There are no changes.

Data Macros

There are no changes.

General Macros

There are no changes.

Selected Equate Macros

Table 1165 summarizes the selected equate macro changes. This information is presented in alphabetic order by the name of the selected equate macro.

Table 1165. Changes to Selected Equate Macros for TPF Internet Mail Server Enhancements for PUT 15

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs? Programs to Reassemble
CZ1SE Changed No Not Applicable

Structured Programming Macros (SPMs)

There are no changes.

System Initialization Program (SIP) Skeleton and Internal Macros (Inner Macros)

Table 1166 summarizes the system initialization program (SIP) skeleton and internal macro changes. This information is presented in alphabetic order by the name of the SIP skeleton and internal macro. If the SIP skeleton and internal macro (inner macro) is changed, you must reassemble the SIP Stage I deck and run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

Table 1166. Changes to SIP Skeleton and Internal Macros for TPF Internet Mail Server Enhancements for PUT 15

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
SPPGML Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 1167 summarizes system initialization program (SIP) Stage II macro changes. This information is presented in alphabetic order by the name of the SIP Stage II macro. If IBMPAL is changed, you must run the system allocator (SALO) and load the new program allocation table (PAT) to the TPF 4.1 system.

Table 1167. Changes to SIP Stage II Macros for TPF Internet Mail Server Enhancements for PUT 15

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

There are no changes.

System Equates

There are no changes.

User Exits

There are no changes.

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 1168 summarizes command changes. This information is presented in alphabetic order by the name of the command. See TPF Operations for a complete description of all commands.

Attention: Changes to commands can impact any automation programs you are using in your complex.

Table 1168. Changes to Commands for TPF Internet Mail Server Enhancements for PUT 15

Command New, Changed, or No Longer Supported? Description of Change
ZMAIL Changed Added the SYSLOG parameter.

Messages and System Errors

Table 1169 summarizes message (offline and online messages) and system error changes.

The message IDs or system error numbers are listed in numeric order preceded by their alphabetic prefix. Some offline and online messages do not have a standard message ID. For these, the messages are presented in alphabetic order based on the initial message text; or for those messages that begin with variable information, the initial message text that follows that variable information. See Messages (System Error and Offline) and Messages (Online) for a complete description of all messages and system errors.

Attention: Changes to offline messages, online messages, and system errors may impact any automation programs you are using in your complex.

Table 1169. Changes to Messages and System Errors for TPF Internet Mail Server Enhancements for PUT 15

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
09812D System Error New
IMAP0001E Online New
IMAP0002E Online New
IMAP0003E Online New
IMAP0004E Online New
POP30001E Online New
POP30002E Online New
POP30003E Online New
POP30004E Online New
SMTP0001E Online New
SMTP0002E Online New
SMTP0003E Online New
SMTP0004E Online New

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

There are no changes.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 1170 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See the TPF Library Guide for more information about the TPF library.

Table 1170. Changes to TPF Publications for TPF Internet Mail Server Enhancements for PUT 15

Publication Title Softcopy File Name Description of Change
TPF C/C++ Language Support User's Guide GTPCLU0F Updated with changes to the mail function for TPF Internet mail server enhancements for PUT 15.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about messages and system errors that were added, changed, and no longer supported for TPF Internet mail server enhancements for PUT 15.
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for TPF Internet mail server enhancements for PUT 15.
TPF Operations GTPOPR0F Updated with information about the commands that were added and changed for TPF Internet mail server enhancements for PUT 15.
TPF Transmission Control Protocol/Internet Protocol GTPCLW0B Updated with information about TPF Internet mail server enhancements for PUT 15.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

The mail function was updated to include options that allow you to access Internet mail by using a data level instead of a file name. These changes make it easier for you to process Internet mail with TPF applications that are written in assembler. See the TPF C/C++ Language Support User's Guide for more information about the mail function.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to install TPF Internet mail server enhancements for PUT 15 on your TPF 4.1 system:

  1. Unpack PUT 15, which contains APAR PJ27966 for TPF Internet mail server enhancements for PUT 15. See TPF Memo to Licensees for more information about unpacking the tape.
  2. Install the following:
  3. Run the system allocator (SALO) using IBMPAL and SPPGML additions for newly created segments to create an updated program allocation table (PAT) and system allocator (SAL) table.
  4. Assemble the SIP stage I deck to create a SIP stage II deck.
  5. Run SIP stage II.
  6. Reassemble or recompile the members listed in Table 1164.
  7. Load the link-edited modules listed in Table 1163.
  8. IPL your TPF 4.1 system.
  9. On the mail subsystem, cycle the TPF 4.1 system to CRAS state or higher.
  10. On the mail subsystem, enter the following commands to delete the TPF Internet mail servers from the Internet daemon configuration file (IDCF):

    ZINET DELETE S-SMTP

    ZINET DELETE S-IMAP

    ZINET DELETE S-POP3

    See TPF Operations for more information about the ZINET DELETE command.

  11. On the mail subsystem, enter the following commands to add the TPF Internet mail servers to the Internet daemon configuration file (IDCF) again:

    ZINET ADD S-SMTP PGM-CMNS MODEL-DAEMON ACT-OPER

    ZINET ADD S-IMAP PGM-CMNM MODEL-DAEMON ACT-OPER

    ZINET ADD S-POP3 PGM-CMNP MODEL-DAEMON ACT-OPER

    See TPF Operations for more information about the ZINET ADD command.

  12. On the mail subsystem, enter ZMAIL START ALL to start the TPF Internet mail servers.

    The mail servers are now ready for you to use.