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