Difference: BackgroundProcessing (7 vs. 8)

Revision 82013-07-24 - AlKalter

Line: 1 to 1
 
META TOPICPARENT name="APPXAdministrator"

APPX Background Processing on a Windows Server

Added:
>
>
 This document will demonstrate the setup of APPX background processing when APPX is installed on a Windows server.

Overview

Line: 16 to 19
 

Steps

APPX Designer

  • Modify the JOB's OUTPUT process type to have Separate Task (Sep. Task) checked as shown in the figure below.
Changed:
<
<
  • JOB-OUTPUT-001.gif
>
>
  • JOB-OUTPUT-001.gif
 

APPX Server

Changed:
<
<		If all you wish to do is submit an APPX JOB's OUTPUT process to the background, you do not need to set the APPX_BG_SCRIPT environment variable, nor do you need to have an appx_submit.cmd batch file. If however you wish to take specific action based on one of the arguments APPX passes to the appx_submit.cmd script , then you should set APPX_BG_SCRIPT=appx_submit.cmd and create an appx_submit.cmd file that can act on the 8 argument pairs that are past. They are (-image, -session, -mode, -notify, -date, -priority, -queue, and -user) These configuration files (appx.env file containing APPX_BG_SCRIPT environment variable, and appx_submit.cmd batch script) need to be placed on the APPX Windows server.
>
>		 If all you wish to do is submit an APPX JOB's OUTPUT process to the background, you do not need to set the APPX_BG_SCRIPT environment variable, nor do you need to have an appx_submit.cmd batch file. If however you wish to take specific action based on one of the arguments APPX passes to the appx_submit.cmd script , then you should set APPX_BG_SCRIPT=appx_submit.cmd and create an appx_submit.cmd file that can act on the 8 argument pairs that are past. They are (-image, -session, -mode, -notify, -date, -priority, -queue, and -user) These configuration files (appx.env file containing APPX_BG_SCRIPT environment variable, and appx_submit.cmd batch script) need to be placed on the APPX Windows server.
 

The appx.env file.

Changed:
<
<		The appx.env file is a file that is referenced by all appx processes. The file contains environment variables that you want to be present for APPX sessions. Any line that starts with # is a comment line and is not used by APPX. The other lines have a syntax of VARIABLE=VALUE, where VARIABLE is an environment variable such as APPXPATH, and VALUE is the text that you want to assign to the variable, such as C:\Appx\Data. Here is an example appx.env file.
>
>		 The appx.env file is a file that is referenced by all appx processes. The file contains environment variables that you want to be present for APPX sessions. Any line that starts with # is a comment line and is not used by APPX. The other lines have a syntax of VARIABLE=VALUE, where VARIABLE is an environment variable such as APPXPATH, and VALUE is the text that you want to assign to the variable, such as C:\Appx\Data. Here is an example appx.env file.
 
Changed:
<
<
###############################################################################
>
>
###############################################################################
 # # APPX Configuration File # -----------------------
Line: 135 to 137
 #APPX_KEATERM=NoButtons

#=============================================================================

Changed:
<
<		# SCRIPTING & REGRESSION TESTING CONFIGURATION SECTION
>
>		# SCRIPTING & REGRESSION TESTING CONFIGURATION SECTION
 #=============================================================================

# APPX_SCRIPT_OUT will record all enduser keystrokes (and selected

Line: 248 to 250
 # #APPX_UNIXIO_STATS=/tmp/file_stats #APPX_UNIXIO_PROCS=1
Changed:
<
<
>
>
 
  • Place the following inside your appx.env file, which should be in %APPXPATH or C:\Appx\data\appx.env
Changed:
<
<
APPX_BG_SCRIPT=appx_submit.cmd
>
>
APPX_BG_SCRIPT=appx_submit.cmd
 

The appx_submit.cmd Windows batch file

Added:
>
>
 The appx_submit.cmd file is a Windows batch file that you can parse the 8 argument pairs that APPX passes it.
  • The appx_submit.cmd command should contain
Line: 264 to 264
 
  • The appx_submit.cmd command should contain
Changed:
<
<
::APPX_SUBMIT.CMD
>
>
::APPX_SUBMIT.CMD
 :: A Typical Argument list will be 8 Arguments passed from APPX :: -image, -session, -mode, -notify, -date, -priority, -queue, and -user :: Windows will break on the equals sign giving us 16 arguments in total
Line: 303 to 302
 ::

%2 %3=%4

Changed:
<
<
>
>
 

APPX Run Time

  • On the JOB's output disposition screen select SUBMIT to BG.
Changed:
<
<
  • JOB-OUTPUT-002.gif
>
>
  • JOB-OUTPUT-002.gif
  • NOTE: If you do not wish to present a Disposition screen, you can specify background processing in ILF code:
    • SET --- SUBMIT PROCESS = Y
 

Bugs:

Changed:
<
<
  1. Fixed - Bug Description 1.
  2. OPEN - Bug test - Test bug. Not valid.
>
>
  1. Fixed - Bug Description 1.
  2. OPEN - Bug test - Test bug. Not valid.
 

Comments:

Added:
>
>
 Read what other users have said about this page or add your own comments.
Changed:
<
<
<--/commentPlugin-->
-- JoeOrtagus - 10 Mar 2009
>
>		 
<--/commentPlugin-->
-- JoeOrtagus - 10 Mar 2009
 
META FILEATTACHMENT attachment="JOB-OUTPUT-001.gif" attr="" comment="JOB OUTPUT - Notice the Sep. Task value is checked." date="1236715995" name="JOB-OUTPUT-001.gif" path="JOB-OUTPUT-001.gif" size="39785" stream="JOB-OUTPUT-001.gif" user="Main.JoeOrtagus" version="2"
META FILEATTACHMENT attachment="JOB-OUTPUT-002.gif" attr="" comment="JOB OUTPUT - Notice Submit to BG button" date="1236716030" name="JOB-OUTPUT-002.gif" path="JOB-OUTPUT-002.gif" size="24911" stream="JOB-OUTPUT-002.gif" user="Main.JoeOrtagus" version="1"
View topic | History: r11 < r10 < r9 < r8 | More topic actions...
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback