Presentation on theme: "Multi-host Internet Access Portal (MIAP) Enhancement Guide"— Presentation transcript:
1 Multi-host Internet Access Portal (MIAP) Enhancement Guide version 12.0March 2015Prepared ByOperations DirectorateDECC Division MechanicsburgMechanicsburg, PA 17050
2 MIAP RWeb 12: New Features & Functions For detailed descriptions of features & functions, please see the MIAP Manual.I) Introduction …………………………………………….3II) Help Section …………………………………………..4III) Toolbar …………………………………………………..6A) Toolbar FunctionalityB) New Toolbar OptionsC) Customized IconIV) Macros ………………………………………………….11A) New OptionsV) Keyboard Mappings .…………………….……….15A) Mapping a MacrosB) New Mapping OptionsVI) Button Palette ………………………………………21VII) Paste Replacement Characters ……..……..22VIII) Print …………………………………………………….24IX) Unisys ……………………………………………………….25A) Connection SetupB) PrintXI) Telnet ……………………………………………………….29XII) VT 320 ……………………………………………..30XIII) FTP …………………………………………………31IconsFile MenuView MenuConnection SetupSetup Transfer – GeneralSetup Transfer – ReceiveSetup Transfer – SendSetup Transfer – TransferSetup Transfer – DirectoriesSetup Transfer – File TypesTransfer MenuTransfer RequestsXIV) IND$FILE …………………………………………51A) IconsB) File MenuC) Setup MenuD) Transfer MenuE) Transfer RequestsXV) Known Issues………………………………………64A) okc vt320 …. cpftp sessionsB) FTP Send ErrorC) IND$FILE Show HostD) IND$FILE Set Up
3 IntroductionThe following are some of the major changes from RWeb 10 to RWeb 12:Toolbar has new options available including customized icons.Macros can now be edited and enhanced with the Macro Editor.Keyboard Mapping has new options available.Button Palette has new options available.Print prompt will popup if the printer ID has not previously been input and option is available to display the printer ID on the bottom of your screen.Unisys now has a popup prompt for entering your terminal ID, if it has not been previously entered. Also, a new field to display your terminal ID in the status line.Telnet has a new field to display your terminal ID in the status line.VT320 has new layout and additional options.FTP has a new layout including updated icons, additional toolbar dropdown options and the ability to change the toolbar display. Other screen updates include:Connections Setup screen has new optionsFTP Setup Transfer screen has been reorganizedNew FTP transfer menuNew FTP Transfer Request feature.IND$File menu and screens have been reorganized.
4 HelpFor additional help please refer to the help section. Select ‘Help’ from theMenu bar then ‘Help Topics.’
5 HelpWithin the help window a search bar can be used to search various topics oryou can scroll through the available topics.
6 Toolbar : Toolbar Functionality The toolbar viewing functionality has been modified in RWeb Previously the Show Toolbar and Show Toolbar Text were the available options, under Views. In RWeb 12.0, under View, the Toolbar can be turned on for viewing , by clicking on Toolbar and it will be checked. Clicking on Toolbar again will turnoff (uncheck) viewing the toolbar.RWeb 10.2RWeb 12.0
7 Toolbar: Toolbar Functionality In RWeb 12.0 additional toolbar functionality is available. Select Setup, then Toolbar. On the bottom right of the screen that is displayed, the Show dropdown allows icon and text options, in addition to larger (Big) icon choices.Items can be dragged onto or off of the default toolbar.
8 Toolbar: Toolbar Functionality If there are more icons than can fit across the top of the screen, click on the >> in the top right corner to display the additional icons down the right hand side of the screen. Click it again to hide the additional icons.
9 Toolbar: New Options Connect to Host Disconnect from Host Configure Session SettingsNew Macro Editor Window
10 Toolbar: Custom IconsYou can create a custom toolbar icon and associate it with an action, then add it to the toolbar. From the session menu select Setup then Toolbar. Click Add to open the Define Toolbar Item dialog box. Click Edit to change an existing custom toolbar button. Click Delete to remove the custom toolbar button. Drag the custom icon onto the toolbar to display.
11 MacrosA macro is a series of keyboard actions that can be recorded and then run while using Reflection for the Web (RWeb). In previous versions of Web the Macros option was named Playback. Select Macros and the Macro box will appear.RWeb 10.2RWeb 12
12 Macros: New OptionsEdit - After you've finished recording your macro and saved it, you can edit and enhance it using the Macro Editor. See next slide for example.New – Allows you to create a new macro from scratch.Events - Allows you to assign a macro to be run when a connect event or a disconnect event occurs in the terminal session. This option is only available if there are existing macros.This option wascalled Play inprevious versionsof RWeb.
14 MacrosMacro EditorNote: If the script has errors, it will not run. The run button provides the capability of testing the script.
15 Keyboard Mapping: Mapping a Macro The Keyboard Setup dialog box can be used to update the keyboard mapping forReflection. Keyboard mapping is the association of keys or key combinations on yourkeyboard (the "trigger") with particular actions. A new option available is mappinga macro. To map a macro do the following:Select Setup from the session toolbar then Keyboard from the drop down menu.
16 Keyboard Mapping: Mapping a Macro Select Add and the Define Trigger box will appear. Press the keystroke that you wantto map. For example if you are remapping the ‘esc’ key then press the ‘esc’ key .
17 Keyboard Mapping: Mapping a Macro If the key is already mapped you will receive ‘The keystroke Escape is already mapped.Overwrite the mapping?’ Select yes if you want to overwrite the current mapping.
18 Keyboard Mapping: Mapping a Macro The Define Action box will appear. To map a macro select Execute command in the Action type drop down. Scroll down to find run macro. Select OK and OK again to save the keyboard setup.
19 Keyboard Mapping: Mapping a Macro Execute transfer request, Load java class and Run macro are no longer options within the Action type drop down. They are now available within the Execute command drop down.RWeb 10.2RWeb 12Now located here
20 Keyboard Mapping: New Options The following are new mapping options available using the Execute Command:Configure button paletteConfigure colorsConfigure keyboard mappingsDisplay macro popup menuEdit previous macro played/recordedNew macro editor windowOpen specified URLRun previous macro played/recordedShow IND$FILE transfer windowShow reflection for the web helpShow transfer requestsStart recording a macroStop recording/running macroToggle button paletteToggle keyboard paletteToggle SO/SI markers*Note: These options are also available for the Button Palette
21 Button PaletteThe button palette is a set of clickable buttons on a palette that you can use to transmit strings or host functions to the host, or to execute Reflection commands locally. To display the button palette, choose Setup then Button Palette from the dropdown menu. ‘Tooltip to associate with button’ is a new field in the Define Button Test box. The Button Palette also has the same new options in the Execute Command field as seen on the previous slide for keyboard mapping.
22 Paste Replacement Characters In an IBM 3270 telnet session, if characters are not translated correctly during a paste from an application such as Microsoft Word, use the new Replacement characters feature. Select Edit on the toolbar, Copy/Paste Settings, from the dropdown, then select Replacement characters.
23 Paste Replacement Characters When a pasted character is beyond the range of characters in the IBM 3270 translation table, a question mark (?) is displayed. To force the character that is not being replaced appropriately, assign a different value in this dialog box. Common Unicode characters and their replacements are already provided, but you can add new mappings, delete a mapping, or change a mapping.Click on Help button for more information.
24 PrintIn a TN3270 printer session, prompt for the printer ID (Host LU name) has been modified. The following prompt will popup if the printer ID has not previously been input.If you would need to correct your printer ID value after it has been entered or if the popup does not appear, select Connection, then Connection Setup to display a screen with fields to turn on the prompting or to type in a value.
25 Unisys: Connection Setup New in Rweb 12, there is now a popup prompt for entering your terminal ID, if it has not been previously entered, as long as the prompt if not specified checkbox has been checked on the Connection Setup screen.
26 Unisys: Connection Setup Once you have entered your terminal ID, it will be automatically filled in on the Connection Setup screen Specify terminal ID field and saved in your preference file, so that you will not be prompted for it again. If you need to correct your terminal ID, you can do so on the Connect Setup screen, after clicking on the Disconnect button if you are connected, so that the Specifyterminal ID field will be ungreyed and accessible.If the Connect at startup field is checked, your session will connect automatically when you launch it.
27 Unisys: PrintRWeb 12 includes an enhancement that allows variables to be input in as page headers and footers. From a Unisys session, select File, Page Setup, then the Page options… button.Note: Page headers and footers are only used when the print is sent to the printer not went sent to file.
28 Unisys: PrintIn the below example, &d&t in the Page header field results in the date and time being printed on the top of each page. Page footer of &p results in the page number being printed on the bottom of each page.
29 TelnetFor TN3270 telnet sessions, some of the device name fields, i.e. prompting , have moved from the TN3270E Settings screen to the Connection Setup page.RWeb 12.0RWeb 10.2
30 VT 320See below for the new layout of the VT 320 Terminal Setup Display Window. It also has the following three additional options:Save before clearing from any row: This setting specifies whether data that has been cleared from a portion of the terminal window is saved in display memory.Compress blank rows: Select this option to save room in display memory by compressing multiple blank rows into a single blank row.Enable ANSI locator service: You can use your mouse to specify screen locations and send locator position reports and locator device status reports (DSRs) back to the host.10.212.0
31 FTP: IconsFTP icons have been updated. If the icons are not self explanatory , recommend turning on the text with the icons as described on slide #7 (Toolbar Functionality).ExamplesSend to HostTransfer Setup12.010.2Send to HostTransfer Options18.104.22.168
32 FTP: File MenuAdditional toolbar dropdown selections have been added. Most of these simply provide users with additional ways to perform functions they have always been able to do. Others support the new Transfer Request feature, which will be described subsequently.As an alternative to using the icons, File, New Directory, Rename File or Delete File can now be used. The icons can still be used in RWeb12 as well. Edit File is a new option that can be used after selecting (highlighting) a local file and it will open the file for editing.
33 FTP: Edit MenuAbility to copy and/or to clear the FTP console options can be found under the Edit option on the toolbar. Select Edit , then Copy Console Contents to copy all the data in the FTP console to the system clipboard. The Data copied to the system clipboard message will display on the bottom of your screen. This data can then be pasted into a Word, Notepad or other document. The Edit then Erase Console Contents will clear the FTP console on your screen.
34 FTP: View MenuAn alternate way to change your display to show both lists and console or just one or the other is now available. Under View, check Show Lists and Console or Show Lists or Show Console. The original way to choose with the icons is still available. Reminder: To change the size of your FTP console hover your cursor on the up and down arrows above FTP console until a white arrow appears and then left click on your mouse and drag up or down.
35 FTP: Connection SetupConnection Setup and its Advanced FTP Settings screen have had some additions. Select Connection, then Connection Setup. Server type is a new field that defaults to Auto Detect, which identifies your server automatically. Connect at Startup is also new and is checked by default so that the session behaves as it had previously establishing an FTP connection as soon as the session is launched. As before, click on the Advanced button to display the Advanced FTP Settings screen, to specify additional settings.
36 FTP: Connection SetupOn the Advanced FTP Settings screen the LIST command parameters field is new where any command parameters that should be sent when issuing a LIST command to the FTP server can be specified. The default value is -a. This option is only available if you clear the check box for Auto detect from server type.Reminder: Startup Quote command field can be used to specify a string to be sent to the FTP server as the session starts. It allows you to set FTP server options when starting the session. For example: lrecl=160 blksize=18400.
37 FTP: Setup Transfer - General Many of the transfer settings and options have been moved in RWeb12 for better organization and to group like items together. In the below tab driven FTP Transfer Setup screen. Select Setup from the menu , then Transfer Setup.The default tab is the General tab shown. (These options were previously located on the Setup menu, FTP Options selection.) The Prompt to add request when sending or receiving files checkbox is new as part of the Transfer Requests enhancement.
38 FTP: Setup Transfer - Receive Select Setup , Transfer then click on the Receive tab to configure settings to be used when receiving a local file from the remote host.If local file exists and Refresh local file automatically fields were in previous versions (previous location Setup, FTP options). However, additional options are now available If local file exists and there is a new field If Transfer fails: to specify how the transfer should operate if the transfer fails.
39 FTP: Setup Transfer - Send Select Setup , Transfer then click on the Send tab to configure settings to be used when sending a local file to the remote host.If remote file exists and Refresh remote file automatically fields were in previous versions (previous location Setup, FTP options) . However, additional options are now available in If remote file exists drop down and there are two new fields: If Transfer fails: to specify how the transfer should operate if the transfer fails and Compute space on MVS. By default, the FTP Client computes and pre-allocates the number of tracks on the MVS host system. Clear this option to disable the feature.
40 FTP: Setup Transfer- Transfer Select Setup, Transfer then the Transfer tab to set additional transfer settings.These fields were all available in previous RWeb versions. Host encoding and Show progress dialog previously were located on the Setup Transfer Options screen. Session timeouts is located here in addition to under Connection Setup then Advanced button.
41 FTP: Setup Transfer - Directories Select Setup , Transfer then click on the Directories tab to configure Initial remote and local directories.These could previously be set under Setup menu , Directory locations selection.
42 FTP: Setup Transfer – File Types Select Setup, Transfer then click on the File Types tab to determine what transfer method to use (ASCII or binary) when transferring files using the smart file transfer option. The determination of how the files are transferred will be made on the selections made on this screen only if Smart transfer is selected (see next screen).The determination of whether the files will be transferred using ASCII or binary method, depends on the source file extension. Ex. .bat file will use ASCII method, based on the highlighted entry on the right. Any file extension not in the table will use the Transfer method for undefined file types selection.This screen was previously located under Setup menu, FTP Options selection, File Types button.
43 FTP: Setup Transfer – File Types If you want the FTP client to automatically determine what transfer method to use (ASCII or binary) based on the type of file that is being transferred, select the Smart transfer method button in the FTP session window. Or if you select ASCII, all files will be transferred using the ASCII transfer method. If Binary is selected, all files will be transferred using the Binary method. This choice can be made by selecting the icon for either Smart, ASCII or Binary on the toolbar. An alternate way to make this choice that has been added in RWeb12, is to select Transfer from the menu, then Transfer Method and then make your selection. (Smart transfer has been selected in below examples.)Magnified icons with text
44 FTP: Transfer MenuThe Transfer Menu is new in RWeb12. It mostly consists of alternate ways to perform functions that were previously available and are still available using the icons: Send File, Receive file, Refresh List and Stop Operation. Transfer Method was discussed on the previous slide.After selecting a file or set of files in the server pane, select Receive File to transfer the file(s) to the current directory location on local machine.To specify the local file name, select Receive File As…. You will be prompted to type in the new local file name (see below).Send File and Send File As…behave similarly for files being sent to the host.
45 FTP: Transfer Requests New Feature: FTP Transfer Requests. Use FTP transfer requests to save file transfer information to later execute the transfers without having to specify files and options each time.Creating a transfer requestIn the local directory and the server directory panes of the FTP client, navigate to the location where the file transfer operation is to be performed. This is an easy way to specify the directories that will be used in your file transfer request.Select the file or files that you want to transfer in the Local files pane or the Server files pane.Click Add Request icon on the toolbar or select Add transfer request from the File menu.Add transfer request iconLocal files paneServer files pane
46 FTP: Transfer Requests A Receive Transfer Request screen (shown below) or a Send Request screen will popup depending on whether the file(s) you selected to transfer were in the in the Local files pane or the Server files pane.Specify a Name for the file transfer request.Review the Transfer settings for the transfer request, and make any necessary changes.Click OK.A transfer request with that name will be added and will automatically be displayed on the Transfer Requests screen.
47 FTP: Transfer Requests Transfer requests are shown in the Transfer Requests screen. To open this dialog box, do one of the following: Select File, then Transfer Requests or click the Show transfer requests icon on the toolbar.Enlarged show transfer requests iconAll existing transfer requests are listed in this dialog box, including transfer details about the files included in this transfer, and options you have configured for the transfer. To run a saved transfer, select it and click Execute. You can also edit or delete a transfer request from this list.Successful file transfer message
48 FTP: Transfer Requests Click on the Add group button to open the Add Group dialog box, where you can specify a new group name. Use transfer request groups to organize requests that you routinely execute together. You can drag transfer requests into a group or edit the request and select from a list of available groups.Click the arrow in front of the group folder to expand the group and show all requests that are included in it.
49 FTP: Transfer Requests When creating a transfer request, if the file(s) you select to transfer are in the Server files pane (to be transferred to your local machine), the Receive Transfer Request screen will popup.In addition to giving the transfer a name and group, you can also specify the filename for the file to be received in Destination Name and can select the Transfer settings button to specify additional options for the receive transfer request.The settings on the Transfer and Receive tabs are similar to the Setup Transfer screens described earlier.
50 FTP: Transfer Requests Similarly when creating a transfer request, if the file(s) you select to transfer are in the Local files pane (to be transferred to the server (host)), the Send Transfer Request screen will popup.In addition to giving the transfer a name and group, you can also specify the filename for the file to be sent in Destination Name and can select the Transfer settings button to specify additional options for the send transfer request.The settings on the Transfer and Send tabs are similar to the Setup Transfer screens described earlier.
51 IND$FILEIND$FILE and IND$FILE Transfer Requests were available in previous versions, but their menu options have been moved to be directly under File as shown below. To launch IND$FILE now either select File then IND$FILE or the IND$FILE icon from the Toolbar.NOTE: Any host commands that were previously needed to perform IND$FILE transfers , ex. TSO command option (6), entering \ft on command line, are still necessary.12.010.2
52 IND$FILEIND$FILE has been reorganized in RWeb12 and its menu and screens now have a similar look to FTP in RWeb12. In RWeb12 there are now menu (File, Setup…) and toolbar icons available, instead of the dropdowns and buttons previously located in the center of the screen. Show host files is still used to list files on the host.10.212.0
53 IND$FILE: IconsThe icons are consistent with the icons for FTP. If the icons are not self explanatory , recommend turning on the text with the icons as described on slide #6 (Toolbar Functionality) or clicking Help menu. Icon examples:ASCII transfer method - Use for text files with no special formatting.Transfer (Send) selected files to the host.Specify TSO data level - If you are connected to a TSO host, click this button to type in the new dataset you want to view. Reflection for the Web updates the remote file list using the dataset level you specify.Configure transfer settings to set defaults and to control various aspects of IND$FILE transfer.
54 IND$FILE: File MenuThe RWeb12 IND$FILE File Menu is consistent with the RWeb12 FTP File menu. Most of these selections simply provide users with additional ways to perform functions that can alternately be done with the icons. For Ex. both the icon and file menu options pointed to perform the New Directory function.File, New Directory allows you to create a new folder or directory on the local. After clicking in the local panel to make this option available, enter a directory name in the dialog box, and then click OK. Rename File or Delete File or Edit File can be only be used after selecting (highlighting) a local file.
55 IND$FILE: Setup MenuTo configure transfer settings to set defaults and to control various aspects of IND$FILE transfer, select Setup and then Transfer Setup or click on the corresponding icon. Most of these setting choices were previously located in the center of the IND$FILE Transfer screen. They are now located on this tab driven screen similar to RWeb12 FTP.The IND$FILE Transfer Setup General tab is to configure IND$FILE confirmations and prompts for file transfer. For instance, check Confirm file deletions if you want to be prompted for confirmation before deleting a file or folderHidden configure transfer settings icon
56 IND$FILE: Setup MenuThere are separate IND$FILE Transfer Setup tabs to set specific settings when receiving or sending files, Receive and Send. Most of these setting choices were previously located in the center of the IND$FILE Transfer screen. However, If Transfer fails: to specify how the transfer should operate if the transfer fails and Abort transfer operation if transfer fails checkboxes are new.
57 IND$FILE: Setup MenuThe IND$FILE Transfer Setup Transfer tab contains the rest of the transfer settings that can be configured. Most of these setting choices were previously located in the center of the IND$FILE Transfer screen.Note: System: TSO and Transfer method: ASCII are usually selected.New Fields:PC code page - The character set to use when reading or writing local files during a file transfer. The value "Default" uses the code page corresponding to your operating systems locale.Host code page - The character set to use when translating EBCDIC characters while transferring files to or from the host. The default, Use NCS setting, uses the national character set specified in the Terminal Setup, Emulation tab.
58 IND$FILE: Transfer Menu Again, the RWeb12 IND$FILE Transfer Menu is consistent with the RWeb12 FTP Transfer menu. Most of these selections simply provide users with additional ways to perform functions that can alternately be done with the icons. (For example, instead of selecting Send File, the iconcould have been selected.)After selecting a file or set of files in the local files pane, select Send File to transfer the file(s) to host.To instead specify the host file name, select Send File as and the prompt below will display allowing you to type in the new host file name.Receive File and Receive To Location behave similarly for files being received on the local machine.
59 IND$FILE: Transfer Requests Transfer Requests for IND$FILE are not new in RWeb The process has been modified to be consistent with RWeb12 FTP. Transfer requests were added and executed previously using the Add Requests and Show Requests buttons in the center of the screen. In RWeb12 Transfer requests are added by selecting File, then Add Transfer Request or clicking on the Add transfer request icon. Transfer requests are displayed to be executed by selecting File, then Transfer Request or clicking on the Show transfer request icon.10.212.0
60 IND$FILE: Transfer Requests To add a transfer request, same as previously, navigate in the local directory and the host directory to the desired file locations. Select the file(s) to be transferred. Select File, then Add Transfer RequestA Receive Transfer Request screen (shown below) or a Send Request screen will popup depending on whether the file(s) you selected to transfer were in the in the Local files pane or the Host files pane.Specify a Name for the file transfer request.Review the Transfer settings for the transfer request, and make any necessary changes.Click OK.A transfer request with that name will be added and will automatically be displayed on the Transfer Requests screen.
61 IND$FILE: Transfer Requests When adding a file request in addition to the Name, additional Transfer settings can now be specified, similar to FTP transfer requests.For transfers from the host to the local machine, on the Receive Transfer Request screen, click on Transfer settings button.The Transfer Settings screen will popup with Transfer and Receive tabs. These tabs contain the same settings that were described earlier for IND$FILE transfers. They now can be specified when creating saved IND$FILE Transfer Requests.
62 IND$FILE: Transfer Requests Similar settings can be specified when transferring from the local machine to the host, on the Send Transfer Request screen, click on Transfer settings button.The Transfer Settings screen will popup with Transfer and Send tabs. These tabs contain the same settings that were described earlier for IND$FILE transfers. They now can be specified when creating saved IND$FILE Transfer Requests.
63 IND$FILE: Transfer Requests To execute a saved transfer request, select File then Transfer Requests or click on the show transfer requests icon for the Transfer Requests screen to display. The functionality of the screen is the same in RWeb12 as it was previously, but some of the buttons locations and headings have changed. After selecting a transfer request (highlighting it), you can click on the Execute button to perform the transfer or select the Edit or Delete buttons to edit or delete the transfer request. Add group button works as it did previously. (Add group is described in more detail on FTP Transfer Requests(slide 48)).12.010.2
64 okc vt320 …. cpftp sessionsWhen you receive the error:"550 LIST file status error file*file. "File not found or deleted by another run".", the host disconnects you from the host. MIAP still shows you as connected.550 LIST file status error File*File. *File not found or deleted by another run”.You can check your status; on the command line enter “rstatus”. ‘Command failed’ result confirms you've been disconnected.If you get the error, disconnect and reconnect.Set “Passive Mode” as a possible work around to keepfrom disconnectingUnder Connection / Connection Setup select “Use passive mode”.The 550 list error may still occur but the transfer should complete.Check the Host files after the transfer completes to verify.Please try the following as a work around for 550 file not found error.Prior to sending the file to the host, if the file does not already exist on the host, issue a catalog command on the host for that file.If you can't catalog the file first, you will need to use a command line:PUT C:\DIRNAME\FILENAME.TXT QUALIFIER*FILENAME.ELEMENTSend the file.
65 FTP Send ErrorIf an error occurs sending a file to the host, the name of the file may be saved in cache. When you go to do the next send, that name may be still referenced.Solution: Select a local file name and hit “ctrl” and click on that file name. This will clear the cache.65
66 IND$FILE Show HostIf the “Show host files…” button appears on your Host files panel after attempting a transfer, check your host session. You may be disconnected or an error may have occurred. If selecting “Show Host files…” button does not refresh you Host files panel, you will need to close the session and start again.When creating a Send Transfer Request, on browsing to select a Host Destination name, the Select Host Files displays an incorrect image. Clicking the “Show Host files…” button works correctly.6666
67 IND$FILE Set UpThe default IND$FILE screen is shown below. CMS shows by default. Binary is the default “Transfer method”. Use the IND$FILE Transfer Setup /Transfer tab to configure your preferences. Select the your preference from the drop downs and select “OK”.Note: Most users select System: TSO and Transfer method: ASCII.Default Setup