Z command code

The Z command code sets the value of the subset pointer to 0. After your program issues a call with the Z command code, the pointer is no longer set to a segment, and the subset defined by that pointer no longer exists.

IMS returns a status code of GE to your program if you try to use a subset pointer having a value of 0.

For example, using the passbook example, suppose that you used the R command code to retrieve the first unposted transaction. You then process the chain of segments, posting the transactions. After posting the transactions and inserting any new ones into the chain, use the Z command code to set the subset pointer to 0 as shown in the following call:

ISRT     Abbbbbbb(AKEYbbbb=bA1)
         Bbbbbbbb*Z1

After this call, subset pointer 1 is set to 0, which indicates to a program that subsequently updates the database that no unposted transactions exist.