PURPOSE --
Spawn off a batch job to generate an SMS. Create all the ancillary
files that go with an SMS.
 
Requires environment variables:
   - PE_DAT
   - SPSS_SMS
   - SPSS_DB
 
DEVELOPER --
Don Chance
 
MODIFICATION HISTORY --
 
o Initial implementation 10/25/00
o Fix calendar displays.  drc 5/2/01
o Changed name from 'gen_sms.py' to 'sms.py';
  major modifications for smsg on Unix.  drc 11/08/01
o Delete the log file if it exists before generating a new SMS. drc
  12/3/01
o Updated docstring (SPSS 44.5). drc 12/17/01
o Fix sa_angle problem for cold starts. drc 12/21/01
o Fix call to has_coldstart_IAC.  drc 01/03/02
o Turn cache option back on (fixed w/ SPSS 44.6). drc 5/16/02
o Fix fix_nic_acqs. drc 6/03/02
o Mods for new smsg -eps -offset switch.  mdr 1/20/04
o Fix bug with -eps_offset switch.  mdr 3/29/05
o modified for SGE 6.  drc 5/8/07
o add -anode to spb calendar display.  mdr 8/7/08
o add -trace as a possible smsg option.  drc 8/13/08
o allow non-standard start instruction on cold starts. drc 8/22/08
o update SAA models for post-SM4 instruments. mdr 6/8/09
o change the default cache option to 'none'. mdr 10/5/12
o Check on use of an eps override file.  mdr 5/19/14

Modules
		glob os sms_util spss_sys_util spst_getopt stpydb string submit_codine

Functions
		fix_nic_acqs(calendar) Add an extra qesiparm to certain NIC ACQ SUs.   This routine will extract all NIC ACQ SUs from a calendar, then if those SUs are included in a file, those SUs will be given a special qesiparm to not do a hole locate.   Translated from FIX_NIC_ACQS.COM, NIC_HOLELOCATE.ISQL, and NIC_ACQ_BY_CCL.ISQL written by Merle. run(smsname=None, *args) Spawn off a batch job to generate an SMS.   Usage: do sms sms_name [-cache=<cache_sms_name>]                 [-cont=<continuity_sms_name>]                 [-eps_over]                 [-eps_offset]                 [-sa_angle=<angle>]                 [-ref_ut=<time_or_sms_name>]                 [-trace=<value>]                 [-test]   Note: This tool must be run from a Unix system.   The 'cache_sms_name' is the name of the SMS from which to initialize the cache file.  Defaults '-cache=none' which forces the opening of a new cache file.   The 'continuity_sms_name' is the SMS whose .glo file to use.  Defaults to the continuity SMS determined from the calendar baseline. '-cont=cold_start' forces a cold start SMS.   The 'eps_over' will cause the SMS to be generated with EPS override file: $SPSS_SMS/sms_name.eps_ovr_#.  'do check_eps_ovr' with the '-move' qualifier should have been run to create the override file.  The default is to not use an EPS override file.   The 'eps_offset' will cause the SMS to be generated with an EPS offset override file:  $SPSS_SMS/sms_name.eps_off_1.  The default is to not use an EPS offset override file.   The 'angle' is the initial SA angle to use.  Useful for cold start SMSs. Defaults to the last SA angle from the continuity SMS.   The 'time_or_sms_name' is a time in SPSS time format (yyyy.jjj:hh:mm:ss.ccc) or an SMS name.  This time or the creation time of the given SMS will be used as input to the 'same_ut' qualifier.  This qualifier tells 'smsg -gen' to use the veh_time_coeff record where the ascii_ref_ut time is less than or equal to the specified time.   Use -trace=full to generate a full trace file.  Other options include brief, debug:cache, debug:callframe, debug:globals, debug:labels, debug:pseudos, debug:query, debug:tcs, debug:times, debug:values. The default is brief.   Use the '-test' option to run a test SMS.  Use of the '-test' option forces '-cont=cold_start'.

Data
		FLIGHT_SMS_QUEUE = 'flight_sms.q' TEST_SMS_QUEUE = 'test_sms.q' __version__ = '05/19/14'