Call History Phone Statements

The call history phone statements erase the call history of a phone record or display the call history of a phone record.

Valid Subtypes

• Call_Note
• Erase_All_Call_Histories
• Erase_Current_CallHistory
• Show_Call_Histories

CALL_NOTE

Shortform: !PHONE,CALLNOTE

The CALL_NOTE subtype moves information from the data record to the “call note” area for the call. The call note may be up to 64 columns wide.

The syntax for the PHONE,CALL_NOTE question type is:

PHONE,CALL_NOTE,<TO location(call note)>,<FROM location(data)>,width

The TO location is the absolute location in the call history field for this particular call (e.g. Call #5) and has to be a number between 35 and 99. The total length of the call note may not exceed 64 columns. This option may only be used if you have phone_history_note_length set to >0 in the phone header.

ERASE_ALL_CALL_HISTORIES

Shortform: !PHONE,ERASEALLHIST

ERASE_ALL_CALL_HISTORIES initializes a phone number, taking the current record and making it look as if it were a fresh number. All history fields are cleared, but other system fields (time on call, calls made) are not. There are no parameters.

ERASE_CURRENT_CALLHISTORY

Shortform: !PHONE,ERASECURRHIST

ERASE_CURRENT_CALLHISTORY erases the history for the current call (saves the number without a history for this call) even though you gave it a status to move it to some other calling stack. There are no parameters.

SHOW_CALL_HISTORIES

Shortform: !PHONE,SHOWHIST

SHOW_CALL_HISTORIES gets and displays the phone history and any suspend text if a number has been retrieved with an earlier PHONE statement.

The syntax for the SHOW_CALL_HISTORIES subtype is :

PHONE,SHOW_CALL_HISTORIES

The default is to show all histories.

Example:

Call # 1: FRI NOV 1 2013 16:57 – 16:59 ID: TEST STATUS: NO ANSWER
Call # 2: TUE NOV 5 2013 10:23 – 10:28 ID: MARY STATUS: TIMED CALL

You may specify two numbers that control the histories shown:

!PHONE,SHOW_CALL_HISTORIES,<# from end>,<# from start>,SHOWNOTE

This will let you see from start histories from the first call and from end histories from the last call made. If the SHOWNOTE parameter is used, it will show the call note in addition to the call history information.

NOTE: SHOWNOTE can only be used if you have 100-column call histories, the last 64 columns are the note.

EXAMPLE:

!PHONE,SHOW_CALL_HISTORIES,3,1

This will show the first call and the last three calls. If only one number is specified, that many histories from the end will be shown.

The text describing the phone status on the phone history can be controlled using the file FONESTAT in the $cfmc/CONTROL directory. Each label can be up to 16 characters. Add a line to the file for every status you will be using consistently, or modify the text for existing statuses. If you do not provide text, the program will list the status number instead.