Results of a message: I/O PCB

After your program issues a call, IMS TM returns information about the results of the call in the I/O PCB. To find out about the results of the call, your application program must check the information that IMS TM returns to the I/O PCB.

When your application program retrieves a message, IMS TM returns this information about the message to the I/O PCB:

• The name of the terminal that sent the message.
• A 2-character status code describing the results of the call. If the program receives a status code of QC after issuing a call to retrieve a message, no more messages are available for the program to process.
• The current date, time, and sequence number for the message.
• The user ID of the person at the terminal or the transaction code for the program that sent the message.

Because the I/O PCB resides in storage outside of your program, you define a mask of the PCB in your program based at this address to check the results of IMS TM calls. The mask contains the same fields in the same order as the I/O PCB.