Systemwalker Operation Manager Reference Guide

17.9 Unsupported Short Mail Message Conversion Exit [Windows]

When you want to send a message to a short mail, you must convert the message text into code.

If you are using a short mail that is not supported by Systemwalker Centric Manager, you will have to create an exit (DLL) for converting the message in advance.

Save the new DLL as "f3crhxpc.dll" in the following directory:

<Systemwalker installation directory>\MpWalker.JM\bin

Interface with Exit Program

Use the following format for calling up the function for converting the message.

int f3crhx_convert(char *Msg_Text,char *MsgNo,int MsgNoSize,char *Vender)

Msg_Text:

This sets the text (character string for the message text to be converted) that is to be sent to the short mail.

MsgNo:

The storage area for the conversion result has been prepared. Specify it on exit. Convert the text stored in Msg_Text to a character string of dialable number and specify. Specify it in the range for the length set in MsgNoSize, and specify "\0" at the end of the character string.

MsgNoSize:

The size of the area that stores the converted result (MsgNo) is set.

Vender:

The short mail company's name is set.

Return Values

Use the function's return value to post the conversion result of the message.

Normal end:

Posts an integer above 0. (Sends short mail.)

Abnormal end:

Posts an integer less than 0. (Does not send short mail.)

Cautions

• When you create this DLL, you need to register your Short Mail company in the Short Mail sheet of the Action Environment Setup dialog box.

• If this DLL ends abnormally, Systemwalker service will stop.

• If the control is not returned from this DLL, you will not be able to send short mail.

Program Example

Below is an example program for the unsupported short mail message conversion exit:

int f3crhx_convert(char *MsgText,char *MsgNo,int MsgNoSize,char *Vender)
{
    int i ;
    int NoLen = 0 ;

    if ( strcmp(Vender,"ven01") != 0 )  {     //  unsupported company
        return -1 ;

    }

    //  message conversion process
    for ( i = 0 ; i < strlen(MsgText) ; i++ ) {
        /* store the conversion result in MsgNo */
        /* store the number of strings stored in MsgNo in NoLen */
    }
    MsgNo[NoLen] = '\0' ;                    //  setting of end code

    return 0 ;                               //  normal end
}