Market Phone Statements

The market phone statements will set the market weight or change a number from one market to another.

NOTE: See the Markets documentation for more information on how to use these further.

Valid Subtypes

  • Assign_Market_Weight
  • Change_Market

ASSIGN_MARKET_WEIGHT

Shortform: !PHONE,ASSIGNMARKETWEIGHT

ASSIGN_MARKET_WEIGHT sets the market weight. This is usually used to set the market weight to “0” when a quota target has been reached for the market and you no longer want to attempt to get numbers from there.

The syntax for the PHONE,ASSIGN_MARKET_WEIGHT question type is:

!PHONE,ASSIGN_MARKET_WEIGHT,<market name>,<weight>

Market name is the name of the market to apply the weight to. This can be referenced directly or placed in the data and referenced by data location or label name.

Weight is a number between 0 and 9. If you set it to 0, the market is no longer called.

Example:

{ CHOOSEMARKET:
Choose the market:
!FIELD
1 NEW YORK
2 PHILADEPHIA
3 BOSTON }

{!IF CHOOSEMARKET(1) AND QUOTA(NEW_YORK)>=QUOTA(NEW_YORK.T)
!PHONE,ASSIGN_MARKET_WEIGHT,NEW_YORK,0 }

In this example, if New York is the market chosen in the CHOOSEMARKET question and the quota for New York is full, the market weight for the New York market will be set to zero, causing no sample to be released in the New York market.

You can also use the !PHONE,ASSIGN_MARKET_WEIGHT statement to read the market name from the data.

The syntax to do this is:

!PHONE,ASSIGN_MARKET_WEIGHT, [<label or location>], <weight>

The “label or location” would store the name of the market you will be updating. In this manner, you can update all your market weights with just the following two statements, instead of a statement for each market.

Example:

{ MARKET:
!PHONE,GET_PHONE_INFORMATION,201,20 }

{!IF QUOTAN([QUOTANUM])>=QUOTAN([TARGNUM])
!PHONE,ASSIGN_MARKET_WEIGHT,[MARKET],0 }

This helps with an increased number of markets and allows you to work with quota names such that quota and market weight updates can occur with very few statements.

CHANGE_MARKET

Shortform: !PHONE,CHANGEMARKET

CHANGE_MARKET is used to change a number from one market to another. You specify the name of the market you want to move the number to in the PHONE,CHANGE_MARKET statement.

The syntax for a PHONE,CHANGE_MARKET statement is:

!PHONE,CHANGE_MARKET,<market name>

In addition, the old market name and the number of changes made to the market is stored in the phone file.

“PREV_MARKET” stores the previous market number and is in column 5214.3.

“MARKET_CHANGES” stores the number of times the market has been changed and is in column 5217.3.