Organizing $STDLISTs under Folders
Introduction

This document outlines how to organize your $STDLISTs into ElectroPage folders. This may be accomplished with or without an ElectroPage license. ElectroPage is used to process non-$STDLIST reports. The folder organizations available in the Status program and in the Windows Nobix Viewer may be utilized by both JobRescue for $STDLISTs and ElectroPage for reports.

Background

Folder organizations are defined in the CONFIGIX.JPAK.NSD program and stored in the NSD account as part of the JobPak configuration.  In this document, the term spoolfile refers to any file contained in the HP3000 spool system, no matter the name of the file or how it was created.  The term $STDLIST refers only to spoolfiles that are the standard output of a job.  The term report refers to any spoolfile that is not a $STDLIST.  Folders may contain both sub-folders and spoolfiles.  There is no limit to the number of folder levels that you can define.

Spoolfiles are displayed under folders using a pattern match that you configure.  The default condition is that $STDLISTs are not accepted as part of the pattern.  This ensures that ElectroPage users do not see $STDLISTs intermixed with their saved reports, simply because the same pattern matches both the $STDLIST and a variety of reports.  To have $STDLISTs appear under folders, the spoolfile name matching pattern must explicitly state $STDLIST instead of a wildcard.

This document does not discuss folder and report security.  If specific access lists are not defined, then the default Status security is used for folders.  For more information about access lists, see the ElectroPage Admin Guide.

Setting up folders

To set up folders in JobPak, perform the following steps
  1. Sign on as MGR.NSD using an HP terminal or HP terminal emulator
  2. Enter the command:

        CONFIGIX.JPAK

    This runs the JobPak configuration program.  Please Note: there are two types of screens in this program.  The screen currently before you is the menu selection type.  On this type of screen you may use the arrow keys to highlight an item and the enter key to select that item.  On subsequent screens you will see the field entry type of screen where you are allowed to type information into fields on the screen.  On the field entry type of screen DO NOT USE THE ARROW KEYS.  Using the arrow keys on field entry screens tends to "mess up" the display, and you'll lose track of where you are.  On field entry type of screens use the TAB key to transition from field to field, and use the enter key to save the data when the "ok" button is highlighted.

  3. As you are now on the first selection dialog, use the arrow keys to move the highlighted bar down to "Configure FOLDER Organization".  Then use the enter key to select this item in the list.


    4. The dialog before you displays the current folder defintions. There may or may not be any information displayed.
  4. Press the F1 function key to add a new folder.  The bottom part of the display will now show entry fields.  DO NOT USE THE ARROW KEYS.
  5. Enter a "Y" in the "TopLvl?" field.  The cursor will automatically transition to the "Name" field.
  6. Enter a descriptive folder name in this field, such as "$STDLISTs".
  7. Use the TAB key to highlight the OKAY button.  Then press enter. 


    8. The new folder will now be displayed in the list. You will now create a sub-folder.
  8. Using the arrow keys, ensure that the new folder is highlighted. Press the F1 key.
  9. Enter a "N" in the "TopLvl?" field.
  10. Enter a sub-folder name in the "Name" field, such as "SYS" and press the TAB key to highlight the OKAY button.
  11. Press the enter key to save the new sub-folder. The new sub-folder "SYS" will display indented below the "$STDLISTs" top-level folder.
  12. Using the arrow keys, ensure that the "SYS" subfolder is highlighted.  Press the F2 "Add Report" function key.


    13. The display changes to allow entry of five fields.  None of these fields are labeled.  They are not labeled because, well, I don't know.  However, the fields are the matching patterns for (in order) spoolfile name, job/session name, user name, account name, spooled device.  Spoolfiles stored by JobPak (JobRescue or ElectroPage) are then matched against these patterns for display purposes.  As stated above, in order to have a $STDLIST match to a folder, the spoolfile name must contain the text "$STDLIST", a wildcard match will not work.
  13. So, in the first field enter the text "$STDLIST".  (don't enter the quote characters)
  14. In the second field enter a single "@".
  15. In the third field enter a single "@".
  16. In the fourth field enter the text "SYS", as in the SYS account on your system.
  17. In the fifth field enter a single "@".  This last field is the device the original $STDLIST was spooled to.
  18. Then TAB to the OKAY and press enter to save it.


    19. You will now see the pattern match indented under the "SYS" folder.
    You are almost done. 
  19. Press the F8 key.  This takes you back to the main menu.
  20. Press the F8 key again. You are now prompted to save the configuration.
  21. Press the enter key twice, once on the Y and once on the OKAY. The configuration is now saved.

Viewing using STATUS
Run the STATUS program:

    STATUS.JPAK.NSD

Enter the command "REPORT".  This takes you into report viewing mode.

You should see the folders listed.  To open a folder, highlight it and use the enter key.  All of the $STDLISTs belonging to the SYS account should now be displayed under the SYS folder.  You may view an individual $STDLIST by highlighting it and pressing the enter key.

Viewing using the Nobix Viewer
After starting the viewer and connecting to the HP3000, select the "Folders & Reports" tab.  You should see your folder organizations in the left pane in a tree-view control.  Individual $STDLISTs and reports are viewed by double-clicking the entries in the right pane's listview control.