This document covers the following topics:
Enables users to trace the events which occur on the terminal line between the TOPCALL, GNT, or CAESAR system and the Natural telex driver on the host. Additionally, users can check when the last interaction between the Telex, Teletex, or Telefax driver and the connected hardware occurred.
If this program is added as an Application in the user's cabinet, it can be invoked from any point in Con-nect . For further information, see the Con-nect User's Guide, section Applications. Otherwise, it can be invoked from the SYSCNT2T library by entering D-TELEX at the Next prompt.
The following screen is displayed.
Note:
If this program is added as an Application in the user's cabinet
with the "User" defined as a parameter, this screen is not displayed.
FOR USER ________ FUNCTION _ 0=DISPLAY 1=START 2=STOP |
- For User
The user ID running the Con-nect Teleservices driver.
- Function
0=DISPLAY Display the traced events. Events cannot be traced unless this trace feature has been initialized for the specified communication line by specifying 1 (e.g. user TELEX). 1=START Begin tracing the communication line. Once the trace feature is started, it continues to trace the line until the system is rebooted, or you select the stop function. To activate the trace facility, the user defined for the terminal line must be restarted. To do so, logoff and restart the telex driver. 2=STOP Stop tracing the communication line.
If you select the START function, the trace feature is activated and you are returned to the menu in which you called the d-telex program. For example, if you have defined the d-telex program as an application in your cabinet and you call it from the main menu, you are returned to the main menu.
If you select the DISPLAY function, similar information as shown below is displayed:
16. 16:07:48 *** TOP-CALL TELEX *** ROLL -> 2 MIN 57 SEC 16. 16:10:46 D..2Q?R?? 16. 16:10:48 D?D++++++A:+EMPTY?D318 keine Nachricht?E? 16. 16:10:49 *** TOP-CALL TELEX *** ROLL -> 2 MIN 57 SEC 16. 16:18:31 D..2Q?R?? 16. 16:19:12 D?D++++++A:+EMPTY?D318 keine Nachricht?E? 16. 16:20:11 *** TOP-CALL TELEX *** ROLL -> 1 MIN 20 SEC 16. 16:21:49 D..2Q?R?? 16. 16:21:54 D?D++++++A:+EMPTY?D318 keine Nachricht?E? 16. 16:21:55 *** TOP-CALL TELEX *** ROLL -> 2 MIN 54 SEC |
The first column on the left-hand side contains the current date. The next column contains the time the message was sent to the TOPCALL, CAESAR or GNT system, while the remaining information contains the protocol element (message, event) that was sent to the TOPCALL, CAESAR or GNT system.
Note:
This trace program does not store log records until they are
physically deleted. Rather, approximately two pages worth of log records are
stored, with the oldest records overwritten with the most current records.
X-BLG-M can only be used with a TOPCALL system.
This program is an extended trace facility which enables the administrator to observe significant events that occur during the execution of Con-nect Teleservices routines.
To activate the extended trace program, the #TC-TRACE-ENABLED switch in the startup program TLXDRV must be set to <TRUE>, and the user defined for the terminal line must be restarted. To perform a restart, you logoff and restart the telex driver.
Notes:
With this program, Con-nect Teleservices can keep log information for each significant action and, thus, facilitate problem determination and general supervision by the administrator. Significant events include initialization, incoming and outgoing telex, telefax or teletex mail items, uploading charge files and journals from the telex system to Con-nect , as well as other exceptional conditions.
This program can be added as an Application in the user's cabinet and, thus, can be invoked from any point in Con-nect. For further information, see the Con-nect User's Guide, section Applications. Otherwise, it can be invoked from the SYSCNT2T library by entering X-BLG-M at the Next prompt.
The following screen is displayed:
1:55 PM * * * C O N - T A C T 3 * * * 14.Feb.94 Cabinet LS Log Information Maintenance X-BLG-M Cmd Program Log Time Ty Log Info --- -------- ----------------- -- -------------------------------------------- __ X-BIO3 94-03-02 09:47:50 O D?R?? __ X-BIO3 94-03-02 09:49:43 I T? __ X-BIO3 94-03-02 09:49:43 O D..2EOT,BREAK=1?D..2END?D..2C,R=B:TTC??????? __ X-BIO3 94-03-02 09:50:08 I D?D++++++B:+INHALT?D?D930311 0949?DKENNUNG __ X-BIO3 94-03-02 09:50:08 M *** TOP-CALL TELEX *** INITIALIZED __ X-BIO3 94-03-02 09:50:08 O D..2P,D=930311,T=0950?D..2Q?R?? __ X-BIO3 94-03-02 09:50:11 I D?D++++++A:+EMPTY?D318 keine Nachricht?E? __ X-BIO3 94-03-02 09:50:11 M *** TOP-CALL TELEX *** ROLL -> 2 MIN 57 SE __ X-BIO3 94-03-02 09:53:08 O D..2Q?R?? __ X-BIO3 94-03-02 09:53:11 I D?D++++++A:+EMPTY?D318 keine Nachricht?E? __ X-BIO3 94-03-02 09:53:12 M *** TOP-CALL TELEX *** ROLL -> 2 MIN 57 SE __ X-BIO3 94-03-02 09:56:09 O D..2Q?R?? __ X-BIO3 94-03-02 09:56:12 I D?D++++++A:+EMPTY?D318 keine Nachricht?E? __ X-BIO3 94-03-02 09:56:12 M *** TOP-CALL TELEX *** ROLL -> 2 MIN 57 SE Commands: Position to Log Time: ______________ Enter a command, press a PF-key, or enter * to list commands DI Display ER Erase TO Top DB DispBuffer (YYYYMMDDHHMMSS) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- QUIT ERAL - + -- |
- Program
The name of the program which generated the log record.
- Log Time
The time the log record was created.
- Ty
Type of event. These values are used internally by Con-nect Teleservices. The following values are used:
O Outgoing message from Con-nect Teleservices. I Incoming message to Con-nect Teleservices. M Informational message from Con-nect Teleservices. - Log Info
Information used for tracing.
- Position to Log Time
If the list is longer than one page you can enter a date and time in this line to scroll to the specified date and time.
You can enter the following command aliases in the Cmd column for each log record displayed:
DI Displays additional information pertaining to the log record. ER Erases the selected log record. You are not asked to confirm the deletion, it is erased immediately TO Scrolls the selected log record to the top of the screen. DB Displays the message as it was sent or received. This command is useful if a full screen protocol is used to communicate between the telex system and the Con-nect Teleservices driver. You can use the following PF-keys to page through the list of log records:
PF8 Display the previous page (-). PF9 Display the next page (+). PF10 Display the first page (--). PF11 Display the last page (++).
Enables users to display the delivery status of the telexes, teletexes, or telefaxes sent from their cabinets.
As a supervisor, the delivery status of all telexes, teletexes and telefaxes can be displayed.
If this program is added as ane Application in the user's cabinet, it can be invoked from any point in Con-nect . For further information, see the Con-nect User's Guide, section Applications. Otherwise, it can be invoked from the SYSCNT2T library by entering TELEXE at the Next prompt.
Note:
If you have supervisor status, enter the TELEXE password at the Next
prompt. Without the password only the telexes, teletexes and telefaxes you have
sent will be displayed. To obtain the password, contact your Software AG
representative.
As a result, the following screen is displayed:
Status Number To / Subject Date/Time -------- ---------------- --------------------------------------- --------- Waiting F061519213904 To: jms 19940212 Subject: Test Results 14:33:34 Process F922610 To: eas 19940212 Subject: Test Results 17:03:34 Sent 4197104 To: jcs 19940212 Rej rej Subject: Important Information 18:05:51 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- |
It displays the current status of all telexes, teletexes and telefaxes which you have sent from your cabinet. Each event contains the following information:
- Status
The status of the telex, teletex, or telefax. It can be one of the following:
Waiting The message is currently in the Con-nect spool file, waiting to be transmitted to the telex, telefax, or teletex system. Process The message is being transmitted from the Con-nect spool file to the connected telex, teletex, or telefax system. Sent/Rej. The message is delivered or could not be delivered to the external telex, telefax, teletex addressee and a corresponding status notification is sent to the originator's Con-nect cabinet. For information on rejected telexes and telefaxes, see Rejected Telexes. - Number
The number which was used to send the telex, teletex, or telefax message. In the case of a Telefax, the letter F is inserted in front of the number, while the letter T is inserted in front of the Teletex number. No letter is inserted in front of a Telex number.
Note:
If this program is activated with the TELEXE password, the name and user ID of the originator is displayed below the status and number of the telex, teletex, or telefax.- To / Subject
The addressee's name and the subject of the telex, teletex, or telefax as specified in the "To" and "Subject" lines on the "Send Telex/Teletex/Telefax to Node-name" window.
- Date/Time
Date and time the Con-nect Teleservices Send function was called.
Telexes which cannot be delivered to the specified addressee are indicated in the "Status" column with Rej "NNN", where "NNN" is one of the following codes:
Code | Description |
---|---|
rej | General error |
abf | Garbled reception of answerback |
abd | Number in receiver's answerback does not match the selected national number |
abs | Subscriber absent, connection switched off |
ci | Conversation with this connection impossible |
der | Connection disturbed |
df | Connection successful |
inf | Momentarily not reachable, call information |
na | Communication with this subscriber not allowed (sometimes instead of occ, nc, der) |
nc | All lines busy |
nch | Number changed, call information |
np | Selection number leads to no telex connection |
occ | Desired connection busy |
spp | Receiver was also writing, disconnected |
usc | Non-interpretable character received |
Telefaxes which cannot be delivered to the specified addressee are indicated in the "Status" column with one of the following codes:
Code | Description |
---|---|
Rej rej | General error |
Rej NNN | Number not relevant |
If the API subprogram X-BO-U is activated, you can obtain a detailed description as to why the mail item cannot be delivered to the addressee. For further information, see the Con-nect Installation and Operations documentation, section User Modifications.
Enables the Con-nect Teleservices administrator to stop the Con-nect Teleservices driver in between the driver's "sleeping time" as specified in the TLXDRV program.
If this program is added as an Application in the user's cabinet, it can be invoked from any point in Con-nect . If you specify IN-USER-ID and MAX-TIME as parameters when adding the program as an application, you can circumvent the X-BSTOP screen. For further information, see the Con-nect User's Guide, section Applications. Otherwise, this program can be invoked from the SYSCNT2T library by entering X-BSTOP at the Next prompt.
If you have not added this program as an application with IN-USER-ID and MAX-TIME defined as parameters, the following screen is displayed:
#IN-USER-ID #MAX-TIME |
- IN-USER-ID
Enter the user ID running the Con-nect Teleservices driver.
- MAX-TIME
The number of minutes the program will wait before stopping the Con-nect Teleservices driver. The time specified here must be greater than the sleeping time specified in the TLXDRV program. Valid values are: " " (blank), or 0 through 999.
If no time limit is specified in parameter MAX-TIME, this program sets a flag in the spool file, exits and the screen from where you called this program is displayed. You are not notified when the driver is stopped, but the next time the driver checks the spool file, the driver is stopped.
If you specify a time limit, this program sets a flag in the spool file but does not exit until the driver is stopped. Thus, your terminal is locked until then.
If for any reason the driver stops itself during the time limit specified in parameter MAX-TIME, the driver automatically erases the flag.
The following program can be included in program X-STOP so that you are notified when the driver is stopped.
HIST. HISTOGRAM SPOOL-VIEW DIR-KEY FROM #X-BSTOP-KEY THRU #X-BSTOP-KEY END-HISTOGRAM IF *COUNTER(HIST.) GT 0 CALL 'CMROLL' #ROLLOUT /* WAIT 1 MINUTE ELSE WRITE 'DRIVER HAS STOPPED' /* ADD MESSAGE FOR USER ESCAPE ROUTINE /* DRIVER HAS STOPPED WORKING END-IF