Attach Logging to Logical Unit

This Subprogram enables logging such that all subsequent Input will be written to the specified Logical Unit.

Short Name Calling Sequence

STATUS = UIATLG(LOGLUN[,OLDLOG])

Long Name Calling Sequence

STATUS = UI_ATTACH_LOG(...)

Input Arguments

LOGLUN (Integer) Logical Unit

Output Arguments

OLDLOG (Logical) Old Log Mode (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

1. The Application Program must have already opened the specified Logical Unit prior to this call. All subsequent User Input will be logged to this Logical Unit.
2. This call will redirect Logging to another Logical Unit if Logging is already enabled at the time of the call.
3. Logging may be disabled by a later call to UI_DISABLE_LOG. Note that this will Close the Log File.
4. The OLDLOG Argument is optional and, if present, will be set to the old Logging Enabled Status (.TRUE. or .FALSE.) prior to this call.
5. UI_ATTACH_LOG and UI_ENABLE_LOG are alternatives whereby Logging may be established.