SQWareProduction:sybase:bin:sqwsyb KillSessions.ksh

Presentation

Script $gvsqw_SybBin/sqwsyb_KillSessions.ksh :

Generate kill of sybase connections
You can include or exclude databases by lists
By default kill all sessions
you can also choose the number of retry to kill session

Online help

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

Sourcing sqwsyb_Global.lib v2024.02 SQWareProduction for Sybase (dbSQWare) ... 

Usage: sqwsyb_KillSessions.ksh [-h] -I <dataserver> [+ options]

DESCRIPTION
   sqwsyb_KillSessions.ksh kill sybase sessions
SUPPORT
   Sybase supported versions: 12.0 <= v <= 16.0

PARAMETERS
     -I  dataserver     : Target dataserver for kill.
OPTIONS
     -h                 : Display the full usage.
     -s                 : Display samples of usage.
     -NoMail            : Deactivate sendmail on error pmexpdba@gmail.com (by default, send on error).
     -AddMail   email   : Email address to add at 'pmexpdba@gmail.com'.
     -SendReport        : Send execution log report.
     -ID  listdb        : List of databases to include (by default all).
     -ED  listdb        : List of databases to exclude.
     -FRT       code    : Force return code value on error.
     -Dist              : For distant connection to database (change $gvsqw_DbaUser to $gvsqw_DistDbaUser ).
     -NBA Nb            : Number of attempts (by default 4).
     -Locale    locale  : Force Locale for help display (fr,en).
     -Exec              : Kill sessions (by default, display generated commands).

Error management

Errors passing arguments

This type of message is generated:

Lack 'dataserver' parameter, Usage: sqwsyb_KillSessions.ksh [-h] -I <dataserver> [+ options]
For full help : sqwsyb_KillSessions.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 'dataserver' 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_sybase : " (See help customize this variable).

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_sybase (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_sybase : " (See help customize this variable).

Usage examples

Sourcing sqwsyb_Global.lib v2024.02 SQWareProduction for Sybase (dbSQWare) ... 

#Standard help for script sqwsyb_KillSessions.ksh:


$gvsqw_SybBin/sqwsyb_KillSessions.ksh -h
#Display online help for this script

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

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -s
#Display usage examples for this script

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY
#Generate commands but don't execute them !

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -Exec
#Execute kill of sybase's connections

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -Dist -Exec
#Run the script for the instance <$DSQUERY> with the status DIST (by default, only for status ON)

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -NBA <Number> -Exec
#Execute generated commands with attempt number

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Add the mail list to the default address managed by the variable gvsqw_GlobalMail

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -SendReport -Exec
#Send the log by email at the end of the treatment even if there is no error

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -NoMail -Exec
#Disables sending an email on error to $gvsqw_GlobalMail (by default, send on error)

$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -FRT <NumericValue> -Exec
#Force return code to '<NumericValue>' on error (if no error, "exit 0!")
#You can also force return code of this script on all your
#environnement if you set the variable: $gvsqw_ForcedReturnCodeScript_sqwsyb_KillSessions=<NumericValue>
#in configuration file $gvsqw_SybBin/../etc_cust/sqwsyb_GlobalVar.cfg

#Options to generate databases list with filters (you can mix all off them):
$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -ID <listdb> -Exec
#Generate database list with 'in list':
#=> and name in ('$ListInclude')
$gvsqw_SybBin/sqwsyb_KillSessions.ksh -I $DSQUERY -ED <listdb> -Exec
#Generate database list with 'not in list':
#=> and name not in ('$ListExclude')