Format of synchronous callout log records
Synchronous callout messages are non-recoverable OTMA messages that are initiated by an ICAL call through the AIBTDLI interface. These messages do not go through the IMS message queue structure.
The processing of a synchronous callout request and its corresponding response involves the exchange of a number of different message types, such at a resume tpipe request message, the callout request message, the ACK or NAK message to the callout request, the response message, and so forth.
For each possible type of message that is exchanged in the processing of a synchronous callout request and its response, a simplified X'6701' log record is written that contains an ID that identifies the type of message the log record documents.
The message-type identifier for each message type is displayed in the ID= field in the log records. Message types are identified by the following ID= values that are shown in alphabetical order:
- YACK
- ACK that OTMA received from the client for a callout request
- YAKO
- ACK that OTMA sent to the client for a callout response
- YCRT
- CANCEL RESUME TPIPE request that OTMA received from the client, usually as a result of the timeout of a RESUME TPIPE request
- YNAK
- NAK that OTMA received from the client for a callout request
- YNKO
- NAK that OTMA sent to the client for a callout response
- YOUT
- Synchronous callout request that OTMA sent to the client
- YPSI
- ACK or NAK that OTMA received from the client is sent to a wrong IMS system, or delayed ACK or NAK that is received by OTMA
- YRSP
- Response to the synchronous callout that OTMA received from the client
- YRTR
- RESUME TPIPE request that OTMA received from the client
In the output log records, all the messages for a particular synchronous callout request share the same correlation ID and the message types are recorded in the order in which they occur in the flow during synchronous callout processing.
- YRTR
- YOUT
- YACK or YNAK
- YRSP
- YAKO or YNKO
- YCRT
Examples of formatted X'6701' log records
The X'6701' log records for each message type in OTMA callout processing have a similar format. The format shown in following examples is representative of the format of all OTMA X'6701' log records for synchronous callout processing.
YOUT example of the OTMA X'6701' log record
The following example shows an X'6701' log record with ID = YOUT. The YOUT record is written when a synchronous callout message is sent to an OTMA client, such as IMS Connect.
INTERNAL TRACE RECORD ID = YOUT SEGNO=00 RECNO = 0000082F TIME 12:48:22.189 DATE 2008.234?
MCI PREF
0992D84E 000000 0180 20000020 E3D7C9D7 C5F14040 A0F00000 * ......TPIPE1 .0..*
0992D860 000012 00030000 00000000 00000001 0000 *..............STATE ......0 ..*
STATE
0C29F040 000000 00482048 01004040 40404040 40400000 00000000 00B60000 00000000 00000000 *...... ..................*
0C29F060 000020 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
0C29F080 000040 00000000 00000000 *........SECURITY......0H......FP*
SECURITY
0C29F088 000000 000E0000 0902C6D7 C5F0F0F0 F140 * ......FPE0001 USER SGM..*
USER SGM
0C29F096 000000 0100 00000000 00000000 * ..........*
0C29F0A0 00000A 0000E3D7 C9D7C5F1 40400000 00000000 00000000 00000000 00000000 00000000 *..TPIPE1 ......................*
0C29F0C0 00002A 00000000 00000000 00000000 00000000 00000000 40000000 00000000 00000000 *.................... ...........*
0C29F0E0 00004A 00000000 00000100 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
0C29F100 00006A 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
0C29F120 00008A SAME AS ABOVE
0C29F140 0000AA 00000000 00000000 00000000 00280000 C9D4E2F1 01000017 00220002 C2E0DE33 *................IMS1........B...*
0C29F160 0000CA 9B08FE7C E3D7C9D7 C5F14040 C6D7C5F0 F0F0F140 00000000 00000000 00000000 *...@TPIPE1 FPE0001 ............*
0C29F180 0000EA 00000000 00000000 00000000 00000000 00000000 0000 *......................APPL SGM..*
APPL SGM
0C29F196 000000 0068 0000C6C9 D9E2E340 * ....FIRST *
0C29F1A0 00000A D4C5E2E2 C1C7C540 C9E240E2 C5D5E340 E3D640C3 D3C9C5D5 E3404040 40404040 *MESSAGE IS SENT TO CLIENT *
0C29F1C0 00002A 40404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040 * *
0C29F1E0 00004A 40404040 40404040 40404040 40404040 40404040 40404040 40404040 4040 * B.*
YACK example of the X'6701' log record
The following example shows an X'6701' log record with ID = YACK. The YACK record is written when a synchronous callout message is sent to an OTMA client, such as IMS Connect.
After a synchronous callout message is received and an acknowledgment is sent back to OTMA, OTMA writes the following X'6701' log record with ID = YACK:
INTERNAL TRACE RECORD ID = YACK SEGNO=00 RECNO = 00000830 TIME 12:48:22.303 DATE 2008.234?
MCI PREF
7F2D8E28 000000 01208000 0000E3D7 C9D7C5F1 4040A0E0 0000000F 00000000 * ......TPIPE1 ..........*
7F2D8E40 000018 00000000 00010000 *........STATE ...."...... ....*
STATE
7F2D8E48 000000 00482040 01000000 00000000 00000000 00000000 00B60000 * ... ....................*
7F2D8E60 000018 00000000 00000000 00000000 0000C2E0 DE2137C9 6A780000 00000000 00000000 *..............B....I............*
7F2D8E80 000038 00000000 0000E3C5 E2E3D3E3 D9D40000 *......TESTLTRM..SECURITY...."...*
SECURITY
7F2D8E90 000000 006AC614 0902E4E2 D9E3F0F0 F1400903 * ..F...USRID01 ..*
7F2D8EA0 000010 40404040 40404040 00000000 00000000 00000000 00000000 00000000 00000000 * ........................*
7F2D8EC0 000030 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F2D8EE0 000050 00000000 00000000 00000000 00000000 00000000 00000000 0000 *..........................USER S*
USER SGM
7F2D8EFA 000000 0100 0000C9D4 * ....IM*
7F2D8F00 000006 E2F14040 4040E3D7 C9D7C5F1 4040F9F9 F9F94040 4040C2E0 DE2137C8 E2B80000 *S1 TPIPE1 9999 B....HS...*
7F2D8F20 000026 00000000 00000000 00000BB7 ED480000 00000000 00001000 40640000 00004040 *........................ ..... *
7F2D8F40 000046 40404040 40400000 00000200 00000000 00000000 00004040 40404040 40400000 * ................ ..*
7F2D8F60 000066 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F2D8F80 000086 TO 7F2D8FC0 0000C6 SAME AS ABOVE
7F2D8FE0 0000E6 00000000 00000000 00000000 00000000 00000000 00000000 0000 *..........................B.....*
YRSP example of the X'6701' log record
After OTMA receives a response for a synchronous callout message, the following X'6701' log record with ID = YRSP is written:
INTERNAL TRACE RECORD ID = YRSP SEGNO=00 RECNO = 00000831 TIME 12:48:22.305 DATE 2008.234?
DFSERA30 - FORMATTED LOG PRINT PAGE 0002
MCI PREF
7F2D8E10 000000 01800800 0000E2E8 D5C3D9C5 E2D7A0F0 * ......SYNCRESP.0*
7F2D8E20 000010 00000010 00000000 00000000 00010000 *................STATE ...."...*
STATE
7F2D8E30 000000 00480040 01000000 00000000 00000000 * ... ............*
7F2D8E40 000010 00000000 00B60000 00000000 00000000 00000000 0000C2E0 DE33B714 1FBA0000 *......................B.........*
7F2D8E60 000030 00000000 00000000 00000000 0000E3C5 E2E3D3E3 D9D40000 *..............TESTLTRM..SECURITY*
SECURITY
7F2D8E78 000000 006AC614 0902C7D6 * ..F...GO*
7F2D8E80 000008 C6C9E2C8 C9D50903 40404040 40404040 00000000 00000000 00000000 00000000 *FISHIN.. ................*
7F2D8EA0 000028 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F2D8EC0 000048 SAME AS ABOVE
7F2D8EE0 000068 0000 *..USER SGM...."..S....IMS1 SY*
USER SGM
7F2D8EE2 000000 0100 0000C9D4 E2F14040 4040E2E8 D5C3D9C5 E2D7F9F9 F9F94040 4040C2E0 * ....IMS1 SYNCRESP9999 B.*
7F2D8F00 00001E DE33B713 C5BA0000 00000000 00000000 00000BB7 EAB00000 00000000 00000000 *....E...........................*
7F2D8F20 00003E 40E90000 00004040 40404040 40400000 00000200 00000000 00000000 00004040 * Z.... ................ *
7F2D8F40 00005E 40404040 40400000 00000000 00000000 00000000 00000000 00000000 00000000 * ..........................*
7F2D8F60 00007E 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F2D8F80 00009E 00000000 00000000 00000000 00000000 00000000 00000000 00280000 C9D4E2F1 *............................IMS1*
7F2D8FA0 0000BE 01000017 00220002 C2E0DE33 9B08FE7C E3D7C9D7 C5F14040 C6D7C5F0 F0F0F140 *........B......@TPIPE1 FPE0001 *
7F2D8FC0 0000DE 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F2D8FE0 0000FE 0000 *..APPL SGM...."..S....RESPONSE T*
APPL SGM
7F2D8FE2 000000 001E 0000D9C5 E2D7D6D5 E2C540E3 D640E2E8 D5C3C840 C3C1D3D3 D6E4E340 * ....RESPONSE TO SYNCH CALLOUT *
YNAK example of the X'6701' log record
If OTMA receives a negative acknowledgment (NAK) for the synchronous callout message from its client, the following X'6701' log record with ID = YNAK is written:
INTERNAL TRACE RECORD ID = YNAK SEGNO=00 RECNO = 000008AC TIME 12:50:52.645 DATE 2008.234?
MCI PREF
7F363E28 000000 01204000 0000E3D7 C9D7C5F1 4040A0E0 00000014 00000DAC * .. ...TPIPE1 ..........*
7F363E40 000018 00000000 00010000 *........STATE ...."...... ....*
STATE
7F363E48 000000 00482040 01000000 00000000 00000000 00000000 00B60000 * ... ....................*
7F363E60 000018 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F363E80 000038 00000000 0000E3C5 E2E3D3E3 D9D40000 *......TESTLTRM..SECURITY...."...*
SECURITY
DFSERA30 - FORMATTED LOG PRINT PAGE 0006
7F363E90 000000 006AC614 0902E4E2 D9E3F0F0 F1400903 * ..F...USRID01 ..*
7F363EA0 000010 40404040 40404040 00000000 00000000 00000000 00000000 00000000 00000000 * ........................*
7F363EC0 000030 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F363EE0 000050 00000000 00000000 00000000 00000000 00000000 00000000 0000 *..........................USER S*
USER SGM
7F363EFA 000000 0100 0000C9D4 * ....IM*
7F363F00 000006 E2F14040 4040E3D7 C9D7C5F1 4040F9F9 F9F94040 4040C2E0 DEB11E60 BEB50000 *S1 TPIPE1 9999 B....-....*
7F363F20 000026 00000000 00000000 00000BB7 ED480000 00000000 00001000 40640000 00004040 *........................ ..... *
7F363F40 000046 40404040 40400000 00000200 00000000 00000000 00004040 40404040 40400000 * ................ ..*
7F363F60 000066 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *................................*
7F363F80 000086 TO 7F363FC0 0000C6 SAME AS ABOVE
7F363FE0 0000E6 00000000 00000000 00000000 00000000 00000000 00000000 0000 *..........................B..C..*