116 Advice on Group Selection - Alternate group header selection criteria

The 116 statement has been introduced in ATIS93 to allow several features not available in ATIS89. The primary new feature is to allow a programmatic approach to the selection of groups. The 116 statements should be treated as groups and may be transmitted during the night on systems which allow partial input files. 116 statements are usually generated by an APA rather than directly by a participating astronomer. Like other groups, the relative sequence within the ATIS input file is of no importance.

IDENTIFIER: 116
INFORMATION:

#NameTypeInputOutput
1Advice Numberintegerrequiredechoed
2Start LSTrealrequiredechoed
3End LSTrealrequiredechoed
4Start UTrealrequiredechoed
5End UTrealrequiredechoed
6Previous Groupintegerrequiredechoed
7Set Execution Countintegerrequiredechoed
8Group Numberintegerrequiredechoed
9User Numberintegerrequiredechoed
10Group Testintegerrequiredechoed
11Next If Trueintegerrequiredechoed
12Next If Falseintegerrequiredechoed
13Wait Flagintegerrequiredechoed

Example:

116
74 0.0 0.0 5.23214 5.43214 25344 3 25666 327 1 75 122

Where:

Advice Number is a unique (within a given telescope) number from 1 to a maximum number assigned to each 116 statement. The maximum number is not defined by ATIS, but is typically 1000 or more. Zero is never assigned as an advice number, but referencing advice number 0 exits the 116 pattern and executes one pass through the 'normal' 103 selection rules as if no 116 statements existed. The 116 statements are resumed at advice number 1 if it exists. Otherwise the 103 selection rules apply. Appending a 116 statement with the same advice number as an existing 116 statement overwrites the existing statement. Others are added to the list. Link changes are accomplished by adding and replacing 116 statements.

Start LST is the earliest LST in decimal hours which yields true. Use 0.0 in both LST parameters for "don't care".

End LST is the latest LST in decimal hours which yields true.

Start UT is the earliest UT in decimal hours which yields true. Use 0.0 in both UT parameters for "don't care".

End UT is the latest UT in decimal hours which yields true.

Previous Group checks if the previous executed completely or aborted.

0don't care if last group executed successfully
1last group must have executed successfully
2last group must have aborted

Set Execution Count determines how to change the group execution count prior to executing the group if 0 to N = set the execution count to N (N=0..maxint) -1 = don't change the execution count.

Group Number is the 103 group to execute if tests pass. Selecting a non existent group will cause the "Next_if_False" path to be taken, along with an error comment. If the group is executed, the execution count will be decremented whether it is successful or not.

User Number is the 103 user number to check for a match. Group Number and User Number together always form a universally unique group to execute.

Group Test is a flag which indicates whether the 103 JD and Moon information should also be tested prior to executing the group. A fail will be treated as though the 116 line failed to pass.

0ignore 103 header tests
1J.D and Moon group tests must also be true

Next If True is the Advice Number to execute if all tests pass and the group has been executed (successfully or not).

Next If False is the Advice Number to execute if the tests fail. Requesting Advice number zero to execute will result in exiting the 116 statement sequence and making one pass through the 103 headers to select the next group. The software will then reenter the 116 sequence starting at Advice number 1. 116 statements are echoed in the ATIS output file immediately before a 103 statement when they are responsible for the execution of a group.


[Previous] Statement 115 [Up] 100 Series [Next] 200 Series