DBRC stop request (STOPDBRC)

You can use the STOPDBRC request to terminate the DBRC application and to stop DBRC.

If the application registered to DBRC by supplying an SSID on the STARTDBRC request, a subsystem record for the application was recorded in RECON. The STOPDBRC request automatically deregisters the application, unauthorizing any authorized databases and deleting the subsystem record.

Syntax for the STOPDBRC request

Read syntax diagramSkip visual syntax diagramnameDSPAPIFUNC=STOPDBRCTOKEN= addressMF=SMF=(S, list)MF=(L, list)MF=(M, list,COMPLETE,NOCHECK)MF=(E, list,COMPLETE,NOCHECK)RETCODE= returncodeRSNCODE= reasoncodeVERSION=1.0VERSION= number

Parameters for STOPDBRC

name
Optional symbol you can specify. If used, begins in column 1.
TOKEN=symbol | (2 - 12)
Specifies the address of a 4-byte field that was returned on the FUNC=STARTDBRC request.
RETCODE=returncode | (2-12)
If specified as a symbol, specifies the label of a word of storage to receive the return code. If specified as a register, the register must contain the address of a word of storage to receive the return code. Regardless of whether RETCODE is specified, register 15 contains the return code.
RSNCODE=reasoncode | (2-12)
If specified as a symbol, the symbol must be the label of a word of storage to receive the reason code. If specified as a register, the register must contain the address of a word of storage to receive the reason code. Regardless of whether RSNCODE is specified, register 0 contains the reason code.
MF=S | L | M | E
Specifies the macro form of the request.
VERSION=1.0 | number
Specifies the version number of the parameter list to be generated by this request.

To use the parameters associated with a version, you must specify the number of that version or a later version. If you specify an earlier version level, the parameter is not accepted for processing and an error message is issued at assembly time. If parameters have a version dependency, the parameter descriptions with each request type identify the version number required.

Return and reason codes for STOPDBRC

Table 1. Return and reason codes for the STOPDBRC request
Code type Return codes Reason codes Meaning
  X'00000000' X'00000000' Request completed successfully.
Severe error X'0000000C' X'C9000001' Invalid TOKEN. The TOKEN block passed to the API is not recognized as a TOKEN created by a FUNC=STARTDBRC call.
  X'0000000C' X'C900000A' The TCB address is not the same as the TCB address under which the STARTDBRC request was issued.
  X'0000000C' X'E220nnnn' Error attempting to sign off the application. 'nnnn' is the return code from DBRC Signoff module, DSPSSIGN.
  X'0000000C' X'E2000100' Security error. SAF or the DBRC Command Authorization exit routine (DSPDCAX0) determined that the user is not authorized to perform the request.
Parameter error X'00000030' X'C9000001' Parameter error. The function (FUNC) specified in the parameter list passed to the API is invalid.
  X'00000030' X'C9000002' Invalid TOKEN field address. The address of the field containing the API TOKEN failed validity checking. The address specifies storage not owned by the calling program.
  X'00000030' X'C9000003' Invalid RETCODE field address. The address of the field to contain the API RETCODE failed validity checking. The address specifies storage not owned by the calling program.
  X'00000030' X'C9000004' Invalid RSNCODE field address. The address of the field to contain the API RSNCODE failed validity checking. The address specifies storage not owned by the calling program.