Sample Information Phone Statements

These phone statements get information from the phone record and write it to the data file, and they get information from the data and write it to the phone record.

Valid Subtypes

• Get_Phone_Information
• Put_Phone_Text

GET_PHONE_INFORMATION

Shortform: !PHONE,GETPHONEINFO

GET_PHONE_INFORMATION gets information from the phone record and writes it into the data record.  In PHONE,GET_PHONE_INFORMATION statement, you can reference the fields using the field name or the data location in the phone file.

The syntax for the PHONE,GET_PHONE_INFORMATION question type is:

!PHONE,GET_PHONE_INFORMATION,<FROM label or location,width (phone record)>

Example:

{ STATECODE:
!PHONE,GET_PHONE_INFORMATION,SCODE }

Or

{ STATECODE:
!PHONE,GET_PHONE_INFORMATION,1121,2 }

In these Examples, the STATECODE question gets the information from the SCODE field or 1121.2 in the phone record (state code) and puts it into the data location specified on the question label line (or the next available field if none is specified). If a width is used, it may be specified either on the PHONE line or in the data location field on the question label line.

The PHONE,GET_PHONE_INFORMATION statement will check for valid phone positions if a location is used. The number of columns that you’re getting (the width) can be from 1-4900 per statement in the phone text area, but must be the actual width of the field for non-text area items, except the time zone and call history field. In large phone file systems, references to Survox variable locations can be “actual” or “standard”; standard is the default and would start in position 5000.

NOTE: PHONE_GET_PHONE_INFORMATION statements can move 4900 columns of data between the phone file and the data file.

PUT_PHONE_TEXT

Shortform: !PHONE,PUTPHONE

PUT_PHONE_TEXT moves information from the data record and writes it into the phone text area.

PUT_PHONE_TEXT is the reverse of GET_PHONE_INFORMATION, but data may only be written to the phone text area or to columns 25-34 (CASEID field) to attach a case ID and change the phone record to Phone Says Datarecord mode.

The syntax for the PHONE,PUT_PHONE_TEXT question type is:

!PHONE,PUT_PHONE_TEXT,<TO location(phone text)>,<FROM location(data)>,<width>

The TO location must be a field name or column in the phone text area. The FROM location can be a question name or question number, in which case the width is optional; or a data location, which requires a width. The width can be specified on the PHONE,PUT_PHONE_TEXT line or as part of the data location (i.e., [161.10]). If the data location is a question label, the width will be assumed to be the width of the labeled question unless overridden by a separate width.

Example:

{ PUTPHONETEXT:
!PHONE,PUT_PHONE_TEXT,51,[161],80 }

In this Example, the PHONE,PUT_PHONE_TEXT statement moves 80 data columns starting at column 161 to the first 80 columns of the phone text area, which begins in column 51.

NOTE: PHONE,PUT_PHONE_TEXT statements can move up to 4900 columns of data between the phone file and the data file.