UpdateProfile

Purpose

Use UpdateProfile to modify information about the current mailbox in the current application profile. (For more information about application profiles, see the Blueworx Voice Response for AIX: Designing and Managing State Table Applications information.)

Description

UpdateProfile can modify any of the following information for a caller's mailbox:

• Password
• Owner Status
• Prompt Level
• Referral Extension Type
• Retrieval Order
• Referral Extension
• Announce Only
• Greeting ID
• Mailbox Status
• Access Mode

Your application should include a check to verify that the caller is authorized to update the specified information with UpdateProfile. For example, a caller who updates Access Mode must be authorized to control access to other mailboxes in the application profile.

Before you use UpdateProfile, you must set the Caller - Profile ID (SV20) and Caller: Mailbox - ID (SV32) system variables.

Parameters

UpdateProfile has either one or two parameters, depending on what is being updated.

Data

Specifies the information to be used to update the mailbox. Valid data values for each item that can be modified are:

Password

Numeric value up to 8 digits in length

Owner Status

0=in

1=out

2=sick

3=busy

4=travel

Prompt Level

0=normal

1=novice

2=expert

Referral Extension Type

0=telephone

1=beeper

Retrieval Order

0=first in first out

1=last in first out

Referral Extension

Telephone number, up to 20 digits (0 through 9 only)

Announce Only

0=take messages

1=do not take messages

Greeting ID

0=no greeting is defined

1 through 255

Mailbox Status

0=not active

1=active

Access Mode

0=read/write access to any mailbox in this profile

1=read access to any mailbox in this profile

2=read/write access for current mailbox only.

Possible results

UpdateProfile can have one of the following results:

Succeeded

The profile has been updated.

Failed

The profile has not been updated.

Invalid Mailbox ID

The information in the variable defined as the value of the Mailbox ID parameter is not a valid mailbox ID.

ASCII syntax

When using an ASCII editor, code this action with these parameters in the following order:

1. "PASSWORD" or
   • "OWNER_STATUS" or
   • "PROMPT_LEVEL" or
   • "REFERRAL_EXT_TYPE" or
   • "RETRIEVAL_ORDER" or
   • "REFERRAL_EXT" or
   • "ANNOUNCE_ONLY" or
   • "GREETING_ID" or
   • "MAILBOX_STATUS" or
   • "ACCESS_MODE"
2. Variable/constant

For example:

label: "Check Edges"
        UpdateProfile("PASSWORD", in1_n)
          edge EDGE_UPD_PROFILE_COMPLETE:         complete
          edge EDGE_UPD_PROFILE_FAILED:   failed
        ;
        UpdateProfile("OWNER_STATUS", in1_n);
        UpdateProfile("PROMPT_LEVEL", in1_n);
        UpdateProfile("REFERRAL_EXT_TYPE", in1_n);
        UpdateProfile("RETRIEVAL_ORDER", in1_n);
        UpdateProfile("REFERRAL_EXT", in1_n);
        UpdateProfile("ANNOUNCE_ONLY", in1_n);
        UpdateProfile("GREETING_ID", in1_n);
        UpdateProfile("MAILBOX_STATUS", in1_n);
        UpdateProfile("ACCESS_MODE", in1_n);

The parameters and edges are described above under "Parameters" and "Possible results". For more information, see Testing a state table using the debugger.