Unix Start Stop Maintenance
Unix Start Stop Maintenance
Unix Start/Stop Maintenance
Module: Utilities
Overview
SBN uses some Unix procedures to run processes in the background. You may view Unix procedures in /ir/ins/command_library. If you run two machines, IBS recommends that you start all processes on both.
.cmd files
The Unix procedure filenames include the server name and the extension .cmd. You may view the .cmd procedures in the /ir/iwork/process/directory.
Note: If a procedure does not have a file that ends in .cmd, the process is not active on the server. Even if the process appears to be running, it will stop without a .cmd file.
The following are examples of these files:
-
servername_MAALGEN1.cmd
-
servername_MAALGEN2.cmd
-
servername_MATOC.cmd
q Always run MATOC on both machines to prevent data contamination.
q MATOC resets if idle more than 90 minutes (option).
-
servername_BGCLEAN.cmd
q Always run BGCLEAN on both machines to prevent data contamination.
q BGCLEAN deletes passcards and low rows.
-
servername_RW_SCHEDULER.cmd
Unix Commands
Use the following Unix commands to start and stop processes.
erasereports
|
Usage: erasereports [keepdays] |
|
|
Erases old report from standard ibs report directory. |
|
|
Parameters: |
|
|
keepdays |
Number of days to keep reports. |
invoice_scheduler
|
Usage: server [user] [psw] [loop-delay] [file] |
|
|
Schedules a delayed invoice batch. |
|
|
Parameters: |
|
|
server |
Login server. |
|
user |
Username. |
|
psw |
Password |
|
loop-delay |
Loop time, in seconds. |
|
file |
Output default is the standard process file. |
start_bg_jobs
|
Usage: start_bg_jobs [server] [loop-delay] [file] |
|
|
Starts background cleaner. |
|
|
Parameters: |
|
|
server |
Login server. |
|
loop-delay |
Loop time, in seconds. |
|
file |
Output default is the standard process file. |
stop_bg_jobs
|
Usage: stop_bg_jobs [server] |
|
|
Stops background cleaner. |
|
|
Parameters: |
|
|
server |
Login server. |
start_billing_copytask
|
Usage: start_billing_copytask [source-server] [destination-server] [outfile] [delay] [id#] |
|
|
Starts billing copytask between machines. |
|
|
Parameters: |
|
|
source- server |
Source server. |
|
dest serv |
Destination server. |
|
outfile |
Outfile (normally /dev/null). |
|
delay |
Delay. |
|
id# |
Machine ID. |
stop_billing_copytask
|
Usage: stop_billing_copytask [source-server] [destination-server] [id#] |
|
|
Stops billing copytask between machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest server |
Destination server. |
|
id# |
Machine ID. |
start_concfron
|
Usage: start_concfron |
|
Starts UNIX-based Frontend. |
|
Variable CONCFRONPORT may be defined in /iconfig/ibsprof or in iconfig/start_sql_SERVERNAME. |
|
Example: CONCFRONPORT= tty,1200, o, 7, 1; export CONCFRONPORT |
Note: If CONCFRONPORT is not defined, the default is ttyb, 9600, n, 8, 1.
start_invoice_scheduler
|
Usage: start_invoice_scheduler [server] [loop-delay] [file] |
|
|
Starts invoice scheduler. |
|
|
Parameters: |
|
|
server |
Login server. |
|
loop-delay |
Loop time, in seconds. |
|
file |
Output default is the standard process file. |
stop_invoice_scheduler
|
Usage: stop_invoice_scheduler [server] |
|
|
Stops invoice scheduler. |
|
|
Parameters: |
|
|
server |
Login server. |
start_maalgen
|
Usage: start_maalgen [server] [loop-delay] [file] [gen#] |
|
|
Starts maalgen generator. |
|
|
Parameters: |
|
|
server |
Login server. |
|
loop-delay |
Loop time in seconds. |
|
file |
Outfile default is standard process file. |
|
gen# |
Algen # (default is 1). |
stop_maalgen
|
Usage: stop_maalgen [server] [gen#] |
|
|
Stops maalgen generator. |
|
|
Parameters: |
|
|
server |
Login server. |
|
gen# |
Algen # (default is 1). |
start_ma_dataentry_copytask
|
Usage: start_ma_dataentry_copytask [source-server] [destination -server] [outfile] [delay] [id#] |
|
|
Starts data entry copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest- server |
Destination server. |
|
outfile |
Outfile. |
|
delay |
Delay. |
|
id# |
Machine ID (default is 1). |
stop_ma_dataentry_copytask
|
Usage: stop_ma_dataentry_copytask [source-server] [destination-server] [id#] |
|
|
Stops data entry copytask. |
|
|
Parameters: |
|
|
source-server |
Source server. |
|
dest-server |
Destination server. |
|
id# |
Machine ID. |
start_ma_monitoring_copytask
|
Usage: start_ma_monitoring_copytask [source-server] [destination-server] [outfile] [delay] [id#] |
|
|
Starts monitoring copytask between two machines. |
|
|
Parameters: |
|
|
source-serv |
Source server. |
|
dest-serv |
Destination server. |
|
outfile |
Outfile |
|
delay |
Delay |
|
id# |
Machine ID (default is 1). |
stop_ma_monitoring_copytask
|
Usage: stop_ma_monitoring_copytask [source-server] [destination-server] [id#] |
|
|
Stops monitoring copytask between two machines. |
|
|
Parameters: |
|
|
source-serv |
Source server. |
|
dest-serv |
Destination server. |
|
id# |
Machine ID (default is 1). |
start_marketing_copytask
|
Usage: start_marketing_copytask [source-server] [destination-server] [outfile] [delay] [id#] |
|
|
Starts marketing copytask between two machines. |
|
|
Parameters: |
|
|
source-serv |
Source server. |
|
dest-serv |
Destination server. |
|
outfile |
Outfile (normally /dev/null). |
|
delay |
Delay |
|
id# |
Machine ID. |
stop_marketing_copytask
|
Usage: stop_marketing_copytask [source-server] [destination-server] [id#] |
|
|
Stops marketing copytask between two machines. |
|
|
Parameters: |
|
|
source-serv |
Source server. |
|
dest-serv |
Destination server. |
|
id# |
Machine ID (default is 1). |
start_ma_service_copytask
|
Usage: start_ma_service_copytask [source-server] [destination-server] [outfile] [delay] [id#] |
|
|
Starts service copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest-server |
Destination server. |
|
outfile |
Outfile. |
|
delay |
Delay. |
|
id# |
Machine ID (default is 1). |
stop_ma_service_copytask
|
Usage: stop_ma_service_copytask [source-server] [destination-server] [id#] |
|
|
Stops service copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest-server |
Destination server. |
|
id# |
Machine ID. |
start_ocmonitor
|
Usage: start_ocmonitor [server] [loop-delay] [file] |
|
|
Starts open/close monitoring. |
|
|
Parameters: |
|
|
server |
Login server. |
|
loop-delay |
Loop time in seconds. |
|
file |
Outfile default is the standard process file. |
stop_ocmonitor
|
Usage: stop_ocmonitor [server] |
|
|
Stops open/close monitoring. |
|
|
Parameters: |
|
|
server |
Login server. |
start_paging_scheduler
|
Usage: start_paging_scheduler [database] [server] [user] [psw] [intval] [ofile] |
|
|
Starts the paging scheduler. |
|
|
Parameters: |
|
|
database |
Database to use. |
|
server |
Server. |
|
user |
User ID (optional). |
|
psw |
User password (optional). |
|
intval |
Time in seconds the scheduler sleeps (optional). |
|
outfile |
Outfile (intended for /dev/null). |
Note: You must define the environmental variable IBS_PAGING before you start the paging scheduler. This variable defines the directory in which paging files are stored. You may either type this variable as export IBS_PAGING=/directory path or include this variable in the normal setup configuration.
stop_paging_scheduler
|
Usage: stop_paging_scheduler [server] |
|
|
Stops the paging scheduler. |
|
|
Parameters: |
|
|
server |
Login server. |
start_rw_report_scheduler
|
Usage: start_rw_report_scheduler [database] [server] [user] [psw] [intval] [maxj] [kdays] [ofile] [mask] |
|
|
Starts the RW report scheduler. |
|
|
Parameters: |
|
|
database |
Database to use. |
|
server |
Login server. |
|
user |
User name (optional). |
|
psw |
User password (optional). |
|
intval |
Time in seconds the scheduler sleeps (optional). |
|
maxj |
Maximum concurrent reports (optional). |
|
kdays |
Keep days (optional), (intended for /dev/null). |
|
ofile |
Outfile (optional). |
|
mask |
Types to submit: l % = All l X = Jam |
stop_rw_report_scheduler
|
Usage: stop_rw_scheduler [server] |
|
|
Stops the RW report scheduler. |
|
|
Parameters: |
|
|
server |
Login server. |
start_schedule_copytask
|
Usage: start_schedule_copytask [source-server] [destination-server] [outfile] [delay] [id#] |
|
|
Starts schedule copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest-server |
Destination server. |
|
outfile |
Outfile (normally /dev/null). |
|
delay |
Delay. |
|
id# |
Machine ID (default is 1). |
stop_schedule_copytask
|
Usage: stop_schedule_copytask [source-server] [destination-server] [id#] |
|
|
Stops schedule copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest-server |
Destination server. |
|
id# |
Machine ID. |
start_skill_monitor
|
Usage: $0 [loop-delay] [file] |
|
|
Starts skill monitoring. |
|
|
Parameters: |
|
|
server |
Login server. |
|
loop-delay |
Loop time in seconds. |
|
file |
Outfile default is the standard process file. |
stop_skill_monitor
|
Usage: $0 server [loop-delay] [file] |
|
|
Stops skill monitoring. |
|
|
Parameters: |
|
|
server |
Login server. |
start_workorder_copytask
|
Usage: start_workorder_copytask [source-server] [destination-server] [outfile] [delay] [id#] |
|
|
Starts workorder copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest server |
Destination server. |
|
outfile |
Outfile (normally /dev/null). |
|
delay |
Delay. |
|
id# |
Machine ID. |
stop_workorder_copytask
|
Usage: stop_workorder_copytask [source-server] [destination-server] [id#] |
|
|
Stops workorder copytask between two machines. |
|
|
Parameters: |
|
|
source serv |
Source server. |
|
dest-server |
Destination server. |
|
id# |
Machine ID. |
Output Files
As each process starts, an output file is created.
Output File Names
Output file names include the server name and the extension .out. (The current output file is renamed with the date or the word old.) The following are examples of these file names:
-
servername_MAALGEN1.out
-
servername_MAALGEN2.out
-
servername_MATOC.out
-
servername_BGCLEAN.out
-
servername_RW_SCHEDULER.out
Output File Content
Output files display the command information about the start of the process. For example:
sql command started at 05.01.01 at 15:15:15
out.date File Names
As each process starts, an output file is created with the extension .out.date. The following are examples of these file names:
-
servername_MAALGEN1.out.050101
-
servername_MAALGEN2.out.050101
-
servername_MATOC.out.050101
-
servername_BGCLEAN.out.050101
-
servername_RW_SCHEDULER.out.050101
out.date File Content
.out.date files display information about the process activities. Below are examples:
-
ALGEN:
GT 05/01/01 10:36:24 05/01/0110:36:24 CI/ZO/TY/SZ 7 -3
SA -3 7 -
MATOC:
07:38:11 0 pro_oc_monitor started
Tio: 05/01/01 6:09:00 Use/ms:150 Del/s:5352 -
BGCLEAN:
sql command started at 05.01.01; 14:49:15
Error Files
Error files begin with the abbreviation Msg, for example:
Msg 2812 Level 16, State 4:
Procedure ’r;pro_cp_bg_jobs’, Line 129:
Stored procedure ’r; ’r; not found. Specify owner.objectname or use sp_help to check whether the object exists (sp_help may produce much output). (return status = -6)
The Report Scheduler .out.out.old files also list the processes and errors, for example:
-
FINI /ir/iwork/report/ARNOLD rw report scheduler .9130
REPORT START
i run report 4 ub/softreq2 2831 sbnmaster ARNOLD -
UX:lp: WARNING: Cannot access the file:
a:/open.rpt.
TO FIX: Make sure file names are valid.
Stop SBN Processes
You may stop SBN processes for a specific server.
Note: You must LOGIN as sybase to run this command.
sbnoff
|
Usage: sbnoff server |
|
|
Stops all SBN processes prior to a machine shutdown. |
|
|
Parameters: |
|
|
server |
Server name. |
To stop SBN processes for a specific server
1. Type the command sbnoff with the correct server name.
‰ A question appears: �Do you want to shutdown SBN processes on server XXXX? (y/n)�
2. If you choose �y,� the procedure will stop the following processes on the named server:
l All ALGENs
l The BGCleaner
l The Open/Close Handler
l The Report Scheduler
l The Paging Scheduler
‰ A question appears: �Do you want to shut down COPYTASKS for server XXXX? (y/n)�
3. If you choose �y�, the procedure will stop the following processes on the named server:
l The data entry copytask
l The monitoring copytask
l The service copytask
‰ A question appears: �Do you want to shut down server XXXX? (y/n)�
4. If you answer �y,� the procedure will stop the named server.
Modifications and Updates to Unix Start Stop Maintenance
The following table lists modifications and updates to the Unix Start Stop Maintenance document.
|
Mod Number |
Date |
Description |