Chapter 4 The STATUS Program. Nobix ElectroPage

PDF

Dokument

Oglas

Chapter 4

The STATUS Program

The STATUS program allows users to interactively view and search saved spoolfiles. After

ElectroPage has examined and saved a spoolfile, the report or IBM job listing will be available online via the STATUS program. The STATUS program allows access to saved reports with a user interface called the Viwer.

The STATUS program provides:

• Index selection and search

• User-defined function keys

• Forward/backward search

• Streamlined folder configuration

• Suppression of PCL data, for easier report viewing

• Support of vertical single line and page scrolling

• Support of horizontal single line and multiple-column scrolling.

• Ability to save user preferences.

Command reference

The STATUS program has two modes: Line mode and Report mode. The Line mode commands are:

Commands

SHOWFOLDER

Description

Displays the folder structure.

Nobix ElectroPage Administrator’s Reference Guide 49

Commands

SHOWREPORT

Chapter 4 The STATUS Program

Description

Displays the reports within a folder structure.

Nobix ElectroPage Administrator’s Reference Guide 50

Chapter 4 The STATUS Program

SHOWFOLDER

This command displays the folder structure for a given tree or branch.

Syntax

>>SHOWFOLDER [<folder-name> | @]

Operation

This command tells ElectroPage to display the folder structure, starting with < foldername > and all folders beneath it. This command shows how folders relate to others within the same branch structure. It displays the number of spoolfiles in each folder and the time the folder was last updated with a new spoolfile.

The < folder-name > parameter is optional. Use the name of the folder in quotes. If foldername is omitted, the system displays all top level folders. Wildcards are not allowed, however using @ for the folder name displays the entire nested structure.

Example

>>SHOWFOLDER.

FolderName---------*

ALL-REPORTS

M.I.S. REPORTS

MANUFACTURING

SALES

Count

735

129

538

Example

>>SHOWFOLDER “SALES”.

FolderName---------*

SALES

..SALES ORDER

Count

Latest----------*

2005/09/04 09:54:20

2005/09/04 03:27:53

2005/09/04 18:37:12

2005/09/04 09:54:20

Latest----------*

2005/09/04 09:54:20

2005/09/03 23:33:09

See Also

SHOWREPORT

Nobix ElectroPage Administrator’s Reference Guide 51

Chapter 4 The STATUS Program

SHOWREPORT

This command displays the reports associated with a folder.

Syntax

>>SHOWREPORT [<folder–name>]

Operation

This command tells ElectroPage to display the reports and spoolfiles contained within a folder as specified by <folder–name>.

Example

>>SHOWREPORT “all reports”

File FileDes

1 STATUS

2 TEST

24 TEST

8 TEST

TEST

Job/Sess UserName

MGR

TEST

MANAGER

TEST

MANAGER

See also

SHOWFOLDER

AcctName OrigDev

ALTAO 00000307

#Pages Created-----#J/S

4 20050722 0953 S13

NSD LP 3 20050727 1707 S398

SYS

20050819 0946 J12

20050819 0944 J11

20050819 0943 J10

SYS

20050819 0941 J9

20050819 0926 J8

20050819 0903 J7

Nobix ElectroPage Administrator’s Reference Guide 52

Chapter 4 The STATUS Program

Report mode

Reports cannot be viewed from within the CONFIGX program, so first exit the configuration program. At the e3000 prompt, enter the STATUS program Report mode by typing: status.jpak.nsd report

Optionally, enter Report mode on the MPE command line by typing:

STATUS.JPAK.NSD -R

To quit Report mode, press F8-EXIT VIEWER .

Viewer—folder tree

When the Viewer initially opens, the JobPak folder tree appears:

Nobix

The folder tree contains a hierarchical listing of all of the folders containing the reports

currently in the system. Refer to the “Configuring folder organization” section in Chapter 3,

“The CONFIGX Program.”

Function buttons appear at the bottom of the Viewer screens, providing a shortcut method to execute commands. These buttons correspond to the F1-F8 function keys on the keyboard.

(Some of these buttons remain undefined.)

If the folder tree is very large, press F1-FIND FOLDER to quickly locate a particular folder.

ElectroPage Administrator’s Reference Guide 53

Chapter 4 The STATUS Program

To display just the top-level folders, select F4-COLLAPSE ALL . The total number of reports stored in the JobPak folders appears on the right-hand side of each top-level folder.

To re-display all of the folders in the JobPak folder tree, select F2-EXPAND ALL .

To expand one section or branch of the folder tree, highlight a folder as shown below and press F3-EXPAND BRANCH .

Nobix

To view the subfolders in any particular folder, highlight the parent folder and press ENTER .

Updating the folder tree

If you have been in Report mode for some time, there may have been changes to the configuration that have not been recorded. To update the folder tree and create a current list of folders and reports, press F6-REFRESH DISPLAY .

Viewer configuration options

In Report mode, the screen configuration can be changed for individual viewing. At the

Viewer folder tree screen, select F5-CHANGE CONFIG . The Screen Configuration Options dialog box appears:

ElectroPage Administrator’s Reference Guide 54

Chapter 4 The STATUS Program

Nobix

Note:

To access the Screen Configuration Options screen when viewing a report, press F6-

Misc Keys .

To change the screen configuration, supply variables for the following:

•

Vertical scroll increment (#lines) —enter a number to specify how many lines to scroll through the report when using the UP and DOWN arrow keys.

•

Horizontal scroll increment (#columns) —enter a number to specify how many columns of the report appear when using LEFT and RIGHT arrow keys.

•

Maximum scroll to right edge (#columns) —enter a number from 80 to 264 to change the defined right-hand column scroll destination (defaults to 132).

•

Automatic switch to HP 132-column mode —using Reflection or an HP terminal emulator, you can enter a Y to reconfigure to a 132-column screen width.

Screens will automatically switch between 80-column and 132-column mode. Rows do not change.

•

Automatic screen dimension detection —enter Y to automatically calculate the rows and columns of the display and apply fit-to-window dimensions.

ElectroPage Administrator’s Reference Guide 55

Chapter 4 The STATUS Program

This feature automatically detects how many columns and rows the display has, and will then attempt to fit the information into the screen area, as opposed to the default 80column x 24-row display.

•

Initially explode all folder trees —enter Y to configure the folder tree to display all of the subfolders in the hierarchy.

•

F4-user function key :XEQ filename —Reflection users can define the F4-User Key with an

MPE file name.

Enter the name of the MPE :XEQ file to be executed via this user-defined function.

The first eight characters of the filename will appear as the label on the screen button for your unique user configuration, according to the individual logon ID and sign-on.

Report printing

The STATUSI.PUB.NSD

file sets up the STATUS program’s default printing environment.This governs the Print by Page command when viewing a report. For more information, refer to the

“Miscellaneous keys F6” section in this chapter. This configuration

controls the following:

• Slave printer initialization sequence

• PC initialization sequences

• Additional initialization variables

When the STATUS program is loaded, it searches for the STATUSI file in the logon group of the logon account. If the STATUSI file is not there, STATUS searches the PUB group of the logon account. If it does not find a STATUSI file there, STATUS uses the STATUSI file in the

PUB group of the NSD account.

The following commands reside in the default STATUSI file, which can be changed:

Command

LOCALRESET = “char–sequence”

LOCALCOMPRESS = “char–sequence”

LOCALPORTRAIT = “char–sequence”

Description

STATUS reads this command when it prints to a slave printer on a terminal or PC. The value of char-sequence is sent to the printing device when printing is initiated; it is also the last character sequence sent when printing is finished.

STATUS reads this command when it prints to a slave printer on a terminal or PC. If compressed print is selected, STATUS sends the character sequence to the printing device after it sends the

LOCALRESET sequence but before sending any data.

STATUS reads this command when it prints to a slave printer on a terminal or PC. If a Portrait orientation is selected, STATUS sends the character sequence to the printing device after the LOCALRESET sequence but before any data is sent.

Nobix ElectroPage Administrator’s Reference Guide 56

Chapter 4 The STATUS Program

Command

LOCALLANDSCAPE = “char–sequence”

TERMINIT = “char–sequence”

LOCALMAXPAGES = “numeric value”

Description

STATUS reads this command when it prints to a slave printer on a terminal or PC. If a Landscape orientation is selected, STATUS sends the character sequence to the printing device after the LOCALRESET sequence, but before any data is sent.

When the STATUS program enters report mode, it clears the terminal screen by using an ESC–H,

ESC–J sequence; however, sometimes this is not sufficient.

When entering TERMINIT in the STATUSI file,

STATUS will send the character sequence to the terminal every time Report mode is entered. This allows some additional initialization to be performed, if necessary.

This command limits the number of pages that can be printed on the slave device of a terminal or PC. By default, there is no limit.If the report being printed does not contain carriage controls,

STATUS assumes a page break after every 60 lines.

Character strings

A string of characters surrounded by quotes is used for the parameter value in the above commands. Control characters (non-displayable ASCII) are indicated by a leading caret ( ^ ).

For example, a CNRL-N or ASCII shift-out is represented by ^N . A null is ^@ ; an ESC is ^[ .

A caret is represented by two carets in a row ( ^^ ).

Report viewing

To access a report, highlight the folder where the report resides and press ENTER . A listing of the reports in the selected folder is displayed, as shown below.

Nobix ElectroPage Administrator’s Reference Guide 57

Chapter 4 The STATUS Program

Nobix

For more information, refer to “Viewing report generations” in this chapter.

Report sorting occurs based on File designator, Account name, User name, Job/Session, and date/time sequence (in descending order).

The following information is displayed for each listed report: the generation (version) count, the most recent generation (latest creation time), and the device on which the spoolfile originated.

Locating reports

If a folder displays an extensive list of reports, press F1-FIND REPORT to quickly locate a specific report.

Enter the file designator, job name, user name, account name and originating device, in that order, into the five fields that are displayed at the bottom of the list, as shown in the following example.

ElectroPage Administrator’s Reference Guide 58

Chapter 4 The STATUS Program

To list all the generations of a particular report, including page count and time of creation, highlight the report and press F3-EXPAND REPORT . The report generations are listed in descending time sequence, as in this example:

Nobix ElectroPage Administrator’s Reference Guide 59

Chapter 4 The STATUS Program

Nobix

To re-display the original report listing, showing all of the report generations in the folder and the page count, press F2-EXPAND ALL . To display only the most recent generations (and the generation count), press F4-COLLAPSE ALL .

A tilde appearing next to an individual report listing indicates that page numbering within the report is approximate (no tilde indicates there is carriage control in those files), as explained below.

Viewing report generations

To view a particular report, highlight the report listing and press ENTER . If the file has carriage control, demarcation lines will be displayed within the report indicating the beginning and ending of each new page. The example below shows a report with carriage control; however, sometimes a report without carriage control may also display an initial page indicator at the top, resulting from a form-feed command.

ElectroPage Administrator’s Reference Guide 60

Chapter 4 The STATUS Program

The status line, highlighted at the bottom of the Viewer screen, indicates the pages and lines relative to one. Line number one, indicating the top line, changes while scrolling up or down, using the keyboard arrow keys.

There are a total of 132 columns, with 80 columns for full-screen viewing. A circumflex (^) flags the left and right column numbers. While scrolling to the right or left, using the RIGHT and

LEFT

arrow keys, these column numbers will change.

Report navigation

The following table describes the function buttons at the bottom of the Viewer screen.

Detailed procedures follow the table.

Name

MaxLeft

LinePage Controls

String Search

MaxRight

Head/Col Freeze

Key

Description

Aligns Viewer flush left to column 1 of report.

Accesses line navigation functions.

Accesses text searching functions.

Moves to the value configured for max. scroll to right

(refer to “Viewer configuration options”).

Locks heading and columns on display.

Nobix ElectroPage Administrator’s Reference Guide 61

Nobix

Chapter 4 The STATUS Program

Name

Misc Keys

HELP

EXIT Report

Key

Description

Accesses miscellaneous configuration functions.

Displays on-line help.

Returns the display to the report list.

To navigate within a report, use the Page Up and Page Down keys on the keyboard to move in full-screen views (as opposed to complete pages), or use the UP and DOWN arrow keys, to move one line at a time.

Line page controls F2

Press F2-Line Page Controls to access line navigation functions when viewing a report. The function button display toggles to the following selections:

F1-GoTo Line —enter a line number to view. The specified line displays at the top of the screen when you press ENTER .

F2-ShowLine Numbers —displays line numbers along the left-hand side of the page (offsets the text by eight positions). Toggle this function again to deactivate the line numbers.

F3-GoTo Page —enter a page number at the prompt to access a page of the report. If ENTER is pressed without entering a page number, the prompt disappears.

F4-Show Columns —displays column numbers, in increments of ten, at the bottom of the screen. Toggle this function again to deactivate the column numbers.

F6-Exit LinePage —exits the line page control functions and goes back to the basic Viewer functions.

F5 is undefined for the Line Page Controls.

String search F3

Press F3-String Search to find text in a report. The function button display toggles to the following selections:

F1-Enter FindText —at the prompt enter text to be found. Enter f or b to search forward or backward from the current location.

F2-Find Next —find the next occurrence of text that has been specified by Enter FindText .

F3-Find Options —enter search parameters. The Search Configuration Options dialog box appears:

ElectroPage Administrator’s Reference Guide 62

Chapter 4 The STATUS Program

Nobix

Supply values in the fields as described below:

•

Remove spaces during search —enter Y to remove spaces from a text string specified with

Enter FindText , thereby speeding up the search.

•

Match case during search —enter Y to specify the text search as case-sensitive to the specified text string.

•

Search frozen heading area —enter Y to search the locked lines at the top of the screen.

These are established with the Header/Col Freeze command. For more information, refer to

“Heading and column freeze F5” in this chapter.

•

Left-most column to search —enter the number of the leftmost column to define where the search begins.

•

Right-most column to search —enter the number of the rightmost column to define where the search ends.

To save the search configuration, tab to OKAY and press ENTER .

Press F6-Exit Search to toggle back to basic Report mode functions.

ElectroPage Administrator’s Reference Guide 63

Nobix

Chapter 4 The STATUS Program

Heading and column freeze F5

When scrolling through long reports, it may be helpful to keep column headers in view at the top of the screen. To lock or freeze a heading or column in place, press F5-Head/Col

Freeze . The function button display toggles to the following selections:

Key

F1–Heading Freeze

F1–Increase HeadLock

F2–ShowLine Numbers

F3–Remove Last Lock

F4–Show Columns

F5–Lock a Line

F6–Exit HeadFreeze

F3–Column Freeze

F1–Add Segment

F2 ShowLine Numbers

F3 Remove Last Segment

Description

Locks the report heading at the top of the Viewer screen, and toggles the function button display to the following:

Incrementally adds horizontal heading freezes from the top down. One or more rows can be added to the beginning of the page/column orientation, and the heading configuration can be viewed separately when exiting Heading Freeze.

Shows line numbers along left-hand side of page and offsets the text by eight positions. Toggle again to deactivate.

Incrementally removes a headlock, starting with the last freeze applied.

Displays numbers in increments of ten, at the bottom of the screen, indicating the column numbers.

Freezes text in a line. At the prompt, enter a line number to freeze, and press ENTER . The line appears at the top of the screen.

Toggles back to the Heading/Col Freeze functions.

Locks columns vertically, rather than horizontally, and toggles the display to the following function buttons:

Concatenates selected columns and automatically creates a separate view of the selection, which can be viewed by exiting

Column Freeze . When this function is selected, the column numbers (read vertically, beginning with the numeral 10) are automatically displayed at the bottom of the report, as shown below:

1111111111222222222233333333344444444555555555566666

123456789012345678901234567890123456789012345678901234567890123

--------------------------------------------------------------

At the prompt, enter a beginning column number and a delimiter (space or comma) and an ending column number.

The delineated columns are highlighted when ENTER is pressed. Exit Column Freeze to see the specified segment displayed.

Shows line numbers along the left-hand side of the page, offsetting the text by eight positions. Toggle F2 again to deactivate.

Removes highlighted columns from the report display that was added with Add Segment.

ElectroPage Administrator’s Reference Guide 64

Nobix

Chapter 4 The STATUS Program

Key

F4 Show Columns

F6 Exit Column Freeze

F6 Exit Freeze

Description

Displays numbers in increments of ten, at the bottom of the screen, indicating the column numbers.

Toggles the buttons back to the Head/Col Freeze functions.

Toggles back to the report viewing screen functions.

Miscellaneous keys F6

When viewing a report, press F6-Misc Keys , to toggle the function button display to the following selections:

Name

Change Config

CopyTo PC FIle

Print by Page

User Key

Indexing

Prev Keys

Key

Description

Displays options for changing the report viewing configuration, as described previously in Viewer configuration options.

Saves a portion of a report to a PC file. HP e3000 files can be downloaded to

SheetMate or Monarch software packages

(or Notepad).

Paints screen dialog directly from the e3000 environment data

Can be configured as a user-defined key if you are using Reflection. Use the template

F4KEYXEQ.EXAMPLE

. The function button displays the label you specify.

Finds the index values that were defined by the Pattern indexing configuration, as

described in Chapter 3, “The CONFIGX

Program.”

Toggles the display back to the basic

Viewer functions

Copy to PC file F2

To use this feature, you must be in a Reflection environment. To save a portion of a report to a PC file, press F2-Copy to PC File . The Copy to PC File dialog box appears:

ElectroPage Administrator’s Reference Guide 65

Chapter 4 The STATUS Program

Enter the beginning and ending page numbers, select OKAY and press ENTER .

When the Save File dialog box appears, enter a filename and select Save. The file is then copied to your PC environment.

Print by page F3

To print a spoolfile from the e3000, press F3 Print by Page . The Print by Page dialog box appears:

Nobix ElectroPage Administrator’s Reference Guide 66

Chapter 4 The STATUS Program

Nobix

Enter values in each of the available fields for Print by Page as described below:

•

Local printer or system spooler —enter an L to specify a direct printer connection or printing via a network connection; or enter S to send the file back into the e3000 spool system, for printing.

•

Send init escape sequence if system spooler —enter an N if a laser printer is not being used and initialization sequences do not need to be sent.

•

Keep HP2680 ENV file data if system spooler —if the file was originally spooled to an

HP2680 printer, enter a Y to keep the original 2680 commands, or an N to strip them out before printing.

•

Portrait or landscape —enter a P or L to specify either a vertical or horizontal paper orientation, respectively.

When specifying orientation and pitch, there is an option to specify Landscape, Portrait or Compressed (see next item).

•

Compressed or default print pitch —enter a C or D to specify the horizontal measurement of the number of characters per linear inch.

If a compressed font is already configured in the printer, the default and compressed print pitch will produce the same result.

ElectroPage Administrator’s Reference Guide 67

Chapter 4 The STATUS Program

•

:FILE command for system spooler destination —in an e3000 environment, enter the

MPE :FILE command that the file is to be printed to.

•

Add a value range for the beginning and ending pages in the fields provided.

If you are using Reflection, before processing this configuration, activate the print bypass feature to prevent any ESC sequences from being processed. To do this, from the Terminal menu, select Printer. The Print Setup dialog box appears:

Nobix

Check the Bypass Windows Print Driver option and then tab to OK and press ENTER .

Optionally, from the menu at the top of the Reflections window, select File. Select the Print

Setup command. Highlight or mark the Bypass Windows Print Driver option. Also, highlight or mark the Disable Printer Translation option. Deselect (uncheck) the Auto Form Feed option.

In the Print by Page form, tab to OK , and press ENTER to process the printing configuration for the current job.

Indexing F5

To find a previously defined index value, press F5 Indexing . A list appears that shows the word, line, and column entries of any index values in the report currently being viewed.

ElectroPage Administrator’s Reference Guide 68

Chapter 4 The STATUS Program

Nobix

The indexes will be numbered (at the top of the list box), in relation to how many indexes a particular report has. The index name, next to the index number, has been previously defined in the in the Description field of the Pattern Indexing configuration, as detailed in

Chapter 3, “The CONFIGX Program.”

To find a value in the report, highlight the index entry in the list and press ENTER . The cursor locates that column and line in the report.

If a report has more than one configured index, press F1-Switch Index to toggle the display to the other index lists (i.e., Index #1, Index #2, etc.).

If an index list is particularly long, press F3-Go To Value , which prompts for a value range and quickly accesses the specified range, as shown below using the example Index #1 Account

Number :

ElectroPage Administrator’s Reference Guide 69

Chapter 4 The STATUS Program

At the bottom of the index list, in the Enter Search Value field, type the desired word, line and column (with a space between each entry) and press ENTER ; the specified value range is highlighted.

Select F8-Exit Index to return to the Miscellaneous Keys function buttons.

Note:

To re-index a report that has been previously indexed, use the JPAKCOM command,

REINDEX.

(Go to Chapter 5, “The JPAKCOM Program,” for more information.)

Nobix ElectroPage Administrator’s Reference Guide 70