FCFL gate, TEST_USER function

This function is used to test if the task has updated a record and established itself as a file user, either for any data set or for a specified data set. It can be used either as a domain subroutine call or as an inline macro.

Input Parameters

ENVIRONMENT
Optional Parameter
A fullword environment identifier. If specified, the function tests whether the task is a user of any files in that environment.
DSNAME
Optional Parameter
Specifies that a particular data set is to be tested.

Output Parameters

FLAB_PTR
The address of a file lasting access block (FLAB) that was found by the test. The return of a non-zero value indicates that the user is a task.
REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • DISASTER_PERCOLATION
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
Values for the parameter are:
  • OK
  • EXCEPTION
  • DISASTER
  • INVALID
  • KERNERROR
  • PURGED


dfhs3_FCFLtest_user.html | Timestamp icon Last updated: Monday, 5 June 2017