FCDN gate, GET_NEXT_DSNB function

This function browses the next data set name (DSN) block and returns the attributes to the caller.

Input Parameters

BROWSE_TOKEN
The token returned from the START_DSNB_BROWSE function.
OBTAIN_VSAM_CATALOG_DATA
Optional Parameter
Values for the parameter are:
  • YES
  • NO

Output Parameters

ACCMETH
Specifies the access method.
Values for the parameter are:
  • VSAM
  • BDAM
  • NOT_APPLICABLE
AVAILABILITY
Specifies the availability of the data set.
Values for the parameter are:
  • AVAILABLE
  • UNAVAILABLE
  • NOT_APPLICABLE
BASEDSNAME
The 44-character name of the base data set.
DSNB_TYPE
Specifies the data set name block type.
Values for the parameter are:
  • PATH
  • BASE
  • NOT_APPLICABLE
DSNB_VALID_STATUS
Specifies the status of the DSN block.
Values for the parameter are:
  • YES
  • NO
FILECOUNT
This halfword binary field specifies the file count.
FWDRECOVLOG
This halfword binary field specifies the log ID to which the after images for forward recovery are written.
FWDRECOVLSN
This 26-character string specifies the forward recovery log stream name (LSN).
IMAGE
Indicates whether backup images are to be fuzzy or sharp. Values for the parameter are:
  • FUZZY
  • SHARP
  • NOT_APPLICABLE
LOSTLOCKS
Returns the lost locks status of the data set. Values for the parameter are:
  • REMLOSTLOCKS
  • RECOVERLOCKS
  • NOT_APPLICABLE
  • NOLOSTLOCKS
REASON
The following value is returned when RESPONSE is EXCEPTION:
  • INVALID_BROWSE_TOKEN
The following values are returned when RESPONSE is EXCEPTION:
  • DATASET_MIGRATED
  • DSNB_NOT_FOUND
  • INQ_DATASET_NOT_KNOWN
  • VSAM_ERROR
  • END_OF_LIST
The following values are returned when RESPONSE is DISASTER:
  • DISASTER_PERCOLATE
  • TM_LOCATE_FAILED
  • TM_UNLOCK_FAILED
  • TM_GETNEXT_FAILED
  • VSAM_CATALOG_ERROR
RECOV_VALID_STATUS
Values for the parameter are:
  • YES
  • NO
  • NOT_APPLICABLE
RECOVSTATUS
Specifies the recovery status for the data set. Values for the parameter are:
  • FWD_RECOV
  • RECOV
  • NOT_APPLICABLE
  • NOT_RECOV
REPLICATION LOGGING
Values for the parameter are:
  • YES
  • NO
  • NOT_APPLICABLE
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
Values for the parameter are:
  • OK
  • INVALID
  • EXCEPTION
  • DISASTER


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