9 141 ISSUEMESSAGE

LANSA Technical

9.141 ISSUEMESSAGE

Þ Note: Built-In Function Rules.

Issues a message to a message queue.

For use with

LANSA for i

YES

Visual LANSA for Windows

YES

Visual LANSA for Linux

YES

 

 

Arguments

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Message queue to which message is to be sent. Do not leave this argument blank.
Note: This argument is ignored on non-IBM i platforms.

1

10

 

 

2

A

Req

Type of message (T = text, M = from message file)

1

1

 

 

3

A

Req

Text of message (T) or message number (M)

1

132

 

 

4

A

Opt

Message file name (M only)

Default: QUSRMSG

1

10

 

 

5

A

Opt

Message file library (M only)

Default: *LIBL

1

10

 

 

6

A

Opt

Message data Default: *BLANKS

1

132

 

 

 

 

Return Values

No return values.

Examples

Issue a message to ask user to sign off for 10 minutes:

USE        BUILTIN(ISSUEMESSAGE) 
           WITH_ARGS(DSP16 T  
          'Please sign off for 10 minutes. Thank you.'
 

Issue a message to tell operator that DAYJOB to CLOSE has been submitted to the batch queue:

CHANGE     FIELD(#MSGID) TO(MSG0121)
CHANGE     FIELD(#MSGF) TO(WRKMSGF)
CHANGE     FIELD(#SUB) TO('''DAILY    CLOSE''')
*
SUBMIT     PROCESS(DAYLY) FUNCTION(CLOSE)
USE        BUILTIN(ISSUEMESSAGE) WITH_ARGS(DSP01 M #MSGID
           #MSGF #SUB)
*
MSG0121 = The &1 &2 job for today has been submitted.
 

Note: The message data parameter corresponds directly to the MSGDTA parameter in the CL command SNDPGMMSG. The passing of information through this parameter is your responsibility. For more information on passing substitution variables see the appropriate IBM manuals.