Custom Messages in the Message Library
You can load special user-defined messages into the IBM® Connect:Direct® message library. The sample format for the IBM Connect:Direct message source in the following figure is in the DGAXMSGC member of the IBM Connect:Direct sample library, $CD.SDGASAMP.
Note: Use the exact format as follows. You cannot use
comments.
DELETE =MSG00001
INSERT =MSG00001
MODULE =MSGSOURC
STEXT= This is an example of the short text message (one).
L01 = This is an example of the long text message (one). As
L02 = many as 12 lines may be used for the long text message.
L03 =
L04 =
L05 =
L06 =
L07 =
L08 =
L09 =
L10 =
L11 =
L12 =
Observe the following rules for variables and message IDs:
- The DELETE and INSERT variables are 1–8 characters.
- The MODULE variable is 1–64 characters.
- The STEXT and L01 through L12 variables are 1–63 characters.
- To insert a message ID, the INSERT, MODULE, STEXT, and L01 through L12 variables are required.
- To delete a message ID, the DELETE variable is required.
- To replace a message ID, the DELETE, INSERT, MODULE, STEXT, and L01 through L12 variables are required.
The job stream in the following figure is in the DGAJMSGL member of the IBM Connect:Direct $CD.SDGAJCL library. After copying the message source into your message source library and making changes as needed, run this job stream to add your messages to the IBM Connect:Direct message library.
//JOBNAME JOB (ACCT),’NAME’,CLASS=A,NOTIFY=TSOID,MSGCLASS=X
//MSGBUILD EXEC PGM=DMMSGLOD,PARM=’$CDHLQ.MSGFILE’
//STEPLIB DD DSN=$CDHLQ.SDGALINK,DISP=SHR
//SYSOUT DD SYSOUT=*
//INPUT DD DSN=$HLQ.SDGAMSGS(member),DISP=SHR
Note: For SMP/E installations, add the message source to the SDGAMSGS target library as an SMP/E USERMOD. MSGLOAD JCL can then process it.
Make the following changes to the job:
- Change the PARM statement to reference the file name of the IBM Connect:Direct VSAM message file. This value is the same value specified in the MSGDSN initialization parameter.
- Change the STEPLIB DD card to reference the SDGALINK.
- Change the INPUT DD card to reference the message source text. Source text is normally stored in a member in library SDGAMSGS. A sample format is in the member DGAXMSGC in the IBM Connect:Direct sample library, $CD.SDGASAMP.