SQWareProduction:mysql:bin:sqwmys RunJob.ksh

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Presentation

Script $gvsqw_MysBin/sqwmys_RunJob.ksh :

Run MySQL scripts and generate log and error file
based on $gvsqw_RootCfg/sqwmys_Jobs.cfg configuration file
compress and purge oldest log files

Online help

The online help is available for most scripts with the -h option.
Ex: $gvsqw_MysBin/sqwmys_RunJob.ksh -h
Content of this assistance :

Sourcing sqwmys_Global.lib v2025.05 SQWareProduction for MySQL (dbSQWare) ... 

Usage: sqwmys_RunJob.ksh [-h] -I <instance> -A <action> [+ options]

DESCRIPTION
   sqwmys_RunJob.ksh run script associated to the action parameter
SUPPORT
   All rdbms type and version

PARAMETERS
     -I  instance       : Target instance to action (or 'SQWareCentral').
     -A  action         : Action to execute.
OPTIONS
     -h                 : Display the full usage.
     -s                 : Display samples of usage.
     -Locale    locale  : Force Locale for help display (fr,en).
     -AddMail   email   : Email address to add at 'demo-sqwarebox@dbsqware.com'.
     -SendReport        : Send execution log report.
     -SendMailOnError   : Send mail on error (by default, SendMailOnError='Disable').
     -NoSendMailOnError : No send mail on error (by default, SendMailOnError='Disable').

Note:
To be sure the aid is accurate, refer directly to the online help script -h option.

Error management

Errors passing arguments

This type of message is generated:

Lack 'instance' parameter, Usage: sqwmys_RunJob.ksh [-h] -I <instance> -A <action> [+ options]
For full help : sqwmys_RunJob.ksh -h

If you are connecting through a terminal, no mail will be sent and you will have more this kind of message:

Not sending mail because you are in connected mode !!!
Lack 'instance' parameter

If you are not connected to a terminal, the error message appears and is sent by mail to the address contained in the variable $gvsqw_GlobalMail (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_mysql : " (See help customize this variable).

Note:
Sending mail can be disabled by the option -NoMail for one execution.

Execution errors

Whether you are or not connected to a terminal, the error message appears and an email containing a summary of treatment errors is sent to the address contained in the variable $gvsqw_Mail_mysql (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_mysql : " (See help customize this variable).

Note:
Sending mail can be disabled by the option -NoMail for one execution.

Usage examples

Sourcing sqwmys_Global.lib v2025.05 SQWareProduction for MySQL (dbSQWare) ... 

#Standard generic help for script sqwmys_RunJob.ksh:


$gvsqw_Mys/sqwgen_RunJob.ksh -h
#Display online help for this script

$gvsqw_Mys/sqwgen_RunJob.ksh -Locale en -h
#Display online help for this script with forcing of the 'en' locale (by default locale managed by $gvsqw_Locale)

$gvsqw_Mys/sqwgen_RunJob.ksh -s
#Display usage examples for this script

$gvsqw_Mys/sqwgen_RunJob.ksh -I <Instance> -A <action>
#Search action <action> in $gvsqw_RootCfg/sqwmys_Jobs.cfg
#and execute command line with eval function
#genarate log file "$gvsqw_LogDir/"$(basename $lvsqw_Script|sed 's,.ksh$,,')_$(date +'%Y%m%d_%H%M%S').log
#genarate error file "$gvsqw_LogDir/"$(basename $lvsqw_Script|sed 's,.ksh$,,')_$(date +'%Y%m%d_%H%M%S').err

$gvsqw_SQWareCentralPath/bin/sqwgen_RunJob.ksh -I <Instance> -A <action> -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com'
#Adds the email list to the default address managed by $gvsqw_GlobalMail

$gvsqw_SQWareCentralPath/bin/sqwgen_RunJob.ksh -I <Instance> -A <action> -SendReport
#Sends the log by email at the end of the process, even if there is no error (by default, only in case of an error)

$gvsqw_SQWareCentralPath/bin/sqwgen_RunJob.ksh -I <Instance> -A <action> -SendMailOnError
#Run the script sqwgen_RunJob.ksh and will send mail on error.
#By default, it uses the gvsqw_SendMailOnError variable (SendMailOnError='$gvsqw_SendMailOnError').
#You can change the default for the entire environment by setting this variable
#in the configuration file $gvsqw_PgBin/../etc_cust/sqwpg_GlobalVar.cfg

Note:
To be sure the examples are accurate, refer directly to the online help script -s option.