To access RJE Console, you must be assigned the RJE Console user access right.
Use the RJE Console to transfer files between the personal computer and a host computer. You can perform most file transfer functions from the RJE Console. You can also monitor RJE activity by viewing console messages. By pressing the ... under the Send Files column, you can manually upload JCL to the host.
Click an option you want to learn more about.
The menu bar displays below the title bar. Click the following menus to learn about the available commands.
Open– Opens an existing .brj configuration file.
Save– Saves the current configuration to a .brj file.
Save AS – Saves the current configuration to a .brj file with a new name.
Exit –Closes the RJE Console window. You are prompted to save any changes to the console configuration.
Disconnect and Exit– Disconnects the RJE remote from the host and closes the RJE Console window. Any consoles connected to the RJE remote will also be disconnected.
Copy– Copies the selection to the Clipboard. Copying data to the Clipboard replaces the contents previously stored there.
Colors– Selects the colors to use in the console view and the RJE Diagnostics communication scope. Opens the Colors dialog box.
If Use High Contrast is selected under the Accessibility Options in Control Panel, this menu option will not be available.
Font –Selects the font to use in the console view. Opens the Font dialog box. In order to maintain proper spacing in the console view, only fixed-width fonts can be selected.
If Use High Contrast is selected under the Accessibility Options in Control Panel, this menu option will not be available.
Columns –Shows or hides the Source, Time, and Date columns on the RJE Console. A check appears next to the column name when the column is displayed.
Send Files –Displays or hides the RJE message table, which includes Name, SendFiles, Source, and Status columns. A check appears next to the menu item when the toolbar is displayed.
Error Log - Displays or hides the Error Log table, which includes Method, Message, and StackTrace columns. Note: This table is only for internal development use only.
Status Bar –The left end of the status bar shows the function key for accessing Help. The right area of the status bar displays the connection information. A check appears next to the menu item when the status bar is displayed.
Restore Defaults –Returns the RJE Console back to the default view.
Connect– Opens the Select Connection dialog box for connecting to the host.
Disconnect– Ends a console session and disconnects the RJE remote from the host. Any consoles connected to the RJE remote will also be disconnected.
Select Connection - Allows the user to select a specific connection from a drop-down window.
Clear Default Connection– Disables use of the default connection selected in the Select Connection dialog box. This does not delete the default connection.
RJE Configuration– Opens the RJE Configuration utility for configuring the RJE remote connection to the host. If the console is connected when you select this command, the RJE Configuration Utility will open the current connection.
RJE Diagnostics– Performs RJE diagnostics. Opens the RJE Diagnostics utility.
Mount Forms– Specifies which form to use with each printer. Opens the Mount Forms dialog box.
Contents and Index– Opens the Help.
Barr Systems on the Web– Opens the Help with links to the Barr Systems Web page.
The console view displays operator commands, console messages from the host, and messages regarding Barr software operations on the computer. The contents of the RJE Console are written to a log file. The console log file includes messages from the host, commands sent to the host, diagnostic messages from the Barr software, and other program activity. For more information, see the Viewing the console log topic.
The console view is divided into four columns: Source, Command, Time, and Date. To show or hide these columns, on the menu bar, select View | Columns.
Initially the console displays the Console startup text entered on the Connection Control tab of the RJE Configuration Utility. You can display information about your host computer, such as your host computer’s name and telephone numbers to call. Messages on the RJE Console help you monitor RJE activity. Console messages are recorded in a log file. The console log file includes messages from the host, commands sent to the host, diagnostic messages from the Barr software, and other program activity.
The following table describes the messages that display on the RJE Console.
Message |
Description |
Waiting until xxxxxx to start communication. |
If you configure RJE to auto connect at a specified time, then this message displays when you open the RJE Console. |
Waiting
until xxxxxx to start communication. |
If you configure RJE to reconnect periodically, then this message displays after RJE disconnects until the next reconnect time. |
Waiting
for processes to complete |
This message displays when exiting the software if there is a process in progress. This message will not display if you select to disconnect unconditionally. |
LOGON Failed (NSPE) |
This message displays during initial log on if the requested application is not available. |
LOGON Failed |
This message displays during initial log on if the mainframe detects an incorrect parameter, such as an invalid password in the INITSELF request. |
Console messages are color-coded.
Green – Messages in green pertain to information sent to the mainframe (for example, files and commands).
White – Messages in white pertain to status information received from the mainframe (for example, responses to mainframe commands).
Red – Messages in red are error messages from the Barr software.
Magenta – Messages in magenta pertain to information received from the mainframe (for example, files).
Use the RJE Console Command line to enter host commands and user messages. To issue a command, type the command on the Command line and press ENTER. Alternately, you can select previously issued commands from the drop-down list or double-click commands that appear in the console view. See the Operator commands topic for more information on host commands.
JES3 commands: The ? is a standard character in JES3 commands. However, because the ? is used to prompt you for a parameter, JES3 commands that contain a ? must be entered as double question marks (??). Double question marks will be ignored during the Barr prompt replacement and will be sent to the host as single question marks. The software can then distinguish between the Barr ? prompt and the JES3 ? command character.
The ten numbered command buttons appear below the Command line near the bottom of the window. These buttons provide a quick, customizable way of sending commands to the host. Click a command button to issue the command to the host. Up to 40 buttons (four sets of ten buttons) can be defined to invoke frequently used commands. To customize the command buttons, use the Commands tab of the RJE Configuration Utility.
To choose a command button from the keyboard, hold down the ALT key and type the number of the command button. For example, press ALT+6 to issue the command assigned to the number six command button.
Set – It is possible for users to define four sets of command buttons. Choose whether you want to use Set A, B, C, or D. Sets can be selected by clicking on their option button. To choose a set from the keyboard hold down the ALT key and type the letter of the set. For example, ALT+B selects set B.
The Status box is displayed next to the Command line and indicates the communication status between the RJE remote and the host. The Status box can be used for troubleshooting purposes. There are six possible connection states as described in the following table.
Disconnected – There is no connection between the RJE remote and the host, or the RJE Console is not yet connected to any BARR RJE service.
Connecting – RJE is in the process of connecting.
Link active – The link is active.
PU active – The PU is active.
Disconnecting – RJE is in the process of disconnecting.
Logged on – The RJE remote is logged on to the host.
The computer icon next to the Status box provides visual representation of communication at the host. The lower computer represents outbound data from the host. The upper computer represents inbound data to the host. Outbound traffic is represented in magenta, and inbound traffic is represented in green.
The left end of the status bar shows the function key for accessing Help. The right area of the status bar displays the connection information. To display or hide the status bar, on the menu bar, select View | Status Bar.