User Guide v0.1
Contents
1. 20 The Tweet COMMANA ce cccccesccecsseceeseeceeeceteneeesaecsaaeceaaeesaeeeeaaeceeaaessaaeeeaaececaceseeaaessaeeeeaaeceeaaensenees 20 The Tweet 20 M ssage bee a r a aa arae EE RERS 21 Getting Notifications On Your Smartphone 27 CUSTOM Twitter Applications 27 Registering an application on 27 Linking your application to SongthruSh ccccccccccecsssesssecececeseesesneseceeeceseesesaeseeeescssseseaaeeeeeeesessesenaeeas 35 Editing Application Settings ic 2 2 2ccncedess Bde headsets re es nE aea Ea aR aK eE a aaar aeaea 36 Editing credentials stored against an application ccsccccccccssssssssecececscessessaeeeeeesseesesneaeeeeeesseesees 37 license 8 41 Sonethrash 41 Third Party LiCENSE S isuse 41 41 Installation The installation process consists of two main steps transferring the downloaded save file to your IBM i and th2. Y Test App KFA Twitter De 7 8 https dev twitter com apps 5360955 settings Developers API Health Blog Discussions Documentation Search Q Test App KFA Details Settings OAuth tool Anywhere domains Reset keys Delete Application Details Name Test App KFA Your application name This is used to attribute the source of a tweet and in user facing authorization screens 32 characters max Description Test Appplication to demonstrate Your application description which will be shown in user facing authorization screens Between 10 and 200 characters max Website http www kfa co uk Your application s publicly accessible home page where users can go to download make use of or find out more information about your application This fully qualified URL is used in the source attribution for tweets created by your application and will be shown in user facing authorization screens if you don t have a URL yet just put a placeholder here but remember to change it later Application Icon Change icon No file chosen Maximum size of 700k JPG GIF PNG Application Type Access 0 Read only Read and Write Read Write and Access direct messages What type of access does your application need Note Anywhere applications require read amp write access Find out more about our Application Permission Model Test App KFA Twitter De x e 6 8 https dev twitt
3. MAI 01 001 4 02 Session successfully started Press F6 to create a new filter File Edit View ezerre Actions Window Help S El l lm BB m l 8 eles el l Host 168 1 Port Workstation ID Disconnect Create Filter Name Description Tweet matching messages from account F4 KFA IBM i Type comparisons press Enter Specify OR to start each new group 5 CT AND OR Field Test Value Field amp MSGID message ID of the message amp MSGTXT first level message text amp MSGTYPE type of the message INFO DIAG etc amp SEVERITY severity of the message F3 Exit g 02 Session successfully started Name Enter a name for the filter Description Enter some descriptive text 037008 Tweet matching messages from account Select the twitter account to use to send messages The F4 key will allow the selection from all accounts on the system If all messages received on the queue are to be tweeted press ENTER at this point If the messages are to be restricted the criteria messages need to meet in order to be tweeted must be specified Field The field to make the comparison against This can be one of e amp MSGID the message ID of the message e amp MSGTXT the first level message text e amp MSGTYPE the type of the message e amp SEVERITY the severity of the message Test The test to perform against
4. a terminal window From the main Songthrush menu select the Work with applications option or enter the WRKAPP command from the command line You will see a list of applications defined in the system In a new installation only KFA Songthrush will be in this list TO a Eleve File Edit View Communication Actions Window Help aj ea elm em voltal eles ele Host 1921681 Port Workstation ID Disconnect Work with Applications Type options press Enter 2 Edit 4 Delete C Work With Application Credentials Opt Application Name Bottom F3 Exit F6 Create MAI c 07 003 g 902 Session s ssfully started Press F6 to create your new application in Songthrush Oi Session C ALCEDO L 2am Engs File Edit View Communication Actions Window Help pel elm Em wl volt eles ele Host 168 1 Port Workstation ID Disconnect Work with Applications Type options press Enter 2 Edit 4 Delete C Work With Application Credentials Create Application A Test KFA Application Consumer Key EeCxTj0j6Axse3fubDh1Q Consumer Secret uJZNIFDMn1YIn20oakU23qJyIlAxnFiSAwagK4Wjlduk F12 Cancel Bottom F6 Create 087 040 4 902 Session successfully started Enter the name of the application and the Consumer Key and Consumer Secret from the Twitter OAuth settings section Press ENTER and your application will be created Editing Application Settings Your app
5. account If you are not already logged in you will need to complete the username password fields with the credentials of the account that you are attempting to authorise Click Authorize app and you will be given a serial number e https api twitter com oauth authorize Dr 0 Y Twitter Authorise an appli You ve granted access to Songthrush Next return to Songthrush and enter this PIN to complete the authorisation process 9471160 Go to Twitter Go to the Songthrush homepage You can revoke access to any application at any time from the Applications tab of your Settings page By authorising an application you continue to operate under Twitter s Terms of Service In particular some usage information will be shared back with Twitter For more see our Privacy Policy Type that number into the screen and press ENTER The process will now be completed and the application will be authorised to use Twitter on your account s behalf Sending Tweets You can send a simple status update message Tweet in several ways From the Songthrush menu screen With a command Calling a program Tweeting from the menu On the main Songthrush menu take the Send a tweet option This presents you with a simple screen to use to send your message with the default user application selected for you Fill in the text and press ENTER Your tweet will be sent The Tweet Command The TWEET command in the app
6. from the Applications tab of your Settings page By authorising an application you continue to operate under Twitter s Terms of Service In particular some usage information will be shared back with Twitter For more see our Privacy Policy Enter this PIN number back in the terminal window i Session C ALCEDO 24 e eo eles s File Edit View Communication Actions Window Help S El l elm BIm wl volt eles el l Host 168 1 Port Workstation ID Disconnect Request Application Authorization Log into the twitter website http www twitter com as kfaiseries Open the following URL in your browser and grant access to this account http api twitter com oauth authorize oauth_token gMZaGDSV4NDnFOZNOmJmW9tOLsiGC mj LLXoBKbHARH8 Enter the PIN number that you are given here 3780459 03 053 g 902 Session successfully started The process will now be completed You will now be able to send Tweets directly from the IBM i using this Twitter account Full Setup From the main Songthrush menu select the Work With Accounts option or enter WRKACC from the command line You will be presented with the Work With Accounts screen 2 x File Edit View Communication Actions Window Help e ehl elm BIm sal 5 Sct el l Work with Accounts options press Enter 2 Edit 4 Delete C Work With Account Credentials Opt Account Name Default Appli
7. s happening now We want to empower our ecosystem partners to build valuable businesses around the information flowing through Twitter At the same time we aim to strike a balance between encouraging interesting development and protecting both Twitter s and users rights So we ve come up with a set of Developer Rules of the Road Rules that describes the policies and philosophy around what type of innovation is permitted with the content and information shared on Twitter The Rules will evolve along with our ecosystem as developers continue to innovate and find new creative ways to use the Twitter API so please check back periodically to see the current version Don t do anything prohibited by the Rules and talk to us if you think we should make a change or give you an exception If your application will eventually need more than 1 million user tokens or you expect your embedded Tweets and embedded timelines to exceed 10 million daily impressions you will need to talk to us directly about your access to the Twitter API as you may be subject to additional terms Furthermore applications that attempt to replicate Twitter s core user experience as described in Section 1 5 below will need our permission to have Yes I agree By clicking the Agree button you acknowledge that you have read and understand this agreement and agree to be bound by its terms and conditions CAPTCHA This question is for testing whether you
8. Exit F6 Request Credentials MAI 07 003 g 902 Session successfully started You can edit or delete accounts credentials on this screen using option 2 Edit or 4 Delete Use F6 to request credentials for a different account The software will ask you first to select the account from those defined on the system i Session C ALCEDO L 2am eae File Edit View Communication Actions Window Help 7 I B Ela elm aal valt eres elel Host 1 Port Workstation ID Disconnect Work with Application Credentials Test KFA Application Select Account Type options press Enter 1 Select Opt Account Bottom F3 Exit F6 Request Credentials MAI 10 009 g 902 Session successfully started Once an account is selected you will be issued with a screen prompting you to visit a URL on the twitter website to proceed with authorization Instructions from this point are identical to those following this step detailed in the Full Setup and Quick Setup sections above Oi Session C ALCEDO L 2am o File Edit View Communication Actions Window Help aj S AS Ble ta a el l Host 1921681 Port Workstation ID Disconnect Baj e Reguest Application Authorization Log into the twitter website http www twitter com as kfaiseries Open the following URL in your browser and grant access to this account http api twitter com oauth
9. Help aj ea elm Blew saj 35 alal ele Host 1921681 Port Workstation ID Disconnect Work with Account Credentials kfaiseries Type options press Enter 2 Edit 4 Delete Opt Application Bottom F3 Exit F6 Request Credentials MAI 07 003 g 902 Session successfully started In a new installation the list will be empty Press Fe Request Credentials to begin the process to grant Songthrush authority to your new account The list of applications currently defined on the system will be displayed l Session C ALCEDO 24 B S an File Edit View Communication Actions Window Help e a AS Blom tolta ala elol Host 1 Port Workstation ID Disconnect Work with Account Credentials kfaiseries Select Application Type options press Enter 1 Select Opt Application Name Bottom F3 Exit F3 Exit F6 Request Credentials MAI 107009 g 1902 Session successfully started Select the KFA Songthrush application by typing 1 in the Opt column next to it and press ENTER You will be presented with the following screen 5 Kingfisher ws File Edit View Communication Actions Window Help S pel elm B voltal eles el l Reguest Application Authorization http api twitter com oauth authorize oauth_token dwnJw9ybCZ2CBXr9qCqBBcGutNxEIlo xm2G4anF9L00 The link that is displayed is a web page that you need to navigate to ret
10. INESS INTERRUPTION WEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHER IN CONTRACT STRICT IABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY UT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF UCH DAMAGE
11. SH DEV SAVF SAVF QGPL SONGSAVF If you want to restore the library to a different name e g because you already have an old instance of the software or the library name has been used for another purpose specify the RSTLIB parameter on the command above RSTLIB SAVLIB SONGTHRUSH DEV SAVF SAVF QGPL SONGSAVF RSTLIB SONGNEW You will also need to run the command CHGINSTLIB in the new library which will change the installation library in the application s settings CHGINSTLIB LIB lt INSTALLLIB gt Configuring your server for SSL All of the interaction between your server and Twitter takes place over a secure https connection so you will need to set your server up to support SSL if it does not already do so If you have already configured a SYSTEM certificate store in the Digital Certificate Manager you can skip this section If you don t know if your server has this configured check for the files default kdb and default rdb in the IFS folder QIBM USERDATA ICSS CERT SERVER If they exist your SYSTEM certificate store has been set up 1 Verify pre requisite software is installed a Digital Certificate Manager Option 34 of the operating system 57xx SS1 b TCP IP Connectivity Utilities 57xx TC1 c IBM HTTP server for iSeries 57xx DG1 d IBM Crypto Access Provider 57xx NAE e IBM Develope
12. THER DEALINGS NTHE SOFTWARE T HTTPAPI This software includes the HTTPAPI library written by Scott Klement www scottklement com httpapi The license terms for HTTPAPI are as follows Copyright c 2001 2011 Scott C Klement All rights reserved Redistribution and use in source and binary forms with or without modification are permitted provided that the following conditions are met 1 Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer 2 Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution HIS SOFTWARE IS PROVIDED BY THE NY EXPRESS OR IMPLIED WARRANTIE MPLIED WARRANTIES OF MERCHANTAB RE DISCLAIMED IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE OR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL A R O T AUTHOR AND CONTRIBUTORS AS IS AND A 1 A F DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS O H L O S S INCLUDING BUT NOT LIMITED TO THE ILITY AND FITNESS FOR A PARTICULAR PURPOSE SERVICES LOSS OF USE DATA OR PROFITS OR BUS
13. User Guide v0 1 RON kfa m Table Of Contents 35 6 0 5 2 8 Configuring your Server fOr SSL cccccsssscecececessesssaececeeeseeseaeaeceeeeescusnsaeeeeeeeceseesaeaeceeeesseesesauaeeeeeesseeeegs 5 siecia eaea a a E E aaae E EEE 6 Configuring your internet CONNECTION cccccccesssssssececececeeseaeseceeeceseescaececeeecessesauaeseseeseessesauaeeeseesseesags 7 Registering a Twitter ACCOUNT Wieceteesteddeweuemeuscerutecams E ERES 8 Configuring your account for Use With Songthrush cceceesssseceeecessesesececeeecesseseeaeeeceesessseseaeseeeeeens 10 Quick Setup artes sic a hoes ew eases E ee 10 AESA o E E 13 Authorising Songthrush to your Twitter account cccccccecessssssceeeeecesesseaeseceeecessessuaeaeeeeseeesesnnaees 15 Sending acces E EE daaa E Ea ia 20 Tweeting 6 16
14. are a human visitor and to prevent automated spam submissions Type the text Privacy amp Terms Y Follow twitterapi APITerms APIStatus Blog Discussions Documentation A Drupal community site supported by Acquia You will proceed to the application page Y Test App KFA Twitter De 7 C B https dev twitter com apps 5360955 show y Developers API Health Blog Discussions Documentation Search Home My applications Test App KFA Details Settings OAuth tool Anywhere domains Reset keys Delete Test Appplication to demonstrate http www kfa co uk r Organization Information about the organization or company associated with your application This information is optional Organization None Organization website None OAuth settings Your application s OAuth settings Keep the Consumer secret a secret This key should never be human readable in your application Access level Read only About the application permission model Consumer key EeCxTj036Axse3fubDhiQ Consumer secret udZNIFDMn1 In2oakU23qdyIAxnFiSAwagK4Wjlduk Request token URL https api twitter com oauth request_token Authorize URL https api twitter com oauth authorize Access token URL https api twitter com oauth access_token Callback URL None Sign in with Twitter No Your access token Click the Settings tab Select Read Write and Access direct messages under Application Type
15. authorize oauth_token U7krKvYCBk5S t 7sWdJgwrMF8Xq fMO n314Lsmgg6S43E Enter the PIN number that you are given here F3 Exit 117051 4 902 Session successfully started License Information Songthrush License Third Party Licenses CJSON This software includes an IBM port of the CJSON library This is distributed under the MIT license Permission is hereby granted free of charge to any person obtaining a copyof this software and associated documentation files the Software to deal in the Software without restriction including without limitation the rights to use copy modify merge publish distribute sublicense and or sell copies of the Software and to permit persons to whom the Software is furnished to do so subject to the following conditions The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT IN NO EVENT SHALL TH AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM DAMAGES OR OTHER L F I IABILITY WHETHER IN AN ACTION OF CONTRACT TORT OR OTHERWISE ARISING ROM OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR O
16. cation Default Bottom F3 Exit F6 Create MAI 07 003 There will be no accounts on this screen when the software is first installed Press F6 Create to create a record for your account The following window will be displayed cal File Edit View Communication Actions Window Help S El l elm Sle aal 8 ele S elel Work with Accounts Type options press Enter 2 Edit 4 Delete C Work With Account Credentials Opt Accou Create Account lication Default F4 to select Fi2 Cancel F3 Exit F6 Create MAI 087 030 Fill in the fields as follows Name The Twitter username Account Name A descriptive long name Default Enter Y to set this as the default account for the system Default App The application to use to access Twitter see Applications for more details Press F4 to select the application from a list In a new installation there will be one pre installed entry in this list KFA Songthrush In order for Songthrush to post messages to the Twitter service on your account s behalf you need to grant it authority to do so To do this find the account on the Work With Accounts screen and enter the Work With Account Credentials option C in the Opt field on the row next to the account that you wish to authorize This screen gives you a list of applications to which this account has granted authority Session C ALCEDO 24x en File Edit View Communication Actions Window
17. e message queue objects Bf Son a 51D I File Edit View Communication Actions Window Help aj ee elm 8 8 aal voltal SP elel Host 1 Port Workstation ID Disconnect Work with Monitors Type options press Enter 2 Edit 4 Delete 5 Display F Work With Filters Star Opt Name Create Message Queue Monitor Enter Message Queue Details F12 Cancel F3 Exit F5 Refresh F6 Create F8 WRKJOBSCDE F10 WRKACTJOB MAI 09 032 g 902 Session successfully started IT File Edit View Communication Actions Window Help aj ee elm Elm aal voltal etes 9 Host 1 Port Workstation ID Disconnect Work with Monitors Type options press Enter 2 Edit 4 Delete 5 Display F Work With Filters S Start E End J WRKJOB Opt Name Type Description Bottom F3 Exit F5 Refresh F6 Create F8 WRKJOBSCDE F10 WRKACTJOB MAI A 07 003 g 902 Session successfully started The monitor will now appear on the Work with Monitors screen Before any messages will be tweeted at least one filter needs to be set up for the new monitor Take option F against the monitor to Work With Filters l Session A ALCEDO 24 x 80 File Edit View Communication Actions Window Help al al ele Elm el l Host 1 Port Workstation ID Disconnect Work with Filters Type options press Enter 2 Edit 4 Delete Opt Name Description F3 Exit F6 Create
18. en restoring its contents onto your system Transfer via FTP Download the software to your local PC Upload the software via FTP Create a save file on your IBM i e g CRTSAVF QGPL SONGSAVF From a command prompt on your PC device open an FTP session to your IBM I e g on Windows Linux ftp XXX XXX XXX XXX where is the IP address of your system Logon to your system Change library to QGPL if it is not already your current library o cd QGPL Change your local working directory to the folder to which you downloaded the software using the Icd command lcd C Temp Change your FTP session to binary mode o BIN Transfer the save file to your IBM i PUT songthrushV7RIM0O savf SONGSAVF Transfer via IFS If the IFS of your IBM i has folders that have been shared you can download the software directly to one of these folders or if preferred first download to your local PC and then copy it across to one of these folders Once the software is in the IFS you can copy the save file into a library with the CPYFRMSTMF command e g CPYFRMSTMF FROMSTMF songbuilds songthrushV7R1M0 savf TOMBR QSYS LIB QGPL LIB SONG FILE Restore the SONGTHRUSH library from the save file 1 Once you have the software in a save file in a library on the IBM i you then need to restore the application software from the save file onto your filesystem RSTLIB SAVLIB SONGTHRU
19. er com apps 5360955 settings Developers API Health Blog Discussions Documentation Test App KFA Details Settings OAuth tool Anywhere domains Reset keys Delete Application Details Name Test App KFA Your application name This is used to attribute the source of a tweet and in user facing authorization screens 32 characters max Description Test Appplication to demonstrate Your application description which will be shown in user facing authorization screens Between 10 and 200 characters max Website http www kfa co uk Your application s publicly accessible home page where users can go to download make use of or find out more information about your application This fully qualified URL is used in the source attribution for tweets created by your application and will be shown in user facing authorization screens if you don t have a URL yet just put a placeholder here but remember to change it later Application Icon Change icon Choose File No file chosen Maximum size of 700k JPG GIF PNG Application Type Access Read only Read and Write Read Write and Access direct messages What type of access does your application need Note Anywhere applications require read amp write access Find out more about our Application Permission Model ra Click Update this Twitter application s settings and return to the Details tab Ensure that Access l
20. evel contains Read write and direct messages Scroll down to the OAuth settings section These details will be required in the next step n wildcare Y Test App KFA Twitter De x gt C 8 https devwitter com apps 5360955 show W Developers APIHealth Blog Discussions Documentation Search Q a Organization Information about the organization or company associated with your application This information is optional Organization None Organization website None OAuth settings Your application s OAuth settings Keep the Consumer secret a secret This key should never be human readable in your application Access level Read write and direct messages About the application permission model Consumer key EeCxTjOj6Axse3fubDh1Q Consumer secret uUJZNIFDMn1YIn2oakU23qJyIAxnFiSAwagK4Wjlduk z Request token URL https api twitter com oauth reguest token Authorize URL https api twitter com oauth authorize Access token URL https api twitter com oauth access token Callback URL None Sign in with Twitter No Your access token It looks like you haven t authorized this application for your own Twitter account yet For your convenience we give you the opportunity to create your OAuth access token here so you can start signing your requests right away The access token generated will reflect your application s current permission level nlir n tn Canothri h 5 I AVPPVIICAUU DULHS UL UST Return to
21. ges meeting different sets of criteria Creating a Message Queue Monitor From the main Songthrush menu take Work with monitors BA Session A ALCEDO 24 x 20 i ale File Edit View Communication Actions Window Help ee AS Bim m l tolta etes el l Host 192 168 1 Port Workstation ID Disconnect Work with Monitors Type options press Enter 2 Edit 4 Delete 5 Display F Work With Filters S Start E End J WRKJOB Opt Name Type Description Status F3 Exit F5 Refresh F6 Create F8 WRKJOBSCDE F10 WRKACTJOB MAI A 01 001 a 902 Session successfully started Press F6 to create a new monitor Bf Son a 51D I File Edit View Communication Actions Window Help aj ee elm 8 8 aal voltal SP elel Host 1 Port Workstation ID Disconnect Work with Monitors Type options press Enter 2 Edit 4 Delete 5 Display F Work With Filters S Star Opt Name Create Monitor F12 Cancel F3 Exit F5 Refresh F6 Create F8 WRKJOBSCDE F10 WRKACTJOB MAI A 08 028 4 902 Session successfully started Name Enter a name for the monitor This will be used as the job name for the monitor job Description Enter some descriptive text Type Enter MSGQ for a message queue monitor MSGQ is the only valid input in this release of Songthrush however other monitor types will be added in future releases You will now be prompted for the name and location of th
22. hat only the BASIC authentication scheme is supported Other methods of proxy authentication such as Digest or NTLM are not supported by the software Once the details are fully completed press ENTER to save the configuration Registering a Twitter Account In order to send messages via Twitter you need to set up or configure a Twitter account to send them from If you already have a Twitter account that you want to use please skip this section Open a web browser and go to https twitter com signup You will see a form like the one below subject to any future changes that Twitter make to their website 7 Twitter Create an Account Mozilla Firefox File Edit View History Bookmarks Tools Help 39 Twitter Create an Account l e ath 9 Twitter Inc US https twitter com signup P tf B Most visited Latest Headlines Lasso _ Enable Right Click _ RetailMeNot Localize This Web Development Search Prototype API Share on Facebook Flickr To Facebook _ XRAY Sitonomy Bookmarklet QY Stumble Al Tlikeit EJ 9 Share D Info wy Favorites AA Stumblers Tools e Signin twitter It s your turn Join Twitter 2011 Twitter x FoxyProxy Disabled 4 All of these details can be changed later but Twitter will use the email address that you specify to confirm your registration so that needs to be a genuine address An email address can al
23. k with accounts Work with monitors Work with applications Selection or command 22 007 a 902 Session successfully started Configuring your internet connection If your IBM i is directly connected to the internet then no configuration is necessary If your IBM i needs to use a proxy server to connect to the internet from your IBM i then details of this server will need to be configured From the main Songthrush menu take option 21 Configure internet connection or use the CFGINET command in the installation library from the command line to display the internet configuration window i Session A ALCEDO 24x 8011 a File Edit View Communication Actions Window Help aj S AS Ble a L etet el l Host 1921651 Port Workstation ID Disconnect SONGTHRUSH Songthrush Menu Configure Internet Connection Connect via a proxy server N Proxy server address Port number Authentication required Username Password Fi2 Cancel 06 041 a 1902 Session successfully started To specify connection via a proxy server enter Y in the Connect via a proxy server field Provide the proxy server s IP address and the port number that the proxy service runs on in the respective fields If the server requires authentication specify Y in the Authentication required field Enter the username and password for the proxy server in the respective fields Please note t
24. lication s Consumer Key and Consumer Secret should never need to be changed However they are secure pieces of information In the wrong hands they would enable someone to pretend to be your application If they are ever compromised you can regenerate reset your keys on the Twitter developer s website and enter your new credentials in Songthrush by taking option 2 Edit in the Work with Applications screen and changing the details therein Oi Session C ALCEDO L 2am File Edit View Communication Actions Window Help aj ee elm Elm aw eles el l Host 1921681 Port Workstation ID Disconnect Work with Applications Type options press Enter 2 Edit 4 Delete C Work With Application Credentials Edit Application lest KFA Application Consumer Key EeCxTjOj6Axse3fubDh1Q Consumer Secret uJZNIFDMn1 In20akU23qJyIAxnFiSAwagk4W j lduk Fi2 Cancel Bottom F3 Exit F6 Create 087 020 4 902 Session successfully started Edit To view the account that have granted an application authority take option C Work With ntials stor Application Credentials a Session C ALCEDO BAK Stee File Edit View Communication Actions Window Help al Ela elm aal L eles el l Host 1 Port Workstation ID Disconnect Work with Application Credentials KFA Songthrush Type options press Enter 2 Edit 4 Delete Opt Account Name Bottom F3
25. lication library allows tweets to be sent from the command line The command parameters available are as follows TWEET The text that you wish to send as a tweet ACCOUNT The name of the account that you want to use to send it from The default value of DEFAULT indicates that the system default account will be used APP The name of the application that you want to use The default value of USRDFT indicates that the account s default application will be used Mandatory The Tweet Program Behind the TWEET command is a program also named TWEET This program can be called directly from your IBM i programs to send tweets Procedure prototype D Tweet PR EXTPGM TWEET D text 140A CONST D account 15A CONST OPTIONS NOPASS D application 30A CONST OPTIONS NOPASS Parameter explanations text The text that you wish to send as a tweet account The name of the account that you want to use to send it from If you do not specify an account the system default account will be used application The name of the application that you want to use If you do not specify anything for this the account s default application will be used Mandatory Songthrush offers the facility to monitor IBM i message queues and tweet messages that arrive on them The messages to tweet can be filtered according to your chosen criteria and can different filters can be used to tweet messa
26. r Kit for Java 57xx JV1 Start the Admin instance of the IBM HTTP Server a STRTCPSVR SERVER HTTP HTTPSVR ADMIN Connect to the admin instance of the HTTP Server in a browser a http lt server gt 2001 Click Digital Certificate Manager in the menu In the navigation bar on the left click Create New Certificate Store Select SYSTEM certificate store and accept the defaults to all prompts You will need to specify a password for this certificate store so choose something memorable yet secure NB All users that will be running the Songthrush software will need to have permission to read the files that are created by these steps Please ensure that they have a minimum of RX access to all directories in the path QIBM USERDATA ICSS CERT SERVER and R access to the files QIBM USERDATA ICSS CERT SERVER DEFAULT KDB and QIBM USERDATA ICSS CERT SERVER DEFAULT RDB The Songthrush Menu Once the software is installed onto your system the main menu can be accessed via the command SONGTHRUSH in the installation library This will present you with the following Menu Session A ALCEDO 24x 80 fa File Edit View Communication Actions Window Help aj eS elm Ble a L etet el l Host 1921681 Port Workstation Disconnect SONGTHRUSH Songthrush Menu Select one of the following Tweeting Send a tweet Configuration Configure internet connection Wor
27. rieve a serial number that will allow the process to be completed If you are using an emulator that supports it double click the link to launch your web browser Otherwise open your web browser and copy and paste the URL into the address bar You will now be taken to the Twitter website and be asked to authorize the application with a screen similar to the following W Twitter Authorise an appli x ia Authorise Songthrush to use your account e gt This application will be able to Songthrush By KFA Read Tweets from your timeline akik See who you follow and follow new people Update your profile Post Tweets for you Access your direct messages KFA Songthrush IBM i Twitter client Username or email Password Remember me Forgot password Peele Cancel This application will not be able to See your Twitter password You can revoke access to any application at any time from the Applications tab of your Settings page By authorising an application you continue to operate under Twitter s Terms of Service In particular some usage information will be shared back with Twitter For more see our Privacy Policy If you are already logged in you will not see the username password prompts Please make sure that you are logged in as the account that you intend to authorise Songthrush to If you are logged in as a different account at this time Songthrush s tweets will be posted by that
28. s com but they are not getting delivered You can change to a different address or we can try again Search GQ Home twitter Get started on Twitter What s happening Follow your first 10 accounts e Browse popular accounts by interest e Look for your friends Timeline Searches Lists CarolgeesBob Activity Search This is your homepage CarolgeesBob Nv Get Twitter on your phone It s looking mighty bare right now When you follow people their updates will appear here So go find some interesting people to follow You can tell the world what s happening in the box above account page e Setup mobile notifications s Download a Twitter application to your phone w Set up your profile e Upload a profile picture e Write a short bio Write your first Tweet e Tell the world what s happening in 140 characters or less Find Friends Use the services below to find people you know on Twitter MI Gmail Yahoo Windows Live Hotmail Messenger Bao Trends Worldwide change Twitter for iPhone The official Twitter app for iPhone Once you receive your confirmation email be sure to follow the instructions that it contains and this FoxyProxy Disabled account will be given full access to Twitter s features The quickest way to link your Twitter account to Songthrush is to select the Quick add an account option from the main Songthrush menu This will promp
29. so only have one Twitter account registered to it The full name that you enter will appear next to your messages on the Twitter website and other devices The username that you choose is used to identify you to Twitter and other Twitter uses It is used for login authentication sending and receiving messages etc This is changeable though as Twitter also gives you a hidden internal identifier so as long as the username that you want to use is available you are able to change it as often as you want to Once you have completed the form and submitted it Twitter takes you through a couple of welcome pages that are useful to people getting started with a personal account but that we want to ignore for our purposes at the moment Click Skip this step on the Browse categories and Find people you know pages until you arrive at your homepage Twitter Home Mozilla Firefox EEk File Edit wiew History Bookmarks Tools Help 39 Twitter Home l gt twittercomi e P 8 Most Visited i Latest Headlines Lasso Enable Right Click RetailMeNot Localize This Web Development Search Prototype API Share on Facebook Flickr To Facebook XRAY Sitonomy Bookmarklet GY Stumble Al Tlikeit EJ 9 Share D Info wy Favorites AA Stumblers Tools a Whoops we haven t been able to send email to your new address We ve tried sending confirmation emails to bob carolgee
30. t you for the account name and a text description of it and then step through the process of authorising Songthrush to access Twitter on your accounts behalf Session C ALCEDO 24 File Edit View Communication Actions Window Help aj ee elm 8 8 aal voltal SP elel Host 1 Port Workstation ID Disconnect SONGTHRUSH Songthrush Menu Select one of the following Quick Create Account Fi2 Cancel MAI 08 030 g 902 Session successfully started Once you have entered your Twitter account name and description the following screen will be issued i Session C ALCEDO 24 80 Sn eo eles s File Edit View Communication Actions Window Help S El l elm BIm wl volt eles el l Host 168 1 Port Workstation ID Disconnect Request Application Authorization Log into the twitter website http www twitter com as kfaiseries Open the following URL in your browser and grant access to this account http api twitter com oauth authorize oauth_token gMZaGDSV4NDnFOZNOmJmW9tOLsiGC mj LLXoBKbHARH8 Enter the PIN number that you are given here 107077 4 902 Session successfully started Cut and paste the URL displayed into your web browser and you will be taken to a form on the Twitter website that will ask you for your account name and password if you are not already logged into the Twitter service if you are logged in please ens
31. the field This can be one of e EQ equals e NE not equals e LE less than or equal e GE greater than or equal e LT less than e GT greater than e CT contains e SW starts with Value the value that the field is going to be compared against On lines other than the first specify AND OR in the first column to indicate if the clause is an and or an or clause Getting Notifications On Your Smartphone You are able to receive notifications on your smartphone whenever a tweet is published by your Songthrush linked Twitter account To set this up firstly Custom Twitter Applications In order to use the Twitter API it is necessary to register your application with Twitter Songthrush has already been registered and the majority of users will simply want to use it out of the box However in order for users to be able to have differentiation for the source of Tweets e g for different systems or subsystems and to allow more seamless integration with your software we provide the ability to enter your own application credentials into the system and use those instead Registering an application on Twitter Before you can configure your application in Songthrush it needs to be created on the dev twitter com website You will need to sign into this website with a valid Twitter account in order to create and register your application Go to http dev twitter com apps to create the application Y My applications Twi
32. tter 7 GC B https dev twitter com apps Ow aa Developers API Health Blog Discussions Documentation Search Q wa Home My applications GIE Looks like you haven t created any applications yet Y Follow twitterapi APITerms APIStatus Blog Discussions Documentation A Drupal community site supported by Acquia Click Create a new application to begin the process 6 8 https dev twitter com apps new Developers API Health Blog Discussions Documentation Home My applications Create an application Application Details Name m Your application name This is used to attribute the source of a tweet and in user facing authorization screens 32 characters max Description Your application description which will be shown in user facing authorization screens Between 10 and 200 characters max Website Your application s publicly accessible home page where users can go to download make use of or find out more information about your application This fully qualified URL is used in the source attribution for tweets created by your application and will be shown in user facing authorization screens if you dont have a URL yet just put a placeholder here but remember to change t later Callback URL Where should we return after successfully authenticating For Anywhere applications only the domain specified in the callback will be used OAuth 1 05 applications sho
33. uld explicitly specify their osuth_callback URL on the request token step regardless of the value given here To restrict your application from using callbacks leave this field blank Developer Rules Of The Road T Last Update July 2 2013 Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and discovering what s happening now We want to empower our ecosystem partners to build valuable businesses around the information flowing through Twitter At the same time we aim to strike a balance between encouraging interesting development and protecting both Twitter s and users rights So weve come up with a set of Developer Rules of the Road Rules that describes the policies and philosophy around what type of innovation is permitted with the content and information shared on Twitter Specify the name and description of your application Specify any relevant URL to you or your company against the Website Leave Callback URL blank Accept the terms and conditions and complete the Captcha challenge to create your application Create an application Tw x gt 6 8 https dev twitter com apps new Ov W Developers API Health Blog Discussions Documentation Search Q wa Last Update July 2 2013 Rules of the Road Twitter maintains an open platform that supports the millions of people around the world who are sharing and discovering what
34. ure that you are logged in with the correct account or you may unwittingly grant Songthrush access to an account that you did not intend to Enter your credentials if required and click Authorise app to grant Songthrush the necessary rights to your account bttp 2pitwitter com oauth authorize oauth ti f Y Twitter Authorise an appli I Authorise Songthrush to use your account e Songthrush By KFA Read Tweets from your timeline init lease ie See who you follow and follow new people Update your profile Post Tweets for you Access your direct messages This application will be able to KFA Songthrush IBM i Twitter client Username or email Password Remember me Forgot password Cancel This application will not be able to See your Twitter password You can revoke access to any application at any time from the Applications tab of your Settings page By authorising an application you continue to operate under Twitter s Terms of Service In particular some usage information will be shared back with Twitter For more see our Privacy Policy You will then be given a screen containing a PIN number You ve granted access to Songthrush Next return to Songthrush and enter this PIN to complete the authorisation process 3780459 Go to Twitter Go to the Songthrush homepage You can revoke access to any application at any time
Download Pdf Manuals
Related Search