gtpc1m56Transmission Control Protocol/Internet Protocol

TPF Internet Mail Server Administrator or Operator Tasks

As an administrator or operator, you can perform tasks related to:

Configuring the TPF System for TPF Internet Mail Server Support

The following shows an example of how to configure the TPF system for TPF Internet mail server support. Consider the following scenario:

  1. Update the SIP RAMFIL macro input statements to define fixed file record type #MAIL01 and allocate 1000 records of that type.
  2. Run the FACE table generator (FCTBG) to create a new FACE table (FCTB).
  3. Assemble the SIP stage I deck to create a SIP stage II deck.
  4. Run SIP stage II.
  5. Verify that recoup descriptor BKD1 is defined correctly for fixed file record type #MAIL01. The GROUP and INDEX macro statements will look as follows:
             SYSEQC
             DC    AL2(3)     NUMBER OF PRIMARY GROUPS IN THIS CONTAINER
             DC    S(IAQ,IDQ,IMAI)  PRIME GROUPS
    
      ·
      ·
      ·
    IMAI GROUP MAC=IMAIL,ID=FC55,ECB=10,MET=(SEQ,0),NBR=1,TYP=#MAIL01, X TIME=900,USE=BASE,VER=0,GRP=FC50,IDCOMP=(FC66,0), X ENT=INDON55,EXT=INDOFF55 INDEX TYP=V,FI=IMAIL_LVL1_ENTY,FA=IMAIL_LVL1_ENTY+4, X LI=L'IMAIL_LVL1_ENTY,CNT=(N,500),ALTID=IMAI_ALT
  6. IPL your TPF system and cycle the system to CRAS state or higher.
  7. Enter ZIFIL MAIL01/FC55/00/0/999/NNN/N to initialize the #MAIL01 records.
  8. Enter the following on every processor to initialize the mail-related IBMMP4 records:

    ZIFIL IBMMP4/FC63/00/20/20/NNN/N

    ZIFIL IBMMP4/FC66/00/21/21/NNN/N

    Note:
    You only need to do this the first time you set up a mail server.
  9. Enter ZMAIL FLUSH to initialize the database queue pointers.
    Note:
    You only need to do this the first time you set up a mail server.
  10. Create the SMTP configuration file (/etc/postfix/main.cf); for example:
    #---------------------------------------------------------------------#
    #  SMTP Configuration File                                            #
    #  File Name: /etc/postfix/main.cf                                    #
    #---------------------------------------------------------------------#
    myhostname = tpf01.tpfmail.com
    mydomain = tpfmail.com
    mynetworks = 172.0.0.0/8, 192.0.0.0/8
    mail_name = TPF Mail
    smtpd_banner = $myhostname ESMTP $mail_name
    maximal_queue_lifetime = 4
    minimal_backoff_time = 1000
    ignore_mx_lookup_error = YES
    smtpd_helo_required = YES
    smtpd_helo_restrictions = check_helo_acl,permit_mynetworks,reject_invalid_hostname
    smtpd_client_restrictions = check_client_acl,permit_mynetworks,reject_unknown_client
    smtpd_sender_restrictions = check_sender_acl,reject_unknown_sendom
    
    Note:
    Ensure that the domain name is a valid, registered domain.
  11. Create the IMAP/POP configuration file (/etc/imapd.conf); for example:
    #---------------------------------------------------------------------#
    #  IMAP/POP Configuration File                                        #
    #  File Name: /etc/imapd.conf                                         #
    #---------------------------------------------------------------------#
    quotawarn: 90
    timeout: 30
    poptimeout: 10
    popminpoll: 5
    autocreatequota: 256
    
  12. Create the TPF configuration file (/etc/tpf_mail.conf); for example:
    #---------------------------------------------------------------------#
    #  TPF Configuration File                                             #
    #  File Name: /etc/tpf_mail.conf                                      #
    #---------------------------------------------------------------------#
    MAIL_SSID: BSS
    MAX_LOCAL_DELIVERY_MANAGERS: 10
    MAX_REMOTE_DELIVERY_MANAGERS: 10
    MAX_DEFERRED_DELIVERY_MANAGERS: 10
    AQ_ACK_TIMER_INTERVAL: 30
    DQ_ACK_TIMER_INTERVAL: 30
    DEFER_Q_BACKOFF: 1800
    MAIL_DOMAIN01: 249999991 flyair.tpfmail.com 192.168.135.55
    192.168.100.200 172.234.255.88 172.234.245.20 192.221.117.23
    
  13. Create the access list configuration file (/etc/postfix/access); for example:
    #---------------------------------------------------------------------#
    #  Access List Configuration File                                     #
    #  File Name: /etc/postfix/access                                     #
    #---------------------------------------------------------------------#
    www.greatstuff.com ACCEPT
    www.nogood.com REJECT
    
  14. Update the external DNS servers with the domain names and IP addresses.
  15. Add the SMTP, IMAP, and POP servers to the Internet daemon configuration file (IDCF) by entering the following:

    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

  16. Enter ZMAIL START READ to start the IMAP and POP servers.
  17. Enter ZFILE export MAILDOMAIN=flyair.tpfmail.com to set the MAILDOMAIN environment variable.
  18. Create an account for your three users by entering the following:

    zmail cm larry

    zmail password larry larrypwd

    zmail cm curly

    zmail password curly curlypwd

    zmail cm moe

    zmail password moe moepwd

  19. Enter ZMAIL START ALL to start all the TPF Internet mail servers.

See TPF System Generation for more information about defining and allocating fixed file records. See TPF Operations for more information about the ZIFIL, ZINET ADD, and ZMAIL commands.

Adding a Domain to an Existing TPF Internet Mail Server Configuration

Assume you configured your TPF system for one mail domain, but now your business has expanded and there is a requirement to add another mail domain called trainride.tpfmail.com.

  1. Update the SIP RAMFIL macro input statements to define fixed file record type #MAIL02 and allocate 1000 records of that type.
  2. Run the FCTBG to create a new FACE table.
  3. Assemble the SIP stage I deck to create a SIP stage II deck.
  4. Run SIP stage II.
  5. Update the TPF configuration file (/etc/tpf_mail.conf); for example:
    #---------------------------------------------------------------------#
    #  TPF Configuration File                                             #
    #  File name: /etc/tpf_mail.conf                                      #
    #---------------------------------------------------------------------#
    MAIL_SSID: BSS
    MAX_LOCAL_DELIVERY_MANAGERS: 10
    MAX_REMOTE_DELIVERY_MANAGERS: 10
    MAX_DEFERRED_DELIVERY_MANAGERS: 10
    AQ_ACK_TIMER_INTERVAL: 30
    DQ_ACK_TIMER_INTERVAL: 30
    DEFER_Q_BACKOFF: 1800
    MAIL_DOMAIN01: 249999991 flyair.tpfmail.com 192.168.135.55
    192.168.100.200 172.234.255.88 172.234.245.20 192.221.117.23
    MAIL_DOMAIN02: 249999991 trainride.tpfmail.com 172.118.255.77
    
  6. Update recoup descriptor BKD1 to include the GROUP and INDEX macro pairs for the #MAIL02 fixed file record type, as follows:
             SYSEQC
             DC    AL2(4)     NUMBER OF PRIMARY GROUPS IN THIS CONTAINER
             DC    S(IAQ,IDQ,IMAI,IMAJ)  PRIME GROUPS
    
      ·
      ·
      ·
    IMAI GROUP MAC=IMAIL,ID=FC55,ECB=10,MET=(SEQ,0),NBR=1,TYP=#MAIL01, X TIME=900,USE=BASE,VER=0,GRP=FC50,IDCOMP=(FC66,0), X ENT=INDON55,EXT=INDOFF55 INDEX TYP=V,FI=IMAIL_LVL1_ENTY,FA=IMAIL_LVL1_ENTY+4, X LI=L'IMAIL_LVL1_ENTY,CNT=(N,500),ALTID=IMAI_ALT IMAJ GROUP MAC=IMAIL,ID=FC55,ECB=10,MET=(SEQ,0),NBR=1,TYP=#MAIL02, X TIME=900,USE=BASE,VER=1,GRP=FC50,IDCOMP=(FC66,0), X ENT=INDON55,EXT=INDOFF55 INDEX TYP=V,FI=IMAIL_LVL1_ENTY,FA=IMAIL_LVL1_ENTY+4, X LI=L'IMAIL_LVL1_ENTY,CNT=(N,500),ALTID=IMAI_ALT
  7. Enter ZMAIL STOP ALL to stop the TPF Internet mail servers.
  8. IPL your TPF system and cycle to CRAS state or higher.
  9. Enter ZIFIL MAIL02/FC55/00/0/999/NNN/N to initialize the #MAIL02 records.
  10. Enter ZMAIL START ALL to restart the TPF Internet mail servers and read the updated configuration file.

See TPF System Generation for more information about defining and allocating fixed file records. See TPF Operations for more information about the ZIFIL and ZMAIL commands.

Adding New Users to an Existing TPF Internet Mail Server Configuration

Assume you have a working TPF Internet mail system with three users. With your business continuing to expand, you have hired two new people and need to add new accounts.

  1. Enter the following to create the new user accounts:

    zmail cm steveu

    zmail password steveu netwalk

    zmail cm katej

    zmail password katej tigger

See TPF Operations for more information about the ZMAIL commands.

Controlling the TPF Internet Mail Servers

Use the ZMAIL command to control the TPF Internet mail servers.

The ZMAIL command allows you to:

Managing Client Mailboxes

There are a number of ZMAIL commands that allow you to manage client mailboxes. With these commands you can:

See TPF Operations for more information about the ZMAIL commands.