dipname

The dipname instruction translates a DIP number to a DIP name.

Synopsis

dipname(ctype.dst, type.src)

Description

The dipname instruction stores the DIP name in ctype.dst corresponding to the TSM DIP number specified in type.src. ctype.dst should be least BNAMELENG (as defined in shmemtab.h) bytes long. The dipname instruction stores a null string if the DIP number:

• Is not between 1-34 or 44-75
• Does not have an associated message queue already created
• Maps to a message queue key that is not assigned to a DIP

Note that the contents of the registers is not affected by this instruction.

The dipname instruction is used mostly for scripts that catch the DIP interrupt event and need to translate the DIP number of interrupting DIP to a DIP name.

Examples

/* Space for DIP name */
#define DIPNAME 30
dipname(ch.DIPNAME,r.1) /*DIP number in register 1 */
dipname(ch.DIPNAME,0) /* DIP number 0 */

dipname(ch.DIPNAME,int12) /* DIP number in integer location 12 */

See also

• dipnum

© 2006 Avaya Inc. All Rights Reserved.