COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

Usage Consideration: In a fault-tolerant program, put the CHECKPOINT statement that specifies
cpinfo immediately before the call to COBOL_CONTROL_; otherwise, the queued information
can be lost if a backup process takes over.
COBOL_GETENV_
The COBOL_GETENV_ routine returns the value of a specified environment variable.
env-var
is the name of the environment variable whose value is to be returned. It cannot have trailing
spaces or a zero-byte terminator.
return-value
is the name of the variable that will hold the returned value of env-var. It must be large
enough to hold the maximum possible value of env-var.
length
is the number of characters that return-value contains. If length is zero, env-var was
not found.
COBOL_PUTENV_
The COBOL_PUTENV_ routine sets a specified environment variable to a specified value.
env-var
is the name of the environment variable whose value is to be set. It cannot have trailing spaces
or a zero-byte terminator.
return-value
is zero if the value of env-var was successfully set, nonzero if the value of env-var was not
set because of insufficient heap space.
COBOL_RETURN_SORT_ERRORS_
The COBOL_RETURN_SORT_ERRORS_ routine returns any error message from the FastSort utility
program.
618 Libraries and Utility Routines