Information Technology Services

Basic AppWorx Instructions for Testing - Preproduction UGVAL3

With the move from VMS to UNIX, UNCG discovered that we would no longer have the Banner queue structure which existed in VMS, and that job scheduling would require code intensive script creation. In an effort to provide those same features, AppWorx was purchased and installed.

All Banner users will need to view job submission output via either the Banner GJIREVO form or through the AppWorx client. Once AppWorx has been enabled in the Pre-Production (UGVAL3) environment, the first time a user successfully runs a Banner job through the Banner Job Submission process, a base AppWorx login will be created. This login will use the same Banner user name and Banner password as the one required for the job just run and will allow the user to view, print, or download the job output for the requested jobs. The user will also be able to print or save the output to his/her local machine or the network. Additional AppWorx permissions will be determined and granted at a later date.

Instructions for Installing and Accessing AppWorx

1. Open an Internet Browser window. AppWorx recommends:
   • Internet Explorer 5.x or higher for Windows XP, Windows 2000, NT, and Windows 98
   • Netscape 4.x or higher for Solaris, Windows XP, 2000, NT, and Windows 98
2. Go to the Banner Student Information System. On this page, you will find helpful information regarding Banner.
   
3. Under the AppWorx heading, choose the Pre-Production AppWorx Client (UGVAL3) link. The following window will appear:
   
   
   
   
4. Select the Start the AppWorx Client link under Java WebStart. The Java Plugin was for backwards compatibility to a prior version of AppWorx and will not be needed at UNCG.
   
5. If this is your first time accessing AppWorx, you will receive the following dialog box:
   
   
   
   
6. Click on Start. This will bring up a second dialog box:
   
   
   
   
7. Click on Install. When the processing has completed, a login window similar to the following window will appear:
   
   
   
   
8. Enter your Banner User Name and Password for the database where you just ran Banner Job Submission.
   NOTE: After several logins to AppWorx, you may be prompted to create a shortcut on your desktop which will bring up the login screen directly. Feel free to create the shortcut.
   
9. Upon successful login, you will see a window similar to the following window:
   NOTE: Do not change the Master or Language Values.
   
   
   
   
10. The window above is the main AppWorx window. By default, the Explorer will run and allow you to view other windows within AppWorx. When your job is complete, it will be listed in the bottom half of the window under History. If your job is still running, select the Backlog option from the Explorer tree on the left to show the job in the top half of the window.
    The following window is an example of a Backlog entry for a job that has not yet completed.
    
    
    
    
11. Select the job you want to view by double-clicking it. A window similar to the following will appear.
    
    
    
    
12. Choose the Output tab. A Job Details window similar to the one below will open.
    
    
    
• For any standard Banner job, the following AppWorx output files will exist:
  • oAppWorxJobID.number  - AppWorx specific information.
    NOTE: This number will increment if there are several non-successful runs of the job.
  • Jobname_oneup.lis – the standard lis file you would expect to see in the database or in the old banner_uservol directories on VMS.
  • Jobname_oneup.log – a fairly sparse log file. Generally it contains the message that the job completed successfully, gives you the name of the generated lis file, and tells you that it connected.
• For any non-standard Banner job, the additional files will also be available in this view and named according to the code specifications.
13. To view the files, you can either double-click on the appropriate entry or highlight the entry and select the View button.

The following two windows show an example of the AppWorx and lis files produced:

Also on this Output window, there are icons for further working with the files:

1. Print – Prints the document to the default printer you have set up in Windows. There is some formatting work that still needs to occur in order for this printing to work.  For now, please specify a printer in the printer option of the Job Submission form, or save the file to your desktop and print it.
2. PrintPreview – Allows you to change page setup options, format fonts and font sizes, and print these to your default. These changes are only applicable when printing from your default Windows printer.  
3. System Print – Allows you to designate and print from a network printer that has a UNIX print queue defined. If your job has special printing requirements where default Windows printing will not work, contact ITS to request that you be assigned rights in AppWorx to a UNIX print queue enabled printer within your department.
4. FTP – This is actually a Save to your desktop feature. It allows you to specify a destination folder on or accessible to your local machine and save the output. The default is your C:/drive, but you can navigate the directory structure.  

The following screenshot shows an example of selecting an alternate directory in which to save the file:

• Select Save and as long as you have Write permissions to that directory, your output will be saved.
• When you have finished viewing the output, you should close the window using the X in the top right corner. If you do not close the window, others will stack on top of it. There is no need to log out of AppWorx and log back in each time you wish to view new output. The Explorer Window refreshes itself every ten seconds.
• To exit AppWorx, click on the File pull-down menu and select Exit, or click on the X in the browser window.