Example #1A ESS Input Messages

CAMA-PRINT


                                          ID . . . . . . CAMA-PRINT
                                          GENERIC. . . . B12 and later 
                                          TTY. . . . . . MTCE 
                                          FEATURE. . . . CAMA
                                          APPLICATION. . 1A 
                                          PPU. . . . . . 
                                          TYPE . . . . . Input

1. PURPOSE

   Controls the following:

   (a) The printing of the CA02 immediate-error message and the associated 
       TW02 messages (end code 20000002).

       Note: The printing of the CA02 message is turned on by Pident CAMA 
       for error categories PRG and TDA once a day at 2:30 a.m. 
       Effectively prints CAMA-PRINT-ON3 PRG/ONO TDA.  COPE requests from 
       the CAMA positions are inhibited at 2:30 a.m.  Effectively prints 
       CAMA-PRINT-INH,PEX.

   (b) The taking of TGN counts (CAMA incoming trunk groups) that are 
       printed in the CA03 CAMA ERROR SUMMARY message and the CA04 CAMA 
       TRAFFIC SUMMARY message.

   (c) The printing of the CA03 and CA04 summary messages upon demand.

   (d) The printing of the CA04 CAMA TRAFFIC SUMMARY message either daily 
       or hourly.

   (e) The allowing or inhibiting CAMA operator position exercise (COPE) 
       requests from the operator position.

2. FORMAT

   CAMA-PRINT- aaa bbb.

3. EXPLANATION OF MESSAGE

   The following is a list of the valid parameters for 'a' and 'b'.  Within 
   a group, any parameter 'a' can be used with any parameter 'b'.  By using 
   a slash (/) at the end of the input message instead of a period (.), 
   more than one set of 'a' and 'b' parameters can be specified; however, 
   more than one TTY request may be required to accomplish what is desired. 
   There are no restrictions as to the order in which TTY requests are 
   made.

   Group I Parameters

   a =   ON0 - Turn on printing of the CA02 message.

     =   ON1 - Turn on printing of the CA02 message and one TW02 
         message.  This TW02 will be a dump of the register most 
	 closely related to the error.
     
     =   ON3 - Turn on printing of the CA02 message and up to three 
         TW02 messages.  The registers that can be dumped are CR0, 
	 CR1 , IR, ISR.

     =   OFF - Turn off printing of CA02 and TW02 (end code 
         20000002) messages.
   
   b =   PRG - Do the above for program error category.

     =   TDA - Do the above for translation error category.

     =   DIG - Do the above for digit error category.

     =   OPR - Do the above for operator error category.

     =   HDW - Do the above for hardware error category.

     =   ALL - Do the above for all error categories.

         EXAMPLE (1)

         A good initial state for CA02 printing is all error categories printing, 
         category "program" with up to three register dumps, and the other 
         categories with no register dumps:

         CAMA-PRINT-ON0 ALL/
                    ON3 PRG.

         Assume that trouble develops in an ANI supplying CAMA traffic to the 
         office and the result is a large number of CA02 messages of category 
         "digit."  After using the messages to determine the AN1 problems, it may 
         be desirable to turn off the printing of these messages temporarily 
         until the ANI is fixed:

         CAMA-PRINT-OFF DIG.

         Then, to restore printing:

         CAMA-PRINT-ON0 DIG.

   Group II Parameters

   a =   TGN - TGN information is to follow.

   b =   SUM - Apply the specified TGN only to the CAMA summary 
         messages - CA03 and CA04.  Error and traffic counts will 
	 be taken for the specified CAMA incoming trunk group.

     =   ALL - Apply the specified TGN to the CAMA immediate error 
         message CA02, in addition to the CAMA summary messages 
	 explained directly above.  Printing of CA02 messages will 
	 be restricted to only those that are associated with the 
	 specified TGN.

     =   ( ) - The parentheses represent any 3-digit CAMA incoming 
         trunk group number.  This specifies a TGN: it will be used 
	 according to 'b' parameters SUM or ALL.  Only the last TGN 
	 specified can be in effect at any given time.  If a TGN is 
	 already in effect and another one is specified, CA03 and 
	 CA04 messages are printed and then the TGN counts are 
	 zeroed to initialize for the new TGN.

     =   000 - Remove the influence of the TGN, stop taking TGN 
         error and traffic counts, and stop restricting the 
	 printing of CA02 messages to those associated with a 
	 particular TGN.  CA03 and CA04 messages are printed and 
	 then the TGN counts are zeroed.

         EXAMPLE (2) 

	 Assume that several ANIs develop trouble at one time.  Large numbers of 
	 CA02 messages from each office may make it hard to see patterns of 
	 errors for a particular office.  Restricting the printing of the CA02 
	 messages to those associated with a particular CAMA incoming trunk group 
	 will allow one ANI at a time to be inspected:

	 CAMA-PRINT-TGN XXX/
	            TGN ALL.

	 where XXX = Three-digit CAMA incoming trunk group number.

	 To change to another CAMA TGN:

	 CAMA-PRINT-TGN XXX.

   Group III Parameters

   ab =  SUM NOW - Print immediately the CA03 CAMA ERROR SUMMARY 
         message and the CA04 CAMA TRAFFIC SUMMARY message. 
	 Current counts are printed which cover a period of time 
	 starting at the last hourly or daily printout.  The TGN 
	 counts may cover a period of time if a TGN was specified 
	 after the last scheduled printout.  The counts are not 
	 zeroed.

         EXAMPLE (3)

	 To check the present error and traffic counts without waiting for the 
	 scheduled printout of the summary messages, the following message is 
	 typed:

	 CAMA-PRINT-SUM NOW.

	 To stop taking TGN counts, the following message is typed:

	 CAMA-PRINT-TGN 000.

   Group IV Parameters

   a =   TRF - Traffic information is to follow.

   b =   HLY - Print the CA04 CAMA TRAFFIC SUMMARY message every 
         hour on the half hour.  This message is not printed if all 
	 traffic counts were zero for the past hour.

     =   DLY - Print the CA04 CAMA TRAFFIC SUMMARY message once a 
         day at 2:30 a.m.  This message is not printed if all 
	 traffic counts were zero for the past day.

         EXAMPLE (4)

	 Each office supplying CAMA traffic can be checked to see whether 
	 performance standards are being met by looking at hourly printouts of 
	 the CA03 CAMA ERROR SUMMARY and CA04 CAMA TRAFFIC SUMMARY messages.  The 
	 TGN counts of these messages provide the ability to gather data on 
	 an individual office.  For this application, the TGNs that are specified 
	 should only affect the summary messages and not restrict the printing of 
	 the CA02 messages.  This can be accomplished with the following:

         CAMA-PRINT-TGN xxx/
	            TGN SUM/
		    TRF HLY.

   Group V Parameters

   a =   ALW or INH - Allow or inhibit.

   b =   PEX - COPE requests from the CAMA operator position.  When 
         the system is in the ALW mode any digits received within 1 
	 second after position is occupied will be interpreted as a 
	 COPE request.

4. SYSTEM RESPONSE

   This message is designed for automatic paper tape operation.  Each 
   message on paper tape should be followed by X-OFF (ASCII DC3) and 5 or 
   more RUB (ASCII DEL) characters.

   OK =   Indicates that the request is done.

   PF =   Indicates that the requested printout is forthcoming.

   NO =   Indicates that the request cannot be done because there is 
          no CAMA in this office; or the requested printouts did not 
	  fit into the TTY buffer; or the requested printouts are 
	  not necessary because all the data is zero.

   NG =   Indicates that the input parameters are invalid.

   NA =   Indicates that this response should not be received: there 
          is a program error in the CAMA-PRINT- code.


5. REFERENCES - FOR MORE DETAILS SEE

   PIDENT
     PR-6A069, CAMA1A00

   Practice
     231-090-278, CAMA Tandem ANI and ONI Description
     958-310-100, CAMA General Description Information - No. 5 Crossbar