CICS-related considerations

This page provides miscellaneous information about running EGL-generated programs on CICS®:

Also see the related links at the bottom of the page.

Record properties across programs

In relation to EGL-generated programs that run on CICS for z/OS®, the values of several record properties must be the same for each EGL record that accesses the same file in the same run unit. The record properties are as follows:
  • File name
  • Record type
  • Format and length of the internal structure
  • Length and offset of the key item, if any
  • Offset of any variable length item in the record
  • Offset of any number of occurs item in the record

Temporary storage queue access on CICS

When a relative or serial record is associated with a temporary storage queue on CICS, EGL adds a deletion byte to the beginning of the EGL record associated with the queue. The deletion byte is not in the record definition itself, but non-EGL programs that share the temporary storage queue must allocate space for the byte, which has either of two values:
  • One (1) means that the record was deleted and that the record length is 1
  • Zero (0) means that the record exists logically in the file
EGL statements that operate on a temporary storage queue act as follows:
  • The add or replace statement sets the deletion byte to 0
  • The delete statement sets the deletion byte and record length to 1
  • If the deletion byte equals 1, the inquiry or update statement sets the EGL error value NRF
  • The get next statement skips each queue record in which the deletion byte is 1
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.