PosteCS Volume Transaction Processing V3.0 User's
Contents
1. 2 1 1 1 1122 4 1 iJ 4 1 CLIP ree Cn 4 1 Syntax for Sending a Single 4 1 Syntax for Sending Multiple 4 2 Data Element Table oor ree edana enn tuere re anamata viden gere core 4 2 Chapter 5 Using lt 1442 iaaa hano ot rane re Cun 5 1 JI M H 5 1 Syntax for Receiving Packages and File 5 1 Data Element Table 11000 5 2 Chapter 6 Using PosteCSTrack eere Leirietee scene eese roter eret noel vas Occc ene se Ene 6 1 ec PE ED M 6 1 Syntax for Tracking 6 1 Data Element Table tere 6 1 Chapter 7 GetBillCodeNamses Le cec 72. as follow Package ID Send date and time in GMT Receive date and time in GMT Subject of the package sender s account name Name of the attachment or message file with package ID appended Status All exceptions are written to the exception log file By default it will generate an exception log file named exception lt date time gt log in the current working directory Date and time is the current date and time of the user s machine Format of log details are as follow Package ID Send date and time in GMT Subject of the package sender s account name Error code Reason of failure Heb Rey help Synax Completed command syntax Using the PosteCSReceive 5 3 Chapter 6 Using PosteCSTrack Overview PosteCSTrack is used to track packages sent by an account This application can track packages depending on start date end date subject recipient and Package ID All packages sent will be tracked including expired packages Note This application will track also expired packages Syntax for perl PostecsTrack pl a accountname password lt s subject gt lt bill billing code gt lt Tracking beg Begin date lt end End date lt recipient lt pid package id gt lt logfile gt lt e Packages exception filename gt Refer to Data Element Table below Example postecstrack a vipusername vipuserpwd01 beg 02 02 03 end 02 28 01 sub Test Package for Volume Transaction Project e ipc_exception
3. password utility For Solaris usage refer to Chapter 4 for detail Using theGetMailListNames Using the GetMailListNames This page intentionally left blank 8 5 Log Files PosteCSSend File Name and Location File Format Log Files Log Files Chapter 9 Log Files A log file will be created by the VTP application every time it runs The status of all the messages sent received or tracked both successful or failure will be written to log file Users can specify the log file path and name The name and location of the log is the same as what is specified by the user If the user does not specify the name and location the default file name will be output lt date time gt log under the current working directory Time is sender s machine time Package ID Send date and time in GMT Subject Sender s account name recipient s email Status sss a a SSS e The e mail address of the sender Recipient s email The e mail address of the recipient If the package was oe sent to multiple recipients the status of individual email will be shown on separate lines in the log Status Status of the sent process showing Package sent or Package not sent For further detail refer to Chapter 7 Exit Code session Users may specify the log file name by key 1 Sample 508345 07 30 03 16 50 03 GMT PosteCS The subject el mycompany com test yourcompany com Package sent In this example t
4. 3 MEC C 7 3 Syntax for using this Utility 111 1 111111 nnn nnn nnn 7 3 Chapter 8 11 4 4 1 44 1 4 3612 8 4 ojus 8 4 Syntax for using this utility oreet orae 8 4 Chaptet 9 3 09 TP 9 1 Log Files inrer euucuevesnaccowaus 9 1 File Name and Locatioh 1 eere eee 9 1 File Forrml t esee rtr tret cen stecenstcicecieccasasdeepesstenesscaneseneevisceicherecees 9 1 Mea c S 9 1 File Name and 9 2 File Eormat 25 E AEE A EEE 9 2 ngu HH 9 2 File Name and Locations anneren 9 3 File FOr Matsa CEDE 9 3 p eye 9 3 Chapter 10 Exception File 1er Lettere 10 1 Exception EM 10 1 File Name and 10 1 gi HuogurieetepID 10 1 Ex eptio
5. 5 all msg tdir export home mydir l output log e exception log For windows execute via perl script For Solaris execute shell script Refer to Chapter 4 for detail Access a command line prompt 2 Using the above syntax as a model enter the desired keys as shown in the Key column of the Data Element Table below Continued on next page Using the PosteCSReceive 5 1 Using PosteCSReceive Continued Data Element Table Listed below are all the keys switches you can pass to PosteCSReceive Data Element Default Value Compulsory keys El IE 0 avalid PosteCS account and case sensitive All False When this key is used all packages from the inbox will be received and downloaded except for expired packages If this key is not specified it will only receive and download new attachment files since last execution of the application Subject The All packages with the given subject string will be DUE received Subject string can be complete or part of the subject Quotation is required Sender s dee email address email address Begin date Date p Date This indicates the begin date from which the packages should be received Date is in mm dd yyyy format Time can be specified using 24 hour clock format If time is not specified time is default to 00 00 This date must be prior to or equal the current system date End date end Date Current Date This indicates
6. 68756 07 18 03 14 18 15 GMT PostecS Testing el mycompany com Error 10023 Invalid month If it s a query failure will look like the following Query failed Continued next page Technical support 6 2 Exception File Continued PosteCSTrack File Name and The name and location of the log is the same as what is specified by the user If the Location user does not specify the name and location the name will be exception lt date time gt log and under the current working directory File Format Package ID Send date and time Subject Sender s account name Recipient s email address Error code Reason for failure Field Besepio The e mail address of the sender Recipient email The e mail address of the recipient address Reason for failure The description of the error Exception Files Users may specify the exception file path and name at the command line using e key Sample 568756 07 18 03 14 24 11 GMT PosteCS Instruction you your company ca el mycompany com Error 10021 End date less than begin date Exit Codes Technical support This page intentionally left blank 6 2 Chapter 11 Error Codes and Exit Codes Error Codes 48 The number of package recipients exceeds its limits 89 Invalid recipient maillist 7 0 Recipient is not found in the package 97 Error sending package Please contact PosteCS Help Desk Error sending package Please conta
7. Access a command line prompt the Data Element Table Using the above syntax as a model enter the desired keys as shown in Data Element Table Listed below are descriptions of all the keys switches you can pass to PosteCSSend It is advised to follow the sequence of keys listed below for the command line When a key is specified a value must be input except those value stated as Data Key Values Default Value Description Element Compulsory keys Account name Account Account name and password of the sender Must be a valid name and PosteCS account and case sensitive password Recipient s to Email Email address of the recipients or a PosteCS mailing list For address or multiple recipients email address or mail list should be PosteCS separated by commas Space between email or mail list is Mailing acceptable The mailing list has to be created in PosteCS List Message m File name The text file containing the message Must specify a path on the with txt local server This key can be omitted if there is an attachment file extension to send and path Continue on next page Using the PosteCSReceive 4 2 Using PosteCSSend Continued Data Key Values Default Value Description Element Optional keys ipi CC Email N Same as to key Recipient s adresser PosteCS Mailing List No Recipient s bcc Email Same as to key notification and the recipient s PosteCS receive page A addr
8. PosteCS Volume Transaction Processing V3 0 User s Guide CANADA e POSTES POST CANADA Version 3 0 Canada Post Corporation 2701 Riverside Drive Suite E0245 Ottawa Ontario K1A 0B1 Copyright Notice Copyright and other laws protect the contents of this manual the software and other computer programs Copyright Canada Post Corporation and or its licensors 2001 2004 All rights reserved Printed in Canada Table of Contents Chapter 1 PosteCS Volume Transaction Processing Overview 2 2 1 iii 2 1 2 SEI ELITS Et 2 1 System Specifications eeee 2 1 WINKOWS 22s 2 1 IiclEurr 2 1 Solaris Install tioh coro aaaea octets Tec Gace secesteeueseanets ccrer rua 2 2 Solaris Install Settings 5 1 eere 1e eee oco cree exten Boer 2 2 Chapter 3 VTP Properties 6 1 11 1 1 1 111 110 3 1 OVOIVIOW E 3 1 Properties configurations 1 1 1 3 1 Chapter 4 Using PosteCSSend
9. Subject sender s account name recipients email address Error code Reason of failure Hep heip Syntax 7 Providescompleted command syntax Note e For Boolean switches there will be no value associated with the switch The presence of the switch itself or the lack thereof indicates the value e All values are not case sensitive except account name and password e Unnecessary spaces in the values will be discarded Po d output log will show success delivery to a wrong email address Please check the tracking log file or details Using the PosteCSReceive 4 5 Overview Syntax for Receiving Packages and File Attachments Chapter 5 Using PosteCSReceive PosteCSReceive is used to receive and download attachments and or messages It will accept selection criteria for the packages to be downloaded This application is designed to receive new attachment files that had not been received downloaded before Note This application will not receive or download expired packages This application will not receive or download unique package password protected packages perl PostecsReceive pl a accountname password lt s subject gt lt beg Begin date gt lt end End date fm sender email address gt pid package lt all gt m 4 logfilename gt lt e exception filename Refer to Data Element Table below Example postecsreceive a vtpusername vtpuserpwd01 beg 01 02 2002 end sub RFP 22
10. Volume Transaction Processing Overview Overview The Volume Transaction Processing application allows PosteCS customers account holders to create track and receive large volumes of PosteCS transactions packages automatically without using the browser The intention is for PosteCS customers to obtain the application and install it at their sites The application is available to qualified customers through a simple request on the Canada Post Corporation Web site www canadapost ca vtp The application and its executables will be sent to the requesting customers via PosteCS Once installed customers can create an input file that will contain all of the information needed to send PosteCS packages On execution of the PosteCSSend executable the data from the input file will be read and acted upon accordingly Each record from the input file will be executed and will result in the sending of packages through a secure SSL connection with the PosteCS server The PosteCS server will create the packages send out the notifications and perform all package processing When receiving packages the PosteCSReceive executable will automatically receive the PosteCS packages to predefined directory paths and in accordance with identified parameters The executables generate log files and exception files to document their processing results In addition there is a PosteCS Track executable that provides tracking information for packages sent The functionality
11. ct PosteCS Help Desk 168 Too many invalid login attempts Recipient has been locked out from this package Invalid notification options Unauthorized use of billing code for this package Unauthorized use of package priority for this package Continued on next page Exit Codes Error Codes Continued Description 209 Unauthorized use of package expiration for this package 210 1 1 Unauthorized use of package security for this package Correcting an Error Technical support 211 Unauthorized use of package confirmation success for this package 209 210 212 213 214 217 218 219 Unauthorized use of package confirmation failure for this package Unauthorized use of package notification include message option for this package Ee Unauthorized use of package notification include receive page option for this package The number of pre paid replies specified in the package is then authorized for this account more then authorized for this account ee unas unauthorized the original package sender PosteCS Help Desk 1001 This package has been modified since it was processed by the Postal Service ELECTRONIC POSTMARK TM system 10050 This account is not authorized for a scheduled delivery that far in the future 10051 Invalid security option 10052 The expiration time is beyond the capability of the account type For PosteCSSend if a batch fi
12. e viewed successfully etc time Billing code The Billing code Log Files Users may specify the log file name by key t Sample 127768 06 27 03 16 56 07 GMT PosteCS Test el mycompany com you yourcompany com Received 06 27 03 20 07 45 GMT 357billcode In this example the status shows the recipient has already receive the package 128687 07 17 03 16 56 08 GMT PosteCS Instruction you yourcompany com Recipient Notified 07 17 03 16 56 48 GMT In this example the status shows the recipient has been notified with the email notification pending to receive the package Note No of packages tracked and received will correspond to the total count of packages shown in the outbox inbox respectively Detail deliveries and status per email address will be reported in the track log and receive log Log Files 9 3 Chapter 10 Exception File Exception A file containing errors or exceptions encountered by the application wil be created Files The exception file is only created if a problem is encountered PosteCSSend File Name and The name and location of the log is the same as what is specified by the user If the Location user does not specify the name and location the name will be exception date time gt log and under the current working directory File Format Send date and time in GMT Subject Sender s account name Recipient s email address Error code Reason of fa
13. entionally left blank 6 2 Chapter 12 Troubleshooting Problems amp Solutions Unable to contact the Before contact the PosteCS Help Desk server contact the Make sure vtp property file has ServerName PosteCS Administrator cpc postecs com Make sure your firewall is open for port 5680 If the above is correct check with your network administrator if there is network issues or if proxy settings are required the path specified path to set correct to the install path Java ClassNotFound Check if Classpath is set properly in pl files in bin folder exception Please use double forward slash to indicate all paths in pl and vtp properties file created Check for disk space Can t open perl script Check the correct spelling for PosteCSSend No such file or directory PosteCSReceive PosteCSTrack GetBillingCodeNames and GetMailListNames Account name is A valid and active PosteCS account is required If you incorrect have not have an account you need to enroll via https cpc postecs com enroll If you have an account your account may be inactive contact the PosteCS Help Desk Failure to send e mail Recipient should have a PosteCS Account If a recipient using Account Based does not have PosteCS Account this application will not Password security be able to deliver mail using this security option option Account is locked After 3 unsuccessful login attempts the account is locked of security reasons To unlock
14. ess or PosteCS Subject line 5 No quotation is required Attached File name File Attachment It can be single file or multiple files separated by Mailing File s with comma Must specify a path on the local server extension Electronic epm Postmark postmark not be postmarked The default value is no postmark except the sender s account was created with Electronic Postmark enabled and path Priority 1 The priority for the package The priority setting determines the n order in which the PosteCS Server processes packages low h n Normal h high Security sec Standard Standard Standard Basic Security Encrypt the package on the PosteCS ABP server and require the recipient to use a secure connection to Package access the package password ABP Account Based Password Recipient will be required to enter his her PosteCS account password to access the package Requires the recipient to have a PosteCS account Package password Any value other than standard or will be considered as package password Password should be at least 8 digits and must be alphanumeric with at least 1 digit and 1 character For package password protected message recipient will be required to enter this value password to access the List The subject This will appear on the header as the subject line of the email False i e no When this key is used package will be postmarked If not it will package language f Notify
15. essageFile att Attachments lt s subject gt lt bill billing code gt lt exp expiration days gt lt i gt lt epm gt nv lt nt gt lt lang f e gt lt ccrecipient address gt lt bcc bccrecipient address pay 2 S A 100 gt sec Basic ABP Package password Example For windows perl postecssend pl a vtpusername vtpuserpwd01 to test123 9 company com s Test package for Volume Transaction project m testmessage txt att testattachement sec basic p rec epm exp 10 output log e exception log For Solaris postecssend a vtpusername vipuserpwd01 to test123 company com s Test package for Volume Transaction project m testmessage txt att testattachement sec basic p rec epm exp 10 I output log e exception log Continued on next page Using the PosteCSReceive 4 1 Using PosteCSSend Continued Syntax for Refer to Data Element Table below Sending Multiple Example Input file 3 packages Packages to test123 company com s First Test package for Volume Transaction Application project m testmessage txt att testattachement sec basic p rec epm 10 to testi 239 company com testi2 company com s Second Test package for IPC Volume Transaction Project m testmessage txt att testattachement sec unique p L rec epm exp 30 to test123 company com s Third Test package for IPC Volume Transaction Project m testmessage txt att testattachement sec No p H rec epm exp 5
16. here is no exception in the exception log file 07 30 03 16 50 03 GMT PosteCS Another subject test yourcompany com Package not sent In this example there will be an exception in the exception log file stating the reason and error code Continued on next page Log Files Continued PosteCSReceive File Name and Location File Format Log Files Log Files The name and location of the log is the same as what is specified by the user If the user does not specify the name and location the name will be Receive lt date time gt log under the current working directory Time is user s machine time Package ID Send date and time in GMT Receive date and time in GMT Subject of the package sender s account name Name of the attachment or message file with package ID appended Status Field AJ Bescipion Package ID The Package ID The date amp time the package was sent Time in GMT Date amp Time Received The date amp time the package was received Time in GMT Subject The subject line text of the package The e mail address of the sender Name of the The attachment s file name or the message text file attachment or message name The files will be appended with package ID as file example below 527326 attachment file with file extension Message text file 527326 Status Status of the download Success or Failure For further detail refer to Chapte
17. ilure Send date amp time The date and time of the attempt to send the package Time in GMT Subject The subject text line of the package Sender Email The e mail addr ess of the sender Recipient Email The e mail address of the recipient If there is multiple recipients failure the exception will show in separate line Error code Reason of failure The description of the error Exception Files Users may specify the exception file path and name at the command line using key Sample 07 18 03 14 15 36 GMT PosteCS The Subject you yourcompany com el mycompany com Error 1008 No Attachment s Message File Continued on next page Exit Codes Exception File Continued PosteCSReceive File Name and The name and location of the log is the same as what is specified by the user If the Location user does not specify the name and location the name will be exception lt date time gt log and under current working directory File Format For non query failure exception Package ID Send date and time in GMT Subject of the package sender s account name Error code Reason of failure For query failure exception Query failed Field J Package ID The Package ID Receive date and time The date and time of the attempt to receive the package Time in GMT Exception Files Users may specify the exception file path and name at the command line using key Sample 5
18. irectory Date and time is the current date and time of the user s machine Format of log details are as follow Package ID Send date and time in GMT subject of the package sender s account name recipient s email Package status Current status date and time in GMT Billing code Note The status of each package but not each attachment is written to the tracking log Filename Exception All exceptions are written to the exception log file By default and path date it will generate an exception log file named exception date time gt log time gt log in the current working directory Date and time is the current date and time of the user s machine Format of log details are as follow Package ID send date and time subject sender s account name recipient s email address Error code Reason for failure Hep hep _ Completed command syntax Exception log file Using theGetMailListNames 6 2 Chapter 7 GetBillCodeNames Overview GetBillCodeNames is a new utility to query and list existing billing codes of an account Syntax for For Windows using this perl GetBillCodeNames pl a account name password utility For Solaris usage refer to Chapter 4 for detail Using the GetMailListNames 7 3 Chapter 8 GetMailListNames Overview GetMailListNames is a new utility to query and list existing Mail lists of an account Syntax for For Windows using this perl GetMaiListNames pl a account name
19. is provided by three separate executables 1 The Volume Transaction Sending Application PosteCSSend provides the ability to automatically create and send packages while preserving the core functionality of PosteCS This executable can either accept packages data from the command line or an input file The application reads an input file and will create the package s connect to PosteCS Server and send multiple or single package s For each package it will generate an entry ina log file showing either success or failure when creating the package s Any failure will also be log in an exception file 2 The Volume Transaction Tracking Application PosteCSTrack provides the ability to automate the creation of tracking data on packages sent by an account It will accept selection criteria and generates tracking information for all packages meeting the criteria The tracking information will be written to a text file 3 The Volume Transaction Receiving Application PosteCSReceive provides the ability to automatically download attachments and or text message of a package received in a PosteCS account There are specific criteria that must be entered when downloading the attachments and or messages PosteCS Volume Transaction Processing Overview 1 1 This page intentionally left blank PosteCS Volume Transaction Processing Overview 1 2 Chapter 2 Installation System Specifications The following is required to install and run the Volu
20. le or batch files do not run and the executable creates an exception file you will need to create a new batch file for all of the records that failed and then run the new file Exit Codes PosteCSSend Exit Code o0 Success or help key is specified Error creating session connection to server or database 2 Validation of account Validation of outputlogfiles 7 5_ Validation of exception logfiles 7 PosteCSTrack Exit Code O0 1 Success or help key is specified 1 5 Invalid vtp properties or HOME environment variable in PosteCSTrack file Argument incomplete or incorrect Refer to this user guide for detail Argument incomplete or incorrect please refer to the user guide for detail Invalid URL specified in the vtp properties file Invalid URL specified in vtp properties file 6 SoAPcalhasgenatdafautoremo PosteCSReceive o Suocessorhelpkeyisspedled 1 Invalid vip properties fle or HOME environment variable in PosteCSRecelve 2 argument incomplete or incorrect please refer to the user guide tor detal S mwaldURLspedfiedinvipproperiesfle S Problem connecting to PosteCS sever O e SOAPcalhasgeneriedafautoremo 8 f Errorcreating output files including log and exception files CS Exit Codes Technical support This page int
21. located under lt VTP_Install gt bin folder by updating HOME parameter with the proper install folder path 1 Continued on next page VTP Properties settings Installation Continued Solaris installation The Solaris installation is command line driven Before executing the VTP client software follow the installation steps Create the Unix account user that will own the installation Go to the directory which you want to install VTP Check and update vtp properties file This file is located at lt VTP_Install gt conf folder and is used to define properties settings Note Update proper paths for logs and target directories and any other parameters as necessary 4 Do the following command tar zxvf VTP3Solaris tar gz Installation 2 2 Chapter 3 VTP Properties Settings Overview Vtp properties file is located in the conf folder and should have read permissions Users are recommended to check and define necessary settings in this file before running the application Properties configurations The followings properties can be set using this file Property Description Usage Default Values ServerName Name of the PosteCS server ServerPort Port that will be used to communicate to 5680 PosteCS server SecureConnection Secure connection 0 http 2 https ProxyServerName Proxy server name ProxyServerPort Proxy server port ProxyServerUserN Proxy user name ame ProxyServerUserP Proxy u
22. log t ipc_tracking log For windows execute via perl script For Solaris execute shell script Refer to Chapter 4 for detail Step Access a command line prompt Using the above syntax as a model enter the desired keys as shown in the Data Element Table below Data Element Table Listed below are the keys switches you can pass to PosteCSTrack Data Key Values Default Description Element Value Compulsory keys Account name Account No Account name and password of a valid PosteCS account and password Name and password Optional keys mm o o 57 Format must be MM DD YY or MM DD CCYY Format must be MM DD YY or MM DD CCYY A string or sub string that must match the subject of the package Continued on next page Using the GetMailListNames 6 1 Using PosteCSTrack Continued Data Values Default Description Element Value Recipient Recipients All packages sent to a given recipient will be tracked Recipient email will be an email address only It cannot be a mail list address string Package ID Package ID No Package with a given package id will be tracked This key is given priority in search when in combination usage with other keys code Tracking log Filename Tracking Output will be stored in the tracking log file By default it will file and path lt date generate a log file named tracking lt date time gt log in the time gt log current working d
23. me Transaction Processing software Minimum Memory RAM 128 MB Minimum Disk Space 1 GB Unzip utility Windows Winzip Tar A valid PosteCS account is required to run the applications If you don t have an account yet you can auto enroll yourself through https cpc postecs com enroll or call PosteCS Help Desk at 1 866 511 0546 Windows Installation Download the application from the Web or receive it via PosteCS Before executing the VTP client software follow the installation steps Sep h O Login as administrator Copy the installation file to a temporary directory in your local drive Unzip the VTP3Windows zip in the folder where you want to install VTP The following folders will be created lib contains all jar files conf vtp properties configuration file conf cdm cdm conf configuration file doc readme and license text bin perl scripts for execution of PostecsTrack PostecsSend PostecsReceive and perl exe along with dll s required to execute perl exe jvm Java virtual machine logs default log file location tdir default location for PostecsReceive to download files samples sample files for reference Check and update vtp properties file This file is located at lt VTP_Install gt conf folder and is used to define properties settings Note Update proper paths for logs and target directories and any other parameters as necessary Configure all pl files
24. n Fil s rore erc eere 10 1 File Name and LOCatio mics ecce ioci 10 2 File Forirat olent E 10 2 3 giongdirla P 10 2 File Name and LocatlOn 1 1 ecce erre avedscccecdeaceversecee eeescnassicectcsueeersne 10 3 Table of Contents iii Exception Files rere eine iie Ee Ezeze tete cetur re Dunes ec coo s eseeeceucurerereccce 10 3 Chapter 11 Error Codes and Exit Codes esee 11 5 Error CodeS c deiei aiaa 11 5 Correcting ducecusscecnaesuadssecececaus 11 6 EXit Codes TP 11 7 Chapter 12 Tro bleshooltihg 1 1L ecce ecce ie eSenenevendeccdecadiesveeeduananveneeeneantdi 12 1 Problems amp reci cieedel Dre 12 1 Chapter T3 Ein ncupi reet 13 2 Chapter 14 Technical Suppott eer cce ieee eee rere oc ete Ee cu rouen re penne una 14 1 PosteCS SUppoLt o duneni ae e 14 1 cnt LEM ES EP Tate TON ne Seen Seer a oa 1 1 Table of Contents This page intentionally left blank Table of Contents Chapter 1 PosteCS
25. og file 4 5 Message 4 2 Multiple package Input file 4 4 Package Expiration 4 4 Priority 43 Recipients 4 2 Security 43 Subject line 4 3 PosteCSSend Data Element Table 4 2 PosteCSSend Exception File Format 10 1 Index Index PosteCSSend Exception File Name and Location 10 1 PosteCSSend Log File Format 9 1 9 2 PosteCSSend Log File Name and Location 9 1 PostecsSend Log Files 91 92 PosteCSSend Syntax for Multiple packages 42 for sending a single package 4 1 PostecSTrack Exception log 6 2 PosteCSTrack Account name and password 6 1 Begin Date 61 End Date 6 1 Subject 6 1 Tracking File 6 2 PosteCSTrack Data Element Table 6 1 PosteCSTrack Exception File Format 10 3 PosteCSTrack Exception File Name and Location 10 3 PosteCSTrack File Format 9 3 PosteCSTrack File Name and Location 9 3 PostecsTrack Log Files 9 3 Properties configurations 3 1 Solaris Installation 2 2 subject 10 1 10 2 10 3 Syntax for Receiving Packages and File Attachments 5 1 Syntax for Tracking Packages 6 1 System Specifications 2 1 Technical Support 14 1 Troubleshooting 12 1 Tumbleweed Support 14 1 Unix Account 2 2 Using PosteCSReceive 5 1 Using PosteCSSend 4 1 Using PosteCSTrack 6 1 VTP Properties Overview 3 1 Windows Installation 2 1 Winzip 2 1 Index This page intentionally left blank I 2
26. r 9 Exit Code session Users may specify the log file name by key 1 Sample 508407 07 16 03 10 48 24 GMT 07 16 03 11 00 05 GMT PosteCS Instructions el mycompany com message 508407 txt Success In this example the account is receiving a PosteCS consists only message text and no attachment file 058136 07 16 03 10 49 06 GMT 07 16 03 10 52 08 GMT PosteCS Test el mycompany com message 508136 txt Success 058136 07 16 03 10 49 06 GMT 07 16 03 10 53 02 GMT PosteCS Test el mycompany com 508136 Demo txt Success In this example the account is receiving a PosteCS package consists of message text and 1 attachment file Note both files are received and report in separate lines in the receive log Continued on next page 5 2 Log File Continued PosteCSTrack File Name and The name and location of the log is the same as what is specified by the user If the Location user does not specify the name and location the name will be tracking lt date time gt log under the current working directory File Format Package ID Sent date and time in GMT subject of the package sender s account name recipient s email status current status date and time in GMT Billing code Feld Recipient s email The e mail address of the recipient If the package was sent to multiple recipients the status of individual email will be shown on separate lines in the log Notifi ed Packag
27. recipient I Nil False When this key is used message text will be included in the option notification email Include message Continue on the next page Using the PosteCSReceive 4 3 Using PosteCSSend Continued Data Key Values Default Value Description Element Prepaid replies Option Sender s notification options Notify me when viewed Sender s notification options Notify me if trouble Schedule delivery Package Expiration Billing code Multiple package option Input file Output log file Number of replies S A Kb granted Date and time of days The billing code File name with txt extension and path File name and path Using the PosteCSReceive Immediate 10 days this varies depends on the setting in specific accounts during creation Output lt date time gt log This key can have minimum of 1 and maximum up to 3 values The first value is the number replies granted The second value is to dictate the reply to be sent to sender only or all recipients s reply to sender only a reply to all recipients The third value is the package size in kb to be allowed to reply The values need to be separated by white space For example 3 s 100 When this key is used the sender will be notified when the package is viewed by the recipient When this key is used sender will be notified if trouble prevents delivery of package When this key is used a date and
28. ser password assword LogFilePath Path of output log files VTP_HOME logs ExceptionFilePath Path of exception files VTP HOME logs Locale Locale value English French English TargetDirectory Target Directory of PostecsReceive VTP_HOME tdir output files SilentMode If set to 0 No messages will be 1 displayed Acceptable values are 0 and 1 CDM configurations The followings properties can be set using cdm conf which located at VTP_HOME conf cdm Secure connection 0 hip 2 ips SSLKEV STORE Kewtrebeson _ SSL STORE PASSWORD Keysorepasemm J PPROXY_SERVER Pewsevermme o y FPROXY PORT Dra a le T VTP Properties settings Overview Assumptions Syntax for Sending a Single Package Chapter 4 Using PosteCSSend PostecsSend is used to create and send packages to the PosteCS server It can be used to send a single package or multiple packages To send a single package all required parameters are passed directly to the executable To send multiple packages an input file containing specifications for each package will have to be created and passed to the executable 1 This document assumes all attachments exist as files accessible to PosteCSSend 2 Text for the message if any has been written to an ASCII file that is accessible to PosteCSSend postecssend a accountname password to recipient address m m
29. the account you have to contact the help desk Limitations 12 1 Chapter 13 Limitations The sender account should be created before using the Volume Transaction Application The Volume Transaction Application does not create accounts 2 Member accounts will not be able to create billing codes PosteCSReceive will not download packages sent as notifications confirmation or validation packages Technical support 6 2 This page intentionally left blank Limitations 13 3 Chapter 14 Technical Support PosteCS For support of PosteCS contact PosteCS technical support Support Calling from Canada and US 1 866 511 0546 or e mail postecs canadapost ca Technical Support 14 1 Technical support This page intentionally left blank 6 2 Correcting an Error 11 6 Destination folder 2 2 Disk Space 2 1 Error Code 11 5 Error Codes and Exit Codes 11 5 Exception File 10 1 GetBillCodeNames 7 3 GetMailListNames 8 4 Installation 2 1 Installation Settings Unix Solaris 2 2 License 2 2 Limitations 13 2 Log Files 9 1 Memory RAM 2 1 PosteCS account 4 2 PosteCS Volume Transaction Processing Overview 2 1 PosteCSReceive Data Element Table 5 2 PosteCSReceive Exception File Format 10 2 PosteCSReceive Log File Name and Location 9 2 PosteCSRecieve Exception File Name and Location 10 2 PostecSSend Output log File 4 4 PosteCSSend Account name 4 2 Attached File s 4 3 Electronic Postmark 4 3 Exception l
30. the end date of which packages should be received Date is in mm dd yyyy format If this key is not used current date and time will be the end date Time and be specified using 24 hour clock format If time is not specified time is default to 23 59 The end date must be prior to or equal the current system date and must also be equals to or after the begin date Package ID Package ID No Receive download the package with the given package ID This key will be given priority in searching information when in a combination usage with other keys a o s include header information Target Directory tdir Path Current working The directory where the files will be saved in the directory local drive If the Directory does not exist an error will be thrown All messages and attachments will be appended with package ID in the format as following example 527326 attachment file with file extension Message text file 527326 Continued on next page Using the PosteCSReceive 5 2 Using PosteCSReceive Continued Data Element Default Value Receive log file Filename Receive lt date and path time gt log Exception log file Filename Exception lt date and path time gt log Output will be stored in the Receive log file By default it will generate a log file named receive lt date time gt log in the current working directory Date and time is the current date and time of the user s machine Format of log details are
31. time will require as the value in the following format 05 25 2004 04 30 Time should be in 24 hour clock Date and time is according to sender s time zone The number of days the package will be accessible to the recipients After that the package will be expired This value is a billing code to be appending with the sending of package If the billing code does not exist will then be created This is used for sending multiple packages The file should be a text file containing package information The file will be read and packages will be sent accordingly The status of all transactions successful or failure are written to the log file By default it will generate a log file named Output lt date time gt log in the current working directory Date and time is the current date and time of the user s machine Format of log details are as follow Package ID Send date and time in GMT Subject Sender s account name recipient s email package status Continue on next page 4 4 Using PosteCSSend Continued Data Values Default Value Description Element Exception log File name Exception All exceptions are written to the exception log file By default it file and path date time gt log will generate an exception log file named exception lt date time gt log in the current working directory Date and time is the current date and time of the users machine Format of log details are as follow Send time in GMT
Download Pdf Manuals
Related Search