System i: Programming Message Handling APIs - IBM

More documents

Recommendations

Info

Note Before using this information and the product it supports, read the information in “Notices,” on page 199. This edition applies to version 6, release 1, modification 0 of IBM i5/OS (product number 5761-SS1) and to all subsequent releases and modifications until otherwise indicated in new editions. This version does not run on all reduced instruction set computer (RISC) models nor does it run on CISC models. © Copyright International Business Machines Corporation 1998, 2008. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents Message Handling APIs . . . . . . . . 1 APIs . . . . . . . . . . . . . . . . .3 Change Exception Message (QMHCHGEM) API . .3 Authorities and Locks . . . . . . . . . .3 Required Parameter Group . . . . . . . .3 Error Messages . . . . . . . . . . . .5 Control Job Log Output (QMHCTLJL) API . . . .6 Authorities and Locks . . . . . . . . . .7 Required Parameter Group . . . . . . . .8 CTLJ0100 Output File Names Structure . . . .9 Message Filter Array Elements . . . . . . .9 Field Descriptions . . . . . . . . . . .9 CCSID Considerations . . . . . . . . . .11 Error Considerations . . . . . . . . . .12 Job Message Queue Full Considerations . . . .12 Usage Notes . . . . . . . . . . . . .13 Error Messages . . . . . . . . . . . .13 Job Log Production Messages . . . . . . .13 List Job Log Messages (QMHLJOBL) API . . . .13 Authorities and Locks . . . . . . . . . .15 Required Parameter Group . . . . . . . .15 Format of Generated Lists . . . . . . . .16 Input Parameter Section . . . . . . . . .16 Header Section . . . . . . . . . . . .17 LJOB0100 Format . . . . . . . . . . .17 JSLT0100 Format . . . . . . . . . . . .18 JSLT0200 Format . . . . . . . . . . . .18 Valid Field Identifiers . . . . . . . . . .19 Field Descriptions . . . . . . . . . . .20 Error Messages . . . . . . . . . . . .29 List Nonprogram Messages (QMHLSTM) API . . .30 Authorities and Locks . . . . . . . . . .31 Required Parameter Group . . . . . . . .32 Format of Generated Lists . . . . . . . .33 Input Parameter Section . . . . . . . . .33 Header Section . . . . . . . . . . . .34 LSTM0100 Format . . . . . . . . . . .34 MSLT0100 Format . . . . . . . . . . .35 MSLT0200 Format . . . . . . . . . . .35 Valid Field Identifiers . . . . . . . . . .36 Field Descriptions . . . . . . . . . . .37 Error Messages . . . . . . . . . . . .47 Move Program Messages (QMHMOVPM) API . . .48 Authorities and Locks . . . . . . . . . .48 Required Parameter Group . . . . . . . .48 Optional Parameter Group 1 . . . . . . . .51 Optional Parameter Group 2 . . . . . . . .53 Error Messages . . . . . . . . . . . .54 Open List of History Log Messages (QMHOLHST) API . . . . . . . . . . . . . . . . .54 Authorities and Locks . . . . . . . . . .55 Required Parameter Group . . . . . . . .55 Message Selection Information Format . . . .57 Field Descriptions . . . . . . . . . . .57 HSTL0100 Format . . . . . . . . . . .61 Field Descriptions . . . . . . . . . . .62 Usage Notes . . . . . . . . . . . . .64 Error messages . . . . . . . . . . . .65 Open List of Job Log Messages (QGYOLJBL) API . .65 Differences between QMHLJOBL and QGYOLJBL 66 Authorities and Locks . . . . . . . . . .66 Required Parameter Group . . . . . . . .66 OLJL0100 Format . . . . . . . . . . .67 Field Descriptions . . . . . . . . . . .68 Message Selection Information Format . . . .70 Field Descriptions . . . . . . . . . . .70 Valid Field Identifiers . . . . . . . . . .72 Field Descriptions . . . . . . . . . . .73 Error Messages . . . . . . . . . . . .77 Open List of Messages (QGYOLMSG) API . . . .77 Differences between the QMHLSTM and QGYOLMSG APIs . . . . . . . . . . .78 Difference between the QSYRUSRI and QGYOLMSG APIs . . . . . . . . . . .79 Authorities and Locks . . . . . . . . . .79 Required Parameter Group . . . . . . . .79 LSTM0100 Format . . . . . . . . . . .81 Field Descriptions . . . . . . . . . . .82 Message Selection Information Format . . . .84 Field Descriptions . . . . . . . . . . .85 Valid Field Identifiers . . . . . . . . . .86 Field Descriptions . . . . . . . . . . .87 Error Messages . . . . . . . . . . . .90 Promote Message (QMHPRMM) API . . . . . .91 Authorities and Locks . . . . . . . . . .92 Required Parameter Group . . . . . . . .92 Error Messages . . . . . . . . . . . .94 Receive Nonprogram Message (QMHRCVM) API .94 Authorities and Locks . . . . . . . . . .95 Required Parameter Group . . . . . . . .95 Optional Parameter Group 1 . . . . . . . .97 Optional Parameter Group 2 . . . . . . . .98 Message Types and Message Keys . . . . . .98 RCVM0100 Format . . . . . . . . . . .99 RCVM0200 Format . . . . . . . . . . 100 Field Descriptions . . . . . . . . . . . 101 Error Messages . . . . . . . . . . . . 105 Receive Program Message (QMHRCVPM) API . . 105 Authorities and Locks . . . . . . . . . 106 Required Parameter Group . . . . . . . . 106 Optional Parameter Group 1 . . . . . . . 109 Optional Parameter Group 2 . . . . . . .110 Optional Parameter Group 3 . . . . . . . 111 Message Types and Message Keys . . . . . 111 RCVM0100 Format . . . . . . . . . .113 RCVM0200 Format . . . . . . . . . .113 RCVM0300 Format . . . . . . . . . .114 Sender Information Format . . . . . . . .115 Field Descriptions . . . . . . . . . . .116 Error Messages . . . . . . . . . . . . 122 Remove Nonprogram Messages (QMHRMVM) API 123 Authorities and Locks . . . . . . . . . 123 © Copyright IBM Corp. 1998, 2008 iii
Page 1: System i Programming Message Handli
Page 6 and 7: Required Parameter Group . . . . .
Page 8 and 9: v “Receive Program Message (QMHRC
Page 10 and 11: n Change a message in the message q
Page 12 and 13: Message ID Error Message Text CPF24
Page 14 and 15: Required Parameter Group Output fil
Page 16 and 17: When a generic ID is specified, any
Page 18 and 19: CCSID of 65535 so conversion does n
Page 20 and 21: The List Job Log Messages (QMHLJOBL
Page 22 and 23: The format of the message selection
Page 24 and 25: Offset Dec Hex Type Field 62 3E CHA
Page 26 and 27: Identifier Type Description 0606 BI
Page 28 and 29: Coded character set identifier to r
Page 30 and 31: To list all messages in the job log
Page 32 and 33: Offset of fields to return specifie
Page 34 and 35: procedure name has each procedure n
Page 36 and 37: Message ID Error Message Text CPF24
Page 38 and 39: User space *CHANGE User space libra
Page 40 and 41: Header Section Offset Dec Hex Type
Page 42 and 43: Offset Dec Hex Type Field 0 0 BINAR
Page 44 and 45: 4 A conversion error occurred using
Page 46 and 47: Format of message selection informa
Page 48 and 49: Message queue library used. The act
Page 50 and 51: Qualified message queue names. The
Page 52 and 53: Starting message key used. The mess
Page 54 and 55:
Move Program Messages (QMHMOVPM) AP
Page 56 and 57:
*PGMBDY The call stack entry is for
Page 58 and 59:
The length of the value for the to
Page 60 and 61:
one that is addressed by the pointe
Page 62 and 63:
specified in the user program, the
Page 64 and 65:
*CURRENT The current day is the las
Page 66 and 67:
Number of jobs to list. Specifies t
Page 68 and 69:
Offset Dec Hex Type Field 116 74 BI
Page 70 and 71:
Message type. The type of message l
Page 72 and 73:
Differences between QMHLJOBL and QG
Page 74 and 75:
Offset Dec Hex These fields repeat
Page 76 and 77:
This field is also applicable to th
Page 78 and 79:
If a key of a reply message is spec
Page 80 and 81:
Coded character set identifier (CCS
Page 82 and 83:
Replacement data or impromptu messa
Page 84 and 85:
3 List information Output Char(80)
Page 86 and 87:
1 Sort by the following message typ
Page 88 and 89:
Offset Dec Hex These fields repeat
Page 90 and 91:
0501 When the status of data field
Page 92 and 93:
Starting message keys. The message
Page 94 and 95:
2 No conversion occurred because yo
Page 96 and 97:
Receiving procedure name. This fiel
Page 98 and 99:
message. The message key of the new
Page 100 and 101:
*LERETRY Retry. The initial priorit
Page 102 and 103:
This parameter must specify the siz
Page 104 and 105:
see the Add Message Description (AD
Page 106 and 107:
Offset Dec Hex Type Field 8 8 BINAR
Page 108 and 109:
CCSID conversion status indicator f
Page 110 and 111:
Value Message Type 01 Completion 02
Page 112 and 113:
11 Length of call stack entry Input
Page 114 and 115:
stack entry on the call stack. The
Page 116 and 117:
v 1 through 4096 if partial name in
Page 118 and 119:
Optional You can either specify a m
Page 120 and 121:
Offset Dec Hex Type Field 45 2D CHA
Page 122 and 123:
Offset Dec Hex Type Field 53 35 CHA
Page 124 and 125:
CCSID of replacement data or improm
Page 126 and 127:
Value Message Type 01 Completion 02
Page 128 and 129:
Sending type. The type of the sende
Page 130 and 131:
*LIBL The library list Message key
Page 132 and 133:
diagnostic messages. This can preve
Page 134 and 135:
Messages to remove INPUT; CHAR(10)
Page 136 and 137:
Message ID Error Message Text CPF24
Page 138 and 139:
If the pointer is not Null or it do
Page 140 and 141:
If the pointer provided is not Null
Page 142 and 143:
*NONE This value can be used for th
Page 144 and 145:
The variable that receives informat
Page 146 and 147:
The coded character set identifier
Page 148 and 149:
Offset Dec Hex Type Field 52 34 BIN
Page 150 and 151:
Offset Dec Hex Type Field 228 E4 BI
Page 152 and 153:
0 No conversion was needed because
Page 154 and 155:
Length of relational test entry ava
Page 156 and 157:
*LT Less than *LE Less than or equa
Page 158 and 159:
Retrieve Message File Attributes (Q
Page 160 and 161:
Page 162 and 163:
Field Descriptions Allow alerts. Wh
Page 164 and 165:
Reserved. An ignored field. Text de
Page 166 and 167:
Offset Dec Hex Type Field 12 C CHAR
Page 168 and 169:
Page 170 and 171:
Qualified name of the reply message
Page 172 and 173:
Message File Library Authority *EXE
Page 174 and 175:
For an inquiry message only, the na
Page 176 and 177:
Page 178 and 179:
Message data 0-32767 Immediate text
Page 180 and 181:
v If the less than signs () are spe
Page 182 and 183:
*PGMBDY The call stack entry to sen
Page 184 and 185:
(QMHRCVPM) API specifying this key
Page 186 and 187:
Page 188 and 189:
The length of the reply text, in by
Page 190 and 191:
The Send Scope Message (QMHSNDSM) A
Page 192 and 193:
The Break Handling exit program pro
Page 194 and 195:
Receiving program type. The type of
Page 196 and 197:
The name of the message queue conta
Page 198 and 199:
function. The status message allows
Page 200 and 201:
The name of the message queue and l
Page 202 and 203:
v If an error occurs while retrievi
Page 204 and 205:
Sender’s copy (*COPY). Is a copy
Page 206 and 207:
IBM Corporation Software Interopera
Page 208 and 209:
SAA SecureWay SOM System i System i
Page 210:
204 System i: Programming Message H
show all

System i: Programming Message Handling APIs - IBM

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?