$USER_ILOG

CA-GSS Statements and Commands › Special Purpose IMODs › $USER_ILOG_FULL

$USER_ILOG_FULL

The $USER_ILOG_FULL IMOD is invoked as a subroutine call from $INT_ILOG_FULL whenever an ILOG subfile is filled. Upon return, the ILOG subfile is placed in RESET status and is eligible for reuse, as needed.

Arguments

Two arguments are passed to the IMOD - the ILOG file number, and the subfile number within the ILOG. These values are numeric and are separated by blanks in standard REXX form.

Return Values

$USER_ILOG_FULL can return a text string to the caller. The value of this string determines the final disposition of the ILOG subfile as shown in the following table.

Value	Explanation
RESET	The ILOG subfile is reset and is reused when needed.
null	The ILOG subfile is not reset. You need to reset the subfile manually before CA-GSS can re-use it. If any text string other than RESET is returned, a null string is assumed.

Usage Notes

This IMOD is also entered once for each ILOG subfile that is found to be full during CA-GSS initialization processing.
When you are logging large volumes of data, you need to provide a $USER_ILOG_FULL IMOD so that CA-GSS can automatically switch or reset ILOGs that become full. If you do not provide the IMOD, CA-GSS automatically resets the full ILOG.

Example

A complete example of $USER_ILOG_FULL can be found in the EXAMPLE ISET.

Tell Technical Publications how we can improve this information