Ends a browse.

Sintaxe:

Condições: DISABLED, FILENOTFOUND, ILLOGIC, INVREQ, ISCINVREQ, NOTAUTH, NOTOPEN, SYSIDERR

Notas:

1. DATASET is also accepted, but FILE is preferred.
2. DSIDERR is equivalent to FILENOTFOUND.

Descrição:

ENDBR ends a browse on a file on a local or a remote system.

Always issue an ENDBR command before you perform any update operations on the same file (READ UPDATE, DELETE with RIDFLD, or WRITE), and before a syncpoint.
You need to issue ENDBR only after a successful STARTBR.

Opções:

FILE(name)
• Specifies the name of the CICS file that is being browsed.
• The name must be alphanumeric, and can be up to eight characters long.
• If the SYSID option is not used to specify a remote SYSID, this file must have an entry in the File Definitions (FD).

REQID(data-value)
• Specifies, as a 16-bit binary value, a unique request identifier for the browse; it is used to control multiple browse operations on a file.
• The value should be the same as that given to the corresponding STARTBR command.
• If this option is not specified, a default value of zero is assumed.

SYSID(name)
• Specifies on which CICS region the ENDBR is to run.
• The SYSID name has one through four characters. For a full description of the SYSID option, refer to SYSID.
• If the SYSID option is not specified, it defaults to the value that is in the RemoteSysId attribute of the FD entry for the file that is requested in the FILE option.
• If neither the SYSID option nor the TRANSID option is specified, the CANCEL request runs on the local region.

Condições:

DISABLED
• Occurs if a file is disabled. A file might be disabled because:
  • It was initially defined as disabled and has not since been enabled.
  • It has been disabled by an EXEC CICS SET FILE command or by the CEMT transaction.
• This condition cannot occur after a successful STARTBR command that specified the same REQID, unless an ENDBR has since been issued for that REQID, or the browse has been terminated by an ILLOGIC or IOERROR condition.
• Função pré-definida: Terminates the task abnormally.

FILENOTFOUND
• Occurs if the name that is specified in the FILE option cannot be found in the FD.
• Função pré-definida: Terminates the task abnormally.

ILLOGIC
• Ooccurs if an error occurs that does not fall within one of the other CICS response categories.
• More information is available in the EIBRCODE field; see Appendix A, EXEC interface block (EIB) fields for details.)
• Função pré-definida: Terminates the task abnormally.

INVREQ
• Occurs if the ENDBR command is issued for a file that has not successfully had a previous STARTBR command issued for it.
• Função pré-definida: Terminates the task abnormally.

ISCINVREQ
• Occurs if the remote system indicates a failure that does not correspond to a known condition.
• Função pré-definida: Terminates the task abnormally.

NOTAUTH
• Occurs for the following conditions:
  • When a resource security check is unsuccessful on FILE(name).
  • When SYSID is specified by a transaction that is defined with the RSLCheck attribute set to either internal or external.
• Função pré-definida: Terminates the task abnormally.

NOTOPEN
• Occurs for the following conditions:
  • The requested file is CLOSED and UNENABLED. The CLOSED, UNENABLED state is reached after a CLOSE request has been received against an OPEN ENABLED file, and the file is no longer in use.
  • The requested file is OPEN and in use by other transactions, but a CLOSE request against the file has been received.
  • Current activity is allowed to complete, but no new activity is allowed to start.
• This condition cannot occur after a successful STARTBR command that specified the same REQID, unless an ENDBR has since been issued for that REQID.
• Função pré-definida: Terminates the task abnormally.

SYSIDERR
• Occurs if a problem with the communications configuration prevents the ENDBR from proceeding.
• For example:
  • The connection that is named in the SYSID option is not the name of a Communications Definition (CD) entry.
  • The SYSID option references a CD entry that is incorrectly configured.
  • The SYSID option references a CD entry that is marked as out of service.
• It can also occur if the connection to the remote system is closed.
• This could be because the remote system is not available.
• Função pré-definida: Terminates the task abnormally.

Informações relacionadas:

• DELETE
• READ
• STARTBR
• WRITE
• Appendix A, EXEC interface block (EIB) fields
• TXSeries for Multiplatforms Administration Reference
• TXSeries for Multiplatforms Intercommunication Guide