|
| |
ANYWHERE.DOC Thu 08-27-1998
INTRODUCTION: pcANYWHERE is a reg Trademark of Symantec Corp
StockTrac v5.0 will now support pcANYWHERE32 in WIN95/98 systems. This communications package is not for use on a non-win95 network. This introduction gives a brief explanation of the minimum
requirements needed to implement this program on your systems. In addition, a few comparisons to the older (dos driven) CLOSEUP communications package are presented.
v5.0 Configuration
Note that C:\STCKTR50 is the REQUIRED StockTrac directory. While this program MAY function from another directory, several file/path names are "hard coded" into the script file which means that this program requires access to the directory. The condition where C:\STCKTR50 is not the operating directory "may cause unexpected results". In 5.0, you need a master menu with a rev. date of no earlier than 2-10-1998. The Intershop Communications program (JSI010) must also post date 2-10-98. This version of the programs will honor a "3" in misc-flag[42], the task scheduling flag. This flag forces the above programs to deal with pcANYWHERE rather than CLOSEUP issues. You can set the flag to a "3" with an older JSI001, but to no avail. Set the flag to "3" in CONFIG if your JSI001 is more recent than 2-10-98. You also need a JSI010.EXE of similar vintage .
Intershop Communications Requirements
You still need fetch/send setup. You still need a phone list, and you still need the remote group number set to "1" or "2"; same as for
the old CHOST program. The shop ph.# in the list is NOT used, but other phone list data, and the sequence is used. The phone number gets set later in the properties of the shop-x icon. More on that later. Dont forget to set the group number as appropriate in config's specific shop information screen if you're using remote inventory. The Path and file names in fetch/send are still used and have a more restricted range of configurations than were allowed with
CLOSEUP. In the FETCH/SEND config., you need to remove any existing file name on the destination line if the source file specification has a wildcard in it. See the following
example:
SOURCE: C:\STCKTR50\MMDD?002.DAT Y
DESTIN: C:\STCKTR50
The following example can be done either way:
SOURCE: C:\STCKTR50\CLOCK002.DAT Y
DESTIN: C:\STCKTR50
or
SOURCE: C:\STCKTR50\CLOCK002.DAT Y
DESTIN: C:\STCKTR50\CLOCK002.DAT
Task Scheduling
Here are the typical three lines in StockTrac task scheduling that control the timing of daily intershop communications. They are no
different than those set up for close-up. The third line is needed only if the remote inventory feature is active at the shops.
PERIODIC-.MTWTFS 21:00 SUPPORT_ DAILY.TSK CREATE
PERIODIC-.MTWTFS 21:01 SUPPORT_ DAILY.TSK
PERIODIC-.MTWTFS 22:01 REMOTE__ SEND_REPORTS
This fourth typical line is a handy task file line to bring the accounting date to "today" at midnight, but not a requirement.
PERIODIC-SMTWTFS 23:55 ACNT_DAT
In addition to the above StockTrac v5.0 (HUB=REMOTE)
requirements. You must install the pcANYWHERE32 program and configure it on the hub, and install/configure it on each shop=host computer (server if network). These considerations are dealt with below.
Files Involved
There are six files required in the C:\STCKTR50 directory to support this feature, including the file which your are reading.
ANYWHERE.SCX
ANYWHERE.BAT ANYWHERE.DOC ANYWHERE.COD
ANYTIME.BAT ANYPLACE.BAT
Once you perform file transfers via task scheduling, you may notice that other files are created. These files (listed below) are
temporary in nature.
TASKFILE.DAT ANYWHERE.TSK ANYWHERE.LOG
The ANYWHERE.SCX file is a script file used to drive pcANYWHERE32. It is the file referred to here-in as "this program" . It reads a control file (anywhere.tsk) to determine what files to transfer to and from which shops. In the process, it creates a log file
(anywhere.log). The task scheduling portion of StockTrac v5.0
is responsible for determining the contents of anywhere.tsk based on the Intershop Communications - configuration setup by the user. It is the "daily task file - create" that actually reads this config.
data. See the three line of task scheduling below.
The ANYWHERE and ANYTIME batch files are driven automatically by task scheduling and intershop communications when misc-flag[42] is set to "3" as mentioned above.
The ANYPLACE batch file provides StockTrac v5.0
PRINTING CAPABILITY of the log file (c:\stcktr50\ANYWHERE.LOG). This batch file is run automatically after all shops have been called. It prints its own 3-line header first, then the contents of the task file
(taskfile.dat). Next it prints another of its own 3-line headers followed by the contents of the specific anywhere control file
(anywhere.tsk) which is created daily by the "daily task create" task. Next another 3-line header is printed which is followed immediately by the contents of the log file(anywhere.log). This gives a good overall picture of what the user has specified to do, what
StockTrac did, and what this program did, and the basic results of these operations.
Each fetch/sent operation is entered into the log by this program, and each of these printed lines is terminated with a number. A small number (0 - 200 or so) represents the number of files transferred in that single operation. A value of less than zero (negative number) represents a detected unusual issue, or condition, or event.
Condition Codes
The following numerically coded NORMAL conditions concern the control flow within this script
program (anywhere.scx). These codes can serve to isolate an issue when used in context of the printed information created/printed by anywhere.scx. There are 10 "send" variables and 10 "receive" variables. These (20) variables correspond to Fetch/Send specifications in
StockTrac Config. (Intershop Communications) They indicate the following conditions which are all "normal" for a certain period of time during script operation. These values get updated as control progresses indicating the current state of the communications within the program. Sometimes, an event may occur which leaves one of these values at the end of a log-line. It is safe to say that IF one of these values appears in the log, THEN the requested file transfer was NOT successful.
1000 - An initial value of each control variable (20) indicating that the script has begun, and initial conditions have been set.
2000 - The program has read the control file (anywhere.tsk) and determined which files are to be "fetched" and which files
are to be "sent". Up to ten fetch specifiers and up to ten send specifiers can be set up in
StockTrac-Intershop Comm. -
Configuration screens. Wild card characters (*,?) are allowed in
StockTrac-I.S.-Config. as are MMDD "current date" file
specifiers. It is the obligation of StockTrac to convert the "MMDD" file specifiers to numeric values. It is the job of
PC-AW to deal with the other (*,?) wild card chars. This program does not actually know which files transfer. It does
note how many files of each file specification get transferred. This information is entered/printed in the log file(anywhere.log).
The rightmost 2 digits xx01-xx10) in the following values represent which
StockTrac config. variable is being referenced (1 - 10).
The second digit (x0xx, x1xx) indicates FETCH(0) and SEND(1) operations respectively.
3001 - 3010 - This program (remote) is preparing to RECEIVE files FROM the shop (host) ie FETCH. It is waiting for carrier detection. Note that a fetch is actually a "host send" operation. The last 2 digits tell which of ten file specifiers is affected.
3101 - 3110 - This program (remote) is preparing to SEND files TO the shop (host). It is waiting for carrier detection.
This is a "remote send" operation. The last 2 digits tell which of ten file specifiers is affected.
3061 - 3070 - This program is waiting for the relavent FETCH operation to complete.
3161 - 3170 - This program is waiting for the relavent SEND operation to complete.
Setup: Remote (HUB)
APPLICATION OPTIONS: (pcANYWHERE screen) Click on the "File" menu item and then select "Application Options".
On the "File Transfer" tab you will find the "Download Folder" window. Set this to "C:\STCKT50\". Then select the "settings" option, and find the "DownLoad Timeout " setting. Set this to 30 seconds; and then "APPLY" these changes. Failure to set the path here will prevent pcANYWHERE from properly storing files fetched via tasking in 5.0.
Create Shop Icon
Use the "Add Remote Control Item" icon to create a control item. This selection will ask you to enter a new name for the item. Enter "Shop 1" as an example... and click "next". Select the default modem. If it's wrong, change it later. Click on next. UnCheck the "auto run ..." check box. Click on finish. Use this same scheme to create control items for all shops to be called. The order is not
important except for your own sanity when you look at the icons. You can move them later... The names for these icons is VERY SIGNIFICANT. The names must be as described above. "Shop 1" ... "Shop 99". If not, they can be fixed later. There is no room for creativity here.
Setup Phone Number For Shop
Right Click the "Shop 1" icon, and then left click the PROPERTIES item. Select the proper modem. Click on "details", and make sure that the baud rate (Max speed) is correct and that the COM port is right. If in doubt about speed, select 19200. It will likely work... The com port is likely correct, verify it if you can. Then click on the CONNECTION tab, and make sure that you have (from top to bottom) "8", "None", "1". The CALL PREFERENCES should be : Wait-Chk, Cancel-Chk, Disconnect-No .
If you are using USRobotics modem, click on "Advanced", and make sure you have just "Use Error Control", "Compress Data" ; "Use Flow Control", and "Hardware" Marked. Modulation is "Standard" and dont record a log file. Click on OK. Click on "Options" tab. The only "Check mark" should be on "Display modem status".
Click on the Settings Tab. Make sure that the description reads "Shop 1" (or the current shop selected), and that there is a bullet in
"Use Manually...", and that the shop phone number is in the phone # box. If switchboard lead-in or area codes are required to make the modem call, these numbers should all be placed here. Use dashes in the normal manner. Under "Connection Options" start with "Attempts = 3" and "Seconds = 5" for the time between retries.
Click on the "Automated Tasks" tab. Insure that there are no checks here. Click on the "Security Options" tab. This should show "pcANYWHERE" in the first window, with the other two windows blank. Click on the "Protect Item" tab. This screen should have no password.
That's about it for setting up a single icon at the hub (remote) for later use by task files. You need as many of these icons as there
are shops to be called.
To make a manual call to a shop using one of these icons, you simply double click on the icon, then click on the "load file transfer"
button which will appear along with several others. Once you have the file transfer program loaded, you select the source and target
directories as shown on each half of the screen. After this, you simply "drag and drop" files as you want. The files are automatically
sent to the selected target computer (host/shop or remote/hub).
Properties (Summary)
Connection Info Tab ... (verify settings as in text above)
Settings Tab ... (verify name "Shop 1", verify phone num)
Automated Tasks Tab ... none
Security Options Tab ... none
Conference Tab ... none
Protect Item Tab ... none
Setup Host (Shop)
Install pcANYWHERE32 Version 8.0 or later at the shop. Accept normal default settings. Double click the pcANYWHERE ICON on the desktop to get into the program. Select "BE A HOST PC" button. Use the "Add Be A Host PC Item" icon to create a connection item. This selection will ask you to enter a new name for the item. Enter "Wait for Hub" as the name for the connection item. This is somewhat different than a standard "modem" connection item (or it can be). Click on "Next". Select the appropriate modem. Then click on details. Under the "General" tab... verify the COM port is correct. Set speaker volume as desired. Set Modem speed to 19200 or to a known higher or lower value. Normally 19200 is good to use. Click on the Connection tab. Verify that you have "8", "None", "1"; check mark on "Wait..." , check mark on "Cancel..." , and no check on "Disconnect..." Click on the "Advanced" button and verify that "Use Error Control", "Compress Data" are checked. Verify that "Use Flow Control","Hardware"
are checked/marked. Make sure that "Record a Log file" is NOT checked.
Click OK.
Clink the Options tab and verify that only "Display modem status" has chk.
Click OK.
Click "Next".
Uncheck the Auto Launch box. Click on "Finish".
Observe that you have a nice ICON labeled "Wait for Hub" .
Final Settings
Once you have done the above steps... or something similar, you can right click your "Wait for Hub" icon, and then click on "Properties" to verify that various settings are correct. The following conditions have been set up for a USR Sportster 14400 modem. Your actual settings may vary somewhat... These are provided for reference should you want to settle an issue.
Connection Info Tab
Sportster 14400 Fax PC Plug & Play
Details
General Tab
COM2, Medium Volume, 19200
Connection Tab
8 , None , 1 (3 separate screen line items)
Chk - Wait ...
Chk - Cancel...
Port Settings
Low , Low (2 separate screen line items)
Advanced
Chk - Use Error Control
Chk - Compress Data
Chk - Use Flow Control
dot - Hardware
Standard Modulation
No Chk on Record a log file
Options Tab
Chk - Display Modem Status
Settings Tab
Host Startup ... Chk - Run Minimized
Wait for ZERO (0) minutes
dot - Wait for call
Callback delay - 10 seconds
Keyboard & Mouse Active at Host and Remote
End of Session ... dot - Wait for call
Callers Tab
dot - allow full access to all callers
Security Options Tab
Login Options
Limit Login Attempts ... Max 3 attempts
Limit Time to complete login 1 minutes
Conference Tab
none
Protect Item Tab
none
The following list of numbers and conditions is maintained in a separate file (anywhere.cod) so that it can be printed as an addendum to the daily transfer log if any unusual issue is detected during the file transfer.
Printing is controlled by the "anyplace.bat" file. If some custom printing is needed, you may modify this batch file to print more information as you choose. If you do modify the "anyplace.bat" file, it is best to keep a "manual backup copy" of the file so that if you receive a new "anyplace.bat" file from JANCO, you will have access to your prior mods, as they will need to be made again.
Numeric Messages from (pcANYWHERE-32 ) / ANYWHERE.SCX (Windows)
Value Issue of Concern (abnormal values)
(anywhere.cod)
-1 Operator Intervention/Termination
-4 Timeout Value Expired
-6 Out of Resources (Windows)
-7 Disk Write Error
-8 File Not Found
-9 File Create Error
-11 Not Enough Memory for Requested Operation
-12 End of File (unexpected end)
-15 A Connection Could not be Established
-18 Invalid Path or Invalid File Number
-19 File Already Exists
-20 Invalid Path Specified
-23 Transfer Error; AWSEND not running or not background file xfer
-26 Former Connection Still Active
-29 Calls Nested too Deeply
-30 Invalid Script File
-32 Directory Entry not Found
-33 Unable to Access File/Device
-34 Data out of Bounds (too large)
-35 GoSub/Return Nesting Error.
-36 Invalid Number of Parameters
-37 Invalid Parameter Type
-38 Invalid Parameter Value
-39 Invalid Arithmetic Expression
-40 Too Many Open Files. (max 9)
-42 Global Variable Redefine...
0 - 200 Normal values. The number of files transferred.
1000 - 3200 Normal values. See CONDITION CODES for explanation.
Revised January 11th, 2000
Copyright � 2000 by:
Janco International, Incorporated
All Rights Reserved Worldwide
StockTrac� EZCards�
and TechLink� and are registered
Trademarks of Janco International, Inc.
All Rights Reserved Worldwide
|